通知タスク – SOAP API Request2 min read

• 日付 – [フォーマット] フィールドを表示します。ここでは、エンドユーザーが自分のアカウントにタスクが設定されている場合に定義する日付フォーマットの構文を選択できます。[日付フォーマット選択] のドロップダウン リストから、次のうちの 1 つを選択します。
  • dd-MM-YYYY – 例:16-05-1999
  • MM-dd-YYYY – 例:05-16-1999
  • dd-MM-YY – 例:16-05-99
  • YYYY-MM-dd – 例:1999-05-16
• URL – 正しい URL 構文のためのフィールド検証を含む、エンドユーザーによる URL 入力用のテキスト ボックスを表示します。[プレースホルダー] フィールドには、テキストボックスに表示されるヘルプヒントを入力します。たとえば、「こちらにウェブサイトのURLを入力してください」のようなものです。
• テキストボックス―エンドユーザーにタスクの入力フィールドとして文字入力のためのテキストボックスを表示します（通常は数語程度）。[プレースホルダー] フィールドには、テキストフィールドに表示されるヘルプヒントを入力します。たとえば、「追加する名前を入力してください」のようなものです。
• 静的ドロップダウン – エンドユーザーに選択肢のドロップダウン リストを表示します。オプションの追加をクリックして以下のパラメータでエンドユーザーに表示する項目リストの追加を始まります：
  • オプション名 – エンドユーザーに表示されるオプションの名前です。
  • オプション値―アプリケーションに返すオプション名という値と示します。
  • デフォルト値 – 1 点以上のオプションが定義されている場合、オプションのデフォルト値を選択します。
  • 検索可能―選択するとダイナミック検索、そしてこのフィールドにエンドユーザーが入力する文字の表示を可能にします、もし一致がない場合、フリーフォームのエントリが可能です。

  [保存] をクリックします。項目を追加する場合、オプションを追加をもう一度クリックします。動作コラムのオプション編集または削除します。

• ダイナミックドロップダウン―BotのURLからの応答に基づいて、実行時に動的に生成されるドロップダウンリストを表示します（例：JIRA タスク通知用のプロジェクト一覧）。以下のダイナミックに配置されるドロップダウンへのプロパティを定義します。
  • エンドポイント URL – BotのエンドポイントのURLです。例：https://app.asana.com/api/1.0/workspaces
  • エンドポイントのコンテンツタイプ―指定されたエンドポイントURLから予想されるコンテンツタイプ。以下のうちの一つ：JSON、RSS、XML、URL エンコードされた JSON、CCV、文字、や Twitter エンコードされた JSON。
  • エンドポイント メソッド – 次のうちの 1 つになります。
    • GET– タスクフィールドのHTTPリクエストのGETメソッドを指定します。
    • POST– タスク フィールドの HTTP リクエストの POST メソッドを指定します。
  • 応答パース―希望するドロップダウンリストの値を含む応答内のパスです（例：データ）。
  • ラベルキー – ドロップダウンオプションのラベルのキーです（例：名前）。
  • オプション値キー – ドロップダウンオプションの値のキーです（例：ID）。
  • idペイロード フィールドの追加 – 先行入力フィールドのオプションとして、 応答ペイロードから 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 つ以上のフィールドをクリックして追加します。各先行入力のフィールドオプションについて、ペイロードフィールドのキーとペイロードフィールドの値を入力し、保存をクリックします。動作列でペイロードフィールドを編集または削除します。
  • 編集可能―先行入力の検索結果が一致しない場合のオプションとして、エンドユーザーがフィールドに自由にテキストを入力できるようにします。
• メール―エンドユーザーのメールアドレスを入力するためのテキストボックスを表示します。プレースホルダフィールドには、エンドユーザーに表示するのに役立つヒントをテキストボックス内に入力します。
• 日付と時間―エンドユーザーの日付と時間を入力するためのテキストボックスを表示します。フォーマットフィールドに、エンドユーザーに表示される日付の文字枠に、予想の日付や時間のフォーマットを入力してください。日付フォーマットの選択ドロップダウンリストで、 時間付きの日付のフォーマットを選択してください。
• タイムゾーン―操作システムの設定に基づくタイムゾーンのドロップダウンリストを表示します。
• 位置―エンドユーザーが地理的位置を入力するための文字枠を表示します。例えば、Orlando, FLまたは32801。
• 入れ子フォーム – 親入力フィールドの下に、エンドユーザーの入力フィールドを入れ子形式で表示します。入力フィールドのネスト化済のフォームに以下のフィールドを指定してください：
  • 配列要素型 – 親の入力形式要素のデータ型を選択します。
  • 入れ子フォーム フィールドの追加 – 1 つ以上の入れ子のフォーム フィールドをクリックして追加します。
• ファイル アップロード – アップロードするファイルの検索や選択ができるエンドユーザー コントロールを表示します。クリックして、[ファイル アップロード ペイロード キー] を入力します。ファイルアップロードペイロードキーが定義済の場合、ファイルアップロードペイロードフィールド値のドロップダウンリストで以下のうちの一つを選択してください：
  • ファイル名
  • ファイルサイズ
  • ファイルコンテンツタイプ

• 文字列 – ユーザーは任意の一連の数字、文字や特殊文字を入力することができます。
• 数字 – ユーザーは数字を入力することができます。特殊文字は使用できません。
• ブール値 – ユーザーは true または false のブール値を入力できます。
• メール – ユーザーは有効なメール アドレスを入力できます。
• オブジェクト – データは、JSON オブジェクトとしてボットから受信できます。 “location” : { “lat” : 17.4374614, “lng” : 78.4482878 }ここでは、リクエストチェインやタスクリクエストのプロパティをlocation.lat、location.lngとして参照することができます。
• 配列 – ユーザーは、カンマで区切った値のリストをボットに渡すことができます。例えば、グーグルカレンダーでは、複数の参加者のデータのパスは: “attendees”: [“user1”, “user2”, “user3”] 選択した場合、エンドユーザーの入力の配列のタイプを以下のいずれかに指定します。
  • 文字列
  • 数字
  • ブール値
  • メール
  • 配列
  • 日付
• 日付―ユーザーは完全な日付を入力するか、日付の選択肢から選択することができます。

• IDの発行
• コメント

可視性フィールドをカスタムに設定すると、JIRA APIを使用して@Mikeと呼ばれるユーザーのユーザー情報をキャプチャし、データを取得してcommentフィールドの値に追加することができますが、ペイロードフィールドやクエリフィールドとしては使用できません。可視性フィールドのデフォルト設定は表示です。