X-Git-Url: http://www.aleph1.co.uk/gitweb/?a=blobdiff_plain;ds=sidebyside;f=web%2Fcore%2Fmodules%2Fmigrate%2Fsrc%2FPlugin%2Fmigrate%2Fprocess%2FSkipOnEmpty.php;fp=web%2Fcore%2Fmodules%2Fmigrate%2Fsrc%2FPlugin%2Fmigrate%2Fprocess%2FSkipOnEmpty.php;h=658d897e5124934afd3b72b6984e313eea0b2d47;hb=af6d1fb995500ae68849458ee10d66abbdcfb252;hp=c7d3ad5ea131a9d7708e247281667cbcd3732ea8;hpb=680c79a86e3ed402f263faeac92e89fb6d9edcc0;p=yaffs-website

diff --git a/web/core/modules/migrate/src/Plugin/migrate/process/SkipOnEmpty.php b/web/core/modules/migrate/src/Plugin/migrate/process/SkipOnEmpty.php
index c7d3ad5ea..658d897e5 100644
--- a/web/core/modules/migrate/src/Plugin/migrate/process/SkipOnEmpty.php
+++ b/web/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
  *