Zuora 애플리케이션에서 Product, Account 또는 RatePlan과 같은
오브젝트를 조회하려면 Zuora 오브젝트 조회 활동을 사용하십시오.
이 조작에 대해 지정하는 조회 문자열은 Zuora 오브젝트 조회 언어 표준을 준수해야 합니다.
이 태스크 정보
Zuora 애플리케이션에서 오브젝트를 조회하려면 이 태스크를 사용하십시오. 이 활동의 호출은 입력 데이터가 처리 시 활동으로 전송되고
응답이 다시 오케스트레이션으로 전송되는 동기 호출입니다.
Zuora 오브젝트 조회 활동을
구성하려면 다음 단계를 완료하십시오.
프로시저
- 활성 오케스트레이션에서 활동 탭을 열고
Zuora 폴더 컨텐츠를 펼치십시오.
- 오브젝트 조회 활동 아이콘을 오케스트레이션으로 끌어오십시오. Zuora 오브젝트 조회 체크리스트가 표시됩니다.
- 점검 목록에서 요약을 클릭하십시오.
- 활동 이름 필드의 컨텐츠를 검토하고 필요에 따라 변경을 수행하십시오.
- 점검 목록에서 엔드포인트
선택을 클릭하십시오.
- 찾아보기를 클릭하고 프로젝트
탐색기 대화 상자를 사용하여 관련 Zuora 엔드포인트를 선택하십시오.
- 옵션: 새로 작성을 클릭하고 필수 연결 세부사항을 지정하여
엔드포인트를 작성할 수 있습니다. 연결 테스트를 클릭하여
Zuora 애플리케이션에 연결되었는지 테스트하십시오. 확인을 클릭하여
저장하고 이 구성에 대한 엔드포인트를 사용하십시오.
- 선택된 엔드포인트 구성에 대한 필수 변경사항을 작성하려면 편집을 클릭하여
별도의 창에서 옵션에 액세스하십시오. 글로벌로 수행하는 변경사항은
활성 오케스트레이션의 모든 엔드포인트 사용에 영향을 줍니다.
- 점검 목록에서 입력 맵핑을 선택하십시오.
오브젝트 조회 활동의 선택된 오브젝트에서 생성된 XML 스키마가 활동으로 패널의
request 입력 매개변수 아래에 노드로 표시됩니다.
- 활동의 입력 매개변수와 오케스트레이션 변수 간의 맵을 작성하십시오.
참고: 런타임 시 입력 구조의 필수 요소에 값을 제공해야 합니다.
요소에 기본값을 지정하거나 요소를 입력 노드와 연결하여 값을
제공할 수 있습니다. 런타임 동안 필수 요소의 값이 제공되지 않으면
활동이 완료되고 queryResponse 결과가 오류 메시지로 채워집니다. 활동의 응답을 검토하여
요청이 실패 또는 성공했는지 확인할 수 있습니다.
- 점검 목록에서 출력 맵핑을 선택하십시오.
활동의 응답을 보유하는 데 생성된 XML 스키마가 활동에서 패널의
response 출력 매개변수 아래에 노드로 표시됩니다.
- 출력 매개변수와 오케스트레이션 변수 간의 맵을 작성하십시오.
참고: 오브젝트 조회 활동의 출력은 일반 구조를 가진 queryResponse입니다.
오브젝트 조회 활동의 출력을 이후 활동에서 사용해야 하는 경우, 직접 맵핑을 수행할 수 없습니다. XSLT 적용 활동의 도움을 받아
queryResponse에서 데이터를 추출해야 합니다.
특정 데이터를 추출하는 데 사용할 수 있는 샘플 XSLT:
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:ns1="http://api.zuora.com/" xmlns:ns2="http://object.api.zuora.com/">
<xsl:template match="/ns1:queryResponse/ns1:result">
<xsl:element name="Products">
<xsl:apply-templates select="ns1:records" />
</xsl:element>
</xsl:template>
<xsl:template match="ns1:records">
<xsl:element name="Product">
<xsl:element name="Id">
<xsl:value-of select="ns2:Id"/>
</xsl:element >
<xsl:element name="Name">
<xsl:value-of select="ns2:Name"/>
</xsl:element >
<xsl:element name="SKU">
<xsl:value-of select="ns2:SKU"/>
</xsl:element >
<xsl:element name="EffectiveStartDate">
<xsl:value-of select="ns2:EffectiveStartDate"/>
</xsl:element >
<xsl:element name="EffectiveEndDate">
<xsl:value-of select="ns2:EffectiveEndDate"/>
</xsl:element >
<xsl:element name="Description">
<xsl:value-of select="ns2:Description"/>
</xsl:element >
</xsl:element>
</xsl:template>
</xsl:stylesheet>
결과
Zuora 오브젝트 조회 활동을 구성했습니다.