How to debug Drupal migrations? - Part 2

Submitted by dinarcon on Wed, 08/28/2019 - 23:00

In the previous article we began talking about debugging Drupal migrations. We gave some recommendations of things to do before diving deep into debugging. We also introduced the `log` process plugin. Today, we are going to show how to use the Migrate Devel module and the `debug` process plugin. Then we will give some guidelines on using a real debugger like XDebug. Next, we will share tips so you get used to migration errors. Finally, we are going to briefly talk about the `migrate:fields-source` Drush command. Let’s get started.

How to debug Drupal migrations? - Part 1

Submitted by dinarcon on Tue, 08/27/2019 - 23:00

Throughout the series we have showed many examples. I do not recall any of them working on the first try. When working on Drupal migrations, it is often the case that things do not work right away. Today’s article is the first of a two part series on debugging Drupal migrations. We start giving some recommendations of things to do before diving deep into debugging. Then, we are going to talk about migrate messages and presented the `log` process plugin. Let’s get started.

Understanding the entity_lookup and entity_generate process plugins from Migrate Tools

Submitted by dinarcon on Mon, 08/26/2019 - 23:00

In recent posts we have explored the Migrate Plus and Migrate Tools modules. They extend the Migrate API to provide migrations defined as configuration entities, groups to share configuration among migrations, a user interface to execute migrations, among other things. Yet another benefit of using Migrate Plus is the option to leverage the many process plugins it provides. Today, we are going to learn about two of them: `entity_lookup` and `entity_generate`. We are going to compare them with the `migration_lookup` plugin, show how to configure them, and explain their compromises and limitations. Let’s get started.

Executing Drupal migrations from the user interface with Migrate Tools

Submitted by dinarcon on Sun, 08/25/2019 - 23:00

In previous posts we introduced the concept of defining migrations as configuration entities. This type of migrations can be executed from a user interface provided by the Migrate Tools module. In today’s article, we will present the workflow to import configuration entities and execute migrations from the user interface. Let’s get started.

What is the difference between migration tags and migration groups in Drupal?

Submitted by dinarcon on Sat, 08/24/2019 - 23:00

In the previous post we talked about migration groups provided by the Migrate Plus module. Today, we are going to compare them to migration tags. Along the way, we are going to dive deeper into how they work and provide tips to avoid problems when working with them. Let’s get started.

Tags

Using migration groups to share configuration among Drupal migrations

Submitted by dinarcon on Fri, 08/23/2019 - 23:00

In the previous posts we talked about option to manage migrations as configuration entities and some of the benefits this brings. Today, we are going to learn another useful feature provided by the Migrate Plus module: migration groups. We are going to see how they can be used to execute migrations together and share configuration among them. Let’s get started.

Workflows and benefits of managing Drupal migrations as configuration entities

Submitted by dinarcon on Thu, 08/22/2019 - 23:00

In the last blog post we were introduced to managing migration as configuration entities using Migrate Plus. Today, we will present some benefits and potential drawbacks of this approach. We will also show a recommended workflow for working with migration as configuration. Let’s get started.

Defining Drupal migrations as configuration entities with the Migrate Plus module

Submitted by dinarcon on Wed, 08/21/2019 - 23:00

Last updated on May 15, 2020.

Today, we are going to talk about how to manage migrations as configuration entities. This functionality is provided by the Migrate Plus module. First, we will explain the difference between managing migrations as code or configuration. Then, we will show how to convert existing migrations. Finally, we will talk about some important options to include in migration configuration entities. Let’s get started.

Migrating Microsoft Excel and LibreOffice Calc files into Drupal

Submitted by dinarcon on Tue, 08/20/2019 - 23:00

Today we will learn how to migrate content from Microsoft Excel and LibreOffice Calc files into Drupal using the Migrate Spreadsheet module. We will give instructions on getting the module and its dependencies. Then, we will present how to configure the module for spreadsheets with or without a header row. There are two example migrations: images and paragraphs. Let’s get started.

Migrating Google Sheets into Drupal

Submitted by dinarcon on Mon, 08/19/2019 - 23:00

Today we will learn how to migrate content from Google Sheets into Drupal using the Migrate Google Sheets module. We will give instructions on how to publish them in JSON format to be consumed by the migration. Then, we will talk about some assumptions made by the module to allow easier plugin configurations. Finally, we will present the source plugin configuration for Google Sheets migrations. Let’s get started.