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?