SOQL(Sforce Object Query Language)을 사용하여
이 활동에서 하나 이상의 Salesforce.com 오브젝트 유형에 조회를
실행하고 결과 세트를 리턴합니다. 오브젝트 조회 활동은 자동으로
query 또는 queryAll 호출을 수행하고,
그 뒤로 Salesforce.com에서 리턴된 오브젝트 및 모든 하위에 대해 연속
queryMore 호출을 수행합니다.
참고: 오브젝트 조회 활동을 실행하면 Salesforce.com에서 커서가
열리고 조회 결과를 추적할 수 있습니다. 활동에서 Salesforce.com이
각 사용자에게 할당한 커서 한계에 도달하거나 커서가 만기되는 경우
통합 어플라이언스가 활동을 다시 시도합니다.
오브젝트 조회 활동 사용
- 활동 탭에서 Salesforce.com 디렉토리를 열어서
오브젝트 조회 활동을 찾으십시오.
- 활동을 오케스트레이션에 추가하십시오.
활동에 대한 점검 목록
및 요약이 오케스트레이션 아래에 표시됩니다.
- Salesforce.com 엔드포인트를 선택하십시오.
Salesforce.com 엔드포인트 작성 또는 편집에 대한 지시사항은
Salesforce.com 엔드포인트 작성 또는 편집을 참조하십시오.
- 조회를 지정하고 조회 옵션을 설정하여 활동을
구성하십시오.
- 활동의 재시도 및 제한시간 매개변수를 지정하십시오.
- 활동의
입력을 맵핑하십시오.
- 활동의
출력을 맵핑하십시오.
오브젝트 조회 활동의 입력 맵핑
- 점검 목록에서 입력
맵핑을 선택하십시오.
활동으로 패널에
parameters 요소가 표시됩니다. parameters
요소에는 SOQL 조회에 지정한 각 매개변수의 하위 요소가 있습니다. 조회에서 매개변수의 컨텍스트에 따라
매개변수 유형이 결정됩니다. 매개변수를 지정하지 않으면 parameters
요소 아래에 하위 요소가 표시되지 않습니다.
- 기본 노드를 마우스 오른쪽 단추로 클릭하고 선택적
매개변수 표시를 선택하여 이 활동에 대한 선택적 입력 매개변수를
표시하십시오.
- MruHeader
- CallOptions
- connection
- sessionInfo
- 입력 선택...을 클릭하고
맵의 입력 변수를 선택하십시오.
변수 작성에 대한 지시사항은
변수
작성을 참조하십시오.
- 변수에 입력 매개변수를 적절하게 맵핑합니다.
맵핑 지시사항은 맵 작성을 참조하십시오.
오브젝트 조회 활동의 출력 맵핑
- 점검 목록에서 출력
맵핑을 선택하십시오.
활동에서 패널에
오브젝트 요소가 표시됩니다. 결과 매개변수에는 objects라고 하는
단일 요소가 조회의 구동 오브젝트 다음에 이름 지정된 단일 반복 요소와 함께
있습니다. 구동 오브젝트는 조회의 FROM 절에서 이름 지정된 첫 번째
오브젝트입니다. 예를 들어, 다음 SOQL 문에서는 Account가
구동 오브젝트입니다.
Select Name from Account, Account.Contacts
구동
오브젝트에는 조회의
SELECT 절에 나열된 필드나 관계에 해당되는
하위 요소가 있습니다. 스키마는 다음과 같이
정의됩니다.
- 필드의 경우, 필드 유형이 필드의 SOAP 유형과
일치합니다. SOAP 유형이 널을 허용하면 필드 유형도
널을 허용합니다.
- 상위 요소에 대한 관계의 경우, 요소 이름은
상위의 이름입니다. 활동이 조회를 실행할 때 상위가
없을 경우 요소가 없습니다. 상위의 필드
또는 관계는 관계 요소 바로 아래에 표시됩니다.
- 하위 요소에 대한 관계의 경우, 요소 이름은
하위의 이름입니다. 관계 요소에는 하위 오브젝트의
오브젝트 유형 뒤에 이름 지정된 단일 반복 요소가
있습니다. 하위의 필드 및 관계는 오브젝트 유형 요소 아래에
표시됩니다. 활동이 조회를 실행할 때 하위가
없을 경우 요소가 없습니다.
- 필드 또는 관계를 선택하지 않았지만 대신 SELECT 절에서
count()를 요청하는 경우, 전체 오브젝트 유형 요소는 unsignedInt 유형의
count 요소로 바뀝니다.
- 출력 선택...을 클릭하고
맵의 출력 변수를 선택하십시오.
변수 작성에 대한 지시사항은
변수
작성을 참조하십시오.
- 변수에 출력 매개변수를 적절하게 맵핑합니다.
맵핑 지시사항은 맵 작성을 참조하십시오.