75. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 9/24/2019 1:38:04 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.

75.1 Files compared

# Location File Last Modified
1 PCL-5_v1_build_8.zip\v1_build 8\Unredacted\spp_mha_web-development.zip\spp_mha_web-development\Docs MHA Admin Portal User Guide.docx Wed Jul 31 17:35:31 2019 UTC
2 PCL-5_v1_build_8.zip\v1_build 8\Unredacted\spp_mha_web-development.zip\spp_mha_web-development\Docs MHA Admin Portal User Guide.docx Mon Sep 23 20:33:28 2019 UTC

75.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 1 160
Changed 0 0
Inserted 0 0
Removed 0 0

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

75.4 Active regular expressions

No regular expressions were active.

75.5 Comparison detail

  1   Last updat e by Jason  Wilson 3/ 18/2019
  2   MHA Admin  Portal Use r Guide
  3  
  4   When we sa y MHA in t his docume nt, we mea n the new  MHA Web ap plication.  And when  we say Vis taLinkConn ection, we  mean the  connection  between M HA Web and  that part icular Vis tA instanc e. Each Vi stA instan ce needs a n open por t set up s pecificall y for Vist aLink in o rder to in itiate a V istaLink c onnection.
  5   Intended A udience
  6   This guide  is for Ad min Portal  users who  manage Vi staLink co nnections  in the MHA  web appli cation. Th is is not  intended f or patient s or clini cians usin g of MHA.  When a new  hospital  (Vista Loc ation) com es online,  a VistaLi nk instanc e must be  created fo r that loc ation in o rder to in tegrate wi th MHA. We  need to a dd these n ew VistaLi nk instanc es into th e MHA appl ication if  we want t o be able  to make Vi stA calls  at that lo cation. Th e Admin Po rtal is a  place wher e special  users can  manage the se MHA Vis ta connect ions. Each  user must  have the  administra tor userna me and pas sword. The  username  and passwo rd are the  same for  every user .
  7   Overview
  8   The admin  portal is  a subset o f MHA wher e authoriz ed adminis trators ca n manage V istaLink c onnections  in the ap plication.  It allows  users to  add, updat e, test an d delete V istaLink c onnections  in an MHA  environme nt.
  9   Please not e that whe n managing  VistaLink  connectio ns via the  Admin Por tal, that  these chan ges only a ffect the  domain you  are in. F or example , if you l og into th e Admin Po rtal in th e DEV envi ronment, t he changes  made here  will ONLY  affect th e DEV envi ronment. Y ou must re peat the s teps for a ny other e nvironment s you wish  to update .
  10   Accessing  the Admin  Portal
  11   Developer  Note: The  admin port al is avai lable in b oth the fu ll applica tion and p atient ent ry only ve rsion. 
  12   Open a new  instance  of Interne t Explorer  (please u se IE).
  13   Go to the  admin port al’s landi ng page at  http(s):/ /domain:po rt/admin/p ortal
  14   http(s) =  this would  be either  http or h ttps depen ding on th e environm ent.
  15   domain = t he domain  of the env ironment.  This is lo calhost in  developer s’ environ ments.
  16   port = if  applicable , your por t goes her e. This is  required  for develo pers’ envi ronments.
  17  
  18   The suffix  /admin/po rtal is th e same acr oss all en vironments .
  19   Once promp ted for th e followin g screen ( pictured b elow), ent er your cr edentials:
  20  
  21   Note: For  developer  environmen ts, the us ername and  password  will both  be admin
  22   You will n eed to ask  for the p roduction  environmen t credenti als for an y environm ent in the  cloud (eg : DEV, SQA , UAT etc) .
  23  
  24   Click “OK”  to login.
  25   You should  see the A dmin Porta l home pag e like bel ow. This p age is whe re you can  view and  manage all  existing  VistaLink  Connection s that are  active in  MHA.
  26  
  27  
  28   If you see  a VistaLi nk connect ion here,  then you s hould be a ble to run  RPC’s aga inst that  VistaLink  instance.
  29  
  30   Here you c an update,  delete an d add new  connection s. The upd ate and de lete butto ns are nex t to the e xisting Vi staLink co nnection r espectivel y. And if  you want t o add a ne w connecti on, you ca n click on  the blue  hyperlink  that says  click here  in the de scription  paragraph.
  31   Adding a N ew VistaLi nk Connect ion
  32   Once logge d in, you  will see t he blue hy perlink cl ick here. 
  33  
  34   Click the  hyper link  to add a  new connec tion.
  35   You should  see the f ollowing f orm:
  36  
  37  
  38   You’ll nee d the foll owing when  creating  a new Vist aLink conn ection:
  39   IP address  (VistaLin k IP)
  40   Port (Vist aLink port )
  41   Access cod e
  42   Verify Pin
  43   Station nu mber (uniq ue 3-digit  number)
  44   The connec tion name  and JNDI f ields are  fields you  need to c ome up wit h on your  own. Often  times, th e connecti on name is  the name  of the VA  Division t he connect ion is for . And the  JNDI name  is some un ique strin g with no  spaces or  number.
  45    For examp le, if we  are connec tion to th e Seattle  VA named “ VA Puget S ound” whic h is stati on 663 we  would have  the follo wing:
  46   Connection  name = SE A-PUG-SOUN D 663
  47   JNDI = sea PugSound
  48   Neither of  these fie lds need t o be uniqu e, but it  helps if t hey repres ent the co nnection d escription . The JNDI  name does  not accep t numbers  or special  character s.
  49   The statio n number f ield MUST  be unique  meaning no  two Vista Link Conne ctions may  have the  same stati on number.  The Admin  Portal wi ll prevent  you from  adding a n ew connect ion to a p re-existin g connecti on with th e same sta tion numbe r. You mus t delete o r update t he existin g connecti on.
  50   Once you h ave entere d the fiel ds properl y, you nee d to test  the connec tion by cl icking the  green Tes t Connecti on button.
  51  
  52  
  53   If you tes t a connec tion with  bad VistaL ink creden tials, you  will get  the follow ing error:
  54  
  55   A successf ul connect ion test l ooks like  the follow ing:
  56  
  57   Once you h ave succes sfully tes ted your c onnection,  click the  Add Vista Link Conne ction butt on.
  58  
  59  
  60   You will g et a pop u p asking y ou to conf irm the co nnection.  Click Yes  to proceed .
  61   Upon succe ss, the pa ge will re fresh and  you will s ee you new  connectio n highligh ted in yel low
  62  
  63   Updating a n Existing  Connectio n
  64   You may wa nt to upda te an exis ting Vista Link conne ction if s omething o n the Vist A side has  changed a nd the exi sting conn ection cre dentials a re no long er valid.
  65  
  66   Go to the  Admin Port al home pa ge (at /ad min/portal ). Click t he Update  button for  the conne ction you  wish to up date.
  67  
  68   The update  screen sh ould appea r like pic tured belo w. It will  have some  fields pr e-populate d with the  exception  the acces s and veri fy fields.  You must  re-enter A ccess & Ve rify field s when upd ating a co nnection.  You may no t update t he station  number fi eld. You m ust delete  the conne ction, and  create a  new one if  you wish  to alter t his field.
  69  
  70   Once you h ave update d the desi red field,  Test the  connection .
  71   Once the t est has su cceeded, c lick Updat e and Retu rn Home. T o update t he connect ion and re turn to th e Admin Po rtal home  page.
  72  
  73   Delete a V istaLink C onnection
  74   You may wi sh to dele te an exis ting Vista Link conne ction. If  you need t o do so, y ou can do  this from  the Home p age of the  Admin Por tal.
  75   Please not e that whe n you dele te a conne ction, all  users of  MHA will n o longer b e able to  run RPCs a gainst tha t location . You are  taking thi s Vista in stance off line.
  76   Select the  Delete bu tton of th e connecti on you wis h to delet e.
  77  
  78   A dialog w ill pop up  asking if  you are s ure you wi sh to take  this conn ection off line. Sele ct Yes.
  79  
  80   The connec tion will  not be del eted. Plea se be care ful when p erforming  this opera tion as al l users at  the delet ed locatio n will no  longer be  able to us e MHA.