Skip to content

TypeScript SDK - Overview

The library comes with the typescript SDK which can be used to access Insights Hub APIs.

It implements support for both frontend (browser e.g. angular, react...) and backend development in node.js while supporting different Insights Hub authentication types.

Frontend: - Browser (Session, Cookies)

Backend (node.js): - UserCredentials - AppCredentials - ServiceCredentials - Insights Hub Agents

The SDK implements the Clients for following APIs:

Platform Core APIs

Name SDK - Client Command
Identity Management ✔ ✔
Resource Access Management1 ✔ ✔
Oauth Authorization ✔ ✔
Tenant Management ✔ ✔
Token Management ✔ ✔
Message Broker2 (preview) ✔ ✔
Usage Transparency ✔

1 In the first stage of the availability Resource Access Management must be enabled for the tenant via Insights Hub support team.

2 Message Broker is only available on preview tenants

IoT and Storage

Name SDK - Client Command
IoT File ✔ ✔
IoT Time Series ✔ ✔
IoT TS Aggregates (v3, v4) ✔ ✔
IoT TS Bulk ✔ ✔
Integrated Data Lake ✔ ✔

Connectivity

Name SDK - Client Command
Agent Management ✔ ✔
MindConnect API ✔ ✔
Commanding API (sync) ✔ ✔
OPC UA PubSub ✔

Advanced Services

Name SDK - Client Command
Asset Management ✔ ✔
Event Management ✔ ✔
Notification ✔ ✔
WorkOrder Management ✔ ✔
Visual Flow Creator ✔ ✔

Analytics Services

Name SDK - Client Command
Anomaly Detection ✔ ✔
Data Exchange ✔ ✔
Event Analytics ✔ ✔
Job Manager ✔ ✔
KPI Calculation ✔ ✔
Model Management ✔ ✔
Signal Calculation ✔ ✔
Signal Validation ✔ ✔
Spectrum Analysis ✔ ✔
Trend Prediction ✔ ✔

MindConnect Open Edge

Name SDK - Client Command
Device Management ✔ ✔
Device Status ✔ ✔
Deployment Workflow ✔ ✔
Device Configuration ✔ ✔
Edge App Deployment ✔ ✔
Edge App Instance Management ✔ ✔
Firmware Deployment ✔ ✔

Semantic Data Interconnect

Name SDK - Client Command
SDI Data Management ✔ ✔
SDI Data Query ✔ ✔
SDI Semantic Modelling ✔ ✔

The example below shows how to use the SDK from browser:

// The example shows how to Get Assets from Insights Hub with custom AssetType
// using frontend authentication
// you can pass an instance an Authorizer
// (BrowserAuth, UserAuth, CredentialsAuth, TokenManagerAuth, MindConnectAgent)
// to use different authorization types in Insights Hub or implement the TokenRotation
// interface if you want to provide your own authorizer.
//
// The default constructor uses frontend authorization.

const sdk = new MindSphereSdk();
const am = sdk.GetAssetManagementClient();

const assets = await am.GetAssets({
    filter: JSON.stringify({
        typeId: {
            startsWith: `${tenant}`,
        },
    }),
});

// you will get fully typed assets in response

If an API is missing (and you would like to contribute a client for it), take a look at contributing to SDK.

Community

Connect and Collaborate with Industrial Professionals and Join the Community!

Click to load comments