ラベル機能

ラベル機能は、IoTサービス上で管理する「デバイス」に属性情報を付与する機能です。データ・エンリッチメントおよびステート管理の用途に利用可能です。

IoTサービスプラットフォームへ送信したセンサーデータに対し、お客様の指定したデータを付与(ラベル付け)し、データハブ転送、クラウドアダプタ転送、データストレージ蓄積を行うデータ・エンリッチメント機能。お客様は、ゲートウェイデバイス上のデータ送信プログラムを修正することなくコントロールパネルやWebAPI経由でラベル・データを「後付け」できます。データを「後付け」することでゲートウェイデバイスとIoT-PFの通信量を削減、通信帯域の低いセルラーLPWAなどの通信環境に活用することができます。
IoTサービス上でデバイスの状態をラベルとして管理・保持することで、デバイスのステート(状態)管理用途にも利用可能です。

対応IoTサービス機能（データ・エンリッチメント対象）

データハブ
データストレージ
クラウドアダプタ

ラベル機能の仕様

ラベルは、コントロールパネルとWeb APIで登録、追加、削除が可能です
1デバイスに対して追加できるラベルの数は、最大10までになります
ラベル機能を利用する場合、データハブ、データストレージ、クラウドアダプタの出力フォーマットは「JSON形式」を選択する必要があります。「未加工」を選択した場合、ラベル機能を利用できません。
項目名(Key)、値(Value)の2組み合わせをラベルとして登録できます。それぞれの最大文字数は、50文字、200文字までになります

ラベル登録例（データハブ）

ゲートウェイデバイスから送信するデータ

{
  "name": "温度",
  "value": 23.1,
  "namespace": "Default",
  "tags": {"sensor": "BME280"}
}
 

データハブからお客様システムへ送信するデータ（ラベル「型番：A-001」「拠点：東京」「設置場所：第一工場」を登録）

{
  "timestamp": 1551695375086,
  "serviceCode": "iot99999999",
  "id": "dvc-0123456789",
  "destination": "https://<お客様システム>/recvData",
  "simId": "050xxxxxxxx",
  "labels": {
    "型番": "A-001",
    "拠点": "東京",
    "設置場所": "第一工場"
  },
  "payload": {
    "name": "温度",
    "value": 29.5,
    "namespace": "Default",
    "tags": {"sensor": "BME280"}
  }
}
 

利用シーン

センサーデータとお客様システムマスタデータとの紐付
新たに設備の稼働情報をセンシングしはじめた際、既に稼働中の管理システムと設備センシングデータを紐付ける情報が必要になる場合があります。以下の図のように、お客様の生産管理システムデータベース上の「管理ID」を、IoTサービスのラベルとしてデバイスに登録しておくことで、既存の生産管理システム上のデータと、新規の設備稼働情報のデータを紐付けすることが可能となります。
時系列で変化する情報の動的な付与
Web APIでラベル情報を登録・更新できるため、時系列に変化していく情報もラベルとして登録することができます。以下の例のように、設備の稼働情報に「誰が」「何を」の情報をラベルとして登録しておくことが可能です。
デバイスステート管理
システムからIoTサービス上のデバイスのラベル情報をアップデート、実際の(物理)デバイスからラベル情報を参照し、状態に応じた実行制御を行うなどの利用シーンにも活用できます。
ラベル情報の参照方法は、Gateway API および Web API を参照してください。