Vor einigen Tagen stießen wir auf eine spannende Herausforderung: die Migration von Absätzen von einer Drupal 7 Plattform zu Drupal 8. Während wir nach der richtigen Lösung suchten, durchkämmten wir das Web, fanden aber nichts, was perfekt zu unseren Bedürfnissen passte. Als Ergebnis haben unsere Backend-Entwickler eine maßgeschneiderte Lösung erstellt. Ein besonderer Dank geht an mtech-llc.com und Ada Hernández, deren Arbeit an der Feldsammlungsmigration diese Lösung inspiriert hat.

Während Adas ursprünglicher Artikel die Migration von Feldsammlungen beschreibt, haben wir den Ansatz für die Migration von Absätzen angepasst. Ihre Erkenntnisse erwiesen sich als unschätzbar für unseren Prozess.

Bevor Sie fortfahren, stellen Sie sicher, dass Sie haben:

1. Eine funktionierende Drupal 8 Installation

2. Die folgenden Module installiert:

migrate_drupal

migrate_plus

migrate_tools

migrate_drupal_ui

Alternativ können Sie diese als Abhängigkeiten zu Ihrem benutzerdefinierten Modul hinzufügen.

Nach der Installation der erforderlichen Module, erstellen Sie einen Absatz mit dem Bündel "Kontakt", der diese Felder enthält:

Text plain (Maschinenname: field_name)

Email (Maschinenname: field_email)

Nummer (Integer) (Maschinenname: field_phone)

Dann erstellen Sie einen Inhaltstyp namens Organisation (Maschinenname: organisation) mit:

Standard Body-Feld

Feld Absatztyp (Maschinenname: field_contact)

Dieses Verfahren ist komplex und erfordert sorgfältige Aufmerksamkeit für Details. Wenn während eines Schrittes Fehler auftreten, müssen Sie möglicherweise von vorne beginnen. Bitte lesen Sie jeden Schritt gründlich durch, bevor Sie fortfahren.

1. Datenbankverbindung in settings.php angeben

Fügen Sie die zweite Verbindung zu Drupal 7 in Ihrer settings.php Datei hinzu. In diesem Beispiel lautet der Name der Datenbank "drupal_7_56":

$databases['migrate']['default'] = array( 'database' => 'drupal_7_56', 'username' => 'root', 'password' => '', 'prefix' => '', 'host' => '127.0.0.1', 'port' => '33067', 'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql', 'driver' => 'mysql', );

2. Ein benutzerdefiniertes Modul erstellen

Erstellen Sie ein benutzerdefiniertes Modul mit dem Maschinennamen "custom".

3. YML Vorlagen erstellen

Platzieren Sie die folgenden YML Vorlagen im Ordner config/install:

Zuerst erstellen Sie die Absatz-Migrationsvorlage (Dateiname: migrate_plus.migration.d7_paragraph_contact.yml):

langcode: en status: true dependencies: {} id: d7_paragraph_contact class: null field_plugin_method: null cck_plugin_method: null migration_tags: - 'Drupal 7' migration_group: migrate_drupal_7 label: Contacts source: plugin: d7_paragraph_item key: migrate field_name: field_contact process: field_name: plugin: iterator source: field_name process: value: value revision_id: revision_id field_email: plugin: iterator source: field_email process: value: email revision_id: revision_id field_phone: plugin: iterator source: field_phone process: value: value revision_id: revision_id destination: plugin: 'entity_reference_revisions:paragraph' default_bundle: contact migration_dependencies: required: {} optional: {}

Dann erstellen Sie die Node-Migrationsvorlage (Dateiname: migrate_plus.migration.d7_node_organization.yml):

langcode: en status: true dependencies: {} id: d7_node_organization class: null field_plugin_method: null cck_plugin_method: null migration_tags: - 'Drupal 7' - Content migration_group: migrate_drupal_7 label: 'Nodes (Organization)' source: plugin: d7_node node_type: organization process: nid: nid vid: vid langcode: plugin: default_value source: language default_value: und title: title uid: node_uid status: status created: created changed: changed promote: promote sticky: sticky revision_uid: revision_uid revision_log: log revision_timestamp: timestamp body: plugin: iterator source: body process: value: value format: - plugin: static_map bypass: true source: format map: - null - plugin: skip_on_empty method: process - plugin: migration migration: - d6_filter_format - d7_filter_format source: format field_contact: - plugin: skip_on_empty method: process source: field_contact - plugin: migration_lookup migration: d7_paragraph_contact no_stub: true - plugin: iterator process: target_id: '0' target_revision_id: '1' destination: plugin: 'entity:node' default_bundle: organization migration_dependencies: required: {} optional: {}

4. Erstellen Sie die Source Plugin Klasse

Erstellen Sie eine Datei namens ContactParagraph.php im Verzeichnis /src/Plugin/migrate/source:

<?php namespace Drupal\mparagraf\Plugin\migrate\source; use Drupal\migrate\Row; use Drupal\migrate_drupal\Plugin\migrate\source\d7\FieldableEntity; /** * D7_paragraph_item source. * * @MigrateSource( * id = "d7_paragraph_item" * ) */ class ContactParagraph extends FieldableEntity { /** * {@inheritdoc} */ public function query() { // Select node in its last revision. $query = $this->select('paragraphs_item', 'fci') ->fields('fci', [ 'item_id', 'field_name', 'revision_id', ]); if (isset($this->configuration['field_name'])) { $query->innerJoin('field_data_' . $this->configuration['field_name'], 'fd', 'fd.' . $this->configuration['field_name'] . '_value = fci.item_id'); $query->fields('fd', [ 'entity_type', 'bundle', 'entity_id', $this->configuration['field_name'] . '_revision_id', ]); $query->condition('fci.field_name', $this->configuration['field_name']); } return $query; } /** * {@inheritdoc} */ public function prepareRow(Row $row) { // If field specified, get field revision ID so there aren't issues mapping. if (isset($this->configuration['field_name'])) { $row->setSourceProperty('revision_id', $row->getSourceProperty($this->configuration['field_name'] . '_revision_id')); } // Get field API field values. foreach (array_keys($this->getFields('paragraphs_item', 'contact')) as $field) { $item_id = $row->getSourceProperty('item_id'); $revision_id = $row->getSourceProperty('revision_id'); $row->setSourceProperty($field, $this->getFieldValues('paragraphs_item', $field, $item_id, $revision_id)); } return parent::prepareRow($row); } /** * {@inheritdoc} */ public function fields() { $fields = [ 'item_id' => $this->t('Item ID'), 'revision_id' => $this->t('Revision ID'), 'field_name' => $this->t('Name of field'), ]; return $fields; } /** * {@inheritdoc} */ public function getIds() { $ids['item_id']['type'] = 'integer'; $ids['item_id']['alias'] = 'fci'; return $ids; } }

5. Implementieren Sie den Migrations-Hook

Fügen Sie den folgenden Code zur .module Datei Ihres Moduls hinzu:

<?php use Drupal\migrate\Plugin\MigrationInterface; use Drupal\migrate\Plugin\MigrateSourceInterface; use Drupal\migrate\Row; /** * Implements hook_migrate_MIGRATION_ID_prepare_row(). */ function custom_migrate_d7_node_organization_prepare_row(Row $row, MigrateSourceInterface $source, MigrationInterface $migration) { $values = $row->getSourceProperty('field_contact'); $value_new = []; if ($values) { foreach ($values as $value) { $value_new[] = ['item_id' => $value['value']]; } $row->setSourceProperty('field_contact', $value_new); } }

6. Letzte Schritte

Sobald Sie alle oben genannten Schritte erfolgreich abgeschlossen haben, können Sie Ihre Migration durchführen und zusehen, wie Ihre Absätze von Drupal 7 zu Drupal 8 übertragen werden. Nehmen Sie sich einen Moment Zeit, um die Ergebnisse zu überprüfen, bevor Sie mit weiteren absatzbezogenen Aufgaben fortfahren.

Denken Sie daran, gründlich in einer Entwicklungsumgebung zu testen, bevor Sie diese Migration auf einer Produktionsseite versuchen.