Skip to main content

SNOW_REPLACE_CONF_LINKS Function

Thomas Kerman
Updated

This function only applies to a migration of Knowledge Articles from Jira Confluence into a ServiceNow Knowledgebase.

It can be used to transform the article content to:

  1. Repoint embedded images to attachments in the migrated ServiceNow article
  2. Repoint links to other Confluence articles to the migrated articles in the ServiceNow instance.

Prerequisites

The success of this function depends on the article and all its attachments and any linked articles having been migrated previously. Best Practice approach is to migrate all the articles and their attachments first without transforming the content, and then having a second mapping updating the same set of articles and performing the transformation.

When migrating the articles into ServiceNow, the Article ID field on the created articles must be set to the ID of the article in confluence. Doing this will ensure that the inter-article links can be transformed since the correlation of the source and target articles depends on this relationship.

 

This approach is demonstrated in the OTB project template 'Jira to ServiceNow ->Confluence Pages'.

 

Function Usage

The function takes the following parameters:

  • A csv list of the attachment filenames attached to the migrated article. Usually, this would be provided using a lookup on the sys_attachment table and using the 'Concatenate CSV' option to handle multiple matches. A temporary variable should be created and mapped to store the set of file names.
  • A csv list of the sys_id's for the attachments attached to the migrated article. This can be collected using the same lookup as for filenames above. A temporary variable should be created and mapped to store the set of sys_id's.
  • The article body (the article body source field will provide this).

 

The function will generate warnings if the following occurs:

  • A referenced attachment could not be found
  • A referenced link cannot be found
  • The article body is not HTML formatted
  • The csv lists of filenames and sys_id's are not the same length.

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk