FSI CMS4 Source

The FSI CMS4 Source connector imports location and asset data from FSI CMS4 into Mapped, then regularly polls the system for Work Orders.

Use Cases

Potential use cases include:

• Faulty asset reasoning - contextualize signals from other systems with your asset inventory to find reasons for failure
• Work order analysis - find areas with high maintenance needs and prioritize accordingly

Configuration

This connector requires the following credentials:

Credential	Description
Username & Password	The username and password configured for API access to the FSI CMS4 instance
Site code	The site code for the FSI CMS4 Instance you are enabling the connector for
Subscription Key	The subscription key generated from the FSI CMS4 dashboard
Segment	The FSI segment you want the connector to focus on

Select Buildings

Complete and select details about the locations that have been discovered in the FSI CMS4 system. Use of the Mapping Rules Editor is recommended to help complete large configurations. Once the mapping is completed and saved, Mapped will begin importing the location data, including all relevant identifiers into your graph.

Asset Mappings

Configure and run an asset sync with the FSI system. The Asset Group section will display all of the asset categories discovered in the FSI system, and allow you to assign an Exact Type to the corresponding asset group. If no exact type is specified, a type of Thing will be automatically assigned. Then, you can select the building you wish to import assets from, and select Sync assets. The asset sync will happen asynchronously, and can be monitored from the Logs.

Poll

Enable or disable the work order poll. The poll will regularly scan the FSI system for new or updated work orders submitted for the locations configured in the Select Buildings section.

Mapped Concepts

Connector Concept	Mapped Type
Locations	Building, Floor, Space
Asset Categories	ExactType of Asset
Asset	Thing or configured ExactType for Asset Category
WorkOrder	WorkOrder

Sample Code

You can query Work Orders by the connector's ID and identify related assets and places.

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  workOrders(filter: {connectedDataSourceId: {eq: "CONEVeM6dEGy3v8WWF7RNEutK"}}) {
    id
    name
    description
    dateCreated
    relatesTo {
      ... on Thing {
        id
        name
        exactType
      }
      ... on Building {
        id
        name
        exactType
      }
      ... on Space {
        id
        name
        exactType
      }
    }
  }
}