Configuration export task adapter for IMS

To export the configurations out from IEE to PBC files that can be consumed by the Integration Management Service (IMS), use the Configuration Export Task Adapter.

In the task template, two request types can be used for integration with IMS.

  • When set to External System, the Configuration Export Task Adapter exports all configuration entities for the selected external system that have been created or updated since the Last Export Date in the External System table. After the export completes, the database updates with the Last Export Date.

  • When the request type is set to Last Update Date, it exports all configuration entities that have changed since the specified updated date, from all external systems.

The MDI structure is based on service points. If there is a PBC configuration file with meter-only information and no service point association, IMS cannot convert this PBC config file to an MDI file.

The MDI also has service point parameters in the MDI that come from the service point program in the PBC, such as CommodityType – Electric, Water, or Gas. For this reason, the full hierarchy of configurations is required from IEE, including both instance and programs, for IMS to convert the PBC configuration to MDI.

To include all hierarchy and programs in the Configuration Export task template when you have selected External System or Last Update Date in the Request Type dropdown menu, select the Include All Hierarchy and Programs checkbox.

If this checkbox is checked, IEE exports the full hierarchy of both instances and programs, including all versions and links.

If the checkbox is clear (which is the default), IEE performs an export where Configuration Type = Instance only (meaning without the program), while the Hierarchy Type depends on the entity type:

  • Full hierarchy for service points and premise

  • Single hierarchy for other entity types like meters, customers, accounts, route, etc. "Single" means it will only export the entity itself without the associated links.

The two Request Types handle either Push or Pull mode with IMS.

  • If set to External System, the PBC configs are pushed from IEE to IMS. The high-water mark is in IEE, so IEE keeps track of the last update date.

  • If set to Last Update Date, IMS will be the one pulling or requesting the PBC configs regularly from IEE. Here, the high-water mark is in IMS.

Currently, only the Push mode is supported by IMS. The Pull mode is not supported in IMS, but the option from the IEE side is available in case it is needed in the future.