ViViaN Tutorial Joseph Snyder snyderj@osehra.org Betsy McPhail betsy.mcphail@kitware.com November 2018
OSEHRA Visualization OSPG
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
Visualizing VistA and Namespace
ViViaN in a nutshell Install Information VistA Menu Structure Package Relationships and Dependencies
ViViaN: Use Cases
Exploring the RPC Broker package
#1 Package Exploration
Use case synopsis: Survey the current capability and contents of the RPC Broker package using ViViaN and DOX
Package Classification Page to visit: https://code.osehra.org/vivian/ 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
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
Package Interactions Page to visit: https://code.osehra.org/vivian/vista _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
Cross Reference in DOX https://code.osehra.org/dox/Package_RPC_Broker.html See: Dependency details and lists of other Package objects (Options, Protocols, Templates, etc.)
#2 Patching A Package
Use case synopsis: Find the RPC Broker patch history from the last 5 years and find dependencies of patches that need to be installed
Package Timeline Navigate to Package Timeline page 1 Navigate to Package Timeline page Install → Install Timeline https://code.osehra.org/vivian/installScale.php
Package Timeline Select RPC Broker as the package 1 Select RPC Broker as the package By default, all patches are displayed
Package Timeline Let’s display patches from last 5 years (2014 - 2018) Select 01/01/2014 as start date and click Update
Package Timeline Hover over patches to get a summary
Package Timeline Click on patch for detailed information
Install Dependency Navigate to Dependency Tree page 1 Navigate to Dependency Tree page Select Install → Install Dependency Tree https://code.osehra.org/vivian/patchDependency.php
Install Dependency Select RPC Broker as the package 1 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
Install Dependency Select RPC Broker as the package 1 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
Install Dependency Select RPC Broker as the package 1 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
Install Dependency Hover over a node to get a summary Click on node to open detailed information page
#3 Interfaces of Package
Use case synopsis: Determine the parameters needed for a Remote Procedure call in the RPC Broker package
RPC Listings Select VistA Interfaces → RPC 1 Select VistA Interfaces → RPC https://code.osehra.org/vivian/files/8994/All-RPC.html
RPC Listings 1 2 Search for XWB Click on XWB ARE RPCS AVAILABLE
RPC Listings Click on routine (XWBLIB) to navigate to DOX Routine page 1 Click on routine (XWBLIB) to navigate to DOX Routine page
Routine Click on source file (XWBLIB.m) to navigate to DOX source page 1 Click on source file (XWBLIB.m) to navigate to DOX source page
Routine source
#4 Existing Interfaces
Use case synopsis: When creating an update, determine whether an Remote Procedure in the RPC Broker package can be called
ICR/DBIA Listings Select VistA Interfaces → ICR 1 Select VistA Interfaces → ICR https://code.osehra.org/vivian/files/ICR/All-ICR%20List.html
ICR/DBIA Listings Search for RPC Broker as the Custodial Package 2 3 Search for RPC Broker as the Custodial Package Sort by Date Created Click on Name (XWB IM HERE) to see details 1
ICR/DBIA Listings Check: Usage Subscribing Package Status 1 3 2
#5 Roll and Scroll interfaces
Use case synopsis: Determine starting menu and path to access an option from the RPC Broker package.
OPTION menus Page to Visit: https://code.osehra.org/vivian/vista_ menus.php#19 or Menus -> VistA Option Menus Search for RPC Broker menu XWB MENU: RPC Broker Management Menu 1
OPTION Menu path Highlighted path to requested menu. 1 Highlighted path to requested menu. Click on “RPC Broker Management Menu” string
OPTION Entry details FileMan information about the menu. Click on each menu object for more information
Questions?