Modify the point prefix

To avoid collision with the data streams in the connector, the connector ID is prefixed to the points for which it collects data. You can customize this point prefix by modifying the configuration file.

Note that the PI point prefix has the following limitations:

• Maximum character length is 1023

• Cannot be null or whitespace

• Invalid characters are * \ ? ; { } [ ] | `

To modify the point prefix:

1. Navigate to %PIHOME64%\Connectors\ConnectorName\Configuration\ and open the file PIPointPrefix.config.json.

   For each server that a connector sends data to, the file includes an entry with the Data Archive server name and connector ID. For example:

   "MyServer": {
   "Name": "MyServer",
   "PIPointPrefix": "Example Connector"
   }

2. Change the PI point prefix.

   For example:

   "MyServer": {
   "Name": "MyServer",
   "PIPointPrefix": "New Prefix"
   }

   Note: The adapter adds a period separator to the stream/tag name. For example, if your configured prefix is "NewPrefix", the tag name will be NewPrefix.Well020002.A1. The adapter adds the period between the prefix and stream name.

3. Stop the connector.

4. If you previously ran the connector and collected data on existing points, rename those points, changing the old prefix to the new prefix.

   Note: If you skip this step, the connector leaves the PI points with the old prefix and creates new PI points with the new prefix. Data is not copied from the old PI points to the new renamed PI points.

5. Start the connector.