Richmond Systems SupportDesk Web Interface User Guide 1
Contents SUPPORTDESK WEB INTERFACE...3 INTRODUCTION TO THE WEB INTERFACE...3 FEATURES OF THE WEB INTERFACE...3 HELPDESK SPECIALIST LOGIN...4 SEARCHING THE SUPPORTDESK INVENTORY...6 ADDING NEW INVENTORY DATA...7 AMENDING EXISTING INVENTORY DATA...7 ADDING A REQUEST...8 SEARCHING FOR A REQUEST...8 REQUEST STATISTICS...9 REQUEST DETAILS...10 VIEWING ALARMS...14 EMAILING REQUEST DETAILS...15 THE TO DO LIST...16 CONTACT US...16 BULLETIN BOARD...16 LOGGING OUT OF SUPPORTDESK...17 FILE ATTACHMENTS...17 USER DEFINED FIELDS...19 HELPDESK REPORTS...20 TO PRINT A REPORT...21 HELPDESK END USER (CUSTOMER) LOGIN...21 ENABLING END USERS TO LOGIN...21 LOGGING ON AS AN END USER...22 CHANGE PASSWORD FEATURE...23 THE WEB INTERFACE MAIN WINDOW...23 ADD REQUEST...24 VIEWING THE REQUEST LIST AND REQUEST DETAILS...25 CONTACT US...27 FILE ATTACHMENTS...27 SEARCHING THE SUPPORTDESK KNOWLEDGE BASE...29 INDEX...33 2
SupportDesk Web Interface Introduction to the Web Interface The Richmond SupportDesk Web Interface has been designed to allow end-users (customers) and helpdesk specialists to log and track requests via the Internet. The back-end of the Web Interface employs technologies such as Microsoft Internet Information Server (IIS), Microsoft Component Services and the Microsoft Indexing Service The Web Interface is designed to bolt-on to your existing helpdesk environment and follows a simple installation procedure. The Web Interface has been designed as a server-side application. This means that the configuration of the software is only required on the web server. Features of the Web Interface. There are two possible ways that the Web Interface can be used; either as a helpdesk specialist or as a helpdesk customer. Helpdesk specialists can perform the following functions. Add, update, delete and view requests. Reassign requests. View request log entries. Add, update, delete and view request actions. Add, update, delete, view and convert future activities. Browse and search the SupportDesk inventory. Add or update inventory data. Associate and remove inventory items from requests. View the SupportDesk request list and search for specific requests. View their alarms. View their to-do list. Search the SupportDesk knowledge base for documents or previous problems. Print helpdesk defined reports to a variety of different formats directly from their browser. End-Users can perform the following functions: Add new requests Monitor and view requests associated with them Update their own requests Search the knowledge base Non-registered users who wish to register with the helpdesk can also complete an on-line registration form and assign themselves a user ID and password. On completion of the form, their details will then be submitted to the helpdesk and they will appear as part of the SupportDesk inventory under the default Contact style. The registration form is shown below: 3
Helpdesk Specialist Login This section describes in detail the functions that are available to helpdesk specialists via the Web Interface. Logging into SupportDesk. Specialists are permitted to log onto the web interface by using their existing SupportDesk username and password. When arriving at the initial login options screen, select the Login as helpdesk specialist option and the following screen will appear: 4
Enter your username and password and press the Login button. A total of four incorrect login attempts are allowed before helpdesk specialists can no longer attempt to login. The Web Interface main window Once a helpdesk specialist has logged into SupportDesk, the main window will appear. This is broken into three sections: Along the top of the screen is the navigation toolbar. By pressing any of these buttons, the user will be directed to the relevant section. Located to the left of the window is the Navigator Tree. This contains all of the helpdesk inventory information and works in much the same way as the Navigator within the main SupportDesk program. Finally, the main display window is located to the centre of the screen. This is where all pages of Web Interface are displayed. The Navigation Toolbar The Navigation Toolbar allows users to navigate through the various pages of the Web Interface. These functions from left to right are as follows: Add Request Request List To Do List My Alarms Show all Navigator items Add new inventory item View selected inventory items details Search the inventory Contact us Helpdesk bulletin board Home Helpdesk knowledge base Helpdesk reports menu Log off Viewing the Navigator Once a specialist has logged into SupportDesk, they may then view the Navigator which will populate as soon as a successful login has been completed. 5
By clicking on an item within the Navigator, the Web Interface will proceed to drill down through the inventory and show all sub-items of the selected item. You will also notice that a tick icon appears next to the selected item; this is purely an indicator as to what the current active item is. By clicking on the Item Details toolbar button, you will be directed to another page containing the selected items details. Clicking on the Add Request toolbar button will redirect you to the add request screen and when the request is added, will associate the selected Navigator item with the request. Note: In the same way as the Windows version of SupportDesk does, the Web Interface Navigator displays requests based on the view restriction currently selected by the user. Searching the SupportDesk Inventory By clicking on the Inventory toolbar button, you will be taken to the following screen: 6
From here, you are required to enter all keywords of the item(s) that you are looking for. For example; London + Smith + Hammersmith Once you have entered all keywords, press the Search button to initiate the search. Note: All items that meet any of the specified keywords will be shown. Once the search is complete, you will either be informed that no items matched your criteria, or you will be presented with a list containing all possible matches as shown below: Adding new inventory data Specialists (depending on their user rights) can add new Items into SupportDesk. A parent item must be selected from the Navigator. If no parent item is required, ensure that no particular item is given focus by pressing the 'Show all navigator items' button from the main toolbar. Click on the Add New Inventory Item button. From the Item Style drop down list select the style that you wish to use for the new Item. Once a style has been chosen, the screen will be populated with each of the fields for the selected style. Next, enter the information for the new item in the text boxes provided. Required fields are compulsory and must be completed. When all information has been entered, click on the Save button. You will need to refresh the Navigator before the new item will appear. Amending existing inventory data As well as adding new inventory data, helpdesk specialists (depending on their user rights) can amend existing data. To do this, first select the item to be amended from the Navigator. Click the View selected inventory items details button from the main toolbar 7
The full details of the selected inventory item will be shown and can be amended as required. When all required changes have been made, press the 'Save' button and the item will be updated. File attachments can also be added here by pressing the 'Attachments' button: A list of all the selected items requests can also be viewed by pressing the 'Items Requests' button: Adding a Request The first part of the add request operation is to ensure that the item that you wish to log the request against is the selected item within the Navigator Click on the Add Request toolbar button The following fields are available on the Add Request window Category Status Priority SLA Specialist Logged by Summary Description Note: Status items that are preceded by an exclamation mark (!) are active statuses. As long as a Request is in an active status the SLA clock is running. Note: After selecting a SLA you can click on the type button to view a window detailing the steps of the escalation The Add Request screen can be cleared at any time by pressing the Clear button at the bottom of the window. Searching for a Request By clicking on the Request List toolbar button, you will be directed to the Search Requests screen. This screen allows you to supply selection criteria for the request list and define by which column and in which order you would like the results to be displayed. An example of the screen is shown below: 8
Selecting a View Restriction will remove the other available search criteria options. Leaving the View Restriction blank will allow you to specify other criteria options. Once the search criteria have been selected, press the Search button to initiate the search. You will be presented with the request list as shown below. Clicking on the Request ID link will take you directly to the Request Details screen, from which requests can be amended. Request Statistics By pressing the Request Statistics screen from within the Search Requests screen, it is possible to view the current statistics of the helpdesk. This screen is shown below: 9
This screen displays a series of running totals for all of the currently logged requests by Status, Priority, Group and the total number of requests that have been logged on the current date. Request Details The Request Details screen displays all information regarding a request. From this screen you are able to perform the following functions: Update a request's details. Delete a request. Associate or remove items from a request. View the details of SLA s belonging to associated items and associate the SLA with the Request. View the requests log. Reassign a request to another specialist. View request actions or future activities. Edit User Definable Fields. Open the File Attachment menu. Print a full summary of the request The Request Details screen is shown below. 10
Pressing the Update button at any time on this screen will save the current details of the Request. If at any point you wish to cancel any changes before they are saved, press the Restore button and the Request's previous details will be restored. Note: A Request cannot be updated if any other SupportDesk user has made changes since you last viewed its details. The Delete button allows users, rights permitting, to delete the request from the system. There is no way to undo this action, therefore use it with caution. Pressing the Log button will take you to the Request Log screen. From here, users can view the various steps that the currently selected request has taken and by who. The Re-Assign button allows users, rights permitting, to re-assign a request to a different specialist. To re-assign a request, simply click on the specialist that you wish to re-assign the request to from the list. Rights permitting, an alarm is automatically set here for the selected specialist. The Actions button will show the user a list of all request actions that have been performed against the selected request including the following information: The type of action The date and time of the action The user that performed the action The duration of the action (in the standard format of days, hours and minutes) A brief description of the action. To view the full details of an action, click on the Item button at the left-hand side of the list and the following screen will appear: 11
From here, the details of an action, depending on user rights, can be amended or deleted. Click the Red back arrow to return to the Request Details Screen. The Activities button will show the user a list of all future activities relating to the selected request, including the following information: The type of activity The date and time of the activity The user that is to perform the activity A brief description of the activity 12
To view the full details of a future activity, click on Activity Button at the left-hand side of the list and the following screen will appear: From here, the details of a future activity can be amended and deleted, or the user can convert a future activity into a request action. Within the Request Details screen, it is also possible to view the details of all inventory items that are associated with a Request. These items appear in a list as shown below: The list contains the following headings: ITEM Clicking on this field will take you to the Item Details window where full details of the selected item can be viewed. 13
STYLE Indicates, which inventory style that the item is logged against. EMAIL REQUEST Providing the selected item has a valid email ID, clicking here will take you to the Email Request Details screen from which details of the request can be emailed to the selected item. See Emailing Request Details for further information. REMOVE FROM REQUEST: Clicking on this field will remove the selected item from the request. Note: An item may not be removed if there is only one item associated with a request. SLA: This field indicates whether or not an item has a valid SLA. If the item does not have an SLA then nothing will appear here, however, if an item does have an SLA which has either expired or is not yet valid then a Red symbol will appear indicating that the SLA is not valid. If the SLA is valid then a Green symbol will appear. Clicking on either of these symbols will take you to the SLA Information screen from which full details of the SLA can be viewed and, the request can be made to use the SLA by allowing the user to select both a Status and a Priority that will make it escalate. The Associate button enables you to add further associations to a request. To use this feature, you must fist select the item that you wish to associate from within the Navigator and ensure that it is the currently selected item which is indicated by the red tick. Once that the item has been selected, press the Associate button and the item will become part of the request associations list. Note: Request Associations will not be permitted if the item that is to be associated is already part of the association s list. The Print button allows specialists to print a full summary of a request from the Request Details window. All aspects of a request can be included such as request actions, future activities and the details of all associated items. In addition, the font and size of the printed report can be modified via the Web.INI file. Viewing Alarms It is possible to view alarms that have been assigned to you via the Web Interface even though the SupportDesk Alarms Module is not present. To view all of your existing alarms, simply press the My Alarms button on the main toolbar and you will be presented with the following screen: To view the full details of any alarm, click on the View Button at the far left of the list. From this screen it is possible to perform the following actions: 14
Delete the selected alarm by clicking on the Delete Alarm hyperlink. Go straight to the details of the request that the alarm refers to. Emailing Request Details To E-mail a request s details, click on the animated mail icon from within the Request Details window. Providing that the selected item has an E-mail ID, SupportDesk will generate a new mail message as shown above. 15
No actual email is sent from the web client; instead, the details of the email are mailed to the helpdesk where the SupportDesk email module handles the sending of the message, so there is no need to configure Internet Information Server to handle emails etc. The To Do List The To-Do List shows all outstanding future activities for the given specialist that has not yet been converted to a request action. The list can be filtered by specialist and date range. There are four different view filters for this list which are: TODAY This is the default selection and shows all outstanding activities for the current day. THIS WEEK Shows all outstanding activities for the current calendar week. THIS MONTH Shows all outstanding activities for the current calendar month. USE DATE RANGE This option allows the user to specify a start and end date for viewing Future Activities. To go straight to the details of a future activity within the To-Do List, click on the ID field located at the far-left of the list. This will take you to the Future Activity Details screen where the selected activity can be updated, deleted or converted into a request action. Contact Us Displays an E-mail address (as defined in the Database Administration Module) for contacting the Helpdesk. Bulletin Board The bulletin board screen can be used to add global messages which are viewable by all specialists without the need to set individual alarms for each user. Specialists can "add" or "delete" messages at the touch of a button. 16
Logging out of SupportDesk When a helpdesk specialist logs into SupportDesk via the Web Interface, they must also log out of the system when they leave. This is a very important function and logging out of the helpdesk is required in order for the SupportDesk licensing policy to be enforced correctly. Failing to log out when finishing with the Web Interface will cause problems because the concurrency check will still include the web user until the session on the web server expires. To log out of the Web Interface, press the Log Off button from the main toolbar and you will be informed that you have disconnected from the helpdesk. If any further activity on the Web Interface is required, you will need to re-login to the helpdesk again before any screens can be viewed. Note: Only helpdesk specialists are required to log out of the Web Interface. End users (Customers) are not affected by the licensing policy. File Attachments The File Attachments screen is an option available from the Request, Item, and Knowledge Base functions. From the File Attachments screen specialists (and authorised customers) can upload and download files directly to the Helpdesk database and link them to particular Request, KB article, or inventory Item. These files can be of any type although the maximum file size allowed is 1MB per file. The File Attachments screen is shown below. 17
The upper part of the screen displays existing attachments. Click "browse" to locate new files you wish to upload. Next click "Open" to target the file you wish to upload and then click "Upload" from the File Attachments screen. The Upload confirmation message is then displayed (below). 18
Once the file has been uploaded the File Attachments screen will display the attached files alongside two new options, "Download" and "Delete". Clicking "Download" will copy the file to your local computer. Clicking "Delete" will remove the file from the server. User Defined Fields Specialists can access and amend the User Defined Fields details section for any helpdesk request via the Request Details screen. 19
Amendments are made directly in the user defined field dialogues, click "Save" to confirm changes, "Restore" to abandon changes, or "Close" to return to the Request Details screen. Helpdesk Reports Helpdesk specialists (depending on their user rights) are permitted to view any of the pre-defined helpdesk reports without the need for Crystal Reports to be installed on their PC. To access the reports menu, press the 'Helpdesk Reports Menu' button from the main toolbar and the following screen will appear: 20
This screen contains a list of all existing helpdesk reports including the name of the template that is used for each. There are four possible formats in which reports can viewed. These are: HTML The report is generated as HTML and can be viewed directly from the users browser window. Microsoft Word The report is generated as a Microsoft Word document file which can be downloaded to the users PC and viewed by using Microsoft Word. Microsoft Excel The report is generated as a Microsoft Excel spreadsheet which can be downloaded to the users PC and viewed by using Microsoft Excel. Rich Text If Microsoft Word and Excel are not available; the report can be generated in Rich Text (RTF) format which can be downloaded viewed with WordPad or another text editor that is capable of reading RTF files. To print a report Select the report to be printed and click on the appropriate export format icon. If the report file contains a date field, you will be prompted to select a date-range for the report. If no date range is required, ensure that the 'Ignore Dates' check-box is selected and press the 'Continue' button. When the report has been generated, a confirmation screen will appear as shown below: The report can now be viewed or saved to disk by clicking on the link specified. Helpdesk End User (Customer) login This section describes in detail the functions that are available to helpdesk end-users (Customers) via the Web Interface. When logging into the SupportDesk Web Interface as a customer of the helpdesk, different sets of functions are available than to helpdesk specialists. Registered customers of the helpdesk may perform the following functions. Add and view only their requests. Add note entries to requests Search the SupportDesk knowledge base for documents or previous problems. Enabling end users to login Before end users can begin using the Web Interface, all those who wish to access it are required to have a unique username and password. Assigning usernames and passwords can be achieved in two different ways: A helpdesk operator from within the main SupportDesk program assigns a username and password. 21
An end user that is not currently registered with the helpdesk can enter their own details and choose their own username and password. The first of the above examples is achieved by loading the details of the selected inventory contact and pressing the Web ID toolbar button at the top of the Inventory Item Details window. The following screen will appear for you to enter both a username and password for the item: The second of the above examples uses the default SupportDesk Contact style to gather information from users who wish to register with the helpdesk. The data is then sent back to the SupportDesk database and the newly registered user will appear as part of the helpdesk inventory within the Navigator tree structure. Helpdesk customers are provided with a facility to change their login password should they so wish. To do so, they must specify their existing user ID and password as well as provide and confirm a new password. Once password change is successful a note is automatically added to the customers notes field in SupportDesk stating the date and time that the password was changed. In addition, and providing that the customer has a valid E-mail address, a notification E-mail is sent to them containing the details of their new password. Helpdesk administrators can prevent customers from logging into the web interface if their Service Level Agreement (SLA) has expired or is not yet active. This feature should prove most useful to companies that offer SLAs on a contract basis. It is now possible to have helpdesk customers notified of their password via E-mail instead of displaying it onscreen. Note: In order for new users to register with the helpdesk, they must supply the helpdesk-defined username and password. See Configuring the SupportDesk Web Interface (Above) for further details. Logging on as an end user Once an end user s settings have been configured, they may then login to the helpdesk by using the Login as a customer option where they will then be required to enter their username and password. A total of four incorrect login attempts are allowed before end-users can no longer attempt to login. The "Forgotten Password" screen brings up a dialogue which allows you to provide a customer ID to retrieve your password, as below; 22
This feature can be disabled if required by using the INI Editor program and ensuring that the 'Enable customers to retrieve password' feature is disabled. Change Password Feature Customers can change modify their own password via the customer login screen. In order to do this, customers must provide their existing user id and password. Note: When a customer changes their password, a note entry will be placed against them stating the date and time the password was changed. This can be viewed from within the Inventory Items Notes screen. The Web Interface main window Once that a helpdesk customer has logged into SupportDesk, the main window will appear. 23
This is broken into two sections: Along the top of the screen is the navigation toolbar. By pressing any of these buttons, the user will be directed to the relevant section. Finally, the main display window is located to the centre of the screen. This is where all pages of the Web Interface are displayed. Note:The Navigator Tree is not available to end-users of the SupportDesk Web Interface. The Navigation Toolbar The Navigation Toolbar allows users to navigate through the various pages of the Web Interface. These functions from left to right are as follows: Add Request Request List Contact us Home Knowledge Base Add Request All Requests that an end-user adds will be associated with themselves. To add a request, click on the Add Request button on the navigation toolbar at the top of the page and the following screen will appear: 24
The end-user add request screen looks much the same as the helpdesk specialist version, but if the helpdesk administrator has chosen to enforce a pre-defined set of parameters for the request, then the dropdown-boxes will be automatically populated to reflect those restrictions and no other options will be available to the end-user, however, if no selection restrictions are in force, the end-user will be able to select any of the available parameters. For further information, see Configuring the SupportDesk Web Interface (above). Next, select all of the required parameters for the request and enter a description of the problem. End-users can also choose to set an alarm for the specialist of the request if they so wish, ensuring that the Set alarm for specialist check-box is checked. Press the Add Request button at the bottom of the page and the new request will be added. Confirmation of the request is shown on the screen shot below: Viewing the Request List and Request Details To view all of your existing requests as an end-user, click on the Request List button on the navigation toolbar, and the following screen will appear: 25
You are prompted to sort Requests either by a straight ascending or descending list, or by searching for specific Request ID s. Click the appropriate button and the list of current Requests will appear, shown below; This is the customer request list and it presents a list of all requests that the current customer is associated with. To view the details of any of these requests, click on the request ID field to the far-left of the list and the following screen will appear: 26
This is the Request Details screen that end-users can view. Unlike the helpdesk specialist Request Details screen, end-users are not able to change any of the parameters of a request, but they can submit further notes and comments that are added to the details section of the request. To add a further note to a request, follow the steps below: Load the required request s details into the main window. Enter the note in the Additional Notes section of the page. Press the Update button and the note entry will be added to the request. Note: End-users are not permitted to delete any requests from the system. Contact Us Displays an E-mail address (as defined in the Database Administration Module) for contacting the Helpdesk. File Attachments The File Attachments screen is an option available from the Request, Item, and Knowledge Base functions. From the File Attachments screen specialists (and authorised customers) can upload and download files directly to the Helpdesk database and link them to particular Request, KB article, or inventory Item. These files can be of any type although the maximum file size allowed is 1MB per file. The File Attachments screen is shown below. 27
The upper part of the screen displays existing attachments. Click "browse" to locate new files you wish to upload. Next click "Open" to target the file you wish to upload and then click "Upload" from the File Attachments screen. The Upload confirmation message is then displayed (below). 28
Once the file has been uploaded the File Attachments screen now displays the attached files alongside two new options, "Download" and "Delete". Clicking "Download" will copy the file to your local computer. Searching the SupportDesk Knowledge Base This section explains how to query the SupportDesk Knowledge Base by either searching existing requests or by querying the Microsoft Index Server for documents contained within the helpdesk web server. The section applies to both helpdesk specialists and end-users alike. Introduction 29
Before the Knowledge Base functionality can be used, the SupportDesk database and the Microsoft Index Server must be configured. For information on how to do this, see the sections Configuring the SupportDesk Knowledge Base and Configuring Microsoft Index Server above. Once that these pre-requisites have been met, helpdesk specialists and end-users can access the knowledge base functionality. In both types of environment, click on the Knowledge Base navigation button on the main toolbar and the following screen will appear: The two options available here are as follows: Search Helpdesk Requests: This option allows users to search for existing requests that may solve the problem that they are experiencing. Search Helpdesk Documents: This option allows users to search for documents contained within the helpdesk web-server for articles that may solve the problem that they are experiencing. To search for existing helpdesk articles Click on the Search Helpdesk articles' link and you will be taken to the following screen: From this screen, users are required to enter all phrases or keywords that they are looking for. Each keyword or phrase must be separated by a space. An example of a search string is shown below: forgotten password Once the required search string is complete, press the Search button. The search will then be conducted and the following screen will appear containing any matching results. 30
The results screen shows both the detail and resolution of any matching requests and each of the words or phrases specified in the original search criteria will appear highlighted. Note: If a helpdesk specialist searches for existing requests then along with the search results will appear a link which will take them straight to the details of the specified request. This link is not available to helpdesk customers. To search for helpdesk documents Click on the Search Helpdesk Documents link and you will be taken to the following screen: 31
From this screen, users are required to enter all phrases and keywords that they are looking for. The query language used here is a little different from searching through requests. An example of the query language is displayed below: The text search engine allows queries to be formed from arbitrary Boolean expressions containing the keywords AND, OR, and NOT, and grouped with parentheses. For example: information retrieval Finds documents containing 'information' or 'retrieval' information or retrieval Same as above information and retrieval Finds documents containing both 'information' and 'retrieval' information not retrieval Finds documents containing 'information' but not 'retrieval' (information not retrieval) and WAIS Finds documents containing 'WAIS', plus 'information' but not 'retrieval' web* Finds documents containing words starting with 'web' Once the required criteria has been entered, press the Start Search button. Any matching documents will then be presented to the user along with the filename, file size and a brief extract from the document. If you are using the web interface over an intranet and providing that you have the correct software to do so, you will be able to view the document from within the Web Interface environment. If however you are viewing the document over the Internet then you will be prompted to either download the file or open it over the Internet. 32
Index A Adding a Request....8 Adding new inventory data...7 Amending existing inventory data...7 B Bulletin Board... 16 C Contact Us... 16, 27 Customer Add_Request... 24 Customer Password Change... 23 E Emailing Request Details... 15 Enabling end users to login... 21 F Features of the Web Interface...3 File Attachments... 17, 27 H Helpdesk End User Customer login... 21 Helpdesk Reports... 20 Helpdesk Specialist Login...4 I Introduction to the web interface...3 L Logging on as an end user... 22 Logging out of SupportDesk... 17 R Request Details... 10 Request Statistics...9 S Searching for a Request...8 Searching the SupportDesk Inventory...6 Searching the SupportDesk Knowledge Base... 29 T The To Do List... 16 The Web Interface main window... 23 To print a report... 21 U User Defined Fields... 19 V Viewing Alarms... 14 Viewing the Request List and Request Details... 25 33