1. Building Sites with Oracle Content Management
  2. Developing for Sites with Other Tools
  3. Develop with Oracle Content Management Toolkit
  4. Import and Export Taxonomies

Import and Export Taxonomies

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

The cec download-taxonomy <name> command exports a taxonomy from Oracle Content Management. It downloads a taxonomy from an Oracle Content Management 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 Management 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 Management. It uploads a taxonomy to an Oracle Content Management 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 Management 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 Management 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 Management 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 Content 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 Management server to a target Oracle Content Management server.

A manager or content administrator can import or export a taxonomy with Content 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.