CMMS プロバイダー別統合ガイド
プロバイダー別ガイドは、ソースシステム、アクセス方式、必要フィールド、顧客承認済み運用モデルが確認された後に作成します。CMMS 作業指示アダプター とあわせて使い、汎用 profile を顧客固有の実装ガイドへ落とし込みます。
ガイド構造
- プロバイダー範囲とバージョン。
- アクセス方式：REST、DB ビュー、ファイル、ミドルウェア、データレイク。
- 作業指示、資産、状態、優先度、SLA、添付、クローズフィールド。
- 認証、サービスアカウント、ネットワーク要件。
- 同期頻度、書き戻し動作、失敗処理、受け入れサンプル。
プロバイダープロファイル
| プロファイル | 利用場面 | 備考 |
|---|---|---|
| IBM Maximo | 顧客が Maximo 作業指示、資産、故障コード、site、location、service record を使う場合。 | Maximo status vocabulary、object-structure customization、site / org default、API key access を確認します。 |
| SAP Plant Maintenance | 顧客が SAP PM maintenance order、functional location、equipment、plant、notification、closeout data を使う場合。 | SAP OData root、auth mode、CSRF write flow、plant、order type、status code を確認します。 |
| Generic REST | 顧客、請負会社、ミドルウェア、provider が案件専用 REST API を提供する場合。 | Base URL、auth mode、push path、pull path、field map、response shape、external ID field を確認します。 |
| Honeywell Forge / IBMS profile | 顧客承認済み Forge engagement が overlay 経由で work order、asset、alarm、status path を提供する場合。 | Endpoint shape、OAuth2 または API key、payload contract、direction、顧客承認を確認します。 |
| Infor EAM | 顧客が Infor EAM 作業指示、資産、状態、保全記録を使う場合。 | Provider schema と access details が必要です。 |
| 請負会社作業指示システム | サービス事業者が独自の dispatch / ticket system を持つ場合。 | 通常は Generic REST、Webhook、scheduled export、middleware で実装します。 |
ベースラインフィールドマッピング
| Provider type | Native work-order ID | Asset field | Status field | Description field | Other fields |
|---|---|---|---|---|---|
| SAP PM | ORDER_NR | EQUNR | STATTEXT | LTXT | QMEL.LTXT, PRIOKX |
| IBM Maximo | WONUM | ASSETNUM | STATUS | DESCRIPTION | FAILURECODE, WOPRIORITY |
| Infor EAM | WORKORDERID | EQUIPMENTID | STATUS | DESCRIPTION | 顧客固有の優先度とクローズフィールド |
| Custom REST | id | equipment_id | status | description | プロジェクト承認済みフィールド |
アダプター別計画メモ
IBM Maximo
Maximo は provider-owned work-order system として計画します。Maximo root URL、service account、API key header、default site / org、asset number mapping、location mapping、status vocabulary、priority vocabulary、changed-date pull window を確認します。受け入れサンプルには、open、completed、canceled、status update、custom status または optional field を含む record を入れます。
SAP Plant Maintenance
SAP PM は maintenance-order integration として計画します。OData service root、auth mode、plant、order type、equipment / functional-location mapping、required order fields、write request の CSRF token handling を確認します。顧客が使う created、released、confirmed、technically completed、closed、canceled の状態で検証します。
Generic REST
ソースが安定した API を公開しているが packaged provider profile に当てはまらない場合に使います。Guide には push path、pull path、auth mode、JSON field map、result array path、external ID field、timestamp field、error response examples を含めます。
Honeywell Forge / IBMS
Forge 統合は顧客承認済み overlay profile として扱い、すべての案件で同じ endpoint を前提にしません。承認済み Base URL、credential mode、asset ownership、work-order ownership、alarm direction、status direction、write-back 可能 field を記載します。
予知保全ワークフローでは、設備 ID、状態、優先度、診断または故障コード、クローズメモ、根本原因、完了時刻も含めます。