forked from n8n-io/n8n-docs
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request n8n-io#1771 from n8n-io/NODE-967-item-lists
add new data transformation actions; deprecate item lists
- Loading branch information
Showing
17 changed files
with
225 additions
and
15 deletions.
There are no files selected for viewing
1 change: 1 addition & 0 deletions
1
...ntegrations/builtin/core-nodes/data-transformation-actions/data-section-link.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| Learn more about [data structure and data flow](/data/) in n8n workflows. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
35 changes: 35 additions & 0 deletions
35
docs/integrations/builtin/core-nodes/n8n-nodes-base.aggregate.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,35 @@ | ||
| --- | ||
| title: Aggregate | ||
| description: Documentation for the Aggregate node in n8n, a workflow automation platform. Includes guidance on usage, and links to examples. | ||
| --- | ||
|
|
||
| # Aggregate | ||
|
|
||
| Use the Aggregate node to take separate items, or portions of them, and group them together into individual items. | ||
|
|
||
|
|
||
| /// note | Examples and templates | ||
| For usage examples and templates to help you get started, refer to n8n's [Aggregate integrations](https://n8n.io/integrations/aggregate/){:target=_blank .external-link} page. | ||
| /// | ||
|
|
||
| ## Node parameters | ||
|
|
||
| * **Aggregate**: choose whether to aggregate **Individual Fields** or **All Item Data**. | ||
| * If you choose **Individual Fields**, you can then configure the fields you want to aggregat with the following parameters: | ||
| * **Input Field Name**: the name of the field in the input data to be aggregated together. | ||
| * **Rename Field**: enable this toggle to enter a field name for the aggregated output data. When aggregating multiple fields you must provide new output field names. You can't leave multiple fields undefined. | ||
| * **Output Field Name**: displayed when you enable **Rename Field**. The field name for the aggregated output data. | ||
| * **Options** > **Add Field**: use this to add more optional settings, including: | ||
| * **Disable Dot Notation**: when disabled, you can't reference child fields (in the format `parent.child`). | ||
| * **Merge Lists**: enable this if the field to aggregate is a list, and you want to output a single flat list rather than a list of lists. | ||
| * **Include Binaries**: include binary data from the input in the new output. | ||
| * **Keep Missing And Null Values**: enable this to add a null (empty) entry in the output list when there is a null or missing value in the input. | ||
| * If you choose **All Item Data**, you can then set: | ||
| * **Put Output in Field**: the name of the output field. | ||
| * **Include**: choose from **All fields**, **Specified Fields**, or **All Fields Except**. | ||
|
|
||
| ## Related resources | ||
|
|
||
| View [example workflows and related content](https://n8n.io/integrations/aggregate/){:target=_blank .external-link} on n8n's website. | ||
|
|
||
| --8<-- "_snippets/integrations/builtin/core-nodes/data-transformation-actions/data-section-link.md" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
24 changes: 24 additions & 0 deletions
24
docs/integrations/builtin/core-nodes/n8n-nodes-base.limit.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,24 @@ | ||
| --- | ||
| title: Limit | ||
| description: Documentation for the Limit node in n8n, a workflow automation platform. Includes guidance on usage, and links to examples. | ||
| --- | ||
|
|
||
| # Limit | ||
|
|
||
| Use the Limit node to remove items beyond a defined maximum number. You can choose whether n8n takes the items from the beginning or end of the input data. | ||
|
|
||
|
|
||
| /// note | Examples and templates | ||
| For usage examples and templates to help you get started, refer to n8n's [Limit integrations](https://n8n.io/integrations/limit/){:target=_blank .external-link} page. | ||
| /// | ||
|
|
||
| ## Node parameters | ||
|
|
||
| * **Max Items**: enter the maximum number of items that n8n should keep. If the input data contains more than this value, n8n removes the items. | ||
| * **Keep**: when items must be removed, select if n8n keeps the input items at the beginning or end. | ||
|
|
||
| ## Related resources | ||
|
|
||
| View [example workflows and related content](https://n8n.io/integrations/limit/){:target=_blank .external-link} on n8n's website. | ||
|
|
||
| --8<-- "_snippets/integrations/builtin/core-nodes/data-transformation-actions/data-section-link.md" |
29 changes: 29 additions & 0 deletions
29
docs/integrations/builtin/core-nodes/n8n-nodes-base.removeduplicates.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,29 @@ | ||
| --- | ||
| title: Remove Duplicates | ||
| description: Documentation for the Remove Duplicates node in n8n, a workflow automation platform. Includes guidance on usage, and links to examples. | ||
| --- | ||
|
|
||
| # Remove Duplicates | ||
|
|
||
| Use the Remove Duplicates node to identify items that are identical across all fields or a subset of fields. This is helpful in situations where you can end up with duplicate data, such as a user creating multiple accounts, or a customer submitting the same order multiple times. When working with large datasets it becomes more difficult to spot and remove these items. | ||
|
|
||
| /// note | Examples and templates | ||
| For usage examples and templates to help you get started, refer to n8n's [Remove Duplicates integrations](https://n8n.io/integrations/remove-duplicates/){:target=_blank .external-link} page. | ||
| /// | ||
|
|
||
| ## Node parameters | ||
|
|
||
| * **Compare**: specify which fields of the input data n8n should compare to check if they're the same. The following options are available: | ||
| * **All Fields**: compares all fields of the input data. | ||
| * **All Fields Except**: enter which input data fields n8n should exclude from the comparison. You can provide multiple values separated by commas. | ||
| * **Selected Fields**: enter which input data fields n8n should include in the comparison. You can provide multiple values separated by commas. | ||
| * If you choose **All Fields Except** or **Selected Fields**, n8n displays **Options** > **Add Field**. Use this to add more optional settings, including: | ||
| * **Disable Dot Notation**: when disabled, you can't reference child fields (in the format `parent.child`). | ||
| * **Remove Other Fields**: keep the fields that you're comparing and remove the others. | ||
|
|
||
|
|
||
| ## Related resources | ||
|
|
||
| View [example workflows and related content](https://n8n.io/integrations/remove-duplicates/){:target=_blank .external-link} on n8n's website. | ||
|
|
||
| --8<-- "_snippets/integrations/builtin/core-nodes/data-transformation-actions/data-section-link.md" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
31 changes: 31 additions & 0 deletions
31
docs/integrations/builtin/core-nodes/n8n-nodes-base.sort.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| --- | ||
| title: Sort | ||
| description: Documentation for the Sort node in n8n, a workflow automation platform. Includes guidance on usage, and links to examples. | ||
| --- | ||
|
|
||
| # Sort | ||
|
|
||
| Use the Sort node to organize lists of items in a desired ordering, or generate a random selection. | ||
|
|
||
| /// note | Examples and templates | ||
| For usage examples and templates to help you get started, refer to n8n's [Sort integrations](https://n8n.io/integrations/sort/){:target=_blank .external-link} page. | ||
| /// | ||
|
|
||
| /// note | Array sort behavior | ||
| The Sort operation uses the default JavaScript operation where the elements to be sorted are converted into strings and their values compared. Refer to [Mozilla's guide to Array sort](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort){:target=_blank .external-link} to learn more. | ||
| /// | ||
|
|
||
| ## Node parameters | ||
|
|
||
| * **Type**: use the dropdown to select how you want to input the sorting. The following options are available: | ||
| * **Simple**: when you selected, you can use the **Add Field To Sort By** button to input the fields, and select whether to use **Ascending** or **Descending** order. | ||
| * **Random**: select to create a random order in the list. | ||
| * **Code**: when selected, displays a code input field where you can enter custom JavaScript code to perform the sort operation. | ||
| * **Options** > **Add Field**: use this to add more optional settings, including: | ||
| * **Disable Dot Notation**: when disabled, you can't reference child fields (in the format `parent.child`). | ||
|
|
||
| ## Related resources | ||
|
|
||
| View [example workflows and related content](https://n8n.io/integrations/sort/){:target=_blank .external-link} on n8n's website. | ||
|
|
||
| --8<-- "_snippets/integrations/builtin/core-nodes/data-transformation-actions/data-section-link.md" |
31 changes: 31 additions & 0 deletions
31
docs/integrations/builtin/core-nodes/n8n-nodes-base.splitout.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| --- | ||
| title: Split Out | ||
| description: Documentation for the Split Out node in n8n, a workflow automation platform. Includes guidance on usage, and links to examples. | ||
| --- | ||
|
|
||
| # Split Out | ||
|
|
||
| Use the Split Out node to separate a single data item containing a list into multiple items. For example, a list of customers, and you want to split them so that you have an item for each customer. | ||
|
|
||
| /// note | Examples and templates | ||
| For usage examples and templates to help you get started, refer to n8n's [Split Out integrations](https://n8n.io/integrations/split-out/){:target=_blank .external-link} page. | ||
| /// | ||
|
|
||
| ## Node parameters | ||
|
|
||
| * **Field to Split Out**: the field containing the list you want to separate out into individual items. | ||
| * If working with binary data inputs, use `$binary` in an expression to set the field to split out. | ||
| * **Include**: select if you want n8n to keep any other fields from the input data with each new individual item. You can select: | ||
| * **No Other Fields** | ||
| * **All Other Fields** | ||
| * **Selected Other Fields**: when selected, n8n displays **Fields to Include**. Enter a comma separated list of desired fields. | ||
| * **Options** > **Add Field**: use this to add more optional settings, including: | ||
| * **Disable Dot Notation**: when disabled, you can't reference child fields (in the format `parent.child`). | ||
| * **Destination Field Name**: optionally set the field name under which to put the new split contents. | ||
| * **Include Binary**: include binary data from the input in the new output. | ||
|
|
||
| ## Related resources | ||
|
|
||
| View [example workflows and related content](https://n8n.io/integrations/split-out/){:target=_blank .external-link} on n8n's website. | ||
|
|
||
| --8<-- "_snippets/integrations/builtin/core-nodes/data-transformation-actions/data-section-link.md" |
31 changes: 31 additions & 0 deletions
31
docs/integrations/builtin/core-nodes/n8n-nodes-base.summarize.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| --- | ||
| title: Summarize | ||
| description: Documentation for the Summarize node in n8n, a workflow automation platform. Includes guidance on usage, and links to examples. | ||
| --- | ||
|
|
||
| # Summarize | ||
|
|
||
| Use the Summarize node to aggregate items together, in a manner similar to Excel pivot tables. | ||
|
|
||
| /// note | Examples and templates | ||
| For usage examples and templates to help you get started, refer to n8n's [Summarize integrations](https://n8n.io/integrations/summarize/){:target=_blank .external-link} page. | ||
| /// | ||
|
|
||
| ## Node parameters | ||
|
|
||
| * **Fields to Summarize**: | ||
| * To combine values, select an **Aggregation** method, and enter a **Field** name. | ||
| * To split values, enter a field name or list of names in **Fields to Split By**. | ||
| * **Options** > **Add Field**: use this to add more optional settings, including: | ||
| * **Disable Dot Notation**: when disabled, you can't reference child fields (in the format `parent.child`). | ||
| * **Output Format**: | ||
| * **Each Split in a Separate Item**: splitting generates a separate output item for each split out field. | ||
| * **All Splits in a Single Item**: splitting generates a single item, which lists the split out fields. | ||
| * **Ignore items without valid fields to group by**: ignore input items that don't contain the field specified in **Fields to Summarize**. | ||
|
|
||
|
|
||
| ## Related resources | ||
|
|
||
| View [example workflows and related content](https://n8n.io/integrations/summarize/){:target=_blank .external-link} on n8n's website. | ||
|
|
||
| --8<-- "_snippets/integrations/builtin/core-nodes/data-transformation-actions/data-section-link.md" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.