Keep track of your adjustments

General Add comments
by:

buttonMaking adjustments to a ServiceNow environment is one thing. Tracking your adjustments and document them is a whole different kind of thing. With experience at an FDA compliant customer, it is crucial to keep track of your adjustments for your requirements.
In this blog I would like to follow-up Fred van der Schaar’s blog about the Business Requirement section, in particular; the Functional Specification module. This is a part of the ‘Requirement Management’ application created and used by Logicalis SMC.

The Functional Specification


A Business Requirement contains a need for the business, requested by the Customer. However, the Business Requirement is a strategic level and leaves a lot of questions how things should be implemented on an operational level. To avoid fuss, a translation to actual functionality is required. This is done in the Functional Specification, the tactical level.
The Functional Specification contains all required information for the tactical level, how would we like to see the Business Requirement being fulfilled. For example: ‘We need a risk calculation button and when pressed, a calculation is required between values in Field Y and Field Z’.
The Functional Specification on tactical level is seamlessly integrated with the actual adjustments in the tool, which are on the operational level.

What about keeping track of your adjustments?


The Functional Specification module contains several related lists. The related lists are all connected to specific components in ServiceNow (like Access Controls, Applications, Business Rules and Client Scripts). These related lists are used to relate Functional Specifications to actual adjustments in the tool.



How can we document this?


Now we got all information in the ServiceNow tool. For some customers, just having the information in ServiceNow is not enough and compliance requires an additional document for approval. Or in some cases you would like to create a feature list for your next release. We can use the ‘export to PDF’ function to get the information directly or we can build specific reports to get us the information we want.
Logicalis SMC decided we needed an easy way to export all Business Requirements and Functional Specifications directly out of the tool in a proper layout and in a Word document. In the screenshot below you can see how the Word document looks like when exported out of ServiceNow.

If you have any questions you can contact me via .img[at].img

3 Responses to “Keep track of your adjustments”

  1. HC Lee Says:

    How do you export information from ServiceNow to a word document? Need some guidance.

  2. jc Says:

    I presented on a similar topic at Knowledge 13 specifically around generating FDA validation documentation. I’ll be presenting again at Knowledge 14 on a similar but broader topic. While I’m not familiar with Tim’s work, there are various ways to export ServiceNow data to Word. A simple client-side solution is to use an ODBC connection and VBA (VisualBasic for Application, i.e., Word macro).

  3. Tim Willer Says:

    Hi all,

    Thanks for replying to my blog. As JC is referring to, there are multiple ways to export information from ServiceNow and generate a Word document.

    In this situation we have used a XML and a XSL (StyleSheet) document. With an application like Cooktop we are able to create a ‘new’ XML that can be interpreted by Word.

    However, the trick is to let ServiceNow generate a XML that is compatible with the sections within the StyleSheet. We have used a processor together with a script include to make this translation.

    You can take a look at the „ExportUpdateSet” processor. This is the processor used by ServiceNow to export Update Sets.

    Hope this helps you out!

    – Tim

Leave a Reply