CMMS 作業指示アダプター
FactVerse CMMS 運用は、管理された作業指示アダプターを通じて下流の CMMS / EAM システムに接続できます。既存システムを残したまま、FactVerse で保全作業を作成、引き渡し、同期、監視する場合にこのガイドを使います。
作業指示アダプターは、現場プロトコルアダプターとは別のものです。作業指示アダプターは、Maximo、SAP Plant Maintenance、Honeywell Forge、カスタム REST サービス、Webhook エンドポイントと保全記録を交換します。BACnet、Modbus、SNMP などの現場プロトコルアダプターは、設備ポイント値を資産と作業指示のコンテキストに取り込みます。
前提条件
作業指示アダプターを設定する前に、次を確認します。
- 下流 CMMS または EAM の責任者と、想定される記録システムの所有者
- 承認済みサービスアカウント、認証情報の保管、ローテーションルール
- デプロイ済み FactVerse 環境から provider endpoint までのネットワーク到達性
- open、assigned、completed、canceled、failed、reopened の作業指示サンプル
- マッピングに使う asset、location、site、plant、functional location の識別子
- 共通作業指示ライフサイクルに表示する provider status と priority
- 承認済みの書き込み境界: read-only、draft、handoff、synchronization、write-back
アダプター選択フロー
対応アダプタープロファイル
| プロファイル | 利用場面 | 典型的な方向 | 準備する内容 |
|---|---|---|---|
| Webhook | 下流システムまたはミドルウェアがイベント payload を受け取り、inbound webhook で状態を返す | FactVerse push、プロバイダー callback | Target URL、shared secret、payload 契約、retry 方針 |
| Generic REST | プロバイダーまたは顧客が案件専用 REST API を提供する | 設定ベースの push / pull | Base URL、認証方式、push path、pull path、field map、response shape |
| IBM Maximo | 顧客が Maximo の作業指示、資産、site、status を使う | 作成した作業指示を push し、状態変更を pull | Maximo root URL、API key、site / org default、asset mapping、status mapping |
| SAP Plant Maintenance | 顧客が SAP maintenance order、equipment、functional location、plant を使う | maintenance order を push し、状態変更を pull | SAP OData root、Basic または API key、plant、order type、CSRF write flow |
| Honeywell Forge | 顧客承認済み overlay で Honeywell Forge または IBMS profile を使う | overlay 定義に従う push、pull、asset、alarm path | Forge base URL、API key または OAuth2 client credentials、overlay payload contract |
アダプターの利用可否は、導入範囲、顧客のアクセス承認、プロバイダーバージョン、最終的な統合契約によって決まります。各プロファイルは実装の出発点であり、プロバイダー調査と顧客確認の代替にはなりません。
中核となるアダプターモデル
| 機能 | 確認する内容 |
|---|---|
| 作業指示 push | どの FactVerse 作業指示をプロバイダーへ引き渡すか、どのフィールドが必須か |
| 状態更新 pull | どのプロバイダー状態、担当者、timestamp を共通作業指示ビューへ反映するか |
| Health check | どの endpoint または probe でプロバイダー接続の到達性を判断するか |
| 資産マッピング | FactVerse 設備をプロバイダー資産、場所、site、functional location にどう対応させるか |
| Sync log | 成功、失敗、retry、プロバイダー応答をどうレビューするか |
| 所有ルール | プロバイダーが記録システムのままか、FactVerse が主ワークスペースか、読み取り専用か |
設定入力
| 入力 | 用途 |
|---|---|
| Adapter type | webhook、rest、maximo、sap-pm、または顧客 overlay profile を選ぶ |
| Base URL または endpoint | リクエスト送信先とネットワーク境界を定義する |
| 認証 | サービスアカウント、token、credential rotation、プロバイダー監査所有者を定義する |
| Field mapping | FactVerse 作業指示フィールドをプロバイダーフィールドに対応させ、ソース値を保持する |
| Status mapping | プロバイダー状態を共通 CMMS ライフサイクルに対応させ、元の状態も保持する |
| Asset mapping | FactVerse 設備 ID をプロバイダー資産、場所、site、functional-location ID に対応させる |
| Pull cadence | 状態変更を読む頻度、または webhook callback の利用を定義する |
| Write boundary | 読み取り専用、draft、handoff、write-back の境界を定義する |
Generic REST
顧客、プロバイダー、ミドルウェア、請負会社システムが安定した案件専用 REST API を提供する場合に Generic REST を使います。標準の packaged profile には当てはまらないが、作業指示 API を提供できるシステムに適します。
Base URL、ネットワーク許可、認証方式、push path、HTTP method、pull path、timestamp parameter、result array shape、status field、FactVerse field から JSON key への mapping、作成成功後の external ID field、health-check path を確認します。
Generic REST は設定可能なアダプターフレームワークです。本番導入前に顧客固有の API 契約をレビューします。
IBM Maximo
顧客が IBM Maximo で保全を管理している場合、Maximo profile で Maximo work-order API と記録を交換します。
| 領域 | 準備する内容 |
|---|---|
| Access | Maximo root URL と、承認済み header で送る API key |
| Work-order create | description、long description、priority、status、external reference、site、org、asset、location |
| Priority mapping | FactVerse priority を Maximo work priority に対応させ、導入先の語彙で確認する |
| Status mapping | created、assigned、in progress、completed、canceled などを顧客 Maximo の状態モデルへ対応させる |
| Pull changes | changed-date window、selected fields、page size、custom status handling |
| Asset identity | FactVerse 設備を Maximo assetnum、location、site、org に対応させる |
Maximo では状態値、object structure、必須フィールドがカスタマイズされていることが多いため、本番前に実際の open、completed、canceled、blocked、reopened record で検証します。
SAP Plant Maintenance
顧客が SAP S/4HANA Plant Maintenance で maintenance order を管理している場合、SAP PM profile で作業を引き渡し、または同期します。
| 領域 | 準備する内容 |
|---|---|
| Access | SAP OData service root と、承認済み Basic または API key 認証 |
| Write flow | 作成または更新リクエストで使う CSRF token と session cookie |
| Scope | Maintenance plant、order type、equipment、functional-location field |
| Work-order create | description、order type、plant、priority、traceability reference |
| Status mapping | SAP order status code を FactVerse lifecycle に対応させ、raw SAP status も保持する |
| Pull changes | Last-change timestamp format、selected fields、provider-side filters |
SAP 環境は Gateway 設定、SSO policy、拡張フィールド、order type によって異なります。最終的な service surface は顧客の SAP owner と確認します。
Honeywell Forge と Overlay Profile
Honeywell Forge または IBMS 型の統合は、顧客承認済み overlay profile として扱います。API key または OAuth2 client credentials を使えますが、endpoint shape、payload field、運用方向は案件に依存します。
利用前に、顧客が Forge access と credentials を承認していること、payload shape が顧客または integration partner により確認されていること、asset master ownership、alarm flow、work-order ownership が合意されていること、write-back または handoff が範囲内であることを確認します。
現場プロトコルアダプターとの境界
BACnet、Modbus、SNMP は下流 CMMS 作業指示アダプターではありません。設備ポイント値、controller status、UPS readings、環境値、managed device state を FactVerse コンテキストに取り込むために使います。
作業指示レコードを下流の保全システムと交換する場合は、作業指示アダプターを使います。トリアージ、証拠レビュー、施設運用、予知保全、Agent 説明で設備ポイントを使う場合は、現場プロトコルアダプターを使います。
検証チェックリスト
- Adapter type と provider ownership が確認されている。
- Credential、endpoint、firewall rule、service account が承認されている。
- Asset mapping が実設備と場所サンプルでテストされている。
- Status / priority mapping が provider の元値を保持している。
- Push、pull、health check、sync log、retry、failure path がテストされている。
- Write-back が承認済み field と role に限定されている。
- Operator が native、handoff、synced、failed、waiting for provider action の状態を見分けられる。