Documentation Center

Publishing with Taxonomy Synchronization

After a Tridion Docs publication has been published to Content Delivery, it implicitly updates a cache called Taxonomy-Index in OpenSearch. You can also trigger an explicit refresh of the taxonomy on the Content Delivery system by publishing a special Taxonomy Sync publication. To create such a publication, first run a PowerShell script.

Usually, there's no need to trigger an explicit refresh of the taxonomy on the Content Delivery side, but the following scenarios may prompt you to do so:
  • The person maintaining the taxonomy may have made changes to it in PoolParty, such as reorganizing the taxonomy, adding synonyms, adding languages or changing labels.
  • Creating or refreshing the cache may seem to be failing.
To create the special Taxonomy Sync publication, on your Content Manager server, go the folder c:\InfoShare\App\Database\Common\DatabaseIndependent\Examples\CreateTaxonomySyncPublication\and run the PowerShell script there called CreateTaxonomySyncPublication.ps1. Provide the following parameters:
Parameter nameDescription of value
webServicesBaseUrlThe Web service base URL of the Tridion Docs, for example, https://example.com/ISHWS
trisoftUserNameThe user name of a Tridion Docs user authorized to run this script. You can omit this parameter if you use Windows Authentication.
trisoftPasswordThe password of the Tridion Docs user authorized to run this script. You can omit this parameter if you use Windows Authentication.

The script creates a new publication called Taxonomy Publication Sync in the repository folder \System\Taxonomy Sync\. This publication has publication outputs created for all output formats whose transformationtype is ishditadelivery and whose Dynamic Delivery discovery URL is not empty. You can now publish the publication to any Dynamic Delivery output to update the taxonomy cache for that output.