Omniscript 데이터 매퍼 작업 요소

Omnistudio 데이터 매퍼 추출 작업으로 여러 개체에서 데이터 검색

Salesforce 개체의 데이터로 Omniscript를 로드하려면 데이터 매퍼 추출을 호출합니다. 하나 이상의 관련 Salesforce 개체에서 데이터를 가져올 수 있습니다. 수식 및 복잡한 필드 매핑을 사용할 수도 있습니다.

1. 요소 패널에서 Data Mapper Extract Action 요소를 캔버스로 끌어옵니다.
2. 속성 패널에서 호출할 데이터 매퍼 이름을 선택합니다.
   필드를 입력하여 목록을 필터링할 수 있습니다. 데이터 매퍼 추출이 없는 경우 속성 패널에서 데이터 매퍼를 만듭니다.
3. JSON 노드의 이름 및 JSON 노드의 값을 데이터 매퍼 추출의 입력 매개 변수로 제공합니다.
   각 데이터 소스 필드는 Data Mapper Extract 입력 매개 변수와 일치해야 합니다. 각 필터 값은 입력 매개 변수가 참조하는 sObject 필드의 값과 일치해야 합니다.
4. 응답 변환 속성을 사용하여 출력 JSON을 자르거나 이름을 변경합니다.
   전송/응답 변환 속성으로 JSON 조작을 참조하십시오.

Omnistudio 데이터 매퍼 게시 작업으로 개체에 데이터 쓰기

Omnistudio 데이터 매퍼 게시 작업을 사용하여 Omniscript에서 sObject를 만들고 업데이트합니다. 데이터 매퍼 게시 작업은 Omniscript의 데이터를 하나 이상의 Salesforce 개체에 업데이트하거나 추가하는 데이터 매퍼 로드에 전송합니다.

Omniscript에서 데이터 매퍼 게시물 작업을 사용하려면 다음 세 가지 핵심 항목을 설정해야 합니다.

• 추가 또는 업데이트할 데이터
• 데이터를 추가하거나 업데이트할 개체
• Omniscript JSON의 데이터를 개체 및 필드에 매핑

여러 업서트 키를 사용하는 경우 레코드가 일치하는 모든 키와 일치해야 합니다. 여러 작업이 필요한 경우 통합 절차를 사용하여 데이터 매퍼 게시 작업을 호스팅하고 요청을 처리합니다.

먼저 Omniscript에 개체를 업데이트하거나 추가할 데이터에 대한 액세스 권한이 있거나 데이터를 제공해야 합니다. 예를 들어, 데이터가 사용자 입력인 경우 Omniscript에 계정 이름 및 산업, 계정 연락처의 이름(성 없이), 성(姓), 이메일 주소와 같은 해당 데이터에 대한 입력 필드가 있어야 합니다.

두 번째로, 해당 개체의 필드에 데이터를 쓸 수 있도록 작업에 명명된 데이터 매퍼 로드에 Salesforce 개체가 포함되어야 합니다. 예를 들어 데이터 매퍼 로드에 계정 개체 및 AccountId 필드를 통해 연결된 개체로 연락처가 있습니다.

세 번째로 데이터 매퍼에서 Omniscript의 데이터를 개체 필드로 매핑하여 만들거나 업데이트합니다. 계정 연락처 예를 사용하면 매핑에 이름(성 없이), 성(姓), 이메일 주소가 포함됩니다. 오른쪽에서 JSON 노드 참조가 개체 및 왼쪽 필드에 매핑됩니다.

데이터 매퍼 로드가 예상하는 구조로 입력 JSON을 자르거나 이름을 변경하려면 전송 변환 속성을 사용합니다. 전송/응답 변환 속성으로 JSON 조작을 참조하십시오.

Omniscript 미리 보기는 예 입력에 JSON을 포함합니다.

{
  "omniscriptId": "0jNSG000000Fqnt2AC",
  "language": "English",
  "type": "Content",
  "subType": "Audit",
  "sId": "0jNSG000000Fqnt2AC",
  "runMode": "preview",
  "theme": "lightning",
  "LanguageCode": "en_US",
  "userProfile": "System Administrator",
  "timeStamp": "2025-05-19T15:43:49.752Z",
  "userTimeZoneName": "America/Los_Angeles",
  "userTimeZone": "-420",
  "userCurrencyCode": "USD",
  "userName": “exampleuser123,
  "userId": "005SG00000JaEzCYAV",
  "omniProcessId": "0jNSG000000Fqnt2AC",
  "localTimeZoneName": "Asia/Calcutta",
  "AccountDetails": {
    "AcctName": "Acme",
    "Industry": "Other",
    "ContactFirstName: "Jon”,
    "ContactLastName”: "Doe”,
    "ContactMail": “Jon_Doe@gmail.com"
  }
}

Omnistudio 데이터 매퍼 변환 작업으로 데이터 재구축

데이터를 재구축, 이름 변경 및 변환하려면 데이터 매퍼 변환 요소를 사용합니다. 전체 Omniscript 데이터 JSON을 데이터 매퍼로 보내고 데이터 매퍼에서 매핑을 반환합니다. 데이터 매퍼 추출 및 로드와 달리 변환은 Salesforce 데이터를 읽거나 쓰지 않습니다.

전송/응답 변환 속성을 사용하여 입력 JSON을 자르거나 이름을 변경하여 데이터 매퍼 변환이 예상하는 구조를 갖습니다. 또는 후속 Omniscript 단계에서 출력 JSON을 자르거나 이름을 변경할 수 있습니다.

전송/응답 변환 속성으로 JSON 조작을 참조하십시오.

Omnistudio 데이터 매퍼 터보 작업으로 개체에서 데이터 검색

Omniscript에서 사용할 단일 Salesforce 개체의 데이터를 가져오려면 데이터 매퍼 터보 추출 작업을 사용합니다. 표준 데이터 매퍼 추출과 달리 데이터 매퍼 터보 추출은 수식 또는 복잡한 필드 매핑을 지원하지 않습니다. 반환된 데이터 유형이 SObject가 아닌 Map<String, Object>이므로 다시 직렬화하지 않고 Product2 개체를 업데이트하는 데 사용할 수 없습니다. 데이터 매퍼 터보는 설정하기가 더 간단하며 데이터 매퍼 추출보다 더 빠르게 실행할 수 있습니다.

1. 데이터 매퍼 터보 추출에 필요한 입력 매개 변수로 JSON 노드의 이름 및 값을 제공합니다.
   각 데이터 소스 필드는 Data Mapper Turbo Extract 입력 매개 변수와 일치해야 합니다. 각 필터 값은 입력 매개 변수가 참조하는 sObject 필드의 값과 일치해야 합니다.

   

   노트

   데이터 매퍼 터보 추출은 중첩된 배열 형식으로 개체를 반환합니다.

   예를 들어 컨텍스트 ID를 계정의 레코드 ID로 설정하려면 데이터 소스 필드가 컨텍스트 ID로 설정되고, 필터 값은 데이터 매퍼 터보 추출에 정의된 변수 이름으로 설정됩니다.

   
2. 응답 변환을 정의합니다.
   1. 응답 JSON 경로 필드에 작업의 응답에 반환된 개체의 이름을 입력합니다.

      요소를 미리 채우려면 | 구분 기호 및 숫자를 추가하여 중첩된 배열의 올바른 인스턴스에 액세스합니다.

      데이터 매퍼 터보 추출 JSON 예제	응답 JSON 경로 예제
      { "Account": [ { "RecordTypeId": "0125w000001NgyvAAC", "Phone": "5105551223", "Name": "Aileen Lee", "Id": "0015w00002D8iCAAAZ" } ] }	Account|1

   2. 개체가 중첩되지 않았는지 확인하려면 Response JSON Node 필드에 VlocityNoRootNode를 입력합니다.
      전송/응답 변환 속성으로 JSON 조작을 참조하십시오.