XML-D8 Migration: Very basic migration by just using YML file

As we are working XML to Drupal 8 migration project, so we just want to explore how the very basic migration looks like!

We have written a custom module to define mapping between XML data and Drupal 8 entity.

Like any other module in D8, we need .info.yml file which looks like below,

https://github.com/amitgoyal/migrate_xml_d8_custom/blob/master/migrate_xml_d8_custom.info.yml
In the .info.yml file, we have added dependencies for migrate_plus and migrate_tools modules. Migrate Plus module is required to do migration from sources like XML and JSON. Migrate Tools module provides tools for running and managing Drupal 8 migrations.

As we are migration from XML so we have created a sample XML file which contains ID, Title and Body fields. It looks like below,


Lastly and most importantly, for this very basic migration, we just needed one .yml file in config/install folder for our migration. This .yml file defines Source (XML file and fields in it), Destination (Drupal entity) and Field mappings (Process plugins). It looks like below,

https://github.com/amitgoyal/migrate_xml_d8_custom/blob/master/config/install/migrate_plus.migration.pages_content.yml

We have placed the source XML file (pages_content.xml) in Drupal root folder. After enabling the module, we have executed the migration using Drush like below,


XML file contained 3 records which have been migrated to Drupal site using Drush. We can see below that 3 records have been created on Drupal 8 site.



The source code is also available on Git repository.

Please note that in case you make any changes in .yml file under config/install/ after enabling the module then you have to uninstall the module first and then enable it again. Otherwise your changes will not be reflected. In such cases you also need to delete a record from config table using below SQL command,

DELETE FROM `config` WHERE `name` LIKE '%pages_content%';

To avoid deleting the record manually, we can use hook_uninstall() in .module file.

You can also explore more on migration from various resources in migrate_example_advanced module under migrate_tools module.

Comments

Post a Comment

Popular posts from this blog

Simple Meditation

Set small goals, such as meditating for two minutes every morning. When that feels OK, up the time to 5, 10 or 20 minutes. 1) Find a comfortable seat - where you can sit up tall, either crosslegged on the floor or in a chair. Close your eyes or soften the gaze so you are not focusing on anything in particular. Place the hands with the palms down on the tops of the thighs. 2) Take a moment to notice the sensation of sitting - become aware of the ground or chair beneath you, and the parts of your body in contact with them. Now bring your focus to your hands, noticing the weight of them on the thighs, and the feel of the fabric of your clothes.  3) Now begin to notice how your breath feels in your body as you inhale and exhale. Make no effort to change the breath, simply let your natural breath flow in and out. 4) Aim to stay focussed on these sensations of the breath, but when you notice the mind wandering, acknowledge the thought, then come back to the breath again.  5) When yo...
Read more

Custom MySQL Database to Drupal 8 Migration

Image
There are thousands of websites which are using MySQL as database. If we need to migrate data from Websites, which are using MySQL database, to Drupal 8 then we can use this blog post as starting point. We have a sample MySQL Database 'mysql_custom_db' which contains two tables, users and pages. The data in 'users' table looks like below,   The data in 'pages' table looks like below, As all the fields in 'users' table, from source database, will map to User entity in Drupal 8 site so we don't need make any changes there. But as we are migrating 'pages' table data to 'Basic Page' content type in Drupal 8 site, so we need to create required fields in 'Basic Page' content type. We have created the fields in 'Basic Page' content type and it looks like below, In our migration, field mapping between source site (pages) and destination site (Basic Page' content type) is like below, city...
Read more