항목 목록#
Removed in 1.21.0
n8n은 1.21.0 버전에서 항목 목록 노드를 제거했습니다. 대신 다음 노드를 사용하세요:
항목 목록 노드는 목록(배열)을 포함하는 반환된 데이터 작업을 간소화하여 Code 노드를 사용하거나 사용자 정의 JavaScript를 작성할 필요 없이 구조를 변경하여 추가 처리를 할 수 있게 합니다.
작업#
항목 목록 노드를 사용하면 다음 작업을 수행할 수 있습니다:
- 항목 연결: 여러 항목을 하나의 새로운 항목으로 병합합니다.
- 제한: 정의된 최대 수를 초과하는 항목을 제거합니다.
- 중복 제거: 불필요한 항목을 제거합니다.
- 정렬: 항목의 순서를 변경합니다.
- 항목 분리: 항목 내의 데이터 목록에서 별도의 항목을 생성합니다.
- 요약: 항목을 함께 집계합니다. 피벗 테이블과 유사합니다.
항목 분리#
이 작업은 데이터에 고객 목록과 같이 항목 목록이 포함되어 있고 각각의 고객에 대해 항목을 분리하려는 경우에 유용합니다.
항목 분리 작업을 사용할 때는 다음 매개변수 및 옵션을 구성합니다:
- 분리할 필드: 개별 항목으로 분리할 목록이 포함된 필드.
- 파일 입력으로 작업할 때는
$binary를 사용하여 분리할 필드를 설정합니다.
- 파일 입력으로 작업할 때는
- 포함: n8n이 각 새 개별 항목에 입력 데이터의 다른 필드를 유지하도록 하려면 선택합니다. 선택할 수 있는 옵션은 다음과 같습니다:
- 다른 필드 없음
- 모든 다른 필드
- 선택한 다른 필드: 선택하면 n8n이 포함할 필드를 표시합니다. 원하는 필드의 쉼표로 구분된 목록을 입력합니다.
- 옵션 > 필드 추가: 선택적으로 설정을 추가하려면 사용합니다. 포함되는 내용:
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다(
parent.child형식). - 대상 필드 이름: 새로 분리된 내용을 저장할 필드 이름을 선택적으로 설정합니다.
- 바이너리 포함: 새 출력에 입력의 바이너리 데이터(파일)를 포함합니다.
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다(
항목 연결#
항목 연결 작업은 여러 개의 항목 또는 그 일부를 가져와 개별 항목으로 그룹화할 때 유용합니다.
항목 연결 작업을 사용할 때는 다음 매개변수 및 옵션을 구성합니다:
- 집계: 개별 필드 또는 모든 항목 데이터 중에서 집계할지를 선택합니다.
- 개별 필드를 선택하면 다음을 설정할 수 있습니다:
- 집계할 필드: 입력 데이터에서 함께 집계할 필드 이름.
- 필드 이름 변경: 이 토글을 활성화하여 집계된 출력 데이터에 대한 필드 이름을 입력합니다. 여러 필드를 집계할 때는 새 출력 필드 이름을 제공해야 하며, 여러 필드를 정의하지 않은 채로 두어서는 안 됩니다.
- 출력 필드 이름: 필드 이름 변경을 활성화하면 표시됩니다. 집계된 출력 데이터에 대한 필드 이름.
- 옵션 > 필드 추가: 선택적으로 추가 설정을 추가하려면 사용합니다. 포함되는 내용:
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다(
parent.child형식). - 바이너리 포함: 새 출력에 입력의 바이너리 데이터(파일)를 포함합니다.
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다(
- 모든 항목 데이터를 선택하면 다음을 설정할 수 있습니다:
- 출력을 필드에 넣기: 출력 필드의 이름.
- 포함: 모든 필드, 지정된 필드, 또는 모든 필드 제외 중에서 선택합니다.
중복 제거#
사용자가 여러 계정을 생성하거나 고객이 동일한 주문을 여러 번 제출하는 등의 상황에서 중복 데이터가 발생할 수 있습니다. 대형 데이터셋으로 작업할 때 이러한 항목을 찾아내고 제거하는 것이 더 어려워집니다.
중복 제거 작업을 통해 모든 필드 또는 필드 서브셋에서 동일한 항목을 식별할 수 있습니다.
중복 제거 작업을 사용할 때는 다음 매개변수 및 옵션을 구성하세요:
- 비교: n8n이 동일한지 확인하기 위해 입력 데이터의 어떤 필드를 비교할지 지정합니다. 다음 옵션이 제공됩니다:
- 모든 필드: 입력 데이터의 모든 필드를 비교합니다.
- 모든 필드 제외: n8n이 비교에서 제외해야 할 입력 데이터 필드를 입력합니다. 여러 값을 쉼표로 구분하여 제공할 수 있습니다.
- 선택한 필드: n8n이 비교에 포함해야 할 입력 데이터 필드를 입력합니다. 여러 값을 쉼표로 구분하여 제공할 수 있습니다.
- 모든 필드 제외 또는 선택한 필드를 선택하면 n8n이 옵션 > 필드 추가를 표시합니다. 이를 사용하여 다음과 같은 추가 선택적 설정을 추가합니다:
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다 (형식
parent.child).
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다 (형식
정렬#
정렬 작업을 사용하면 원하시는 순서로 목록을 정리하거나 무작위 선택을 생성할 수 있습니다.
배열 정렬 동작
정렬 작업은 기본 JavaScript 작업을 사용하여 정렬할 요소를 문자열로 변환하고 그 값을 비교합니다. 더 자세한 내용은 Mozilla의 배열 정렬 가이드를 참조하세요.
정렬 작업을 사용할 때는 다음 매개변수 및 옵션을 구성하세요:
- 유형: 드롭다운을 사용하여 정렬을 입력하는 방법을 선택합니다. 다음 옵션이 제공됩니다:
- 간단: 선택하면 정렬 기준 필드 추가 버튼을 사용하여 필드를 입력하고 오름차순 또는 내림차순으로 사용할지 선택할 수 있습니다.
- 무작위: 목록에서 무작위 순서를 생성하려면 선택합니다.
- 코드: 선택하면 정렬 작업을 수행하기 위해 사용자 정의 JavaScript 코드를 입력할 수 있는 코드 입력 필드가 표시됩니다.
- 옵션 > 필드 추가: 이를 사용하여 다음과 같은 추가 선택적 설정을 추가합니다:
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다 (형식
parent.child).
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다 (형식
제한#
수신 데이터에서 특정 수의 항목을 유지하고 처리하려면 제한 작업을 사용하면 유지할 항목 수를 선택할 수 있으며 n8n이 데이터의 시작 또는 끝에서 항목을 가져와야 하는지 여부를 지정할 수 있습니다.
제한 작업을 사용할 때는 다음 매개변수 및 옵션을 구성하세요:
- 최대 항목: n8n이 유지해야 할 최대 항목 수를 입력합니다. 입력 데이터의 개수가 이 값을 초과하면 n8n은 항목을 제거합니다.
- 유지: 항목을 제거해야 할 경우 n8n이 입력 항목을 시작 또는 끝에서 유지할지를 선택합니다.
요약#
Excel 피벗 테이블과 유사한 방식으로 항목을 집계합니다.
요약 작업을 사용할 때는 다음 매개변수 및 옵션을 구성하세요:
- 요약할 필드:
- 값을 결합하려면 집계 방법을 선택하고 필드 이름을 입력합니다.
- 값을 분할하려면 분할할 필드에 필드 이름 또는 이름 목록을 입력합니다.
- 옵션 > 필드 추가: 이를 사용하여 다음과 같은 추가 선택적 설정을 추가합니다:
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다 (형식
parent.child). - 각 분할을 별도의 항목으로: 분할 시 분할된 각 필드에 대해 별도의 출력 항목이 생성됩니다.
- 모든 분할을 단일 항목으로: 분할 시 단일 항목이 생성되며, 여기에는 분할된 필드가 나열됩니다.
- 점 표기법 비활성화: 비활성화할 경우 자식 필드를 참조할 수 없습니다 (형식