Time Series

The Time Series Property allows individual Business Objects in your model to receive and store IoT data. Each Business Object acts as a unique "sensor," collecting timestamped data points for visualization and analysis.

How to Use It: Enable the Time Series Property:

Add a Time Series Property to your Business Model. Each Business Object can now receive IoT data.

Send IoT Data via API: Use a POST request to send data to a specific Business Object:

POST https://api.mybusiness.ai/models/{MODEL_ID}/objects/{OBJECT_ID}/properties/{TIME_SERIES_PROPERTY_ID}

Replace:

{MODEL_ID}: Your Business Model ID.

{OBJECT_ID}: The target Business Object ID.

{TIME_SERIES_PROPERTY_ID}: The Time Series Property ID.

Example Request:

Headers:
Authorization: ApiKey {YOUR_API_KEY}
Content-Type: application/json

Body:
[
{
"value": 22.5,
"timestamp": "2025-03-15T10:00:00.000Z"
}
]

Get API Keys: Navigate to https://WORKSPACE.mybusiness.ai/system-integration/api-keys

Manual Data Entry (GUI):

Use the + (PLUS) button in the Business Object View to manually add data points with timestamps.

Visualize & Analyze Data View Data:

Navigate to the Time Series Property in the Business Object View.

The graph displays all data points, with timestamps on the X-axis and values on the Y-axis.

Filter by Time Range:

Use the start/end date pickers to focus on specific periods (e.g., yesterday’s data).

Interact with the Graph:

Zoom In: Left-click and drag to select a range.

Aggregation Rules: Data points are aggregated based on the selected time range:

≤10 minutes: No aggregation (raw data).

1–4 hours: Average per 30 seconds.

4–12 hours: Average per minute.

12 hours–7 days: Average per hour.

7–31 days: Average per day.

31 days: Average per month.

Key Notes Data Aggregation: Aggregation levels adjust automatically based on the selected time range.

Troubleshooting:

Missing Data? - Verify API permissions and network connectivity.

Graph Errors? - Check timestamp formatting (YYYY-MM-DDTHH:MM:SS.000Z).

Threshold Alarms Coming Soon: Set threshold values (e.g., >= 25°C) to trigger alarms (e.g., email notifications) when data exceeds the limit.

Data: 22.5°C → No alarm (22.5 <= 25).

Data: 26.5°C → Alarm triggered (26.5 >= 25).

See Model Designer