트랜잭션 관리자의 Salesforce와 같은 외부 데이터 소스에서 정보를 수집하기 위해 관리자는 통합을 생성합니다. Transaction Manager 통합은 데이터 소스에 연결하고, 정보를 추출하고, 데이터를 Transaction Manager에 매핑하는 데 필요한 정보를 정의합니다. 통합을 사용하여 Transaction Manager에서 정보를 추출하고 외부 공급업체 환경에서 매핑되도록 전송할 수도 있습니다.

Transaction Manager에 대한 통합을 정의하기 전에 관리자는 먼저 구성 환경의 외부 연결과 마찬가지로 타사 환경에 대한 연결을 만들어야 합니다. 연결은 관리자 UI의 유틸리티 섹션에서 정의됩니다.

연결 생성 중

통합을 정의하기 전에 관리자는 통합에서 사용하는 데이터의 타사 소스에 대한 연결을 정의해야 합니다.

새 연결을 만들려면 관리자 UI의 유틸리티 영역에서 연결을 클릭합니다. 그런 다음 + 새로 만들기 를 클릭하여 새 연결 페이지를 표시합니다.

새 연결 페이지에서 새 연결의 이름을 지정하고 변수 이름을 할당합니다. 다음으로 통합 유형(Salesforce 또는 외부)을 선택합니다.

Salesforce에 대한 연결을 생성하는 경우에는 다른 필드가 필요하지 않습니다. CPQ 는 인증 방법을 알고 있으며 Salesforce와 통신할 때 사용해야 하는 엔드포인트를 알고 있습니다.

외부 통합을 만드는 경우 인증 유형을 선택합니다. 지원되는 인증 방법은 없음, 전달자 토큰 및 OAuth입니다. 전달자 토큰을 선택하는 경우 인증 토큰 필드를 사용하여 통신 중인 사이트에 대한 전달자 토큰을 제공합니다. OAuth를 선택하는 경우 클라이언트 ID, 클라이언트 암호 및 토큰 URL 필드를 사용하여 필요한 OAuth 정보를 제공합니다.

호스트 필드에 통신할 외부 공급업체 사이트의 URL을 입력합니다.

경로 필드에 타사 사이트에서 액세스하려는 엔드포인트의 경로를 입력합니다.

추가 헤더 필드를 사용하여 원하는 엔드포인트를 실행하기 위해 외부 공급업체 사이트에 필요한 헤더 정보를 추가합니다.

통합 생성

새 통합을 만들려면 + 통합 추가를 클릭하십시오. 새 통합 창이 나타납니다. 새 통합에 이름과 변수 이름을 지정하고 저장을 클릭합니다.

통합 편집기 페이지가 열립니다. 다음 설정을 구성하여 새 통합을 계속 정의합니다.

• HTTP 메서드: 타사 사이트에서 사용 중인 엔드포인트에 따라 GET, POST, PATCH, PUT 또는 DELETE 작업을 수행할 수 있습니다.
• 포함할 라인 항목 세부 정보: 통합에서 작업할 라인 항목 유형을 정의합니다. 옵션은 선택한 라인, 수정된 라인 및 삭제된 라인입니다.
• 추가 경로: 외부 공급업체 사이트에서 실행할 쿼리 명령을 입력합니다. Salesforce에 연결하는 경우 이는 아마도 SOQL 쿼리일 수 있습니다. 다른 플랫폼에서는 표준 SQL 쿼리일 수 있습니다.
• 시간 제한: 요청을 선언하기 전에 응답을 기다리는 시간(밀리초)을 정의합니다.
• 비동기: 이 토글을 사용하면 사용자가 작업을 계속할 수 있도록 백그라운드에서 쿼리를 비동기적으로 실행할 수 있습니다.
• 헤더: 간단한 핸들바 구문을 사용하여 헤더 수준 트랜잭션 관리자 필드에서 정적 텍스트를 사용하거나, 헤더에 대한 키-값 쌍을 설정하거나, 이 두 방법을 결합할 수 있습니다. {{txn.필드 이름}}

다음으로 엔드포인트에 대한 연결을 정의해야 합니다. 여기서는 이전에 유틸리티 영역에서 생성한 연결 목록에서 선택하여 이 통합을 위해 연결할 타사 사이트를 정의합니다.

마지막으로 타사 데이터를 필드에 CPQ 매핑하거나 데이터를 타사 데이터 소스 필드에 매핑 CPQ 할 수 있는 변환 템플릿을 정의해야 합니다.

JSON은 다음 예와 같이 매핑을 정의하는 데 사용됩니다.

{
  "fields": [
    {
      "variableName": "txn.custom.tXNNumber",
      "value": "{{#each records}}{{Name}}{{/each}}"
    },
    {
      "variableName": "txn.opportunity.id",
      "value": "{{#eachrecords}}{{LGK__OpportunityId__c}} {{/each}}"
    },
    {
      "variableName": "txn.custom.primaryContact",
      "value": "{{#eachrecords}}{{Contact.FirstName}}{{/each}}"
    }
  ]
}

이 예에서는 Salesforce 사이트에서 추출한 Salesforce 데이터에 Mustache 구문을 사용합니다. 각 필드 매핑에는 추출된 데이터를 수신하는 필드의 CPQ 변수 이름과 데이터가 추출된 Salesforce 필드를 식별하는 값이 포함됩니다. #eachredords 및 /each 명명법은 쿼리 응답의 각 기록이 템플릿의 세 필드 값 각각에 대해 검색됨을 나타냅니다.

샘플 반환 데이터 영역과 변환 결과 영역을 사용하여 작동하지 않는 통합 문제를 해결할 수 있습니다. 쿼리 응답을 보고 복사할 수 있는 Postman과 같은 도구에서 쿼리를 수행하는 경우 샘플 응답 데이터 영역에 쿼리 응답을 붙여 넣은 다음 변환 템플릿 영역 아래의 변환 실행 을 클릭할 수 있습니다. 쿼리 응답 데이터는 정의된 변환 템플릿을 통해 실행되며 변환 결과는 변환 결과 영역에 표시됩니다.