From 36ea4d333d34a4154b4da6d8110325f2d3a53e46 Mon Sep 17 00:00:00 2001
From: Gabor Hojtsy <gabor@hojtsy.hu>
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
---
.../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 c7d3ad5ea131..658d897e5124 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 @@
* - 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 @@
* 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 @@
* 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
*
--
GitLab