powerGate v24

v24.0.7

05-10-2023

Features

A new ERP Integration Settings dialog allows Vault administrators to configure ERP services on a Vault-wide basis.
This enables all common powerGateServer situations as well as direct OData connections to be easily set up.
The Sample.ConnectToERP script automatically connects to all these configured services when logging into the respective Vault in Vault Client and Inventor
Extended Connect-ERP with a -UseSettingsFromVault parameter, which e.g. makes this easily possible also on the Job Processor

General

Renamed sample script Sample.ConnectToPowerGateServer.ps1 to Sample.ConnectToERP.ps1
Instead of the Sample.ManagePowerGateConfiguration script, now the Sample.ConnectToERP script adds a Tools menu item to the Vault Client for opening the current Vault - ERP Integration Settings

Fixed

Issue in the BOM Window where context menu buttons to select/unselect disappeared when custom display scaling settings are used

v24.0.5

11-08-2023

General

Updated Licensing to version: 18.3.1
Updated powerEvents to version: 24.0.4
- This solves the problem where changes to ERP integration scripts being incorrectly reloaded on MTA background threads, resulting in a smoother debugging and development experience:
  Connection Error Dialogs are displayed again if problems occur with new changes in such scripts.
- Changes can now be saved even while modal dialogs are open. It is no longer necessary to restart the Vault Client if, for example, Error Message Boxes, Connection Error Dialog, BOM Windows, Inspector dialogs or simple Message Boxes are displayed.
  Advantageously, for scripts based on our ERP BOM tab samples, changes in BOM Window functions now take effect immediately without the need to re-open the window, reloading tab contents, or waiting for any Check-operations to complete.
- In addition, all sample ERP integration files are now installed in %ProgramData%\coolOrange\Client Customizations.
Breaking Changes

Change paths in Customization distribution mechanisms

Please note that the simplification of the folder structure for Client Customizations may require adjusting paths in automatic distribution mechanisms (e.g. setups or IT tools).
For more details, see the “Breaking Change” section in powerEvents v24.0.4

Fixed

Issue in sample scripts for ERP BOM tabs where failed BOM row creations were incorrectly marked as successfully transferred in the BOM Window.
BOMs are now again created with deep-create, which ensures that they are transferred as a whole and marked as erroneous, even if there are problems with the creation of individual BOM rows.

Note

For ERP interfaces implemented with a ERP BOM tab based on v24.0.3 or v24.0.4, it is recommended to update the section for creating BOM headers and rows in the Transfer-Boms function.

v24.0.4

30-05-2023

Fixed

Issue in sample script for Inventor Menu item “Create/Update ERP Item” and Inventor Menu item “Link ERP Item” where the parent assembly was used when a part or assembly was opened within an opened assembly

v24.0.3

28-05-2023

Features

The user interface for the “ERP Item” and “ERP BOM” tabs in the Vault Client have been redesigned
Added “Link ERP Item” tabs for searching and linking an existing ERP Item to a selected Vault File or a Vault Item
Added “Create/Update ERP Item” Inventor Menu item for creating or updating an Item in ERP using iProperties of the active Part- or Assembly-Document
Added “Insert ERP Item” Inventor Menu item for searching and inserting an existing ERP Item as Virtual Component or as Raw Material for the active Part- or Assembly-Document
Added “Link ERP Item” Inventor Menu item for searching and linking an existing ERP Item to the active Part- or Assembly-Document

General

The Sample.ConnectToPowerGateServer script is enabled by default on new environments and automatically connect to the public Demo ERP system by default
Renamed sample scripts Sample.TransferERPItemViaFileTab.ps1 and Sample.TransferERPItemViaItemTab.ps1 to Sample.Tab-File-ErpItem.ps1 and Sample.Tab-Item-ErpItem.ps1
Renamed used Sample.TransferERPItemTab.xaml to Sample.Tab-ErpItem.xaml
Renamed sample scripts Sample.TransferERPBOMViaFileTab.ps1 and Sample.TransferERPBOMViaItemTab.ps1 to Sample.Tab-File-ErpBom.ps1 and Sample.Tab-Item-ErpBom.ps1
Renamed used Sample.TransferERPBOMTab.xaml to Sample.Tab-ErpBom.xaml
Renamed sample script Sample.SyncERPTabConfiguration.ps1 to Sample.ManagePowerGateConfiguration.ps1
Renamed used configuration Sample.DefaultERPTabConfiguration.xml to Sample.PowerGateConfiguration.xml

v24.0.2

18-05-2023

Features

Easy and secure upgrade of already productive ERP integrations implemented with v21 (or older) and Vault Data Standard, so that working can be continued as usual on all workstations

General

Updating the product disables all sample ERP integration scripts by default if they were not already present on the workstation before.
So for v22 upgrades (or older) also all Sample.TransferERP…Tab.ps1 and Sample.SyncERPTabConfiguration.ps1 files are installed to the .\Disabled subdirectory, so they no longer need to be disabled manually for compatibility reasons.
Automatic display of Non-Terminating Errors:
- For Vault Data Standard integrations, connection errors and incorrect ERP cmdlet usages or parameters are no longer displayed by default.
  This eliminates the need to disable possible duplicate messages after updating from v21 or older. Such errors are now clearly displayed only in powerEvents-based integrations (and PowerShell IDE’s).
- In powerEvents-based integrations the automatic display of these errors can be suppressed for individual ERP cmdlet calls by passing -ErrorAction SilentlyContinue

Fixed

Issue with Updates on Job Processor environments (and workstations with unsupport Vault versions) when only main components (Cmdlets and .NET Library) were installed, but simple setup executions incorrectly installed sample files and powerJobs Client

Breaking Changes

Setup argument renamed and value changed
The Setup argument for installing only the main components (Cmdlets and .NET Library) has been renamed to MAIN_COMPONENTS_ONLY and the required value was changed to 1.
Therefore updates on Job Processor environments (and workstations with unsupport Vault versions) should be performed using the adapted command-line argument:

Previous	Now
`"\\path\to\networklocation\powerGate24.0_Vault2024.exe" -silent ACCEPT_EULA=1 VAULT_ERP_INTEGRATION=0`	`"\\path\to\networklocation\powerGate24.0_Vault2024.exe" -silent ACCEPT_EULA=1 MAIN_COMPONENTS_ONLY=1`

Vault Data Standard integrations for v22.0.1 and later - automatic Error display removed
ERP integrations implemented with Vault Data Standard (e.g. powerGateTemplate based projects) do not contain any additional error checking or handling logic after ERP cmdlet invocations.
So that non-terminating connection errors (v22.0.1) and incorrect ERP cmdlet usages (v23.0.1) are not swallowed, the following line should be added after importing the powerGate module:

Import-Module powerGate
$global:Host.PrivateData.OnNonTerminatingError = $global:deprecated_defaultErrorBehaviorForVDS

Note: Earlier VDS integrations implemented for v21 or older, should already contain the required error handling logic and are therefore not affected (see “Autodesk Vault Data Standard - Non-Terminating Errors”).

v24.0.1

27-04-2023

General

Added support for Vault 2024
Updated Licensing to version: 18.2.29
End User License Agreement (EULA) has changed
Updated minimum required .NET Framework version to 4.7
Removed DEPRECATED support for simple updates of ERP interfaces that are compiled against the 20.0 version of the .NET library.
The policy files for v20 versions of the powerGate.Erp.Client assembly are no longer installed in the GAC, which requires a rebuild against the latest version.