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.
| # | 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 |
| Description | Between Files 1 and 2 |
|
|---|---|---|
| Text Blocks | Lines | |
| Unchanged | 3 | 358 |
| Changed | 2 | 4 |
| Inserted | 0 | 0 |
| Removed | 0 | 0 |
| 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 |
No regular expressions were active.
| 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 |
Araxis Merge (but not the data content of this report) is Copyright © 1993-2016 Araxis Ltd (www.araxis.com). All rights reserved.