Sample.TransferERPItemViaFileTab

During the design process, it is crucial for the engineer to access material information from the ERP system.

Using the “ERP Item” tab from this sample script, the designer can select a file in the Vault Client and view the material number and other relevant information live from the ERP system.
If desired, the displayed ERP data can also be modified directly via this tab.
If no item exists yet, all necessary information for the creation of a new ERP Item can be entered manually to create it in the ERP system afterwards.

Requirements

The event script is designed to be used with the sample ERP Plugin of powerGateServer:

  • A connection to the “MaterialService” is required. The Sample.ConnectToPowerGateServer script ensures that Vault is connected to the OData service before any operations are performed by this tab.

  • An entity set named “Materials” is expected as well as the entityset “MaterialDescriptions”

  • To provide additional information a pre-configured set of data for UnitOfMeasures and MaterialTypes are required. The Sample.SyncERPTabConfiguration script ensures that a default configuration is uploaded to Vault.

  • Vault files are uniquely assigned to an ERP item via their material number stored in the Vault property “Part Number” and the ERP field “Number”

Testing

The script can be tested by doing the following steps on your test-environment:

  1. Install powerGateServer which comes by default with its sample ERP plugin and check that the service is running

  2. Open the Vault Client and log in to your TestVault

  3. Navigate to a file and select it

  4. Click on the tab with the name “ERP Item”

  5. Since no item with the “Part Number” of the selected file exists in the ERP plugin of powerGateServer, a new one can be created.
    To do this, select a ‘Type’ from the combobox and click on “Create Item in ERP”:

    ../../_images/Sample.TransferERPItemViaFileTab_Create.png

    A new ERP Item has now been successfully created in the ERP system

  6. Its material number and other metadata are displayed:

    ../../_images/Sample.TransferERPItemViaFileTab_Update.png

    This information can also be changed and they are transferred to the ERP system after clicking on “Update Item in ERP”

Disabling the script

By default, the script enables the Vault “ERP Item” tab for files.
If you work exclusively with Vault Items, or if you do not use this tab, the file %PROGRAMDATA%\coolOrange\powerEvents\Events\Sample.TransferERPItemViaFileTab.ps1 can be moved to the directory %PROGRAMDATA%\coolOrange\powerEvents\Events\Disabled.