Update powerGate to current version

Summary of changes that need to be done when updating powerGate to current version

17.1.68

See: breaking changes

Customization has to be updated in locations using Connect-Erp, Disconnect-ERP, Get-ERPServices, Get-ERPObject, Get-ERPObjects, Remove-ERPObject, Update-ERPObject, Add-ERPObject, Update-ERPObject and Add-ERPObject

Usages for cmdlets like Get-ERPConnectionStatus, Resolve-ERPObject, Get-ERPEntities, Add-ERPDir, Update-ERPDir and powerGateErrors variable have to be removed in the scripts

PowerShell scripts containing Show-ErpWindow have to use Show-BomWindow instead

19.0.14

See: breaking changes

When upgrading to this version remove the StoredLayout files

Customizations with global PowerShell variables or other cachings may have to be updated in when conflicts arise because required BomWindow functions are executed in current runspace

Scripts expecting Get-BomRows to be called automatically after Add-BomWindowEntity  have to be adapted

20.0.7

Register the Serial Number for v20 products (and later) on your environments

21.0.13

See: breaking changes

Some cmdlets return empty array:

The customization should be updated in places that use the results of the following cmdlets: Get-ERPEntityTypes, Get-ERPEntitySets, Get-ERPServices and Get-ERPObjects. 

They no longer return $null in case of error, but an empty array instead.

$entities = Get-ERPObjects -EntitySet $documentEntitySet 

if($null -eq $entities){
  ...
}

if(-not $entities){
   ....
}

.NET library:

try {
   var item = erpClient.Services["InforVisual"].EntitySets["Materials"].GetErpObject(keys);
} 
catch (WebRequestException ex) {
  if(ex.StatusCode == 404) {
    ....
  }
}

var item = erpClient.Services["InforVisual"].EntitySets["Materials"].GetErpObject(keys);
if(item == null) {
   ....
}

21.0.14

See: breaking changes

The -Tooltip parameter of the Update-BomWindowEntity Cmdlet was renamed to -statusDetails.
Update your code to use -StatusDetails instead of -Tooltip.

The property "_Tooltip" of the BOM, BomRow and Item object were renamed to "_StatusDetails". Update your code to use "_StatusDetails" instead of "_Tooltip"

21.0.16

See: breaking changes

When BOM row properties are directly passed from Get-ERPObjects cmdlet to Add-BomWindowEntity -Properties, they should be updated to be passed as BOM properties with a "Bom_" prefix.   

$addedBomRow = Add-BomWindowEntity -Type BomRow -Parent $bom -Properties @{
    'Effective Length' -> 'Bom_Effective Length' =$erpBomRow.'Effective Length'
}

When accessing these BOM properties from the BomRow object they need to be retrieved using a "Bom_" prefix.

$effectiveLength = $addedBomRow.'Effective Length' -> $addedBomRow.'Bom_Effective Length' 

All the other properties are treated as entity properties. They used to be ignored by Update-BomWindowEntity for newly added BOM rows.

$addedBomRow | Update-BomWindowEntity -Status Remove -Properties @{
   'Part Number' = $erpBomRow.ChildNumber # this cmdlet now updates this entity property too
}

Therefore verify if the entity properties that are passed to these cmdlets should be removed or extended with a "Bom_" prefix. It might be sensible to return the BOM information in the Get-BomRows function with "Bom_" prefix.

No changes are necessary when the retrieved ERP data of the related Material should be displayed directly in the BOM Tab.

function Get-BomRows($bomHeader) {
   ...
   $bomRow.PSObject.Properties.Remove('Effective Length') 
   Add-Member -InputObject $bomRow -Name "Bom_Effective Length" -Value $bomRow.Unit -MemberType NoteProperty -Force
   ...
}

function Check-Boms($boms) {
   ...
   $addedBomRow = Add-BomWindowEntity -Type BomRow -Parent $bom -Properties @{
      'Bom_PositionNumber' = $erpBomRow.PositionNumber
      'Number' = $erpBomRow.ChildNumber  -> $erpMaterial.Number # used to be filled with data from ERP BOM but it makes more sense to use material data
      #'Part Number' = $erpBomRow.ChildNumber   # removed because this is an entity property that should not be filled with ERP BOM data
      'Bom_Effective Length' = $erpBomRow.'Effective Length'
   }
   ...
}

When additional columns are enabled for displaying the previously incorrect BOM properties, then they can be removed from the BOM Window as they will be empty in newly created BOM. The passed entity properties will be displayed in the duplicated column instead.

22.0.1

See: Changes

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