Ultimo Developer
  • Welcome
  • Getting started
    • Introduction
    • Software editions
  • API guide
    • REST
      • Requesting data
      • Inserting data
      • Inserting data in batch
      • File uploads
      • Query options
      • Special characters
      • Testing REST
      • Additional security
      • Limits and Quotas
    • HTTP POST
      • Overview of a POST request
      • Requesting data
      • Inserting data
      • Testing HTTP POST
      • Additional security
    • SOAP
      • Overview of a POST request
      • Requesting data
      • Inserting data
      • Testing SOAP
      • Additional security
    • Third party integration
    • Error handling
  • CONNECTORS
    • BI Platform
      • Create database user
      • Connect to the database
      • Expiring passwords
    • Exchange Online
      • Email import
      • Custom SMTP
    • LDAP
      • LDAP connector
      • Cloud vs On Premises
    • SCIM
    • OCI
    • Universal Print
      • Prerequisites & limitations
      • How to setup
  • API key Templates
    • Introduction
    • Master data
      • Cost centers
      • Departments
      • Employees
      • Service contracts
      • Suppliers
    • Assets
      • Technical Service
      • Medical Assets
      • Fleet objects
      • Infra objects
      • IT Configuration-Items
    • Jobs
      • Technical Service jobs
      • Medical jobs
      • Fleet jobs
      • Infra jobs
      • IT-incidents
      • Attach or change images
    • Article
      • Create articles
      • Create article supplier
    • IoT
      • REST
      • HTTP POST
      • SOAP
    • Reservations
      • Create reservation
      • Update reservation
      • Cancel reservation
      • Get reservations
    • Track & Trace
  • Database
    • BI overview
      • BI functions
      • BI views
  • Azure documentation
    • Terms & Conditions
    • Azure migration
      • Export alternatives
      • Import alternatives
      • LDAP
    • Setup standard Single Sign On with MS Entra ID
    • Azure Authentication
    • Azure IP addresses
    • Azure AD SCIM provisioning
  • Have a question?
    • Ask on our Customer Portal
    • Contact Customer Support
Powered by GitBook
On this page
  1. API key Templates

IoT

PreviousCreate article supplierNextREST

Last updated 3 years ago

Professional Premium Enterprise

The Ultimo IoT connector enables third parties to provide measurements (i.e. based on sensor data) to Ultimo. There are three different ways to connect to Ultimo:

  1. *

  2. *

* Not available in Professional

After importing a measurement, various validations and business rules will be executed in Ultimo.

Ultimo is not suitable for raw sensor data, so it is not allowed to directly connect sensors to Ultimo or send unfiltered sensor data to Ultimo. The Ultimo IoT connector is intended to connect with a server or platform that collects and filters / aggregates data from sensors.

To avoid an overload of sensor data, there is a maximum limit of measurements. When processing measured values, Ultimo will check if there are no more than 3 days with more than 25 measured values in the past 10 days.

It is also possible to create new measurement points with the REST interface.

Functional details

Objects or meters can have measurement points. These can be stored on an equipment or a process function. Each measurement should refer to an existing measurement point (for an equipment or process function).

A measurement contains:

Parameter

Description

EquipmentId or ProcessFunctionId

Use an EquipmentId or ProcessFunctionId depending on where the object is stored (internal Ultimo ID).

It is recommended to use a Meter, which is an Equipment. This property is required.

MeasurementPointId

The code of the measurement point (int. Ultimo ID).

Date

The date and time of the measurement. This property is required. Allowed formats:

  • yyyy-MM-dd hh:mm:ss (i.e. 2018-08-21 15:21:59)

  • UTC: yyyy-MM-ddThh:mm:ssZ (i.e. 2018-08-20T15:17:59Z)

Value or Delta

Use Value when the measured value should be interpreted as an absolute value. Examples: a temperature or the total running hours of a machine.

Use Delta when the measured value is a difference relative to the previous measurement and it is desired to be cumulated in Ultimo. Example: the running hours since the last measurement. Note: Delta is only available in REST-API.

Text

Additional information or remarks for the measurement.

With the REST interface it is possible to create a new measurement point. When the new measurement point is the first measurement point for an equipment or process function, this will be the default measurement point.

A measurement point contains:

Parameter

Description

EquipmentId or ProcessFunctionId

Use an EquipmentId or ProcessFunctionId depending on where the object is stored (internal Ultimo ID). It is recommended to use a Meter, which is an Equipment. This property is required.

MeasurementPointId

The new code of the measurement point (internal Ultimo ID). This property is required.

Description

Additional description for the measurement point. This property is required.

✅
✅
✅
REST
HTTP POST
SOAP