Integration between SDL Tridion Sites and SDL Tridion Docs
As of SDL Tridion Sites 9, SDL Tridion Sites can be integrated with SDL Tridion Docs (release 13 SP2 or later) to facilitate a "content mashup" --that is, putting content coming from both products together on the same webpage.
In a content mashup, authors and editors publish content from the Content Managers of both products to the same Content Delivery environment. By interacting with this one environment, you can add technical content, coming from the SDL Tridion Docs product, to a webpage of a marketing website, driven by SDL Tridion Sites.
- Authoring content
-
SDL Tridion Sites and SDL Tridion Docs, the two products that together comprise the SDL Tridion DX suite, each have their own separate content management environment, called "Content Manager" in both cases. As before, authors and editors of both products use their own content management system, content editors and other tools, specific to their product.
- Adding shared Keywords to content
-
A special taxonomy connector enables SDL Tridion Docs authors and editors to enrich the content they write with Keywords that originate from a Taxonomy in the SDL Tridion Sites Content Manager. This Taxonomy is read-only for SDL Tridion Docs users: they cannot modify, add or remove Keywords in the Taxonomy.
SDL Tridion Sites authors, of course, can also tag their content with Keywords from the same Taxonomy. And if they are properly authorized, SDL Tridion Sites users can also modify the Taxonomy itself: adding, removing and modifying Keywords.
- Publishing content to the same Content Delivery environment
-
From the two Content Managers, content authors and editors for each product can publish to one single shared Content Delivery server environment, using a shared Content Deployer known as the DX Content Deployer. This Content Deployer puts the published content in the same shared Content Delivery Content Data Store. The associated Keywords for each published item also get published alongside the content, and also end up in the same Content Data Store.
- Getting content and showing it on the same webpage
-
With the content from both products residing in the same Content Data Store, a SDL Tridion DX-based website can now create webpages that use the new Public Content API to dynamically query the Content Data Store for all content, regardless of its origin, tagged with Keywords from the shared Taxonomy, and put both pieces of content on the same webpage. Thus, you can "mash up" the content from the two products on the same webpage.
To implement a content mashup, SDL recommends that you read the SDL DXA documentation. The SDL DXA product includes a sample content mashup implementation that offers this functionality out of the box. You can change this sample implementation to suit your specific mashup scenario.