Ferrysoft Help Desk
Ferrysoft Help Desk is a web based help desk solution. The Express Edition is free of charge. Click the screen shot to learn more about Ferrysoft Help Desk.
How to use the Administration features of Ferrysoft Help Desk
Introduction
The administration options of Ferrysoft Help Desk are accessible via the Administration page. This page is only available to users with the Help Desk Administrator role. This is initially just the user named administrator. The screen image below shows the Administration page.
The following sections explain each of the available options. The options are listed in the suggested order for setting up a new system.
Registration Key
The Setup Registration Key page allows input of the Registration Key details as provided by Ferrysoft. Setup of a Registration Key is only required if Ferrysoft Help Desk is being used in a multi-user environment as it allows more than one registered user. If Ferrysoft Help Desk is used without setting up a valid Registration Key then the number of registered users is limited to one. The Organisation Name, Registered Users and Registration Key must be entered exactly as provided by Ferrysoft, in order to setup the Registration Key correctly. The screen image below shows the Setup Registration Key page.
Organisation Name
Enter the name of the organisation as provided by Ferrysoft. Organisation Name is a required field.
Registered Users
Enter the number of registered users as provided by Ferrysoft. Registered Users is a required field and must be numeric in the range 1 to 1000 or zero for unlimited.
Registration Key
Enter the registration key as provided by Ferrysoft. Registration Key is a required field and is a maximum of thirty two characters in length.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
Priorities
The Priorities page allows the priorities table to be modified. The priorities table controls the allowable priorities for cases. The screen image below shows the Priorities page.
Click the Modify link to access the Existing Priority page for the selected priority.
The screen image below shows the Existing Priority page.
Priority Name
Enter the priority name for the priority.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
Lists and Entries
The Lists page allows the list names and entries within those lists to be modified. The lists and entries table controls the allowable customised lists for cases. The screen image below shows the Lists page.
Click the Modify link to access the Existing List page for the selected list. Click the Entries link to access the Entries page for the selected list.
The screen image below shows the Existing List page.
List Name
Enter the list name for the list. List Name is mandatory.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
The screen image below shows the Entries page.
Click the New Entry link to access the New Entry page for the list. Click the Modify link to access the Existing Entry page for the selected entry.
The screen image below shows the Existing Entry page.
Entry Name
Enter the entry name for the entry. Entry Name is mandatory.
Entry Description
Enter the entry description for the entry. Entry Description is mandatory.
Delete button
Click the Delete button to delete the entry. A prompt will appear to confirm that the entry should be deleted.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
Organisations, Contacts and Users
Ferrysoft Help Desk allows you to associate contacts with cases. Contacts can belong to your own internal organisation, customer organisations or supplier organisations. Internal contacts can be accessed directly via the Internal Contacts link of the Administration page. Alternatively, internal contacts can be accessed by selecting the internal organisation from the Organisations page. Customer contacts and supplier contacts can only be accessed by selecting the corresponding organisation from the Organisations page. You are allowed to setup one internal organisation and multiple customer and supplier organisations. Each organisation can have multiple contacts associated with it. Users are people who are allowed to login to Ferrysoft Help Desk. Users must be bound to a contact before they are eligible to login to Ferrysoft Help Desk. Therefore users are categorised as internal, customer or supplier depending on their contact binding. Binding can be performed in either direction with the same result. That is, a user can be bound to a contact or a contact can be bound to a user. The screen image below shows the Organisations page.
Click the New Organisation link to access the New Organisation page. Click the Modify link to access the Existing Organisation page for the selected organisation. Click the Contacts link to access the Contacts page for the selected organisation.
The screen image below shows the Existing Organisation page.
Organisation ID
Enter the organisation identifier for the organisation. Organisation ID is mandatory.
Organisation Name
Enter the organisation name for the organisation. Organisation Name is mandatory.
Delete button
The Delete button does not appear if the organisation is an internal organisation. Click the Delete button to delete the organisation. A prompt will appear to confirm that the organisation should be deleted.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
The screen image below shows the Contacts page.
Click the New Contact link to access the New Contact page for the organisation. Click the Modify link to access the Existing Contact page for the selected contact. Click the Bind link to access the Select The User To Bind To page for the selected contact. The Bind link is not shown if the contact is already bound to a user.
The screen image below shows the Existing Contact page.
Contact Name
Enter the contact name for the contact. Contact Name is mandatory.
Email Address
Enter the email address for the contact. Email Address is mandatory.
Business Phone
Enter the business telephone number for the contact.
Home Phone
Enter the home telephone number for the contact.
Mobile Phone
Enter the mobile telephone number for the contact.
Bind Status
An indication of whether the contact is bound to a user. Display only.
Unbind when contact is saved
This checkbox is only visible if the contact is bound to a user. Check the box if you want to unbind the contact from the user when the Save button is clicked.
Delete button
Click the Delete button to delete the contact. A prompt will appear to confirm that the contact should be deleted.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
The screen image below shows the Users page.
Click the New User link to access the New User page. Click the Modify link to access the Existing User page for the selected user. Click the Unlock button to unlock a locked user. The Unlock button is not shown unless the user is locked. Click the Approve button to approve the user to login. The Approve button is not shown if the user is already approved to login. Click the Bind link to access the Select The Contact To Bind To page for the selected user. The Bind link is not shown if the user is already bound to a contact.
The screen image below shows the Existing User page.
Email Address
Enter the email address for the user. Email Address is mandatory.
Password
Enter the password for the user. Password is mandatory.
Approved
Check the box if the user is approved to login.
Help Desk User Role
Check the box if the user is designated with the user role within the help desk. This is the lowest level of access allowed within the help desk. If a user does not hold at least this role then access to the help desk is not allowed.
Help Desk Supervisor Role
Check the box if the user is designated with the supervisor role within the help desk. This is a higher level of access than user but a lower level of access than administrator within the help desk.
Help Desk Administrator Role
Check the box if the user is designated with the administrator role within the help desk. This is the highest level of access allowed within the help desk.
Discussion Forum User Role
Check the box if the user is designated with the user role within the discussion forum. This is the lowest level of access allowed within the discussion forum. If a user does not hold at least this role then access to the discussion forum is restricted to anonymous access.
Discussion Forum Moderator Role
Check the box if the user is designated with the moderator role within the discussion forum. This is the highest level of access allowed within the discussion forum.
Knowledge Base User Role
Check the box if the user is designated with the user role within the knowledge base. This is the lowest level of access allowed within the knowledge base. If a user does not hold at least this role then access to the knowledge base is restricted to anonymous access.
Bind Status
An indication of whether the user is bound to a contact. Display only.
Unbind when user is saved
This checkbox is only visible if the user is bound to a contact. Check the box if you want to unbind the user from the contact when the Save button is clicked.
Delete button
Click the Delete button to delete the user. A prompt will appear to confirm that the user should be deleted.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
The screen image below shows the Select The User To Bind To page.
Click the Bind button to bind the contact to the selected user.
The screen image below shows the Select The Contact To Bind To page.
Click the Bind button to bind the user to the selected contact.
External Interfaces
Ferrysoft Help Desk incorporates an incoming mail server interface to receive emails, an outgoing mail server interface to send emails and a web interface. The Setup External Interfaces page allows the parameters for each of these interfaces to be defined. The screen image below shows the Setup External Interfaces page.
Incoming Mail Server (POP3) Connection Parameters
Server Name
Enter the server name of the incoming mail server to use for receiving emails. The incoming mail server must support the Post Office Protocol - Version 3 (POP3).
Port Number
Enter the port number of the incoming mail server. Port number must be numeric. If this option is left blank then the default is "110".
Connection Timeout
Enter the connection timeout in seconds to use with the incoming mail server. Connection timeout must be numeric. If this option is left blank then the default is "30".
Encrypted Connection
Select this check box if the incoming mail server requires an encrypted connection (SSL).
Username
Enter the Username to use when authenticating with the incoming mail server.
Password
Enter the Password to use when authenticating with the incoming mail server. The password is stored in encrypted form within the incoming mail server interface for security purposes.
Outgoing Mail Server (SMTP) Connection Parameters
Server Name
Enter the server name of the outgoing mail server to use for sending emails. The outgoing mail server must support the Simple Mail Transfer Protocol (SMTP).
Port Number
Enter the port number of the outgoing mail server. Port number must be numeric. If this option is left blank then the default is "25".
Connection Timeout
Enter the connection timeout in seconds to use with the outgoing mail server. Connection timeout must be numeric. If this option is left blank then the default is "30".
Encrypted Connection
Select this check box if the outgoing mail server requires an encrypted connection (SSL).
Authentication
Select this check box if the outgoing mail server requires authentication. If authentication is selected then a Username and Password is also required.
Username
Enter the Username to use when authenticating with the outgoing mail server. Username is only required if authentication is selected.
Password
Enter the Password to use when authenticating with the outgoing mail server. Password is only required if authentication is selected. The password is stored in encrypted form within the outgoing mail server interface for security purposes.
From Email Name
Enter the From Email Name to use on outgoing emails.
From Email Address
Enter the From Email Address to use on outgoing emails.
Web Interface
Internet Address
Set Internet Address to the web site address that you have set up for accessing Ferrysoft Help Desk via the Internet. For example, http://www.example.com/ferrysofthelpdesk/
Intranet Address
Set Intranet Address to the web site address that you have set up for accessing Ferrysoft Help Desk via your intranet. For example, http://example/ferrysofthelpdesk/
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
Announcements
Announcements is a feature to display messages to users of Ferrysoft Help Desk on the login page. Announcements can be used to display status information about Ferrysoft Help Desk or other useful information. Each announcement is set up with a Sunrise Date (the first date when it will appear) and a Sunset Date (the last date when it will appear). The screen image below shows the Announcements page.
Click the New Announcement link to access the New Announcement page. Click the the Modify link to access the Existing Announcement page for the selected announcement.
The screen image below shows the Existing Announcement page.
Announcement Title
Enter the title for the announcement. Announcement Title can be up to 255 characters long. Announcement Title is mandatory.
Announcement Text
Enter the text for the announcement. Announcement Text is mandatory.
Sunrise Date
Select the date that specifies the start of the period for showing the announcement to users of Ferrysoft Help Desk. The Sunrise Date must not be after the Sunset Date otherwise the announcement would never be shown. The Sunrise Date and the Sunset Date can be the same date, in which case, the announcement is shown for one day.
Sunset Date
Select the date that specifies the end of the period for showing the announcement to users of Ferrysoft Help Desk. The Sunset Date must not be before the Sunrise Date otherwise the announcement would never be shown. The Sunset Date and the Sunrise Date can be the same date, in which case, the announcement is shown for one day.
Delete button
Click the Delete button to delete the announcement. A prompt will appear to confirm that the announcement should be deleted.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
Discussion Forum
Discussion Forum is an electronic meeting place where a community of users can get together to discuss a common interest. The Discussions page is the means to setup the structure of the discussion forum. The screen image below shows the Discussions page.
Click the New Discussion link to access the New Discussion page. Click the Modify link to access the Existing Discussion page for the selected discussion.
The screen image below shows the Existing Discussion page.
Discussion Name
Enter the name for the discussion. Discussion Name can be up to 25 characters long. Discussion Name is mandatory.
Discussion Description
Enter the description for the discussion. Discussion Description can be up to 255 characters long. Discussion Description is mandatory.
Recent Display Maximum
Enter the recent display maximum number and type for the discussion. This controls the maximum number of topics displayed in a Recent Topics display. It can be expressed as a number of topics or a number of days. Recent Display Maximum is mandatory.
Older Display Maximum
Enter the older display maximum number and type for the discussion. This controls the maximum number of archives displayed in an Older Topics display and the display style. It can be expressed as a number of months or a number of years. The display style is monthly archives or yearly archives depending on the specified type. Older Display Maximum is mandatory.
Delete button
Click the Delete button to delete the discussion. A prompt will appear to confirm that the discussion should be deleted.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
Knowledge Base
Knowledge Base is an electronic database of knowledge that can be used to contain solutions to common issues. The Knowledge Bases page is the means to setup the structure of the knowledge base. The screen image below shows the Knowledge Bases page.
Click the New Knowledge Base link to access the New Knowledge Base page. Click the Modify link to access the Existing Knowledge Base page for the selected knowledge base. Click the Topics link to access the Knowledge Topics page for the selected knowledge base.
The screen image below shows the Existing Knowledge Base page.
Knowledge Base Name
Enter the name for the knowledge base. Knowledge Base Name can be up to 25 characters long. Knowledge Base Name is mandatory.
Knowledge Base Description
Enter the description for the knowledge base. Knowledge Base Description can be up to 255 characters long. Knowledge Base Description is mandatory.
Delete button
Click the Delete button to delete the knowledge base. A prompt will appear to confirm that the knowledge base should be deleted.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
The screen image below shows the Knowledge Topics page.
Click the New Knowledge Topic link to access the New Knowledge Topic page. Click the Modify link to access the Existing Knowledge Topic page for the selected knowledge topic.
The screen image below shows the Existing Knowledge Topic page.
Knowledge Topic Title
Enter the title for the knowledge topic. Knowledge Topic Title can be up to 255 characters long. Knowledge Topic Title is mandatory.
Knowledge Topic Text
Enter the text for the knowledge topic. Knowledge Topic Text is mandatory.
Delete button
Click the Delete button to delete the knowledge topic. A prompt will appear to confirm that the knowledge topic should be deleted.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page
System Defaults
The Setup System Defaults page is used to setup the defaults for system level data values. The screen image below shows the Setup System Defaults page.
Text 1
Enter a new description for the Text 1 field. This allows the use of the Text 1 field to be tailored for display on the New Case and Existing Case pages. Text 1 is mandatory.
Text 2
Enter a new description for the Text 2 field. This allows the use of the Text 2 field to be tailored for display on the New Case and Existing Case pages. Text 2 is mandatory.
Text 3
Enter a new description for the Text 3 field. This allows the use of the Text 3 field to be tailored for display on the New Case and Existing Case pages. Text 3 is mandatory.
Default Sunrise Date Offset
Enter a number of days in the range 0 to 90. This number is added to today's date to calculate the Default Sunrise Date for a new announcement. If the Default Sunrise Date Offset is zero then the Default Sunrise Date for a new announcement is today. If the Default Sunrise Date Offset is one then the Default Sunrise Date for a new announcement is tomorrow. Typically, Default Sunrise Date Offset will be set to zero so that the Default Sunrise Date is today which causes a new announcement to appear immediately.
Default Sunset Date Offset
Enter a number of days in the range 0 to 90. This number is added to today's date to calculate the Default Sunset Date for a new announcement. If the Default Sunset Date Offset is zero then the Default Sunset Date for a new announcement is today. If the Default Sunset Date Offset is one then the Default Sunset Date for a new announcement is tomorrow. Typically, Default Sunset Date Offset will be set to seven so that the Default Sunset Date is one week away which causes a new announcement to appear for a duration of one week.
Announcement Purge Days
Enter a number of days in the range 0 to 365. This number is added to the Sunset Date of announcements to determine the earliest date to purge the announcement from the system. If the Announcement Purge Days is zero then announcements are eligible for purging as soon as they have passed their sunset date. Typically, Announcement Purge Days will be set to ninety so that announcements are purged approximately three months after they have reached their sunset date.
Default Discussion
Select the name of the discussion to display by default when the Discussion Forum is accessed. If no Default Discussion is set then the first discussion in alphabetic order is displayed by default.
Default Knowledge Base
Select the name of the knowledge base to display by default when the Knowledge Base is accessed. If no Default Knowledge Base is set then the first knowledge base in alphabetic order is displayed by default.
Default Assigned To
Select the name of the person to use as the default for all new cases entered by customer contacts or supplier contacts. This allows a named user to be automatically assigned to new cases and receive alerts when new cases are entered by customer contacts or supplier contacts. This default does not apply to new cases entered by internal contacts as the default in that situation is always the name of the internal contact entering the new case.
Save button
Click the Save button to save the changes made on this page.
Cancel button
Click the Cancel button to abandon the changes made on this page and return to the previous page