통합을 위한 사용자 지정 작업에 계약 추가

참고: 이 문서는 AWS Lambda, Genesys Cloud, Google, Microsoft Dynamics 365, Salesforce, 웹 서비스 및 Zendesk 데이터 작업 통합에 적용됩니다.

사용자 지정 작업을 만들 때 먼저 작업을 추가한 다음 계약을 추가합니다. 계약은 실행을 위해 작업에 제공하는 정보와 궁극적으로 반환하는 응답을 정의합니다. 자세한 내용은 통합을 위한 사용자 지정 작업 만들기.

메모:
  • 작업을 게시한 후에는 계약을 변경할 수 없습니다.
  • 계약은 지원하지 않습니다 $참조 예어.

  1. 클릭 설정 탭.
  2. 클릭 계약 탭.
  3. 아래에 입력 계약, 클릭 단순한 또는 JSON 계약을 구성합니다. Genesys는 단순 입력 방식을 사용할 것을 권장합니다.

    입력 계약은 실행을 위해 작업에 제공하는 정보를 정의합니다. 

    메모:
    • 입력 계약은 키-값 쌍이 있는 개체를 허용합니다. 키-값 쌍은 다음 데이터 유형으로 제한됩니다. 문자열, 정수, 숫자, 부울, null. 입력 계약은 중첩된 개체를 지원하지 않습니다.
    • 입력 계약의 속성 이름은 문자(az, AZ)로 시작해야 하며 문자, 숫자(0-9), 하이픈(-) 또는 밑줄(_)만 포함해야 합니다. 예약된 용어를 사용하지 마십시오 조직 ID, 통합 ID, 그리고 원시 요청, 또는 기존 속성을 이러한 이름으로 덮어쓰고 데이터 작업이 실패하게 됩니다.

    인터페이스를 사용하여 개체 및 개체 속성을 추가합니다. 인터페이스는 JSON 스키마를 올바르게 형식화하고 구조화합니다.

    Genesys는 건축가 워크플로에서 더 쉽게 식별할 수 있도록 제목과 설명을 추가할 것을 권장합니다. 

    직책 추가하려는 스키마 항목의 제목입니다.

    데이터 유형 선택기: 스키마 항목에 데이터 유형을 할당합니다. 스키마의 최상위 항목은 개체만 될 수 있습니다. 개체 속성은 문자열, 숫자, 정수, 부울 또는 null일 수 있습니다.

    별표 : 항목이 필요한지 여부를 나타냅니다. 스키마의 최상위 항목은 기본적으로 필수입니다.

    채팅 : 설명을 추가한 경우 아이콘 위로 마우스를 가져가면 어두워지고 설명이 표시됩니다. (확장된 구성 옵션에서 설명을 추가할 수 있습니다. 딸깍 하는 소리 연필 .)

    을 더한 : 개체 속성에 대한 새 행을 추가합니다. 다양한 속성을 추가할 수 있습니다. 인터페이스의 구성 옵션은 다른 데이터 유형(문자열, 숫자, 정수, 부울 또는 null)을 사용할 수 있다는 점을 제외하고는 최상위 개체와 유사합니다.

    연필 : 더 많은 구성 옵션이 있는 인터페이스를 엽니다. 이러한 옵션은 선택한 데이터 유형에 따라 다릅니다. 구성을 저장하려면 확인 표시를 클릭하십시오. .

    삭제 행을 삭제합니다. 체크 표시를 클릭한 후 , 체크 표시를 클릭하십시오 삭제를 확인하거나 삭제 삭제를 취소합니다.

    데이터 작업에 계약 스키마 입력

    다른 작업에서 입력 계약을 복사하거나 다음 예제를 JSON 스키마 생성을 위한 가이드로 사용할 수 있습니다.

    입력 계약

    {
      "$schema": "http://json-schema.org/draft-04/schema#",
      "type": "object",
      "required": [
        "service"
      ],
      "properties": {
        "service": {
          "type": "string"
        }
      }
    }
  4. 아래에 출력 계약, 클릭 단순한 또는 JSON 계약을 구성합니다. Genesys는 단순 입력 방식을 사용할 것을 권장합니다.

    출력 계약은 성공적인 실행 후 작업이 반환하는 정보를 정의합니다.

    참고: 출력 계약은 중첩 배열을 지원하지 않습니다.

    인터페이스를 사용하여 개체 및 개체 속성 또는 배열 및 배열 항목을 추가합니다. 인터페이스는 JSON 스키마를 올바르게 형식화하고 구조화합니다.

    Genesys는 건축가 워크플로에서 더 쉽게 식별할 수 있도록 제목과 설명을 추가할 것을 권장합니다. 

    직책 추가하려는 스키마 항목의 제목입니다.

    데이터 유형 선택기: 스키마 항목에 데이터 유형을 할당합니다. 스키마의 최상위 항목은 개체 또는 배열일 수 있습니다. 개체 속성 또는 배열 항목은 문자열, 숫자, 정수, 부울 또는 null일 수 있습니다.

    별표 : 항목이 필요한지 여부를 나타냅니다. 스키마의 최상위 항목은 기본적으로 필수입니다.

    채팅 : 설명을 추가한 경우 아이콘 위로 마우스를 가져가면 어두워지고 설명이 표시됩니다. (확장된 구성 옵션에서 설명을 추가할 수 있습니다. 딸깍 하는 소리 연필 .)

    을 더한 : 개체 속성 또는 배열 항목에 대한 새 행을 추가합니다. 다양한 개체 속성 또는 배열 항목을 추가할 수 있습니다. 인터페이스의 구성 옵션은 다른 데이터 유형(문자열, 숫자, 정수, 부울 또는 null)을 사용할 수 있다는 점을 제외하고는 객체 또는 배열과 유사합니다.

    연필 : 더 많은 구성 옵션이 있는 인터페이스를 엽니다. 이러한 옵션은 선택한 데이터 유형에 따라 다릅니다. 구성을 저장하려면 확인 표시를 클릭하십시오. .

    삭제 행을 삭제합니다. 체크 표시를 클릭한 후 , 체크 표시를 클릭하십시오 삭제를 확인하거나 삭제 삭제를 취소합니다.

    데이터 작업에서 출력 계약 스키마

    다른 작업에서 출력 계약을 복사하거나 아래 예제를 JSON 스키마 생성을 위한 가이드로 사용할 수 있습니다.

    출력 계약

    {
      "$schema": "http://json-schema.org/draft-04/schema#",
      "type": "object",
      "required": [
        "build",
        "name",
        "status"
      ],
      "properties": {
        "build": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "status": {
          "type": "string"
        }
      }
    }

    다음, 구성 추가.

    자세한 내용은 통합을 위한 사용자 지정 작업 정보.

    통합에 대한 자세한 내용은 다음을 참조하십시오. 데이터 작업 통합 정보.