1. ViViaN Tutorial Joseph Snyder snyderj@osehra.org Betsy McPhail
November 2018

2. OSEHRA Visualization OSPG

3. What is ViViaN? OSEHRA’s Visual representations of VistA
Uses captured data from a VistA instance from a variety of sources
XINDEX
Parsing of Routines and Globals
ViViaN’s interactive displays use D3.js, HighCharts, and DataTables

4. Visualizing VistA and Namespace

5. ViViaN in a nutshell Install Information VistA Menu Structure
Package Relationships and Dependencies

6. ViViaN:
Use Cases

7. Exploring the
RPC Broker
package

8. #1
Package Exploration

9. Use case synopsis:
Survey the current capability and contents of the RPC Broker package using ViViaN and DOX

10. Package Classification
Page to visit:
Find the Package
Click on tree until “RPC Broker” is found or
Use the “Search for Package” to open a highlighted path to “RPC Broker”
Click on Node 1 2

11. Package Classification
3. Review Package Info
1. Namespaces
2. OSEHRA DOX links 1
3. Package “Interface: links 3 4
4. Link to VA’s “Hybrid Information Model” 2
5. Package Description 5

12. Package Interactions
Page to visit: _pkg_dep.php
Hover over “RPC Broker” entry
See packages that depend on RPC Broker in green
See packages that RPC broker depends on in red
See bi-directional Package dependencies in purple
Click on “RPC Broker” text to visit DOX pages
1,2

13. Cross Reference in DOX
See: Dependency details and lists of other Package objects (Options, Protocols, Templates, etc.)

14. #2
Patching A Package

15. Use case synopsis:
Find the RPC Broker patch history from the last 5 years and find dependencies of patches that need to be installed

16. Package Timeline Navigate to Package Timeline page1
Navigate to Package Timeline page
Install → Install Timeline

17. Package Timeline Select RPC Broker as the package1
Select RPC Broker as the package
By default, all patches are displayed

18. Package Timeline Let’s display patches from last 5 years (2014 - 2018)
Select 01/01/2014 as start date and click Update

19. Package Timeline
Hover over patches to get a summary

20. Package Timeline
Click on patch for detailed information

21. Install Dependency Navigate to Dependency Tree page1
Navigate to Dependency Tree page
Select Install → Install Dependency Tree

22. Install Dependency Select RPC Broker as the package1 2
Select RPC Broker as the package
From the Package Timeline, we know we’re interested the following patches:
XWB*1.1*67
XWB*1.1*64
XWB*1.1*63

23. Install Dependency Select RPC Broker as the package1 2
Select RPC Broker as the package
From the Package Timeline, we know we’re interested the following patches:
XWB*1.1*67
XWB*1.1*64
XWB*1.1*63

24. Install Dependency Select RPC Broker as the package1 2
Select RPC Broker as the package
From the Package Timeline, we know we’re interested the following patches:
XWB*1.1*67
XWB*1.1*64
XWB*1.1*63

25. Install Dependency Hover over a node to get a summary
Click on node to open detailed information page

26. #3
Interfaces of Package

27. Use case synopsis:
Determine the parameters needed for a Remote Procedure call in the RPC Broker package

28. RPC Listings Select VistA Interfaces → RPC1
Select VistA Interfaces → RPC

29. RPC Listings 1 2
Search for XWB
Click on XWB ARE RPCS AVAILABLE

30. RPC Listings Click on routine (XWBLIB) to navigate to DOX Routine page1
Click on routine (XWBLIB) to navigate to DOX Routine page

31. Routine Click on source file (XWBLIB.m) to navigate to DOX source page1
Click on source file (XWBLIB.m) to navigate to DOX source page

32. Routine source

33. #4
Existing Interfaces

34. Use case synopsis:
When creating an update, determine whether an Remote Procedure in the RPC Broker package can be called

35. ICR/DBIA Listings Select VistA Interfaces → ICR1
Select VistA Interfaces → ICR

36. ICR/DBIA Listings Search for RPC Broker as the Custodial Package2 3
Search for RPC Broker as the Custodial Package
Sort by Date Created
Click on Name (XWB IM HERE) to see details 1

37. ICR/DBIA Listings
Check:
Usage
Subscribing Package
Status 1 3 2

38. #5
Roll and Scroll interfaces

39. Use case synopsis:
Determine starting menu and path to access an option from the RPC Broker package.

40. OPTION menus
Page to Visit: menus.php#19 or
Menus -> VistA Option Menus
Search for RPC Broker menu
XWB MENU: RPC Broker Management Menu 1

41. OPTION Menu path Highlighted path to requested menu.1
Highlighted path to requested menu.
Click on “RPC Broker Management Menu” string

42. OPTION Entry details
FileMan information about the menu. Click on each menu object for more information

43. Questions?