변환 요소
소스 데이터를 대상 데이터로 매핑하고 변환할 플로 자원을 선택합니다. 화면 플로, 트리거가 없는 자동 실행 플로, 레코드 트리거형 플로에 변환 요소를 사용할 수 있습니다.
필수 Edition
| 지원되는 Edition을 확인하세요. |
| 필드 | 설명 |
|---|---|
| 소스 데이터 | 변환할 데이터입니다.
|
| 대상 데이터 | 변환된 후의 데이터
|
| 수식 | 데이터를 변환하는 수식입니다. 수식 표현식:
수식 결과는 대상 필드 데이터 유형과 호환되어야 합니다. 수식에서 [$EachItem] 병합 필드 구문은 컬렉션의 각 항목을 나타냅니다. 병합 필드는 주문 컬렉션을 참조하고 각 주문 항목에는 고객 필드가 있습니다. 각 고객 필드에는 이름 필드가 포함되어 있습니다. {!Orders[$EachItem].Customers[$EachItem].Name} |
사용
변환 요소를 사용하려면 다음 일반 제한 사항을 이해해야 합니다.
- 컬렉션을 변환할 때 변환에 데이터 정렬 또는 필터링이 포함될 수 없습니다. 대신 플로에서 컬렉션 필터 또는 컬렉션 정렬 요소를 사용하여 컬렉션을 필터링하거나 정렬할 수 있습니다.
- 소스 및 대상 데이터의 디버그 세부 사항을 서식 있는 대화형 형식으로 보는 것은 트리거가 없는 자동 실행 플로와 레코드 트리거형 플로에서만 지원됩니다.
- 대상 데이터의 리소스가 외부 서비스 등록의 Apex 클래스인 경우 Flow Builder의 디버그 세부 사항에 수정된 필드 이름이 표시됩니다.
노트 외부 서비스가 등록되면 Salesforce에서 서비스의 입력 및 출력을 저장하는 Apex 클래스를 만듭니다.- 필드에서 예약된 이름을 사용하는 경우 필드 이름에 z0이 추가됩니다(예: z0type). 플로가 외부 서비스에 콜아웃하면 원래 필드 이름(이 예에서는 유형)이 사용됩니다. Apex 예약 키워드를 참조하십시오.
- name_set과 같이 _set을 추가하는 필드는 동적 Apex 클래스에 자동으로 추가됩니다. 필드는 동적 Apex 클래스를 검사하는 경우에만 플로 디버그 세부 사항에 나타납니다. Apex에서 외부 서비스 등록을 참조하십시오.
- 표준, 사용자 정의, 외부 개체의 조회 필드를 통해 관련 레코드에 액세스하는 기능은 지원되지 않습니다.
- 확인란 그룹, 선택 목록, 선택 항목 조회 화면 구성 요소는 소스 또는 대상 데이터에 대한 플로 자원으로 지원되지 않습니다.
- 데이터 그래프는 세그먼트 트리거 플로와 데이터 그래프 트리거를 사용하는 자동화 이벤트 트리거 플로에서 지원됩니다.
- 데이터 그래프의 컬렉션은 지원되지 않습니다. 예를 들어 변환 요소는 데이터 그래프에서 컬렉션을 집계할 수 없습니다.
컬렉션에서 데이터 구조의 무결성을 유지하는 다음 규칙을 이해합니다.
- 소스 컬렉션의 필드를 대상 컬렉션의 필드에 매핑할 경우 두 컬렉션이 각 자원에서 동일한 계층 수준에 있어야 합니다. 예를 들어 소스 데이터의 컬렉션 A와 대상 데이터의 컬렉션 A는 다른 컬렉션에 속하지 않습니다. 해당 자원의 상위 컬렉션이므로 두 컬렉션 사이에 필드를 매핑할 수 있습니다.
- 다른 컬렉션 내의 컬렉션에 있는 필드를 매핑하기 전에 상위 컬렉션의 필드를 매핑합니다. 예를 들어, 소스 및 대상 데이터의 플로 자원에 모두 데이터 구조가 동일한 컬렉션 A가 포함되어 있습니다. 컬렉션 A에는 컬렉션 B가 포함되어 있습니다. 컬렉션 B의 필드를 매핑하기 전에 컬렉션 A의 필드를 매핑한 후 컬렉션 B의 필드를 매핑하십시오.
런타임 시 대상 데이터 필드가 매핑되지 않거나 null이면 변환 요소에서 생성된 플로 자원에서 제거됩니다.
조인 변환에 대한 다음 제한 사항을 검토하세요.
- 다른 컬렉션에 속하는 컬렉션은 조인할 수 없습니다.
- 소스 필드를 대상 필드에 매핑하려면 두 필드가 동일한 데이터 유형이어야 합니다. 예를 들어 소스 필드가 Apex 정의 데이터 유형이라면 대상 필드 또한 Apex 정의 데이터 유형이어야 합니다.
- 조인할 각 필드는 대상 컬렉션에서 하나의 대상 필드에만 매핑될 수 있습니다.
- 조인 변환에서 이미 선택되거나 매핑된 소스 컬렉션 또는 소스 필드를 제거하거나 수정하면 조인 변환이 무효화됩니다.
- 조인 변환에는 하나의 대상 컬렉션만 포함됩니다. 조인 변환이 여러 개 있는 경우 각 변환에는 고유의 대상 컬렉션이 포함됩니다.
- 조인 변환에서 대상 컬렉션을 매핑하는 경우 조인 변환 외부의 다른 매핑에 대상 컬렉션을 사용할 수 없습니다.
- 데이터 그래프 지원되지 않습니다.
조인 변환으로 Apex CPU 제한을 초과하지 않도록 다음 지침을 검토하세요. 디버그 로그를 확인하여 각 변환 요소에 소요되는 CPU 시간을 확인할 수 있습니다.
- 즉시 실행되는 플로 경로의 경우, 각 소스 컬렉션에 700개 미만의 레코드가 포함되도록 제한합니다.
- 일정에 따라 또는 비동기식으로 실행되는 플로 경로의 경우, 각 소스 컬렉션에 1,500개 미만의 레코드가 포함되도록 제한합니다.
- 각 소스 컬렉션에 600개 미만의 레코드가 포함된 컬렉션의 경우, 200개 이하의 소스 필드를 대상 필드에 매핑합니다.
제한
- 변환 요소는 최대 하나의 중첩된 컬렉션 매핑을 지원합니다.
- Apex 정의 플로 자원에 있는 필드는 최대 10개의 Apex 정의 필드 수준을 참조할 수 있습니다. 예를 들어 CollectionA의 이름 필드는 첫 번째 수준입니다. CollectionB의 필드는 두 번째 수준입니다.
- 디버그 세부 사항은 컬렉션에 최대 20개의 레코드를 표시합니다.
- 변환 요소에서 수식은 255자까지 포함할 수 있습니다. 255자를 초과하는 문자는 잘립니다. 플로에 수식 자원을 만들면 수식에 255자 넘게 입력할 수 있습니다. 수식 자원은 수식에서 255자를 초과할 수 있습니다. 변환 요소에서 수식을 사용하여 데이터를 변환할 때 수식 자원을 선택할 수 있습니다.
다음 사항도 참조:
이 기사를 통해 문제를 해결했습니까?
개선을 위한 의견을 보내주세요.
