次の方法で共有

材料取り扱い設備のインターフェイス (MHAX)

  • [アーティクル]

材料取り扱い設備インターフェイス (MHAX) を使用すると、外部の物理材料取り扱い (MH) システムを、Microsoft Dynamics 365 Supply Chain Management の倉庫管理プロセス (WMS) によって管理される倉庫に接続できます。 WMS と MH システム間のインターフェイスは、2 つのキューで構成されています: 1 つは発信イベント用 (WMS から MH)、もう 1 つは受信イベント用 (MH から WMS )です。 WMS システムは、さまざまな作業の作成および実行プロセス中に作成された作業明細行に基づいて発信イベントを生成します。 次に、MH システムは、新しいイベントについて定期的に WMS システムをポーリングして、応答を処理します。 MH システムは、作業指示に従ってイベントの処理を終了した後、作業明細行の完了やショート ピッキングなどの受信イベントを送信します。

重要

この機能を有効にした場合、選択した第三者サービスでデータが共有されます。 第三者と共有するデータがある場合は、ユーザーが管理します。 お客様が第三者サービスを使用することには、お客様の責任と第三者との間で合意された条件が適用されます。 Microsoft にとってお客様のプライバシーは重要です。 詳細については、Microsoft プライバシー ステートメントをお読みください。

次の図は、MHAX 統合を使用する際に発生するさまざまな要素およびプロセスの順序を示しています。

MHAX コンポーネントと相互作用。

ここでは、前の図に示した相互作用について説明します。

  1. 作業の作成または作業の実行中に、発信イベントが発信キューに作成されます。
  2. MH 設備は、MH 設備サービスに接続し、関連する新しいイベントに対するポーリングを行い、それらのイベントを処理します。
  3. MH 設備を再報告する準備ができたときに、その設備が再度サービスに接続し、受信イベントを送信します。 これらのイベントは、キュー プロセッサによって直ちに処理されます。
  4. 受信イベント データに基づいて、キュー プロセッサで既存の作業を実行したり、変更したり、新しい作業を作成したりします。

MHAX 機能をオンにする

MHAX 機能を使用する前に、その機能とコンフィギュレーション キーの両方を有効にする必要があります。

  1. Supply Chain Management のバージョン 10.0.28 以前を稼働している場合、次のいずれかの手順を実行します:
    1. システム管理者 > ワークスペース > フィーチャー管理 の順に移動します。
    2. 機能管理 ワークスペースで、材料取り扱い設備のインターフェイスという名前の機能を有効にします。 (Supply Chain Management 10.0.29 では、この機能は必須であり、オフにすることはできません。)
  2. メンテナンス モードの説明に従って、システムをメンテナンス モードにします。
  3. システム管理 > 設定 > ライセンス コンフィギュレーション の順にクリックします。
  4. 取引 >倉庫と輸送管理を展開し、材料取り扱い設備のインターフェイスのチェック ボックスをオンにします。
  5. メンテナンス モードの説明に従って、メンテナンス モードをオフにします。

MHAX パラメーターの設定

この機能を構成するには、材料取り扱い設備のインターフェイス パラメーター ページでいくつかの一般的なパラメーターを設定する必要があります。

  1. 材料取り扱い設備のインターフェイス > 設定 > 材料取り扱い設備のインターフェイス パラメーターに移動します。

  2. 一般タブで、次のフィールドを設定します。

    • ユーザー マッピング - システム ユーザーを関連する倉庫作業者にマップします。 システム ユーザーを使用して受信キュー サービスを呼び出します。 選ばれた作業者には、インバウンドキューで処理される作業 (ピックとプット) が割り当てられます。 作業操作は、各作業者の既定の倉庫で実行されます。
    • 受信メッセージ ID を有効にする – このオプションがはいに設定されている場合、重複する受信メッセージ ID を受信するとメッセージが拒否され、エラー メッセージにメッセージが既に存在することが示されます。 このオプションをいいえに設定すると、重複する受信メッセージ ID が許可されます。
    • 手動受信メッセージの作成を有効にする - このオプションを はい に設定した場合、受信キュー ページからレコードを直接作成することで、着信メッセージをシミュレートできます。

  3. 番号順序タブで、システム全体の番号順序を選択します。この番号順序を使用して、受信キュー項目、発信キュー品目、および作業明細行のペアに対して固有 ID を生成します。

発信イベント

作業の作成中または作業の実行中の特定の時点で、MH システムに送信する発信イベントを生成する必要するかどうかはシステムが決定します。 倉庫の処理中に特定のポイントに対してサブスクリプションが構成されている場合、サブスクリプションの設定に従ってイベントが生成されます。

発信イベントの構造

各発信イベントは、発信キュー ID で一意に識別されます。 発信トランザクション タイプはイベントのタイプを決定します。 イベントを生成したサブスクリプションの倉庫および ID もイベントに記録されます。

MH システムにデータを転送するために、発信イベントには、データ用の 10 フィールド (data01 から data10) が含まれます。 これらのデータ フィールドには、既存のデータベース フィールドに対して 1 対 1 (1:1) のマッピングがあります。 具体的には、作業明細行および作業ヘッダー テーブルのフィールドから抽出されます。 フィールドは自由に選択できます。 サブスクリプションを作成するときに設定します。

既存のデータベース フィールドに対して 1:1 のマッピングを行う 10 のデータ フィールドに加え、イベントには、ペイロードと呼ばれる追加のデータ フィールドを含めることができます。 このフィールドの内容は、ペイロード ジェネレーターと呼ばれるカスタム X++ コードによって生成されます。 使用する必要があるすべてのペイロード ジェネレーターはサブスクリプションで設定されます。

MH システムが各発信キュー ID を 1 回だけ受信するために、ステータス フィールドを使用して、イベントを外部処理システムに送信できる (準備完了ステータス) かどうか、またはすでに送信されている (送信済ステータス) かどうかを指定します。

発信キューのサブスクリプション

イベントを生成する前に、イベントを生成するかどうか、および生成する方法を MHAX 機能に示すサブスクリプションを設定する必要があります。 生成されたイベントはサブスクリプション ID によってタグ付けされます。 したがって、複数の MH システムは同じ WMS システムに接続できますが、イベントは別々に維持されます。 MHAX サービスが新しいイベントに対するポーリングを行う場合、サブスクリプションはイベントを取得する際に使用できるオプションの 1 つです。

サブスクリプションを作成するには、材料取り扱い設備のインターフェイス > 設定 > サブスクリプションに移動します。 各サブスクリプションに対して、次のパラメータを使用できます。

  • サブスクリプション ID – サブスクリプションを識別する一意の名前。
  • 説明 – サブスクリプションの自由書式の説明。
  • 倉庫 – イベントをフィルタ処理する特定の倉庫。
  • 発信トランザクション タイプ – サブスクリプションに含まれるイベントのタイプ。
  • ペイロード ジェネレーター – 発信イベントのプレイロード フィールドに追加情報を入力できるコード拡張機能。

クエリは各サブスクリプションに関連付けできます。 このクエリは、作業明細行とヘッダーをフィルタ処理して、サブスクリプションを使用してイベントを生成する作業をさらに制限します。 サブスクリプションにクエリを追加するには、サブスクリプションページで関連するサブスクリプションのクエリの実行チェック ボックスをオンにし、アクション ウィンドウでクエリの編集を選択します。 標準の Supply Chain Management クエリ エディターが表示されます。

さらに、サブスクリプションには、必要に応じて、作業ヘッダーまたは作業明細行のいずれかのフィールドを発信イベントの 10 種類の空きデータ フィールドの一部またはすべてにマップするサブスクリプション マップが含まれます。 MHAX サービスに情報を返すには、通常、作業明細行レコード ID または作業明細行ペア ID が含まれます。 (作業明細行ペア ID は、システムが単一の返却コマンドを使用してピッキング明細行とプット明細行を処理できるようにする新しいプロパティです。) 残りのフィールドは、ユース ケースによって異なります。 この記事の後半で例をいくつか紹介します。

サブスクリプション マップを設定するには、サブスクリプションページで関連するサブスクリプションを選択し、アクション ウィンドウでサブスクリプション マップを選択します。 表示されたサブスクリプション マップ ダイアログ ボックスで、必要に応じて使用できる各データ フィールドに対してテーブルとフィールドを割り当てることができます。

発信イベント タイプ

このセクションでは、使用可能なさまざまなイベント タイプについて説明します。 (イベント タイプはトランザクション タイプとも呼ばれます。) また、各タイプのイベントが WMS システムでいつ作成されるかについても説明します。

作業作成イベント (WorkCreation)

作業作成イベントは、アプリケーションによって作業が生成された後に作成されます。 この動作は、ほとんどのタイプの作業作成プロセス、特にピッキングおよび補充作業の作成に適用されます。 一般に、作業がオープン状態で作成され、作業を作業員が実行できる状態を示す場合は、作業作成イベントが生成されます。 さらに、基本的な移動作業 (テンプレート作業による移動ではない) については、オープン作業として作成されていなくても、作業作成イベントが生成されます。

この動作の例外として、現在サポートされていない循環棚卸作業があります。 MH システムの在庫棚卸は MHAX の範囲外にあり、棚卸の結果を在庫棚卸仕訳帳にインポートする必要があります。

作業の作成が完了すると、MHAX サービスは生成された作業明細行を処理し、各作業ヘッダーに対して生成されたすべての作業明細行に作業明細行ペア ID を割り当てます。 その目的は、すべてのピッキング作業明細行を、1 つの作業行に分け、その後の 1 つの作業行に分法でグループ化します。 (グループは、作業テンプレートのピック/プットのペアに対応します。) これにより、1 つの ID を使用して、関連のすべてのピッキング明細行とプット明細行の作業完了を報告できます。 グループ化プロセスは最初の行から始まり、連続するプット/ピック作業明細行のペアに遭遇するまで同じ ID で続行されます。 実行している ID は、そのペアのプット明細行に割り当てられます。 その後、ペアのピック明細行に使用される新しい ID。 このプロセスは、作業ヘッダーに属しているすべての明細行が処理されるまで続行されます。

作業作成イベントの特別な機能として、作業ヘッダーでブロックされたウェーブをはいに設定した場合、生成されたイベントは、MH システムへの送信に使用される準備完了の通常のステータスではなく、ステータスがブロックになります。 作業ヘッダーのブロックされたウェーブ フラグは、おそらく未完了の補充作業のために、作業ヘッダーがまだ作業者を実行する準備ができていないことを示します。 ブロックされたウェーブ フラッグが無効にされている場合、生成済みのイベントのブロックが解除され、MH システムがキューから取得できます。

作業開始イベント (WorkInitiation)

作業開始イベントは、作業状態が作業の更新時に開くから進行中に変更される場合にトリガーされます。

作業完了イベント (WorkCompletion)

作業完了イベントは、作業状態が作業の更新時に進行中から終了済に変更される場合にトリガーされます。

作業のキャンセル イベント (WorkCancel)

作業完了イベントは、作業状態が作業の更新時にキャンセル済みからキャンセル済み以外のステータスに変化したときにトリガーされます。 さらに、作業ヘッダーに関連付けらた他のすべてのイベントは、すべてのサブスクリプションのキューから削除されます。 これにより、外部システムが不必要なイベントを処理するのを防ぎます。

ピック/入力完了イベント (PickCompletion/PutCompletion)

ピック/プット完了イベントは、作業明細行の更新中にピック/プット明細行の状態が進行中から終了済に変更される場合にトリガーされます。

発信キューの監視

発信キューを確認するには、材料取り扱い設備のインターフェイス >共通 > 発信キューに移動します。 発信キューページは、すべての発信キュー品目とその状態が一覧表示されます。 キュー品目を選択して、その詳細を表示します。 これらの詳細には、品目のトランザクション タイプ、使用したサブスクリプション、各データ フィールド (data01 から data10) およびペイロードの値が含まれます。

発信キューのクリーンアップ

最終的に、発信キューは既に送信されたキュー品目でいっぱいになり始めます。 これらの品目を削除するには、材料取り扱い設備のインターフェイス > 定期処理のタスク > クリーンアップ> 発信キューのクリーンアップに移動します。

受信イベント

このセクションでは、MH システムが WMS システムに報告できるさまざまな種類の受信イベントについて説明します。 また、データは MH システムによって提供される必要があり、各受信イベントが WMS システムで何を行うかについても説明します。

受信イベントの構造

受信イベントが送信されると、外部システムは最大 10 個のパラメータ (data01 から data10) とともに受信トランザクション タイプを提供する必要があります。 オプションの検証により、MHAX サービスが同じ受信イベントを複数回受信していないことを確認できます。 この検証を有効にするには、各受信イベントに一意のメッセージ ID が必要です。 重複するメッセージ ID を受信し、材料取り扱い設備のインターフェイス パラメーターページで受信メッセージ IDを有効にするオプションがはい に設定されている場合、メッセージは拒否されます。 エラー メッセージは、メッセージが既に存在することを示します。

受信データ フィールドに加えて、システムはイベントに一意の受信キュー ID を割り当てます。

受信イベント タイプ

このセクションでは、サポートされている受信イベント タイプ (トランザクション タイプ) と、イベントを処理するために提供する必要のあるデータについて説明します。

作業確認イベント (WorkConfirm)

作業確認イベントは、受信するデータ フィールドに次の情報が含まれる必要があります。

  • data01 – 作業明細行ペア ID。

  • data02 – 作業明細行レコード ID (RecId 値)。

    メモ

    data01 フィールドまたは data02 フィールドのどちらかが存在している必要があります。

  • data03 – ピックするライセンス プレートの ID。

  • data04 – 作業ヘッダーのターゲット ライセンス プレート ID。

作業明細行ペア ID が提供されている場合、作業明細行ペア ID でマークされ、状態が開くまたは進行中であるすべてのピック、プット、またはカスタム作業明細行が順番に実行されます。 作業明細行レコード ID (RecId 値) が提供されている場合は、開くまたは進行中の状態を持つ、作業明細行がピック、プット、またはカスタム作業明細行である必要があります。

ライセンス プレートで管理されている場所からのピック明細行では、明細行が作業明細行レコード ID または作業明細行ペア ID のどちらでマークされているかに関係なく、data03 でピックするライセンス プレートを指定する必要があります。 data04 フィールドは、ピックに対する作業ヘッダーのターゲット ライセンス プレートを指定する必要があります。

プット明細行は、それ以上の情報を受け入れません。 これらは、現在の作業明細行の場所と作業のターゲット ライセンス プレートのみに基づいて実行されます。 別の場所にプットを行う必要がある場合は、この記事の後半の 上書きイベント セクションの説明に従って、作業明細行の場所を変更してください。

カスタム作業明細行は、受信イベントで追加情報を必要とせず、サポートしません。

ショート ピック イベント (ShortPick)

ショート ピック イベントは、受信するデータ フィールドに次の情報が含まれる必要があります。

  • data02 – 作業レコード ID (RecId 値)。
  • data03 – ピックするライセンス プレートの ID。
  • data04 – ピックする数量。
  • data05 - 作業例外レコードにリンクされているショート ピック例外 コード。例外タイプの値はショート ピックです。
  • data06 – 作業ヘッダーのターゲット ライセンス プレート ID。 この ID は、自動的に生成される設定の場合は空白のままにすることができます。

注記

data01 フィールド は、ショート ピック イベントに使用されません。

このイベントは作業確認イベントと似ていますが、ピック明細行にのみ適用されます。

上書きイベント (Override)

上書きイベントは、受信するデータ フィールドに次の情報が含まれる必要があります。

  • data01 – 作業レコード ID (RecId 値)。
  • data02 – 新しい場所の ID。

作業明細行は、開くまたは進行中のいずれかの状態であり、 新しい場所が存在する必要があります。

ライセンス プレート受領書イベント (LPReceipt)

ライセンス プレート受領書イベントは、受信するデータ フィールドに次の情報が含まれる必要があります。

  • data01 – 受け取る受信ライセンス プレートの ID。

システムは、data01 フィールドの値として渡されたライセンス プレートに基づいて、ライセンス プレートの入荷の操作を実行します。

受信キューの監視

受信キューを確認するには、材料取り扱い設備のインターフェイス >共通 > 受信キューに移動します。 受信キュー ページは、すべての受信キュー品目とその状態が一覧表示されます。 キュー品目を選択して、その詳細を表示します。 これらの詳細には、品目のトランザクション タイプ、メッセージ ID、各データ フィールド (data01 から data10) の値が含まれます。

受信イベントの処理中にエラーまたは別のタイプのログ品目が発生した場合は、アクション ウィンドウでエラー ログを選択してログを検査できます。

受信イベントの処理

受信イベントは、まずデータベースに書き込まれた後、すぐに (同期敵に) 実行されます。 処理中にエラーが発生した場合でもイベントはキューに書き込まれますが、状態はエラー済に設定されています。 MHAX サービスは MH システムにエラー メッセージを返し、その後の調査のために受信イベント レコードにエラー ログを格納します。

エラーの状態があるイベントは、エラー条件が修正されれば、後で再処理できます。 それらを再処理するには、次のいずれかの手順に従います。

  • 材料取り扱い設備のインターフェイス > 共通 > 受信キューに移動します。 関連する受信キューを選択し、アクション ウィンドウ 再処理を選択します。
  • 材料取り扱い設備のインターフェイス > 共通 > エラー受信キューの再処理に移動します。 標準のバッチ ジョブ ダイアログ ボックスが表示されます。 そこでレコード フィルタを設定し、バッチ ジョブをスケジュールまたは実行してキューを再処理できます。

すべての作業操作 (ピックとプット) は、材料取り扱い設備のインターフェイス パラメーター ページのユーザー ID フィールドで選択された作業者を使用して実行されます。

受信キューのクリーンアップ

最終的に、受信キューは既に処理されたキュー品目でいっぱいになり始めます。 これらの品目を削除するには、材料取り扱い設備のインターフェイス > 定期処理のタスク > クリーンアップ> 受信キューのクリーンアップに移動します。

キュー マネージャを使用した簡単な概要の取得

受信キューと発信キューに関連付けられているすべての活動の簡単な概要を取得するには、材料取り扱い設備のインターフェイス > ワークスペース > キュー マネージャに移動します。 キュー マネージャ ページは、キューを監視および参照するために使用できる一連のタブとタイルを提供します。 また、この記事に記載されている他の多くのページへの便利なリンクも紹介します。

MHAX サービスに接続

MHAX はカスタム サービスとして実装されます。 したがって、SOAP および REST 呼び出しを介してアクセスできます。 SOAP および REST エンドポイントのアドレスは次のとおりです。

  • SOAP:https://base_environment_URL/soap/services/WMHEServices
  • REST:https://base_environment_URL/api/services/WMHEServices/WMHEService

発信キューからのメッセージの取得

発信キューからメッセージを取得するには、次のいずれかの方法を使用します。

  • readOutboundSubscriptionQueue を使用してサブスクリプション ID に基づいてイベントを取得します。
  • readOutboundWarehouseQueue を使用して複数のサブスクリプションにわたるイベント タイプと倉庫 ID に基づいてイベントを取得します。