用語集

この用語集では、Things Cloudおよびドキュメント全体で使用される主要な用語と概念の定義を提供します。このページで、Things Cloudの製品、機能、技術用語に関する明確な説明を確認してください。

A

管理アプリケーション

Administration application

管理アプリケーションは、Things Cloud のデフォルトアプリケーションであり、プラットフォーム管理者がテナントを管理するための中心的な場所です。これは、ユーザー、ロール、権限の管理、アプリケーションおよびマイクロサービスのサブスクライブと管理、データ保持ルール、カスタムプロパティ、ブランディングなどのテナントレベル設定の構成によって、テナントを統制するために使用されます。

ドキュメントのプラットフォーム管理も参照してください。

開発者向け詳細
管理アプリケーションは、その機能のためにさまざまなREST APIを利用します。たとえば、ユーザー/ロール向けのUser API（/user/...）、テナント設定/オプション向けのTenant API（/tenant/...）、アプリケーション/マイクロサービス管理向けのApplication API（/application/...）です。ブランディングや機能トグルなど、UIで構成される多くの設定はキー・バリューのペアとして保存され、Tenant Options API（/tenant/options）で管理できます。

アラーム

Alarm

アラームは、ユーザーまたはシステムによる対応を必要とする状態を示します。アラームにはライフサイクルステータス（ACTIVE、ACKNOWLEDGED、CLEARED）と重大度（CRITICAL、MAJOR、MINOR、WARNING）があり、解決されるまでプラットフォーム内で明示的に追跡されます。

ドキュメントのアラームを扱うも参照してください。

開発者向け詳細
アラームは技術的にはイベントの特殊なタイプであり、Alarm API（/alarm/alarms）で管理されます。主なプロパティには type、text、time、status（ACTIVE、ACKNOWLEDGED、CLEARED）、severity（CRITICAL、MAJOR、MINOR、WARNING）があります。アラームの作成にはPOSTを使用し、ステータス更新には /alarm/alarms/{alarmId} に対するPUTを使用します。SmartRESTテンプレート（例：301-304）により、MQTT/HTTP経由での作成が簡素化されます。

分析ビルダー

Analytics Builder

分析ビルダーは、Things Cloud ストリーミング分析アプリケーション内のツールで、グラフィカルなドラッグ＆ドロップ環境でリアルタイム分析モデルを設計できます。事前構築されたブロックを組み合わせることで、ストリーミングIoTデータを変換し、新しいデータを生成し、アラートを作成し、またはデバイスオペレーションをトリガーするモデルを素早く構築できます。

ドキュメントの分析ビルダーも参照してください。

開発者向け詳細
分析ビルダーのモデルはAPIではなくユーザーインターフェースで作成します。分析ビルダーの挙動に影響するテナントオプションは、分析ビルダーの設定ドキュメントに記載されています。Analytics Builder Block SDKを使用して、カスタムブロックの作成、テスト、パッケージ化を行い、これらのブロックを分析ビルダーにアップロードできます。

Apama

Apama

Apamaは、Things Cloud ストリーミング分析を支える高性能なイベント処理エンジンです。リアルタイム分析を可能にし、スマートルール、分析ビルダーのドラッグ＆ドロップモデル、カスタムEPLアプリの基盤を形成します。

開発者向け詳細
Apamaエンジン上で動作するEPLコードは、EPL API（例：com.apama.cumulocity パッケージ）を使用して Things Cloud と連携し、プラットフォームデータの送受信を行います。EPLファイル（.mon）のデプロイは、ストリーミング分析UIまたはEPL Apps Toolsで管理されます。診断および監視は、/service/cep/diagnostics のような専用エンドポイント、またはトラブルシューティングと診断に記載のとおりPrometheusを使用して行えます。

アプリケーション

Application

アプリケーションはプラットフォームに統合されたコンポーネントであり、ユーザーインターフェース（= webアプリケーション）、ビジネスロジック（= マイクロサービス）、またはその両方を提供して、IoTソリューションを実現、拡張、またはカスタマイズします。アプリケーションはデバイスデータとユーザーのワークフローおよびビジネスプロセスを橋渡しし、遠隔監視、予知保全、アセット追跡、スマート自動化などのユースケースを支援します。Things Cloud のアプリケーション有効化ツールにより、ビジネスユーザーと開発者の双方がカスタムアプリケーションを構築してデプロイできます。

ドキュメントのアプリケーション有効化も参照してください。

開発者向け詳細
アプリケーション（webアプリ、マイクロサービス）は、Application API（/application/applications）で管理されます。これには、作成（POST）、取得（GET）、更新（PUT）、削除（DELETE）、コピー（POST /clone）が含まれます。アプリケーションバージョン（/application/applications/{id}/versions）およびバイナリ（/application/applications/{id}/binaries）にも専用エンドポイントがあります。

アプリケーションの可用性

Application availability

アプリケーションの可用性は、カスタムアプリケーションまたはマイクロサービスをどのように共有しアクセスできるかを定義します。上位テナント（すなわち、エンタープライズテナント（親テナント）またはマネジメントテナント）がこの可用性を管理し、自身のサブテナントとアプリケーションを共有します。

開発者向け詳細
アプリケーションの可用性は、Application API（/application/applications）で管理され、PUTリクエストで変更できます。

アプリケーションスイッチャー

Application switcher

アプリケーションスイッチャーは、Things Cloud 上でユーザーがアクセスできるすべてのアプリケーションを表示し、これらのアプリケーション間で切り替えることができるUIコンポーネントです。

開発者向け詳細
アプリケーションスイッチャーUIは、ユーザーがアクセス可能なアプリケーションを一覧表示します。この一覧は、ユーザー権限とテナントのサブスクリプションに基づいて作成され、GET /application/applications?user={userId} で取得されます。アプリケーションマニフェストのプロパティ noAppSwitcher（Application APIで管理）を使用すると、スイッチャーからアプリケーションを非表示にできます。

アセット

Asset

アセットは、機械、建物、車両など、Things Cloud のインベントリ内にあるビジネスオブジェクトのデジタル表現です。技術的には、アセットはマネージドオブジェクトであり、子アセット関係を使用して論理的な階層（アセット階層）に構造化できます。アセットは、整理のために使用される単純なグループ、テレメトリデータを送信するデバイス、またはデジタルツインマネージャー（DTM）のアセットモデルで定義される複雑なカスタムアセットなど、いくつかの形態を取ることができます。

ドキュメントのデジタルツインマネージャーも参照してください。

開発者向け詳細
アセットは、Inventory API（/inventory/managedObjects）内のマネージドオブジェクトとして表現されます。階層管理のために childAssets プロパティと、関連するエンドポイント（/inventory/managedObjects/{id}/childAssets）を使用します。デジタルツインマネージャーアプリケーション経由で作成されたアセットは、そのアセットモデルで定義されたカスタムフラグメントで拡張されます。

アセット階層

Asset hierarchy

アセット階層は、インベントリ内の構造であり、（アセットモデルに基づく）アセットおよびデバイスを整理して、工場が生産ラインを含み、それが個々の機械を含む、といった論理的またはビジネス上の関係を反映します。アセット階層は、アセット同士を入れ子にして親子関係（子アセット）を形成することで構築されます。これは、物理ネットワークトポロジ（子デバイス）をモデル化する通信階層とは本質的に異なります。

ドキュメントのアセット階層も参照してください。

開発者向け詳細
アセット階層は、Inventory APIの子アセット用エンドポイントによってリンクされたマネージドオブジェクトで構成されます: GET /inventory/managedObjects/{id}/childAssets、POST /inventory/managedObjects/{id}/childAssets、DELETE /inventory/managedObjects/{id}/childAssets/{childId}。DTMアプリケーションは、基盤となるアセットモデルとプロパティを管理するための専用 dtm-ms マイクロサービスおよびAPI（例：/service/dtm-ms/...）によってサポートされます。

アセットモデル

Asset model

アセットモデルは、デジタルツインマネージャー（DTM）で定義される再利用可能な設計図であり、特定の種類のアセットの構造、プロパティ、関係を規定します。これには一意のキーとラベル、アセットプロパティ、および（任意で）アセット階層の構成を支援するための子アセットモデルへの参照（例：ローターとタワーのサブモデルで構成される風力タービンモデル）が含まれます。公開後、アセットモデルは、そのタイプのアセットが Things Cloud のアプリケーション全体でどのように作成、検証、可視化されるかを統制します。

ドキュメントのアセットモデルも参照してください。

開発者向け詳細
アセットは、Inventory API（/inventory/managedObjects）内のマネージドオブジェクトとして表現されます。階層管理のために childAssets プロパティと、関連するエンドポイント（/inventory/managedObjects/{id}/childAssets）を使用します。アセット固有の特性は、カスタムJSONフラグメントを使用して定義されます。Asset definitionsも参照してください。

アセットプロパティ

Asset property

アセットプロパティは、アセットモデル内の構成可能な属性であり、アセットの特性を定義、記述、拡張します（例：風力タービンモデルの tower height）。これらは、テキスト、数値、日付、ファイル、ブール値、複合オブジェクト、またはカスタムなど、さまざまなデータ型を取ることができます。プロパティは、単純（単一値）、複合（入れ子構造）、またはカスタム（追加メタデータ）であり得ます。また、アセット間で一貫したデータ構造、メタデータ拡張、および統制された情報を確保するための再利用可能なビルディングブロックとして機能します。

監査ログ

Audit log

監査ログは、プラットフォーム上で実行されたセキュリティ上重要なアクションの記録です。監査ログはイベントの特殊なタイプであり、誰がアクションを実行したか（人のユーザー、デバイス、マイクロサービス、またはプラットフォーム自体）、使用されたアプリケーション、アクティビティ自体、および重大度の詳細を含みます。監査ログは、セキュリティ分析およびコンプライアンス監査のために、オペレーションの時系列かつ不変の履歴を提供します。

ドキュメントの監査ログも参照してください。

開発者向け詳細
監査ログは、Audit APIで管理されます。レコードは POST /audit/auditRecords で作成し、GET /audit/auditRecords で取得できます。ユーザー、タイプ、アプリケーション、日付範囲によるフィルタリングが可能です。監査レコードの作成には ROLE_AUDIT_ADMIN または AUDIT_ADMIN 権限が必要です。

認証

Authentication

認証は、Things Cloud プラットフォームへのアクセスを試みるユーザー、デバイス、またはアプリケーションのIDを検証するプロセスです。Things Cloud は、Basic認証、OAI-Secure（OAuth2ベースの実装）、外部IDプロバイダーとのシングルサインオン（SSO）統合など、複数の認証方法をサポートします。

ドキュメントの認証も参照してください。

開発者向け詳細
利用可能なすべての認証方法は、Tenant APIで、RESTエンドポイント PUT /tenant/loginOptions（CREATE）および POST /tenant/loginOptions/{typeOrId})（UPDATE）を介して構成されます。

認可

Authorization

認可は、認証済みのアイデンティティ（ユーザー、デバイス、またはアプリケーション）が、特定のリソースへアクセスしたり、特定のアクションを実行したりするために必要な権限を持つかどうかを判断するプロセスです。Things Cloud の認可は、権限がグローバルロールおよびインベントリロールに束ねられるロールベースアクセス制御（RBAC）モデルにより管理されます。

開発者向け詳細
認可は、ユーザーに割り当てられたロールに基づいてプラットフォームにより強制されます。これらのロールおよび関連する権限は、User API（/user/roles、/user/inventoryroles）で定義および管理されます。

可用性

Availability

可用性は、デバイスの接続ステータスを監視して、ONLINE、OFFLINE、またはステータスがUNKNOWNであることを示すことを指します。このステータスは、データの定期送信やプッシュ接続の維持などのデバイス通信パターンにより判定されます。

開発者向け詳細
接続ステータスは、デバイスのマネージドオブジェクト内の c8y_Connection フラグメントで公開されます。監視動作は c8y_RequiredAvailability フラグメントで構成され、必要な応答間隔（分）を指定します。

B

ブロック（分析ビルダー）

Block (Analytics Builder)

ブロックは、分析ビルダーのモデルにおける基本的な処理単位です。各ブロックは、センサーからデータを受信する、計算を実行する、条件を検出する、出力信号を生成するなど、あらかじめ定義された機能を実装し、それに応じてデータを処理します。各ブロックには、複数の入力、出力、および設定可能なパラメータがあります。分析ビルダーには、事前構築されたブロックのセットが付属しています。

開発者向け詳細
Analytics Builder Block SDKを使用して、カスタムブロックを作成、テスト、パッケージ化し、これらのブロックを分析ビルダーにアップロードできます。

ブランディング

Branding

ブランディングは、通常エンタープライズテナントまたは関連するアドオンで利用できる機能で、組織がプラットフォームのユーザーインターフェースを企業アイデンティティに合わせてカスタマイズできるようにします。これには、ロゴ、色、フォント、およびアプリケーションのドメイン名を変更して、一貫性のあるカスタマイズされたユーザーエクスペリエンスを提供することが含まれます。

開発者向け詳細
ブランディング設定は、ブランディングアプリケーション内のoptions.jsonというファイルで管理されます。このファイルには、管理者が設定できる色、ロゴ、フォント、その他のUI要素のキーを含むJSONオブジェクトが含まれています。

一括デバイス登録

Bulk device registration

一括デバイス登録は、デバイスの詳細を含むCSVファイルをアップロードすることで、各デバイスを個別に登録するのではなく、Things Cloudプラットフォームに多数のデバイスを登録する方法です。

C

変更ログ

Change logs

変更ログは、Things Cloud製品の変更およびアナウンスの公式記録であり、すべてのクラウドデプロイメント（継続的デプロイメント）向けに公開されます。新機能、改善、APIの変更または廃止予定などの更新内容を詳述します。これは、リリースノートに相当します。

変更ログを参照してください。

子アセット

Child asset

子アセットは、Things Cloudのインベントリのドメインモデルにおける関係タイプで、マネージドオブジェクト間に親子リンクを確立するために使用されます。この関係によりアセット階層が形成され、親アセットまたはグループが、ビジネスまたは論理的観点から従属するアセットまたはデバイスに接続されます。

開発者向け詳細
子アセットの関係はInventory APIで管理されます。主なエンドポイント: GET /inventory/managedObjects/{id}/childAssets、POST /inventory/managedObjects/{id}/childAssets、DELETE /inventory/managedObjects/{id}/childAssets/{childId}。

子デバイス

Child device

子デバイスは、Things Cloudのインベントリのドメインモデルにおける関係タイプで、通信階層を反映する親子リンクを確立するために使用されます。通常は（エージェントやゲートウェイであることが多い）親デバイスを、それが管理する下流のデバイスに接続します。

開発者向け詳細
子デバイスの関係はInventory APIで管理されます。主なエンドポイント: GET /inventory/managedObjects/{id}/childDevices、POST /inventory/managedObjects/{id}/childDevices、DELETE /inventory/managedObjects/{id}/childDevices/{childId}。

Cumulocity Developer Codex

Cumulocity Developer Codex

Cumulocity Developer Codexは、カスタムwebアプリケーションを構築する開発者向けの、Cumulocity IoTの包括的なデザインシステムです。Cumulocity Developer Codexは、UIガイドライン一式、再利用可能なAngularコンポーネント（Web SDK）のライブラリ、そしてスタイリングユーティリティを提供し、カスタムアプリケーションが標準のCumulocity IoTアプリケーションと一貫したルック&フィールおよびユーザー体験を維持できるようにします。

コックピットアプリケーション

Cockpit application

コックピットアプリケーションは、Things Cloudのデフォルトアプリケーションの一つです。アセットの管理、データの可視化、ダッシュボードの利用、レポートの管理など、ビジネスの観点からIoTアセットとデータを管理・監視するためのセルフサービスUIを提供します。

ドキュメントのCockpitも参照してください。

開発者向け詳細
コックピットのUIは、コアREST APIを使用します: アセット/グループ向けのInventory API（/inventory/managedObjects）、Measurement API（/measurement/measurements）、Event API（/event/events）、Alarm API（/alarm/alarms）。ダッシュボードなどコックピット固有の設定は、マネージドオブジェクトとして保存されます。

通信階層

Communication hierarchy

通信階層は、ネットワーク通信の観点からデバイスがプラットフォームにどのように接続されているかをモデル化します。これは子デバイスの関係を使用して構築され、通常はエージェントまたはゲートウェイが階層のルートを形成します。この構造は、アセット階層で表される論理的なビジネス構造とは対照的に、物理的またはネットワークのトポロジーを反映します。

ドキュメントのThings Cloudのドメインモデルも参照してください。

開発者向け詳細
通信階層は、Inventory APIのエンドポイント GET /inventory/managedObjects/{id}/childDevices、POST /inventory/managedObjects/{id}/childDevices、DELETE /inventory/managedObjects/{id}/childDevices/{childId} で管理されます。

構成管理

Configuration management

構成管理機能により、管理者およびアプリケーションはデバイスの設定をリモートで管理できます。これは通常、構成オペレーションを作成して適用することで実現します。

ドキュメントの構成の管理も参照してください。

開発者向け詳細
構成管理は主にDevice Control APIで処理されます。構成更新は、c8y_Configurationフラグメントを含む POST /devicecontrol/operations でオペレーションを作成して送信します。より大きなファイルの場合、構成を POST /inventory/binaries でアップロードし、その参照をオペレーションに含めることができます。

接続監視

Connection monitoring

接続監視機能により、Things Cloudプラットフォームとの通信を停止したdevicesを特定できます。接続ステータス（ONLINE/OFFLINE）は、デバイスのハートビートを監視するか、永続的なプッシュ接続のステータスを追跡することで判定されます。

開発者向け詳細
接続ステータスは、デバイスのマネージドオブジェクト内の c8y_Connection フラグメントを介して公開されます。監視動作は c8y_RequiredAvailability フラグメントで設定されます。デバイスが通信に失敗すると、プラットフォームは c8y_Connection.status を UNAVAILABLE に更新します。

Cumulocity IoT Sensor App

Cumulocity IoT Sensor App

Cumulocity IoT Sensor AppはiOSおよびAndroid向けの無料のスマートフォンアプリケーションで、スマートフォンを管理対象のIoTデバイスに変換し、スマートフォン本体、接続されたBluetoothデバイス、対応するOBDセンサーからのセンサーデータをリアルタイムに収集できるようにします。このデータをThings Cloudプラットフォームへ安全に送信し、デバイス登録、ライブデータの可視化、eventおよびalarmのトリガー、リモートデバイスオペレーションをサポートし、Things CloudのIoT機能を試すための簡単な入口を提供します。

ドキュメントのCumulocity IoT Sensor Appも参照してください。

D

ダッシュボード

Dashboard

ダッシュボードは、コックピットアプリケーションのようなアプリケーション内のカスタマイズ可能なビューで、さまざまなウィジェットで構成されます。データを可視化し、アセットを監視し、場合によってはアクションをトリガーするために使用されます。

詳細については、ドキュメントのダッシュボードの操作を参照してください。

開発者向け詳細
ダッシュボードは、インベントリ内で c8y_Dashboard フラグメントを持つマネージドオブジェクトとして保存されます。レイアウトやウィジェット設定を含む構成は、このマネージドオブジェクト内の複雑な JSON オブジェクトとして保存されます。ダッシュボードは、Inventory API（POST /inventory/managedObjects および PUT /inventory/managedObjects/{id}）で作成および更新されます。

データブローカー

Data broker

データブローカー機能は、エンタープライズテナント（親テナント） のオプション機能で、他のテナントと選択的にデータを共有することができます。

開発者向け詳細
ブローカー接続の設定は、管理アプリケーションを使用して行います。基盤となる REST API は feature-broker アプリケーション内部のもので、公開 API セットの一部ではありません。databroker-agent-server マイクロサービスがテナントにサブスクライブされている場合は、メッセージングベースのブローカーが使用されます。そうでない場合は、元のインメモリ実装が引き続き使用されます。

データエクスプローラー

Data explorer

データエクスプローラーは、特定のアセットまたは全てのアセットにわたる、メジャーメント、アラーム、イベントなどの IoT データを探索、比較、分析するための可視化ツールです。

詳細については、ドキュメントのデータエクスプローラーを参照してください。

開発者向け詳細
データエクスプローラーの UI コンポーネントは、データを取得して可視化するために Measurement API（/measurement/measurements および /measurement/measurements/series）を使用します。

データレイク

Data lake

データレイクは、Things Cloud DataHubの文脈で使用されます。データレイクは、オフロードされたデータのストレージコンテナとして機能します（例: ADLS Gen2/Azure Storage（Azure）、S3（Amazon）、NAS）。

開発者向け詳細
データレイクは外部ストレージであり、DataHub アプリケーションと Dremio を通してのみアクセスでき、API 経由ではアクセスできません。

データポイント

Data point

データポイントは、データエクスプローラーやダッシュボードなどの UI ビューで、特定のメジャーメントの時系列がどのように可視化されるかを定義する設定です。データポイントは、ラベル、色、単位、閾値の範囲など、メジャーメントストリームの表示方法を定義します。これらの設定は UI でカスタマイズすることも、データポイントライブラリでテンプレート化することもできます。

開発者向け詳細
データポイントは UI の概念であり、直接の API はありません。基盤となるデータは Measurement API（GET /measurement/measurements/series）を介して取得されます。可視化プロパティは、ダッシュボードのマネージドオブジェクト構成内、またはデータポイントライブラリ内に保存されます。

データポイントライブラリ

Data point library

データポイントライブラリは、アカウント全体でメジャーメントデータの可視化を標準化するために使用されるテンプレートのコレクションを提供します。各テンプレートは、フラグメントとシリーズにより識別される特定のメジャーメントを対象とし、視覚的なプロパティ（ラベル、色、単位、閾値範囲など）を定義します。これにより、任意のデバイスからの一致する時系列が一貫して表示されます。

詳細については、ドキュメントのデータポイントライブラリを参照してください。

デバイス

Device

デバイスは、Things Cloud プラットフォームに接続された物理的な機器を表す、特別なタイプのアセットです。デバイスは、データを送信でき、リモートオペレーションを受信できる点で、他のアセットとは異なります。

開発者向け詳細
インベントリでは、デバイスは c8y_IsDevice フラグメントでマークされたマネージドオブジェクト（/inventory/managedObjects）として表現されます。ID は Identity API（/identity/externalIds）で管理され、オペレーションは Device Control API（/devicecontrol/operations）で管理されます。また、送受信されるデータは Measurement API（/measurement/measurements）、Event API、Alarm API を介します。

デバイスエージェント

Device agent

デバイスエージェントは、デバイス固有の通信プロトコルを標準の Things Cloud REST または MQTT ベースのプロトコルに変換し、安全な双方向通信を可能にするソフトウェアコンポーネントです。デバイスエージェントは、デバイス自体（例: ゲートウェイ上）にデプロイすることも、Things Cloud プラットフォーム内のサーバーサイドマイクロサービスとして実行することもできます。

開発者向け詳細
インベントリでは、エージェントは com_cumulocity_model_Agent フラグメント（/inventory/managedObjects）でマークされたマネージドオブジェクトとして表現されます。エージェントは Device Control API（/devicecontrol/operations）と密接に連携して、自身および子デバイスのオペレーションを受信および更新し、しばしばリアルタイム通知（/cep/realtime）を使用します。

デバイス管理アプリケーション

Device Management application

デバイス管理アプリケーションは、Things Cloud のデフォルトアプリケーションの一つです。デバイスを接続、管理、監視する機能を提供し、リモートでデバイスを制御し、トラブルシューティングすることを可能にします。

詳細については、ドキュメントのデバイス管理アプリケーションを参照してください。

開発者向け詳細
デバイス管理 UI は、コア REST API（Inventory（/inventory/managedObjects）、Identity（/identity/externalIds）、Device Control（/devicecontrol/operations））およびデータ API（Measurement/Event/Alarm）を利用します。

デバイスプロトコル

Device protocol

デバイスプロトコルは、特定のデバイスタイプからのデータがどのように Things Cloud プラットフォームへ転送され、Things Cloud のデータモデルへ変換されるかを定義します。

開発者向け詳細
標準プロトコル（REST、MQTT）は、文書化されたパターンに従います。カスタムプロトコルでは、Inventory API を介して特定のマネージドオブジェクトを作成したり、専用のマイクロサービス API を使用したりする場合があります。

デバイス交換

Device replacement

デバイス交換機能により、元のデバイスに関連付けられた履歴データを失うことなく、物理デバイスを交換できます。

開発者向け詳細
デバイス交換プロセスは、Identity API（/identity/externalIds）を中心に行われます。これは、インベントリ内の同じマネージドオブジェクト ID を維持したまま、外部識別子を古いデバイスから新しいデバイスへ再マッピングすることを伴います。

デジタルツイン

Digital twin

デジタルツインは、物理アセットまたはシステムの仮想表現であり、接続されたデバイスからのリアルタイム IoT データで継続的に更新されます。このデータ駆動のデジタル対応物により、センサーメジャーメントをビジネスコンテキストと組み合わせることで、物理アセットの監視、分析、最適化が可能になります。

デジタルツインマネージャー (DTM)

Digital Twin Manager (DTM)

デジタルツインマネージャー (DTM) は、Things Cloud のスキーマベースのモデリングアプリケーションであり、ユーザーがデータモデルスキーマを作成および管理できるようにします。これらのスキーマは、アセット、プロパティ、およびその他のマネージドオブジェクトをモデリングするための設計図として機能し、プラットフォーム内で再利用可能なテンプレートとして機能します。

詳細については、ドキュメントのデジタルツインマネージャーを参照してください。

開発者向け詳細
DTM アプリケーションは、専用の dtm マイクロサービスと、アセットモデル、アセットプロパティ、アセットインスタンスのライフサイクルを管理するための専用 API（/service/dtm/）によってサポートされています。

ドキュメント

Document

Things Cloud は、マネージドオブジェクト、アラーム、メジャーメントなどのすべての運用データをドキュメントとして保存します。ドキュメントは、Things Cloud の REST API で使用される基本的な JSON 構造です。

開発者向け詳細
ドキュメントは一意の識別子を持つ多用途な JSON 構造であり、web アプリケーションや REST API の URL で参照可能です。主要なプラットフォームエンティティはすべて JSON ドキュメントとして表現され、特定の API エンドポイントを介して操作されます。

ドメインモデル

Domain model

ドメインモデルは、Things Cloud がさまざまな種類の情報（インベントリ、メジャーメント、イベント、オペレーション）をどのように構造化し、表現し、関連付けるかを定義する概念的フレームワークです。データは JSON ドキュメント内でモジュール化されたフラグメントとして整理され、柔軟な拡張とカスタマイズを可能にします。

詳細については、ドキュメントのThings Cloud のドメインモデルを参照してください。

開発者向け詳細
ドメインモデルは、コア REST API（Inventory、Measurement、Event、Alarm）を通じて実装および公開されています。データは JSON ドキュメント内でモジュール化されたフラグメントとして整理され、柔軟な拡張とカスタマイズを可能にします。

E

エンタープライズテナント（親テナント）

Enterprise tenant

エンタープライズテナント（親テナント）は、Things Cloudのテナント階層におけるテナントタイプであり、主に複数のサブテナントの管理に焦点を当てた高度な管理機能を提供します。エンタープライズテナント（親テナント）（「親」テナントと呼ばれることもあります）は、自身のサブテナントを作成、管理、請求でき、カスタムブランディング、カスタムドメイン名、ユーザー階層などの機能を有効にできます。

ドキュメントのEnterprise tenant administrationも参照してください。

開発者向け詳細
エンタープライズテナントでは、テナントドメインやメールテンプレートなどの詳細設定のために、特定の管理エンドポイントを使用します。サブテナント管理は、Tenant API（POST /tenant/tenants）を介して実行されます。サブテナントのアプリケーションおよびブランディングのサブスクリプションは、POST /tenant/tenants/{tenantId}/applicationsで管理されます。

EPL (イベント処理言語)

EPL (Event Processing Language)

Apama EPLは、Javaに似た構文を持つドメイン固有のイベント駆動型プログラミング言語で、リアルタイムにイベントを処理するプログラムを記述するために設計されています。Things Cloudでは、EPLロジックは通常、ストリーミング分析アプリケーション内のEPLアプリとして実装されます。

EPLアプリ

EPL Apps

EPLアプリは、Things Cloudストリーミング分析アプリケーションの一部です。これにより、Apama EPLを使用して、単一ファイルのEPLアプリケーションをThings Cloud内で直接開発でき、ストリーミング分析アプリケーションを定義するためのプロコード環境を提供します。

開発者向け詳細
EPLアプリは、ストリーミング分析UIで管理されます。Apama EPL Apps Tools GitHub repositoryには、コマンドラインまたはCI/CD環境からEPLアプリのテストやデプロイを支援するツールが含まれています。

イベント

Event

Things Cloudイベントは、デバイスまたはアセットの状態変化に関するリアルタイム情報を送信する、タイムスタンプ付きの情報レコードです。
Things Cloudイベントに加えて、Things Cloudプラットフォーム内では以下の種類のイベントが使用されます。

  • Apama（ストリーミング分析）では、「イベント」はすべてのインタラクションの基礎となるデータ構造です。
  • アラームは、イベントの特殊なタイプです。
  • 監査ログは、セキュリティに関連するイベントです。
開発者向け詳細
イベントは、Event API（/event/events）で管理されます。主要なプロパティには、type、time、text、sourceが含まれます。

エクスポート

Export

エクスポートは、コックピットアプリケーションの機能であり、メジャーメント、アラーム、イベントなどの限られた量のプラットフォームデータをCSVまたはXLSXファイルに抽出できます。エクスポートは、特定のデバイス、時間範囲、データフィールドに対するフィルターで設定できます。繰り返しエクスポートは、コックピットアプリケーションでスケジュールできます。

ドキュメントのExportsも参照してください。

開発者向け詳細
エクスポート設定は、Inventory API（/inventory/managedObjects）を介して、特殊なタイプのマネージドオブジェクトとして管理されます。オブジェクトのJSONペイロードには、エクスポートパラメータ（フィルター、フィールド、ファイルタイプ）とスケジュールを定義するフラグメントが含まれます。report-agentマイクロサービスは、これらのマネージドオブジェクトを読み取り、スケジュールされたエクスポートを実行します。UIからトリガーされる手動エクスポートも、このバックエンドサービスによって処理され、ユーザーにダウンロードリンク付きのメールが送信されます。

拡張機能

Extensions

拡張機能は、Things Cloudプラットフォームに新しい機能を追加する、公式またはコミュニティによってサポートされるパッケージです。拡張機能には、実行時に既存のアプリケーションに機能を追加するプラグイン、または新しいアプリケーションを作成するための事前設定されたUI機能の組み合わせであるブループリントを含めることができます。

分析ビルダーの拡張機能のアップロードについては、独自のブロックの作成を参照してください。

開発者向け詳細
個々の拡張機能はパッケージにバンドルされ、Application API（/application/applications）を介してアプリケーションとしてインストールされます。このパッケージには、マニフェスト内にisPackageフラグが含まれています。さらに、拡張機能はVersioning APIを使用して、アプリケーションに統合される際の互換性を確保します。

F

フラグメント

Fragment

フラグメントは、マネージドオブジェクト、イベント、オペレーション などの Things Cloud の中核データ型を拡張するために使用される JSON オブジェクトです。これらは、柔軟で拡張可能な ドメインモデル を作成するための主要な仕組みであり、固定的で事前定義されたデータベーススキーマなしに、あらゆる アセット や デバイス を表現できるようにします。

開発者向け詳細
フラグメントは他のリソース内に埋め込まれ、それぞれの API を介して親リソースの一部として管理されます（例: PUT /inventory/managedObjects/{id} によって c8y_Position フラグメントを更新します）。

フラグメントライブラリ

Fragment library

フラグメントライブラリは、例えば 構成管理 のようなデバイス管理アクティビティで Things Cloud 内で使用されるデータ構造を定義します。データ構造は、マネージドオブジェクト、オペレーション、およびその他のリソース内で使用できる フラグメント として表現されます。

ドキュメント内の フラグメントライブラリ も参照してください。

開発者向け詳細
フラグメントライブラリは、一般的なデバイス機能についてプラットフォームのデータモデルを定義する標準 JSON 構造（フラグメント）の、概念的でドキュメント化されたライブラリです。REST および SmartREST API を使用して統合を構築するための開発者向けリファレンスとして機能します。

G

グローバルロール

Global role

Things Cloud の 権限 モデルにおける ロール の一種で、テナント 内のすべてのデータに適用される権限を含みます。特定の アセット や グループ に対する権限を付与する インベントリロール とは異なり、グローバルロールはテナント全体に適用されます。

詳細については、ドキュメントの グローバルロール を参照してください。

開発者向け詳細
グローバルロールは User API を介して管理されます。/user/roles 配下に定義され、POST /user/users/{username}/roles によりユーザーに割り当てることができます。

グループ

Group

グループは、構造化および 権限 管理を目的として デバイス やその他のアセットを整理するために使用される、特殊な種類の アセット です。グループは柔軟な整理をサポートし、インベントリロール と組み合わせることで、含まれるデバイスやアセットへの ユーザー アクセスを許可または制限できます。

開発者向け詳細
インベントリ（Inventory API）では、グループはマネージドオブジェクト（/inventory/managedObjects）として表現され、c8y_IsDeviceGroup フラグメントを使用し、多くの場合 c8y_DeviceGroup タイプを持ちます。アセット、デバイス、またはサブグループは、子アセット参照（POST /inventory/managedObjects/{groupId}/childAssets）により割り当てられます。

I

インベントリ

Inventory

インベントリは、デバイスおよびアセットのすべてのマスターデータ（それらの構成や関係性を含む）を保存し、Things Cloud内の物理または論理エンティティのデジタルツインとして機能します。

開発者向け詳細
インベントリは、Inventory API (/inventory/managedObjects) を介して管理されます。マネージドオブジェクトの作成 (POST)、取得 (GET)、更新 (PUT)、削除 (DELETE) が可能です。

インベントリロール

Inventory role

インベントリロールには、インベントリ内の特定のデバイスまたはアセットのグループへのアクセスを許可する権限が含まれます。これにより、特定のアセットまたはデバイスグループと、それらに関連するデータに対して、きめ細かな認可が可能になります。

詳細については、ドキュメントのインベントリロールを参照してください。

開発者向け詳細
インベントリロールは、User API (/user/inventoryroles) を介して管理されます。/user/users/{username}/inventoryroles を介して、特定のマネージドオブジェクトグループに対してユーザに割り当てられ、ユーザID、グループID、インベントリロールIDが関連付けられます。

分離レベル

Isolation level

分離レベルは、マイクロサービスインスタンスがテナント間でどのように共有されるかを定義します。オプションは、「マルチテナント」（マニフェスト内の MULTI_TENANT）で、単一のインスタンスが複数のサブスクライブ済みテナントにサービスを提供するもの、または「テナントごと」（マニフェスト内の PER_TENANT）で、サブスクライブする各テナントごとに専用のインスタンスが作成されるものです。

開発者向け詳細
分離レベルは、マイクロサービスパッケージ内の cumulocity.json マニフェストファイルで構成される宣言的な設定です。

M

マネージドオブジェクト

Managed object

マネージドオブジェクトは、Things Cloudのインベントリの中核となる構成要素です。マネージドオブジェクトは、デバイス、アセット、論理的なグループ化、またはアプリケーションコンポーネントなどのエンティティを表現するために使用される主要なデジタルレコード（デジタルツイン）です。マネージドオブジェクトはデータソース（例えばIoTセンサー）をモデル化するために使用され、イベント、アラーム、オペレーションなど、マネージドオブジェクトにリンクされた関連データも含まれます。「ソースマネージドオブジェクト」と呼ぶ場合は、そのデータの発生源を表すマネージドオブジェクトを指します。

開発者向け詳細
マネージドオブジェクトは、Inventory API（/inventory/managedObjects）の中核リソースです。最小限のマネージドオブジェクトには名前が必要で、タイプやその他のフラグメントを含めることができます。例: {"name": "MySensor", "type": "temp_sensor", "c8y_IsDevice": {}}。

マネジメントテナント

Management tenant

マネジメントテナントは、Things Cloudの3階層テナント階層の最上位を構成し、通常はThings Cloudインスタンスを管理するオペレーションチームのみが利用できます。マネジメントテナントは、すべてのエンタープライズテナント（親テナント）を含むプラットフォーム全体のデプロイメントを管理し、プラットフォームレベルの排他的な管理機能を保持します。

開発者向け詳細
マネジメントテナントの完全な管理APIへのアクセスは、通常制限されています。エンタープライズテナント（親テナント）と同じコアAPI（例: /tenant/tenants）を使用しますが、プラットフォーム全体に対する昇格権限が付与されます。

メジャーメント

Measurement

メジャーメントは、センサーまたはデバイスから収集され、ソースマネージドオブジェクトにリンクされた、タイムスタンプ付きの読み取り値または統計です。メジャーメントは1つ以上のフラグメント（例: c8y_TemperatureMeasurement）に整理され、各フラグメントには、特定の観測プロパティに対する数値と単位を保持する1つ以上の系列（例: T）が含まれます。

開発者向け詳細
メジャーメントは、Measurement API（/measurement/measurements）を介して管理されます。POSTで作成され、ソースマネージドオブジェクトにリンクされます。X-Cumulocity-Processing-Modeヘッダーを使用して、一時的なメジャーメントを作成できます。

マイクロフロントエンド

Microfrontend

マイクロフロントエンドは、UIをより小さく独立してデプロイ可能なアプリケーションまたはプラグインへ分解するwebアプリケーションのアーキテクチャスタイルを指します。Things Cloudのweb UIはWeb SDKとともにこのアーキテクチャで構築されており、（Cockpitなどの）「シェル」アプリケーションが、他のwebアプリケーションから「リモート」モジュール（プラグイン）を読み込むことで拡張できるようになっています。

開発者向け詳細
マイクロフロントエンド（プラグイン）は標準のwebアプリケーションとしてパッケージ化され、Application API（POST /application/applications/{id}/versions）を介してZIPアーカイブとしてアップロードされます。cumulocity.jsonマニフェストには、isPackage: true と、利用可能なモジュールを定義するexportsセクションが含まれている必要があります。その後、他のアプリケーションは application remotes セクションで参照することで、そのマイクロフロントエンドをインポートできます。

マイクロサービス

Microservice

マイクロサービスは、バックエンドのビジネスロジックを実装したり外部システムとの統合を可能にしたりすることで、Things Cloudの機能を拡張するサーバーサイドのアプリケーションです。マイクロサービスは、Things Cloudのホスティング、セキュリティ、およびAPI管理に完全に統合されており、高可用性、スケーラブル、かつマルチテナント対応として設計できます。

詳細については、ドキュメントのマイクロサービスも参照してください。

マイクロサービスマニフェスト

Microservice manifest

マイクロサービスマニフェストは、マイクロサービスパッケージに含まれる必須のJSONファイル（cumulocity.json）です。プラットフォームがマイクロサービスのデプロイ、ライフサイクル、および統合を管理するために必要なメタデータを提供します。

詳細については、ドキュメントのマイクロサービスマニフェストも参照してください。

開発者向け詳細
cumulocity.jsonマニフェストファイルは、マイクロサービスのZIPアーカイブ内にパッケージ化され、POST /application/applications/{id}/binaries を介してアップロードされる静的な設定ファイルです。

マイクロサービスSDK

Microservice SDK

Things CloudマイクロサービスSDKは、開発者がカスタムマイクロサービスを効率的に構築するのに役立つツール、ライブラリ、およびドキュメントのセットです。Java向けに、Things CloudはSpring Boot統合を備えた専用SDKを提供します。このSDKは、プラットフォームに対する組み込み認証と堅牢なコンテキスト管理を提供することで開発を効率化し、安全でマルチテナント対応のアプリケーションを実現します。同時に、マイクロサービスは任意のプログラミング言語で開発できますが、Dockerコンテナとしてパッケージ化され、プラットフォーム要件に準拠している必要があります。

開発者向け詳細
Microservice SDKは開発ツールのコレクションです。マイクロサービス内からThings CloudコアとのREST API を利用したやり取りを簡素化するクライアントライブラリを提供します。

モデル（分析ビルダー）

Model (Analytics Builder)

分析ビルダーでは、モデルは、ドラッグ＆ドロップ環境で事前構築されたブロックをワイヤで接続して作成される分析ロジックの視覚的表現です。各ブロックは特定の機能を実行し、それらを組み合わせることで、受信データを変換、分析し、アクションを実行できるワークフローを形成します。モデルは、固定値の代わりにプレースホルダーを使用する再利用可能なテンプレートモデルとして設計できます。これらのプレースホルダーに具体的な値を指定すると、実行可能なモデルインスタンスが作成されます。

開発者向け詳細
分析ビルダーを参照してください。

マルチテナンシー

Multi-tenancy

マルチテナンシーは、ソフトウェアアプリケーションの単一インスタンスが複数の顧客（テナント）にサービスを提供するアーキテクチャです。Things Cloudでは、各テナントは物理的に分離されたデータ空間を持ちます。テナント間のデータ共有はデフォルトで無効であり、明示的に構成する必要があります（例: データブローカーを使用）。

詳細については、ドキュメントのマルチテナンシーも参照してください。

開発者向け詳細
マルチテナンシーはアーキテクチャ上の機能であり、主にTenant API（/tenant/tenants）を介してエンタープライズテナント（親テナント）によって管理されます。

N

Navigator

ナビゲータは、Things CloudプラットフォームのUIの左側にある要素です。現在使用しているアプリケーション内のさまざまなページに移動するためのメニュー項目のリストを提供します。

開発者向け詳細
ナビゲータはUIコンポーネントであり、直接のREST APIはありません。新しいメニュー項目（ノード）を追加するために、Web SDKのhookNavigatorプロバイダーを使用して拡張されます。

O

オフロードパイプライン

Offloading pipeline

オフロードパイプラインは、Things Cloud DataHub 内の設定可能なジョブであり、運用ストア内の特定のコレクションからデータを抽出し、それを変換し、データレイク内のターゲットテーブルにロードするプロセスを定義します。

開発者向け詳細
オフロードパイプラインは、Things Cloud DataHub アプリケーションの UI から設定および管理されます。パイプライン設定をプログラムで管理するための公開 REST API はありません。

オペレーション

Operation

オペレーションは、制御、設定、または保守などの特定のアクションを実行するために、デバイスまたはアセットへ送信される命令です。オペレーションは送信元のマネージドオブジェクトに関連付けられ、Things Cloud の信頼性の高いキューイングメカニズムにより非同期に配信されます。デバイスはオペレーションを実行して結果を報告し、一貫したリモート管理と自動化を可能にします。典型的なオペレーションには、新しいファームウェアのインストール、電力計内のリレーの切り替え、または自動販売機へのクレジットの送信があります。

オーナー

Owner

ユーザーがインベントリオブジェクト（デバイスやグループなど）を作成すると、そのユーザーは自動的にそのオブジェクトのオーナーになります。オーナーシップにより、その特定のオブジェクトに対してユーザーに完全な権限（ADMIN、READ、CHANGE）が付与され、作成したリソースを完全に管理できることが保証されます。

開発者向け詳細
オーナーシップは、プラットフォームのコア API によって適用される暗黙的な権限モデルです。ユーザーが POST /inventory/managedObjects を介してオブジェクトを作成すると、新しいオブジェクトの owner フィールドは自動的にそのユーザーの ID に設定されます。

P

権限

Permission

権限はThings Cloudにおけるアクセス制御の最も細かいレベルであり、特定の機能（例: アラーム、インベントリ）に対するアクセス権（例: READ、CREATE、ADMIN）を定義します。権限はユーザーに直接割り当てられるのではなく、ロールにグループ化されます。

ドキュメントの権限とロールの管理もご覧ください。

開発者向け詳細

権限はロールを介して付与され、ロールはUser API（/user/roles, /user/inventoryroles）で管理されます。 プラットフォームは各細分化された権限を一意の「permission」文字列で識別し、これはROLE_（例: ROLE_ALARM_READ）で始まります。

ユーザーに権限を付与するには、ROLE_ALARM_READのような必要な権限文字列を適切なグローバルロールまたはインベントリロールに割り当て、その後、そのロールを該当する権限を持つべきユーザーに割り当てます。

重要: 権限文字列は、API全体および設定ファイル（例: マイクロサービスマニフェストにはrequiredRolesフィールドが含まれます）で「ロール」として参照されることが頻繁にありますが、実際には権限を指しています。

処理モード

Processing mode

処理モードは、Things Cloudが受信データ（メジャーメントおよびイベント）をデータ永続化およびリアルタイム処理の観点でどのように扱うかを、クライアントが制御できる仕組みです。モードには、PERSISTENT（デフォルト）、TRANSIENT（処理して保存しない）、QUIESCENT（保存し、通知を抑制する）、CEP（一時的に処理し、通知を抑制する）があります。

開発者向け詳細
RESTでは、処理モードはX-Cumulocity-Processing-Mode HTTPヘッダーを使用して指定します。MQTTでは、処理モードを指定するために特定のトピック（s/, t/, q/, c/）が使用されます。

R

RBAC (Role-Based Access Control)

RBAC (Role-Based Access Control)

RBAC（Role-Based Access Control）は、Things Cloudで使用されるセキュリティモデルであり、権限がロールにグループ化され、これらのロールがユーザーまたはユーザーグループに割り当てられます。これにより、管理者はユーザーの役割や責任に基づいてアクセスを管理できます。

開発者向け詳細
RBACモデルは、ユーザーAPIを通じて実装および管理されます。/user/roles および /user/inventoryroles 配下のエンドポイントはロールの定義に使用され、/user/users/{username}/roles のようなエンドポイントはユーザーへの割り当てに使用されます。

リリースノート

Release notes

リリースノートは、各 Things Cloud のリリースごとに公開され、新機能、バグ修正、API変更の詳細が記載されます。リリースノートは、ユーザーが変更を追跡し、デプロイメントへの影響を理解するのに役立ちます。

レポート

Report

レポートはグローバルなダッシュボードであり、コックピットアプリケーションでアクセスでき、アセット階層に関係なくテナント全体で表示されます。レポートは、アプリケーション、アラーム、アセットなどのテナント全体のデータを可視化および追跡するための、ウィジェット用のカスタマイズ可能なコンテナとして機能します。

ドキュメントのレポートの操作も参照してください。

開発者向け詳細
レポートは、インベントリAPI（/inventory/managedObjects）を介してマネージドオブジェクトとして管理されます。基本的には、ダッシュボードの特別なタイプです。

REST API

REST API

Things Cloud REST APIは、HTTPおよびRESTを介して Things Cloud プラットフォームと他のシステム間の通信を可能にするインターフェースです。

利用可能なエンドポイントに関する技術的な詳細については、Things Cloud OpenAPI仕様を参照してください。

ロール

Role

ロールは、プラットフォーム上の認可レベルを決定するためにユーザーおよび/またはデバイスに割り当てることができる、権限の名前付きコレクションです。ロールは、Things Cloud のRBACモデルの中核コンポーネントです。プラットフォームでは、グローバルロール（テナント全体）とインベントリロール（インベントリ内のデバイスデータに固有）を区別します。

ドキュメントの権限とロールの管理も参照してください。

開発者向け詳細
ロールはユーザーAPIを介して管理されます。グローバルロールは /user/roles で管理され、インベントリロールは /user/inventoryroles で管理されます。 重要: プラットフォームは、各詳細権限を一意の「permission」文字列で識別し、これには ROLE_ という接頭辞が付きます（例: ROLE_ALARM_READ、ROLE_INVENTORY_ADMIN）。 これらの permission 文字列は、API全体および設定ファイル内で「ロール」として参照されることがよくありますが、実際には権限を指しています。

S

サービスユーザー

Service user

サービスユーザーは、テナントがマイクロサービスをサブスクライブするときに自動的に作成される、人間以外のユーザーアカウントです。これにより、エンドユーザーのセッションとは独立して、バックグラウンドタスクのためにREST API経由でマイクロサービスがテナントのデータとやり取りできます。

開発者向け詳細
マイクロサービスは、ブートストラップ認証情報を使用して /application/currentApplication/subscriptions に認証済みの GET リクエストを行うことで、サービスユーザーの認証情報を取得します。サービスユーザーを取得するには、サービスブートストラップユーザーを使用する必要があります。サービスブートストラップユーザーは、マイクロサービスランタイムの環境変数としてマイクロサービスにプロビジョニングされます。

スマートグループ

Smart group

スマートグループはグループの一種で、静的な割り当てではなく、定義された基準に一致するデバイスプロパティに基づいてメンバーシップが動的に決定されます。これはデバイス管理アプリケーションの機能です。

詳細は、ドキュメントのスマートグループの使用を参照してください。

開発者向け詳細
スマートグループは、フィルタクエリを格納する c8y_DynamicGroup フラグメントを含む、タイプ c8y_DeviceGroup の標準マネージドオブジェクトです。任意の時点でこのスマートグループに含まれるデバイスのセットを取得するには、インベントリAPIでフィルタクエリを実行する必要があります。

SmartREST

SmartREST

SmartRESTは、デバイスとプラットフォーム間でデータを交換するための、軽量なCSVベースのデバイスプロトコルです。SmartRESTは標準のMQTTを使用します。このプロトコルにより、メッセージフィールドをオブジェクトプロパティにマッピングするテンプレートを使用して、デバイスが構造化メッセージを送受信できるようになり、メッセージサイズを削減し、リソース制約のあるIoTデバイスの統合を簡素化します。

開発者向け詳細
デバイスは、Things Cloud と専用のMQTTトピックで通信します。CSVデータの各行は、特定の事前登録済みリクエストテンプレート、または豊富な組み込みテンプレート群のいずれかに対応するメッセージIDで始まります。

スマートルール

Smart rules

スマートルールを使用すると、コードを書かずにリアルタイムデータを分析し、事前定義された条件に基づいてアクションを実行できます。たとえば、メジャーメントが特定の閾値を超えたときにメールを送信したり、アラームを生成したりするルールを作成できます。

プラットフォームには、この機能の2つのバージョンがあります。

  • スマートルールコレクション: 固定のルールテンプレートセットを提供し、コックピットアプリケーションのシンプルなウィザードを使用して設定します。
  • スマートルール（NEW）プラグイン: 拡張可能で完全にカスタマイズ可能なルールテンプレートを提供します。これらは分析ビルダーで作成され、その後、（コックピットやデバイス管理などの）任意のアプリケーションでシンプルなフォームとして利用可能になります。

詳細は、ドキュメントのスマートルールコレクションまたはスマートルール（NEW）プラグインを参照してください。

開発者向け詳細
ルールは、コックピットやデバイス管理など、スマートルール（NEW）プラグインがインストールされているアプリケーションによって設定されます。スマートルールは、スマートルール（NEW）向けのApamaエンジンと、旧世代のスマートルール向けの「smartrule」マイクロサービスを基盤としています。

標準テナント（サブテナント）

Standard tenant

標準テナントは、テナント管理機能を持たないテナントです。エンタープライズテナント（親テナント）またはマネジメントテナントとは異なり、標準テナント（サブテナント） にはマルチテナンシー機能がなく、サブテナントを作成できません。

詳細は、ドキュメントの標準テナント管理を参照してください。

開発者向け詳細
標準テナントはコアREST APIを使用しますが、エンタープライズテナント（親テナント） および マネジメントテナント で利用できるマルチテナントの管理APIにはアクセスできません。

サブスクリプション

Subscription

Things Cloud においてサブスクリプションとは、管理アプリケーションからテナントに対してwebアプリケーションへのアクセスが付与されるプロセスを指します。上位テナント（エンタープライズテナント（親テナント）やマネジメントテナントなど）が、アプリケーションおよびマイクロサービスをサブテナントにサブスクライブします。

  • マイクロサービスの場合: サブスクリプションは必須の手順です。マイクロサービスは、利用可能になるためにテナントにサブスクライブされている必要があります。
  • webアプリケーションの場合: サブスクリプションにより、（コックピットアプリケーションなどの）共有アプリケーションまたはマーケットプレイスアプリケーションを特定のテナントで利用可能にします。

詳細は、ドキュメントのアプリケーションのサブスクリプションを参照してください。

開発者向け詳細
サブスクリプションは、テナントAPI（POST /tenant/tenants/{tenantId}/applications）およびアプリケーションAPI（POST /application/applications/{applicationId}/subscription）で管理されます。マイクロサービスは GET /application/currentApplication/subscriptions を使用して、サブスクライブされているテナントを一覧表示します。

サブテナント

Subtenant

サブテナントは、Things Cloud のテナント階層において、親テナント（エンタープライズテナント（親テナント）またはマネジメントテナントのいずれか）の下で作成および管理されるテナントです。

開発者向け詳細
サブテナントは、親 エンタープライズテナント（親テナント） または マネジメントテナント の管理者により、テナントAPI（/tenant/tenants）を通じて作成および管理されます。

T

テナント

Tenant

テナントはThings Cloud内の論理的に分離されたデータスペースを表し、通常は顧客や組織単位に対応します。テナントには独自のユーザー、デバイス、アプリケーション、およびデータ（Things Cloudのドメインモデルを参照）があります。

開発者向け詳細
テナントはTenant API（/tenant/tenants）で管理されます。これには、サブテナントの作成（POST）、詳細の取得（GET）、プロパティの更新（PUT）、削除（DELETE）が含まれます。テナント固有の構成はTenant Options API（/tenant/options）で管理されます。

テナントドメイン

Tenant domain

テナントドメインとは、<tenant-name\>.\<instance-name\> の形式でThings Cloudのテナントにアクセスするために使用されるドメイン名を指します。これはログインおよびAPIアクセスに使用され、テナントの一意の識別子（テナントID）とは異なります。たとえば、インスタンス cumulocity.com 上の “acme” という名前のテナントの場合、テナントドメインは “acme.cumulocity.com” になります。エンタープライズテナントおよびそのサブテナントは、プラットフォームのカスタムドメイン機能を使用して、アクセス用にカスタムドメインを任意で設定できます。

開発者向け詳細
テナントドメインは管理アプリケーションで構成され、Sslmanagementマイクロサービスをサブスクライブする必要があります。

テナント階層

Tenant hierarchy

テナント階層とは、Things Cloudにおいてテナントを整理する構造を指し、最上位にマネジメントテナント、その下にエンタープライズテナント（親テナント）、最下位に標準テナント（サブテナント）が配置されます。

ドキュメントのテナント階層も参照してください。

開発者向け詳細
テナント階層はTenant API（/tenant/tenants）を通じて管理されます。親テナントの下にサブテナント（POST /tenant/tenants）を作成すると、階層リンクが確立されます。

テナントID

Tenant ID

テナントIDは各テナントに割り当てられる一意の識別子です。テナントIDは認証のためにユーザー名のプレフィックスとして使用されることが多くあります（例：\<tenantID\>/\<username\>）。

テナントオプション

Tenant option

テナントオプションは、テナントに関連付けられた設定可能なキーと値のペアであり、プラットフォームの動作をカスタマイズしたり、アプリケーション設定を行ったり、テナント固有の構成を保存したりするために使用されます。

開発者向け詳細
テナントオプションはTenant Options API（/tenant/options）で管理されます。オプションは作成（POST）、取得（GET）、更新（PUT）、削除（DELETE）できます。 テナントオプションを暗号化する仕組みがあります。credentials. で始まるキー名でテナントオプションが作成されると、自動的に暗号化されます。マイクロサービスからオプションを取得すると、credentials. プレフィックスは削除され、値は、そのマイクロサービスが当該オプションの所有者である場合にのみ復号されます。

テナントポリシー

Tenant policy

テナントポリシーは、テナントオプションおよびデータ保持ルールの事前定義済みセットで、マネジメントテナントまたはエンタープライズテナント（親テナント）で作成でき、新しいサブテナントの作成時に適用して、一貫した初期構成を確保できます。テナントポリシーは管理アプリケーションで作成および管理されます。

ドキュメントのテナントポリシーも参照してください。

開発者向け詳細
テナントポリシーはインベントリに保存され、Inventory APIエンドポイント（/inventory/managedObjects）を通じて管理されます。ポリシーを作成または更新する際、リクエストボディは特定の形式に従う必要があり、たとえば c8y_TenantPolicy フラグメントを含める必要があります。

thin-edge.io

thin-edge.io

thin-edge.ioは、カスタムデバイス統合のためにThings Cloudが推奨するオープンソースのソフトウェアフレームワークです。特にデバイス側ロジックの実装に適しており、デバイスをプラットフォームに接続するためのコンポーネントおよびツールを提供します。

開発者向け詳細
thin-edge.ioはローカルのThings Cloudプロキシエンドポイントを公開し、デバイスコンポーネントがThings Cloud REST API全体にアクセスできるようにします。

Things Cloud コア

Things Cloud Core

Things Cloudコアは、Things Cloudプラットフォームの基盤です。デフォルトのアプリケーション（管理、コックピット、デバイス管理）、Things Cloud オペレーショナルストア、マイクロサービス、セキュリティ、REST API、MQTT API、スマートルールなど、すべての主要コンポーネントで構成されています。

開発者向け詳細
コア機能は、Things Cloud OpenAPI仕様に記載されている主要な REST API（Inventory API、Event API、Alarm API、Measurement API など）を介してアクセスされます。

Things Cloud DataHub

Things Cloud DataHub

Things Cloud DataHubは、Things Cloud オペレーショナルストアからデータレイクへ定期的にデータをオフロードし、データレイクの内容をクエリするためのThings Cloud アプリケーションです。

ドキュメントのDataHubも参照してください。

開発者向け詳細
DataHubは、Dremio エンジンへのクエリ関連リクエストをプロキシする REST API（/service/datahub/）を提供します。

Things Cloud Messaging Service

Things Cloud Messaging Service

Things Cloud Messaging Serviceは、パブリッシュ/サブスクライブ型のメッセージングバスであり、Things Cloudコンポーネント間、ならびにホストされたマイクロサービスおよび外部クライアントアプリケーションとの間で、疎結合かつ非同期なデータ転送を提供します。 とりわけ、データブローカー、Notifications 2.0、ストリーミング分析、およびMQTT Serviceで使用されます。

Things Cloud MQTT Service

Things Cloud MQTT Service

Things Cloud MQTT Serviceは、Things Cloudプラットフォームに出入りするすべてのMQTTプロトコルトラフィックのための統合エンドポイントです。 Things Cloudの「core MQTT」プロトコル（SmartRESTおよびJSON-over-MQTT）を実装するMQTTデバイスと、Things Cloud以外のプロトコルを実装する「generic」デバイスをサポートします。

ドキュメントのMQTT Serviceも参照してください。

開発者向け詳細
「generic」デバイスは、デバイスプロトコルとThings Cloudのドメインモデルとの間のマッピングを実装するカスタムマイクロサービスまたは外部クライアントを使用して統合されます。 マイクロサービスおよび外部クライアントは、Apache Pulsarのパブリッシュ/サブスクライブAPIを使用して、Messaging Serviceを介してMQTT Serviceとやり取りします。

Things Cloud OpenAPI仕様

Things Cloud OpenAPI Specification

Things Cloud OpenAPI仕様は、Things CloudにおけるREST APIの完全なOpenAPI仕様（OpenAPI 3.0標準に準拠）であり、https://developer.ntt.com/iot/docs/api/core/で利用できます。利用可能なエンドポイント、各エンドポイントでのオペレーション、各オペレーションの入出力、認証方式を含む、REST API全体を記述しています。

Things Cloud オペレーショナルストア

Things Cloud operational store

Things Cloudの内部データストアには、すべてのデータ（アラーム、イベント、インベントリ、およびメジャーメントなど）が「基本コレクション」として格納されます。

開発者向け詳細
オペレーショナルストアには、各データ型に対応する標準 REST API（/alarm/alarms、/event/events、/inventory/managedObjects、/measurement/measurements）を介して間接的にアクセスします。ストアへの直接 API アクセスは提供されていません。

Things Cloud ストリーミング分析

Things Cloud Streaming Analytics

Things Cloud ストリーミング分析アプリケーションを使用すると、受信データを即時かつリアルタイムに処理するための独自のロジックを追加できます。ユーザーは、分析ビルダーのモデルを作成したり、カスタムEPLアプリを記述したりして、データストリームの分析、新しいデータの生成、アラームの作成、デバイスでのオペレーションのトリガーを実行できます。

詳細については、分析 > ストリーミング分析を参照してください。

開発者向け詳細
ストリーミング分析は Apama 分析エンジンを基盤としています。設定には、監視と設定で説明されているテナントオプションを使用します。監視と診断には、トラブルシューティングと診断で説明されている専用 REST エンドポイント（/service/cep/diagnostics、/service/cep/monitoring）または Prometheus を使用します。

U

ユーザー

User

Things Cloud テナント内の個人アカウントで、一意のユーザー名によって識別されます。ユーザーには、データおよび機能へのアクセス権を決定する特定の権限を持つロールが割り当てられます。

開発者向け詳細
ユーザーは、ユーザーAPI（/user/users）を介して管理されます。これには、ユーザーの作成（POST）、取得（GET）、更新（PUT）、削除（DELETE）が含まれます。ロールの割り当ては、/user/users/{username}/roles のようなサブリソースを介して管理されます。

ユーザー階層

User hierarchy

ユーザー間の階層関係を作成できるオプション機能です。これにより、親ユーザーがサブユーザーを管理し、権限を委任できるようになります。

開発者向け詳細
ユーザー階層は、ユーザーAPI（/user/users）を介して管理されます。owner プロパティを指定してユーザーを作成/更新することで、階層が確立されます。

W

Webアプリケーション

Web application

Things Cloud Webアプリケーションは、Things Cloud プラットフォーム上でホストされる、ブラウザベースのアプリケーションです。これには、公式の Things Cloud アプリケーション（コックピット、デバイス管理、管理、ストリーミング分析 など）に加え、必要に応じて Things Cloud Web SDK を使用してお客様が構築するカスタムアプリケーションも含まれます。

開発者向け詳細
Webアプリケーションは、type: HOSTED で Application API（/application/applications）を介して管理されます。これらは、少なくとも index.html ファイルを含み、任意で cumulocity.json ファイルを含む ZIP アーカイブとしてアップロードされます。

Web SDK

Web SDK

Things Cloud Web SDK は、Things Cloud プラットフォームへのデプロイ向けに、拡張機能または Webアプリケーション を構築できるようにする開発フレームワークです。安全な API アクセス、デフォルトの UI コンポーネントへのアクセス、カスタムブランディングのサポートを提供し、開発者がプラットフォームのエコシステムとシームレスに統合し、一貫したユーザー体験を維持する、カスタマイズされたアプリケーションを作成できるようにします。

ドキュメントの Web SDK および Cumulocity Developer Codex も参照してください。

開発者向け詳細
Web SDK は Webアプリケーションを構築するための開発ツールキット（主に Angular ベース、@c8y/ngx-components、@c8y/client）です。API そのものではありませんが、フロントエンドアプリケーションからの API 利用を可能にします。すべてのパッケージは npm の @c8y スコープで確認できます。

ウィジェット

Widget

ウィジェットは、IoT データを可視化するために Things Cloud のダッシュボードに追加できる、設定可能な UI コンポーネントです。ウィジェットは、地図、画像、グラフ、テーブル、ならびにアラーム、メジャーメント、イベントなどのその他の情報を表示できます。

開発者向け詳細
ウィジェットは、ダッシュボードのマネージドオブジェクト内で設定される UI コンポーネントです。各ウィジェットの設定は、ダッシュボードデータ内の JSON オブジェクトとして保存されます。カスタムウィジェットは Web SDK を使用して開発します。ウィジェット専用の API はありません。

ワイヤー（分析ビルダー）

Wire (Analytics Builder)

分析ビルダーでは、ワイヤーは、あるブロックの出力ポートと別のブロックの入力ポートの間でデータを転送するために、2つ以上のブロックを互いに接続します。