.NET Based OPC UA Client/Server SDK  3.3.1.531
Migration guides

Table of Contents

Migration from SDK 3.2.x to 3.3.x

  • The NodeHandleType was extended by the InternalPush constant. The first value, that can now be used is 5u. However, we recommend you to define the constants relative to the VendorDefined constant. That is now 100u and should not be changed with future additions.

Migration from SDK 3.1.x to 3.2.x

  • The UserAccessMask values have been changed from type PermissionType to PermissionTypeDataType due to the implementation of RoleConfiguration.
    If NodeAccessInfo was used so far, please check if the UserAccessMask enum values are still valid in your use case.
    If not, there are also several methods in the NodeAccessInfoUtils class for converting from PermisisonDataTypeData to PermissionType.

Migration from SDK 3.0.x to 3.1.x

  • Application configuration moved to ApplicationInstanceBase
  • Set the type of the UaApplicationConfiguration in app.config to "UnifiedAutomation.UaBase.ApplicationConfigurationSection,UnifiedAutomation.UaBase" (remove ".Windows").
  • Certificate Store path in default configuration changed to %CommonApplicationData%\defaultOrganisationName\CertificateStores\pki\.
  • Trace path in default configuration changed to %CommonApplicationData%\defaultOrganisationName\Logs\.

Migration from SDK 2.x to 3.0.x

  • Remove referenced Unified Automation assemblies and add the distributed packages
    • UaBase
    • UaBase.Windows
    • UaClient (for client applications)
    • UaServer (for server applications)
  • Replace calling new UaClient.Session() by new UaClient.Session(ApplicationInstance.Default).
  • Replace XmlElement by XmlString when using the DataType for DataValues.
  • Replace Utils.GetDefaultIcon by GuiUtils.GetDefaultIcon.
  • Remove EventHandler MissingHttpsCertificate.
  • If the ApplicationSettings are set in code, then replace UaSchema.SecuredApplication by ConfigurationInMemory.
  • The method SecurityUtils.LoadCertificate (string storeType, string storePath, string subjectName, string thumbprint, bool needPrivateKey) has been removed.
    Create a certificate store with SecurityUtils.CreateStore and call ICertificateStore.Find instead.
  • Add TimestampsToReturn method argument to history read methods, if implemented.

Migration of applications based on .NET Framework to .NET Core

  • Change framework to .NET Core 2.0 or later.
  • Remove all dependencies to System.Windows.Forms.
  • Remove package UaBase.Windows.
  • Add package UaBase.BouncyCastle.
  • Replace occurrences of ApplicationInstance by ApplicationInstanceBase. Only use the functionality of ApplicationInstanceBase.