NCS Content integration setup guide

Information for Naviga implementation staff for configuring the Naviga Writer integration with NCS Content.

Configuring fact boxes

Content Parts from Naviga Writer may be sent to NCS Content as Main Factboxes, linked to the parent article. This requires that the content part be mapped to a Main Factbox format in tagmappings.xml.

The first step is to determine which Naviga Writer content part should be treated as a factbox in NCS Content. In the following example, the content part that serves as the factbox is a content part with a URI of im://content-part/fact in the Naviga Writer configuration for the Writer plugin io.infomaker.contentpart.

{
            "id": "io.infomaker.contentpart",
            "name": "im-contentpart",
            "url": "https://plugins.writer.infomaker.io/v1/infomaker/im-contentpart/2.5.0/index.js",
            "style": "https://plugins.writer.infomaker.io/v1/infomaker/im-contentpart/2.5.0/style.css",
            "enabled": true,
            "mandatory": false,
            "data": {
                "disableUseOfAnnotationTools": true,
                "types": [
                    {
                        "name": "Facts",
                        "uri": "im://content-part/fact",
                        "default": true,
                        "fields": [
                            {
                                "id": "subject",
                                "label": "Headline"
                            },
                            {
                                "id": "title",
                                "label": "Title"
                            },
                            {
                                "id": "text",
                                "label": "Body text",
                                "icon": "fa-paragraph"
                            }
                        ]

In this example, the content-part with URI im://content-part/fact must be mapped to a Main Factbox text format in NCS Content. The first step is to determine which format should be assigned to the factbox upon import to NCS Content.

It is possible to have multiple content parts in Writer, and for each content part to be mapped either to the same NCS Content format, or to different formats. More on that below.

Log in to the NCS Content Admin and navigate under the Product to Text Formats for Article Types. Expand the tree, and locate Main Factbox. Expand the tree under Main Factbox to view the available formats for the article type.

If no Formats exist under Main Factbox, it will be necessary to assign at least one Format to this Article Type.

In this example, we will assign the Text Format 2c Box as the default format for factboxes sent from Naviga Writer to NCS Content. We must first locate the database ID for the text format.

Log into SQLPlus and issue the following statement, replacing the value of name with the name of the desired format in single quotes:

select id,name from sx_textformat where name = '2c Box';

and press Enter. The result should look something like this:

Make a note of that nine-digit id. That's the value we're going to enter in our tagmappings.xml file.

On the server on which EWS runs, a file named tagmappings.xml exists within the EWS configuration in the Tomcat container. Typically, that file will be found on the server at

C:\Program Files\Apache Software Foundation\{ews-service-name}\webapps\ewsconfig\tagmappings.xml.

Locate that file and open it in your favorite text editor. Near the top of the file is a node called factboxes. In that node, you will map the factbox uri to the textformatid.

		<factboxes>
			<factbox uri="im:/content-part/fact" textformatid="410413500"/>
			<factbox uri="im:/content-part/gamefact" textformatid="410413500"/>
		</factboxes>

Enter the nine-digit code returned by SQLPlus for the wanted default format. Save tagmappings.xml, and restart the Tomcat service.

In the example above, two different Naviga Writer content parts are mapped to the same NCS Content text format. It also would be possible to map them to different formats.

Last updated