Feature: The "data-factory:list" and "data-factory:import" commands
Description
Two console commands make the seed sets of an installation visible and import one of them.
vendor/bin/typo3 data-factory:list
vendor/bin/typo3 data-factory:import demo --dry-run
vendor/bin/typo3 data-factory:import demo --base='https://example.com/'
data- prints identifier, title and providing extension of every
seed set found in Configuration/ of an active
extension, in the order the installation loads its extensions in. -v
adds the directory of each set. An identifier provided by more than one
extension is reported with all of its providers and makes the command exit
non-zero: the sets cannot be told apart, so neither listing nor importing may
pick one of them.
data- writes one set. Without an identifier it asks which one;
without a terminal to ask on it lists the available sets and exits non-zero
rather than guessing. The options are:
| Option | Effect |
|---|---|
-- | Validate the set and report what an import would do, writing nothing. |
-- | Import although the set suggests uids this installation already uses. |
-- | The page the set is written below. 0 is the page tree root. |
-- | Replaces the base of every site configuration the set writes. |
-- | Skip the site configurations the set declares. |
Each kind of failure has its own exit code — unknown set, unresolvable set, invalid definition, uid collision, no administrator, failed write — so that a deployment script can tell "no such set" from "that would overwrite something" without parsing the output. The complete list is in the Configuration chapter.
Impact
An installation can be provisioned from the command line, and a pipeline can act on what happened. The complete option and exit code reference is in the Configuration chapter.