Skip to content

Asset Management Service

Idea

Independent of your domain, the Asset Management Service supports you in creating digital representations of your physical assets. Such assets could be valves, engines, gas turbines, trains or buildings. The level of detail depends on your use case.

Access

For accessing this service you need to have the respective roles listed in Asset Management roles and scopes.

Basics

The API divides the functions into categories, for each category you can use a different controller. This section describes the controllers:

Aspect Types

An aspect type is a template for creating multiple aspects with the same variables. They can be used in asset types. You can configure, read or delete your aspect types. An aspect type is accessed by its ID. There are predefined aspect types, which are available for all users, but cannot be modified or deleted.

Asset Types

An asset type is a template for creating multiple assets with the same variables. You can configure, read or delete your types. An asset type is accessed by its ID.

Basic Types

The Asset Management Service provides basic asset types for users. These are predefined asset types, which are available for all users, but cannot be modified or deleted. The available basic asset types are documented in the References for Basic Types.

Default Values

The Asset Management Service allows you to assign default values to static (non-time series) variables and static aspect types of an asset type. They are applied following a type-instance concept, so that newly created assets are automatically assigned the default values of their asset type. These values can be overwritten on instance level, if required. Refer to the Samples for Using Default Values in Asset Types to learn more about what you can do with default values.

Assets

In MindSphere the following types of assets are distinguished:

  • Device types: represents a machine, or any object, from which data is collected
  • Agent types: represents the agent (software or physical device) measuring and collecting data of devices, machines, etc.
  • Hierarchy types: represents the hierarchy levels of an organization
  • Application types: used by other services to collect data of their applications (e.g., Edge Analytics Application)

Using the Asset Management Service you can configure, read and manage an asset or the root asset. You can also delete assets, except for root assets, which are deleted when their tenant is deleted. In addition, you can assign existing files to assets.

Hierarchy

The Asset Management Service supports hierarchical relationships between assets. Assets inherit their parent's type assignments, but not their assets. They can also overwrite the inherited type assignments. The Breadcrumbs feature returns the hierarchical path of an asset up to the root via all respective parent assets. This can be used as a navigational aid. An example implementation of hierarchical asset relationships is provided in Modeling Hierarchical Asset Structures.

Structure

The structure of an asset can only be read. It lists all aspects and variables without their values. You can configure the variables' values by updating the asset.

Location

You can define the location of your assets and update or delete the location data.

Files

You can upload files and assign these files to assets or asset types. One file can be used multiple times, or not at all.

Features

The Asset Management exposes its API for realizing the following tasks:

  • Create asset types as templates for assets
  • Define default values within asset types
  • Create and manage assets
  • Model complex asset structures using hierarchy
  • Upload and assign files to assets

Example Scenario

A brewery has moved a conveyor belt to a different location. A fixed installed camera takes images of the conveyor belt every 2 minutes.

The Asset Management API allows you to change the location of the conveyor belt. You can define a new aspect for the conveyor belt like production volume.

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.