Sage X3連携ガイド SkyPlanner APSで生産スケジューリング

連携方法は導入形態によって決まります。Sage X3のクラウド版では、外部アプリケーションにアプリケーションのファイルシステムもデータベースも公開されないため、APIまたはホスティング環境のファイル転送を使って連携します。オンプレミス版では、ファイルの直接インポートやX3データベース内のステージングテーブルも利用できます。

オンプレミスでGraphQLを使用するには、"bearer"をsession.auth配列（nodelocal.js内）に追加する必要があります。Sage X3 SaaSでは、接続アプリの認証がデフォルトで有効になっています。Sage X3 Cloudでは、接続アプリにadminユーザーを使用できません。代わりに、Standard認証を使用するSyracuseユーザーを作成してください。

データの流れと使用するインターフェース

• 製品、拠点、購買、在庫：Sageの公式サンプルと同様に、GraphQLを使用します。
• 製造指図、工程、工順、作業区：REST api1のRepresentation、またはAOWSEXPORTで実行するエクスポートテンプレートを使用します。GraphQLスキーマで製造ドメイン（xtremX3Manufacturing）が公開されているリリースでは、GraphQL経由で同じデータを読み取ります。
• 工程日付と作業区のX3への書き戻し：Work order（GESMFG）のSOAP Webサービスでmodifyを使用します。代替手段は、AOWSIMPORT経由のインポートテンプレートです。
• 生産実績：Production tracking（GESMTK）のSOAP Webサービスでsaveを使用します。

ファイルシステムやデータベースへの直接アクセスを必要としないため、X3のクラウド版とオンプレミス版で同じ設計を使えます。X3へのインストールは不要です。連携には、接続アプリケーション、Syracuseユーザー、GESAWEで公開したWebサービスを使用します。

イベント検知はポーリングを前提に

Sageが公開しているX3の開発者向けドキュメントには、外部へのWebhook通知やビジネスイベント機能の記載はありません。2024 R1で追加された「Callback URL」設定は、Mobile AutomationとWeb SchedulingがSOAP Webサービスを呼び出す際に使うもので、汎用的なイベントシステムではありません。変更は定期的な読み取りで検知してください。GraphQLクエリ、クラウド版のSync APIのタイムスタンプカーソル、またはテンプレートによる定期エクスポートを使用します。

1. マスタデータの初回取り込み。まず作業区とカレンダーを取り込み、次に製品、BOM、工順を取り込みます。工順が作業区を参照するため、この順序で進めます。

2. オーダーの同期。MFGHEADとMFGOPEをポーリングし、新規および変更された製造指図を取得します。MFGOPEの各明細を、WSTコードで指定されたリソース上のSkyPlannerの工程に対応付けます。未完了の購買発注も同じ周期で同期します。SkyPlannerは発注済みの資材を購買発注の納入日から利用可能とし、購買発注がDeliveredになると在庫を更新します。これにより、資材チェックでは在庫と入荷予定の両方を考慮できます。

3. スケジュールの書き戻し。スケジュールが変更されると、SkyPlannerのWebhookが発火します。連携処理は、GESAWEでSOAP Webサービスとして公開したWork orderオブジェクト（GESMFG）のmodify操作を呼び出します。変更のあった各工程のStart（OPESTR）、End（OPEEND）、作業区を更新します。一括更新では、AOWSIMPORT経由で製造指図のインポートテンプレートを使い、同じ項目を更新します。書き込むのは日付と作業区だけです。数量、BOM明細、工順は決して書き換えないでください。

4. 選択した設備の反映。作業区を一対一で対応付けている場合、エンジンが代替設備の中から選んだ設備を、その工程の作業区としてX3に書き戻します。これにより、実際に作業を行う設備がX3に記録されます。X3の作業区が設備グループを表す場合は、作業者の作業キューに個々の設備を表示します。X3には、グループの作業区と予定日付を渡します。

5. 製造現場からの実績報告。作業者はMobile ConfirmationsまたはProduction Timerで作業を記録します。連携処理は、Production trackingオブジェクト（GESMTK）のsave操作を使って実績報告を一件ずつ登録します。工程実績には工程時間と数量を登録し、そこで資材消費も管理している場合は消費量も登録します。X3で実績を登録できるのは、ステータスがFirmの製造指図だけです。また、製品・拠点の設定でRelease if shortage（MFGSHTCOD）を選択していない限り、構成品が利用可能でなければなりません。

6. 確実な同期。実績登録ごとにSkyPlannerの作業時間記録IDをキーとして使い、登録時に作成されたX3の実績番号を保存します。これにより、Webhookが再送されても二重登録されません。X3で完了または取消になった製造指図は、次のポーリングでスケジュールから削除します。拒否された呼び出しは、むやみに再試行せず、X3のエラーメッセージとともにログに記録してください。X3に接続できない間は変更をキューに保持し、接続復旧後に順番どおり登録します。

7. 管理範囲のルール。何を作るかはX3で管理します。対象は製品、数量、BOM、工順、拠点です。いつ、どこで作るかはSkyPlannerで管理します。対象は作業順序、リソース、開始・終了日時です。SkyPlannerで管理するオーダーについては、計画担当者がPlanning workbenchで再スケジューリングせず、FUNMAUTJも実行しないことを合意しておいてください。そうしなければ、担当者の変更は次の書き戻しで上書きされます。

• MRPの提案は製造指図ではありません。MRPの提案には、計画済みまたは確定の製造指図に変換されるまでMFGOPEの工程明細がありません。スケジューリングの対象にするのは提案ではなく、変換後の製造指図です。
• カレンダーの設定漏れ。稼働日に稼働時間帯が設定されていない場合は、DEFDIHのデフォルトスキーマが適用されます。稼働時間帯が空欄でデフォルトもない日は、日付や負荷が不正になります。カレンダーをエクスポートする前に、各週間稼働パターンのすべての稼働日に稼働時間帯を設定してください。
• 更新されていない負荷バケット。能力やカレンダーを変更しても、再スケジューリングしてRecalculate loads（FUNMIWL）を実行するまで、X3の既存の負荷バケットには反映されません。古いままのLoads inquiry（CONSMWK）を基準にSkyPlannerの結果を検証しないでください。
• No. of resourcesは作業人数を表します。WSTNBRは、工程を実行するために作業区で必要となるリソース数です。たとえば、人員の作業区なら三人といった値です。これをSkyPlannerのリソースの作業者数にマッピングします。SkyPlannerでは、ひとつの作業に複数人を同時に割り当てられます。GFS拡張インターフェースを利用していた拠点では、Sageの要件に従ってこの値が1に設定されているため、実際の作業人数がどこに保持されているかを確認してください。
• 作業区が設定されていない工順の工程は、リソースに割り当てられません。マッピング時に検出されます。
• 時間単位と代替作業区。工順の時間には固有の時間単位（TIMUOMCOD）があり、代替作業区には優先順位があります。どちらも明示的にマッピングし、X3をアップグレードするたびにマッピングのチェックを再実行してください。
• 製造指図のロック。拠点でProduction Schedulerも利用していた場合、そこに送信した製造指図はBeing optimizedステータスになり、スケジューリング対象から除外する（PSOPTFREE）まで変更できません。切り替え前に解除してください。

数週間で本稼働を始めたいなら、SkyPlannerをお選びください。何か月もかかるAPS導入プロジェクトを待つ必要はありません。

料金は5リソースを含む月額199 €からで、毎月のお支払いです。連携費用は、お客様の業務プロセスと要件に応じて、ご利用プランとともに事前にお見積もりするため、開始前に総費用を把握できます。料金と機能をご覧いただくか、最大20リソースを使える30日間の無料トライアルをお試しください。クレジットカードは不要です。