Module 3: Import and export tools
With the mapping written, the content has to get in. This module teaches the tools Exponential already has, the way of working that makes an import repeatable, and, for developers, the skeleton of a custom import script for sources no tool reads.
At a glance
| Course | Migrating to Exponential |
| Duration | 2 hours 45 minutes |
| Lessons | 3 |
| Level | Intermediate to advanced |
Lessons
| Lesson | Duration | What learners do |
|---|---|---|
| 3.1 Choosing the right import or export tool | 45 minutes | List classes and export columns with xrowextract; match five sources to their tools |
| 3.2 Importing with xrowextract: dry runs and repeatable imports | 60 minutes | Export a class, dry-run and apply an import, and prove that it does not duplicate |
| 3.3 A custom import script | 60 minutes | Run the documentation's skeleton with three items, twice, and see updates instead of duplicates |
Preparing this module
- To do: One training installation per learner with shell access; check that
php bin/php/console ext:xrowextract:csv --list-classes --node=2works on it (xrowextract installed and active). - To do: Each learner has a course folder with at least one article, and knows its node id (lessons 3.2 and 3.3).
- To do: A plain text editor on the training machines; no spreadsheet program for the CSV.
- To do: Lesson 3.3 is for developers. Non-developers can do lesson 3.2 again with a second class, or read the tools page section 2 on exports.
- To do: Run lesson 3.3 once yourself; note the locale code and the identifiers of the Folder class of your training site package.
Timing plan
| Block | Minutes |
|---|---|
| Lesson 3.1 | 45 |
| Lesson 3.2 | 60 |
| Break | 15 |
| Lesson 3.3 | 60 |
| Total | 180 (2 hours 45 minutes of lessons, plus a 15-minute break) |
Related pages
- Migrating to Exponential: course overview
- Exponential's import and export tools: the page this module teaches from.
- Trainers: start here
- Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.
Become an Exponential Partner
Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.