AiM Asset Management

The AiM Asset Management connector imports assets and location data from AiM to enable work order synchronization.

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. Customer success will work with edge customers to securely retrieve the credentials:

Credential	Description
Username & Password	The username and password configured for API access to the AiM API
Base URL	The base URL for the AiM instance

Mapped Concepts

Connector Concept	Mapped Type
Locations	Building, Floor, Space
Asset Groups	ExactType
Asset	Thing or configured ExactType for Asset Category
Work Order	Work Order

Select Buildings

Complete and select the details about the locations that have been discovered in the AiM 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 AiM system. The Asset Type section will display all of the asset categories discovered in the AiM 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. Once saved, the connector will begin importing all assets for the buildings selected in the Select Buildings step.

Poll

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

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
{
  workOrders(filter: {connectedDataSourceId: {eq: "CONDUfL5cDFx4u7VVE8QMDvsH"}}) {
    id
    name
    dateCreated
    relatesTo {
      ... on Thing {
        id
        name
        exactType
      }
      ... on Building {
        id
        name
        exactType
      }
    }
  }
}