How to Connect Tridion Docs to an External Taxonomy Using the PoolParty API
By Touhid Chowdhury
An Introduction to PoolParty
PoolParty, a globally renowned Semantic Middleware, uses linked data technologies and knowledge graphs as a basis of its AI strategy. It primarily applies the SKOS standard, as well as other RDF schemas, thus making it compliant to the semantic web.
By adding a connector to your semantic layer within your chosen platform, you are simplifying processes, freeing up time, and developing the flexibility needed to maintain sites, without overcomplicating your governance model.
Late last year, we performed a demo integration between Tridion Docs and PoolParty, and wanted to share that walkthrough with you to illustrate just how helpful this tool is for non-technical teams.
We referred to the Custom Metadata Binder on SDL’s documentation site.
Side note: If you’re unfamiliar with PoolParty’s interface or need an understanding of Semantic Technologies, I highly recommend going to PoolParty’s YouTube channel and taking advantage of their tutorials.
Creating (or importing) a taxonomy in PoolParty
For the purposes of our demo, we created a trial account where we built a taxonomy of beverages.
We organized it so that all Top Concepts have multiple Narrow Concepts and a few of those Narrow Concepts were assigned Narrower Concepts, thus creating nested Concepts to better facilitate our needs for a use case.
If you have an existing Taxonomy that can be exported into RDF format, you will be able to import that taxonomy into PoolParty for your use case
Our Example Taxonomy:

Steps:
Acquire the API call
Obtain the API call (Request URL) and generate a JSON representation of the whole Data Tree (JSONConceptTree).
In order for us to understand the format of the API and find the Web Service Methods that are relevant to our objective, we referred to the PoolParty Thesaurus API Reference Documentation.
A Glossary of all available web service methods for the PoolParty Thesaurus API, listed and documented (FYI: An active account is required to access the Documentation).
From there we concluded the format of the API call:
http://<server>/PoolParty/api/thesaurus/<project-id>/<web-service-method>?root=<uri-of-root-node>
Where,
- <server> represents the base URL. In our case this was enterprise.poolparty.biz.
- <project-id> can be found when clicking on your project and observing the code under the title.

- <web-service-method>?<parameters>
Using the Reference Documentation we acquired the <web-service-method> ‘subtree’, which returns all concepts under the ‘root’. The root is a String passed as a <parameter> to the method.
The root can be the id/uri of either the Concept Scheme (acquire the entire Data Tree) or a Top Concept (specifically get Narrower Concepts under a specific Concept).
We used the Concept Scheme for our objective, and its id/uri can be found by clicking on the Concept Scheme of the project and observing the URI present under the title:

The final request URL we concluded was:
https://enterprise.poolparty.biz/PoolParty/api/thesaurus/1E264942-63DF-0001-BF38-1D203ABA3780/subtree?root=https://enterprise.poolparty.biz/Test/0
Deserialize
Write code to deserialize the Data Tree into a list of entries. The subtree is returned in JSON format, as shown below.

Next, we created models to deserialize the JSON and use the JSONProperties into usable objects. We created type classes for a Concept, referring to a concept’s URI and label; a Concept Node, which contains the concept and its narrowers (which are a list of Concept Nodes); and a class for the Scheme that refers to its URI and label.
Associate entries
Use the Custom Metadata Binder code and associate each entry in the Data Tree to a metatag on Tridion Docs.
Side note: For information on creating and deploying a custom metadata binder, see this great post from fellow Content Bloomer, Manish Mehmood.
Though we’ve strictly focused on taxonomy management for our demo, PoolParty includes and provides multiple other features and services such as Powertagging (to enhance CMS search features), Semi auto-generated metadata/tag suggestions (augmented by Knowledge Graphs), and other Data/Knowledge mining capabilities.
It’s an incredible content management tool. If you’re interested in learning more, Content Bloom is offering a free consultation to businesses looking to improve their processes.
Get the latest industry news, articles, and updates.
(No junk. Just the good stuff.)
Related posts

Tridion Docs 15: Boosting Productivity and Quality
Tridion Docs 15 streamlines workflows, enhances security, optimizes performance, and paves the way for future advancements.

What is the Content Supply Chain and Why is it Key to Strategic Content?
The Content Supply Chain addresses the key challenges facing content teams in the digital age.

Adobe Summit: The Dawn of Experience-Led Growth
At Adobe Summit this year, more than 10,000 industry leaders came together to gain insights on delivering controlled, profitable growth, through experience-led strategies. Attendees were privy to the latest advancements from Adobe, including their innovative tools for personalization at scale, Adobe AEM enhancements, and generative AI for businesses. This conference provided an opportunity for professionals […]