Upgrade PI Connector for OPC UA

Consider the following when upgrading PI Connector for OPC UA:

From version 1.0 to 1.1

PI Connector for OPC UA version 1.1 introduced the following inconsistencies:

• In PI point names, for which the OPC UA NodeIds are used, space(s) and right and left single quotation mark(s) are not replaced by an underscore.

  Examples for differences in PI point names

  OPC UA dynamic variable NodeId	PI point name created by connector version 1.0	PI point name created by connector version 1.1
  V10A1 E1.VX2	OPC UA.V10A1_E1.VX2	OPC UA.V10A1 E1.VX2
  V10A1'E4.VX8	OPC UA.V10A1_E4.VX8	OPC UA.V10A1U+2018E4.VX8
  V10A1'E5.VX12	OPC UA.V10A1_E5.VX12	OPC UA.V10A1U+2019E5.VX12

  Note: As highlighted in the table, right and left single quotation mark(s) are replaced by their corresponding UTF-8 code.

• In PI AF element names, space(s) and right and left single quotation mark(s) are not replaced by an underscore.

  Examples for differences in PI AF element names

  OPC UA object name	PI AF element name created by connector version 1.0	PI AF element name created by connector version 1.1
  Zone 1 pressures	Zone_1_pressures	Zone 1 pressures
  Zone 1'pressures	Zone_1_pressures	Zone 1'pressures
  Zone 1'pressures	Zone_1_pressures	Zone 1'pressures

• For PI AF element attributes, the inconsistency introduced by the different logic dealing with the restricted characters is the following:

  Examples for differences in PI AF attribute names

  OPC UA variable name	PI AF attribute name created by connector version 1.0	PI AF attribute name created by connector version 1.1
  Pressure*A	Pressure%10iA	Pressure_A
  Pressure'A	Pressure%11iA	Pressure_A
  Pressure?A	Pressure%12iA	Pressure_A
  Pressure;A	Pressure%13iA	Pressure_A
  Pressure{A	Pressure%14iA	Pressure_A
  Pressure}A	Pressure%15iA	Pressure_A
  Pressure[A	Pressure%16iA	Pressure_A
  Pressure]A	Pressure%17iA	Pressure_A
  Pressure|A	Pressure%18iA	Pressure_A
  Pressure\A	Pressure%19iA	Pressure_A
  Pressure`A	Pressure%20iA	Pressure_A
  Pressure"A	Pressure%21iA	Pressure_A

From version 1.0 or 1.1 to 1.1.1

The connector install kit 1.1.1 detects the existence of version 1.0 and, with regards to the characters mentioned earlier, retains the behavior from version 1.0. In other words, the backward compatibility with version 1.0 is ensured. In case of an initial installation of version 1.1.1, the naming schema of version 1.1 is used.

The connector's global configuration file ConnectorGlobal.config.json located at %PIHOME64%\Connectors\OpcUa\Configuration includes a section titled CharacterReplacementRules, in which you can enforce a certain naming schema. The following example enforces the naming schema of PI Connector for OPC UA version 1.0.

{

"connectorglobal": {

"ConfigObject": {

"CharacterReplacementRules": "V1.0"

}

}

}