430 likes | 449 Views
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
E N D
ViViaN Tutorial Joseph Snyder snyderj@osehra.org Betsy McPhail betsy.mcphail@kitware.com November 2018
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
ViViaN in a nutshell Package Relationships and Dependencies Install Information VistA Menu Structure
ViViaN: Use Cases
Exploring the RPC Broker package
#1 Package Exploration
Survey the current capability and contents of the RPC Broker package using ViViaN and DOX Use case synopsis:
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. Link to VA’s “Hybrid Information Model” 4 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
Find the RPC Broker patch history from the last 5 years and find dependencies of patches that need to be installed Use case synopsis:
Package Timeline • Navigate to Package Timeline page • Install → Install Timeline • https://code.osehra.org/vivian/installScale.php 1
Package Timeline • Select RPC Broker as the package • By default, all patches are displayed 1
Package Timeline • Let’s display patches from last 5 years (2014 - 2018) • Select 01/01/2014 as start date and click Update 1 2
Package Timeline • Hover over patches to get a summary
Package Timeline • Click on patch for detailed information
Install Dependency • Navigate to Dependency Tree page • Select Install → Install Dependency Tree • https://code.osehra.org/vivian/patchDependency.php 1
Install Dependency 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 1 • 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 2
Install Dependency 1 • 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 2
Install Dependency • Hover over a node to get a summary • Click on node to open detailed information page
#3 Interfaces of Package
Determine the parameters needed for a Remote Procedure call in the RPC Broker package Use case synopsis:
RPC Listings • Select VistA Interfaces → RPC • https://code.osehra.org/vivian/files/8994/All-RPC.html 1
RPC Listings • Search for XWB • Click on XWB ARE RPCS AVAILABLE 1 2
RPC Listings • Click on routine (XWBLIB) to navigate to DOX Routine page 1
Routine • Click on source file (XWBLIB.m) to navigate to DOX source page 1
#4 Existing Interfaces
When creating an update, determine whether an Remote Procedure in the RPC Broker package can be called Use case synopsis:
ICR/DBIA Listings 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 • Sort by Date Created • Click on Name (XWB IM HERE) to see details 2 3 1
ICR/DBIA Listings • Check: • Usage • Subscribing Package • Status 1 3 2
#5 Roll and Scroll interfaces
Determine starting menu and path to access an option from the RPC Broker package. Use case synopsis:
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. • Click on “RPC Broker Management Menu” string 1
OPTION Entry details FileMan information about the menu. Click on each menu object for more information