Leanpub Header

Skip to main content
Go to Leanpub.comLeanpub

31 days of Drupal migrations

Mauricio Dinarte

A book explaining Migrate API concepts for Drupal 8/9 and beyond.

Minimum price

$12.50

$31.00

You pay

$31.00

Author earns

$24.80
$

...Or Buy With Credits!

You can get credits monthly with a Reader Membership
PDF
EPUB
WEB
259
Readers
193
Pages
About

About

About the Book

This book covers Migrate API concepts for Drupal 8/9 and beyond. Examples include migrating from different sources into different destination types. It also includes tips on running migration projects and debugging issues. You can read the full series online at https://understanddrupal.com/31-days-of-migrations If you are able to pay for the eBook version of the series, your purchase will support keeping the content and examples up to date.

Share this book

Categories

PHPComputer ScienceComputers and Programming

Feedback

Contact the author

Author

About the Author

Mauricio Dinarte

Mauricio Dinarte is creating web development educational material in multiple languages.

At https://understanddrupal.com/ we are producing Drupal tutorials in English, Spanish, and French. We would appreciate your support in keeping this educational project moving forward.

Contents

Table of Contents

Understand Drupal Migrations Course

  1. Content
  2. Testimonials

Drupal migrations: Understanding the ETL process

  1. Understanding the ETL process
  2. Drupal migrations: a two step process

Writing your first Drupal migration

  1. Writing the migration definition file
  2. Running the migration

Using process plugins for data transformation in Drupal migrations

  1. Syntactic sugar
  2. Providing default values
  3. Concatenating values
  4. Chaining process plugins

Migrating data into Drupal subfields

  1. Getting the example code
  2. Migrating formatted text
  3. Migrating images
  4. Which subfields are available?
  5. Default subfields

Using constants and pseudofields as data placeholders in the Drupal migration process pipeline

  1. Setting and using source constants
  2. Setting and using pseudofields
  3. Understanding Drupal Migrate API process pipeline
  4. Migrating images using the image_import plugin

Tips for writing Drupal migrations and understanding their workflow

  1. Importing and rolling back migrations
  2. Stopping and resetting migrations
  3. What happens when you rollback a Drupal migration?
  4. Re-import or update migrations
  5. Tips for writing Drupal migrations

Migrating files and images into Drupal

  1. File entity migrate destination
  2. Source section definition
  3. Process section definition
  4. Skipping invalid records
  5. Creating the destination URI
  6. Creating the source URI
  7. Copying the image file to Drupal

Introduction to migration dependencies in Drupal

  1. Breaking up migrations
  2. Writing the source and destination definition
  3. Using previously imported files in image fields
  4. Being explicit about migration dependencies
  5. Tagging migrations

Migrating taxonomy terms and multivalue fields into Drupal

  1. Getting the code
  2. Migrating taxonomy terms and their hierarchy
  3. Migrating multivalue taxonomy terms fields
  4. More syntactic sugar

Migrating users into Drupal - Part 1

  1. Getting the code
  2. Understanding the source
  3. Configuring the destination and dependencies
  4. Processing the fields

Migrating users into Drupal - Part 2

  1. Getting the code
  2. Migrating user creation date
  3. Migrating user roles
  4. Migrating profile pictures

Migrating dates into Drupal

  1. Getting the code
  2. PHP date format characters
  3. Date format conversions
  4. Node creation time migration
  5. Date only migration
  6. Date range migration
  7. Datetime migration
  8. Things to consider

Migrating addresses into Drupal

  1. Getting the code
  2. Source and destination sections
  3. Available subfields
  4. Address subfield mappings
  5. Finding expected values
  6. The commerceguys addressing library
  7. Migrating country and zone fields

Introduction to paragraphs migrations in Drupal

  1. Getting the code
  2. Understanding the example set up
  3. The paragraph migration
  4. The node migration
  5. Paragraph field mappings
  6. Do migrated paragraphs disappear upon node rollback?

Migrating CSV files into Drupal

  1. Getting the code
  2. Understanding the example set up
  3. Migrating CSV files with a header row
  4. Migrating CSV files without a header row
  5. CSV file location
  6. CSV source plugin configuration

Migrating JSON files into Drupal

  1. Getting the code
  2. Understanding the example set up
  3. Migrating nodes from a JSON file
  4. Migrating paragraphs from a JSON file
  5. Migrating images from a JSON file
  6. JSON file location
  7. Migrating remote JSON files

Migrating XML files into Drupal

  1. Getting the code
  2. Understanding the example set up
  3. Migrating nodes from a XML file
  4. Migrating paragraphs from a XML file
  5. Migrating images from a XML file
  6. XML file location
  7. Migrating remote XML files
  8. XMLReader vs SimpleXML in Drupal migrations

Adding HTTP request headers and authentication to remote JSON and XML in Drupal migrations

  1. Migrate Plus architecture for remote data fetching
  2. JSON and XML Drupal migrations with HTTP request headers and Basic authentication.
  3. JSON and XML Drupal migrations with HTTP request headers and Digest authentication.
  4. JSON and XML Drupal migrations with HTTP request headers and OAuth2 authentication

Migrating Google Sheets into Drupal

  1. Getting the code
  2. Understanding the example set up
  3. Migrating nodes from Google Sheets
  4. Publishing a Google Sheet in JSON format
  5. Understanding the published Google Sheet JSON export
  6. Configuring the Migrate Google Sheets source plugin

Migrating Microsoft Excel and LibreOffice Calc files into Drupal

  1. Getting the code
  2. Understanding the example set up
  3. Understanding the source document and plugin configuration
  4. Migrating spreadsheet files with a header row
  5. Migrating spreadsheet files without a header row

Defining Drupal migrations as configuration entities with the Migrate Plus module

  1. Drupal migrations: code or configuration?
  2. Transitioning to configuration entities
  3. UUIDs for migration configuration entities
  4. Automatically deleting migration configuration entities

Workflows and benefits of managing Drupal migrations as configuration entities

  1. What is the benefit of managing migration as configurations?
  2. Are there any drawbacks?
  3. Workflow for managing migrations as configuration entities

Using migration groups to share configuration among Drupal migrations

  1. Understanding migration groups
  2. Creating a migration group
  3. Organizing and executing migrations
  4. Sharing configuration with migration groups

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

  1. What is the difference between migration tags and migration groups?
  2. What do migration tags and groups have in common?
  3. Can groups only be used for migrations defined as configuration entities?
  4. Setting migration tags inside migration groups

Executing Drupal migrations from the user interface with Migrate Tools

  1. Getting the example code
  2. Importing configuration entities from the user interface
  3. Executing configuration entities from the user interface
  4. Limitations of the user interface

Understanding the entity_lookup and entity_generate process plugins from Migrate Tools

  1. What is the difference among the migration_lookup, entity_lookup, entity_generate plugins?
  2. Getting the example code
  3. Using the entity_lookup to assign the node author
  4. Using the entity_generate to assign and create taxonomy terms
  5. More configuration options
  6. Compromises and limitations

How to debug Drupal migrations? - Part 1

  1. Minimizing the surface for errors
  2. What to check first?
  3. Migration messages
  4. The log process plugin

How to debug Drupal migrations? - Part 2

  1. The migrate_devel module
  2. The debug process plugin
  3. Using the right tool for the job: a debugger
  4. If it is not broken, break it on purpose
  5. The migrate:fields-source Drush command

How to configure XDebug, PHPStorm, and DrupalVM to debug Drupal migrations via Drush commands and the browser?

  1. Getting DrupalVM
  2. Configuring PHPStorm
  3. Triggering the breakpoint
  4. Debugging from the user interface

List of migration related Drupal modules

  1. Core modules
  2. Migration runners
  3. Source plugins
  4. Destination plugins
  5. Development related
  6. Field and module related
  7. Modules created by Tess Flynn (socketwench)
  8. Miscellaneous

Introduction to Drupal 8 upgrades

  1. What is a Drupal upgrade?
  2. Preparing your migration
  3. Customizing your migration
  4. Performing the upgrade
  5. Known issues and limitations
  6. Upgrade paths for contributed modules
  7. Upgrade strategies
  8. What about upgrading to Drupal 9?

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

Now, this is technically risky for us, since you'll have the book or course files either way. But we're so confident in our products and services, and in our authors and readers, that we're happy to offer a full money back guarantee for everything we sell.

You can only find out how good something is by trying it, and because of our 100% money back guarantee there's literally no risk to do so!

So, there's no reason not to click the Add to Cart button, is there?

See full terms...

Earn $8 on a $10 Purchase, and $16 on a $20 Purchase

We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earned over $14 million writing, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub