Infor M3連携ガイド SkyPlanner APSによる生産スケジューリング

Infor M3には四つの連携レイヤーがあり、この連携ではそれぞれが役割を担います。

1. ION API Gateway上のM3 API（MIプログラム）。すべてのMIプログラムはREST呼び出しで実行します：https://{ionapi-host}/{tenant}/M3/m3api-rest/v2/execute/{program}/{transaction}。v2を使用してください。v2では会社、事業部、日付形式のパラメーターが追加され、返されるペイロードもv1とは異なります。PMS100MIは製造オーダー、PMS070MIは工程実績の報告を扱います。（Inforドキュメント）
2. Infor Data FabricのCompass query API。MITMAS、MWOHED、MWOOPEなど、複製されたM3テーブルをSQLで読み取ります。Compassは非同期で動作します。ジョブを送信し、ステータスをポーリングしてから、ページあたり最大100,000行または10 MBの結果を取得します。マスタデータの初期取り込みに適しており、リアルタイム同期には向きません。（Inforドキュメント）
3. ION BODs。M3 BOD Processorは、有効化されたBODを会計エンティティごとに発行します。受信用BODには、Process ProductionOrder、SyncおよびProcess BillOfMaterials、Process ItemMaster、Sync InventoryCountなどがあります。（Inforドキュメント）
4. M3 Event Hub。MOヘッダーや工程の変更など、テーブル単位のイベントを扱うパブリッシュ／サブスクライブ型のフレームワークです。（Inforドキュメント）

MI APIの仕様は、各テナントのION APIカタログにあるAvailable APIsに掲載されており、プログラムごとにSwaggerが用意されています。標準カタログに必要なトランザクションがない場合は、XtendM3でカスタムMIプログラムを追加し、Metadata Publisherでカスタムの一覧取得APIを作成します。

M3は変更をプッシュ通知できますが、Infor側で次の設定が必要です。

• Event Hubは、有効なサブスクライバーが存在するイベントだけを発行します。ION Enterprise Connector（IEC）は、EventHub Subscriberチャネルを通じてイベントを購読します。
• BODsは、BOD Processorで会計エンティティごとに有効化する必要があります。この設定にはM3EC-Administratorロールが必要です。（Inforドキュメント）

プッシュ通知がまだ設定されていない場合は、PMS100MIの一覧取得トランザクションをポーリングするか、更新タイムスタンプを条件にCompassクエリを実行します。

書き戻し側は、SkyPlanner自体のWebhookにより、運用初日からイベント駆動で動作します。

1. マスタデータの初期取り込み。Compassを通じて、品目、製品構成、工程、作業区を一括で読み取ります。各作業区をSkyPlannerのリソースとリソースグループのどちらに対応させるか、明確に決めてください。並列稼働する三台の機械を表す作業区で、それぞれを個別にスケジュールしたい場合は、三つのリソースとして登録します。

2. オーダーの同期。PMS100MIまたはMWOOPEからリリース済みMOとその工程を読み取り、在庫と未完了の購買オーダー明細も取り込みます。SkyPlannerは、発注済みの材料をPOの納入日から使用可能として扱い、POがDeliveredになると在庫を更新します。スケジューリングでは、この両方を確認します。

スケジューリングの対象は、確定済みMOだけにしてください。計画MO（PMS170）はMRPによって再生成され、再計画のたびにM3がその負荷を再構築します。

3. スケジュールの書き戻し。エンジンが配置または移動したすべての工程について、SkyPlannerは計画開始・終了日時をMOの工程に書き戻します。呼び出しには、テナントのカタログにあるMO工程用のM3 MIトランザクションを使用します。環境に応じて必要な場合は、XtendM3のMIプログラムを使用します。数量、ステータス、原価計算は引き続きM3が管理します。

4. 製造現場での実績確定。作業者はSkyPlanner Mobile ConfirmationsまたはProduction Timerで作業を記録します。SkyPlannerはPMS070MI Report operationを通じて段取り時間、加工時間、数量を送信し、工程完了時にはConfirmまたはClose operationを実行します。Inforは”it is important that every operation is reported,”（すべての工程の実績を報告することが重要）と述べています。この報告により、M3の負荷とSkyPlannerの進捗の整合性を保ちます。（PMS070MI）

工程ごとに、実績報告の経路を一つに決めてください。同じ工程をSkyPlannerとM3のPMS070の両方から報告すると、数量が二重に計上されます。

5. データの管理主体と競合時のルール。本稼働前に、次の内容を文書化してください。

競合の主な原因は、M3独自の日程計算ロジックです。負荷は”is automatically generated when a manufacturing order or planned manufacturing order is generated or replanned.”（製造オーダーまたは計画製造オーダーの生成時や再計画時に自動生成されます）。再計画されたMOは新しいバージョンとして扱い、再同期したうえでSkyPlannerに再スケジューリングさせてください。Autopilotは、生産状況が変わると自動的に再スケジューリングします。SkyPlannerにM3 Scheduling Workbenchは必要ありません。SWBのライセンスがある場合も、互いに上書きしないよう、工程日程の管理はSkyPlannerに任せてください。

• 工順オブジェクトはありません。工程は製品構成（PDS002）に含まれ、MO上ではMO工程として保持されます。工順用のAPIを探す必要はありません。
• 工程のない製品構成。製品構成には少なくとも一つの工程が必要です。工程がないとM3で負荷が生成されず、SkyPlannerにも作業が渡りません。
• M3の有限能力フラグは外部の計画と競合します。PDS010のフラグとCRS786のボトルネック設定は、M3側の日程を変更します。M3の作業区は無限能力のままにし、実際の能力を踏まえたスケジューリングはSkyPlannerに任せてください。
• API仕様はテナントごとに異なります。v1とv2ではレスポンスが異なり、トランザクション名もカタログやXtendM3の拡張によって変わります。v2を使用し、会社と事業部のパラメータを明示してください。
• プッシュ通知は初期状態では無効です。Event Hubにはサブスクライバーが必要で、BODは会計エンティティごとに有効化する必要があります。IONとIECの設定担当を決めるか、まずはポーリングで開始してください。
• 流量制限とページング。ION APIはテナントのポリシーに従って流量を制限し、Compassが返すデータはページあたり最大100,000行または10 MBです。毎回全件を再読み込みせず、差分をポーリングしてください。
• M3とCloudSuite Industrialは別の製品です。CSIはIDO APIを、M3はMIプログラムを使用します。すべての仕様書に、対象となるM3のオブジェクト名を明記してください。