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

Epicorは次のように説明しています。”All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.”（ビジネスオブジェクト、プロセス、レポート、BAQs、Epicor Functionsを含むすべてのKineticサービスに、RESTエンドポイントからアクセスできます。）スケジューリング連携は、Epicorの四つの技術を基盤とします。

1. Kinetic REST API v2 (OData v4)。ビジネスオブジェクトは、Erp.BO.<Name>Svc という名前のサービスとして公開されます。通常のパスは /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet} です。REST v1 も残っていますが、旧仕様のため、連携は v2 で構築してください。利用するリリースのエンティティセットとメソッドは、/api/help/v2/ の REST Help で確認してください。
2. REST 経由の Business Activity Queries (BAQ)。BAQ は /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data で公開されます。JobHead、JobOper、JobMtl、PartWhse、PORel を結合し、一度の呼び出しで計画用データを抽出する際に実用的な取得方法です（コミュニティの実装例）。
3. Epicor Functions (EFx)。/api/v2/efx/{Company}/{Library}/{Function} で呼び出せるサーバー側の関数です。Epicor は、これらの関数について “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.”（BPM、REST サービス、スケジュール、アプリケーションイベントなど、複数の起点から実行できる）と説明しています。
4. BPMディレクティブ。Method DirectivesとData Directivesは、製造指図や工程の変更時に発火し、データを外部へ送信する関数を呼び出せます。

ファイル連携では、取込にDMT、外部向けのデータ抽出にBAQエクスポートを使用します。EpicorはEpicor Automation Studioも提供しており、これを”a low-code app for integration-led automations”（システム連携を軸とした自動化のためのローコードアプリ）と説明しています。データベースへの直接アクセスは避けてください。REST、BAQs、関数は、オンプレミスでもKinetic Cloudでも同じように動作します。

Epicorのドキュメントには汎用の送信用Webhook APIが記載されていないため、Kineticの変更は次の二つの方法のいずれかでSkyPlannerに伝えます。

• イベント駆動。JobHead または JobOper の BPM Data Directive が Epicor Function を呼び出し、その関数が変更されたジョブを SkyPlanner REST API に送信します。
• 定期ポーリング。変更日時で絞り込むBAQを数分ごと、または毎時実行します。運用管理も障害復旧も、こちらのほうが容易です。

逆方向では、SkyPlannerがWebhookで状態やスケジュールの変更を送信します。お客様のミドルウェアまたはEFxエンドポイントが受信し、Kineticに書き込みます。

1. マスタデータの初回取り込み。品目、リソースグループ、リソース、対応能力、カレンダー、従業員を取得します。Kinetic のリソースを基に SkyPlanner のリソースを、リソースグループを基にリソースグループを作成します。大量のデータを取得する場合は、$top と $skip でページ分割するか、BAQ で一括取得してください。

2. オーダーの同期。リリース済みかつ確定済みのジョブを、工程・資材とともに送信します。エンティティを個別に取得するのではなく、GetDatasetForTree または BAQ でジョブツリーを取得してください。未確定の MRP ジョブは、確定するまで Kinetic に残します。在庫の取得と併せて、未完了の発注納入明細と納期も同期します。SkyPlanner は発注済み資材を納入日から使用可能として扱い、発注のステータスが Delivered になると在庫を更新します。そのため、スケジューリングでは在庫と入荷予定の両方が考慮されます。

3. スケジュールの書き戻し。SkyPlanner の Webhook が、工程ごとの開始・終了予定日時とリソースを EFx エンドポイント（/api/v2/efx/{Company}/{Library}/{Function}）に送信します。関数は Kinetic のスケジュールエンジンを通じて書き込みます。これは Job Entry のスケジューリングやスケジュールボードでも使われるビジネスオブジェクトです（コミュニティの実装例）。処理は次のとおりです。

1. ScheduleEngine.GetNewParamsForJob が、そのジョブ用のスケジュールエンジンのデータセットを作成します。
2. 関数でジョブ番号、組立順序番号、工程順序番号、開始予定日時を設定し、ScheduleEngine.MoveJobItem を呼び出します。
3. SkyPlanner がグループ内の別のリソースに工程を割り付けた場合は、ScheduleEngine.ChangeResource でそのリソースへ移動します。MoveJobItem だけでは、グループの既定のリソースが使われたままになります。
4. 関数でジョブのスケジュールロック（JobHead.SchedLocked、Job Entry の Lock オプション）を設定します。これにより、Global Scheduling でも SkyPlanner が設定した日付が維持されます。

これらの呼び出しを一つの Epicor Function にまとめると、ジョブ単位で書き込みの原子性を保ち、独自の検証処理も追加できます。カスタム関数を使わない方針の拠点では、Erp.BO.ScheduleEngineSvc を REST で直接呼び出して同じ処理を実行できます。ResourceTimeUsed や JobOper の日付フィールドには、絶対に直接書き込まないでください。エンジンを経由しないため、スケジュールボードの割り付けと不整合が生じます。

4. 製造現場の実績登録。作業者は Mobile Confirmations、Production Timer、Quick Log Mode を使って SkyPlanner に作業を記録します。終了した作業時間記録は、Erp.BO.LaborSvc を通じて Kinetic の作業実績になります。リアルタイムの作業記録には StartActivity と EndActivityByEmp を、事後入力には Labors と Update を使います。拠点で承認が必要な場合は、処理フローとアクセススコープに submitForApproval を含めてください。

5. データの管理主体と競合時のルール。本稼働前に以下を明文化してください。

SkyPlannerがスケジューリングする製造指図にはスケジュールロックが設定されるため、Global Schedulingはその日程を変更しません。SkyPlannerの計画対象外のリソースには、引き続きKineticのスケジューリングを使用してください。

通常、導入支援の開始から数週間で実装が完了します。Kineticとの連携プロジェクトでは、以下を行います。

1. 開発に着手する前に、製造指図、工程、リソースをCSVまたはExcelでエクスポートし、そのデータで30日間試用します。
2. APIキー、アクセススコープ、連携専用ユーザー、連携で読み取るBAQsを設定します。
3. マスタデータをマッピングします。能力、リソースグループ、リソース、カレンダー、従業員を、SkyPlannerのワークステーション、グループ、シフト、人員に対応付けます。
4. 品目、製造方法（BOMと工程）、リソースを初期投入します。
5. ジョブと発注（PORel の納期）、および PartWhse の在庫の同期。
6. Epicor Function 内で ScheduleEngineSvc (MoveJobItem, ChangeResource) を使い、工程の予定日を書き戻す処理。ジョブのロックも設定します。
7. LaborSvc を通じて、製造現場の実績を作業実績として登録。
8. 現在のKineticのスケジュールと並行してテストし、その後、本稼働に移行します。

Kineticの運用方法は工場ごとに異なります。能力に基づく工順、リソースグループのカレンダー、BAQの設計、BPMディレクティブ、リリースごとの書き戻しメソッドは、拠点によって違います。これらを正しく設定できるかどうかが、計画担当者が信頼できるスケジュールになるか、手直しが必要になるかの分かれ目です。

1. SkyPlannerチームが導入支援時に設定し、本稼働後もサポートします。お客様のリソース、製造指図、購買発注の納入明細をマッピングし、BAQによる読み取り、BPMトリガー、書き戻し関数を設定します。SkyPlannerのREST APIとWebhookをKinetic REST v2に接続します。BAQs、BPMs、Kineticのリリースが変わった場合も、サポートを継続します。
2. お客様のEpicorパートナー。BAQs、BPMs、Epicor Functionsの開発経験があるパートナーは、公開仕様に基づく同じSkyPlanner REST APIを使って開発できます。このAPIでは、オーダー、製品、資材、工程、時間記録を読み書きできます。
3. お客様の社内開発者。Kinetic RESTの経験がある社内チームは、直接開発できます。Automation Studioを利用している場合は、その上での開発も可能です。SkyPlannerのAPIキーがあれば着手でき（連携チュートリアル）、必要に応じてSkyPlannerチームが支援します。製品ドキュメントはSkyPlannerドキュメントで公開しています。

同じAPIとWebhookによる連携方式は、UTUなど、他のERPを使う企業でも本稼働しています。Laboratory & Alliedでは、社内ITチームがSkyPlannerの支援を受けながら、SAP Business Oneとの連携の大部分を自力で構築しました。

どの方法でも、最初の手順は同じです。まずCSVを取り込んで30日間の無料トライアルを行い、スケジュールを検証してから連携を構築します。料金はワークステーション5件を含めて月額199 €から。月払いで、いつでも解約できます。連携費用は、お客様の業務プロセスと要件に合わせ、プラン料金とともに事前にお見積もりするため、開始前に総費用を確認できます。