Time Series

The Time Series action publishes values for a datasource to the Mindsphere Service.  A time series record consists of a timestamp and one or more values.  This action allows sending of an array of records to MindSphere.

For more information, see https://developer.mindsphere.io/apis/iot-iottimeseries/api-iottimeseries-overview.html.

Parameter descriptions

Parameter
Description
S&F Profile The S&F profile to use if the data from the action can not be sent to the MindSphere Service.

If the default "None" is selected, then the optional MindSphere S&F feature will not be used for this action

If the data for this action is stored in a S&F queue, then the action's Store and Forward Route will be used to determine the next action to execute.

For more information, see MindSphere S&F Profile Management tab.
Input Type Auto or Manual. Select Auto if Service Credential is setup(see MindSphere Onboard tab), API will be used to enumeration values for Datasource parameters and input variables for existing datasources/datapoints.
Datasource Name of the target datasource. Available when the Input Type option is Auto.
Datapoints JSON Datapoints JSON is used to specify the input for the time series action. Available when the Input Type option is Manual.  The format of the JSON used in the action should be the same as the "dataPoints" element within the JSON that is used by the Data-Source-Configuration API https://developer.mindsphere.io/howto/howto-agent-upload-data.html#creating-a-data-source-configuration.  The supported types are DOUBLE, LONG, INT, STRING and BOOLEAN in upper case. For example: 
[
   {
      "id":"string",
      "name":"string",
      "description":"string",
      "type":"STRING",
      "unit":"string"
   },
   {
      "id":"int2",
      "name":"integer",
      "description":"integer value",
      "type":"INT",
      "unit":"degree"
   }
]
Maximum Array Size The maximum array size to be sent to the server.

Input tab

Input Description
Input variables Input variable parameters will be available for each datapoint in the datasource.
Data Point Timestamp Optional. The timestamp to include with the timeseries record.

If the timestamp is not included, the time the action is executed is used. If Maximum Array Size is greater than 1, this variable becomes a required input variable.
Data Point Count The number of elements in the array to be sent.
ThingKey Optional. If not specified, the thing key for the gateway is used.

Output tab

Output Description
MCL Error Message Optional. Error message returned by the MCL Library when an error is encountered. List of error codes can be found herehttps://developer.mindsphere.io/resources/mindconnect-lib/doxygen/html/index.html.
MCL Error Code Optional.Error code returned by the MCL Librarywhen an error is encountered.List of error codes can be found herehttps://developer.mindsphere.io/resources/mindconnect-lib/doxygen/html/index.html.