Create a Pivot Entity

Before you begin

Register the device details and metrics that you want to use in the pivot entity using baseline entities.
  1. Register the device types and metrics using the supported_device_gateway and the metrics_device_type entities, respectively.
  2. Register the device groups for the device type using the M2M_groups entity. The group must belong to a device type that you want to use in the pivot entity.
  3. Register the devices in a group that you created for their device type.

Procedure

  1. In the main navigation menu, select ENTITIES.
    The ENTITIES workspace appears.

  2. Select Add new pivot entity.
    The Create Pivot Entity window appears.

  3. In the Pivot entity name box, enter a name, and then select Create. The name must contain at least one uppercase or lowercase letter.
    The pivot entity is created. By default, a few fields such as timestamp, device_id, instance_name, and other fields are added to the pivot entity. You cannot modify or delete them. You can, however, add more fields for the metrics that you want to record in the pivot entity.
  4. If you want to collect data from a specific device type:
    1. In the Get Data By box, select Device type.
      A drop-down list box appears next to the Device type box, displaying a list of device types that you have registered using the supported_device_gateway entity.
    2. Select the device type from which you want to collect data in the pivot entity.
  5. If you want to collect data from a specific device group:
    1. In the Get Data By box, select Device group.
      A drop-down list box appears next to the Device group box, displaying a list of device groups that you have registered using the M2M_groups entity.
    2. Select the device group from which you want to send data to the pivot entity.
  6. Create a field for each metric that you want to record (for example, pressure, temperature, and other metrics). The field name must match the metric name that you have registered using the metrics_device_type entity and the metric name that the device uses to send data. This name is case-sensitive.
  7. As needed, create additional fields in the pivot entity, and then select Save or Save And Exit.
    The changes made to the pivot entity are saved.

Results

In the ENTITIES workspace, appears in the row containing the pivot entity that you have created.

What to do next

Select to start collecting data in the pivot entity.