プラットフォーム連携

Studio が PlantPulse プラットフォームの設備データを読み取るための経路です。アプリでどのタグを使うかを選ぶとき、また連携が正常に動作しているかを確認するときに使います。

連携ステータス

GET /api/platform/health

プラットフォームに到達できるか、認証が有効かを確認します。アプリがデータを読み取れないとき、最初に確認すべき場所です。

データ探索

GET /api/platform/browse?path={path}

サイト → ライン → 設備 → タグ の順に階層を降りながら探索します。path は URL エンコードします。空の値の場合は最上位になります。

セマンティック階層

プラットフォームは設備構造をオントロジーとして保持しています。タグ名が現場ごとに異なっていても、意味で検索できるようにするための階層です。

メソッド	パス	機能
GET	/api/semantic/ontology	オントロジー全体
GET	/api/semantic/ontology?site={siteId}	1 サイトのツリー
GET	/api/semantic/search?q={질의}	意味ベースの検索

検索では次のオプションを指定できます。

オプション	意味
site	特定のサイトに限定
type	結果の種類に限定(設備、タグなど)
limit	結果の件数

タグ名を正確に把握していないとき — 「3 ラインのコンプレッサ吐出温度」のような言い方で — 検索する用途です。