From a4c93ae7dd7a0ce74b6b05cac102c386000e404e Mon Sep 17 00:00:00 2001 From: Gabor Hojtsy Date: Sat, 13 Jan 2018 07:24:21 +0100 Subject: [PATCH] Issue #2933773 by masipila, quietone: Merge handbook documentation to API: skip_on_empty process plugin (cherry picked from commit 36ea4d333d34a4154b4da6d8110325f2d3a53e46) --- .../Plugin/migrate/process/SkipOnEmpty.php | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/core/modules/migrate/src/Plugin/migrate/process/SkipOnEmpty.php b/core/modules/migrate/src/Plugin/migrate/process/SkipOnEmpty.php index c7d3ad5ea13..658d897e512 100644 --- a/core/modules/migrate/src/Plugin/migrate/process/SkipOnEmpty.php +++ b/core/modules/migrate/src/Plugin/migrate/process/SkipOnEmpty.php @@ -22,8 +22,8 @@ use Drupal\migrate\MigrateSkipRowException; * - process: Prevents further processing of the input property when the value * is empty. * - 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 - * set, nothing is logged in the message table. + * for this row. Messages are only logged for the 'row' method. If not set, + * nothing is logged in the message table. * * Examples: * @@ -33,11 +33,10 @@ use Drupal\migrate\MigrateSkipRowException; * plugin: skip_on_empty * method: row * source: field_name - * message: 'Field field_name is missed' + * message: 'Field field_name is missing' * @endcode - * - * If field_name is empty, skips the entire row and the message 'Field - * field_name is missed' is logged in the message table. + * If 'field_name' is empty, the entire row is skipped and the message 'Field + * field_name is missing' is logged in the message table. * * @code * process: @@ -47,12 +46,13 @@ use Drupal\migrate\MigrateSkipRowException; * method: process * source: parent * - - * plugin: migration + * plugin: migration_lookup * migration: d6_taxonomy_term * @endcode - * - * If parent is empty, any further processing of the property is skipped - thus, - * the next plugin (migration) will not be run. + * If 'parent' is empty, any further processing of the property is skipped and + * the next process plugin (migration_lookup) will not be run. Combining + * 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 *