키 값에 할당할 요청 개체의 사용자 입력 수집을 위해 최종 사용자 인터페이스에 표시되는 작업 입력 필드의 유형을 지정합니다. 기본 설정은 텍스트 상자이지만 다음 중 하나에 맞게 사용자 정의할 수 있습니다.

• 날짜 – 작업을 계정에 설정할 때 최종 사용자가 정의할 날짜 형식 구문을 선택할 수 있는 형식 필드를 표시합니다. 날짜 형식 선택 드롭다운 목록에서, 다음 중 하나를 선택합니다.
  • 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 입력.
• 텍스트 상자 – 최종 사용자가 작업 입력 필드로 텍스트를 입력하기 위한 텍스트 상자를 표시합니다. 일반적으로 몇 단어입니다. 플레이스 홀더 필드에서, 텍스트 필드에 표시되는 도움말 힌트를 입력합니다. 예: 꾸미려는 이름을 입력합니다.
• 정적 드롭다운 – 최종 사용자에 대한 드롭다운 선택 목록을 표시합니다. 옵션 추가를 클릭하여 다음 매개변수를 사용하여 최종 사용자에게 표시할 항목 목록을 추가합니다.
  • 옵션 이름 – 최종 사용자에게 표시되는 옵션의 이름입니다.
  • 옵션값 – 애플리케이션에 반환된 옵션 이름을 나타내는 값입니다.
  • 기본값 – 하나 이상의 옵션이 정의된 경우 옵션의 기본값을 선택합니다.
  • 검색 가능 – 최종 사용자가 이 필드에 텍스트를 입력할 때 동적 검색 및 표시를 사용함으로 설정하거나 일치 항목이 없는 경우 자유 양식 입력을 허용하려면 선택합니다.

  저장을 클릭합니다. 추가 항목을 추가하려면, 옵션 추가를 다시 클릭합니다. 옵션의 조치 열에서 옵션을 편집하거나 삭제합니다.

• 동적 드롭다운 – 봇의 URL 응답에 따라 실행 시 동적으로 채워진 드롭다운 목록을 표시합니다. 예: JIRA 작업 알림용 프로젝트 목록. 동적으로 채워진 드롭다운에 대해 다음 속성을 정의합니다.
  • 엔드포인트 URL – 봇 엔드포인트 URL입니다. 예: https://app.asana.com/api/1.0/workspaces.
  • 엔드포인트 콘텐츠 유형 – 지정된 엔드포인트 URL에서 예상되는 콘텐츠 유형입니다. 다음 중 하나입니다. JSON, RSS, XML, URL Encoded JSON, CCV, Text 또는 Twitter 인코딩된 JSON.
  • 엔드포인트 메소드 – 다음 중 하나입니다.
    • GET – 작업 필드의 HTTP 요청 GET 메소드를 지정합니다.
    • POST – 작업 필드의 HTTP 요청 POST 메소드를 지정합니다.
  • 응답 경로 – 원하는 드롭다운 목록 값이 포함된 응답의 경로입니다. 예: data.
  • 라벨 키 – 드롭다운 옵션의 라벨 키입니다. 예: name.
  • 옵션값 키 – 드롭다운 옵션 값의 키입니다. 예: id.
  • 페이로드 필드 추가 – 동적 드롭다운에 대한 옵션으로 응답 페이로드에서 하나 이상의 필드를 추가하려면 클릭합니다. 각 페이로드 필드에서, 페이로드 필드 키 및 페이로드 필드 값을 입력한 다음 저장을 클릭합니다. 조치 열에서 페이로드 필드를 편집하거나 삭제합니다.
  • 검색 가능 – 최종 사용자가 이 필드에 텍스트를 입력할 때 동적 검색 및 표시를 사용함으로 설정하거나 일치 항목이 없는 경우 자유 양식 입력을 허용하려면 선택합니다.

• 텍스트 영역 – 최종 사용자가 작업 입력으로 텍스트를 입력하기 위한 텍스트 영역을 표시합니다. 일반적으로 몇 문장입니다. 플레이스 홀더 필드에서, 텍스트 영역 내부에 표시되는 도움말 힌트를 입력합니다.
• 타입 어헤드 – 작업에 정의된 URL 응답에 따라 사용자가 검색 결과와 일치하는 3개 이상의 문자를 입력할 때 실행 시 동적으로 채워진 드롭다운 선택 목록을 최종 사용자에게 표시합니다. 예: JIRA 작업 알림 메시지의 프로젝트 목록. 동적으로 채워진 드롭다운에 대해 다음 속성을 정의합니다.
  • 엔드포인트 URL – 봇 엔드포인트 URL입니다. 예: https://app.asana.com/api/1.0/workspaces.
  • 엔드포인트 콘텐츠 유형 – 지정된 엔드포인트 URL에서 예상되는 콘텐츠 유형입니다. 다음 중 하나입니다. JSON, RSS, XML, URL Encoded JSON, CCV, Text, Twitter Encoded JSON, Multipart/Form-data 또는 Multipart/Related.
  • 엔드포인트 메소드 – 다음 중 하나입니다.
    • GET – 작업 필드의 HTTP 요청 GET 메소드를 지정합니다.
    • POST – 작업 필드의 HTTP 요청 POST 메소드를 지정합니다.
  • 응답 경로 – 원하는 드롭다운 목록 값이 포함된 응답의 경로입니다. 예: data.
  • 라벨 키 – 드롭다운 옵션의 라벨 키입니다. 예: name.
  • 옵션값 키 – 드롭다운 옵션 값의 키입니다. 예: id.
  • 페이로드 필드 추가 – 타입 어헤드 필드에 대한 옵션으로 응답 페이로드에서 하나 이상의 필드를 추가하려면 클릭합니다. 각 타입 어헤드 필드 옵션에서, 페이로드 필드 키 및 페이로드 필드 값을 입력한 다음 저장을 클릭합니다. 조치 열에서 페이로드 필드를 편집하거나 삭제합니다.
  • 편집 가능 – 타입 어헤드 검색 결과가 일치하지 않을 때 사용자가 필드에서 텍스트를 자유롭게 입력할 수 있습니다.
• 이메일 – 최종 사용자가 이메일 주소를 입력할 수 있는 텍스트 상자를 표시합니다. 플레이스 홀더 필드에서, 텍스트 상자 내부에 최종 사용자에게 표시되는 유용한 힌트를 입력합니다.
• 날짜 및 시간 – 최종 사용자가 시간과 함께 날짜를 입력할 수 있는 텍스트 상자를 표시합니다. 형식 필드에서, 날짜 텍스트 상자에 최종 사용자에게 표시할 예상되는 날짜 또는 시간 형식을 입력합니다. 날짜 형식 선택 드롭다운 목록에서, 시간 형식의 날짜를 선택합니다.
• 시간대 – 운영 체제 설정에 따른 시간대 드롭다운 목록을 표시합니다.
• 위치 – 최종 사용자가 지리적 위치를 입력할 수 있는 텍스트 상자를 표시합니다. 예: Orlando, FL 또는 32801.
• 중첩된 양식 – 상위 입력 필드 아래에 중첩된 형식으로 최종 사용자 입력 필드를 표시합니다. 중첩된 양식 입력 필드에 대해 다음 필드를 지정합니다.
  • 배열 요소 유형 – 상위 입력 양식 요소의 데이터 유형을 선택합니다.
  • 중첩 양식 필드 추가 – 하나 이상의 중첩된 양식 필드를 추가하려면 클릭합니다.
• 파일 업로드 – 검색할 최종 사용자 컨트롤을 표시하고 업로드할 파일을 선택합니다. 클릭되면, 파일 업로드 페이로드 키를 입력합니다. 파일 업로드 페이로드 키가 정의된 경우, 파일 업로드 페이로드 필드 값 드롭다운 목록에서 다음 유형 중 하나를 선택합니다.
  • 파일 이름
  • 파일 크기
  • 파일 콘텐츠 유형

다음 사용자 입력 유형 중 하나를 선택합니다.

• 문자열 – 사용자는 연속된 숫자, 문자 또는 특수 문자를 입력할 수 있습니다.
• 숫자 – 사용자는 숫자를 입력할 수 있습니다. 특수 문자는 허용되지 않습니다.
• 불리언 – 사용자는 true 또는 false의 부울 값을 입력할 수 있습니다.
• 이메일 – 사용자는 유효한 이메일 주소를 입력할 수 있습니다.
• 개체 – 봇의 데이터는 JSON 개체로 수신할 수 있습니다. 예: 다음과 같이 정의된 위치 세부정보  “location” : { “lat” : 17.4374614, “lng” : 78.4482878 } 요청 체인 또는 작업 요청에서 속성을 location.lat 및 location.lng로 참조할 수 있습니다.
• Array – 사용자는 쉼표로 구분된 값 목록을 봇에 전달할 수 있습니다. 예: 구글 캘린더에서 데이터가 있는 여러 참석자는 다음과 같이 전달할 수 있습니다. “attendees”: [“user1”, “user2”, “user3”] 선택되면 사용자 입력 배열의 유형을 다음 중 하나로 지정합니다.
  • 문자열
  • 숫자
  • 불리언
  • 이메일
  • 배열
  • 날짜
• 날짜 – 사용자는 전체 날짜를 입력하거나 날짜 선택기에서 날짜를 선택할 수 있습니다.

작업 입력 필드를 최종 사용자에게 표시할지 숨길지 여부를 지정합니다. 가시성 필드는 사용자 정의 필드로 설정할 수도 있으며 데이터는 사용자로부터 캡처되지만 쿼리 매개변수 또는 페이로드 필드로 사용되지 않습니다. 예: JIRA 봇을 사용하는 경우 아래와 같이 @mention 태그를 사용하여 티켓에 의견을 게시합니다. “@Mike, 이 문제를 살펴보세요” 의견 게시를 위한 JIRA API는 다음과 같이 하나의 쿼리 필드와 하나의 페이로드 필드가 필요합니다.

• 발급 ID
• 의견

가시성 필드를 사용자 정의로 설정하면 페이로드 필드 또는 쿼리 필드로 사용하지 않고 comment 필드 값에 추가할 데이터를 가져오기 위해 JIRA API를 사용하여 @Mike로 언급된 사용자의 사용자 정보를 캡처할 수 있습니다. 기본 가시성 필드 설정은 Visible입니다.

• 日付 – [フォーマット] フィールドを表示します。ここでは、エンドユーザーが自分のアカウントにタスクが設定されている場合に定義する日付フォーマットの構文を選択できます。[日付フォーマット選択] のドロップダウン リストから、次のうちの 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フィールドの値に追加することができますが、ペイロードフィールドやクエリフィールドとしては使用できません。可視性フィールドのデフォルト設定は表示です。

• Date – Displays the Format field where you can select the date format syntax for the end-user to define when the task is configured for their account. In the Select Date Format drop-down list, select one of the following:
  • dd-MM-YYYY – For example, 16-05-1999
  • MM-dd-YYYY – For example, 05-16-1999
  • dd-MM-YY – For example, 16-05-99
  • YYYY-MM-dd – For example, 1999-05-16
• URL – Displays a text box for the end-user to enter a URL including field validation for a correct URL syntax. In the Placeholder field, enter the help hint displayed in the text box, for example, Enter the URL for the website here.
• Textbox – Displays a text box for the end-user to enter text as the task input field, typically just a few words. In the Placeholder field, enter the help hint displayed in the text field, for example, Type in the name you want to embroider.
• Static Dropdown – Displays a drop-down list of choices to the end-user. Click Add Option to begin adding the list of items to display to the end-user with the following parameters:
  • Option Name – The name of the option displayed to the end-user.
  • Option Value – The value the represents the Option Name returned to the application.
  • Default Value – Select the default value for the option when more than one option is defined.
  • Searchable – Select to enable dynamic search and display as the end-user enters text in this field, or if no matches, allow free-form entry.

  Click Save. To add additional items, click Add Option again. Edit or remove options in the Actions column for options.

• Dynamic Dropdown – Displays a drop-down list dynamically populated at runtime based on the response from a URL for your Bot, for example, a list of projects for a JIRA task notification. Define the following properties for a dynamically populated dropdown.
  • Endpoint URL – The Bot endpoint URL, for example, https://app.asana.com/api/1.0/workspaces.
  • Endpoint Content Type – The content type expected from the specified endpoint URL. One of: JSON, RSS, XML, URL Encoded JSON, CCV, Text, or Twitter Encoded JSON.
  • Endpoint Method – One of:
    • GET – Specifies an HTTP Request GET method for the task field.
    • POST – Specifies an HTTP Request POST method for the task field.
  • Response Path – The path in the response that contains the desired drop-down list values, for example, data.
  • Label Key – The key for the label of the drop-down option, for example, name.
  • Option Value Key – The key for the value of the drop-down option, for example, id.
  • Add Payload Field – Click to add one or more fields from the response payload as options for the dynamic dropdown. For each payload field, enter the Payload field key and the Payload field value, and then click Save. Edit or delete payload fields in the Actions column.
  • Searchable – Select to enable dynamic search and display as the end-user enters text in this field, or if no matches, allow free-form entry.

• Textarea – Displays a text area box for the end-user to enter text as the task input, typically for several sentences. In the Placeholder field, enter the help hint displayed inside the text area.
• Type Ahead – Displays a dynamically populated drop-down list of choices to the end-user at runtime when the user enters three or more characters that match the search results based on the response from the URL defined for the task. For example, a list of projects for a JIRA task notification message. Define the following properties for a dynamically populated drop-down.
  • Endpoint URL – The Bot endpoint URL, for example, https://app.asana.com/api/1.0/workspaces.
  • Endpoint Content Type – The content type expected from the specified endpoint URL. One of: JSON, RSS, XML, URL Encoded JSON, CCV, Text, Twitter Encoded JSON, Multipart/Form-data, or Multipart/Related.
  • Endpoint Method – One of:
    • GET – Specifies an HTTP Request GET method for the task field.
    • POST – Specifies an HTTP Request POST method for the task field.
  • Response Path – The path in the response that contains the desired drop-down list values, for example, data.
  • Label Key – The key for the label of the drop-down option, for example, name.
  • Option Value Key – The key for the value of the drop-down option, for example, id.
  • Add Payload Field – Click to add one or more fields from the response payload as options for the type ahead field. For each type ahead field option, enter the Payload field key and the Payload field value, and then click Save. Edit or delete payload fields in the Actions column.
  • Editable – Enables the end-user to enter text free-from in the field as an option when type-ahead search results do not match.
• Email – Displays a text box for the end-user to input an email address. In the Placeholder field, enter the helpful hint to display to the end-user inside the text box.
• Date & Time – Displays a text box for the end-user to input a date with time. In the Format field, enter the expected date or time format to display to the end-user in the date text box. In the Select Date Format drop-down list, select the date with time format.
• Time Zone – Displays a drop-down list of time zones based on the operating system settings.
• Location – Displays a text box for the end-user to enter a geographical location, for example, Orlando, FL, or 32801.
• Nested Form – Displays end-user input fields in a nested format below the parent input field. Specify the following fields for a nested form input field:
  • Array Element Type – Select the data type of the parent input form element.
  • Add Nested Form Field – Click to add one or more nested form fields.
• File Upload – Displays end-user control to search for, and select a file to upload. When clicked, enter the File Upload Payload Key. When the File Upload Payload Key is defined, in the File Upload Payload Field Value drop-down list, select one of the following types:
  • File Name
  • File Size
  • File Content Type

• String – Users can input any sequence of numbers, letters, or special characters.
• Number – Users can input a number. No special characters are allowed.
• Boolean – User can input a Boolean value of true or false.
• Email – User can input a valid email address.
• Object – Data from a Bot can be received as JSON objects, for example, as location details defined as:
   “location” : {
                 “lat” : 17.4374614,
                 “lng” : 78.4482878
              }
  where you can refer to the properties in a request chain or task request as location.lat, and location.lng.
• Array – Users can pass a comma-separated list of values to the Bot. For example, in Google Calendar, multiple attendees with data can be passed as:
  “attendees”: [“user1”, “user2”, “user3”]
  When selected, specify the Type for the array of end-user input as one of:
  • String
  • Number
  • Boolean
  • Email
  • Array
  • Date
• Date – Users can type a complete date or select it from a date picker.

• Issue ID
• Comment

With the Visibility field set to Custom, you can capture the user information for the user mentioned as @Mike using the JIRA API to fetch data to append to the comment field value, but not to use as payload field or query field.
The default Visibility field setting is Visible.