How can I import a DITA XML file into CCMS such that it is added as a topic?

Question

I need to add a large number of topics to CCMS. Rather than doing that manually, I am using a script to create files that have the same XML structure as the topic in CCMS. The only difference between the files and the CCMS topic, other than content, is that the elements in the files do not have GUIDs. I am assuming that in the process of importing the files into CCMS, SDL LiveContent Architect Publication Manager or the tool that is used to import the file adds the GUIDs. I am using SDL LiveContent Architect Publication Manager 11.1.2.

Raf Snijders · Answer

Dear all, Huntley is indeed on the correct route to resolve the issue. My take is that your CCMS has the Topic Type property defined as a mandatory property. Hence you need to supply a value for it during the import stage. This is also the reason why this error does not come up on environments which have this property defined as optional. You can supply this value indeed as Huntley suggested through the filemap.xml which is available in the folder with your GUID-ized content. You should check the ishfields structure for your topics to see whether there is a structure as shown below present Any value applicable in your CCMS from you list of values If not you have to add this to each and any of the ishfields structures defined for the topics. You can easily find them by looking at the ISHType attribute on the ishobject element surrounding the ishfields element. The topics are marked as ISHModule. So search for all ishobject tags having the ISHType attribute set to ISHModule and add or correct the ishfield tag as shown above in the bolded section. It might be that you have other properties defined as mandatory as well and need to supply them in a similar approach in order to provide the correct value(s) for them. I hope this helps, Kind Regards, Raf

Raf Snijders · Answer

Dear Persimmon, The .3sish files are files used by the authoring bridge and they do not contain all of the properties which are assigned to the object in the CCMS. I would suggest the following steps with respect to the process you described above and which should resolve your issue. 1/ Check through the webclient or the property dialog windows of either Publication Manager/Authoring Bridge which properties are marked mandatory for topics. You can easily identify them by the * which is available after the label of the field or by trying to upload one of the topics (or a dummy topic) through the webclient while you provide as little information as needed. The dialogs (first for the logical level, second the version level and last the language level dialog) will error on missing mandatory properties. My guess is that the 'Topic Type' property is marked as mandatory. Do choose one value from the drop down which you will apply in the filename for each and every topic available. 2/ Just before you start the 'Import' step of the DITA2Trisoft application, you need to extend the filemap.xml file with the property for the 'Topic Type' property with the choose value from step 1. eg. Your choosen value So each object should have an structure similar to the one shown below: 3/ After you have added all the missing mandatory properties for you object (you can leave out the status and language as these are automatically added), you can import the content into the CCMS. I hope this helps. Kind Regards, Raf

Tridion Docs > 01 - General Discussion Forum

How can I import a DITA XML file into CCMS such that it is added as a topic?

Overview of the filemap.xml file