From 412c5475ed8d3a4afef563f8dd38a4e12dc9dd0e Mon Sep 17 00:00:00 2001
From: Damien McKenna <9131-damienmckenna@users.noreply.drupalcode.org>
Date: Wed, 15 Feb 2023 10:25:27 -0600
Subject: [PATCH] Issue #3331121 by DamienMcKenna, heddn: Extra documentation
 for SkipOnValue for Field API values

---
 src/Plugin/migrate/process/SkipOnValue.php | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/Plugin/migrate/process/SkipOnValue.php b/src/Plugin/migrate/process/SkipOnValue.php
index 2550ea65..56dc72c8 100644
--- a/src/Plugin/migrate/process/SkipOnValue.php
+++ b/src/Plugin/migrate/process/SkipOnValue.php
@@ -44,6 +44,19 @@ use Drupal\migrate\Row;
  * The above example will skip further processing of the input property if
  * the content_type source field equals "blog".
  *
+ * Example usage with a FieldAPI value:
+ * @code
+ *   field_fruit:
+ *     plugin: skip_on_value
+ *     source: field_fruit/0/value
+ *     method: row
+ *     value: apple
+ * @endcode
+ * The above example will skip the entire row if the "fruit" field is set to
+ * "apple". When attempting to access values from a simple Field API-based value
+ * the "0/value" suffix must be used, otherwise it will fail with an "Array to
+ * string conversion" error.
+ *
  * Example usage with full configuration:
  * @code
  *   type:
-- 
GitLab