경고 작업 – SOAP API 요청2 min read

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

• 날짜 – 작업을 계정에 설정할 때 최종 사용자가 정의할 날짜 형식 구문을 선택할 수 있는 형식 필드를 표시합니다. 날짜 형식 선택 드롭다운 목록에서, 다음 중 하나를 선택합니다.
  • 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입니다.