양식에서 API 태스크 호출

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

전제 조건

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

프로시저

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