XML for Glossary Widget

New Here ,
Feb 12, 2021 Feb 12, 2021

Copy link to clipboard

Copied

Captivate 2019 version 11.5.1.499: I want to use the Glossary widget for my project, but will be creating many additional projects that will use the same glossary. The widget allows for you to upload and XML file, but the only help I can find on how to start the widget XML writing process is from the captivate versions 8 and 9. I have been able to understand what to write in the XML file, but have yet to figure out how to start it in terms of the Root and the Child being that the Glossary widget hides all the words under the corresponding letter to make the glossary organized and searchable. I am using XML notepad to write my XML file. Any assistance on how to start the root/child relationship would be greatly appreciated. This will allow one glossary file to be created and uploaded into several trainings vice having to populate numerous glossary widgets.  

Views

117

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines

correct answers 1 Correct Answer

Adobe Community Professional , Feb 12, 2021 Feb 12, 2021
The XML is actually very simple.  If you go into the glossary interaction's properties and click the Show Example button it shows you the structure of a typical valid XML file. When I have a new project to work on where there will be multiple modules that all need to have the same Glossary terms and definitions I set up an Excel spreadsheet that has several columns.  The second column contains the Terms, the fourth column contains the Definitions and the first, third and fifth columns just cont...

Likes

Translate

Translate
Adobe Community Professional ,
Feb 12, 2021 Feb 12, 2021

Copy link to clipboard

Copied

LATEST

The XML is actually very simple.  If you go into the glossary interaction's properties and click the Show Example button it shows you the structure of a typical valid XML file.

Glossary.png

When I have a new project to work on where there will be multiple modules that all need to have the same Glossary terms and definitions I set up an Excel spreadsheet that has several columns.  The second column contains the Terms, the fourth column contains the Definitions and the first, third and fifth columns just contain the XML tags that need to be present to make the valid XML file. 

 

The first line of the spreadsheet just has the opening <XMLBit> tag and nothing else on other columns.  The linne AFTER the last term and definition contains the closing </XMLBit> tag.

 

Here's what the Excel file structure looks like:

Glossary_xlsx.png

So you just enter in all your terms and definitions to their relevant columns, then enter the XML tags for the second line.  Use Excel's features to drag/copy all of the tags down through all of the rows in their columns.

 

Then the final steps to create the XML file from this is to just save your Excel spreadsheet out as a Unicode TXT file.  You change the TXT file ending to XML and that's your file to upload into the Glossary Widget interaction.

 

One caveat here is that you will often find that after you import a new XML file (or even the first time you do it) the Glossary widget does not appear when you preview your HTML5 in a web browser.  The reason is usually that you have some text characters in your Glossary terms or definitions that the widget is mistaking for HTML or JavaScript code and that's the reason it is not working.  One thing to watch out for is having any parentheses ( or ) in the Terms column.  Other text characters that stop it from working are things like ampersands (&) and chevrons < >.  These are all characters used in programming code.  So you need to take these out of your terms and definitions. 

 

Debugging your XML file sometimes turns out to be the longest part of this process.  However, once you have a nice clean XML uploading it into each of your Captivate modules takes only seconds.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines