By quietone on
Change record status: 
Published (View all published change records)
Project: 
Drupal core
Introduced in branch: 
8.2.x
Introduced in version: 
8.2.4
Issue links: 
https://www.drupal.org/node/2690001
Description: 

The dedupe_entity process plugin is used to ensure that an entity has a unique value in the given field, normally the id field. If an entity already exists with the given input value in the given field, a new deduplicated value is created before saving the entity. Thus saving the entity to a deduplicated id value and preserving any existing entity with that id. For example, if the input value was 'notes' then the new value would be 'notes1'. This behavior can now be changed using the optional 'migrated' option. If the 'migrated' configuration value is not empty the relevant map table is checked to see if the entity was migrated. And if the entity was migrated then input value will not be deduplicated.

Example with new migrated configuration option:

-  vid:
   -
      plugin: machine_name
      source: name
   -
      plugin: dedupe_entity
      entity_type: taxonomy_vocabulary
      field: vid
      length: 32
      migrated: true

If vid = 'notes' and a taxonomy vocabulary 'notes' has been migrated then vid will remain 'notes'.

Impacts: 
Module developers