7. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 4/11/2019 2:37:09 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.

7.1 Files compared

# Location File Last Modified
1 ES5.6_docs.zip\ESM TS - ES VET360.docx Wed Mar 27 20:26:46 2019 UTC
2 ES5.6_docs.zip\ESM TS - ES VET360.docx Thu Apr 11 18:20:57 2019 UTC

7.2 Comparison summary

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

7.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

7.4 Active regular expressions

No regular expressions were active.

7.5 Comparison detail

  1   Enrollment  System (E S)
  2   VET360
  3   Technical  Specificat ion
  4  
  5   Department  of Vetera ns Affairs
  6   Office of  Informatio n and Tech nology (OI T)
  7   Product De velopment
  8   Documentat ion Versio n 1.1
  9  
  10  
  11   Revision H istory
  12   Date
  13   Revision
  14   Descriptio n
  15   Author
  16   01/30/2019
  17   1.1
  18   Address Va lidation
  19   Chenjie Yu
  20   01/22/2019
  21   1.0
  22   Initial do cument
  23   Wen Lin an d Trinadh  Kavuri
  24  
  25   Table of C ontents
  26   1Introduct ion4
  27   1.1Purpose 4
  28   1.2Scope4
  29   2Phone Num ber and Em ail Logica l Deletion 5
  30   2.1Change  Request 79 05905
  31   2.2Code Ch anges5
  32   2.2.1VET36 0InboundPr ocessServi ce Code Ch anges5
  33   3Share ID  with Vet36 07
  34   3.1Change  Request 79 55837
  35   3.2Code Ch anges7
  36   3.2.1VET36 0 Model Ch anges7
  37   4ES Addres s Validati on10
  38   4.1Change  Request10
  39   4.2Code Ch anges10
  40   4.2.1User  Interface  (UI) Chang es10
  41   4.2.1.1Add ress Valid ation Meth od11
  42   4.2.1.2Add ress Conve rsion From /To Model1 2
  43   4.3Model a nd Service  Layer Cha nges14
  44  
  45  
  46   Introducti on
  47   Purpose
  48   The purpos e of this  document i s to discu ss changes  to system  component s and proc esses rela ted to VET 360 integr ation with  the Enrol lment Syst em (ES). 
  49   Scope
  50   Technical  specificat ion descri bes the de sign relat ed to VET3 60 integra tion. 
  51   Phone Numb er and Ema il Logical  Deletion
  52   Change Req uest 79059 0
  53   CR 790590  business r equirement s describe  the chang es to ES t o process  logical de letes from  Vet360 fo r phone nu mber and e mail.
  54  
  55   If ES rece ives an ef fective en d date wit h an
  56   Then
  57   Associated  phone num ber from V et 360
  58   ES will co nsider tha t a logica l delete a nd move th at phone n umber on f ile to his tory.    
  59   Associated  email add ress from  Vet 360
  60   ES will co nsider tha t a logica l delete a nd move th at email o n file to  history.  
  61  
  62   Code Chang es
  63   VET360Inbo undProcess Service Co de Changes
  64   If VET360  Phone enti ty has an  effective  end date,  which is b efore the  current ti mestamp, t he phone t ype and ph one number  digits ma tch with t he on-file  phone num ber and th en deletes  the phone  number. F igures 1 a nd 2 below  describes  the simil ar changes  for email  object.
  65  
  66  
  67   Figure 1:  Code chang es to VET3 60InboundP rocessServ ice.java u pdatePhone s
  68  
  69  
  70   Figure 2:  Code chang es to VET3 60InboundP rocessServ ice.java u pdateEmail s
  71   Share ID w ith Vet360
  72   Change Req uest 79558 3
  73   CR 795583  business r equirement s describe  the chang es to the  ES to shar e user ID  and Site I dentifier  with VET36 0.
  74  
  75   ES will se nd the use r ID when  a user edi ts/adds co ntact info rmation (A ddress, Ph one, email ) as well  as Site id entifier t o VET 360.
  76  
  77   Table 1: V ET360 Chan ges by Int erface
  78   Interface
  79   Current
  80   To be
  81   HCA
  82   originatin gSourceSys tem : HEC
  83   sourceSyst emUser" :  anonymousU ser
  84  
  85   originatin gSourceSys tem" : HEC
  86   sourceSyst emUser" :  VOA event
  87  
  88   VistA
  89   originatin gSourceSys tem" : VAM C
  90   sourceSyst emUser" :   anonymous User
  91  
  92   originatin gSourceSys tem" : VAM C
  93   ourceSyste mUser" :   VAMC-608
  94   ES UI
  95  
  96   originatin gSourceSys tem : HEC
  97   sourceSyst emUser" :    DNS
  98  
  99   originatin gSourceSys tem : HEC
  100   sourceSyst emUser" :    DNS
  101  
  102  
  103   Code Chang es
  104   VET360 Mod el Changes
  105   Previously , ES was s ending the  sourceSys temUser as  anonymous  when the  object is  modified b y HCA or V istA. In t he databas e, the rec ord “modif ied by” wi ll be eith er a “VOA  Event” or  “VAMV site  code”. Be cause thes e are not  real user  accounts,  developers  changed t he API to  get the lo gical Id a s shown in  Figures 3 -6 below. 
  106  
  107  
  108   Figure 3:  Code chang es to Addr esBio.java
  109  
  110  
  111   Figure 4:  Code chang es to BioB ase.java
  112  
  113  
  114   Figure 5:  Code chang es to Emai lBio.java
  115  
  116  
  117   Figure 6:  Code chang es to Phon eBio.java
  118   ES Address  Validatio n
  119   Change Req uest 
  120   User story  788100 Re al Time Va lidation o f Addresse s. When an  ES user e nters addr ess inform ation, the  ES provid es a displ ay that al lows real- time valid ation of a ddresses.
  121   Code Chang es
  122   User Inter face (UI)  Changes 
  123   Changes to  the ES us er interfa ce (UI) on  the Demog raphics, A ddresses s creen incl ude adding  new field s for real -time addr ess valida tion. The  new fields  include t hree parts :
  124   Two radio  buttons fo r the ES u ser to sel ect the ad dress to u pdate and  a selectio n item for  candidate  addresses  from the  validation  service r esponse. 
  125   Validated  address de tails disp lay on the  right-sid e of origi nal addres s. 
  126   A Run Addr ess Valida tion butto n displays  under the  validated  address. 
  127   UI changes  update th e Demograp hicMessage s.properti es, demogr ahicAddAdd ress.jsp a nd Demogra phicAddres sesForm.ja va files.
  128   File: Demo graphicAdd ressesForm .java
  129  
  130  
  131   Figure 7:  Validated  Address Va riables
  132  
  133  
  134   Figure 8:  Address Va lidation U I
  135  
  136   Address Va lidation M ethod
  137   The Addres s Validati on Functio n adds the  new actio n method v alidateSer vice() int o Demograp hicAddress esAction.j ava file.  This metho d sends th e address  data from  the origin al address  to call t he validat ion server . After it  receives  the Candid ateAddress Response d ata, it wi ll store t he data in to the new  validated  address f ields in D emographic AddressesF orm.
  138   File: Demo graphicAdd ressesActi on.java
  139  
  140   Figure 9:  validateSe rvice() me thod
  141  
  142  
  143   Address Co nversion F rom/To Mod el
  144   Two change s were mad e in the D emographic AddressesC onversionS ervice.jav a file: 
  145   Add a new  method con vertValida teAddressT oAddress()  into Demo graphicAdd ressesConv ersionServ ice.java f ile. 
  146   Update the  convertFo rmToPerson () method.  
  147   Perform th e followin g steps be low to sto re a valid ated addre ss:
  148   Check the  value of t he new Boo lean varia ble isOrig inalAddres s(). 
  149   Run the ne w convertV alidateAdd ressToAddr ess() meth od to repl ace the or iginal con vertFormTo Address()  method if  it is fals e.
  150   convertVal idateAddre ssToAddres s() method  converts  the valida ted addres s data in  Demographi cAddresses Form to an  Address o bject. 
  151  
  152   If
  153   Then
  154   True
  155   The origin al standar d address  will be co nvert to t he Address  object
  156   False
  157   The new co nvertValid ateAddress ToAddress( ) method w ill be use d to conve rt the val idated add ress to th e Address  Object.
  158  
  159   File: Demo graphicAdd ressesConv ersionServ ice.java
  160  
  161  
  162  
  163   Figure 10:  convertVa lidateAddr essToAddre ss() metho d
  164  
  165  
  166   Figure 11:  Store Val idated Add ress
  167  
  168   Model and  Service La yer Change s
  169   The VET360  Universal  Addressin g Module ( UAM) servi ce provide s address  validation  service.  The UAM se rvice rece ives the r equest, wh ich includ es the ori ginal addr ess, as we ll as send s the resp onse that  includes c andidate a ddresses.  In ES, new  AddressVa lidationSe rvice.java  and Addre ssValidati onServiceI mpl.java f iles were  added for  the addres s validati on service . Furtherm ore, candi date addre ss related  class fil es were ad ded for th e objects  using the  request an d response . Model cl asses are  generated  using Swag ger, code- gen tool. 
  170  
  171  
  172   Figure 12:  candidate  address r elated cla ss
  173  
  174  
  175  
  176   Figure 13:  Vet360 Va lidation S ervice Seq uence Diag ram
  177  
  178  
  179  
  180  
  181   Figure 14:  VET360 Cl ass