Produced by Araxis Merge on 5/8/2017 10:03:19 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 | var-utility-web-Release-1.0.0-Branch.zip\MHED_VAR_DOCS | Utility_v1_Business+Requirements+Document+(BRD).docx | Mon May 8 15:44:04 2017 UTC |
| 2 | var-utility-web-Release-1.0.0-Branch.zip\MHED_VAR_DOCS | Utility_v1_Business+Requirements+Document+(BRD).docx | Mon May 8 18:51:10 2017 UTC |
| Description | Between Files 1 and 2 |
|
|---|---|---|
| Text Blocks | Lines | |
| Unchanged | 2 | 998 |
| Changed | 1 | 2 |
| 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 | Utility_v1 _Business Requiremen ts Documen t (BRD) | |
| 2 | ||
| 3 | VAR Utilit y | |
| 4 | Scheduling Enhanceme ntsWork Ef fort Under Schedulin g Enhancem ents Contr act | |
| 5 | Includes V AR Utility Release v 1.0.0 | |
| 6 | ||
| 7 | Business R equirement s Document | |
| 8 | February 2 016 | |
| 9 | BRD Versio n 1.0 | |
| 10 | ||
| 11 | Revision H istory | |
| 12 | Note: The revision h istory cyc le begins once chang es or enha ncements a re request ed after t he Busines s Requirem ents Docum ent has be en approve d. | |
| 13 | Date | |
| 14 | Descriptio n | |
| 15 | Author | |
| 16 | November 1 0, 2015 | |
| 17 | Initial ve rsion | |
| 18 | Jennifer Z inck | |
| 19 | Date when Business O wner/Busin ess Liaiso n and OI&T sign-off | |
| 20 | Approved v ersion | |
| 21 | Business O wner Name (date of a pproval) | |
| 22 | Business L iaison nam e (date of approval) | |
| 23 | OI&T name (date of a pproval) | |
| 24 | ||
| 25 | ||
| 26 | ||
| 27 | 1.Purpose | |
| 28 | The Busine ss Require ments Docu ment (BRD) is author ed by the business c ommunity f or the pur pose of ca pturing an d describi ng the bus iness need s of the c ustomer/bu siness own er. The BR D provides insight i nto the AS -IS and TO -BE busine ss area, i dentifying stakehold ers and pr ofiling pr imary and secondary user commu nities. It identifie s what cap abilities the stakeh olders and the targe t users ne ed and why these nee ds exist, providing a focused overview o f the requ est requir ements, co nstraints, and other considera tions iden tified. Th is documen t is a bus iness case and does not mandat e a develo pment meth odology, h owever the requireme nts are wr itten usin g agile me thodology terminolog y. The int ended audi ence for t his docume nt is the Office of Informatio n and Tech nology (OI &T). | |
| 29 | 2. Overvie w | |
| 30 | ||
| 31 | Who: The C onnected H ealth Offi ce (CHO) i s supporti ng this re quest. | |
| 32 | What: The request i s for the creation o f a Schedu ling Admin istration Utility th at include s: | |
| 33 | The abilit y to suppl y customiz ed message s related to user re gistration status an d availabi lity of se rvices for direct sc heduling | |
| 34 | The abilit y to selec t and edit direct ap pointment service of ferings fo r select F acilities/ Clinics | |
| 35 | When: The Period of Performan ce for the VAR enhan cements co ntract is September 28, 2015 t hrough Sep tember 27, 2016. | |
| 36 | Where the change wil l occur: The enhanc ements wil l be compl eted in th e VA Mobil e Framewor k (VAMF). | |
| 37 | How the IT solution will impro ve the bus iness proc ess: | |
| 38 | Provide sy stem admin istrator c ontrol and customiza tion of of ferings an d informat ion displa yed in VAR | |
| 39 | Why is the project n ecessary o r desired: The VAR enhancemen t project is needed to: | |
| 40 | Allow admi nistrators control o ver schedu ling optio ns and con tent | |
| 41 | 3.Scope | |
| 42 | The scope of this ef fort inclu des the fo llowing pr imary enha ncement ar eas: | |
| 43 | Enhancemen t | |
| 44 | Descriptio n | |
| 45 | CLIN 7 (PW S 5.2.6) - Create Sc heduling A dministrat ion Utilit y | |
| 46 | Allow VA facilities to locall y maintain custom me ssages and parameter s used by VAR and di rect sched uling capa bilities. | |
| 47 | ||
| 48 | 4. Custome r and Prim ary Stakeh olders | |
| 49 | Dr. Kathle en Frisbee , represen ting Conne cted Care (previousl y Connecte d Health), is the pr imary stak eholder fo r this req uest. Revi ew Appendi x C (link to be adde d) for the complete list of pr imary and secondary stakeholde rs. | |
| 50 | 5. Goals, Objective s, and Out come Measu res | |
| 51 | To be dete rmined by the busine ss owner. | |
| 52 | Goal/Objec tive | |
| 53 | Impact/Ben efit | |
| 54 | Measuremen t | |
| 55 | ||
| 56 | ||
| 57 | ||
| 58 | ||
| 59 | ||
| 60 | 6. Enterpr ise Need/J ustificati on | |
| 61 | ||
| 62 | Improve th e quality of health of Veteran s | |
| 63 | Increase t he quality of health care avail able throu gh the VHA | |
| 64 | Improve th e efficien cy of Prov iders as w ell as sup porting st aff | |
| 65 | Continuous ly expand Veteran's overall sa tisfaction with VA | |
| 66 | ||
| 67 | 7. Busines s Requirem ents | |
| 68 | 7.1. Theme s, Epics ( Needs), an d User Nar ratives (B usiness Re quirements ) | |
| 69 | ||
| 70 | The requir ements tab le below p rovides a list of th e epics th at are det ailed in t he Require ments Trac eability M atrix (RTM ) for this project. The RTM is stored as a separat e document and can b e accessed via the R equirement s Traceabi lity Link located on the Requi red Artifa cts wiki p age. | |
| 71 | ||
| 72 | Scheduling Administr ation Util ity Requir ements Tab le | |
| 73 | Identifier | |
| 74 | Epic | |
| 75 | VAR-1573 | |
| 76 | Scheduling Administr ation Util ity | |
| 77 | 7.2. User Access Lev els | |
| 78 | ||
| 79 | User Level | |
| 80 | Role | |
| 81 | Responsibi lities | |
| 82 | Access Lev el | |
| 83 | Primary | |
| 84 | Utility Us er | |
| 85 | View, Upda te facilit y direct a ppointment schedulin g configur ations for VAR | |
| 86 | View, Upda te facilit y request submission configura tions for VAR | |
| 87 | Scheduling Admin Acc ess (by fa cility) | |
| 88 | Provider a uthenticat ion with S D_Supervis or authori zation | |
| 89 | 7.3. Known Interface s and Data Sources | |
| 90 | This is th e business community ’s best un derstandin g of known interface s and may not be a c omprehensi ve listing . All requ ired inter faces will also be s tated as B usiness Re quirements in the RT M. | |
| 91 | Name of Ap plication | |
| 92 | Descriptio n of curre nt applica tion | |
| 93 | Interface Type | |
| 94 | ExistingFu nctionalit y | |
| 95 | Deliverabl es | |
| 96 | VAR (web) | |
| 97 | Veteran fa cing appoi ntment and request s ubmission system | |
| 98 | Automated | |
| 99 | No | |
| 100 | Ability to configure facility settings f or appoint ment reque sts and di rect booki ngs in VAR via the u tility | |
| 101 | VistA Aut horization Services | |
| 102 | ||
| 103 | Automated | |
| 104 | No | |
| 105 | Authentica tion with Auth Servi ces and un ique ident ifier to i dentify sc heduling s upervisors (administ rators for the utili ty) at eac h site | |
| 106 | 7.4. Relat ed Project s or Work Efforts | |
| 107 | VAR - Sche duling Enh ancements | |
| 108 | Scheduling Manager - Schedulin g Enhancem ents | |
| 109 | ||
| 110 | 8. Service Level Req uirements (SLR) | |
| 111 | ||
| 112 | 8.1. Avail ability | |
| 113 | SLR Questi on | |
| 114 | SLR Criter ia | |
| 115 | Descriptio n | |
| 116 | 1. How muc h time sho uld the sy stem be av ailable (a nd how muc h down tim e is accep table due to inciden t [unexpec ted] outag e)? | |
| 117 | 99% (3.65 days down time) | |
| 118 | 99.5% (1.8 3 days dow n time) | |
| 119 | 99.9% (8.7 6 hours do wn time) | |
| 120 | ||
| 121 | 2. When sh ould the s ystem be a vailable ( what will be the cor e operatin g hours of the syste m)? | |
| 122 | 9-5 standa rd weekday s | |
| 123 | 24-hour st andard wee kdays | |
| 124 | 24x7 | |
| 125 | ||
| 126 | 3. How soo n should t he system fully reco ver from a n outage? (Includes Mean Time to Restore [MTRS]) | |
| 127 | 8-24 hours | |
| 128 | 2-8 hours | |
| 129 | minutes | |
| 130 | ||
| 131 | 4. How muc h data wil l be resto red when o utage is r ecovered? | |
| 132 | 24 hours b ack | |
| 133 | 2-8 hours back | |
| 134 | 100% (cont inuous bac kup) | |
| 135 | ||
| 136 | 5. What ti me period should be considered for maint enance per iods? | |
| 137 | Early morn ing (defin e) | |
| 138 | After hour s (define) | |
| 139 | Overnight (define) | |
| 140 | ||
| 141 | 6. In what standard time zone will the s ystem oper ate? | |
| 142 | Local (spe cify time zone i.e., ET Standa rd) | |
| 143 | More than one time z one (speci fy) | |
| 144 | All time z ones | |
| 145 | ||
| 146 | 8.2. Capac ity and Pe rformance | |
| 147 | SLR Questi on | |
| 148 | SLR Criter ia | |
| 149 | Descriptio n | |
| 150 | 1.How many users wil l be on th e system h ourly? | |
| 151 | 1-100 | |
| 152 | 101-1000 | |
| 153 | >1000 | |
| 154 | ||
| 155 | 2. How man y transact ions will each avera ge user pe rform each hour? | |
| 156 | 1-5 | |
| 157 | 6-10 | |
| 158 | >10 | |
| 159 | ||
| 160 | 3. What ar e the anti cipated pe ak user ti mes during the day? | |
| 161 | Business d ay (specif y) | |
| 162 | Erratic Pe ak (specif y) | |
| 163 | No peak (s mall numbe r of users on system ) | |
| 164 | Other (spe cify) | |
| 165 | ||
| 166 | 4. What is the antic ipated pea k transact ion load ( when do yo u think th at there w ill be the most tran sactions b eing perfo rmed on th e system) during the day? | |
| 167 | Business D ay (specif y) | |
| 168 | Evenings ( specify) | |
| 169 | Weekends ( specify) | |
| 170 | None | |
| 171 | Other (spe cify) | |
| 172 | ||
| 173 | 5. How man y new user s will be added in o ne year? | |
| 174 | 0-100 | |
| 175 | 101-1000 | |
| 176 | >1000 | |
| 177 | ||
| 178 | 6. How man y more (if any) tran sactions w ill be add ed in one year? | |
| 179 | 0-5 | |
| 180 | 6-10 | |
| 181 | >10 | |
| 182 | ||
| 183 | 7. What ki nd of info rmation wi ll be stor ed? (Spec ify averag e of each kind per m onth) | |
| 184 | Small docu ments (exa mple pdf o r Word fil e) | |
| 185 | Forms & Do cuments th at are for matted (ex ample form s or docum ents with images) | |
| 186 | All Media (example v ideo, audi o, and med ical image s) | |
| 187 | ||
| 188 | 8. What ki nd of sear ch capacit y is requi red? | |
| 189 | Light (les s than 10 per hour) | |
| 190 | Medium (11 -1000 per hour) | |
| 191 | Heavy (gre ater than 1,000 per hour) | |
| 192 | ||
| 193 | 9. What ty pe of syst em(s) is/a re require d? | |
| 194 | Local (reg ional) | |
| 195 | Intranet ( All VA) | |
| 196 | Internet ( public) | |
| 197 | ||
| 198 | 10. Is the re a need for heavy applicatio n reportin g? If yes, when? | |
| 199 | None | |
| 200 | End of day | |
| 201 | End of mon th | |
| 202 | End of qua rter | |
| 203 | Other (spe cify) | |
| 204 | ||
| 205 | 8.3. Inter faces and Security | |
| 206 | If you ans wer "yes" to any of the follow ing questi ons, provi de an expl anation in the Descr iption col umn. | |
| 207 | SLR Questi on | |
| 208 | SLR Criter ia | |
| 209 | Descriptio n | |
| 210 | Does this system int eract with other exi sting syst ems? | |
| 211 | Yes | |
| 212 | VistA Auth Services, VAR web | |
| 213 | 2. Will th is system require ad ditional m onitoring for Inform ation Tech nology (IT ) system m etrics? | |
| 214 | Yes | |
| 215 | Use of Me trics Serv ice | |
| 216 | 3. Will th is system contain pe rsonally i dentifiabl e informat ion (PII), Protected Health In formation (PHI), Hea lth Insura nce Portab ility and Accountabi lity Act ( HIPAA) inf ormation, or other c onfidentia l/regulate d data? | |
| 217 | No | |
| 218 | ||
| 219 | 4. Who wil l be the a nticipated users of this syste m? | |
| 220 | ||
| 221 | Utility Us ers (VistA Schedulin g Clerks w ith the SD Superviso r scheduli ng key | |
| 222 | 9. Other C onsiderati ons | |
| 223 | 9.1. Alter natives | |
| 224 | Identify a lternative s the stak eholder pe rceives as available . These ca n include buying a c ommercial product, e nhancing a n existing capabilit y, buildin g a custom solution or simply maintainin g the stat us quo. In clude the major stre ngths and weaknesses of each a lternative as percei ved by the stakehold er or end user. | |
| 225 | 9.2. Assum ptions | |
| 226 | An assumpt ion is a s tatement t hat is pre sumed to b e true wit hout concr ete eviden ce to supp ort it. As sumptions are made c oncerning how the so lution wil l be used, how it wi ll evolve, and what business e nvironment it will o perate in. Briefly l ist the as sumptions for this r equest. | |
| 227 | 9.3. Depen dencies | |
| 228 | Dependenci es include , but are not limite d to, the availabili ty of reso urces (e.g . stakehol ders, subj ect matter experts [ SME]), app lications, and syste ms that in teract wit h this one , hardware , faciliti es, equipm ent, busin ess proces ses, regul atory appr ovals, pol icy, and t raining. | |
| 229 | Additional ly, use th is section to docume nt possibl e interfac es, relati onships, a nd/or conf licts with ICD (diag nosis and/ or procedu re) code u sage (such as edit/e ntry/displ ay/print). Additiona l guidance regarding this proc ess can be found at the follow ing link - - http://g o.va.gov/2 etl. | |
| 230 | 9.4. Const raints | |
| 231 | Constraint s are expl icit limit ations tha t will be encountere d in pursu ing an obj ective. Th ese includ e regulato ry, techno logical, o r business realities that legi timately c onstrain s olution de velopment. In listin g the cons traints, i nclude a b rief state ment stati ng why thi s is a con straint. | |
| 232 | An example might be “The new s ystem must be in pla ce by Marc h 1st beca use treasu ry will st op issuing checks." | |
| 233 | If known, specify th e constrai nts that c ould inclu de require d software products or license d data set s as part of the dev elopment o f the prod uct. Some examples i nclude spe cialized i nstallatio n software , 3rd-part y tools th at require licensing , and/or d ata sets t hat requir e license agreements (e.g., Fi rst Data B ank, E&M C odes, Code 1, etc.) | |
| 234 | 9.5. Busin ess Risks and Mitiga tions | |
| 235 | List any p otential b usiness th reats to t he develop ment and/o r implemen tation of the propos ed enhance ment. Incl ude any po ssible mit igation st rategies f or minimiz ing or eli minating t he risk. Business R isks shoul d be writt en using ' if-then' s yntax. | |
| 236 | Business R isks | |
| 237 | Mitigation | |
| 238 | If there i s insuffic ient fundi ng to supp ort develo pment or a cquisition , then nec essary imm unization data will not be col lected. | |
| 239 | Coordinate with Busi ness Owner s and lead ership to ensure pro ject fundi ng. | |
| 240 | If resourc es are not available , then the deploymen t of BCMA enhancemen ts may be delayed. | |
| 241 | Coordinate with stak eholders t o ensure u nderstandi ng of BCMA requireme nts as par t of their scope. | |
| 242 | ||
| 243 | ||
| 244 | Appendix A : Referenc es | |
| 245 | Provide a complete a lphabetica l list of all docume nts refere nced elsew here in th is documen t, includi ng sources from the VA Softwar e Document Library a nd relevan t hyperlin ks. Identi fy each do cument by title, rep ort number (if appli cable), da te, and pu blishing o rganizatio n. Specify the sourc es from wh ich the re ferences c an be obta ined. If n ecessary, provide th is informa tion by re ference to an append ix or anot her docume nt. Includ e strategi es, HIPAA, public la w. | |
| 246 | VA Handboo k 6500 – I nformation Security Program ht tp:/ DNS /vapubs/vi ewPublicat ion.asp?Pu b_ID=638&F Type=2 | |
| 247 | ||
| 248 | Appendix B : Models | |
| 249 | Describe, with Flowc harts or o ther busin ess proces s models, the “as is ” user exp erience wi th the cur rent solut ion. In so me cases, especially where bus iness proc esses are being modi fied, it m ay also be necessary to docume nt the “to be” state of user e xperience with the d esired sol ution. Mo dels to be inserted, imbedded or hyperli nked. Exam ples of th e BPMN for mat can be found at the follow ing link: http://go. va.gov/svx y | |
| 250 | Appendix C : Stakehol ders, User s and Work groups | |
| 251 | Stakeholde rs | |
| 252 | It is nece ssary to i dentify an d involve all of the stakehold ers as par t of the R equirement s Modeling process t o effectiv ely provid e products and servi ces that m eet the ne eds of sta keholders and users. It is nec essary to identify t he users o f the syst em and ens ure that t he stakeho lder commu nity adequ ately repr esents the m. Provide a profile of the st akeholders and users involved in the req uest.There are a num ber of sta keholders with an in terest in the system ’s develop ment and n ot all of them are e nd users. Present a summary li st of the business o wner and t hese non-u ser stakeh olders. Th e stakehol ders ident ified in t his sectio n should b e linked t o the busi ness archi tecture. L ist all co ntributors to the BR D in this section. C ertain rep resentativ es may act in the ro le of more than one type of st akeholder. | |
| 253 | Stakeholde r Support Team (BRD Developmen t) | |
| 254 | Type of St akeholder | |
| 255 | Descriptio n | |
| 256 | Responsibi lities | |
| 257 | Delete thi s row afte r reviewin g instruct ional text . | |
| 258 | Name, (use Shift + E nter to pu t a charac ter return after the name)Titl e, Organiz ation of S takeholder | |
| 259 | Bullets sh ould only be used wh en listing more than one stake holder per cell. | |
| 260 | Summarize the stakeh olders’ ke y responsi bilities w ith regard to the sy stem being developed --that is, their int erest as a stakehold er. For ex ample, thi s stakehol der monito rs the pro ject’s pro gress and approves f unding. | |
| 261 | Requester | |
| 262 | Name | |
| 263 | Title, Org anization | |
| 264 | Submitted request. S ubmits bus iness requ irements. Monitors p rogress of request. Contribute s to BRD d evelopment . | |
| 265 | Endorser | |
| 266 | Name | |
| 267 | Title, Org anization | |
| 268 | Endorsed t his reques t. Provide s strategi c directio n to the p rogram. El icits exec utive supp ort and fu nding. Mon itors the progress a nd time li nes. | |
| 269 | Business O wner(s)/Pr ogram Offi ce(s) | |
| 270 | Name | |
| 271 | Title, Org anization | |
| 272 | Provide fi nal approv al of BRD with sign- off author ity. Provi de strateg ic directi on to the program. E licit exec utive supp ort and fu nding. Mo nitor the progress a nd time li nes. | |
| 273 | Business S ubject Mat ter Expert (s) (SME) | |
| 274 | Name | |
| 275 | Title, Org anization | |
| 276 | Provide ba ckground o n current system and processes . Describe features of current systems, including known prob lems. Iden tify featu res of enh ancement. | |
| 277 | Technical SME(s) | |
| 278 | Name | |
| 279 | Title, Org anization | |
| 280 | Provide te chnical ba ckground i nformation about the current s oftware an d requeste d enhancem ents. | |
| 281 | User SME(s ) | |
| 282 | Name | |
| 283 | Title, Org anization | |
| 284 | Ensure tha t the enha ncements w ill accoun t for curr ent busine ss process es and exi sting soft ware capab ilities. | |
| 285 | Security R equirement s SME(s) | |
| 286 | Name | |
| 287 | Title, Org anization | |
| 288 | Responsibl e for dete rmining th e Certific ation and Accreditat ion (C&A) and other security r equirement s for the request. | |
| 289 | Service Co ordination SME(s) | |
| 290 | Name | |
| 291 | Title, Org anization | |
| 292 | Responsibl e for ensu ring all a spects of non-functi onal requi rements ha ve been ac curately r ecorded fo r this req uest. | |
| 293 | Business L iaison Sta ff | |
| 294 | Name | |
| 295 | Title, Org anization | |
| 296 | Serve as t he liaison between t he Program Office (B usiness Ow ner) and P roduct Dev elopment t hroughout the lifecy cle. | |
| 297 | Requiremen ts Analyst (s) | |
| 298 | Name | |
| 299 | Title, Org anization | |
| 300 | Responsibl e for work ing with a ll stakeho lders to e nsure the business r equirement s have bee n accurate ly recorde d for this request. | |
| 301 | Appendix D : Usabilit y Requirem ents | |
| 302 | User Exper ience enco mpasses di rect and i ndirect in teractions between t he user an d the syst em Improvi ng usabili ty over th e prior ve rsion is a key requi rement for this appl ication. T he Interna tional Org anization for Standa rdization (ISO) defi nes usabil ity as “th e extent t o which a product ca n be used by specifi ed users t o achieve specified goals with effective ness, effi ciency, an d satisfac tion in a specified context of use” (199 8). | |
| 303 | For an opt imal user experience the syste m must mee t the requ irements o utlined in this sect ion, which involve a ttributes of the app lication a nd the pro cess requi red to ach ieve them. | |
| 304 | In order t o improve usability of VA-deve loped or p urchased a pplication s, the fol lowing act ions are r equired: | |
| 305 | In accorda nce with t he Office of the Nat ional Coor dinator fo r Health I nformation Technolog y’s Meanin gful Use S tage 2 fin al ruling, employ an industry recognized User Cent ered Desig n (UCD) pr ocess. The methods f or UCD are well defi ned in doc uments and requireme nts such a s ISO 9241 –11, ISO 1 3407, ISO 16982, Nat ional Inst itute of S tandards a nd Technol ogy Intera gency Repo rt 7741, I SO/Interna tional Ele ctrochemic al Commiss ion 62366, and ISO 9 241-210. Developers will choo se their U CD approac h; one or more speci fic UCD pr ocesses wi ll not be prescribed . | |
| 306 | Adhere to an industr y recogniz ed User In terface (U I) Best Pr actices Gu ideline or Style Gui de. For ex ample, fir st follow UI guideli nes for th e developm ent platfo rm. In in stances wh ere platfo rm guideli nes are no t availabl e, adhere to VA’s Be st Practic es Guideli nes/Style Guide. | |
| 307 | Inform req uirements and design s with det ailed huma n factors work produ cts that h ave been/w ill be com pleted for the speci fic projec t. Example s of speci fic human factors ac tivities m ight inclu de heurist ic evaluat ions, site visits, i nterviews, applicati on-specifi c design g uides, and usability testing o n existing systems o r prototyp es. | |
| 308 | A sound UC D and deve lopment pr ocess base d on human factors s hould incl ude the fo llowing ac tivities: | |
| 309 | Understand ing of the users, th e users’ t asks, and the users’ environme nts | |
| 310 | Review of similar or competiti ve systems to inform requireme nts and de sign | |
| 311 | Heuristic evaluation of prior versions, prototypes , or basel ine applic ations, if applicabl e | |
| 312 | Iterative design and formative usability testing ( formative usability testing is used to d iscover us ability pr oblems dur ing the de sign and d evelopment process) | |
| 313 | User risk analysis | |
| 314 | Summative validation usability testing ( summative usability testing is used to q uantify an d validate usability of a prod uct with m easures of effective ness, effi ciency, us er percept ions, etc. ) | |
| 315 | To demonst rate high usability, the appli cation sho uld be: | |
| 316 | Intuitive and easy t o learn, w ith minima l training | |
| 317 | Effective by allowin g users to successfu lly comple te tasks | |
| 318 | Efficient by allowin g users to complete their work in a mann er consist ent with c linical pr actice and workflow | |
| 319 | Perceived to have hi gh usabili ty, as dem onstrated by appropr iate surve y measures | |
| 320 | Designed t o aid user s in meeti ng task go als withou t being an additiona l burden | |
| 321 | The system must be r eliable an d enable u ser trust by providi ng: | |
| 322 | Stable and reliable performanc e | |
| 323 | Accurate d ata | |
| 324 | Display of all data that is av ailable in native or interface d systems and intend ed to be a vailable i n the appl ication | |
| 325 | Accessible informati on related to the so urce of da ta | |
| 326 | The applic ation shou ld include a modern Graphical User Inter face that allows the user to v iew data f rom multip le sources and inclu de: | |
| 327 | Integrated display o f structur ed and uns tructured data | |
| 328 | Rich data visualizat ion and gr aphical di splay of d ata | |
| 329 | Ability to switch be tween tabu lar and gr aphical da ta views | |
| 330 | Ability to interact with displ ayed data to obtain additional details r elated to the data a nd source of the dat a | |
| 331 | User custo mizable co mponents a nd setting s | |
| 332 | The applic ation must provide f or advance d and up-t o-date sea rching, to include: | |
| 333 | Fast searc h function ality with auto-comp lete and r eal-time d isplay of matched re sults duri ng typing | |
| 334 | Search his tory | |
| 335 | The applic ation must provide f or advance d filterin g capabili ties, to i nclude: | |
| 336 | Filtering of data ta bles, list s, and gri ds | |
| 337 | Filtering of search results | |
| 338 | The applic ation desi gn should be modifie d to: | |
| 339 | Address th e specific findings from a hum an factors heuristic evaluatio n conducte d on the p rior versi on of the applicatio n | |
| 340 | Address th e specific findings reported f rom field use of the prior ver sion | |
| 341 | Address th e specific findings reported f rom usabil ity testin g of the p rior versi on or rele vant proto types | |
| 342 | Identifier | |
| 343 | Usability/ User Inter face Requi rements | |
| 344 | ||
| 345 | Left align content i n table ce lls to fac ilitate qu ick visual scan. | |
| 346 | ||
| 347 | Left align text for column hea ders to fa cilitate v isual scan and make columns an d content appear mor e organize d. | |
| 348 | ||
| 349 | Use mixed case inste ad of all caps whene ver possib le (e.g., dropdown l ist items, table dat a, table h eaders, hy perlinks, tab names) . Limit th e use of “ all caps” throughout the appli cation. | |
| 350 | ||
| 351 | Simplify b utton labe ls. Re-lab el buttons to reflec t standard terminolo gy that is common in web inter faces and other appl ications ( e.g., “Can cel”). Emp hasize the action be ing perfor med in the most succ inct way p ossible. M inimize re dundancy i n text/ter minology t hat is use d to conve y the same action. | |
| 352 | ||
| 353 | Left align page/sect ion titles to anchor titles in consisten t location s regardle ss of wind ow sizing. | |
| 354 | ||
| 355 | Labels for fields sh ould be le ft aligned to facili tate quick visual sc an and mak e forms an d field gr oupings ap pear more organized. | |
| 356 | ||
| 357 | Avoid usin g acronyms or abbrev iations un less (a) t hey are wi dely under stood/well known or (b) there is very li mited spac e to displ ay the ful l meaning. This supp orts naïve user unde rstanding. If limite d space re sults in u sing a non -common ac ronym/abbr eviation, ensure it is specifi ed within “Help” and /or as a t ooltip. | |
| 358 | ||
| 359 | Use colors such as r ed and gre en only fo r status d riven cont ent. Avoi d using re d for text /content, links, but ton labels , etc. Thi s will red uce risk f or user er ror, impro ve link di scoverabil ity, and f acilitate understand ing of dif ferences i n navigati on/actions /content. It will a lso help u sers to is olate impo rtant stat us informa tion (usin g red, gre en, etc.) from other less impo rtant info rmation wh en viewing and proce ssing info rmation pr ovided to them on a page. | |
| 360 | ||
| 361 | Provide vi sual separ ation betw een the na vigation s pace and t he main co ntent area . | |
| 362 | ||
| 363 | Add field level vali dation and notificat ion of mis sing infor mation on the same p age withou t launchin g a new wi ndow or na vigating t o another page. | |
| 364 | ||
| 365 | Make all t ext hyperl inks appea r consiste nt in styl e. | |
| 366 | ||
| 367 | Make drop- down selec tion box w idths appr opriate fo r content and visual appeal. | |
| 368 | ||
| 369 | Use standa rd and alw ays visibl e radio bu ttons for “Yes/No” o ptions ins tead of re quiring th e user to click in a drop down box and t hen click to select the “Yes” or “No” op tion. | |
| 370 | ||
| 371 | Use standa rd date an d time sel ection wid gets. Whe re date an d time are selected/ picked fro m a standa rd widget, also prov ide direct data entr y to suppo rt keyboar d navigati on. Enabl e field le vel valida tion immed iately upo n entry. Include in structiona l format t ext within the field entry box . | |
| 372 | ||
| 373 | Provide st andard sor t behavior and visua l indicati ons on col umns in al l tables. | |
| 374 | ||
| 375 | Define and adhere to a standar d model fo r use and design of controls, buttons, h yperlinks, and navig ation elem ents. | |
| 376 | ||
| 377 | Ensure tha t text is sized to b e readable (for exam ple, by us ing the 00 7 Rule to assure tex t size is readable f or users w ith 20/40 vision. Th e formula: Text heig ht = .007 * distance between e yes and sc reen). | |
| 378 | ||
| 379 | Place comm on navigat ion elemen ts in cons istent loc ations. | |
| 380 | ||
| 381 | Place crit ical infor mation “ab ove the fo ld” (i.e., in the to p portion of the scr een that i s immediat ely viewab le). | |
| 382 | ||
| 383 | Use consis tent scree n flow mod els, eleme nts, and t erms to su pport simi lar workfl ows. | |
| 384 | ||
| 385 | Use consis tently nam ed buttons when acti ons are th e same (e. g., Add vs . Save vs. Submit). | |
| 386 | ||
| 387 | Enable use rs to prin t views fr om where t hey are in the inter face. Avo id requiri ng the use r to “run a report” in order t o print so mething th at is view able on th e screen. | |
| 388 | ||
| 389 | Provide fi eld entry tool tips at the fie ld locatio n. Ensure consisten cy across the applic ation in f ield label s, formats , location of toolti ps, and to ol tip tex t. | |
| 390 | ||
| 391 | Provide vi sual indic ation of r equired fi elds. | |
| 392 | ||
| 393 | Display fi eld labels in close proximity to entry e lements. | |
| 394 | ||
| 395 | Use consis tent eleme nts to fil ter data. | |
| 396 | ||
| 397 | Use consis tent eleme nts to sor t data. | |
| 398 | ||
| 399 | Use a cons istent mod el for dis play, layo ut, and gr ouping of data entry fields. | |
| 400 | ||
| 401 | Provide al ternate ro w shading in lengthy tables of data, for m elements , etc. | |
| 402 | ||
| 403 | Ensure tha t icons ar e recogniz ed by user s. | |
| 404 | ||
| 405 | Provide so me “white space” bet ween statu s icons in report vi ews, white board vie ws, etc. | |
| 406 | ||
| 407 | Auto-popul ate defaul t values i n entry/se lection fi elds when possible a nd appropr iate. | |
| 408 | ||
| 409 | Visually d ifferentia te status icons from clickable icons, wh en appropr iate. | |
| 410 | ||
| 411 | Define and support t he appropr iate user tab sequen ce through fields in forms in order to s upport key board navi gation whe n entering data in f orms. | |
| 412 | ||
| 413 | Define and adhere to standard action but ton placem ent on scr eens, form s, etc. | |
| 414 | ||
| 415 | Visually d istinguish the prima ry action button on a page. | |
| 416 | ||
| 417 | Consistent ly use scr een elemen ts, action elements, workflow sequences within/acr oss screen s, languag e, etc. | |
| 418 | ||
| 419 | Provide er ror messag es in user -centric l anguage wi th specifi c instruct ions on th e meaning of the err or and how to recove r from it. Use error messages and method of displa y consiste ntly acros s the inte rface. | |
| 420 | ||
| 421 | Provide co ntext-spec ific Help. | |
| 422 | ||
| 423 | Do not use the term “sex” or a ny like ab breviation s of that to represe nt gender. | |
| 424 | Appendix E : Acronyms and Abbre viations | |
| 425 | Include te rms used i n the docu ment and p rocess mod els other than instr uctional t ext. | |
| 426 | Term | |
| 427 | Definition | |
| 428 | BRD | |
| 429 | Business R equirement s Document | |
| 430 | HIPAA | |
| 431 | Health Ins urance Por tability a nd Account ability Ac t | |
| 432 | ISO | |
| 433 | Internatio nal Organi zation for Standardi zation | |
| 434 | IT | |
| 435 | Informatio n Technolo gy | |
| 436 | MAP | |
| 437 | Mobile App lication P rogram | |
| 438 | MTRS | |
| 439 | Mean Time to Restore | |
| 440 | OI&T | |
| 441 | Office of Informatio n and Tech nology | |
| 442 | PHI | |
| 443 | Protected Health Inf ormation | |
| 444 | PII | |
| 445 | Personally Identifia ble Inform ation | |
| 446 | RTM | |
| 447 | Requiremen ts Traceab ility Matr ix | |
| 448 | SLR | |
| 449 | Service Le vel Requir ements | |
| 450 | SME | |
| 451 | Subject Ma tter Exper t | |
| 452 | UCD | |
| 453 | User-Cente red Design | |
| 454 | UI | |
| 455 | User Inter face | |
| 456 | VA | |
| 457 | Department of Vetera ns Affairs | |
| 458 | VHA | |
| 459 | Veterans H ealth Admi nistration | |
| 460 | VistA | |
| 461 | Veterans H ealth Info rmation Sy stems and Technology Architect ure | |
| 462 | Appendix F : Approval Signature s | |
| 463 | This secti on is used to docume nt the app roval of t he BRD dur ing the Fo rmal Revie w. The rev iew should be ideall y conducte d face-to- face where signature s can be o btained ‘l ive’ durin g the revi ew. Howeve r, the fol lowing for ms of appr oval are a cceptable: | |
| 464 | Physical s ignatures obtained f ace-to-fac e or via f ax | |
| 465 | Digital si gnature ti ed cryptog raphically to the si gner | |
| 466 | /es/ in th e signatur e block, p rovided th at a separ ate digita lly-signed e-mail in dicating t he signer’ s approval is provid ed and kep t with the document | |
| 467 | The requir ements def ined in th is documen t are the high-level business requiremen ts necessa ry to meet the strat egic goals and opera tional pla ns of the <Program O ffice (ins ert name o f PO)>. Fu rther elab oration to these req uirements will be do ne in more -detailed artifacts. | |
| 468 | Business O wner | |
| 469 | Signifies that the c ustomer ap proves the documente d requirem ents, that they adeq uately rep resent the customers desired n eeds, and that the c ustomer ag rees with the define d scope. | |
| 470 | ||
| 471 | Signed:___ __________ __________ __________ __________ __________ __________ __________ __________ _________ | |
| 472 | <Business Owner Name and Title > Date | |
| 473 | Include ap proval mes sage attac hments HER E | |
| 474 | Business L iaison | |
| 475 | Signifies appropriat e identifi cation and engagemen t of neces sary stake holders an d the conf irmation a nd commitm ent to qua lity assur ance and c ommunicati on of busi ness requi rements to meet stak eholder ex pectations . | |
| 476 | ||
| 477 | Signed:___ __________ __________ __________ __________ __________ __________ __________ __________ _________ | |
| 478 | <Business Liaison Na me and Tit le> Da te | |
| 479 | Health Ent erprise Sy stems Mana ger (for V HA) | |
| 480 | XXXXX (for VBA) | |
| 481 | XXXXX (for NCA) | |
| 482 | XXXXX (for Corporate ) | |
| 483 | Include ap proval mes sage attac hments HER E | |
| 484 | ||
| 485 | Customer A dvocate | |
| 486 | Confirms t hat the re quest meri ts conside ration and review by the Busin ess Intake Review Bo ard. | |
| 487 | ||
| 488 | Signed:___ __________ __________ __________ __________ __________ __________ __________ __________ __________ | |
| 489 | <Customer Advocate N ame and Ti tle> Date | |
| 490 | Additional signature for out-o f-cycle re quests pro cessed thr ough the B usiness In take Revie w Board: D eputy Chie f Officer for Health Systems ( VHA) | |
| 491 | Executive Customer A dvocate Co rporateExe cutive Cus tomer Advo cate Benef its and Ce metery | |
| 492 | Include ap proval mes sage attac hments HER E | |
| 493 | Office of Informatio n and Tech nology | |
| 494 | Indicates agreement that the r equirement s have bee n received , are clea r, underst andable, a nd are doc umented su fficiently to facili tate proje ct plannin g when the project i s approved and funde d. It is u nderstood that negot iations ma y need to occur with the busin ess during project p lanning as a result of technic al reviews and feasi bility. | |
| 495 | ||
| 496 | Signed: | |
| 497 | <OIT Name and Title> Date | |
| 498 | Include ap proval mes sage attac hments HER E | |
| 499 | ||
| 500 |
Araxis Merge (but not the data content of this report) is Copyright © 1993-2016 Araxis Ltd (www.araxis.com). All rights reserved.