Timestamps for endpoints

When administrators configure endpoints for connecting to IoT platforms, they can specify how to synchronize timestamps between their platform and the Maximo environment when data is imported.

For each request, you can select one of the following options for synchronizing the timestamps:
Reading Date Tag Name
If you select the Reading Date Tag Name radio button, you must specify the JSON property in the endpoint response that represents the timestamp for the sensor reading. The following timestamp formats are supported:
  • EPOCH milliseconds

    For example, your platform might use a timestamp such as "timestamp": 1590497529207

  • ISO 8601 standards

    For example, your platform might use a timestamp such as "evt_timestamp": "2020-05-26T12:52:09.207+0000"

Reading Date Tag Map
For some platforms, the endpoint response might provide a reading date that is split into multiple properties, such as hour, minutes, and seconds. You can select the Reading Date Tag Map radio button to map the IoT platform time tags to time tags that are used in the Maximo environment. For example, Maximo tags include YEAR, MONTH, DAY, HOUR, MINUTE, and SECOND.

The format for maps is a comma-separated list of value pairs. The first value in a pair is the value that is expected by the Maximo environment. The second value in the pair is the value that is returned by an IoT platform.

Your platform might specify timestamp tags as shown in the following example:
   {
        "count": 3,
        "max": 13.7753305952,
        "min": 10.5459309137,
        "std": 1.3900506648,
        "sum": 37.41640663,
        "source": "torque",
        "type": "HOUR",
        "DAYTAG": 24,
        "YEARTAG": 2020,
        "HOURTAG": 21,
        "MONTHTAG": 5,
        "entity_id": "73002",
        "avg": 12.4721355433
    }

In the following sample mapping, YEAR, MONTH, DAY, HOUR, MINUTE, and SECOND are the values for the Maximo environment. You must specify the value that your platform uses for each of the Maximo values, in this case YEARTAG,MONTHTAG,DAYTAG,HOURTAG,MINUTETAG, and SECONDTAG.

YEAR=YEARTAG,MONTH=MONTHTAG,DAY=DAYTAG,HOUR=HOURTAG,MINUTE=MINUTETAG,SECOND=SECONDTAG,
Not Applicable
Not Applicable is the default value. Select this option if a timestamp does not apply to the endpoint.