diff --git a/docs/automation/entity-mapping.md b/docs/automation/entity-mapping.md index 97d7149..215dced 100644 --- a/docs/automation/entity-mapping.md +++ b/docs/automation/entity-mapping.md @@ -7,11 +7,9 @@ sidebar_position: 4 [[API Docs](/api/automation#tag/flows)] [[SDK](https://www.npmjs.com/package/@epilot/automation-client)] -> Entity Mapping is an advanced feature available only for certain pricing tiers. -> -> Please contact epilot support to enable advanced automation features +> These docs describe the advanced, low code Entity Mapping Feature. If you are looking for the no code solution, you can check out the docs [here](https://help.epilot.cloud/automatisierungen-und-mapping/6304301252242-Mapping-Zuordnung-von-Journey-Daten-zu-Entit%25C3%25A4ten?from_search=202771407). -The **Create/Edit Entity** action allows mapping data from one entity to create or update other entities. +The **Create/Edit Entity (Advanced)** action allows mapping data from one entity to create or update other entities. ![MapEntityAction](../../static/img/MapEntityAction.png) @@ -117,6 +115,16 @@ The `_append` operation adds new values to an array. } ``` +### `_prepend` + +The `_prepend` operation adds new values to *the start* of an array. + +```json +// prepend strings "tag1", "tag2" to the beginning of an array +{ + "_prepend": ["tag1", "tag2"] +} +``` ### `_uniq` @@ -132,7 +140,7 @@ The `_uniq` operation makes sure all items in an array are unique. For arrays with objects, you can define a unique key to be used. -Duplicate objects are deeply merged. +Duplicate objects are deeply merged retaining the old values. If a matching object was found, and the values should overwrite the found element, we can additionally set `_retain_old_values` to `false` ```json // append addresses, make sure each item is unique @@ -145,7 +153,8 @@ Duplicate objects are deeply merged. "city": { "_copy": "submission.city" } } ], - "_uniq": ["street", "street_number", "postal_code", "city"] + "_uniq": ["street", "street_number", "postal_code", "city"], + "_retain_old_values": false } ``` diff --git a/static/img/MapEntityAction.png b/static/img/MapEntityAction.png index 51ecf8e..6ed4783 100644 Binary files a/static/img/MapEntityAction.png and b/static/img/MapEntityAction.png differ diff --git a/static/img/automation-add-mapping.png b/static/img/automation-add-mapping.png index 10a8675..24fd8fc 100644 Binary files a/static/img/automation-add-mapping.png and b/static/img/automation-add-mapping.png differ diff --git a/static/img/automation-relation-labels.png b/static/img/automation-relation-labels.png index fe03b7c..09d2339 100644 Binary files a/static/img/automation-relation-labels.png and b/static/img/automation-relation-labels.png differ diff --git a/static/img/automation-relation.png b/static/img/automation-relation.png index 5faab12..51484b4 100644 Binary files a/static/img/automation-relation.png and b/static/img/automation-relation.png differ diff --git a/static/img/automation-select-target.png b/static/img/automation-select-target.png index 3e552db..5714477 100644 Binary files a/static/img/automation-select-target.png and b/static/img/automation-select-target.png differ diff --git a/static/img/mapping-example.png b/static/img/mapping-example.png index 3525c2f..0aac3a6 100644 Binary files a/static/img/mapping-example.png and b/static/img/mapping-example.png differ diff --git a/static/img/opportunity-relation-labels.png b/static/img/opportunity-relation-labels.png index fe7052e..1268969 100644 Binary files a/static/img/opportunity-relation-labels.png and b/static/img/opportunity-relation-labels.png differ