The "mtconnectTimestampPropertyPath" property is an optional string that specifies the location in the JSON document to store the timestamp of when the device collects the data item. In contrast, the timestamp built into FairCom's integration table tracks when the FairCom connector collects the data. When a device collects data infrequently, the device timestamp is more accurate than FairCom's built-in timestamp. Omit this property to omit it from the JSON document. This property defaults to null.
When the FairCom MTConnect connector collects data, it generates a JSON document and stores it in the database. The connector puts the value of the MTConnect timestamp in the JSON document at the location specified by this property. You may use a simple property name, such as "temperatureTimestamp", or a complex JSON path, such as "temperature.timestamp". For examples, see Example property paths that group related properties.
When the FairCom MTConnect Connector requests data over the MTConnect protocol, the device returns an <MTConnectStreams> XML document, which contains data elements. A data element contains the dataItemId and timestamp attributes. The timestamp attribute identifies when the device collected the element's data value.
In the following MTConnectStreams XML document returned over the MTConnect protocol, the data element has a dataItemId of "X1_Stamper1_Temperature". The element is named REAL. The value of the timestamp attribute is "2010-04-06T06:19:35.153141", which is formatted in ISO8601 format.
<MTConnectStreams>
<Streams>
<DeviceStream
name="X1"
uuid="X1_373f-4ab9-9c7a-173edd23e4f3">
<ComponentStream
component="Device"
name="Stamper1"
componentId="X1_Stamper1">
<Samples>
<REAL
dataItemId="X1_Stamper1_Temperature"
name="Temperature"
sequence="5"
timestamp="2010-04-06T06:19:35.153141"
>20.1</REAL>
</Samples>
</ComponentStream>
</DeviceStream>
</Streams>
</MTConnectStreams>