Integrating Third-Party Device Types

Scenario

You want to integrate a third party device type with the Management Platform.

For background information, see the reference section.

Prerequisites

  • You have logged into the Desigo CC Client and have configured a user group and assigned Scope rights and application rights to the user group for working with the powermanager extension. (See Assign Scope to a User Group in Security)
  • You have created a network driver started it.
  • You have associated the network driver with the network.
  • You have created the application for Web services and D3 Visualization in the SMC and their respective URLs are available.
  • System Manager is in Engineering mode.
  • In System Browser, Application View is selected.
  • You have configured and saved the JSON file consisting of the device type configuration of the third party device type.

Overview

1
2
3
4

Import Device Type
Create an Area
(Optional) Create a Sector
Create, Configure, and Save an Imported Device Type

 


To work with the libraries you should have the required customization level access. You can drag and drop a library only if the following nodes are available under the library.
GMS_PM_ConfigurationFolder
GMS_PM_DeviceDefinitionFolder
GMS_ObjectModel_Folder
GMS_MODBUS_CustomRules

Any property changes made to an existing third party device type JSON file will be applicable only to the new devices created under this device type when the modified JSON file is used.

We highly recommend not to change the property name or data type of the third party device type, if the JSON file is used in powermanager and instances are created for that device type. All functions using this device as the source will be disrupted.

Two JSON template file for Powermanager Device Engineer creation are available. These files can be found in the below mentioned path:
…\GmsMainproject\AddSW\PowermanagerDeviceEngineer\SampleFiles

These files are made available after the installation is completed. Types of JSON templates provided:

Single Phase Third Party Type

Three Phase Third Party Type.

You can create a third party device type from an active project in a single server distributed system.

You cannot create a third party device type from a remote server project in a separate server distributed system.

In case of third-party devices in distributed systems, a new device has to be created in the same system where the device type is created. You cannot create a new device of a device type created in the any other system part of the same distribution network.