[project/migrate.git] / README.txt

IMPORTANT: This is the final release of Migrate V1 - there will be no more support for
this version of Migrate going forward.


The Migrate module provides a flexible framework for migrating content into Drupal from other
sources (e.g., when converting a web site from another CMS to Drupal). Out-of-the-box, support 
for creating Drupal nodes, fields, comments, url aliases, users+profiles and roles are included. 
Hooks permit migration of other types of content.

The combination of the Table Wizard and Migrate modules is designed to support a migration process 
along these lines:

 * Import - Table Wizard can be used to import external data into tables in your Drupal database. 
   Any tables in your Drupal database, or in other databases on the same server, can be made 
   available to views for review and migration.

 * Analysis - Table Wizard performs analysis of table data (ranges, sizes, etc.), and supports 
   collaborative documentation of table fields.

 * Content sets - Create Views which represent the different source records that you wish to 
   migrate. The Views utilize the Views integration you just created with Table Wizard.

 * Migration - Migrate takes rows from the content sets creates Drupal objects from them. Migration 
   is reversible - migrated data can be quickly backed out and migrated again. A dashboard is provided to easily manage the process. Background processing via cron is supported for large migrations.

 * Auditing - Errors and other conditions flagged during migration are flagged and can be reviewed 
   in Views). Also, Migrate maintains mapping tables from the source data to the resulting Drupal 
   objects, enabling the creation of comparison views.

Acknowledgements 
----------------

Much of the Migrate module functionality was sponsored by Cyrve, for its clients GenomeWeb 
(http://www.genomeweb.com) and The Economist (http://www.economist.com). The original code was 
based on node_import.

Author
------

Mike Ryan - http://drupal.org/user/4420
Commit	Line	Data
ea2e65b7 MR	1	IMPORTANT: This is the final release of Migrate V1 - there will be no more support for
	2	this version of Migrate going forward.
	3
859ca6fd	4
0e71d701 MR	5	The Migrate module provides a flexible framework for migrating content into Drupal from other
	6	sources (e.g., when converting a web site from another CMS to Drupal). Out-of-the-box, support
	7	for creating Drupal nodes, fields, comments, url aliases, users+profiles and roles are included.
	8	Hooks permit migration of other types of content.
7c9e473a	9
0e71d701 MR	10	The combination of the Table Wizard and Migrate modules is designed to support a migration process
0e71d701 MR	11	along these lines:
7c9e473a	12
0e71d701 MR	13	* Import - Table Wizard can be used to import external data into tables in your Drupal database.
	14	Any tables in your Drupal database, or in other databases on the same server, can be made
	15	available to views for review and migration.
7c9e473a	16
0e71d701 MR	17	* Analysis - Table Wizard performs analysis of table data (ranges, sizes, etc.), and supports
0e71d701 MR	18	collaborative documentation of table fields.
7c9e473a	19
0e71d701 MR	20	* Content sets - Create Views which represent the different source records that you wish to
0e71d701 MR	21	migrate. The Views utilize the Views integration you just created with Table Wizard.
7c9e473a	22
0e71d701 MR	23	* Migration - Migrate takes rows from the content sets creates Drupal objects from them. Migration
0e71d701 MR	24	is reversible - migrated data can be quickly backed out and migrated again. A dashboard is provided to easily manage the process. Background processing via cron is supported for large migrations.
7c9e473a	25
0e71d701 MR	26	* Auditing - Errors and other conditions flagged during migration are flagged and can be reviewed
	27	in Views). Also, Migrate maintains mapping tables from the source data to the resulting Drupal
	28	objects, enabling the creation of comparison views.
7c9e473a	29
d22cc188	30	Acknowledgements
0e71d701	31	----------------
7c9e473a	32
0e71d701 MR	33	Much of the Migrate module functionality was sponsored by Cyrve, for its clients GenomeWeb
	34	(http://www.genomeweb.com) and The Economist (http://www.economist.com). The original code was
	35	based on node_import.
7c9e473a	36
d22cc188	37	Author
0e71d701	38	------
7c9e473a	39
d22cc188	40	Mike Ryan - http://drupal.org/user/4420