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

Proalpha ERPはProgress OpenEdge上で動作し、Release 9で基盤がOpenEdge 12に移行しました。（Proalpha）スケジューリングに関わる主なインターフェースは四つあります。

1. Proalpha ERP REST APIs。公開されているProalpha API Portalには、api/web/v1配下のOpenAPI 3.0仕様が108件掲載されています。書き戻しと、部品・在庫の読み取りに使用します。
2. Integration Workbench (INWB)。ProalphaはINWBについて、”is a central platform which connects different IT systems, machines, sites”（異なるITシステム、機械、拠点を接続する中核プラットフォーム）であり、”converts the data into the format of the target system.”（データを接続先システムの形式に変換する）と説明しています。（Proalpha）POST /api/web/v1/inwb/messageを通じてpAXメッセージを受信します。Proalphaとの製造指図の送受信に使用します。
3. Proalpha Integration Platform。2026年四月に発表された、n8nを基盤とするプラットフォームです。”will be available to customers either on-premises or in the cloud.”（オンプレミスまたはクラウドで顧客に提供される予定）とされています。また、Proalphaは”will rely on an API-centric reference architecture and REST interfaces.”（API中心のリファレンスアーキテクチャとRESTインターフェースを採用する予定）としています。（Proalpha）
4. EDIとファイル出力。INWBは業界固有のファイル形式を扱えます。SkyPlannerのトライアルでは、ファイル出力で対応できます。

生産関連のエンドポイント

Proalpha API Portalには、Webhook購読用のAPIは掲載されていません。Proalpha側の変更は、次の方法で取得します。

• 新規・変更済みの製造指図を工程とともに送信するINWBメッセージフロー
• Proalpha Integration Platform上のn8nワークフロー
• 在庫を取得するためのMaterial APIの定期ポーリング

SkyPlannerは状態やスケジュールの変更時にWebhookを送信するため、Proalphaへの書き戻しはイベント駆動で行われます。

1. マスタデータの初回取り込み。Part APIで部品を読み取り、INWBまたはファイル出力を使ってリソース、リソースグループ、カレンダーを初回に取り込みます。Proalphaの各リソースをSkyPlannerのどのリソースに対応させるか、明確に決めてください。代替リソースグループは、代替リソースに対応します。

2. オーダーの同期。INWBメッセージフローまたはn8nワークフローで、未完了の製造指図を工程、標準時間、リソースとともに送信します。在庫はMaterial APIからMRPエリア別に取得し、未納の購買発注はINWB経由で取得します。SkyPlannerは発注済み資材を購買発注の納入日から使用可能とみなし、購買発注のステータスがDeliveredになると在庫を更新します。

3. スケジュールの書き戻し。エンジンが配置または移動した各工程について、連携処理は工程のguidと開始・終了日時を指定してsetWorkOrderOperationDatesを呼び出します。エンジンが別のリソースを選択した場合は、続けてchangeWorkOrderOperationResourceを呼び出します。

4. 製造現場での実績登録。作業者はSkyPlanner Mobile ConfirmationsまたはProduction Timerで作業を記録します。作業時間ログによってスケジュールが最新に保たれ、operationDataEntryを通じてProalphaに実績が登録されます。工場ですでにPDC端末から実績を登録している場合は、二重登録を防ぐため、登録経路を一つに統一してください。

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

Proalpha APSまたはFeinplanungを使用している場合は、工程の日時をどちらのシステムで管理するか決めてください。二つのスケジューラが同じ日時を書き込むと、互いのデータを上書きしてしまいます。Autopilotを使用すると、生産状況の変化に応じてSkyPlannerが自動でスケジュールを組み直します。

• 工順オブジェクトはありません。Proalphaは製品のプロセスモデルに基づいて計画します。SAPやBusiness Centralのプロジェクトから流用したツールは工順を探すため、データを取得し損ねます。製造指図から工程とBOM明細を読み取ってください。
• カレンダーの稼働設定。カレンダーの時間枠にはintensityとoverloadIntensityが含まれます。時間数をそのままコピーするのではなく、SkyPlannerのシフトと稼働効率に対応付けてください。
• 計量単位。quantityUnitCodeと、標準段取り時間が指図単位か製品一個単位かを確認してください。単位を誤ると、すべての所要時間が不正確になります。
• 自社環境のエンドポイント。REST層は自社のProalphaサーバー上で動作します。ファイアウォール、ポート、証明書の準備状況がプロジェクトの開始日を左右するため、早めにアクセスを確保してください。
• リリースバージョン。マッピングを確定する前に、使用中のProalphaリリースで利用できるREST APIをパートナーに確認してください。
• ドキュメントの閲覧にはログインが必要です。ProalphaのオンラインヘルプはDocumentation Portal内にあります。フィールド名は推測せず、パートナーに確認してください。