# powerGate v23

## v23.0.13

`18-04-2023`

**General**

- Updated powerEvents to version: [23.0.20](<inv:powerevents#change_logs/powerevents_v23:v23.0.20>).\
  This fixes terminating errors that prevented the use of `finally` statements in *-Action* parameters of cmdlets like [](<inv:powerevents#code_reference/commandlets/register-vaultevent>), [](<inv:powerevents#code_reference/commandlets/add-vaulttab>), [](<inv:powerevents#code_reference/commandlets/add-vaultmenuitem>) and [](<inv:powerevents#code_reference/commandlets/add-inventormenuitem>),\
  which affect e.g. ERP integrations based on the [powerGateTemplate](<https://github.com/coolOrangeLabs/powerGateTemplate>) project.

**Fixed**
- Display issue in the [Error Message Box](<inv:powerevents#client_customizations:errors>) where *System.Management.Automation.RuntimeException* was displayed for all [non-terminating errors](<erp_integrations:errors>) instead of their actual exception type

## v23.0.12

`04-04-2023`

**Features**

-  The sample [Vault - ERP integration](<erp_integrations:erp integrations>) can be tried out immediately after installing powerGate, as it automatically connects to a public [](</getting_started/demo_erp_system>).\
   This way, no more [powerGateServer](<inv:powergateserver#plugins/sample_plugins:erp>) installation or "TestVault" configuration is required for the evaluation.

**General**

- [Disabled](<inv:powerevents#getting_started:activating a sample script>) the [](</erp_integrations/Sample.ConnectToERP>) script by default on new environments, as a connection to the powerGateServer [ERP Plugin](<inv:powergateserver#plugins/sample_plugins:erp>) for evaluation purposes is no longer performed

**Fixed**

- Issue with *Sample.SyncERPTabConfiguration* where the script failed and an error dialog was displayed,\
  when a user logged in to Vault with no `Vault Get Options` or `Vault Set Options` permission

## v23.0.10

`17-03-2023`

**Fixed**

- Issue with [](</code_reference/commandlets/update-erpobject>) where the cmdlet did not return a result even though the update was successful,\
 when the *BeforeRequest/AfterResponse* action gets set in [-OnConnect](<code_reference/commandlets/connect-erp:remarks>) of the *Connect-ERP*
## v23.0.9

`07-03-2023`

**General**

- Updated powerEvents to version: [23.0.19](<inv:powerevents#change_logs/powerevents_v23:v23.0.19>).\
  This prevents crashes of the Vault Client that can occur in custom ERP Tabs after [scripting errors](<erp_integrations:errors>) in UI events or when using the `Show-Inspector` cmdlet,\
  especially in scripts based on *Sample.TransferERPBOMViaFileTab* or *Sample.TransferERPBOMViaItemTab*.

## v23.0.8

`08-02-2023`

**Features**

-  Extended [Setup](<installation:Setup>) with additional command-line argument for installing product without [sample files](<erp_integrations:scripts>) and without [powerJobs Client](<inv:powerjobs_client#index>) on Job Processor and unsupported Vault workstations

**Fixed**

- Issue with [Setup](<installation:Setup>) that after upgrading it was not longer possible to uninstall via Programs & Features, when the Setup file of the previous installation was renamed or removed

## v23.0.7

`12-01-2023`

**Fixed**

- Issue in BOM Window when multiple positions of the same item are displayed in the [BOM Tab](</bom_window>) and the [custom BOM properties](<code_reference/commandlets/show-bomwindow/objects/bomrow:bom properties>) of the first bomRow were incorrectly displayed for all rows and also transferred to ERP
- In the [Field Chooser](<bom_window/customization:add or remove columns>) all BOM properties can be correctly identified with a corresponding BOM icon
- Issue with [](</code_reference/commandlets/add-erpmedia>) where uploading a file to an EntitySet of an Odata v4 service failed when using the *-Properties* argument

:::{warning}
When upgrading to this version with saved layout files, the [columns](<bom_window/customization:customizing the layout>) and their order on the [](<bom_window:item tab>) and [](<bom_window:bom tab>) are reset to the default value.
:::

## v23.0.6

`19-12-2022`

**Features**

- Added *Sample.SyncERPTabConfiguration* script that provides Tools Menu items in the Vault Client for uploading -and downloading configurations for the [ERP integrations](<erp_integrations:erp integrations>)

## v23.0.5

`14-12-2022`

**Features**

- The "ERP Item" tabs in the Vault Client allow to create new materials in the ERP system, with information from the selected *Vault file*, *Vault item* or manually entered data.<br>
In addition, these tabs also allow material information to be updated in the ERP system directly from the Vault Client.
- Enhanced "ERP BOM" tabs with the ability to batch transfer material- and BOM data to the ERP system.<br>
With the [](</bom_window>) the complete CAD-BOM of the selected *Vault file* or *Vault item* can be displayed and its status can be compared with the ERP system.\
BOMs, individual positions or items that do not yet exist or need to be updated can than be automatically transferred to ERP.

**General**

- Renamed sample scripts *Sample.DisplayERPItemInFileTab.ps1* to *Sample.TransferERPItemViaFileTab.ps1* and *Sample.DisplayERPItemInFileTab.ps1* to *Sample.TransferERPItemViaItemTab.ps1*
- Renamed used *Sample.DisplayERPItemTab.xaml* file to *Sample.TransferERPItemTab.xaml*
- Renamed sample scripts *Sample.DisplayERPBOMInFileTab.ps1* to *Sample.TransferERPBOMViaFileTab.ps1* and *Sample.DisplayERPBOMInFileTab.ps1* to *Sample.TransferERPBOMViaItemTab.ps1*
- Renamed used *Sample.DisplayERPBOMTab.xaml* file to *Sample.TransferERPBOMTab.xaml*

## v23.0.4

`06-12-2022`

**Features**

- Added [Sample.ConnectToPowerGateServer](</erp_integrations/Sample.ConnectToERP>) script that automatically connects to the test/productive powerGateServer environment depending on the logged in Vault
- Added *ERP Item tab* that displays the material number and other relevant information from the ERP system for a selected Vault file
- Added *ERP BOM tab* that displays the complete ERP bill of materials (BOM) for the selected Vault file
- Added *ERP Item tab* that displays the material number and other relevant information from the ERP system for a selected Vault item
- Added *ERP BOM tab* that displays the complete ERP bill of materials (BOM) for the selected Vault item

**Fixed**

- Issue with [](</code_reference/commandlets/disconnect-erp>) and [IErpService.Dispose()](</code_reference/net_library/erpclient>) that performed unnecessary requests which terminated with the unclear error message *"Unexpected WebException encountered"* when closing connections to unavailable *Catalog Services* ([powerGateServer](<inv:powergateserver#plugins/sample_plugins:catalogservice>) and SAP systems)

:::{dropdown} Breaking Changes
:class-title: warning

**ERP integrations without powerGateServer (SAP)**\
The [Sample.ConnectToPowerGateServer](</erp_integrations/Sample.ConnectToERP>) script is active by default and will, depending on the Vault name try to connect to a powerGateServer on the localhost or ADMS.\
For ERP integrations where no powerGateServer is used (e.g. with SAP systems), [Error Message Boxes](<erp_integrations:Errors>) are displayed after logging into Vault.\
The sample script must therefore be [disabled](<inv:powerevents#getting_started:activating a sample script>).

:::

## v23.0.3

`10-11-2022`

**Fixed**

- Issue with [](</code_reference/commandlets/update-erpobject>) that *-Keys* were missing in request body when using [PUT](</code_reference/net_library/updatemethod>) as PreferredUpdateMethod

## v23.0.2

`17-10-2022`

**Fixed**

- Issue with [Connection Error Dialog](<erp_integrations:errors>) not displayed in [Vault Data Standard customizations](<https://knowledge.autodesk.com/support/vault-products/learn-explore/caas/CloudHelp/cloudhelp/2022/ENU/Vault-Admin/files/GUID-D7A81AE0-7CB0-4428-961C-A5E0F8B791D8-htm.html>) (e.g. [powerGateTemplate](<https://github.com/coolOrangeLabs/powerGateTemplate>)) and powerEvents [](<inv:powerevents#client_customizations>)


## v23.0.1

`05-10-2022`

**Features**

- [powerJobs Client](<inv:powerjobs_client#index>) is automatically installed and therefore adds support for *Vault Applications*:\
  Vault Client- and Inventor 2023, 2022 and 2021
- An [Error Message Box](<erp_integrations:errors>) informs about erroneous [ERP cmdlet](</code_reference/commandlets/>) usage and parameters by which no web requests can be sent\
  (e.g. missing *Connect-ERP* invocations, \$null values for *-Keys* or for not-nullable *-Properties*, wrong property names, property values of invalid type…)
- Also in the [BOM Window](<bom_window:errors>), where multiple BOMs, rows and Items are checked or transferred, automatic [Error states](</bom_window/status/>) are displayed if [ERP cmdlets](</code_reference/commandlets/>) with problematic parameter values are used.
- [powerEvents Restriction events](<inv:powerevents#code_reference/objects/event_mappings>) are automatically restricted when such issue occur in [ERP cmdlets](</code_reference/commandlets/>).

:::{dropdown} Breaking Changes
:class-title: warning

**Requires Vault Professional Client**\
The product can only be installed on environments where Autodesk Vault Professional Client 2023, 2022 or 2021 is installed.

:::