오브젝트 조회 활동 구성

오브젝트 검색 활동을 구성하려면 SOSL(SForce Object Search Language) 조회를 작성해야 합니다. 다음 절에서는 오브젝트 검색 활동을 구성하고, SOSL 조회를 작성하며, IBM® WebSphere® Cast Iron의 SOSL 구문 규칙을 제공하는 단계에 대해 설명합니다.

프로시저

  1. 점검 목록에서 구성을 선택하십시오.

    조회 지정 창이 열립니다.

  2. 조회 지정 창에서 SOSL 조회를 작성하십시오.
  3. (선택사항) SOSL 문의 검색 절에서 동적 매개변수를 지정할 수 있습니다. 이러한 매개변수를 활동의 입력 매개변수로서 동적으로 맵핑할 수 있습니다. 그러면 활동에서 오케스트레이션의 입력에 따라 조회를 동적으로 제어할 수 있습니다. 달러($) 부호 뒤에 매개변수 이름을 사용하여 매개변수를 나타냅니다.
  4. 유효성 검증 아이콘 을 클릭하여 조회의 유효성을 검증하십시오.
    조회가 올바르지 않은 경우 유효성 검증 피드백 아이콘()이 조회 지정 창의 왼쪽 아래 구석에 표시됩니다. 올바르지 않은 조회의 경우 다음을 수행하십시오.
    1. 유효성 검증 오류 목록을 보려면 조회 지정 창의 왼쪽 아래 구석에 있는 유효성 검증 피드백 아이콘을 클릭하십시오.
    2. 메타 데이터를 새로 고치고 SOSL 문의 유효성을 다시 검증하려면 새로 고치기 아이콘()을 사용하십시오.
  5. 점검 목록에서 조회를 선택하여 특정 조회 옵션을 구성하십시오.

    조회 옵션 분할창이 열립니다.

  6. 삭제한 항목을 조회에 포함(queryAll 조작 실행)을 선택하여 기존 레코드 외에 삭제된 레코드에 대해 조회하십시오. 이 옵션을 선택하지 않으면 통합 어플라이언스가 기존 레코드만 조회합니다.
  7. 통합 어플라이언스의 성능을 조정하는 데 도움을 받으려면 조회 일괄처리 크기를 200 - 2,000개 조회로 지정하십시오.

    이 옵션은 모든 조회 호출의 QueryOptions SOAP 헤더에 사용되는 일괄처리 크기를 결정하며 활동에서 리턴되는 결과 수에는 영향을 주지 않습니다. 기본적으로 이 옵션은 500개 조회로 설정됩니다.

SOSL 조회 작성

SOQL 조회를 작성할 때 SOQL 문의 WHERE 절에 동적 매개변수를 사용할 수 있습니다. 그러면 Studio가 이러한 매개변수를 활동의 입력 매개변수로서 동적으로 맵핑할 수 있습니다. 따라서 오케스트레이션의 입력에 따라 조회를 동적으로 제어할 수 있습니다.

이 태스크 정보

SOQL(SForce Object Query Language)은 매개변수화된 조회의 구문을 정의하지 않지만, Cast Iron은 몇 가지 사유 SOQL 구문 규칙을 적용합니다. 단순 표현식 또는 세트 표현식에서 매개변수를 사용할 수 있습니다.

Cast Iron에 대한 SOSL 구문 규칙
  • 달러($) 부호를 사용하여 매개변수를 나타냅니다. 달러($) 부호 뒤에 영숫자 문자를 지정하십시오. 첫 번째 문자는 문자[a-zA-Z]여야 합니다. 그 뒤에는 문자[a-zA-Z], 숫자[0-9], 또는 밑줄( _ )을 사용할 수 있습니다.
    주: 매개변수 이름은 대소문자를 구분하므로 $a 및 $A 매개변수는 다른 매개변수로 간주됩니다.
    다음 표에는 올바른 매개변수 선언과 올바르지 않은 매개변수 선언의 예가 포함되어 있습니다.
    매개변수 올바름/올바르지 않음
    $AnAccount 올바름
    $a123_456 올바름
    $123a 올바르지 않음
    $_id 올바르지 않음
  • WHERE 절에서 표현식 오른쪽에 매개변수를 선언해야 합니다.
  • 지정된 SOQL 문에서 매개변수가 두 번 이상 표시될 수 있습니다. SOQL 문에서 매개변수가 두 번 이상 표시되어도 입력 매개변수 맵에서는 한 번만 표시됩니다. 이 활동에서는 런타임 시에 매개변수가 사용되는 모든 위치를 동일한 값으로 대체합니다.
    주: 동일한 매개변수 이름을 사용하고 유형이 일치하지 않는 경우 오류가 발생합니다. 예를 들어 $param이 문자열 및 날짜 유형 둘 다로 사용되기 때문에 다음 SOQL에서 오류가 생성됩니다.

    SELECT Name from Account where Name like $param and createdDate > $param

  • 매개변수를 비교하는 필드의 유형에 따라 매개변수의 유형과 매개변수가 단순 표현식, 세트 표현식 또는 세트 표현식의 일부에 사용되는지 여부가 결정됩니다.
    표현식 유형 설명
    단순 표현식 예: Select ID from Account where Name = $NameParam

    표현식 왼쪽에 있는 필드의 SoapType은 매개변수 유형을 결정합니다. 필드 유형이 널 허용이고 연산자가 ( = ) 또는 ( != )인 경우 매개변수는 널 허용 상태입니다. 매개변수에서 xsi:nil=true를 설정하면 대체될 때 매개변수값이 널로 설정됩니다. 매개변수의 유형을 작은따옴표(')로 묶어야 할 경우, 대체되는 동안 매개변수값이 작은따옴표로 묶이고 컨텐츠가 자동으로 이스케이프됩니다.

    SOQL의 경우 백슬래시(\)와 작은따옴표(‘)가 이스케이프됩니다.

    세트 표현식 예를 들어 Select ID From Account where ID in $idList의 경우, 매개변수 유형은 표현식 왼쪽에 있는 필드의 SoapType의 반복 시퀀스입니다. 매개변수가 널을 허용하지 않으며 요소에 minOccurs=1, maxOccurs=unbounded가 있습니다.

    이 시퀀스는 런타임 시에 펼쳐져 적절한 세트 값이 됩니다. 예를 들면 다음과 같습니다.

    Select Id From Account where Id in (‘value1',‘value2')

    세트 표현식의 일부 세트 목록 내부에 있는 매개변수는 단순 표현식 매개변수 유형로 간주됩니다. 예를 들면 다음과 같습니다.

    SELECT Name from Account where BillingState IN (‘California', $state2). 이 예에서, $state2 매개변수 유형은 Account BillingState 필드의 SoapType이며 반복 요소가 아닙니다. 매개변수는 널을 허용하지 않습니다.