CONTENTS OF THIS FILE

• Introduction
• Requirements
• Installation
• Configuration
• Usage
• Maintainers

INTRODUCTION

Entity Migrate Export is a Drupal (8|9) to Drupal (8|9) migration generator tool. With this module, you are able to export entity instances of the specified content entity types (including their referred entities) into migrations.

Entity Migrate Export generates a module with a set of migration plugin definitions and data sources. After installing that module (its name defaults to eme_content), you will be able to import the entities (e.g. nodes, files, media, comments etc) with Migrate Tools.

REQUIREMENTS

This module does not depend on any contrib module. However, the migrations it generates (and the generated module as well) require Migrate Plus.

INSTALLATION

You can install Entity Migrate Export as you would normally install a contributed Drupal 9 module.

CONFIGURATION

The module's settings form can be found at /admin/config/development/entity-export/settings.

Configuration options:

• Machine name of the generated module (defaults to eme_content).
• Human name of the generated module (defaults to Content Entity Migration).
• The group of the generated migration plugin definitions (defaults to eme).
• The ID prefix of the generated migration plugin definitions (defaults to eme).
• The list of entity type IDs which should be ignored (nothing ignored by default).

USAGE

Exporting content

From UI

• Go to the export form at /admin/config/development/entity-export, select which type of entities do you want to export to migrations, and submit the form.
• At the end of the batch process, you will get the generated migration module.
• Extract the downloaded archive to your Drupal codebase.

With Drush

• From the project root:

  drush eme:export \
    --id my_project_dev \
    --types node,block_content

  This is equivalent with:

  drush eme:export \
    --module my_project_dev_content \
    --group my_project_dev \
    --id-prefix my_project_dev \
    --types node,block_content \
    --name 'My Project Dev Content Entity Migration' \
    --destination modules/custom

Importing content

• Install Migrate Tools, Migrate Plus and the generated module.
• Execute the migrations with Drush:

  drush migrate:import \
    --group my_project_dev \
    --execute-dependencies

Update previous export

From UI

• Go to the collection form at  /admin/config/development/entity-export/collection.
• Press the "Reexport" button of the collection you want to update with new content.

With Drush

• drush eme:export --update my_project_dev_content

MAINTAINERS

• Zoltán Horváth (huzooka) - https://www.drupal.org/user/281301