Import and Export Taxonomies

Use OCE Toolkit commands to import taxonomies from your local machine to an Oracle Content and Experience server or to export taxonomies from the server to your local machine.

The cec download-taxonomy <name> command exports a taxonomy from Oracle Content and Experience. It downloads a taxonomy from an Oracle Content and Experience server.

You can use the following options in this command:

  • --status, -t [promoted | published] [required]: Specify the taxonomy status.
  • --id, -i: If another taxonomy has the same name, specify the taxonomy ID.
  • --server, -s: Specify a registered Oracle Content and Experience server, or use the one specified in the cec.properties file.
  • --help, -h: Show help for the command.

Some examples of the download-taxonomy command follow:

cec download-taxonomy Taxonomy1 -t promoted

  cec download-taxonomy Taxonomy1 -i 6A6DC736572C468B90F2A1C17B7CE5E4 -t promoted

  cec download-taxonomy Taxonomy1 -t published -s UAT

The cec upload-taxonomy <taxonomy> command imports a taxonomy to Oracle Content and Experience. It uploads a taxonomy to an Oracle Content and Experience server.

You can use the following options in this command:

  • --createnew, -c: Create a new taxonomy.
  • --name, -n: Specify the name of the new taxonomy.
  • --abbreviation, -a: Specify an abbreviation for the new taxonomy.
  • --description, -d: Specify a description of the new taxonomy.
  • --file, -f: Indicate whether the taxonomy is from a file.
  • --server, -s: Specify a registered Oracle Content and Experience server, or use the one specified in the cec.properties file.
  • --T2P: Checks if an asset or taxonomy with the same ID exists on the target Oracle Content and Experience instance. If true, the asset is added as a new version and the taxonomy as a draft (overriding the existing draft). Otherwise, a new asset or taxonomy is created with the same IDs.
  • --New: Always creates a new asset or taxonomy on the target Oracle Content and Experience instance.
  • --help, -h: Show help for the command.

Some examples of the upload-taxonomy command follow:

cec upload-taxonomy Taxonomy1
Create a new taxonomy or a draft of an existing taxonomy on upload  

cec upload-taxonomy Taxonomy1 -s UAT 
Create a new taxonomy or a draft of an existing taxonomy on upload on the registered server UAT

cec upload-taxonomy Taxonomy1 -c                                  
Create a new taxonomy on upload

cec upload-taxonomy Taxonomy1 -c -n Taxonomy1_2 -a t12 -d          
Create a new taxonomy on upload with the given name, abbreviation

"Taxonomy1 copy" and description cec upload-taxonomy          
Create a new taxonomy or a draft of an existing taxonomy in <file-name>.json -f and upload the JSON file

You can use OCE toolkit test to production CLI utilities to automate the import or export of assets together with a content model and its dependencies from a source Oracle Content and Experience server to a target Oracle Content and Experience server.

A manager or content administrator can import or export a taxonomy with OCE Toolkit commands in a test to production environment. With manager permission, you can add a draft of a taxonomy. With content administrator permission, you can create a new taxonomy.

Taxonomy lifecycle operations, such as promote, assign to a repository, and publish taxonomy are available for test to production. You can import assets together with categorization information and taxonomies into an import file, and you can export assets together with categorization information and taxonomies from an export file.