@kontent-ai-consulting/content-model-accelerator
v1.1.0
Published
This utility enables easy export / import of project structure's in Kontent.ai
Downloads
24
Maintainers
Readme
Kontent.ai Model Accelerator
[!TIP]
The idea behind this tool is to export & import content model structures to & from Kontent.ai environments. Data is both exported and imported viaManagement Api
into a specifiedjson
format.
Getting started
We recommend running @kontent-ai-consulting/content-model-accelerator
with npx
. Use --help
anytime to get information about available commands and their options.
npx @kontent-ai-consulting/content-model-accelerator --help
# you can also install the package globally, or locally
npm i @kontent-ai-consulting/content-model-accelerator -g
# with the package installed, you can call the tool as follows
kontent-ai-accelerator --help
Use via CLI
Configuration
| Config | Value |
| ----------------------- | -------------------------------------------------------------------------------------------- |
| environmentId | Id of Kontent.ai environment (required) |
| apiKey | Management API key (required) |
| action | One of (export
, list
, remoteImport
or fileImport
) (required) |
| filename | Filename used to export or import |
| model | Codename of the remote model (required for remoteImport
) |
| contentTypes | Comma-separated list of codenames. May be used to import only selected content types |
| contentTypeSnippets | Comma-separated list of codenames. May be used to import only selected content type snippets |
| taxonomies | Comma-separated list of codenames. May be used to import only selected taxonomies |
| debug | If set to true
, full error messages are shown in console log |
| force | If set to true
, confirmation prompt is disabled |
Execution
[!CAUTION]
We do not recommend importing into a production environment directly (without proper testing). Instead you should first create a testing environment and run the script there to make sure everything works as you intended to.
# List default accelerator models
kontent-ai-accelerator --action=list
# Export existing model to json
kontent-ai-accelerator --action=export --environmentId=xxx --apiKey=yyy --filename=my-export.json
# Import from file to an existing environment
kontent-ai-accelerator --action=fileImport --environmentId=xxx --apiKey=yyy --filename=my-export.json
# Import from the default accelerator model
kontent-ai-accelerator --action=remoteImport --environmentId=xxx --apiKey=yyy --model=advanced_model
# Import only parts from the default accelerator model
kontent-ai-accelerator --action=remoteImport --environmentId=xxx --apiKey=yyy --model=advanced_model --contentTypes=link --contentTypeSnippets=metadata --taxonomies=persona,product_type
# To get some help you can use:
kontent-ai-accelerator --help