供給同期の透明性

供給同期ワークフローの例

履行管理者が ITEM001 の複数の同期要求を NODE01の ITEM100 にプッシュするシナリオを考えてみます。 ITEM001-ITEM010や ITEM011-ITEM020などの単一ノードに対して、10 個の固有のアイテムを使用して 10 個の供給同期要求が行われると想定します。 要求ごとに、履行管理者は同じ batchIdを適用します。 標準の供給同期要求とは別に、供給同期 API (/v1/supplies) は、応答ペイロードで supplySyncTransactionId を返すようになりました。これは、更新の状況をトレースするために使用できます。

{
  "supplySyncTransactionId": "d088bba7-8d08-4d87-885a-fb24323b1cg9",
  "batchId": "a014bba7-8d08-4d87-885a-fb24323b1cf8"
}

その後、履行管理者は、サプライ同期トランザクション状況 API (v1/supplies/transaction/{supplySyncTransactionId}/status) を使用して、単一要求 [ITEM001-ITEM010] の全体的な状況を確認し、推定完了時刻と各状況のレコード数を表示することができます。

供給同期トランザクション・レコード (v1/supplies/transaction/{supplySyncTransactionId}/records) を使用して、供給同期の元の要求入力を確認することもできます。 各レコードのステータスも、レコードがイベントによってパブリッシュされているかどうかを確認するための詳細とともに提供されます。 イベントが無効になっている場合、 published 属性は常に false です。

履行管理者は、トランザクション ID を使用して個々の同期要求を確認できます。 ただし、トランザクション ID を忘れた場合は、供給同期トランザクション検索を使用できます。 サプライ同期トランザクション検索 API (v1/supplies/transaction/status) は、一定期間にわたって、または batchIdによって、トランザクションを見つけることができます。 応答は、 supplySyncTransactionIdとともに、一致する複数のトランザクション状況レコードで構成されます。

いずれかの供給同期レコードが失敗した場合、履行管理者は、供給履歴 API (v1/supplies/history) を使用して sourceTs 値および updatedTs 値を検証し、個々のレコードを再同期する必要があるかスキップする必要があるかを判別することができます。

供給の透明性をアクティブ化し、バッチ ID に要求を関連付ける手順

サプライ同期の一部として recordTransaction クエリー・パラメーターを設定することにより、サプライ同期の透過性トラッキングをアクティブにすることができます。 供給同期要求を受け入れると、システムは自動的に supplySyncTransactionIdを生成します。これを使用して、要求の状況と詳細を識別できます。 1 つ以上の提供同期要求を単一のバッチに関連付けるために使用できる 3 つの照会パラメーターは、以下のとおりです。

/{tenantId}/v1/supplies?recordTransaction=true&newBatch=true
/{tenantId}/v1/supplies?recordTransaction=true&batchId=a014bba7-8d08-4d87-885a-fb24323b1cf8
/{tenantId}/v1/supplies?recordTransaction=true&endOfBatch=true&batchId=a014bba7-8d08-4d87-885a-fb24323b1cf8

{
  "supplySyncTransactionId": "d088bba7-8d08-4d87-885a-fb24323b1cg9",
  "batchId": "a014bba7-8d08-4d87-885a-fb24323b1cf8"
}

同期トランザクション状況の提供

トランザクション状況 API は、供給同期トランザクション状況の概略を提供します。 状況を表示するには、有効な supplySyncTransactionIdを指定する必要があります。 この API は、実行依頼されたタイム・スタンプ、推定完了期間、および完了タイム・スタンプを提供します。 推定完了期間は、同期プロセス全体が完了すると予想される時刻と、エラーが発生したかどうかを確認できる時刻を示します。 estimatedCompletionTime 状況は、ジョブが COMPLETED または EXCEPTION 状況でない場合に返されます。

同期トランザクション・レコードの提供

この API を使用すると、トランザクションの一部として元の供給同期要求入力を検索することができ、結果をレコード状態 [SUBMITTED, CHANGED, UNCHANGED, FAILED] でフィルターに掛け、状態 [true] でパブリッシュすることができます。

各供給同期トランザクション・レコードは、その処理状態で許可されているシステムによって受け入れられた要求入力を表します。

供給履歴

供給同期トランザクション・レコード API を使用して元のレコードを取得できる一方で、供給同期中に供給調整を行うことができる場合があります。 供給更新履歴 API は、システム上で最後に更新された供給レコードの真の値を返します。

この API は、ユーザー入力によって提供された sourceTS 、および供給レコードが最後に変更されたときのタイム・スタンプである updatedTsとともに、供給レコードの詳細を返します。 どちらの属性を使用しても、調整要求または同期要求を最初にシステムに対して行うかどうかを決定することができます。

同期トランザクション検索の提供

同期トランザクション状況およびレコードの提供 API を使用するには、 supplySyncTransactionIdを指定する必要があります。 ID の値が見つからない場合は、トランザクション検索 API を使用して、一致する supplySyncTransactionId または batchIdを見つけることができます。