Skip to main content

Service Connections

Environment access level

This section describes all operations that an Environment access level user can perform with Service Connections.

What are service connections in Inimco.facts?

In Inimco.facts, a service connection is a configured interface that enables integration and communication between Inimco.facts and external services or applications. It allows for authenticated access to resources or functionalities within Inimco.facts through established protocols, facilitating the transfer and synchronization of data. Examples of service connections include:

  • Telemetry from Email: This service connection configures Inimco.facts to integrate and retrieve energy data sent via email, allowing for the consolidation of telemetry information directly from email messages into the platform.
  • IoT Central Integration: It enables Inimco.facts to connect with IoT Central to manage and analyze device telemetry data within a unified system, enhancing IoT data oversight.
  • Jira Service Management Cloud Integration: This connection allows Inimco.facts to fetch and incorporate data from Jira Service Management Cloud, streamlining workflow and incident management data for better operational visibility.
  • Power BI Integration: By connecting with Power BI, Inimco.facts can leverage advanced analytics and visualization tools, providing in-depth data analysis and reporting capabilities.

What can we do with the service connections in Inimco.facts?

  • View All Service Connections: Access a list of all service connections associated with the current subscription, providing an overview of integrated services.

  • View Service Connection Details: Examine the specifics of a service connection, including configurations, status, and any other pertinent details that define the connection.

Procedures

Set up Telemetry from Email connection on a subscription level

  1. Log in to Inimco.facts on a subscription level. You will be taken to the Home screen.
  2. Navigate to Service Connections.
  3. Click the + icon in the top right corner.
  4. Click Telemetry from Email.
  5. Enter the connetion name into the Name field.
  6. In the Schema field input the following details:
        {
"Type": "XXXX",
"InputEmailUser": "XXXX",
"InputEmailBox": "XXXX",
"InputEmailTenantId": "XXXX",
"InputEmailClientId": "XXXX",
"InputEmailClientSecret": "XXXX",
"OutputSubscriptionId": "XXXX",
"OutputDeviceId": "XXXX"
}

Replace XXXX with the respective credentials.

  1. Click SAVE.

Set up Telemetry from Email connection on the environment level

  1. Log in to Inimco.facts on the environment level. You will be taken to the Home screen.
  2. Navigate to Service Connections.
  3. Click Telemetry from Email.
  4. Click NEXT.
  5. Click the + icon in the top right corner.
  6. Enter the connetion name into the Name field.
  7. In the Schema field input the following details:
{
"runEachSeconds": XX
}

Replace XX with the number of seconds that indicate the interval at which the mail data is read.

  1. Click SAVE.

Set up IoT Central Service connection

  1. Log in to Inimco.facts on a subscription level. You will be taken to the Home screen.
  2. Navigate to Service Connections.
  3. Click the + icon in the top right corner.
  4. Click IoT Central.
  5. Click NEXT.
  6. Enter the connetion name into the Name field.
  7. In the Schema field input the following details:
{
"applicationId": "XXXX",
"subDomain": "XXXX",
"apiKey": "XXXX",
"subscriptionId": "XXXX",
"resourceName": "XXXX"
}

Replace XXXX with the respective credentials.

  1. Click SAVE.

Set up Jira Service Management Cloud Service connection

  1. Log in to Inimco.facts on a subscription level. You will be taken to the Home screen.
  2. Navigate to Service Connections.
  3. Click the + icon in the top right corner.
  4. Click Jira Service Management Cloud.
  5. Click NEXT.
  6. Enter the connetion name into the Name field.
  7. In the Schema field input the following details:
{
"applicationId": "XXXX",
"subDomain": "XXXX",
"apiKey": "XXXX",
"subscriptionId": "XXXX",
"resourceName": "XXXX"
}

Replace XXXX with the respective credentials.

  1. Click SAVE.

Set up Power BI Service connection

  1. Log in to Inimco.facts on a subscription level. You will be taken to the Home screen.
  2. Navigate to Service Connections.
  3. Click the + icon in the top right corner.
  4. Click Power BI.
  5. Click NEXT.
  6. Enter the connetion name into the Name field.
  7. In the Schema field input the following details:
{
"tenantId": "XXXX",
"clientId": "XXXX",
"clientSecret": "XXXX",
"workspaceId": "XXXX"
}

Replace XXXX with the respective credentials.

  1. Click SAVE.

Edit a service connection name

  1. Log in to Inimco.facts on a subscription level. You will be taken to the Home screen.
  2. Navigate to Service Connections.
  3. Click the ellipsis (...) in the service connection row that you want to update.
  4. Click Edit service connection.
  5. Enter the new name.
  6. Click SAVE.

Edit a service connection name

  1. Log in to Inimco.facts on a subscription level. You will be taken to the Home screen.
  2. Navigate to Service Connections.
  3. Click the ellipsis (...) in the service connection row that you want to delete.
  4. Click Delete.
  5. Confirm deletion.