위치:
통합 절차에 대한 목록 작업
목록 작업은 지정된 목록 항목 JSON 노드의 값을 일치시켜 여러 목록을 병합합니다. 기본 병합은 노드 이름과 정확하게 일치합니다. 고급 병합은 다른 이름이 있거나 수신 목록에서 다른 수준에 있는 노드를 일치시킵니다.
목록에 항목이 하나만 포함되어 있는 경우에도 목록 작업에 대한 입력은 각각 목록 형식이어야 합니다. 하나의 항목이 있는 목록을 반환하는 Omnistudio 데이터 매퍼 추출은 항목을 단일 개체로 변환하는 경우가 많습니다. 단일 개체를 다시 목록으로 변환하려면 Omnistudio Data Mapper Transform Examples의 첫 번째 예를 사용할 수 있습니다.
자세한 목록 처리 옵션은 지원되는 데이터 매퍼 및 통합 절차 함수에서 데이터 매퍼를 사용하여 목록 변환 및 AVG, FILTER, IF, LIST, LISTMERGE, LISTMERGEPRIMARY, LISTSIZE, MAX, MIN, SORTBY, SUM 함수를 참조하십시오.
이름이 다른 노드를 일치시키거나 수신 목록에서 다른 수준에 있는 노드를 일치시키려면 고급 병합을 클릭하고 다음과 같이 일치시킬 노드에 대한 설정을 지정합니다.
-
목록 키: 일치시킬 노드가 있는 JSON 목록 노드의 이름을 입력합니다.
-
일치 경로: 일치시킬 노드에 대한 목록 내 경로를 입력합니다.
-
매칭 그룹: 일치시킬 모든 노드에 같은 번호를 지정합니다.
예를 들어, 이 그림은 노드 이름이 다른 두 수신 목록의 이름과 성을 일치시키는 방법을 보여줍니다.
속성 |
설명 |
|---|---|
|
목록이 병합되는 순서를 지정합니다. 목록에 이전 목록으로 채워진 키에 대한 값이 포함된 경우 이후 항목이 이전 항목을 덮어씁니다. |
병합 필드 |
병합할 항목에 대해 일치해야 하는 JSON 노드의 이름입니다. JSON 구조의 최상위 수준 아래에 있는 노드를 지정하려면 콜론 구분 경로를 사용합니다. 기본적으로 두 목록의 노드는 이름이 같고 동일한 수준에 있는 것으로 간주됩니다. 병합 필드를 지정하지 않으면 목록이 단일 목록으로 병합되지만 키가 일치하는 노드는 병합되지 않습니다. JSON 목록에 있는 값을 일치시키려면 경로에 |
고급 병합 |
다른 이름이 있거나 수신 목록에서 다른 수준에 있는 노드를 일치시킵니다. 통합 절차 목록 작업을 참조하십시오. |
|
병합 필드가 모두 null인 경우 일치 항목을 처리할지 여부를 지정합니다. |
|
목록에 중복 항목이 있는 경우 목록 내에서 항목을 병합할지 여부를 지정합니다. 이 예에서는 인트라 목록 병합 방지를 선택하지 않은 경우 병합된 목록 출력: 인트라 목록 병합 방지를 선택한 경우 병합된 목록 출력: |
|
출력에 유지할 키의 허용 목록을 지정합니다. |
기본 목록 키 |
(옵션) 병합이 수행된 후 항목 목록을 유지할 수 있습니다. 기본 목록을 지정하는 경우 해당 목록의 항목만 출력에 유지됩니다. |
필터 목록 수식 |
목록의 각 노드에서 실행되는 수식을 지정하여 목록에 남아 있는지 여부를 결정합니다. 노드를 평가한 후 FormulaResult가 TRUE를 반환하는 경우 노드가 유지되며, 그렇지 않으면 노드가 제거됩니다. 예를 들어, 목록에서 null 값을 제거하도록 |
동적 출력 필드 |
기본적으로 모든 노드가 반환됩니다. 지정된 결과 노드 하위 집합을 반환하려면 입력 JSON에 노드를 추가하고 해당 값을 원하는 노드 이름의 쉼표로 구분된 목록으로 설정합니다. 이 목록에서 공백을 사용하지 마십시오. 이 속성을 이 노드 이름 목록을 포함하는 노드의 이름으로 설정합니다. |
정렬 기준 |
출력 목록이 정렬되는 키를 하나 이상 지정합니다. |
필드 값 업데이트 |
값을 할당하거나 출력 목록에서 값을 평가하고 조건부로 바꿀 수 있는 수식을 지정합니다. 수식을 지정하려면 표현식 앞에 "="을 붙입니다. 예를 들어, 빈 이름 또는 성을 "지정되지 않음"으로 바꾸려면 이 그림에 표시된 항목을 추가합니다. ![]() 자세한 내용은 지원되는 데이터 매퍼 및 통합 절차 기능을 참조하십시오. |

