Drupal 8 Content Migrations

Summary

Learn how the migrate system works in Drupal 8 with hands-on examples. Move content into different field types including image, address, and paragraphs. No PHP coding required.

Course description

Learn how the migrate system works in Drupal 8 with hands-on examples. Move content into different field types including image, address, and paragraphs. No PHP coding required

Learn to move content into Drupal using the Migrate API. A short overview of the Extract-Transform-Load (ETL) pattern that migrate implements will be presented. Source, process, and destination plugins will be explained to learn how each affect the migration. By the end of the workshop, you will have a better understanding on how the migrate ecosystem works and the thought process required to plan and perform migrations. All examples will use YAML files to configure migrations. No PHP coding required.

Syllabus/Agenda

• Overview of the migrate API.
• Defining migration via YAML configuration files.
• Dissecting a migration: source, process, and destination plugins.
• Migrating from a JSON endpoint.
• Running migrations from the user interface.
• Using constants and pseudo fields to store temporary migrate data.
• Migrating from CSV files.
• Running migrations from the command line using Drush.
• Setting targets for sub fields.
• Defining migration dependencies.
• Reverting migrations.

Learning objectives

• Learn to run migrations from the user interface and the command line with Drush.
• Import data from CSV and JSON files.
• Transform the data to populate taxonomy, date, image, file, and address fields.
• Get content into Paragraphs.

Who Will Gain the Most From This Training?

People who want to learn the about the workflow and thought process to migrate data into Drupal 8. There will be plenty of hands on examples to demonstrate different migrate concepts and how they can be used to import data into different types of fields. Time will also be allocated to answer attendee’s project specific questions for topics not covered in the predefined material.

Prerequisites for this Course

Although no prior Migrate module knowledge is required, it is expected that you have a basic understanding of nodes, content types, and fields. You can learn about the prerequisites for the training visiting https://agaric.coop/migration-training-resources

A local Drupal 8 installation, Drush, and the availity to install modules via composer is required to attend this training. Feel free to use your existing tools (Core's built in quickstart script, Drupal Composer template, Drupal VM, DDev, Lando, Docksal, etc.) We expect all attendees come to the training with a local environment already set up. If you need help or want recommendation setting up a local development environment, feel free to send an email to ask@agaric.com

For the training we will use the following module hosted on GitHub https://github.com/dinarcon/mbe_professors Additionally, you will need to install the following contrib modules: Address, Entity reference revisions, Migrate plus, Migrate source csv, Migrate tools, and Paragraphs.

About the trainers

Agarics have been working with Drupal for over 10 years. They bring their expertise in Drupal development and migrations to projects for clients in different sectors including government, education, and NGOs. They is very passionate about teaching too. Over the last few years, Agarics have presented 25+ sessions and full day trainings in 12+ DrupalCamps and DrupalCons over America and Europe. They have developed educational material in English, Spanish, and French.

Benjamin Melançon (mlncn on drupal.org) has been working with Drupal for over 12 years. Having co-written a book on Drupal and dozens of contributed modules, he has deep understanding of Drupal internals. For client projects, Benjamin is able to use its expertise in frontend, backend, and infrastructure to make sure requirements and expectations are met. He is also a frequent speaker at DrupalCamps in North America.