翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
イベントフィルターを設定する
イベントフィルターを使用すると、計算属性で使用するプロファイルオブジェクトをフィルタリングできます。例えば、イベントフィルターで顧客の標準アセットオブジェクトをフィルタリングして、ステータスがインストール済みまたは登録済みのアセットのみが計算に含まれるようにすることができます。
注記
計算属性の定義を作成した後でイベントフィルターを編集することはできません。
計算属性を作成する際に、1 つまたは複数のイベントフィルターを作成できます。イベントフィルターは、以下のコンポーネントで構成されています。
-
フィルターグループ: プロファイルオブジェクトに適用するフィルターのグループ。OR 関係によって接続されている複数のフィルターグループを追加できます。
-
フィルター: 属性、演算子、値を指定して、計算属性の計算に含まれるプロファイルオブジェクトをフィルタリングします。ユースケースに必要な数のフィルターを追加できます。
-
属性: フィルタリングするオブジェクトの属性。Customer Profiles ドメインに保存されているオブジェクトから属性を選択するか、オブジェクトタイプ定義で定義されているフィールド名を使用できます。オブジェクトタイプのマッピングの詳細については、「Amazon Connect Customer Profiles のオブジェクトタイプのマッピング定義の詳細」を参照してください。
注記
-
Amazon Connect 管理ウェブサイトでは、属性ドロップダウンに、プロファイルオブジェクトが最後に保存または更新された時刻のタイムスタンプが 属性で表示されます。
-
プロファイルオブジェクトの属性と同じ名前のオブジェクトタイプのフィールドの両方がある場合、イベントフィルターはフィルタリングでオブジェクトタイプのフィールド名を優先します。例えば、プロファイルオブジェクトに Status という名前の属性があり、Status という名前のオブジェクトタイプフィールドがある場合、フィルターはフィルタリングにオブジェクトタイプフィールド Status を使用します。
-
-
演算子 - 演算子は入力された値と属性の関係を決定します。詳細については、「フィルター演算子」を参照してください。
-
値 — オブジェクトをフィルタリングする値。OR 関係によって接続された複数の値を指定できます。例えば、アセットのステータスはインストール済みまたは登録済み。値は大文字と小文字が区別されます。例えば、Asset's Status is Installed と Asset's Status is installed は異なる結果を返します。プロファイルオブジェクトを表示するには、Amazon Connect Customer Profiles の ListProfileObjects API を使用します。
オプションで、最大 2 つのイベントフィルターを作成し、それらの間の関係 (AND/OR/EXCLUDE) を作成できます。関係の詳細については、「イベントフィルター間の関係」を参照してください。
フィルター演算子
演算子は、入力された値と属性の関係を決定します。以下の表で、利用できる演算子について説明します。
| サポートされている属性値のタイプ | 演算子 | 説明 |
|---|---|---|
| Number | Greater than | 数値属性にのみ使用されます。この演算子は、渡された数より大きい結果をフィルタリングします。例えば、Asset's Quantity が 1 より大きい場合です。 |
| Greater than or equal | 数値属性にのみ使用されます。この演算子は、渡された数と同じか、より大きい結果をフィルタリングします。例えば、Asset's Quantity が 1 以上の場合です。 | |
| Equals | 数値属性にのみ使用されます。この演算子は、同じ数値を持つオーディエンスをフィルタリングします。例えば、Asset's Quantity が 1 に等しい場合です。 | |
| Less than | 数値属性にのみ使用されます。この演算子は、渡された数より小さい結果をフィルタリングします。例えば、Asset's Quantity が 2 未満の場合です。 | |
| Less than or equal | 数値属性にのみ使用されます。この演算子は、渡された数と同じか、より小さい結果をフィルタリングします。例えば、Asset's Quantity が 2 以下の場合です。 | |
| String | Is | 属性が指定された文字列と一致するオブジェクトをフィルタリングします。例えば、Ticket's Title が Refund の場合です。 |
| Is not | 属性が指定された文字列と一致しないオブジェクトをフィルタリングします。例えば、Ticket's Title が Refund でない場合です。 | |
| Contains | これを使用して、文字列内の部分文字列に基づいてオブジェクトをフィルタリングします。例えば、Ticket's Title に Refund が含まれる場合です。 | |
| Begins with | 属性が指定された文字列で始まるオブジェクトをフィルタリングします。例えば、Asset's SerialNumber が「1234」で始まる場合です。 | |
| Ends with | 属性が指定された文字列で終わるオーディエンスをフィルタリングします。例えば、Asset's SerialNumber が「0000」で終わる場合です。 | |
| 日付 | Before | 属性に特定の日付より前の日付値があるオブジェクトをフィルタリングします。例えば、Asset's UsageEndDate が 2024/10/01 より前の場合です。 |
| On | 属性値が特定の日付と一致するオブジェクトをフィルタリングします。例えば、Asset's UsageEndDate が 2024/10/01 の場合です。 | |
| After | 属性に特定の日付より後の日付値があるオブジェクトをフィルタリングします。例えば、Asset's UsageEndDate が 2024/10/01 より後の場合です。 | |
| Time range is | 属性の日付値が特定の時間範囲にあるオブジェクトをフィルタリングします。時間範囲は、絶対時間モードまたは相対時間モードで指定できます。 | |
| 絶対時間モード: 絶対時間範囲を指定できます。例えば、2024/10/01 午前 0 時 ～ 2024/10/07 午前 0 時です。 | ||
相対時間モード: 将来または過去の X 時間、X 日、X 週、X 月、または X 年を相対時間範囲として指定できます。
|
||
| Time range is not | 属性の日付値が特定の時間範囲にないオーディエンスをフィルタリングします。時間範囲は、絶対時間モードまたは相対時間モードで指定できます。詳細については、この表の Time range is 演算子を参照してください。 |
注記
Amazon Connect 管理ウェブサイトの計算された属性は、すべての時間ベースのフィルターに UTC タイムゾーンとデフォルトの時刻の 00:00:00 UTC を使用します。日付でフィルタリングできますが、時刻は同じ値として記録されます。2024-01-01 と日付を入力すると、コンソールは 2024-01-01T00:00:00Z として時刻を渡します。
注記
デフォルトでは、イベントフィルターはプロファイルオブジェクトが保存または更新されたときに評価されます。例えば、PurchaseDate が過去 1 週間以内の標準アセットオブジェクトをフィルタリングする場合、相対時間はアセットオブジェクトが保存または更新された時点から過去 1 週間以内として計算されます。つまり、フィルタリング結果は、オブジェクトの保存または更新のタイミングによって異なる場合があります。
イベントフィルター間の関係
必要に応じて、2 番目のイベントフィルターを追加し、1 番目のイベントフィルターとの関係を定義できます。 Amazon Connect 管理ウェブサイトで計算属性を作成する場合、計算属性ごとに最大 2 つのイベントフィルターを設定できます。2 番目のイベントフィルターを計算属性に追加する場合は、2 つのイベントフィルターの接続を指定する 2 つの方法のいずれかを選択できます。
-
AND 関係 — AND 関係を使用して 2 つのイベントフィルターを接続する場合、1 番目と 2 番目のイベントフィルターの両方を満たすオブジェクトが計算に含まれます。
-
OR 関係 — OR 関係を使用して 2 つのイベントフィルターを接続する場合、1 番目または 2 番目のイベントフィルターのいずれかを満たすオブジェクトが計算に含まれます。
-
EXCLUDE 関係 — EXCLUDE 関係を使用して 2 つのイベントフィルターを接続する場合、最初のイベントフィルターは満たすが、2 番目のイベントフィルターは満たさないオブジェクトが計算に含まれます。
次の手順
