通知タスク – フィルターの定義

こちらでご覧いただいた通り、通知タスクの結果をエンドユーザーが必要とする結果に制限するよう、エンドユーザー用のフィルターを定義することができます。たとえば、名前やアカウント、ビジネスなどのフィルターを定義できます。エンドユーザーごとに通知がセットアップされ、フィルターが適用されると、フィルターの条件を満たす通知メッセージのみがエンドユーザーに表示されます。

フィルターの定義

タスクのフィルターの定義を開始するには、下図のように、設定タブでフィルターセクションの展開アイコンをクリックしてから追加をクリックします。追加をクリックすると、下図のように通知タスクフィルターダイアログが表示されます。前述の図で定義されたフィルターは、所有者というラベルのついたフィルターとしてエンドユーザーに表示されます。フィールドタイプはダイナミックドロップダウンに設定され、エンドユーザーは応答のペイロードで定義された、動的に入力された所有者一覧から名前を選択することができます。下記のテーブルの説明の通りにタスクに新規のフィルターの作成フィールドを定義してください。

パラメータ名	説明
名前	タスクの設定時にフィルターセクションでエンドユーザーに表示されるフィルターの名前を指定します。例えば、「以下のユーザーがツイートしたときのみ通知する」などです。
フィールド名	タスクを絞り込むフィールド名を入力して、[フィールドを選択] をクリックすると、タスク内の [API リクエスト] タブに定義された [応答サンプル] から解析済みのフィールド名がドロップダウンリストに表示されます。
フィールドタイプ	ユーザー入力を収集するために入力フィールドタイプを選択します。テキストボックス – ユーザーにテキストボックスを表示します。[プレースホルダー] フィールドには、フィールドの説明を入力します。たとえば、「追加する名前を入力してください」のようなものです。テキストボックス – 長い文章を入力できる、テキストボックスをユーザーに表示します。[プレースホルダー] フィールドに、テキスト領域の説明を入力します。静的ドロップダウン – ユーザーに選択肢のドロップダウンリストを表示します。[オプションの追加] をクリックして、以下のパラメーターで項目リストの追加を始めます。オプション名 – ユーザーに表示されるオプションの名称です。オプション値 – オプションに関連付けられた値です。デフォルト値 – オプションが 1 つ以上定義されている場合、リストのデフォルト値を選択します。検索可能 – 選択すると、ユーザーの入力に先行してリストから一致する候補を表示します。 [保存] をクリックします。項目を追加する場合、オプションを追加をもう一度クリックします。動作コラムのオプション編集または削除します。ダイナミックドロップダウン – BotのURLからの応答に基づいて、実行時に動的に生成されるドロップダウンリストを表示します（例：JIRAタスク通知用のプロジェクト一覧）。以下のダイナミックに配置されるドロップダウンへのプロパティを定義します。エンドポイント URL – BotのエンドポイントのURLです。例：https://app.asana.com/api/1.0/workspaces エンドポイントのコンテンツタイプ―指定されたエンドポイントURLから予想されるコンテンツタイプの一つ。JSON、RSS、XML、URL にエンコードされた JSON、CSV やテキスト。エンドポイントメソッド – 次のうち 1 つを選択します。 GET– タスクフィールドのHTTPリクエストのGETメソッドを指定します。 POST– タスクフィールドの HTTP リクエストの POST メソッドを指定します。応答パス – 希望するドロップダウンリストの値を含む応答内のパスです（例：データ）。ラベルキー – ドロップダウンオプションのラベルのキーです（例：名前）。オプション値キー – ドロップダウンオプション値のキーです。例:id ペイロードフィールドの追加 – 先行入力フィールドのオプションとして、応答ペイロードから 1 つ以上のフィールドをクリックして追加します。各先行入力のフィールドオプションについて、ペイロードフィールドのキーとペイロードフィールドの値を入力し、保存をクリックします。動作列でペイロードフィールドを編集または削除します。チェックボックス – ユーザーが選択できる 1 つ以上の選択肢のリストを表示します。[オプションを追加] をクリックして、以下のパラメーターで表示する項目リストの追加を始めます。オプション名 – エンドユーザーに表示されるオプションの名前です。オプション値 – オプション名に対応する値です。先行入力 – タスクに定義されたURLからの応答に基づく検索結果に一致する文字をユーザーが 3 文字以上入力すると、動的に入力されたドロップダウンリストの選択肢が実行時にユーザーに表示されます。例えば、JIRAのタスク通知メッセージのプロジェクト一覧です。以下のダイナミックに配置されるドロップダウンへのプロパティを定義します。エンドポイント URL – BotのエンドポイントのURLです。例：https://app.asana.com/api/1.0/workspaces エンドポイントのコンテンツタイプ―指定されたエンドポイントURLから予想されるコンテンツタイプ。以下のうちの一つ：JSON、RSS、XML、URL エンコードされた JSON、CCV、テキスト、Twitter エンコードされた JSON、Multipart/Form-data または Multipart/Related。エンドポイントメソッド – 次のうち 1 つを選択します。 GET– タスクフィールドのHTTPリクエストのGETメソッドを指定します。 POST– タスクフィールドの HTTP リクエストの POST メソッドを指定します。応答パス – 希望するドロップダウンリストの値を含む応答内のパスです（例：データ）。ラベルキー – ドロップダウンオプションのラベルのキーです（例：名前）。オプション値キー – ドロップダウンオプションの値のキーです（例：ID）。ペイロードフィールドの追加 – 先行入力フィールドのオプションとして、応答ペイロードから 1 つ以上のフィールドをクリックして追加します。各先行入力のフィールドオプションについて、ペイロードフィールドのキーとペイロードフィールドの値を入力し、保存をクリックします。動作列でペイロードフィールドを編集または削除します。編集可能―先行入力の検索結果が一致しない場合のオプションとして、エンドユーザーがフィールドに自由にテキストを入力できるようにします。動的チェックボックス – ボットの URL からの応答に基づいて、実行時に動的に生成され、1 つ以上の選択ができる選択肢のリストです。たとえば、JIRA のタスク通知のプロジェクトリストのようなものです。以下のダイナミックに配置されるチェックボックスの選択のリストへのプロパティを定義します。エンドポイント URL – BotのエンドポイントのURLです。例：https://app.asana.com/api/1.0/workspaces エンドポイントのコンテンツタイプ―指定されたエンドポイントURLから予想されるコンテンツタイプ。以下のうちの一つ：JSON、RSS、XML、URL にエンコードされた JSON、CSV やテキスト。エンドポイントメソッド – 次のうち 1 つを選択します。 GET– タスクフィールドのHTTPリクエストのGETメソッドを指定します。 POST– タスクフィールドの HTTP リクエストの POST メソッドを指定します。応答パス – 希望するドロップダウンリストの値を含む応答内のパスです（例：データ）。ラベルキー – ドロップダウンオプションのラベルのキーです（例：名前）。ボックス値キー – ドロップダウンオプション値のキーです。例:id
データタイプ	エンドポイントURLから受信したコンテンツのデータタイプです。以下のうちの一つ：テキスト – このフィルタのユーザー入力にはテキストが求められます。数字 – このフィルターのユーザー入力には整数が求められます。日付 – このフィルターのユーザー入力は日付です。リスト – このフィルターのユーザー入力はコンマ区切りのリストです。
オペレーター	エンドユーザーがフィルターに適用できる、 1 つ以上のフィルター操作を選択します。選択したデータ型によって、次のオプションのうち 1 つ以上をエンドユーザーに表示するよう選択することができます。すべてを含む – 応答オブジェクトでフィルターをかけた文字は、指定された値をすべて含みます。すべてを含まない – 応答オブジェクトでフィルターをかけた文字は、指定された値のすべてを含みません。完全一致 – 応答オブジェクトでフィルターをかけた文字は、指定された値のみを含みます。完全一致ではない – 応答でフィルターをかけた文字オブジェクトは、指定された値を含みません。含む – 応答オブジェクトでフィルターをかけた文字は、指定された値を含みます。含まない – 応答オブジェクトでフィルターをかけた文字は、指定された値をどれも含みません。から始まる – 応答オブジェクトでフィルターをかけた文字は、指定された値で始まります。から始まらない – 応答オブジェクトでフィルターをかけた文字は、指定された値で始まりません。で終わる – 応答オブジェクトでフィルターをかけた文字は、指定された値で終わります。で終わらない応答オブジェクトでフィルターをかけた文字は、指定された値で終わりません。等しい – 応答オブジェクトでフィルターをかけた数字や日付は、指定された値と等しくなっています。より大きい – 応答オブジェクトでフィルターをかけた数字や日付は、指定された値を超えています。より小さい – 応答オブジェクトでフィルターをかけた数字や日付は、指定された値未満です。存在する – 応答オブジェクトでフィルターをかけたリストは、指定された値を含みます。存在しない – 応答オブジェクトでフィルターをかけたリストは、指定された値を含みません。

複数のフィルターには、フィルターをエンドユーザーの予想の順番と並び直すことができます、下記の図の数目順の通りに表示します。必要に応じて、フィルターセクションの動作列にある上へ移動アイコンと下へ移動アイコンを使用して、フィルターの順序を変更します。編集アイコンをクリックして既存のフィルターの設定を変更します。削除アイコンをクリックして既存のフィルターを削除します。警告：この操作は永久的で、元に戻すことはできません。

このページの内容

通知タスク – フィルターの定義

フィルターの定義

パラメータ名	説明
名前	タスクの設定時にフィルターセクションでエンドユーザーに表示されるフィルターの名前を指定します。例えば、「以下のユーザーがツイートしたときのみ通知する」などです。
フィールド名	タスクを絞り込むフィールド名を入力して、[フィールドを選択] をクリックすると、タスク内の [API リクエスト] タブに定義された [応答サンプル] から解析済みのフィールド名がドロップダウンリストに表示されます。
フィールドタイプ	ユーザー入力を収集するために入力フィールドタイプを選択します。テキストボックス – ユーザーにテキストボックスを表示します。[プレースホルダー] フィールドには、フィールドの説明を入力します。たとえば、「追加する名前を入力してください」のようなものです。テキストボックス – 長い文章を入力できる、テキストボックスをユーザーに表示します。[プレースホルダー] フィールドに、テキスト領域の説明を入力します。静的ドロップダウン – ユーザーに選択肢のドロップダウンリストを表示します。[オプションの追加] をクリックして、以下のパラメーターで項目リストの追加を始めます。オプション名 – ユーザーに表示されるオプションの名称です。オプション値 – オプションに関連付けられた値です。デフォルト値 – オプションが 1 つ以上定義されている場合、リストのデフォルト値を選択します。検索可能 – 選択すると、ユーザーの入力に先行してリストから一致する候補を表示します。 [保存] をクリックします。項目を追加する場合、オプションを追加をもう一度クリックします。動作コラムのオプション編集または削除します。ダイナミックドロップダウン – BotのURLからの応答に基づいて、実行時に動的に生成されるドロップダウンリストを表示します（例：JIRAタスク通知用のプロジェクト一覧）。以下のダイナミックに配置されるドロップダウンへのプロパティを定義します。エンドポイント URL – BotのエンドポイントのURLです。例：https://app.asana.com/api/1.0/workspaces エンドポイントのコンテンツタイプ―指定されたエンドポイントURLから予想されるコンテンツタイプの一つ。JSON、RSS、XML、URL にエンコードされた JSON、CSV やテキスト。エンドポイントメソッド – 次のうち 1 つを選択します。 GET– タスクフィールドのHTTPリクエストのGETメソッドを指定します。 POST– タスクフィールドの HTTP リクエストの POST メソッドを指定します。応答パス – 希望するドロップダウンリストの値を含む応答内のパスです（例：データ）。ラベルキー – ドロップダウンオプションのラベルのキーです（例：名前）。オプション値キー – ドロップダウンオプション値のキーです。例:id ペイロードフィールドの追加 – 先行入力フィールドのオプションとして、応答ペイロードから 1 つ以上のフィールドをクリックして追加します。各先行入力のフィールドオプションについて、ペイロードフィールドのキーとペイロードフィールドの値を入力し、保存をクリックします。動作列でペイロードフィールドを編集または削除します。チェックボックス – ユーザーが選択できる 1 つ以上の選択肢のリストを表示します。[オプションを追加] をクリックして、以下のパラメーターで表示する項目リストの追加を始めます。オプション名 – エンドユーザーに表示されるオプションの名前です。オプション値 – オプション名に対応する値です。先行入力 – タスクに定義されたURLからの応答に基づく検索結果に一致する文字をユーザーが 3 文字以上入力すると、動的に入力されたドロップダウンリストの選択肢が実行時にユーザーに表示されます。例えば、JIRAのタスク通知メッセージのプロジェクト一覧です。以下のダイナミックに配置されるドロップダウンへのプロパティを定義します。エンドポイント URL – BotのエンドポイントのURLです。例：https://app.asana.com/api/1.0/workspaces エンドポイントのコンテンツタイプ―指定されたエンドポイントURLから予想されるコンテンツタイプ。以下のうちの一つ：JSON、RSS、XML、URL エンコードされた JSON、CCV、テキスト、Twitter エンコードされた JSON、Multipart/Form-data または Multipart/Related。エンドポイントメソッド – 次のうち 1 つを選択します。 GET– タスクフィールドのHTTPリクエストのGETメソッドを指定します。 POST– タスクフィールドの HTTP リクエストの POST メソッドを指定します。応答パス – 希望するドロップダウンリストの値を含む応答内のパスです（例：データ）。ラベルキー – ドロップダウンオプションのラベルのキーです（例：名前）。オプション値キー – ドロップダウンオプションの値のキーです（例：ID）。ペイロードフィールドの追加 – 先行入力フィールドのオプションとして、応答ペイロードから 1 つ以上のフィールドをクリックして追加します。各先行入力のフィールドオプションについて、ペイロードフィールドのキーとペイロードフィールドの値を入力し、保存をクリックします。動作列でペイロードフィールドを編集または削除します。編集可能―先行入力の検索結果が一致しない場合のオプションとして、エンドユーザーがフィールドに自由にテキストを入力できるようにします。動的チェックボックス – ボットの URL からの応答に基づいて、実行時に動的に生成され、1 つ以上の選択ができる選択肢のリストです。たとえば、JIRA のタスク通知のプロジェクトリストのようなものです。以下のダイナミックに配置されるチェックボックスの選択のリストへのプロパティを定義します。エンドポイント URL – BotのエンドポイントのURLです。例：https://app.asana.com/api/1.0/workspaces エンドポイントのコンテンツタイプ―指定されたエンドポイントURLから予想されるコンテンツタイプ。以下のうちの一つ：JSON、RSS、XML、URL にエンコードされた JSON、CSV やテキスト。エンドポイントメソッド – 次のうち 1 つを選択します。 GET– タスクフィールドのHTTPリクエストのGETメソッドを指定します。 POST– タスクフィールドの HTTP リクエストの POST メソッドを指定します。応答パス – 希望するドロップダウンリストの値を含む応答内のパスです（例：データ）。ラベルキー – ドロップダウンオプションのラベルのキーです（例：名前）。ボックス値キー – ドロップダウンオプション値のキーです。例:id
データタイプ	エンドポイントURLから受信したコンテンツのデータタイプです。以下のうちの一つ：テキスト – このフィルタのユーザー入力にはテキストが求められます。数字 – このフィルターのユーザー入力には整数が求められます。日付 – このフィルターのユーザー入力は日付です。リスト – このフィルターのユーザー入力はコンマ区切りのリストです。
オペレーター	エンドユーザーがフィルターに適用できる、 1 つ以上のフィルター操作を選択します。選択したデータ型によって、次のオプションのうち 1 つ以上をエンドユーザーに表示するよう選択することができます。すべてを含む – 応答オブジェクトでフィルターをかけた文字は、指定された値をすべて含みます。すべてを含まない – 応答オブジェクトでフィルターをかけた文字は、指定された値のすべてを含みません。完全一致 – 応答オブジェクトでフィルターをかけた文字は、指定された値のみを含みます。完全一致ではない – 応答でフィルターをかけた文字オブジェクトは、指定された値を含みません。含む – 応答オブジェクトでフィルターをかけた文字は、指定された値を含みます。含まない – 応答オブジェクトでフィルターをかけた文字は、指定された値をどれも含みません。から始まる – 応答オブジェクトでフィルターをかけた文字は、指定された値で始まります。から始まらない – 応答オブジェクトでフィルターをかけた文字は、指定された値で始まりません。で終わる – 応答オブジェクトでフィルターをかけた文字は、指定された値で終わります。で終わらない応答オブジェクトでフィルターをかけた文字は、指定された値で終わりません。等しい – 応答オブジェクトでフィルターをかけた数字や日付は、指定された値と等しくなっています。より大きい – 応答オブジェクトでフィルターをかけた数字や日付は、指定された値を超えています。より小さい – 応答オブジェクトでフィルターをかけた数字や日付は、指定された値未満です。存在する – 応答オブジェクトでフィルターをかけたリストは、指定された値を含みます。存在しない – 応答オブジェクトでフィルターをかけたリストは、指定された値を含みません。