양식에서 API 태스크 구성

API 태스크을 호출하는 양식을 생성 및 구성하고 API 태스크 변수를 양식의 필수 필드에 매핑합니다.

전제 조건

  • Bot Creator 라이선스가 있어야 합니다.
  • 양식에서 호출하려면 먼저 API 태스크를 생성해야 합니다.
이 항목에서는 양식에서 API 태스크을 호출하는 방법에 대해 설명합니다. 이 예제에서는 제공된 우편번호 입력을 기반으로 place 및 state 세부 정보를 검색하기 위해 API 태스크를 호출하는 우편번호 양식을 생성합니다. 작성된 양식은 프로세스를 통해 실행됩니다. 유스케이스에 맞는 필드를 통해 양식을 생성할 수 있습니다.

프로시저

  1. 기존 양식으로 이동하거나 API 태스크을 호출할 새 양식을 만듭니다. 자세한 내용은 Create a form 항목을 참조하십시오.
    이 양식의 이름을 API 태스크 - 우편번호 양식으로 지정합니다.
  2. 양식 설계: 양식 요소를 사용하여 유스케이스에 맞는 대화형 양식을 구성합니다. 이 예에서는 양식이 API 태스크에서 우편번호 변수를 매핑하기 위해 설계되었습니다.
    1. 요소 열에서 텍스트 상자 요소를 끌어 양식 디자이너에 놓습니다.
      화면 오른쪽에 관련 필드와 함께 속성 탭이 나타납니다.
    2. 요소 라벨을 입력합니다. 예시: 우편번호.
    3. 버튼 요소를 드래그하여 우편번호 텍스트 상자 아래에 디자이너에 놓습니다. 버튼-텍스트(필수) 필드에 이 버튼의 이름을 제출로 입력합니다.
    4. 또한 텍스트 상자 요소를 두 개 더 드래그하고 이름을 장소 및 주로 지정합니다.
  3. 양식 규칙을 추가합니다. 양식 규칙은 양식의 각 요소에 필요한 조건을 제공합니다. 양식 규칙을 설정하기 위해if및then조건을 사용하고, 조건이 충족될 때 실행되는 작업을 지정합니다. 이 예제에서는 우편번호를 입력하고 제출 버튼을 누르면 장소 및 상태 요소 상자에 API 태스크 변수의 값이 검색되도록 양식 규칙이 구성되어 있습니다. 실행 시 양식 규칙 조건이 충족되지 않으면 API 태스크가 예상대로 작동하지 않습니다.
    1. 양식 규칙 탭을 클릭합니다.
    2. 원하는 경우 규칙 이름을 입력합니다. (예: API 태스크 호출).
    3. If 조건을 입력하여 입력한 버튼이 올바른지 확인합니다.양식에서 API 태스크 호출
    4. Then 조항을 정의하려면 양식 작업을 선택한 다음 드롭다운에서 API 호출에서 값 가져오기를 선택합니다.
    5. API 태스크에 연결된 변수를 변수 매핑 추가 옵션을 사용하여 양식에 매핑할 수 있습니다.
      주: 작업을 체크인한 후에 게시된 API 태스크을 편집하고 변수를 추가하는 경우, 변수가 양식에 표시되지 않습니다. 변수를 추가한 후에는 API 태스크에 체크인해야 합니다.
    6. 찾아보기를 클릭하여 특정 API 태스크을 선택하여 지정된 작업을 수행합니다. 이 예제에서 API 태스크(API 태스크 - 우편번호)은 우편번호의 장소와 주를 검색하기 위해 선택됩니다.