docs/admin/staff_client-login.adoc

   1 Logging in to Evergreen
   2 -----------------------
   3
   4 indexterm:[staff client, logging in]
   5 indexterm:[SSL certificate]
   6
   7 . Select the _Locale_ to match your language preference.
   8 . Enter the _Hostname_ of the Evergreen server you are connecting.
   9 . Click _Test Server_ to ensure that you are able to reach the
  10 server.  You should see ``200 : OK'' indicated in green for _Status_ and _Version_.
  11 +
  12 [NOTE]
  13 ============
  14 If _Status_ indicates ``There was an error testing this server'', check for a typo
  15 in the _Hostname_ field or ask your administrator for the correct _Hostname_
  16 to use.
  17
  18 IF _version_ indicates ``404 Not Found'', the server does not support the version
  19 of your staff client. You will need to download the correct version or contact
  20 your system administrator.
  21
  22 If your server has a self-signed SSL certificate, you may need to click _Add SSL Exception_
  23 in order to login.
  24 ============
  25 +
  26 . Enter your _Username_ and _Password_  and  click _Login_.
  27 . If this is the first time you login from the workstation, you will
  28 need to <<register_workstation,register your workstation>>.
  29
  30 Standalone Interface
  31 ~~~~~~~~~~~~~~~~~~~~
  32
  33 indexterm:[staff client, standalone interface]
  34
  35 If your connection to Evergreen is lost, click _Standalone
  36 Interface_ to circulate items or register patrons while connection is down.
  37
  38 [[preset_tabs]]
  39 Preset Tabs in Evergreen Client
  40 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  41
  42 To have preset tabs waiting when Evergreen opens you will need to modify the
  43 *Evergreen shortcut* on your desktop.
  44
  45 . First, you need to copy your shortcut. There are a couple of ways to do this.
  46 .. Right-mouse click and drag icon; upon release select *Create Shortcut
  47 Here*.
  48 +
  49 image::media/create_shortcut_here.png[]
  50 +
  51 .. Right-mouse click icon, select *Send to*, and select *Desktop (create
  52 shortcut)*.
  53 +
  54 image::media/send_to_desktop.png[]
  55 +
  56 . Right-mouse click the new shortcut and select *Properties*.
  57 +
  58 image::media/shortcut_properties.png[]
  59 +
  60 . Listed in the *Target* box you will see something like the following path
  61 surrounded by quotation marks:   "C:\Program Files\Evergreen Staff Client MVLC\evergreen.exe"
  62 +
  63 image::media/shortcut_properties_window.png[]
  64 +
  65 . Place your cursor after the ending quotation mark. Enter a space after the
  66 last quotation mark and then enter the tab code from the list below. Add
  67 multiple tabs with a space separating them.
  68 +
  69 image::media/preset_tabs.png[]
  70 +
  71 For Example, to have Checkout, Checkin, Catalog Search, and a blank tab preset:
  72 "C:\Program Files\Evergreen Staff Client MVLC\evergreen.exe" -ilscheckout -ilscheckin -ilsurl XUL_OPAC_WRAPPER -ilstab
  73 . The following options are available:
  74
  75 - -ILScheckin : Opens the Check In interface
  76 - -ILScheckout : Opens the Check Out interface
  77 - -ILSurl <url/constant> : Opens the specified page
  78 - -ILSnew : Opens a new "menu" window
  79 - -ILStab : Opens a new (default) tab
  80 - -ILSnew_default : Opens a new "menu" window with a guaranteed default tab
  81 - -ILSoffline/-ILSstandalone : Opens the standalone interface
  82 - -ILSlogin : Opens the login page
  83 +
  84 [TIP]
  85 .Useful Tab Codes
  86 =====================
  87       - -ilsurl XUL_PATRON_DISPLAY : Opens a Patron Search tab
  88       - -ilsurl XUL_HOLD_PULL_LIST : Opens a Pull List tab
  89       - -ilsurl XUL_HOLDS_BROWSER :        Opens a Browse Holds Shelf tab
  90       - -ilsurl XUL_OPAC_WRAPPER : Opens an Advanced Catalog search tab
  91       - -ilsurl XUL_COPY_STATUS : Opens an Item status by barcode tab
  92       - -ilsurl XUL_RECORD_BUCKETS : Opens a Manage Record Buckets tab
  93       - -ilsurl XUL_COPY_BUCKETS : Opens a Manage Copy Buckets tab
  94       - -ilsurl XUL_MARC_NEW : Opens a Create new MARC record tab
  95       - -ilsurl XUL_Z3950_IMPORT : Opens an Import record from Z39.50 tab
  96       - To open two windows, one with checkin and checkout, one with Marc and Z39.50, use:
  97       +
  98       -ilscheckin -ilscheckout -ilsnew -ilsurl XUL_MARC_NEW -ilsurl XUL_Z3950_IMPORT
  99 ========================
 100 +
 101 . You may want to rename your shortcut to reflect its purpose. For example, you
 102 could have one icon set to open circulation-related tabs and one icon to open
 103 cataloging-related tabs. Right-mouse click and select *Rename* to do this.
 104
 105 Auto Login
 106 ~~~~~~~~~~~
 107
 108 To use auto login, you will need to modify the *Evergreen shortcut* on your desktop. There are three new commands which are necessary for automatic login:
 109
 110 - -ilsuser
 111 - -ilspassword
 112 - -ilshost
 113
 114 You will need all three to have your client successfully login. To enable
 115 automatic login we need to modify the Evergreen shortcut on your desktop. If
 116 your shortcut already has preset tab commands, then place the automatic login
 117 commands after those commands.
 118
 119 . First, if your workstation will have multiple logins (circ, cat, admin) you need to copy a shortcut for each. There are a couple of ways to do this.
 120 .. Right-mouse click and drag icon; upon release select *Create Shortcut Here*.
 121 +
 122 image::media/create_shortcut_here.png[]
 123 +
 124 .. Right-mouse click icon, select *Send to*, and select *Desktop (create shortcut)*.
 125 +
 126 image::media/send_to_desktop.png[]
 127 +
 128 . Right-mouse click the new shortcut and select *Properties*.
 129 +
 130 image::media/shortcut_properties.png[]
 131 +
 132 Listed in the *Target* box you will see something like the following path
 133 surrounded by quotation marks: "C:\Program Files\Evergreen Staff Client MVLC\evergreen.exe"
 134 +
 135 image::media/shortcut_properties_window.png[]
 136 +
 137 . Place your cursor after the ending quotation mark and enter a space after the
 138 last quotation mark.
 139 +
 140 image::media/target_box.png[]
 141 +
 142 .. After the space enter the login code for username followed by a space and
 143 the username +
 144 -ilsuser circuser
 145 .. Enter a space and then the login code for password followed by the password +
 146 -ilspassword circpass
 147 .. Finally, enter the login code for host followed by a space and the host
 148 address (this is the exact address which shows up in the Server Hostname box
 149 when you manually login to the client. +
 150 -ilshost evergreen.mvlcstaff.org
 151 +
 152 image::media/auto_login.png[]
 153 +
 154 [NOTE]
 155 When you double-click on the new shortcut it may seem like nothing is
 156 happening, but it really is! It takes the program a few moments to digest the
 157 new requests and to do the login.
 158
 159 Logging Out
 160 ~~~~~~~~~~~
 161
 162 indexterm:[staff client, logging out]
 163
 164 There are several ways to end your Evergreen staff client session:
 165
 166 * Click the *Exit Evergreen* button on the bottom of the login page.
 167 * Click the *x* at the top left of the *login* window.
 168 * Choose *File -> Quit Program* from the menu of the application window.
 169
 170 [CAUTION]
 171 ============
 172 Clicking the *x* on the application window (not the login window) will not exit
 173 Evergreen, but only close the window.
 174
 175 A new application window can be opened by clicking _Open New Window_ from the
 176 login window.
 177 ============
 178