Documentation

{{docApp.title}}

{{docApp.description}}

INDEX

Documentation Library

Search for information on Hornbill Documentation.

{{docApp.searchError}}

{{docApp.searchResultFilteredItems.length}} results for "{{docApp.currentResultsSearchText}}" in {{docApp.searchFilterBySpecificBookTitle}}

Have questions about this site?


What is this site?

  • This website is Hornbill's new product documentation website and is currently under development.
  • It is intended that all existing and future public-facing documentation we produce will be available to search, browse and share.
  • Hornbill's current documentation is available at Hornbill Wiki but over time this content will be migrated to this documentation site.
  • Please feel free to have a look around at any time.

Why has Hornbill created this site?

  • Hornbill's products have moved on considerably since we introduced it almost 10 years ago. At the time, the MediaWiki tool was sufficient, but we have outgrown it.
  • Our customers are more enterprise focused and more self-sufficient than ever before, so for 2023 and beyond we have established a new documentation platform and team to drive our documentation initiative forwards.
  • We are aiming to deprecate the use of Hornbill Wiki for most Hornbill related documentation.
  • We want to enable our growing partner network with product resources and information, documentation beyond our Wiki approach is required.
  • We could definitely do with some help, and may even pay for some! If you have domain knowledge and would like to help, please check out our Hornbill Docs Contributor Guide and contact the Hornbill docs team at docs@hornbill.com.

What will this site be good for?

  • Community contribution will be facilitated, encouraged, and most welcome.
  • High quality documentation, will be kept up to date as rapidly as our products evolve.
  • Real-time content search and discovery.
  • Articles organized into books, books into libraries, creating a more natural and logical structure to our documentation.
  • Legacy API documentation and various other documentation sources will all be consolidated into a single unified documentation system.
  • Documentation available in browser as well as printable/viewable as PDF on demand.
  • Personalized documentation experience, allowing dark/light mode, article subscriptions, social media sharing and other useful features.
  • Almost all publicly available documentation on docs.hornbill.com will be open-source and available to fork on GitHub, allowing customers to derive their own custom documentation around Hornbill products should they wish to.

What is the timeline for this site?

  • We have taken the decision to publish and make available early, there is very little content at this time.
  • As and when we have completed/usable documentation, it will be published here.
  • We have a host of additional features we wish to add over time, so please watch this space.
  • We expect most of our existing documentation should be reviewed/migrated to docs.hornbill.com over the coming months.
  • The documentation project will be ongoing, will continue to expand, evolve and improve day-by-day.

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

{{group.title || group.id}}

{{group.description}}

  1. {{book.title}}

{{group.title}}

Resolve and Close

The Resolve and Close Action Item is used to set the request status to either Resolved or Closed. In addition to changing the status, information about the solution or information supporting the status change can be added along with the selection of a Closure Category.

Options

  • Resolve
  • Close
  • Closure Category
  • Resolution Text
  • Editing

Tip

If the visibility is set to Customer, the resolution tab along with the resolution text is made available to the customer on the portal.

Settings

Prevent resolution when there are outstanding Activities This setting prevents a request from being resolved when there are outstanding activities. Additional activities can be added after the request has been resolved if required.

webapp.view.ITSM.serviceDesk.requests.resolve.denyWithOpenActivities

  • Default Setting is Off.
  • This will apply to all request types for all services.

Enforce the selection of a closure category This setting prevents a request from being resolved or closed until a Closure Category has been selected.

servicemanager.request.closureCategory.default.required

  • Default is set to 'Off.
  • This will apply to all request types for all services.

Enforce the selection of a last item closure category Whether the user is forced to select the last tree element for the closure category.

guest.servicemanager.request.category.closure.enforceLastItem

  • Default is set to Off.
  • This will apply to all request types for all services.

Resolve Linked Requests A Service Manager setting is available which enables a feature within the Request Close Action Item that allows an analyst to resolve one or more requests that are linked to the request that you are resolving or closing.

app.request.resolve.enableLinkedRequestAction

  • Default is set to Off
  • Resolve When this setting is enabled, the Resolve button will include an additioal drop-down option to Resolve Linked Requests. A list of the requests that are currently linked to the request you are resolving will be displayed. From this list, you can select which requests you would like to resolve at the same time.
    • The requests displayed will be filtered to those that you have the right to resolve, based on if the linked requests are logged against Services that your teams support.
    • Resolved/closed requests will not appear in the list.
  • Close When this setting is enabled, the close button will include an additional drop-down option to Close Linked Requests if there are requests linked with the status of resolved. An additional option will be available to resolve requests if there are any linked requests that have a status of Open.
    • The requests displayed will be filtered to those that you have the rights to close/resolve, based on if the linked requests are logged against Services which your teams support.
    • Closed requests will not appear in the list.

Two Stage Closure

Many customers like to operate what is known as a “Two Stage Closure” routine after a resolution to a request has been established. This typically involves changing the status of the request to “Resolved” when the initial resolution has been provided to the customer and closing the request only when either a confirmation of the resolution has been received from the customer, or a certain period has elapsed without action or response, and the request should be automatically closed e.g. 7 days. This can be incorporated into Hornbill Service Manager using the configured Business Processes against your requests and this article explains how to set this up.

Scenarios

Before configuring, its useful to consider the different scenarios when resolving and closing a request. What will be the same for every request is that it will be Resolved (i.e. have its status set to Resolved). This is typically performed by an Analyst entering a resolution within the Hornbill request, which may notify the customer.

  1. Resolution Accepted
    The customer accepts the resolution, either via the Service portal or the Analyst closing on their behalf. This moves the status of the request to Closed
  2. Resolution Rejected
    The customer advised the issue is not resolved or the resolution didn’t work, either by actioning this on the Service Portal or informing the Analyst who will reopen on their behalf. This moves the status of the request to Open
  3. No Action
    There is no response from the customer. Instead of the analysts having to remember to manually close these requests, the system will automatically close any resolved request after “X” number of days. This moves the status of the request to Closed

Two Stage Closure Workflow

The above scenarios need to be configured within the Business Process of your request.

  • Suspend - Wait for Status Change
    The first node to be set up is “Suspend - Wait for Status Change”. We know that by the time it reaches this node, the status of the request will be “Resolved”. This pauses the process until the status changes to either Closed or back to Open – as per the scenarios above.

    Within the configuration of this node, you will also have the option to set an Expiry Period. This is the period that this Suspend node will stay active for, before it automatically moves on to the next node in the process – which is how it possible to set up the automatic closure after a defined number of days. The expiry period is in working hours and will adhere to the hours configured in the Working Time Calendar.

  • Decision Node
    Following the suspend node, the decision node will determine the status that the request has been changed to.

    1. Reopened By Customer
      This decision criteria is based on if the status has been changed from Resolved to Open.
    2. Expired
      This decision criteria is based on if the status has remained as resolved and Expiry Time we provided has elapsed. The expiry time is in working hours and will adhere to the hours configured in the “ServiceDeskDefaultCalendar” working time calendar found in Hornbill Administration.
    3. No Match
      This refers to the only other option, which is that the request has been closed – and the criteria is based on if the status has been changed from resolved to closed.
In This Document