Written by: Niambh Scullion, Shanthi Shanmugam, Shankar Sreedhara and John Gleeson.
This article provides you with a high-level overview of how the CÃºram Analysis Documentation Tool (CAD) tool can be used to help with the analysis of Intelligent Evidence Gathering (IEG) scripts. It is based on training material on the CAD tool developed by Shanthi Shanmugam, Shankar Sreedhara and John Gleeson who are part of the IBM Watson Health, GHHS Implementations team based in Canada. Shanthi, Shankar and John have extensive expertise and technical experience in CÃºram Social Program Management Platform, and they work closely with Social Program Management customers to design and deliver projects to obtain their business goals and achieve better outcomes for both their employees and citizens. The IBM Watson Health GHHS Implementations team regularly produce and maintain training materials, presentations and technical assets to complement and customize the existing CÃºram Social Program Management product documentation and features for our customers.
Updating IEG scripts
IEG scripts are used in Curam to gather information interactively by displaying a script of questions that a user can provide answers to 1. IEG Scripts are interactive and can be configured to only display questions that are consistent with a userâ€™s previous answers. Information supplied by the user is then stored in the datastore 2.
Previously, when a change to an existing script was required, or a new script was being designed, the business analyst had to check multiple areas as follows:
1. Internal documentation, that captures the script details,
2. They had to verify behavior within the application,
3. Work with a developer to check the IEG XML and the datastore,
4. Finally, they would have to check the IEG Editor.
While the information was there, accessing all the information they needed was a very time consuming exercise.
How CAD can reveal IEG Script information
CAD contains information about all the IEG Scripts and the datastores that are configured within the application. When a user selects the IEG Scripts link or icon, the user is presented with a list of all the IEG Scripts within the Social Program Management Application. Each IEG Script is identified by the following fields:
â€¢ The ID,
â€¢ The Version, and
â€¢ The Type which make up the unique script identifier.
â€¢ The Name of the script,
â€¢ The Component that contains the script are also listed.
Users can filter the list of rule sets, by typing in to the text field in the list, see figure 1 for an example, where the list is filtered by the word â€˜HealthCareâ€™.
By clicking the ID, the user is then presented with the IEG Script. The IEG Script page in CAD provides a high level view of the script, an interactive diagram, detailing the pages and the flow between the pages. The page contains a filtered list of all pages in the script and finally, if there are any callouts used within the script these are listed.
Viewing IEG Script pages in CAD
This section outlines all the information displayed within an IEG Script page in CAD. It is worth noting, the images below are not from the same IEG Script.
At the top of the page, high level script information is displayed. The user is presented with the following information (see figure 2):
â€¢ The script file location.
â€¢ The associated property file location.
â€¢ The datastore objects that are configured in the IEG Script.
Figure 2 Script Details from an IEG Page in CAD
Clicking on the datastore link, you can access the full datastore that is configured with the application (figure 3).
Parent Scripts and Sub Scripts
When a script is being designed, if the script is very large and complex, the development team may â€˜breakâ€™ the script up in to smaller scripts. These are known as â€˜Sub Scriptsâ€™, if a script contains Sub Scripts, these are listed (see figure 4). Alternatively, if the script is a subscript, the parent script is listed (see figure 5).
Figure 4 A list of subscripts within a script
IEG Flow Diagram
The IEG page contains a diagram depicting the flow of the script, any conditions, and callouts. The diagram is interactive, and once you click on the diagram you can manipulate it. Hover over the icons to get more information about the element(see figure 6).
Figure 6 IEG Page Diagram with information about a loop element
Beneath the diagram, a list of IEG pages are displayed to users. The list, like all lists within CAD can be filtered. Your filter text may be a question, a condition, or any piece of text that would be contained within a page and the list will be filtered. Once the user expands the toggle associated with a page the following information is displayed (figure 7):
â€¢ The page description, if it is available.
â€¢ The location of the page property file that is associated with the page.
â€¢ The page display criteria.
â€¢ Page display preconditions describe all the conditions, and loops that a page can be nested within.
â€¢ The type and name of the persistence attribute.
â€¢ A full list of questions displayed on the page.
â€¢ Any validations configured for a page (figure 8).
â€¢ If legislation or policy links are specified.
Questions in more detail
Understanding when a question is displayed is a key component within IEG. CAD will show if the question is mandatory or not, but also the conditions with which the question will be displayed. As a user, you will also see datastore attribute that stores the users input.
IBM.com. (2019). IBM Knowledge Center. Authoring IEG [online] Available at: https://www.ibm.com/support/knowledgecenter/en/SS8S5A_7.0.4/com.ibm.curam.content.doc/AuthoringScriptsUsingIEG/ctr_AuthoringScriptsUsingIEG.html [Accessed 20 Jun. 2019].
IBM.com. (2019). IBM Knowledge Center. [online] Working with IEG Available at: https://www.ibm.com/support/knowledgecenter/en/SS8S5A_7.0.4/com.ibm.curam.content.doc/WorkingWithIntelligentEvidenceGathering/c_WORKIEG_Getting2DatastoreDs1.html [Accessed 20 Jun. 2019].