Loading
데이터 매퍼 터보 추출 구성

위치:

  1. Salesforce 도움말
  2. 문서
  3. Omnistudio

데이터 매퍼 터보 추출 구성

데이터 매퍼 터보 추출을 구성하려면 개체 유형, 필터, 추출할 필드, 옵션을 지정합니다.

  1. 앱 시작 관리자에서 데이터 매퍼를 찾아서 선택합니다.
  2. 구성할 데이터 매퍼 터보 추출을 선택합니다.
  3. 추출 개체를 검색하고 선택합니다.
  4. 추출 개체 경로를 입력합니다.
  5. 읽을 데이터를 결정하는 필수 필터를 추가합니다. null 값을 필터링하려면 $Vlocity.NULL 변수를 사용합니다.

    가장 기본적인 필터는 Id = Id이며, 이는 개체의 ID를 입력 매개 변수 ID로 설정합니다. INCLUDES 및 EXCLUDES 연산자는 다중 선택 선택 목록 필드에만 적용됩니다. Salesforce 도움말의 다중 선택 선택 목록 쿼리를 참조하십시오.

    Turbo Extract에는 추가 연산자 옵션 IN가 있습니다. IN 연산자를 사용하면 배열의 항목에 값을 일치시킬 수 있습니다. 예를 들어 필터가 LastName IN Names이고 JSON 입력이 {"Names": ["Miller", "Torres"]}인 경우 LastName 필드에 Miller 또는 Torres가 있는 모든 레코드를 검색합니다.

    데이터 매퍼 터보 추출은 필드 값에 작은 따옴표가 있는 여러 입력 필드를 지원하지 않습니다. 대신 데이터 매퍼 추출을 사용하십시오. 예를 들어, 값이 T’an인 FirstName이라는 입력과 C’os라는 값이 있는 LastName이라는 다른 입력은 데이터 매퍼 터보 추출에서 지원되지 않습니다.

  6. 추가 필터를 구성하려면 아래쪽 화살표를 클릭합니다.
    AND Add another filter and specify that both filters must be true
    OR Add another filter and specify that either filter can be true.
    LIMIT Specify the maximum number of records returned. Valid values are 1 through 50000; the default is 50000.
    OFFSET

    페이징 논리를 구현하려면 필터를 추가하여 레코드 검색이 시작되는 위치를 지정합니다. 드롭다운 목록에서 OFFSET을 선택하고 호출자가 동적 오프셋(예: offsetValue)을 유지하는 입력 페이로드의 노드 이름을 지정합니다.

    OFFSET with LIMIT를 사용하여 다중 페이지 검색에서 페이지에 표시할 첫 번째 레코드를 지정합니다. 오프셋은 정수여야 합니다. 예를 들어, LIMIT가 5인 경우 연속 페이지의 오프셋은 0, 5, 10 등입니다.

    노트
    노트 Salesforce는 OFFSET을 사용하는 쿼리에 2,000개의 레코드 제한을 적용합니다. 허용되는 OFFSET 값은 0~2000입니다. SOQL 쿼리에서 Offset 2000 한도 해결 방법을 참조하십시오.
    ORDER BY

    지정된 필드별로 결과를 정렬합니다. 여러 필드로 정렬하려면 쉼표로 구분된 필드 이름 목록을 우선 순서대로 지정합니다(예: LastName,FirstName).

    경우에 따라 오름차순 정렬에 ASC를 지정하거나 내림차순 정렬에 DESC를 지정할 수 있습니다. 경우에 따라 NULLS FIRST 또는 NULLS LAST를 지정하여 시작 또는 끝에 빈 값을 배치할 수 있습니다. 예를 들어 직원 수를 기준으로 계정을 정렬하여 가장 먼저 알 수 없는 규모의 회사와 가장 큰 고용주를 나열할 수 있습니다. ORDER BY 값 NumberOfEmployees ASC NULLS FIRST을 지정합니다.
    DELETE Remove a filter.
  7. 기본 개체의 상위 개체에서 데이터를 검색하려면 관련 개체를 선택합니다. 예: Contact.Account. 표기법에 대한 자세한 내용은 관계 표기법 vs. 다중 추출 단계를 참조하십시오.

    다른 개체와의 관계를 선택하면 해당 필드가 사용 가능한 필드에 나타납니다. 해당 필드를 클릭하면 두 번째 수준 관계가 표시되므로 5개 수준을 탐색할 수 있습니다. 수준으로 돌아가려면 목록을 클릭하고 이전 수준을 선택하기만 하면 됩니다.

  8. 필드 매핑에서 사용 가능한 필드를 검색합니다. 관리 패키지에서 디자이너를 사용하는 경우 이 옵션을 사용할 수 없습니다.
  9. 추출할 필드를 선택하고 사용 가능에서 선택된 필드로 옮깁니다. ID 필드는 항상 선택한 필드에 포함됩니다.
  10. 옵션을 클릭하고 추가 설정을 구성합니다.
    1. 데이터 캐싱이 활성화된 경우 조직 캐시 또는 세션 캐시에 캐시된 값이 유지되는 시간(분)을 지정합니다. 최소값은 5분입니다.
    2. 데이터 캐싱을 활성화하려면 Salesforce Platform Cache 유형 선택 목록에서 캐시 유형을 선택합니다. 캐싱을 사용하여 데이터 매퍼 성능 향상을 참조하십시오.

      없음 - 이 데이터 매퍼에 대한 데이터 캐싱을 비활성화합니다.

      세션 캐시 - 사용자 및 로그인 세션과 관련된 데이터입니다.

      Org Cache - 기타 모든 유형의 데이터.

    3. 데이터 매퍼를 실행하기 전에 필드에 대한 사용자의 액세스 권한을 확인하려면 실행 전에 필드 수준 보안 확인을 선택합니다. 이 옵션을 선택하면 조직 캐시가 비활성화되지만 세션 캐시는 비활성화되지 않습니다.
    4. Data Mapper 응답에 null 값을 포함하려면 응답에 null 값 포함을 선택합니다.
    5. 변경 사항을 저장합니다.
  11. Data Mapper Turbo Extract를 테스트할 때 캐싱의 영향을 확인하려면 캐시 무시를 선택 취소합니다. 캐싱을 사용하여 데이터 매퍼 성능 향상을 참조하십시오.
 
로드 중
Salesforce Help | Article