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

Divalto infinityのAPIプラットフォームには、外部スケジューラとの連携に使える三つの仕組みがあります。

1. RecordSql（標準REST）。宣言済みのクエリファイル（DHOQ）を通じてDivaltoのテーブルを読み取ります。OF、séquences、gammes、articles、postes、在庫の読み取りに使います。新しいクエリ宣言の反映には、最大十分かかる場合があります（Divalto RecordSqlの設定）。
2. WEBSERVICE_INFINITY（REST）。Divaltoの業務Webサービスです。各呼び出しでは、アクションWEB_SERVICE_INFINITY、アクセストークン、業務アクション・dossier・データを指定するパラメータ文字列をJSONボディで送信します（呼び出し形式）。生産関連のアクションには、create_dataxml（生産用scrutateurへのファイル配置）、integration_dt（構成部品、séquences、ressources、outillagesなどの技術データの作成）、在庫照会、品目作成があります（生産関連のアクション）。
3. 生産用scrutateur。Divaltoの生産機能でXMLファイルを取り込むファイル監視機能です。create_dataxmlは、この機能にbase64形式のファイルを渡します。取込種別には、予定日時用のGG_DATES_ORDO、作業時間用のGG_TEMPS_IMPORT、完了サイクル用のGG_FIN_DE_CYCLE、MESデータ用のCO_MES_IMPORT、部品消費用のGG_COMPOSANT_OMがあります（create_dataxml）。

DivaltoのSOAPサービスは、このプラットフォームではすでにサポートされていません。連携はRESTのみで構築してください。

DivaltoのWebhookは受信専用です。外部システムがDivaltoのWebhookを呼び出すと処理が開始されます。Divaltoは、Webhookはデータを返すためのものではないと説明しています（DivaltoのWebhook）。Divaltoから外部へのイベント送信はありません。

そのため、Divalto側のデータはポーリングで取得します。未完了のOFと最近の変更に絞ったRecordSqlクエリで、新しい作業を取得します。頻度は工場ごとに設定し、OFは数分ごと、在庫は毎時などとします。

SkyPlannerは状態やスケジュールが変わるとWebhookを送信するため、書き戻しはイベント駆動で行います。

1. マスタデータの初回取込。RecordSqlクエリを宣言し、articles、nomenclatures、gammes、centres de charge、postes、opérateurs、outillages、カレンダーを読み取ります。centresをSkyPlannerにどう対応付けるかは、明確に決めてください。たとえば、四つのpostesを持つcentre de chargeは、四つのリソースを含む一つのリソースグループに対応します。

2. OFの同期。未完了のOFをséquences・構成部品とともに読み取り、未完了の仕入先発注も取得します。SkyPlannerは、発注済み資材を購買オーダーの納入予定日に使用可能として扱い、購買オーダーがDeliveredになると在庫を更新します。Divaltoが日程を再調整するのは親OFのみのため、親OFとその子OFはまとめて読み取ってください。

3. スケジュールの書き戻し。エンジンが作業を配置または移動すると、SkyPlannerのWebhookをきっかけにcreate_dataxmlを呼び出します。送信するのはGG_DATES_ORDO形式のファイルです。OFごとにdossier、事業所、OF番号、開始・終了予定日時を含め、séquenceごとに番号と開始・終了予定日時を含めます。代替リソースに作業を移した場合は、centreとposteも含めます（GG_DATES_ORDOの形式）。Divaltoのscrutateurが、このファイルをOFヘッダーとséquence明細に取り込みます。

4. 製造現場からの実績報告。作業者はSkyPlanner Mobile ConfirmationsまたはProduction Timerで作業を記録し、その作業時間記録によってスケジュールが最新に保たれます。作業時間をDivaltoへ書き戻すかどうかは選択できます。書き戻す場合は、作業時間をGG_TEMPS_IMPORTファイル、完了サイクルをGG_FIN_DE_CYCLEファイルとして送信します。書き戻さない場合は、従来どおりDivaltoのMESに作業時間を入力します。

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

OFの日程を書き込む主体は一つに決めてください。予定日時の書き込みは、Opcenter APSや手動での日程再調整に代わってSkyPlannerが担います。Opcenter APSを使用している場合、SkyPlannerがスケジュールするOFについては、Opcenter APSからの取込を無効にしてください。両方がGG_DATES_ORDOを使用するためです。

• scrutateurの設定。 create_dataxmlのファイルを受信できるのは、生産用scrutateurが有効で、Production dossierのMESチェックボックスと「Interfaces」パスが設定されている場合だけです。
• トークンの更新。 Divaltoのアクセストークンは短時間で失効します（「認証」を参照）。API呼び出しをまとめて実行するたびに、事前に更新してください。
• クエリの登録。 RecordSqlクエリは、新規作成や変更から有効になるまで数分かかります。初期データの取り込み前に登録してください。
• 親OFと子OF。 Divaltoが日程を再調整するのは親OFだけです。子OFを子製品としてスケジュールし、構成品が揃うまで親OFが待つようにします。
• 品目の特性。 Divaltoでは、品目のスケジューリング属性を十個の特性フィールドに保持します。これらは、段取り時間マトリクスや「Allow similarity」で使うSkyPlannerの製品属性に対応付けやすい項目です。