Drupal
/
drupal
mirror of https://git.drupalcode.org/project/drupal.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Issue #2933773 by masipila, quietone: Merge handbook documentation to API: skip_on_empty process plugin 

(cherry picked from commit 36ea4d333d)
merge-requests/1654/head
Gabor Hojtsy 2018-01-13 07:24:21 +01:00
parent a8de786572
commit a4c93ae7dd
1 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
core/modules/migrate/src/Plugin/migrate/process/SkipOnEmpty.php
View File

@ -22,8 +22,8 @@ use Drupal\migrate\MigrateSkipRowException;
* - process: Prevents further processing of the input property when the value * - process: Prevents further processing of the input property when the value
* is empty. * is empty.
* - message: (optional) A message to be logged in the {migrate_message_*} table * - message: (optional) A message to be logged in the {migrate_message_*} table
* for this row. Messages are only logged for the 'row' skip level. If not * for this row. Messages are only logged for the 'row' method. If not set,
* set, nothing is logged in the message table. * nothing is logged in the message table.
* *
* Examples: * Examples:
* *
@ -33,11 +33,10 @@ use Drupal\migrate\MigrateSkipRowException;
* plugin: skip_on_empty * plugin: skip_on_empty
* method: row * method: row
* source: field_name * source: field_name
* message: 'Field field_name is missed' * message: 'Field field_name is missing'
* @endcode * @endcode
* * If 'field_name' is empty, the entire row is skipped and the message 'Field
* If field_name is empty, skips the entire row and the message 'Field * field_name is missing' is logged in the message table.
* field_name is missed' is logged in the message table.
* *
* @code * @code
* process: * process:
@ -47,12 +46,13 @@ use Drupal\migrate\MigrateSkipRowException;
* method: process * method: process
* source: parent * source: parent
* - * -
* plugin: migration * plugin: migration_lookup
* migration: d6_taxonomy_term * migration: d6_taxonomy_term
* @endcode * @endcode
* * If 'parent' is empty, any further processing of the property is skipped and
* If parent is empty, any further processing of the property is skipped - thus, * the next process plugin (migration_lookup) will not be run. Combining
* the next plugin (migration) will not be run. * skip_on_empty and migration_lookup is a typical process pipeline combination
* for hierarchical entities where the root entity does not have a parent.
* *
* @see \Drupal\migrate\Plugin\MigrateProcessInterface * @see \Drupal\migrate\Plugin\MigrateProcessInterface
* *