イベントしきい値

イベントしきい値は、さまざまなレベルで構成を提供することにより、可用性イベントの生成頻度を制御するために使用されます。イベントしきい値は、グローバル・レベル、アイテム・レベル、ノード・レベル、または分配グループ・レベルで構成できます。しきい値構成は、イベントが below しきい値または above しきい値 (low, medium, high) に該当する場合にのみパブリッシュされるように、可用性の数量を検証するために使用されます。デフォルトでは、しきい値の設定に関係なく、数量がいずれかのしきい値レベルを超えると、イベントがパブリッシュされます。 eventThreshold 構成は、可用性レコードの計算時にそのレコードにスタンプされる thresholdLevel フィールドとともに使用されます。この API は、テナント・レベル、分配グループ・レベル、出荷ノード・レベル、およびアイテム・レベルで、高、中、および低の可用性イベント・レベルしきい値を定義するために導入されました。

重要: イベント・データの公開は、テナント・レベル、出荷ノード・レベル、および SKU レベルで制御できます。 SKU レベルは、出荷レベルよりも優先されます。船のノード・レベルはテナント・レベルより優先される。また raiseOnThresholdChange フラグが常に優先されます。もし raiseOnThresholdChange フラグがfalseに設定されている場合、SKUレベルの設定を使用して、SKUデータをWebhookまたは IBM Cloud® Object Storage エンドポイントに選択的に公開することができます。

注: デフォルトでは、スナップショット・イベントはイベントしきい値構成を考慮しません。ただし、しきい値構成は、 considerEventThreshold フラグを使用して制御できます。詳細については、Inventory service API ドキュメントの Trigger Node Availability Snapshot および Trigger Distribution Group Availability Snapshot を参照してください。

構成値

イベント・レベルしきい値は、しきい値レベルのストリング表現です。各レベルは包括的です。例えば、 eventThreshold が BELOW_HIGH の場合、可用性のしきい値レベルが BELOW_HIGH、 BELOW_MEDIUM、または BELOW_LOWのときに可用性イベントが発生することを意味します。使用可能な値は以下のとおりです。

しきい値レベル	説明
`NONE`	パブリッシュされたイベントはありません。
`BELOW_LOW`	数量が下限しきい値より少ない可用性が公開されます。
`BELOW_MEDIUM`	数量が中程度のしきい値未満の可用性が公開されます。
`BELOW_HIGH`	数量が上限しきい値より少ない可用性が公開されます。
`ABOVE_LOW`	数量が下限しきい値を超える可用性が公開されます。
`ABOVE_MEDIUM`	数量が中程度のしきい値を超える可用性が公開されます。
`ABOVE_HIGH`	数量が上限しきい値を超える可用性が公開されます。
`ALL`	すべてのイベントがパブリッシュされます。

テナント・レベル、アイテム・レベル、出荷ノード・レベル、および分配グループ・レベルでのイベントしきい値の API が導入されました。詳細については、Sterling Intelligent Promising API ドキュメントを参照してください。

以下の優先順位で使用される 3 つの異なる構成オプションがあります。

アイテム
ロケーション (出荷ノードまたは分配グループ)
グローバル (テナント固有)

注: 既存のすべてのテナントのグローバル・レベルは ALLに設定されています。そのため、設定を更新するまで、動作の変更が表示されない可能性があります。

表 1. イベントしきい値構成: 構成例
構成	ID	イベントしきい値
グローバル		`BELOW_LOW`
DG	`EastGroup`	`ABOVE_MEDIUM`
ノード	`store-BostonMA`	`BELOW_MEDIUM`
アイテム	`t-shirt`	`BELOW_LOW`

表 2. 可用性イベント: シナリオ例
SKU	現在の可用性しきい値レベル	発生したイベント	説明
`t-shirt / store-BostonMA`	`BELOW_LOW`	はい	項目イベントしきい値が最低レベルを下回っています。
`t-shirt / store-LittletonMA`	`BELOW_MEDIUM`	いいえ	項目イベントしきい値が最低レベルを下回っています。
`jersey / store-BostonMA`	`BELOW_LOW`	はい	アイテム構成がありません。ノード・イベントのしきい値が中レベルより小さくなっています。
`jersey / store-LittletonMA`	`BELOW_HIGH`	いいえ	アイテム構成がありません。ノード構成がありません。グローバル・イベントしきい値が最低レベルを下回っています。
`t-shirt / EastGroup`	`BELOW_HIGH`	いいえ	項目イベントしきい値が最低レベルを下回っています。
`jersey / EastGroup`	`BELOW_HIGH`	はい	項目構成がありません。DG イベントしきい値が中間レベルを超えています。

しきい値を超えたときのイベント・パブリッシングの有効化

グローバル・レベルでのイベントしきい値の構成に加えて、しきい値レベルでの可用性に変更がある場合は、イベントを構成して公開することもできます。グローバル・イベントしきい値 API を使用して、しきい値を超えたときにイベントを発生させるための新しい raiseOnThresholdChange プロパティーを構成できます。

raiseOnThresholdChange が true に設定されていて、イベント可用性しきい値レベルが変更された場合、 NONEに設定されている場合を除き、イベントしきい値レベルの構成に関係なく、イベントは発生します。
raiseOnThresholdChangeNONEイベントのしきい値レベルの設定がに設定されている場合、の設定値にかかわらず、イベントは発生しません。
raiseOnThresholdChange のデフォルト値は TRUEです。

テーブル3。グローバル・イベントしきい値構成: シナリオ例
イベントしきい値レベル	低	中間	高
`BELOW_LOW`	10	50	100

API について詳しくは、 Sterling Intelligent Promising APIを参照してください。

テーブル4。可用性イベント：シナリオ例1 (raiseOnThresholdChange = true)
使用可能数量	現在の可用性しきい値レベル	発生したイベント	説明
15	`BELOW_MEDIUM`	はい	項目イベントは、最初のイベントとしてしきい値を超えます。
25 GB	`BELOW_MEDIUM`	いいえ	項目イベントしきい値が中レベルより小さく、しきい値を超えていません。
55カ所の	`BELOW_HIGH`	はい	項目イベントがしきい値を超え、前の項目イベントしきい値が中レベルより小さくなっています。
5	`BELOW_LOW`	はい	アイテム・イベントのしきい値が最低レベルを下回っています。
10	`BELOW_LOW`	はい	アイテム・イベントのしきい値が最低レベルを下回っています。

テーブル5。可用性イベント：シナリオ例2 (raiseOnThresholdChange = false)
使用可能数量	現在の可用性しきい値レベル	発生したイベント	説明
15	`BELOW_MEDIUM`	いいえ	項目イベントしきい値が「中」を下回っており、しきい値を超えるとイベント・パブリッシングが無効になります。
25 GB	`BELOW_MEDIUM`	いいえ	項目イベントしきい値が中レベルより小さいです。
55カ所の	`BELOW_HIGH`	いいえ	項目イベントしきい値が最高レベルより小さく、しきい値を超えるとイベント・パブリッシングが無効になります。
5	`BELOW_LOW`	はい	項目イベントしきい値が最低レベルを下回っています。
10	`BELOW_LOW`	はい	項目イベントしきい値が最低レベルを下回っています。