2. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 8/1/2017 12:28:31 PM Eastern Daylight Time. See www.araxis.com for information about Merge. This report uses XHTML and CSS2, and is best viewed with a modern standards-compliant browser. For optimum results when printing this report, use landscape orientation and enable printing of background images and colours in your browser.

2.1 Files compared

# Location File Last Modified
1 RA5_0_132.zip EPIP_Remediation_Plan_(RA_5.0_132).docx Mon Jul 31 14:57:46 2017 UTC
2 RA5_0_132.zip EPIP_Remediation_Plan_(RA_5.0_132).docx Mon Jul 31 19:13:17 2017 UTC

2.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 4 282
Changed 3 10
Inserted 0 0
Removed 0 0

2.3 Comparison options

Whitespace
Character case Differences in character case are significant
Line endings Differences in line endings (CR and LF characters) are ignored
CR/LF characters Not shown in the comparison detail

2.4 Active regular expressions

No regular expressions were active.

2.5 Comparison detail

  1   Existing P roduct Int ake Progra m (EPIP)
  2   Patch RA*5 .0*132
  3   Remediatio n Plan
  4  
  5   Department  of Vetera ns Affairs
  6   April 2017
  7   Version 1. 0
  8  
  9  
  10  
  11   Revision H istory
  12   Date
  13   Version
  14   Descriptio n
  15   Author
  16   04/03/2017
  17   1.0
  18   Initial (d raft) vers ion
  19   EPIP Proje ct Team
  20  
  21  
  22  
  23  
  24   Table of C ontents
  25   1.Introduc tion1
  26   2.Purpose1
  27   3.Patch De scription1
  28   3.1.Needs  and Requir ements1
  29   4.Points o f Contact2
  30   5.Code Rem ediation2
  31   5.1.Standa rds and Co nventions2
  32   5.2.Review  and Analy sis2
  33   5.3.Coding  Changes2
  34   6.Testing3
  35   6.1.Test P lan3
  36   6.2.Test E nvironment 3
  37   6.3.Test R eadiness R eview3
  38   6.4.Testin g Phases3
  39   6.4.1.Unit  Testing4
  40   6.4.2.Comp onent Inte gration an d Systems  Testing (C I/ST)4
  41   6.4.3.Func tional Tes ting4
  42   6.4.4.Regr ession Tes ting4
  43   6.4.5.Sect ion 508 Co mpliance T esting4
  44   7.Document ation Reme diation4
  45   7.1.User G uides5
  46   7.2.Instal lation Gui des5
  47   7.3.Techni cal Manual s5
  48   7.4.Operat ions Manua ls5
  49   8.Project  Reporting5
  50   9.Project  Schedule5
  51   10.Deploym ent5
  52   11.Sustain ment Requi rements5
  53   12.Mainten ance and K nowledge T ransfer6
  54   Appendix A :XINDEX Li sting for  MUMPS Code  Changes7
  55   Appendix B :Source Co de Changes 8
  56  
  57  
  58  
  59   Introducti on
  60   The Depart ment of Ve terans Aff airs (VA)  currently  utilizes t he Veteran s Health I nformation  Systems a nd Technol ogy Archit ecture (Vi stA) suite  of applic ations to  provide cl inical, fi nancial, i nfrastruct ure, and m anagement  tools. The  process o f advancin g “Class 3 ” field-de veloped Vi stA softwa re to “Cla ss 1” nati onally-dis tributed s tatus is r eferred to  as the Ex isting Pro duct Intak e Program  (EPIP). Th e VA’s goa l is to su pplement o ngoing act ivities as sociated w ith evalua ting and a dvancing f ield-devel oped softw are to a s tate that  meets nati onal stand ards and f acilitates  release f or Veteran s Health A dministrat ion (VHA)- wide use.
  61   Purpose
  62   The purpos e of this  document i s to fully  describe  the remedi ation plan  to be use d for the  successful  remediati on of the  intake pro duct code  to be depl oyed as pa tch RA*5.0 *132. This  patch add resses the  following  NSRs:
  63   NSR2016070 6 Add Heig ht and Wei ght to Rad iology Exa m
  64   This NSR h as been im plemented  locally at  the VA Me dical Cent er in San  Francisco  CA. 
  65   This docum ent addres ses the sc hedule, co de remedia tion, test ing, docum entation,  and delive ry of this  remediati on effort.
  66   Patch Desc ription
  67   RA*5.0*132  modifies  the VistA  Radiology  package to  display a  patient's  height an d weight w hen schedu ling exams . It is im portant fo r a provid er to know  a patient 's height  and weight  prior to  a Radiolog y procedur e; however , that dat a is not c urrently a vailable i n the Vist A Radiolog y package  when sched uling exam s. Based o n this dat a, alterna tive arran gements mi ght need t o be made  prior to a  patient's  arrival.  Additional ly, calcul ating Body  Mass Inde x (BMI) is  integral  to reporti ng dose me trics for  radiation  exposures.  The expos ure server s use the  BMI calcul ation to c reate mode ls and cal culate the  organ dos e per exam  and the c umulative  doses. Cur rently, Ra diology st aff must o btain the  patient’s  height and  weight in  order to  calculate  BMI. This  patch disp lays heigh t and weig ht in the  REGISTER P ATIENT FOR  EXAMS [RA  REG] and  ADD EXAMS  TO LAST VI SIT [RA AD DEXAM] opt ions in Vi stA.
  68   Needs and  Requiremen ts
  69   The Needs  and Requir ements for  the NSR(s ) addresse d in this  remediatio n are:
  70   NSR2016070 6 Add Heig ht and Wei ght to Rad iology Exa m  
  71   NEED 76096 1: Height  and Weight  On Radiol ogy Exam -  For Radio logy Staff   who need  to be awa re of a pa tient’s he ight and w eight for  a radiolog ic procedu re, a modi fication t hat will a llow the R adiology s taff to vi ew the pat ient’s hei ght and we ight withi n the Vist A Radiolog y package.  Unlike th e current  method tha t does not  display t he patient ’s height  and weight  within Vi stA Radiol ogy, our p rocess ens ures that  patient’s  height and  weight ar e displaye d within V istA Radio logy so th at if heig ht or weig ht is an i ssue for a  particula r procedur e, alterna tive arran gements ca n be made  prior to a  patient’s  arrival f or consist ency in BE ST PRACTIC ES/Quality .
  72   Points of  Contact
  73   The VA Poi nts of Con tact (POC)  for NSR20 160706 Add  Height an d Weight t o Radiolog y Exam are :
  74   Functional  POC: Jack  Liberati  ( PII ),  PII
  75   Technical  POC: Don D onati ( PII ), PII
  76   Code Remed iation
  77   Leidos wil l review a nd analyze  the intak e product  code for c ompliance  with codin g standard s, pointer s, shared  tables, de pendencies , and any  interferen ce with Vi stA system s.
  78   Standards  and Conven tions
  79   Leidos wil l referenc e the http :// DNS /sacc webs ite for ap plicable d ocuments a nd will ad here to VA  standards  to comple te the ana lysis of t his intake  product.  The output  of the VA  XINDEX ut ility will  be used t o analyze  the MUMPS  source cod e and docu ment the a ffected ro utines (se e Appendix  A).
  80   The MUMPS  coding sta ndards web site http: // ip /Demo/Anno Std will a lso be use d to ensur e that the  remediate d code con forms to V A standard s.
  81   Review and  Analysis
  82   Review and  analysis  of this in take produ ct involve s two part s: 1) veri fication t hat the so urce code  changes sp ecified in  this docu ment provi de the des ired effec t, and 2)  verificati on that th e source c ode change s do not a dversely a ffect any  other Vist A or CPRS  functional ity. 
  83   Testing wi ll be perf ormed to v alidate th at the int ended effe ct of thes e products  is implem ented, and  that no o ther VistA  or CPRS G raphical U ser Interf ace (GUI)  functional ity is adv ersely aff ected. 
  84   Coding Cha nges
  85   The coding  changes r equired fo r NSR20160 706 Add He ight and W eight to R adiology E xam are in  the follo wing MUMPS  routines:  
  86   Modified r outines: R ADEM2
  87   New routin es: TBD
  88   A detailed  analysis  of the cod ing change s is provi ded in App endix B.
  89   Testing
  90   Leidos wil l perform  all testin g-related  activities  to ensure  that the  remediated  code meet s the expe ctations o f the VA b usiness ow ner.
  91   Test Plan
  92   Leidos wil l configur e the test  environme nt, provid e code mod ifications  and end-t o-end test ing, and d eliver app licable te sting docu mentation,  following  Veteran-f ocused Int egration P rocess (VI P) guideli nes.
  93   The Leidos  developer  will modi fy the sof tware purs uant to th e VA stand ards defin ed in the  Standards  and Conven tions sect ion of thi s document , and will  conduct f ull unit t esting of  the functi onality an d verify p erformance  of all so ftware cod e before i t is relea sed to Lei dos SQA. S QA will th en perform  all appli cable test ing types  as describ ed in the  Testing Ph ases secti on of this  document.  The devel oper and S QA will re solve prob lems and a ddress iss ues as the y arise du ring testi ng and wil l document  issues us ing the Ra tional Tea m Concert  (RTC) defe ct trackin g tool.
  94   Test Envir onment
  95   Within fiv e working  days of ap proval of  this Remed iation Pla n, the dev eloper wil l configur e the deve lopment/te st environ ment on an  Austin In formation  Technology  Center (A ITC) serve r or other  VA-approv ed develop ment/test  environmen t used for  this inta ke product  and insta ll the rem ediated Ke rnel Insta llation an d Distribu tion Syste m (KIDS) b uild. The  environmen t will be  restored t o its orig inal basel ine state  by the Vis tA system  administra tor after  developmen t testing  is complet ed, follow ed by inst allation o f the reme diated sof tware.
  96   Upon notif ication fr om the dev eloper of  test envir onment rea diness, SQ A will com mence with  planned t esting act ivities. T he SQA tes t executio n and repo rting docu mentation  will resid e in the R ational Qu ality Mana ger (RQM)  “EPIP” Pro ject. In o rder to pe rform test ing of thi s VistA mo dification , the foll owing tool s will be  leveraged:  RQM, Refl ections em ulator, CP RS GUI v31  (1.0.30.7 5), and Sn agIt.
  97   Test Readi ness Revie w
  98   Leidos wil l conduct  a Test Rea diness Rev iew (TRR)  at the con clusion of  unit test ing to ver ify the co ntents of  the softwa re to be t ested, the  test sche dule, test  environme nts, test  participan ts, and as sociated l ogistics.  Leidos wil l provide  an agenda  prior to t he TRR and  written m inutes aft er complet ion of the  TRR, in a ccordance  with the P erformance  Work Stat ement (PWS ).
  99   Testing Ph ases
  100   Leidos wil l perform  developmen t and SQA  testing ac tivities i n phases,  and will p rovide all  required  testing do cumentatio n.
  101   Unit Testi ng
  102   The develo per will c onduct uni t testing  of individ ual units  of source  code to de termine if  they are  fit for us e. 
  103   Component  Integratio n and Syst ems Testin g (CI/ST)
  104   Component  Integratio n and Syst ems testin g will be  conducted  by SQA to  ensure tha t connecti vity to th e VistA ap plication  exists and  is functi oning norm ally. SQA  will recor d Passed/F ailed outc omes and c apture dis played con tent to do cument the  system te sting effo rt.
  105   Functional  Testing
  106   Functional  testing w ill be per formed by  SQA to tes t the code  modificat ions. This  testing w ill ensure  that the  software f unctionali ty is in a lignment w ith the Go vernment F urnished I nformation . SQA will  record Pa ssed/Faile d outcomes  and captu re display ed content  to docume nt the fun ctional te sting effo rt. 
  107   Regression  Testing
  108   Regression  testing w ill be per formed by  SQA to ens ure that t he remedia ted code d oes not in troduce er rors to ex isting fun ctionality . The regr ession tes t framewor k will be  kept up-to -date with  manual te st cases a nd test sc ripts defi ning the i nputs and  expected o utcomes. S QA will re cord Passe d/Failed o utcomes an d capture  displayed  content to  document  the regres sion testi ng effort.  
  109   Section 50 8 Complian ce Testing
  110   Section 50 8 testing  will be pe rformed on  VistA and  CPRS code  when new  CPRS GUI c hanges are  introduce d by the d eveloper.  The VA-rec ommended A ssistive T echnology  tool, JAWS , will be  used to co nduct the  508 testin g. Test re sults and  related do cumentatio n will be  submitted  to the VA  Section 50 8 team in  accordance  with the  VA 508 tes ting requi rements. D efects fou nd during  testing wi ll be asse ssed and r emediated  by the dev eloper.
  111   Documentat ion Remedi ation
  112   Leidos wil l review e xisting VA  documenta tion for p ossible im pact as a  result of  this remed iation eff ort, and w ill make u pdates whe re applica ble.
  113   To determi ne the exi sting VA d ocumentati on that re quires mod ification,  Leidos wi ll conduct  a thoroug h review o f the docu ments curr ently avai lable from  the VA So ftware Doc ument Libr ary (VDL)  located at  http:// DNS . Keyword  searches u sing terms  relevant  to this re mediation  effort wil l be used  to identif y document s that mig ht be impa cted; thos e document s were wil l then be  reviewed i n their en tirety for  any neede d revision s.
  114   The follow ing sectio ns outline  the VDL d ocuments t o be revis ed for thi s remediat ion.
  115   User Guide s
  116   The follow ing User G uide will  be updated  in the VD L:
  117   Radiology/ Nuclear Me dicine Use r Manual V ersion 5.0
  118   Installati on Guides
  119   The Nation al Patch M odule Patc h Descript ion docume nt for thi s remediat ion will p rovide the  procedure  for insta lling KIDS  packages  migrated f rom the te st environ ment to th e VA Pre-P roduction  environmen ts. Theref ore, no In stallation  Guides wi ll be upda ted.
  120   Technical  Manuals
  121   The follow ing Techni cal Manual  will be u pdated in  the VDL:
  122   Radiology/ Nuclear Me dicine Tec hnical Man ual Versio n 5.0
  123   Operations  Manuals
  124   No Operati ons Manual s require  revision a s a result  of this m odificatio n.
  125   Project Re porting
  126   Leidos wil l provide  interim pr ogress upd ates durin g daily Sc rum calls  and weekly  managemen t calls wi th VA repr esentative s. 
  127   Project Sc hedule
  128   Leidos wil l follow t he Scrum A gile metho dology for  software  developmen t. It is a nticipated  that this  patch wil l require  five 2-wee k sprints.  
  129   Deployment
  130   Leidos wil l create a  KIDS pack age contai ning the s oftware ch anges nece ssary to f ulfill the  requireme nts for th is remedia tion effor t. A KIDS  package, a long with  all relate d document ation, wil l be deliv ered to th e Contract ing Office  Represent ative (COR ) for acce ptance. If  accepted,  the KIDS  package ca n then be  released f or nationa l VA consu mption; ot herwise, L eidos will  correct a ny defects  found and  repeat th e necessar y remediat ion activi ties.
  131   Sustainmen t Requirem ents
  132   Leidos wil l provide  maintenanc e support  for 60 day s to the V A to suppo rt the fin al Class 1  product a fter it is  nationall y released .  
  133   Maintenanc e and Know ledge Tran sfer
  134   To facilit ate contin uous proce ss improve ment, Leid os will de liver Spri nt Review  and Retros pective sl ides and a  Lessons L earned Rep ort to VA  upon compl etion of t he final s print.
  135   XINDEX Lis ting for M UMPS Code  Changes
  136   The XINDEX  tool is t he standar d tool use d by the V A to analy ze MUMPS s ource code . Followin g is a lis ting of th e results  of the XIN DEX analys is of the  affected r outines.
  137   TBD
  138   Source Cod e Changes
  139   This appen dix displa ys the Vis tA code be fore and a fter the u pdates req uired for  this code  modificati on were im plemented.  The follo wing routi nes were a ffected:
  140   Modified r outines: R ADEM2
  141   New routin es: TBD
  142   RADEM2
  143   Before: 
  144   RADEM2 ;HI SC/CAH,FPT ,GJC-Displ ay Patient  Demograph ics (short ) ;10/20/9 4 09:18 ;; 5.0;Radiol ogy/Nuclea r Medicine ;**31**;Ma r 16, 1998 PAT Q:'$D( ^DPT(RADFN ,0)) S Y=^ (0),RANME= $P(Y,"^"), RASEX=$P(Y ,"^",2),RA SSN=$$SSN^ RAUTL,RADO B=$P(Y,"^" ,3),X1=DT, X2=RADOB D  ^%DTC S R AGE=X\365. 25 S:$E(DT ,4,7)=$E(R ADOB,4,7)  RAGE=RAGE+ 1 ; today  is birthda y S Y=RADO B D D^RAUT L S RADOB= Y N RAVETE LI S RAVET ELI=$$VETE LI(RADFN)  S RAVET=$P (RAVETELI, "^"),RAELI G=$P(RAVET ELI,"^",2)  I $D(^DPT (RADFN,.1) ),^(.1)]""  D ^RASERV DIS W @IOF ,!," ***** ****** Pat ient Demog raphics ** *********" ,! W !?2," Name : ",$ E(RANME,1, 20) W:$D(R AWARD) ?37 ,"Currentl y is an in patient."  W !?2,"Pt  ID : ",RAS SN W:$D(RA WARD) ?39, "Ward/Serv ice: ",$E( RAWARD_"/" _RASER,1,2 5) W !?2," Date of Bi rth: ",RAD OB," (",RA GE,")" W:$ D(RABED) ? 39,"Bedsec tion : ",R ABED W !?2 ,"Veteran  : ",RAVET, ?39,"Eligi bility : " ,$E(RAELIG ,1,25) W ! ?2,"Sex :  ",$S(RASEX ="M":"MALE ",RASEX="F ":"FEMALE" ,1:"Unknow n") I $D(^ RADPT(RADF N,1)) W !? 2,"Narrati ve : ",^(1 ) W !?2,"O ther Aller gies:",!?7 ,"'V' deno tes verifi ed allergy  'N' denot es non-ver ified alle rgy",! S D FN=RADFN D  ALLERGY^R ADEM I '$D (GMRAL) W  !?20,"** N o allergie s on file.  **" G ALE R F I=1:1  Q:'$D(PI(I )) W:I#2 ! ?2,PI(I) W :I#2=0 ?40 ,PI(I) ;AL ER ; S RAP OP=0 I $D( ^DPT(RADFN ,.35)),$P( ^(.35),"^" ) W !!?2,$ C(7),"****  Patient h as died ** **",!!,"Do  you want  to continu e? NO// "  R X:DTIME  S:"Nn"[X R APOP=1Q K  RAWD,PI,RA DOB,RAELIG ,RAGE,RASS N,RAVET,I, VAIN,VAERR ,X,Y Q:RAP OP  S RACO NT="" G ^R ADEM1 ;RAD FN S DIC(0 )="AEZMQ"  D ^RADPA Q :Y<0 S RAD FN=+Y G PA T ;VETELI( DFN) ; Is  this patie nt a veter an? Does t his patien t have a ;  primary e ligibility  code? ; R AELI=Prima ry Eligibi lity code  <-> RAVET= Veteran (Y es/No) N R AELI,RAVET  Q:DFN'=+D FN "Unknow n^Unknown"  I 'DFN!(' $D(^DPT(DF N,0))#2) S  (RAELI,RA VET)="Unkn own" E  D  . K VAEL,V AERR D ELI G^VADPT .  S RAELI=$P ($G(VAEL(1 )),"^",2)  . S RAELI= $S(RAELI]" ":RAELI,1: "Unknown")  . S RAVET =+$G(VAEL( 4)) . S RA VET=$S(RAV ET:"Yes",' RAVET:"No" ,1:"Unknow n") . K VA EL,VAERR .  Q Q RAVET _"^"_RAELI
  145   After: 
  146   RADEM2   ; HISC/CAH,F PT,GJC-Dis play Patie nt Demogra phics (sho rt) ;10/20 /94 09:18       ;;5.0 ;Radiology /Nuclear M edicine;** 31**;Mar 1 6, 1998PAT    Q:'$D(^ DPT(RADFN, 0)) S Y=^( 0),RANME=$ P(Y,"^"),R ASEX=$P(Y, "^",2),RAS SN=$$SSN^R AUTL,RADOB =$P(Y,"^", 3),X1=DT,X 2=RADOB D  ^%DTC S RA GE=X\365.2 5      S:$ E(DT,4,7)= $E(RADOB,4 ,7) RAGE=R AGE+1 ; to day is bir thday       S Y=RADOB  D D^RAUTL  S RADOB=Y       N RA VETELI S R AVETELI=$$ VETELI(RAD FN)      S  RAVET=$P( RAVETELI," ^"),RAELIG =$P(RAVETE LI,"^",2)       I $D( ^DPT(RADFN ,.1)),^(.1 )]"" D ^RA SERVDIS    W @IOF,!,"  ********* ** Patient  Demograph ics ****** *****",!       W !?2, "Name : ", $E(RANME,1 ,20) W:$D( RAWARD) ?3 7,"Current ly is an i npatient."       W !? 2,"Pt ID :  ",RASSN W :$D(RAWARD ) ?39,"War d/Service:  ",$E(RAWA RD_"/"_RAS ER,1,25)       W !?2, "Date of B irth: ",RA DOB," (",R AGE,")" W: $D(RABED)  ?39,"Bedse ction : ", RABED       W !?2,"Ve teran : ", RAVET,?39, "Eligibili ty : ",$E( RAELIG,1,2 5)      W  !?2,"Sex :  ",$S(RASE X="M":"MAL E",RASEX=" F":"FEMALE ",1:"Unkno wn") I $D( ^RADPT(RAD FN,1)) W ! ?2,"Narrat ive : ",^( 1)      ;R TW Add hei ght and we ight *** B EGIN ***       D ;       . N ARH DVITL,ARHD X,DFN,GMRV STR,X,Y       . F ARH DVITL="HT" ,"WT" D       .. S DF N=RADFN,GM RVSTR=ARHD VITL       .. D EN6^G MRVUTL S A RHDX=$G(X)       .. W  !?2,$E(AR HDVITL),"e ight : ",$ P(ARHDX,U, 8)      ..  I $P(ARHD X,U,8)]""  W $S(ARHDV ITL="HT":" """,ARHDVI TL="WT":"  lbs",1:"")       .. S  Y=$P(ARHD X,U,1) I Y >0 D D^RAU TL W " on  ",Y      . . Q      .  Q     ;RT W Add heig ht and wei ght *** EN D ***       W !?2,"Ot her Allerg ies:",!?7, "'V' denot es verifie d allergy  'N' denote s non-veri fied aller gy",!       S DFN=RAD FN D ALLER GY^RADEM I  '$D(GMRAL ) W !?20," ** No alle rgies on f ile. **" G  ALER       F I=1:1 Q :'$D(PI(I) ) W:I#2 !? 2,PI(I) W: I#2=0 ?40, PI(I)       ;ALER   ;       S RA POP=0 I $D (^DPT(RADF N,.35)),$P (^(.35),"^ ") W !!?2, $C(7),"*** * Patient  has died * ***",!!,"D o you want  to contin ue? NO// "  R X:DTIME  S:"Nn"[X  RAPOP=1Q    K RAWD,PI ,RADOB,RAE LIG,RAGE,R ASSN,RAVET ,I,VAIN,VA ERR,X,Y Q: RAPOP S RA CONT="" G  ^RADEM1       ;RADFN    S DIC(0) ="AEZMQ" D  ^RADPA Q: Y<0 S RADF N=+Y G PAT       ;VET ELI(DFN)    ; Is this  patient a  veteran?  Does this  patient ha ve a       ; primary  eligibilit y code?       ; RAELI =Primary E ligibility  code <->  RAVET=Vete ran (Yes/N o)      N  RAELI,RAVE T Q:DFN'=+ DFN "Unkno wn^Unknown "      I ' DFN!('$D(^ DPT(DFN,0) )#2) S (RA ELI,RAVET) ="Unknown"       E D       . K V AEL,VAERR  D ELIG^VAD PT      .  S RAELI=$P ($G(VAEL(1 )),"^",2)       . S R AELI=$S(RA ELI]"":RAE LI,1:"Unkn own")       . S RAVET =+$G(VAEL( 4))      .  S RAVET=$ S(RAVET:"Y es",'RAVET :"No",1:"U nknown")       . K VA EL,VAERR       . Q       Q RAVET _"^"_RAELI