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 their 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.
We recently 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 concepts URI and label; a Concept Node, which contains the concept and it’s narrowers (which are a list of Concept Nodes); and a class for the Scheme that refers to it’s 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.
Receive our latest news, articles, and updates.
(No junk. Just the good stuff.)
Related posts

Futureproof Your Business with MACH
MACH is a new technology that enables you to quickly acclimate, achieve business success, and grow in any market condition.

A Recap of Tridion Expert Summit 2020 – Day 2
Here’s a full recap on Day 2 of Tridion Expert Summit 2020.

Hacking the Tridion UDP Library
Follow along as our Tridion Practice Lead, Damian Jewett, walks through how to hack the Tridion UDP library.