ファクトリ管理
目次
- 概要
- 画面構成 — 6つのサブメニュー
- モデル画面 (
/model/index) - エセット画面 (
/asset/tree/index) - タグ画面 (
/tag/index) - オントロジー画面 (
/ontology/index) - メタデータ画面 (
/metadata/index) - 基準情報画面 (
/basedata/index) - ファクトリモデル確定
- 活用シナリオ
- よくある質問
- 関連画面
概要
Factory Modelグループは、工場の構造とドメインメタ情報（資産・タグ・オントロジー・メタデータ・基準情報）を登録・修正・削除する領域です。6つのサブ画面で構成され、すべて運営メタストレージに直接接続されます。
| サブメニュー | 内部URL | 用途 |
|---|---|---|
| モデル | /model/index | サイト追加 + 論理/物理モデルマッピング + モデル確定 |
| エセット | /asset/tree/index | 資産ツリー(サイト→区域→ライン→設備)の編集 |
| タグ | /tag/index | 登録済みタグ一覧・検索・一括削除・Excelエクスポート |
| オントロジー | /ontology/index | 資産分類体系(カテゴリ・メタ属性)の登録 |
| メタデータ | /metadata/index | ドメイン別ユーザー定義メタ属性キー-値 |
| 基準情報 | /basedata/index | コードマスタ・基準値の登録 |
運営開始前にこのメニューでサイト・資産・タグをすべて登録する必要があります。これにより、ダッシュボード・データポイント・アラームなどの他画面に意味を持つようになります。
画面構成 — 6つのサブメニュー
運営フロー:
[모델] → [에셋] → [태그]
사이트 추가 자산 계층 등록 태그 등록·매핑
│ │ │
└─────[온톨로지·메타데이터·기준정보 보강]──────┘
│
└→ [팩토리 모델 확정] (배포)
| 画面 | 使用頻度 | 開くタイミング |
|---|---|---|
| モデル | 中 | サイトを新しく追加する場合や、論理↔物理マッピングを調整する場合 |
| エセット | 高 | 資産階層・資産メタを変更する場合 |
| タグ | 非常に高 | タグ登録・修正・アラームバンド設定 — 最も頻繁に使用します |
| オントロジー | 中 | 分類体系を整備する場合 |
| メタデータ | 低 | ユーザー定義メタ属性を追加する場合 |
| 基準情報 | 低 | コードマスタを調整する場合 |
モデル画面 (/model/index)
上部ツール
🗂 모델 [✓ 팩토리 모델 확정] [💾 메타 스토어 백업] [↻]
| ボタン | 動作 |
|---|---|
| ファクトリモデル確定 | deployAssetToEvent() — 登録された資産/タグをイベントルールに適用し、ルールエンジンに反映（後述のファクトリモデル確定を参照） |
| メタストアバックアップ | backup() — メタストレージ全体をバックアップ（管理者保管用） |
| 更新 | refresh() |
案内ボックス
🏭 サイト追加および物理/論理モデル設定 インダストリアルデータを接続するファクトリ(サイト)を登録してください。次に、サイトに接続されたOPCやその他の産業プロトコルに接続して物理モデルを完成させてください。その後、物理モデルを論理モデルに置換することで、サイト構造の設定が完了します。
サイト一覧 (カードグリッド)
사이트 목록 [전체 N개의 사이트] [➕ 사이트 추가]
─────────────────────────────────────────────────
[ 사이트 카드 ] [ 사이트 카드 ] [ 사이트 카드 ] ...
各サイトカード(site-panel, 240px)に以下が表示されます。
| 領域 | 表示 |
|---|---|
| 上段 (site-title) | サイトID (黄色背景) |
| 本文 (site-body) | 🏭 サイトアイコン + サイト名 + 説明 — クリックするとそのサイトの資産/接続ツリーを下部にロード(loadTreeData()) |
| フッター (site-footer) | 🔧 修正(editSite()) / 📁 モデル削除(deleteModels()) / 🗑 サイト削除(deleteSite()) |
サイト追加フォーム
| 入力 | 説明 |
|---|---|
| 企業名 | サイトが属する企業。企業はインストールにつき1社のみです |
| サイトID | 英大文字/数字/_ のみ許可 — SITE_ で開始 |
| サイト名 | 人が識別するための名前 |
| 位置 | [地図から選択] で座標を選択します |
| 説明 | 自由テキスト |
| 運転状態 | 稼働状況の大きな段階 |
| サイトコード (ERP/MES) | ERP・MESで管理される工場コード (任意) |
| 住所 | 事業所住所 (任意) |
論理・物理モデル (左右ツリー)
サイトカードを選択すると、その下に2つのツリーが左右に展開されます。
左側 — エセット [論理モデル] (assetTreeDiv)
| 動作 | 動作ID | 説明 |
|---|---|---|
| モデルツリー更新 | loadTreeData(last_tree_site_id) | ツリーを再ロード |
| エセット検索 | searchItem('Asset') | ツリー上の検索入力欄をトグル |
| エセット追加 | showAddModal('Asset') | 新規エセット追加モーダル |
| エセット修正 | showModifyModal('Asset') | 選択したエセットを修正 |
| エセット削除 | deleteItem('Asset') | 選択したエセットを削除 |
論理モデルツリーは「サイト→区域→ライン→設備」として表示され、タグは設備に紐付けられます。運営者が意味的に構成する階層です。
データ階層は、その上にさらに企業を置いた5層構造ですが（V5 · MCP応答に記載）、コンソールのツリーには企業は表示されません。企業は地図(/map/index)とサイトフォームで修正します。
右側 — 接続 [物理モデル] (opcTreeDiv)
| 動作 | 動作ID | 説明 |
|---|---|---|
| 接続検索 | searchItem('OPC') | ツリー上の検索入力欄をトグル |
| 接続追加 | addOpc() | 接続管理 の登録フォームへ移動 |
物理モデルは「OPCサーバー→チャネル→タグ」形式の通信単位ツリーです。
論理 ↔ 物理マッピング
左側の論理資産ノードと右側の物理OPCタグをドラッグ/マッピングで接続します。このようにマッピングすることで、論理資産（例：ラインAのモータ）で発生したデータがどの物理タグ（例：OPC-LINE-AのPDI_001）から来ているのかをシステムが認識できます。
エセット追加/修正モーダル
左側ツールバーのエセット追加またはエセット修正ボタンを押すと、標準モーダルが開きます。V2026.05デザインシステムの適用により、モーダルのすべての様式が fieldset + form-stack 構造に統一されています。
┌─🏭 에셋 추가 및 수정─────────────────── × ─┐
│ │
│ ┌─🗂 상위 에셋──────────────────────┐ │
│ │ 상위 에셋 ID [읽기 전용] │ │
│ │ 상위 에셋 명 [읽기 전용] │ │
│ └──────────────────────────────────┘ │
│ ┌─📦 에셋 정보─────────────────────┐ │
│ │ 에셋 ID [입력] │ │
│ │ 에셋 명 [입력] │ │
│ │ 설명 [입력] │ │
│ └──────────────────────────────────┘ │
│ │
├──────────────────────────────────────────┤
│ [× 취소] [💾 저장] │
└──────────────────────────────────────────┘
| 領域 | 表示 |
|---|---|
| モーダルヘッダー | 🏭 アイコン + タイトル + × 閉じる |
| 上位エセット fieldset | 親ノードのID・名称 (読み取り専用 — ツリー選択値を表示) |
| エセット情報 fieldset | 新規エセットのID・名称・説明 (入力) |
| モーダルフッター | × キャンセル / 💾 保存 (保存時に saveForm('Asset')) |
すべての入力欄ラベルは
form-label control-labelクラスで統一され、幅・整列が一貫しています。他の画面のモーダル（ワークオーダー・イベント・勤務表など）も同様の fieldset + form-stack パターンを使用します。
エセット画面 (/asset/tree/index)
資産ツリーを詳細に編集し、資産単位のメタ・タグ・接続関係を一つの画面で定義します。 左側にツリー、右側に詳細フォーム + タイムライン + 子テーブル/タブが配置されます。
| 番号 | 場所 | 機能 |
|---|---|---|
| ① | 左上 | サイトセレクター — どのサイトのツリーを表示するか選択します |
| ② | 左側本文 | 資産ツリー — サイト → 区域 → ライン → 設備。ノードを選択すると右側が切り替わります |
| ③ | 左下 | オブジェクトID — ツリーでマウスホバーしたノードのドメインIDがここに表示されます |
| ④ | 右上 | エセット情報 — 選択したノードの基本情報・状態カード・イメージ。上の図は設備を選択した状態で、何も選択していない場合は «エセットを選択してください» という案内のみが表示されます |
| ⑤ | 右上端 | 保存 — ④ で修正した内容を保存します |
| ⑥ | 右下 | タイムライン — その資産の接続・健全状態の推移 |
| ⑦ | 画面右上 | ファクトリモデル確定 — 編集したモデルをエンジンに反映します (後述) |
上の図がその状態です — 「エセットが選択されていません」。故障ではありません。
左側 — 資産ツリー
🗂 모델 — 사이트 → 구역 → 라인 → 설비 [💬] [🔍] [📋]
사이트: [▼]
[에셋 트리 / 연결 트리]
─────────────────────
🔗 오브젝트 ID: - ← 트리에서 호버 시 도메인 ID 표시 (footer)
| ヘッダーアイコン | 動作 |
|---|---|
| 💬 (吹き出し) — タグ説明表示 | ツリーにタグノードの説明を併記するかをトグル |
| 🔍 検索 | ツリー内テキスト検索入力窓をトグル |
| 📋 コピー | 選択されたタグ名をクリップボードにコピー |
右側 — エセット詳細フォーム + タイムライン + 子/タブ
空の状態 — エセット未選択
左側ツリーでどのノードも選択していない場合、右側の詳細領域に空状態の案内が表示されます。
🟦 (큐브 아이콘)
에셋이 선택되지 않았습니다
왼쪽 에셋 트리에서 [에셋명을 선택]하여 주십시오.
エセット情報パネル — フルカラーグラデーション状態カード 2枚
資産を選択すると、パネル本文の最上段にメタ1行（タイプ + 登録/修正日）+ 接続状態 / 健全状態 の2つのカードが左側に表示されます。
| カード | アイコン | 表示 |
|---|---|---|
接続状態 (connection_status) | 📶 Wi-Fi | フルカラーグラデーション — 🟢 正常 / 🟡 遅延 / 🔴 異常 / ⬛ 断線 / ⚪ 不明 |
健全状態 (health_status) | 💗 ハートビート | フルカラーグラデーション — 🟢 正常 / 🟡 注意 / 🔴 危険 |
各カードは「アイコン + ラベル + 値（例："正常接続", "危険"）」の形式でグラデーション背景に表示され、遠くからでも色だけで状態を即座に確認できます。
資産イメージ (右側)
イメージが登録されている場合はSVG/PNGで表示されます。ない場合は空状態が表示されます。
🖼 (이미지 아이콘)
이미지 없음
선택한 노드에 등록된 이미지가 없습니다.
基本情報パネル (入力)
| 入力 | path | プレースホルダー/説明 |
|---|---|---|
| エセットID | asset_id | 読み取り専用 |
| エセット名 | asset_name | プレースホルダー: 예) 조립 1라인 (한글·영문·숫자·공백·_ . - ( ) & , / :) |
| 設備分類 | asset_class_code | この階層の分類 — セレクター。リストは 基準情報 の該当階層分類タブです |
| 説明 | description | 自由テキスト |
エセットイメージパネル
| コントロール | 動作 |
|---|---|
| 📂 ファイル選択 | PNG/SVGを選択 (推奨 640×320) |
| ☁ アップロード | 選択したイメージをその資産に登録 |
タイムラインパネル — 時間推移
資産選択時にその下にタイムラインパネルが表示されます。パネルヘッダーに期間(from_to)の案内があり、本文に横棒タイムライン + 右側に5種類の凡例が表示されます。
| 凡例 | 色 | 意味 |
|---|---|---|
| 不明 | ⚪ グレー | 受信履歴なし |
| 正常 | 🟢 緑 | 異常なし |
| 注意 | 🟡 黄 | 警告アラーム存在 |
| 危険 | 🔴 赤 | 重大アラーム存在 |
| 断線 | ⬛ 濃赤 | 24時間以上未受信 |
パネル本文左上の ⓘ 情報アイコンにマウスを合わせると、接続状態5段階 + 健全状態3段階のマッピング表が大きなツールチップで表示されます。
固有属性タブ — 階層ごとの属性
サイト・区域・ラインを選択した場合、右側のタブには固有属性のみが表示されます。設備の場合は、他のタブと共に一番右端に配置されます。 その階層だけが持つ属性と共通項目をここで修正し、下の固有属性保存で保存します。修正はADMINのみ可能です。
| 番号 | 場所 | 機能 |
|---|---|---|
| ① | タブ列の末尾 | 固有属性タブ |
| ② | タブ本文 | 階層別属性(図は設備) ・ 担当 ・ 運転状態 ・ 外部番号 |
| ③ | 右下 | 固有属性保存 |
| 階層 | 項目 |
|---|---|
| サイト | タイムゾーン(空欄時はインストールタイムゾーン) ・ 国 ・ サイトコード ・ 住所 ・ 緯度 ・ 経度 |
| 区域 | 機能(生産 / 保管 / ユーティリティ) ・ 担当者 |
| ライン | 種類(生産ライン / プロセスセル / 生産ユニット) ・ 設計速度(時間あたり, 値と単位を併記) ・ 担当者 |
| 設備 | 製造元 ・ モデル ・ シリアル番号 ・ 機能位置 ・ 重要度(A高 / B中 / C低) ・ 設置日 ・ 稼働開始日 ・ 保証終了日 |
| 共通 | 外部システム + 外部ID(セットで入力または空欄) ・ 運転状態 |
| 項目 | 注意点 |
|---|---|
| 運転状態 | 計画 · 試運転 · 運営中 · 待機 · 使用停止 · 廃棄(ISO 14224)。稼働状況の大きな段階であり、運転・停止などのリアルタイム状態や、アラームのサービス除外とは異なります |
| 機能位置 | この設備が担う位置の番号。サイト内で唯一である必要があります |
| 実際の担当 | 区域・ライン・設備に表示される読み取り専用項目。自身の担当が空欄の場合、最も近い上位(ライン → 区域)の担当を引き継ぎます。担当者の入力欄は区域・ラインにのみ存在します |
下位エセットリスト (SITE/AREA/LINE 選択時)
SITE / AREA / LINE ノードを選択した場合にのみ表示されます。
| カラム | 幅 | 表示 |
|---|---|---|
| エセットID | 250px | 子資産のID (ドメインバッジ) |
| エセット名 | 250px | 子資産の名前 |
| 説明 | 自動 | メモ |
EQUIPMENT 選択時 — 13個のタブパネル
設備(EQUIPMENT)ノードを選択すると、子テーブルの代わりに13個のタブパネルが表示されます。
| タブ | アイコン | パネル | 内容 |
|---|---|---|---|
| ① 接続 | 🌐 | マッピングされた接続リスト | この設備に接続されたOPC/PLC/Modbusなどのデータソース — 接続状態・ID・名称・タイプ・サーバーIP |
| ② タグ | 🏷 | マッピングされたタグ | 設備にマッピングされたタグと 現在値・単位・データタイプ・最終更新日時 |
| ③ データ | 🗄 | 最新データ | 最近収集された時系列スナップショット (タイムスタンプ · データJSON) + [トレンド移動] |
| ④ アラーム | 🔔 | 最新アラームリスト | 設備マッピングタグで発生したアラーム (SEQ · アクティブ · 重要度 · 内容) + [アラーム移動] |
| ⑤ イベント | 📅 | 最新イベントリスト | ステートメント・プラグインが発生させた イベント (イベント名 · 色・開始時間 · 持続時間[MS]) |
| ⑥ 状態 | 👁 | 最新状態リスト | ステートメントが追跡する キー・値コンテキスト |
| ⑦ 集計 | 🥧 | 最新集計リスト | ステートメントが蓄積した 集計キー・値 |
| ⑧ コマンド | 🎮 | コマンド実行 + 最新命令リスト | 定義されたコマンドを この設備で実行 — 設備命令 |
| ⑨ レジストリ | 💻 | エセットステートメント + 命令レジストリ | EQLステートメント・ISOプラグイン登録 · この設備の 意味コマンド定義 |
| ⑩ ドキュメント | 📄 | エセットドキュメント | 設備添付文書管理 |
| ⑪ 整備 | 🔧 | 設備整備 | この設備の整備オーダー |
| ⑫ 基準値 | 📏 | 基準値 | この設備の標準値プロファイル |
| ⑬ 固有属性 | ☑ | 固有属性 | 前節 + QRラベル |
イベント・状態・集計の3つのタブは、ステートメント(またはISOプラグイン)が生成したものを表示します。 その設備にステートメントを一つも紐付けていない場合、3つのタブすべてが空であるのが正常です。 ⑨ レジストリタブで [ステートメント追加] · [ISOプラグイン] を選択して紐付けてください。
⑦ 集計はタグの «集計» 設定とは異なります。 タグ集計(1分/5分/…)は トレンド画面 で確認してください。
定義されたコマンドを選択し [実行] を押すと、PLCに値が 実際に書き込まれます。 権限・パラメータ・事前条件・インターロックゲートおよび拒否コードは 設備命令 で別途扱います。実行パネルは ADMIN · MANAGER にのみ 表示されます。
タグ画面 (/tag/index)
登録されたすべてのタグを検索・一括削除・Excelダウンロードする画面です。
上部ツール
🏷 태그 [전체 N개] [✓ 팩토리 모델 확정]
| ボタン | 動作 |
|---|---|
| 全 N件 | 登録タグ数 (千単位カンマ) |
| ファクトリモデル確定 | deployAssetToEvent() — モデル画面と同一 |
リストパネルヘッダーの右側には 選択したタグ削除 / Excelダウンロード / 更新 の3つのボタンがあります。
検索フォーム (マルチフィルタ)
| 入力 | id | 幅 | オプション |
|---|---|---|---|
| サイト | site_id | 180px | 登録サイト — 常に1つが選択されています |
| 区域 | area_id | 180px | すべての区域 + 区域 (サイト変更時に自動更新) |
| ライン | line_id | 180px | すべてのライン + ライン (区域変更時に自動更新) |
| 設備 | equipment_id | 180px | すべての設備 + 設備 |
| 接続 | opc_id | 180px | OPC選択 + 登録OPC |
| タグID | tag_id | 180px | プレースホルダー: "タグ ID" |
| タグ名 | tag_name | 180px | プレースホルダー: "タグ名検索 ..." (オートコンプリート) |
| データタイプ | java_type | 180px | INT/FLOAT/STRING/BOOLなどのセレクター |
タグテーブル (10カラム + アクション)
| カラム | 幅 | 表示 |
|---|---|---|
| 選択 | 50px | 一括削除用チェックボックス |
| No. | 40px | 行番号 |
| タグID | 100px | ドメイン識別子 |
| タグ名 | 300px | 人が読みやすい名前 |
| データタイプ | 80px | String/Short/Integer/Long/Float/Double/Boolean/Date |
| ポイント件数 | 80px | 累積受信件数 |
| アラーム件数 | 60px | 累積アラーム件数 |
| 現在値 | 60px | 最終受信値 |
| 単位 | 40px | 測定単位 (°C, kPa, rpmなど) |
| 最終更新日時 | 160px | 最終受信時刻 |
| アクション | 60px | 🔧 修正 / 🗑 削除 — ADMIN にのみ表示されます |
リストに 説明 と 遅延 [MS] カラムはありません。タグ説明は タグ詳細 で、 遅延は 接続管理 の接続済みタグリストで確認してください。
アクションカラムは
ADMINのみが 閲覧可能です。USERとAPIの役割ではカラムごと消えるため、 修正・削除アイコンが表示されない場合は権限の問題です。
タグ登録/修正様式 (/tag/form)
タグ様式は、画面上部に 基本情報パネル + 下部に 9つのタブ で構成された2段構造です。
この画面は 一つのフォームではありません。 基本情報パネルと9つのタブが それぞれ自身のフォーム(form-metadata,
form-link, form-alarm …)を持っており、各パネル右下の 保存 ボタンは そのパネルだけ を
サーバーに送信します(POST /tag/updateMetadata/{tag_id} のようにタブ別エンドポイント)。
複数のタブを修正して最後に1回だけ保存ボタンを押すと、他のタブの変更内容は破棄されます。 タブを修正するたびに そのタブで保存 してください。保存が完了すると、右上に緑色のトーストが表示されます。 トーストが表示されなかった場合は保存されていません。
上段 — 基本情報パネル (常時表示)
| 入力 | 説明 |
|---|---|
| タグID | 英数字/_ (修正モードでは読み取り専用) |
| タグ名 | 必須。人間識別用 |
| データタイプ | String / Short / Integer / Long / Float / Double / Boolean / Date |
| タグ説明 | 自由テキスト (100文字) |
パネルヘッダー右側に タグ表示 ボタン — 即座に タグ詳細画面 へ移動。
パネル下段の保存は、これら4つの項目のみを保存します(/tag/updateBasic)。
下段 — 9個のタブ
番号は画面上の左から右への順序です。
| タブ | アイコン | 保存対象 | 機能 |
|---|---|---|---|
| ① タグ属性 | ☀ | updateMetadata | タグタイプ・タグソース・エイリアス・単位・表示フォーマット・小数点・最低/最高値・周期[MS]・IOアドレス・元タグ名・経緯度 |
| ② リンク | 🔗 | updateLink | このタグを 設備にマッピング — 以下参照 |
| ③ アラームバンド | 🔔 | updateAlarm | 閾値6段階 (数値型) / TRUE·FALSE条件 (Boolean) + メッセージ・受信者・抑制・メール/SMS |
| ④ 計算 | 🧮 | updateCalculation | 仮想タグ計算式 (EQL, CodeMirrorエディタ) + 使用有無 — 仮想タグ |
| ⑤ サンプリング | 💉 | updateSampling | 使用有無のみ — オンにすると周期ごとの最終値をサンプリングして保存 |
| ⑥ 集計 | 🪙 | updateAggregation | 使用有無 + 集計周期 1分 / 5分 / 10分 / 30分 / 1時間 を選択 |
| ⑦ 人工知能 | 🧠 | updateAi | LLMベースリアルタイム異常診断 の対象カラム / 分岐カラムを指定 |
| ⑧ 発行 | 📬 | updatePublish | Kafka発行 · MQTT発行 の2つのトグル |
| ⑨ ノート | 💬 | updateAttribute | タグに関する自由形式メモ |
① タグ属性タブ — 4 fieldset
| fieldset | 項目 |
|---|---|
| タグ属性 | タグタイプ · 重要度 · タグソース · メトリクス使用 |
| データ属性 | エイリアス · 単位 · 表示フォーマット · 小数点丸めモード · 小数点スケール · 最低値 / 最高値 · 周期 [MS] · 読み/書き |
| IOおよび元OPCタグ名 | IOアドレス (PLC管理用) · 元タグ名 |
| 位置 | 緯度 / 経度 — [地図から選択] ボタンで地図を開き座標を指定します |
min_value / max_value は 範囲外の値をブロックしません。 画面ヘルプの通り
«最低/最高値を入力すると ゲージチャートの基準 として表示されます» — キャンバスゲージウィジェットの
目盛りの両端を決定する値です。値をフィルタリングしたい場合はアラームバンドや計算式を使用してください。
周期 [MS] も収集周期を «変更する» 値ではなく、このタグがどの程度の間隔で受信されるかを 記述しておく値 です。実際のポーリング間隔は接続(OPC/Modbus/PLC)側の設定で決定します。
エイリアスを指定すると、その名前が イベントとエセットデータのカラム名 になります。 EQLで照会した際に表示される名前が変わるため、既に使用されているタグのエイリアスは不用意に変更しないでください。
② リンクタブ — 設備マッピング (OEE·RAM·EMS の前提条件)
| 項目 | 説明 |
|---|---|
| 設備検索 | 設備IDまたは名称で検索して選択 (例: EQUIPMENT_000001, 사출기 #3) |
| 現在マッピングされた設備ID | 読み取り専用 — 設備を選択すると linked_asset_id が自動更新されます |
| マッピング解除 | マッピングを解除します |
リンク対象は 設備(asset_type='M') のみです。ラインや区域にはマッピングされません。
マッピングされた設備は OEE / RAM / EMS 分析でこのタグのデータを使用します。言い換えれば、 タグを設備にリンクさせないと、そのタグはISO分析に捕捉されません — 分析結果が 空に見える場合にまず確認すべき箇所です。
③ アラームバンドタブ — 5 fieldset
画面警告文の通りです — «データタイプがナンバー(Short, Integer, Long, Float, Double)
タイプおよびブーリアン(Boolean)である場合のみ、バンドアラーム設定が可能です。» String · Date タグには
アラームバンドを設定できません。そのようなタグを監視する場合は 高度なアラーム を使用してください。
アラーム設定は タグ一つ に対して設定されます。複数のタグを組み合わせた条件（例：入口 − 出口圧力）にアラームをかけたい場合は、 まずその組み合わせを 仮想タグ として作成し、アラームは仮想タグに対して設定します。
閾値 / ブーリアン条件
数値型タグには1本のグラフィカルなバーが表示され、min_value 〜 max_value の範囲内で
lo_lo · lo · hi · hi_hi がどの色帯域にマッピングされるかを保存前に確認できます。
[ ███ lo_lo ████ lo ════════════ 정상 ════════════ hi ████ hi_hi ███ ]
🔴 심각 🟠 경고 🟢 정상 🟠 경고 🔴 심각
| 項目 | 説明 |
|---|---|
lo_lo / hi_hi | 重大アラーム閾値 — トリップ(Trip)前の最終警告線 |
lo / hi | 警告アラーム閾値 |
trip_lo / trip_hi | トリップ(設備停止命令)閾値 — アラームを超えてアクションが発生 |
use_alarm | アラームバンド使用有無 — オフにするとすべての閾値を無視 |
Booleanタグの場合は代わりに アラーム条件 (TRUEの時 / FALSEの時 / 使用しない) · アラームグレード · 発生時点 · 重要度 · メッセージ をTRUE・FALSEそれぞれに対して指定します。
アラームメッセージ — 置換トークン
基本文言は {tag_name} 값이 임계치를 초과하였습니다 — 현재값 {value} です。
以下のトークンが発生時点で実際の値に置換されます。
| トークン | 置換される値 |
|---|---|
{tag_id} | タグID |
{tag_name} | タグ名 |
{value} | 現在値 |
{timestamp} | 発生時間 |
{band} | アラームバンド (TRIP_HI / HI_HI など) |
受信者 · 重複抑制 · 送信
| fieldset | 項目 | 説明 |
|---|---|---|
| 受信者 | 基本受信者 | 登録者に伝達します |
| 追加受信者 | その他の受信者を指定します | |
| 重複アラーム抑制 | 抑制時間 (分) | この時間の間、同タイプのアラームプッシュを抑制します |
| メール / SMS送信 | メール | 受信者のメールにアラームを伝達します |
| SMS | 受信者の携帯電話にSMS伝達 — SMSゲートウェイが必要です |
境界値付近で値が変動すると、同じアラームが秒単位で繰り返し生成されます。閾値を広げる前に 抑制時間 (分) を先に上げてみてください。閾値を広げすぎると、本当の異常まで見逃してしまいます。
⑤ サンプリング · ⑥ 集計 — 両者の違い
| サンプリング | 集計 | |
|---|---|---|
| 保存するもの | 周期ごとの 最終値 | 周期ごとの 統計値 |
| 統計種類 | — | 最初/最終値, 最低・最高・平均・標準偏差・中央値 |
| 周期 | 10秒·30秒·1分·5分·10分·30分·1時間 | 1分 / 5分 / 10分 / 30分 / 1時間 から選択 |
| 画面設定 | 使用有無のみ | 使用有無 + 周期 |
画面ヘルプの通りです — «ポイント生成周期が速いデータである場合、システム性能が低下する恐れがあるため、 長い集計周期の選択に留意してください。» 集計はリアルタイムインメモリエンジンで動作するため、秒単位で受信するタグに1分集計を全適用すると、メモリとCPU負荷が同時に上昇します。
⑦ 人工知能タブ — 多変量異常診断の «対象» 選択
このタブは予測モデルを紐付ける場所 ではありません。 画面副題の通り LLMベースリアルタイム異常診断 に このタグをどう使うかを2つの値（対象 / 対象外）で決定します。
| 項目 | 意味 |
|---|---|
| 対象カラム | 多変量相関分析の対象とします。 設備内に2つ以上の対象タグがある場合にのみ有効化 されます |
| 分岐カラム | 多変量データを分割する カテゴリ(レシピ · 設備モード · 運転など) として使用します |
相関関係は2つ以上の変数間でのみ定義されます。一つの設備に «対象» タグを 一つだけ 設定しても 分析は有効化されません。温度・圧力・電流のように 共に変動するタグをセットで 設定してください。
⑧ 発行タブ — Kafka / MQTT
| トグル | 機能 |
|---|---|
| KAFKA発行 | Kafkaプロトコルでポイントメッセージを発行します |
| MQTT発行 | MQTTプロトコルでポイントメッセージを発行します |
画面ヘルプに記載されています — «OPC-UAサーバープラグインでデータを受信するするには、 KAFKA発行が有効化されている必要があります。» プラグインを導入したのに値が上がってこない場合は、プラグイン 設定よりも タグのこのトグル をまず確認してください。
入力ラベルの下には インラインヘルプ が併記され、形式・制約条件を案内しています。
仮想タグ・仮想ポイント
タグ画面には2つの特殊な登録方式があります。
| 画面 | 用途 |
|---|---|
tag/add_vtag.jsp | 仮想タグ — 接続修正画面の 接続済みタグリスト → [仮想タグ] で登録します。値はタグの 計算 タブにあるEQLが他のタグ値を用いて生成します |
tag/add_vpoint.jsp | 仮想ポイント — ストリーム画面の [仮想ポイント] で、タグ一つに対し時刻と値を手動で入力します |
作成方法・例・アラームとの関係は 仮想タグ を参照してください。
タグ詳細画面 (/tag/view/{tag_id})
タグ一覧からタグ名をクリックして進入します。一つのタグの全運営情報を一つの画面に集約したビューで、画面が 左側 col-lg-3 (2パネル) + 右側 col-lg-9 (現在値パネル + データ/アラームタブ) で構成されます。
上段 — ページヘッダー
🏷 태그 | {태그명} [ 태그명 입력 ▼ ] [태그 이동 →] [← 목록] [↻]
| コントロール | 動作 |
|---|---|
| タグ名入力 + タグ移動 | 他のタグをオートコンプリートで検索し、即座にそのタグの詳細画面へ移動 (moveTag()) |
| ← 一覧 | タグ一覧(/tag/index) へ戻る |
| ↻ | 画面更新 (リアルタイムデータを再購読) |
左側 ① タグ情報パネル — 4セクション ds-dl
パネルヘッダー右側の ⚙ 歯車アイコン — タグ設定様式(/tag/form)へ移動します。変更権限を持つ役割でのみ保存が可能です。
| セクション (view-section-title) | 表示項目 (定義リスト) |
|---|---|
| 🪪 基本情報 | タグID (ドメインバッジ TAG) · タグ名 · データタイプ · タグ説明 · 登録日 |
| 🔗 接続情報 | 接続ID (ドメインバッジ OPC) · 接続名 |
| 🏭 サイト情報 | サイトID (バッジ) · サイト名 |
| 🟦 エセット情報 | エセットID (バッジ) · エセット名 |
IDはすべてドメイン別色バッジで表示され、バッジをクリックすると該当ドメインの詳細画面へ移動します (例: サイト → サイト画面)。
左側 ② 統計情報パネル — ポイント・アラーム・重要度別アラーム
パネルヘッダー右側に 今日 / 昨日 トグルボタン — 統計期間の切り替え。
| セクション | 表示 |
|---|---|
| 📶 ポイント | 大きな数字 "今日のポイント受信件数" + 24時間スパーク (point_24hh) + 全ポイント累積カウンタ |
| 🔔 アラーム | 大きな数字 "今日のアラーム発生件数" + 24時間スパーク (alarm_24hh) + 全アラーム累積カウンタ |
| ❗ 重要度別アラーム | 3カードグリッド — 情報(青) · 警告(黄) · 重大(赤) それぞれに大きな数字 + ラベル |
┌── 정보 ──┐ ┌── 경고 ──┐ ┌── 심각 ──┐
│ 1,234 │ │ 23 │ │ 2 │
│ (파랑) │ │ (노랑) │ │ (빨강) │
└──────────┘ └───────────┘ └───────────┘
↓ 그 아래에 도넛 차트
[중요도별 점유율 도넛 차트]
右側 ① 現在値パネル (5カラム)
パネルヘッダー右側にクイック移動ボタングループ。
| クイック移動 | 動作 |
|---|---|
| 🔀 ストリーム | このタグを ストリーム でリアルタイム表示 |
| 🗄 トレンド | このタグの トレンド |
| 🔔 アラーム | このタグの アラーム 履歴 |
| カラム | 表示 |
|---|---|
| 現在値 | 大きな数字 — 品質色バッジ (good = 緑 · uncertain = 黄 · bad = 赤) |
| 最終更新 | 時刻 (yyyy-MM-dd HH:mm:ss) |
| 遅延 [MS] | 平均応答遅延 |
| 品質 | OPC品質コード (例: GOOD, BAD, UNCERTAIN) |
| エラーコード | 最終受信でエラーがあった際、そのコードを表示 |
右側 ② データ/アラームタブ
| タブ | 内容 |
|---|---|
| 📊 データポイント | チャートパネル (リアルタイムトレンドライン — 数値型) または 状態タイムライン (Boolean) + 集計表 (今日受信ポイント · 最低 · 最高 · 平均 · 合計 / Booleanは最初 · 最終 · 合計) |
| 🔔 アラーム | このタグで発生したアラームリストと処理状態 |
データタブのチャートはWebSocketでリアルタイム更新されます。チャート読み込み中は「チャート読み込み中...」という案内が中央に表示されます。
この詳細画面は、タグ単位の運営者総合点検 — 閾値検討・異常追跡・物理マッピング確認の入り口となります。
オントロジー画面 (/ontology/index)
資産分類体系(カテゴリ・メタ属性・関係)とサイト単位の知識グラフを可視化する高度なメタ画面です。デザインシステムの刷新により、サイトバナー + 左側サイドカード + グラフ本文 に再構成されました。
上段 — サイトバナー (onto-site-banner)
ページヘッダーの直下にフルカラーバナーが表示されます。
🏭 {사이트명} | {사이트 설명} [기준시간 : {gen_timestamp}]
- サイトが変更されるとバナーテキストも即座に更新されます
- 基準時刻はツリー・メトリクスが最後に更新された時刻です
左側 ① サイトパネル (col-w-280)
パネルヘッダー
| ボタン | 動作 |
|---|---|
| ❄ レーディアルトグル | パネル本文のツリーを「一般ツリー ↔ レーディアル(放射型)グラフ」に切り替え |
| ↻ 更新 | ツリー再構築 (createTree()) |
パネル本文 — セレクター2種
| セレクター | オプション |
|---|---|
| サイト選択 | 登録済みサイト — 常に1つが選択されています (変更時にツリーを即時再構成) |
| 初期レベル | サイト > 区域 / サイト > 区域 > ライン / サイト > 区域 > ライン > 設備 (デフォルト) |
パネルフッター
全サイト数を表示 — 🏭 전체 사이트 N개。
左側 ② 資産カウントカード 4種 (onto-count-stack)
サイトパネルの下にフルカラーグラデーションの4カードグリッドが表示されます — 選択サイトの資産数。
| カード | アイコン | 表示 |
|---|---|---|
| AREA | 🏭 車庫 | 区域数 (area_size) |
| LINE | 📜 コンベア | ライン数 (line_size) |
| EQUIPMENT | 📺 ベータマックス | 設備数 (equipment_size) |
| TAG | 🏷 タグ | タグ数 (tag_size) |
本文 — オントロジーグラフ
選択したサイトの資産ツリーを大きなキャンバスに可視化します。
| 動作 | ショートカット |
|---|---|
| ノードクリック | そのノードのメタパネル表示 (選択サイトイベント/状態/集計コンテナ) |
| ズームイン/アウト | マウスホイール |
| ノードドラッグ | 位置移動 |
| ノードホバー | onto-tip-* ツールチップ (ドメインIDバッジ + メタキープレビュー) — oklch色でドメイン別に色分け表示 |
主要機能
- カテゴリツリー / レーディアル — 資産分類(例: 回転機械 → モータ → ACモータ)の階層構成
- メタ属性定義 — カテゴリ別に資産が持つメタキーを定義 (例: モータの定格出力・電圧)
- 関係定義 — 資産間の関係(上位/連動/代替)を表現
- 検証ルール — メタ入力時の検証規則 (必須/数値/範囲)
- ドメインIDバッジ — SITE/AREA/LINE/EQUIPMENT/TAG の色が ドメインID統合検索 と同一のoklchカラーで統一
オントロジーは一般の運営者が頻繁に使用する画面ではありません。システム導入初期または資産カテゴリ整備時にシステム管理者が定義します。
メタデータ画面 (/metadata/index)
ドメイン単位でユーザー定義メタキー-値を登録する簡易画面です。
使用例
| ドメイン | メタキー | 値 |
|---|---|---|
| Asset | manufacturer | "ABC Industries" |
| Asset | installed_year | "2020" |
| Tag | description_en | "Pump discharge pressure" |
| Order | customer_class | "VIP" |
入力形式
| カラム | 説明 |
|---|---|
| ドメインタイプ | Asset/Tag/Order/Customer など |
| ドメインID | そのドメインの識別子 |
| メタキー | ユーザー定義 |
| メタ値 | 自由テキスト/数値 |
メタデータは オントロジー とは異なり、カテゴリに縛られない自由メタです。迅速な暫定メタが必要な場合に使用します。
基準情報画面 (/basedata/index)
コードマスタ・基準値登録画面。コードをタブ別に管理します。
タブ構成
| タブ | 説明 |
|---|---|
| 資産タイプ | 設備階層の層コード |
| サイト分類 · 区域分類 · ライン分類 · 設備分類 | その層の 設備分類(Asset class) コードと言語別名称 — エセット画面の 設備分類 セレクターリストです |
| 設備状態 | 設備状態コード |
| タグタイプ | タグタイプコード |
| 不良原因 · 停止原因 · 故障原因 | 原因コード |
| 原因辞典 | 原因辞典 |
| EQLテンプレート | EQLテンプレート |
| 勤務表タイプ | 勤務表タイプコード |
サイト・区域・ライン・設備がそれぞれ独自の分類リストを持ちます。設備には 設備分類タブのコードのみ を設定できます。
他の層のコードを指定すると保存が拒否されます。分類はコード(asset_class_code)で保存され、名称は言語ごとに別に保持されます。
APIでは /api/v5/reference/asset-class となります。
基準情報はシステム標準値を定義する画面であり、頻繁に変更されることはありません。標準コードを整備する場合のみ使用してください。
ファクトリモデル確定
モデル または タグ 画面上段の ✓ ファクトリモデル確定 ボタンをクリックすると、登録されたサイト・資産・タグがイベントルールエンジン(CEP > ステートメント)に一括反映されます。
動作手順
- すべてのサイトの資産ツリー・タグ・マッピングが意図通りに登録されているか確認
- 上段の ✓ ファクトリモデル確定 をクリック
- システムが資産単位のドメインルール(状態・集計・イベント・コマンド)を自動登録
- ルール登録後、CEP > ステートメント で新しいルールを確認可能
いつ確定させるべきか？
- 新規サイト・資産を大量に登録した直後
- 資産の分類・階層を大幅に変更した後
- アラームバンド・メタ属性を一括変更した後
ファクトリモデル確定は頻繁に押さないでください(ルールエンジンの再登録コストが発生します)。変更作業がすべて完了した後に一度だけ押すことを推奨します。
活用シナリオ
| シナリオ | 手順 |
|---|---|
| 新規工場セットアップ | モデル → サイト追加 → エセット画面で区域/ライン/設備ツリー構成 → OPC接続登録 → タグ自動/手動登録 → モデル確定 |
| 新規ライン追加 | エセット画面 → サイトの区域を選択 → ライン追加 → ライン下位に設備ツリー構成 → タグ登録 |
| タグ一括整理 | タグ画面 → 検索フォームで廃止対象を絞り込み → 選択 → 選択したタグ削除 |
| 資産メタ強化 | メタデータ画面 → ドメイン = Asset, キー = manufacturer など自由に追加 |
| 資産カテゴリ標準化 | オントロジー画面 → カテゴリツリー整備 → カテゴリ別メタ属性定義 |
| 新単位追加 | 基準情報 → 単位マスタタブ → 追加 |
| 運営メタ一括抽出 | タグ画面 → 検索 → Excelダウンロード |
よくある質問
Q. サイトを追加しましたが、ダッシュボード の地図にマーカーが表示されません。 A. サイト追加時に緯度・経度を登録していない場合、マーカーは表示されません。サイトカードの 🔧 修正 → 緯度/経度を入力してください。
Q. モデル確定とメタストアバックアップの違いは？ A. モデル確定は資産/タグをルールエンジンに一括登録(運営有効化)することであり、メタストアバックアップはメタストレージ全体をバックアップファイルとして保存(データ保存)する別個の作業です。
Q. 資産ツリーで親資産を変更できますか？ A. 一般的に、資産の上位ノードは変更しないことを推奨します(履歴・ルールの整合性のため)。変更がどうしても必要な場合は、システム管理者に相談した上で進めてください。
Q. タグを削除すると過去のデータも消えますか？ A. タグメタは削除されますが、時系列データは保存ポリシーに基づき一定期間維持されます。正確な保存ポリシーについてはシステム管理者に問い合わせてください。
Q. 仮想タグと一般タグの違いは？ A. 一般タグは実際のセンサ/PLCからデータを受信しますが、仮想タグは他のタグの値を計算して生成された仮想の時系列です。例：センサAとセンサBの差分を仮想タグCとして定義。作成方法は 仮想タグ を参照してください。
Q. オントロジーを使用しないとどうなりますか？ A. 基本的な運営に影響はありません。オントロジーは資産を分類体系で管理したい場合(例：全モータの統合レポート作成時)に使用します。
Q. 資産ツリーでモデル確定に時間がかかります。 A. 資産が多いほど時間がかかります(数千単位で数分)。モデル確定は営業時間外に実施することを推奨します。
Q. タグ検索でオートコンプリートが動作しません。 A. サイトが選択されていないとオートコンプリートは動作しません。先にサイトセレクターを設定してください。
Q. メタデータに登録したキー-値をどこで確認できますか？ A. 資産詳細画面、資産ツリーのメタ領域、および フロー のドメインCRUDノードでメッセージペイロードの一部として利用可能です。
Q. 基準情報のコードを変更すると既存データに影響しますか？ A. はい、コード変更は既存データにも影響します。変更前にシステム管理者に相談してください。