This article offers an overview of the breaking changes and the recommended changes so that your customization still works after an upgrade.
When upgrading from e.g. version v19 to v21 make sure to follow the steps to upgrade to the latest v19 version first, then follow the steps for upgrading to v20 and finally to v21.
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
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
See: breaking changes
Register the Serial Number for v20 products (and later) on your environments
Upgrading other products to v21 may be required, as described in this article
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.
When accessing these BOM properties from the BomRow object they need to be retrieved using a "Bom_" prefix.
All the other properties are treated as entity properties. They used to be ignored by Update-BomWindowEntity for newly added BOM rows.
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.
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.See: breaking changes