17. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 5/8/2017 10:03:18 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.

17.1 Files compared

#	Location	File	Last Modified
1	var-utility-web-Release-1.0.0-Branch.zip\MHED_VAR_DOCS	Utility_v1.1.0_Requirements+Traceability+Matrix+(RTM).docx	Mon May 8 15:43:47 2017 UTC
2	var-utility-web-Release-1.0.0-Branch.zip\MHED_VAR_DOCS	Utility_v1.1.0_Requirements+Traceability+Matrix+(RTM).docx	Mon May 8 18:45:50 2017 UTC

17.2 Comparison summary

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

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

17.4 Active regular expressions

No regular expressions were active.

17.5 Comparison detail

	1	Utility_v1 .1.0_Requi rements Tr aceability Matrix (R TM)
	2
	3	rtm-requir ment docum ent
	4	Key
	5	Summary
	6	Descriptio n
	7	rtm-testab le
	8	rtm-test i d
	9	rtm-test n ame
	10	rtm-pass/f ail
	11	JIRA
	12	VARUT-3
	13	Utility - Connectivi ty Error H andling
	14	As a userI want to b e aware if the app i s unable t o communic ate to the databaseS o that I c an take ap propriate action
	15	Discussion : This fea ture is ab out the de vice’s con nection to HA/VAMF. If the use r makes a request th at require s the app to connect to the HA server an d that con nection ca nnot be ma de, the ap p will pre sent a mes sage. Addi tionally, as part of the same check, if the app de tects the user is NO T connecte d to the i nternet ba sed upon s tandard W3 C calls, t he app wil l provide a message about the lack of in ternet con nectivity in place o f the mess age that i ndicates t he server is not cur rently ava ilable.
	16	User Accep tance Crit eria:1. Gi ven a user who has l ost their internet c onnection, when the user takes an action in the ap p that req uires inte rnet conne ctivity, t he system displays a warning m essage:1.1 . Header: Connection Error1.2. Text: You r internet connectio n appears to be unav ailable. P lease try again when you regai n connecti vity.1.3. OK button1 .3.1. Sele cting OK c loses the modal and returns th e user to the app wi th focus p laced on t he header of the las t screen t hey were w orking on. Existing screen dat a will con tinue to d isplay unt il the use r closes t he app. 2. Given a u ser who is working i n the app when the H A/VAMF sys tem become s unavaila ble, the s ystem disp lays a war ning messa ge:2.1. Ti tle: Error 2.2. Text: The syste m cannot b e reached. If the se rver is un available you will b e unable t o use this applicati on. You ca n close yo ur browser and try a gain later or try to reconnect now.2.3. Retry butt on, alt te xt Retry2. 3.1. Selec ting Retry executes the most r ecent tran saction2.4 . Close bu tton, alt text Close 2.4.1. Sel ecting Clo se closes the modal and return s the user to the he ader of th e screen t hey were l ast workin g on.
	17	Y
	18	* VARUT-18 5* VARUT-1 83
	19	* Validate session t imeout war ning and l ogout* Val idate the error mess age displa yed due to connectiv ity issues
	20	PassPass
	21	JIRA
	22	VARUT-4
	23	Utility - Session Ti meout - Wa rning and Logout
	24	As a userI want to b e aware if my authen tication s ession is about to e nd So that I can ext end my ses sion if ne eded
	25	Discussion : VA mobil e apps are built so that an au thenticati on session ends auto matically after 15 m inutes of inactivity . This ina ctivity re fers to of any app t hat is par t of the a uthenticat ion sessio n.
	26	User Accep tance Crit eria: 1. W hen an aut henticated user has been inact ive for 12 minutes, the system displays an alert:1 .1. Header : Your use r session will time out in X m inutes.1.2 . Text:
	27	To help pr otect your informati on, your u ser sessio n times ou t after 15 minutes.
	28	If you are actively using your mobile ap ps, simply select Co ntinue to reset the session. Y ou can als o select L ogout to l ogout of y our user s ession now .
	29	1.3. Logou t button, alt text L ogout1.3.1 . Selectin g Logout l ogs the us er out of all VA app s and retu rns the us er to the unauthenti cated land ing page1. 4. Continu e Button, alt text C ontinue1.4 .1. Select ing contin ue closes the modal and return s the user to the he ader of th e main scr een2. The minutes re maining co unter in t he modal h eader will update ea ch minute that no ac tion is ta ken up unt il 15 minu tes of ina ctivity. W hen 15 min utes is re ached the user is lo gged out o f the syst em and a S ession end ed message is shown on top of a darkened screen ba ckground w here all d ata fields obscured: 2.1. Heade r: Login S ession End ed2.2. Tex t: Select Launchpad to be take n to the L aunchpad. Select log in to log back into the applic ation you were using .
	30	2.3. Launc hpad butto n, alt tex t Launchpa d2.3.1. Se lecting La unchpad cl oses the a pplication and retur ns the use r to the L aunchpad
	31	Select log in to log back into the applic ation you were using .2.4. Logi n button, alt text L ogin2.4.1. Selecting Login ope ns the VA staff auth entication screen
	32	Y
	33	* VARUT-18 3* VARUT-1 85
	34	* Validate the error message d isplayed d ue to conn ectivity i ssues* Val idate sess ion timeou t warning and logout
	35	PassPass
	36	JIRA
	37	VARUT-5
	38	Utility - Unauthenti cated Land ing Page
	39	As the VAR Utility U sersWe wan t to see b asic app i nformation and login access on the utili ty landing pageSo we can under stand what the tool is and ele ct to logi n if desir ed
	40	Criteria:1 .. An unau thenticate d landing page is pr ovided tha t provides basic too l informat ion.1.2. H eader Bar – Tool Nam e: VAR Uti lity1.3. P age body:1 .4. Name o f utility: VAR Utili ty1.5. Des cription:
	41	The VAR Ut ility allo ws users t o manage t he VA Heal th Care fa cility app ointment a nd request offerings available in the VA R Appointm ent app.
	42	Valid faci lity login credentia ls are req uired to u se this to ol.
	43	1.6. Login button1.6 .1. Select ing the Lo gin button redirects users to the VAMF s taff authe ntication login scre en.1.7. Fo oter: 1.7. 1. VAR Uti lity – v1. 0.0 (left aligned)1. 7.2. Not L ogged In ( right just ified on l arger form factors, aligned un der app na me in foot er on smal ler form f actors)
	44	Note: The following actions ar e external to utilit y:1. Users supply lo gin creden tials and specify a facility a s part of the VAMF s taff authe ntication process. 2 . Failed V AMF authen tication a ttempts ar e handled by the VAM F authenti cation scr eens.
	45	Y
	46	* VARUT-41
	47	* VAR Util ity - Unau thenticate d Landing page
	48	Pass
	49	JIRA
	50	VARUT-8
	51	Utility - User Menu & Logout
	52	As a userI want to v iew a user menuSo I can access an About screen and a logout button.
	53	Criteria:
	54	1 When the user sele cts the us er menu ic on, the us er menu is shown:
	55	1.1 Label: User Menu 1.2 Button (bottom): Logout (d isplayed w hen user i s logged i n) - Retur ns user to unauthent icated lan ding page. Login (dis played whe n user is logged out .)
	56	Y
	57	* VARUT-13 3
	58	* Validate the link logout und er User Me nu
	59	Pass
	60	JIRA
	61	VARUT-9
	62	Utility - About page
	63	As a user I want to access inf ormation a bout the a ppSo I can understan d what the app does and which version I am accessi ng
	64	1. When a user selec ts About f rom the Us er Menu, t he system displays t he About i nformation in a moda l screen:1 .1. Header : About1.2 . App name and versi on number1 .3. Text: The VAR Ut ility allo ws users t o set faci lity-level configura tions for the VAR ap p.1.5. OK button, Sc reen reade r text mat ches butto n text1.5. 1. Selecti ng the OK button clo ses the mo dal and re turns the user focus to the Ab out menu b utton
	65	Y
	66	* VARUT-18 0
	67	* Validate the About Page cont ent for Va r Utility
	68	Pass
	69	JIRA
	70	VARUT-12
	71	Utility - Authorizat ion
	72	As a Utili ty Busines s OwnerI w ant to req uire VAR U tility Use rs to comp lete an au thorizatio n step bef ore access ing the VA R UtilityS o that I l imit VAR U tility Use r access t o select i ndividuals
	73	Criteria:1 . After su ccessful V AMF authen tication, users cred entials ar e checked for the ex istence of a VistA s cheduling key:
	74	NAME: SD S UPERVISORN ote: Key d esignation should be configura ble
	75	2. If the user's cre dentials i nclude thi s key, a l anding pag e is shown that demo nstrates t he user ha s successf ully been authorized .
	76	2.1 App ti tle "VAR U tility" is shown in header2.2 Footer dis plays: "VA R Utility - v1.0.0" (left just ified); Lo gged in as <username > (right j ustified)
	77	(Full page content i s detailed in a sepa rate story )
	78	3. If the user's cre dentials d o not incl ude the au thorizatio n key, the user is s hown a lan ding page (not autho rized view ) that inc ludes a me ssage indi cating the failed au thorizatio n and inst ructions f or obtaini ng help:
	79	2.1 App ti tle "VAR U tility" is shown in header2.2 Footer dis plays: "VA R Utility v1.0.0" (l eft justif ied); Logg ed in as < username> (right jus tified)2.3 . Page bod y2.3.1. Pa ge Body:
	80	Welcome <u ser first name> <use r last nam e><date - formatted as Month D D, YYYY>
	81	Your crede ntials do not suppor t authoriz ation to u se this ap p. Please contact yo ur supervi sor for as sistance. (offset in error tex t box styl e)
	82	Mockup: Ut ility - No t Authoriz ed Home Pa ge 0323201 6.pdf on: https:// DNS /display/A RA/Wirefra mes+and+Mo ckups
	83	Dev notes: Includes:t est data s etupstaff logins wit h role and without r ole
	84	Y
	85	* VARUT-12 9
	86	* Utility Authorizat ion - Vali date Autho rization a nd access to VAR uti lity
	87	Pass
	88	JIRA
	89	VARUT-13
	90	Utility - Direct App ointments - View/Edi t Service Patient Hi story Limi t
	91	As a userI want to v iew/edit t he number of days (p atient his tory limit ) in which a patient must have had conta ct with a given serv ice in ord er to sche dule an ap pointmentS o that I c an view an d update t he setting
	92	1. When a user selec ts the "Di rect Sched uling" opt ion in Pan el 2, the Detail vie w (panel 3 ) is updat ed to show the Direc t Scheduli ng setting options.
	93	1.1 Subhea der bar la bel: Direc t Scheduli ng1.2 Titl e: Patient History O ptions1.3 Instructio nal Text: For the ca re types l isted belo w, provide the direc t scheduli ng Patient History o ptions sup ported by the instit ution and its includ ed divisio ns.1.3.1 * Required field
	94	1.4 Reset button: al t text "Re set" selec ting retur ns the tab le options to the la st saved e ntries.1.5 Save butt on: alt te xt "Save", selecting saves the updates t he setting s displays a confirm ation moda l:1.5.1 Ti tle “Confi rmation”1. 5.2 Text “ The Direct Schedulin g settings have been saved.” 1 .5.3 OK bu tton; when selected, the confi rmation mo dal closes , focus is returns t o the Save button on the Direc t Scheduli ng Page.1. 5.4 A hori zontal rul e separate s the text and OK bu tton1.5.6 A horizont al rule se parates th e Confirma tion title and text.
	95	1.6. Patie nt History Options T able1.7 Co lumn 1 - T ype of Car e: Lists a ll types o f care sup ported by VAR1.7.1 D isplays th e patient friendly n ame for th e stop cod e combinat ions relat ed to that service, all of whi ch are sto red in the VAR utili ty DB1.8 C olumn 2 - Require Re lationship to Schedu le 1.8.1 F or Primary Care, dis play "PACT Team Assi gnment" as static te xt.1.8.2 F or remaini ng care ty pes, displ ay a drop down selec tion list, default s election t o "Select" (null); o ther list values are : Yes, No1 .9 Column 3 - Last S een Within (Months) * (require d when an input cont rol is pre sent)1.9.1 When Requ ire Relati onship to Schedule i s set to " Yes" displ ay a drop down list selection control (d efault to null/"Sele ct") with the follow ing option s (order a s listed): 24 months (730 days) 12 months (365 days)
	96	1.10 Save and Cancel buttons a re replica ted at the bottom of the scree n. (Mimic VAR New Ap pointment/ Request la yout place ment).
	97	Y
	98
	99
	100
	101	JIRA
	102	VARUT-16
	103	Utility - Authentica tion
	104	As a Utili ty UserI w ant to acc ess the Ad ministrati on Utility for my fa cility usi ng my VAMF credentia lsSo that I can auth enticate w ith existi ng credent ials
	105	Criteria:
	106	1. When a user selec ts the Log in button on the Uti lity unaut henticated landing p age, the s ystem redi rects user s to the V AMF staff authentica tion login screen.
	107	Technical comments:1 . Utility should hav e its own client id and secret .2. Create a Utility specific resource t o retrieve token. Th is will be part of v ar-utility -resources . VA has d eveloped a library t o retrieve token. Pl ease revie w that lib rary and u se it if i t does not have any issues.3. Security f or the tok en should be IS_AUTH ENTICATED_ ANONYMOUSL Y. This sh ould be on ly enabled for token endpoint. All other dependenc ies should require f ully authe ntication and ROLE_S TAFF autho rization. This shoul d be defau lt setting for /* wi ld card.4. REST depe ndencies o n the var utility ap p should b e managed to resourc e director y. Resourc e director y conventi on should be followe d quite si milar to V AR app.5. For servic es, start with versi on v1 in t he URL and this shou ld be defi ned in the web.xml.
	108	Y
	109	* VARUT-13 7
	110	* Validate Staff Log in page
	111	Pass
	112	JIRA
	113	VARUT-17
	114	Utility - Authentica ted & Auth orized Lan ding page
	115	As an auth enticated and author ized userI want to b e aware of the insti tutions af fected by my setting changesSo that I am aware of the scope of impact
	116	1. After a user has authentica ted and au thorized i nto the VA R Utility, a landing page is s hown.
	117	1.1 Header bar: Home icon, alt text Home ; selectin g from any screen re turns the user to th e home pag e Dev Note : No App O ptions men u (panel 1 ) formerly available by select ing the "h amburger i con" is in cluded in the header bar.
	118	1.2 Primar y Header b ar label: VAR Utilit y
	119	2. Primary View - di splayed (p anels 2 an d 3):
	120	Panel 2 - Label: Man age Settin gsPanel 3 - Label: H ome
	121	3. Panel 2 - Manage Settings o ptions3.1 Two option s are show n under ma nage setti ngs (funct ionality i s describe d in separ ate storie s); none a re selecte d by defau lt3.1.1. D irect Sche duling
	122	4. Panel 3 - Detail4 .1 Subhead er bar lab el: Home4. 2 Content:
	123	Display th e followin g text (mi rror landi ng page st yle):
	124	Welcome <U ser first name> <Use r last nam e><date Mo nth dd, YY YY>
	125	Facility: <Primary I nstitution Name>
	126	Update VAR Settings by selecti ng an opti on from th e left han d menu. No te that an y changes to this fa cility's s ettings al so affect all of the facility' s related divisions.
	127	Mockup: ht tps:// DNS /display/A RA/Wirefra mes+and+Mo ckups
	128	Dev notes:
	129	Data sourc e for Prim ary Instit ution name is derive d from the staff log in credent ials
	130	Y
	131	* VARUT-13 1
	132	* Validate the landi ng page fo r an autho rized user
	133	Pass
	134	JIRA
	135	VARUT-60
	136	Utility - Navigate w ithout Sav ing Warnin g
	137	As a userI want to b e warned i f I try to navigate away from utility fo rm edits w ithout sav ing So tha t I don't accidental ly lose da ta I've en tered
	138	Dev Note: initial wo rk on bran ch
	139	Y
	140	* VARUT-21 2
	141	* Utility- Validate t he confirm ation moda l displaye d on exiti ng without save
	142	Pass
	143	JIRA
	144	VARUT-81
	145	Utility - User Guide and Link
	146	Create a u tility use r guide
	147	Provide a link to th e utility user guide at the bo ttom of th e About sc reen
	148	See the Us er Guide f or more de tailed ins tructions for using this app. (Hyperlink the word "user guid e" to the PDF).
	149	Y
	150	* VARUT-22 9
	151	* Validate the user guide link on the Ab out Page
	152	Pass
	153	JIRA
	154	VARUT-82
	155	Utility - Requests - View/Edit Service S ettings - Shell
	156	As a userI want to v iew/edit p rimary car e request options fo r my facil itySo that I can vie w and upda te the set ting
	157	1. When a user views the Manag e Settings list in t he VAR Uti lity an op tion label ed "Reques ts" is ava ilable in the list ( displayed below Dire ct Schedul ing).When a user sel ects "Requ ests", the Detail vi ew (panel 3) is upda ted to sho w the Requ est settin g options.
	158	1.1 Subhea der bar la bel: Reque sts1.2 Tit le: Reques t Settings 1.3 Instru ctional Te xt: For th e care typ es listed below, set the Reque st options supported by the in stitution and its in cluded div isions.1.3 .1 * Requi red field
	159	1.4 Reset button: al t text "Re set" (disp layed in p anel subhe ader bar) 1.5 Save b utton: alt text "Sav e", (displ ayed in pa nel subhea der bar)
	160	1.6. Reque st Setting s table - Column lab els:1.6.1 Column 1 - Type of C are: 1.6.2 Column 2 - Supporte d at this Facility?1 .6.3 Colum n 3 - *Las t Seen Wit hin (Month s) (requir ed)1.7 Hor izontal Ru le shown b elow grid1 .8 Reset b utton; rig ht aligned (duplicat es control shown in subheader bar)1.9 Sa ve button, right ali gned (dupl icates con trol shown in subhea der bar)
	161	Y
	162	* VARUT-35 7
	163	* Validate the Reque st Setting s on Utili ty
	164	Not tested
	165	JIRA
	166	VARUT-219
	167	VAR Utilit y - Direct Schedulin g Screen - Update la bels
	168	1) Update column 2 ( formerly R equire rel ationship to schedul e) to read : Supporte d at this Facility? (not requi red; all s electable fields wil l default to No) – r eview/disc uss requir ed status during pla nning
	169	2) Update row drop d own boxes for Audiol ogy, Optom etry and O utpatient Mental hea lth as fol lows:
	170	Change "Se lect" to " No"Change "No" to "Y es - Any V eteran"Cha nge "Yes" to "Yes - Based Upon Time Fram e"
	171	3) Change static tex t "PACT Te m Assignme nt" to "Ye s - PACT T eam Assign ment"
	172	Y
	173	* VARUT-26 7
	174	* Validate column na me change and drop d own value changes on Direct Sc heduling p age
	175	Pass
	176	JIRA
	177	VARUT-223
	178	Utility - Requests - View/Edit Service S ettings
	179	As a utili ty userI w ant to vie w/edit req uest optio ns for my facilitySo that I ca n view and update th e setting
	180	1. When a user views Request s ettings gr id, the fo llowing se tting para meters are shown:
	181	1.1 Type o f Care:
	182	List all t ype of car e found in the Utili ty db (dyn amically p ulled) e.g . Primary Care, Audi ology, Opt ometry, Ou tpatient M ental Heal th (Note: These are the defaul t values ( including case) that will be p rovided fo r the 3.1 release; u tility use rs may upd ate as nee ded)Labels matches n ame stored in VAR UT db)
	183	1.2 Suppor ted at thi s Facility ? Not requ ired; Drop down sele ct box;
	184	List optio ns for Pri mary Care row: No, Y es - Any V eteran; de fault to N oList opti ons for al l other ro ws: No, Ye s - Any Ve teran, Yes - Based U pon Time F rame; defa ult to No
	185	1.3 Last S een Within (Months)*
	186	Drop down select box condition ally displ ayed as re quired whe n Supporte d at this Facility = Yes - Bas ed Upon Ti me Frame; List value options: values: Se lect (null ), 24 Mont hs (730 Da ys), 12 Mo nths (365 Days); def ault to Se lect
	187	2. When th e user sel ects Save, the setti ngs are up dated in t he VAR UT db.
	188	3 Reset bu tton: alt text "Rese t" (displa yed in pan el subhead er bar) se lecting re turns the table opti ons to the last save d entries. 4 Save but ton: alt t ext "Save" , (display ed in pane l subheade r bar) sel ecting sav es the upd ates the s ettings di splays a c onfirmatio n modal:4. 1 Title “C onfirmatio n”4.2 Text “The Requ est settin gs have be en saved.” 4.3 OK bu tton; when selected, the confi rmation mo dal closes , focus is returns t o the Head er on the Requests p age.4.4 A horizontal rule sepa rates the text and O K button4. 5 A horizo ntal rule separates the Confir mation tit le and tex t.
	189	Y
	190	* VARUT-35 9
	191	* Validate the Reque st setting s on the r equest pag e on Utili ty
	192	Pass
	193	JIRA
	194	VARUT-294
	195	Utility - Launchpad Feature
	196	As a userI want to b e able to access Lau nchpad fro m within t he appSo t hat I can easily nav igate to o ther VA ap ps
	197	Acceptance criteria:
	198	1. When th e user vie ws the Use r Menu, a Launchpad button is shown:Loca tion: Bott om of menu above Log Out/Login button.Ic on: Airpla ne (not re ad by scre en reader) Label: Lau nchpadSele cting the link close s the app and naviga tes the us er to the VA Launchp ad; system retains u ser authen tication s tatus at t ime of but ton select ion
	199	2. When th e user sel ects Logou t from the user menu , the syst em logs th e user out of all VA apps, clo ses the ap p, and ret urns the u ser to the Launchpad .
	200	3. When th e user vie ws the Log in Session Ended mod al a link to Launchp ad is show n:Label: L aunchpadLo cation: Le ft of Logi n buttonLa bel: Launc hpadSelect ing the li nk closes the app an d directs the user t o the VA L aunchpad
	201	4. When th e user sel ects Logou t from the Session e nding warn ing modal, the user is directe d to the L aunchpad
	202	Y
	203	* VARUT-31 9
	204	* Validate Launchpad on user m enu and se ssion time out modal
	205	Pass
	206	JIRA
	207	VARUT-328
	208	Access Uti lity from Launchpad
	209	As a veter an userI w ant to be able to id entify the app on th e VA Launc hpad and w hen saved on my desk topSo that I can qui ckly find it and ope n it
	210	1. Web App : When a u ser views the app on Launchpad , a unique icon and short desc ription ar e displaye d. (Saving to home s creen on I E follows the patter n establis hed by oth er Launchp ad apps wh ereby a ge neric icon is shown. )2. When a user view the URL f or web-bas ed apps, a unique na me is used in the UR L. 3. App name shown on Launch pad: VAR U tility4. S hort descr iption on Launchpad: Configure facility settings f or Veteran VA Appoin tment mobi le app use .
	211	Note: Atta ch app ico ns in HTML 5 pixel si zes: 57, 7 2, 114, 14 4
	212	Y
	213	* VARUT-35 4
	214	* Test Acc ess Utilit y from Lau nchpad
	215	Not tested
	216	16 issues