Skip to Content
Information
This documentation supports the 21.05 version of BMC Helix ITSM. To view an earlier version, select the version from the Product version menu.

Linking knowledge articles in the dataload spreadsheets

With Knowledge Managementand Data Management, you can add a link to an article from the Rich Text Format (RTF) fields in another article.

Related topic

Configuring-Data-Management

To link a knowledge articles

Embed a link from the current article in the spreadsheet to another article, you need the following:

  • Article ID of the article to which you are linking.
  • Text of the link to which you are linking.
  1. In the spreadhseet, select the knowledge article in which you want to add the link

  2. Create a tag in the current article in the following format:

    ##LINK_ARTICLE##<PrevDocIDValueHere>##LINK_END##<TextLinkHere>##TEXT_END##.

    For example, to create a link that says "Click here to view article 2000" from the current article to an article with the legacy ID (PrevDocID) of 2000, the tag looks like this:

    ##LINK_ARTICLE##2000##LINK_END##Click Here To view article 2000##TEXT_END##.


To embed a link from the current article to another article, you need the article ID of the article to which you are linking, and the text of the link itself. With this information, you create a tag in the current article that takes the following format:

##LINK_ARTICLE##<PrevDocIDValueHere>##LINK_END##<TextLinkHere>##TEXT_END##.

For example, to create a link that says "Click here to view article 2000" from the current article to an article with the legacy ID (PrevDocID) of 2000, the tag looks like this:

##LINK_ARTICLE##2000##LINK_END##Click Here To view article 2000##TEXT_END##.


If you have articles with links to other articles, refer to the sample procedures in the following example to add links and update your dataload spreadsheets:

Information
Example

A How To article with the articleID Article001 has a link to Article002 in the Question field.

The following sample text is available in the RTF field: 

"Electronic mail*, commonly known as email or e-mail, is a method of exchanging digital messages from an author to one or more recipients
Please refer to "How to Write Emails"<Link to Article002>
Modern email operates across the Internet or other computer networks. Some early email systems required that the author and the recipient both be online at the same time, in common with instant messaging." 

If you want to move the article with the above mentioned text to Action Request System using Data Management, the sample text is converted in the following format:

"Electronic mail*, commonly known as email or e-mail, is a method of exchanging digital messages from an author to one or more recipients
Please refer to ##LINK_ARTICLE##Article002##LINK_END##How to Write Emails##TEXT_END##.
Modern email operates across the Internet or other computer networks. Some early email systems required that the author and the recipient both be online at the same time, in common with instant messaging." 

The actual link to Article002 is converted to ##LINK_ARTICLE##Article002##LINK_END##How to Write Emails##TEXT_END## in order for Data Management to understand that this is a link to Article002. Article001 and Article002 are the article IDs from the earlier system. You do not need to know the new article IDs to add the link. 

Similarly, if you have the articles in HTML format and the link is in the following format: <a href="article123">Email Writing!</a>, the link is converted to ##LINK_ARTICLE##article123##LINK_END## Email Writing!##TEXT_END##.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix ITSM 21.05