Difference between revisions of "Request Catalog"

From Hornbill
Jump to navigation Jump to search
 
(93 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
__NOTOC__[[Main Page|Home]] > [[Service Manager]] > [[Services]] > Request Catalog
+
This document can now be found at its new location in the [https://docs.hornbill.com/servicemanager-user-guide/service-portfolio/request-catalog/ Hornbill Document Library].
−
== Introduction ==
 
  
−
The Service Request Catalogs provide a structured way of promoting the available types of requests that are available for a particular Service. Items in the Request Catalog are accessible by subscribed users of a Service on the Hornbill Portals and can also be accessed by Support Staff to provided a standard way of raising a particular type of request. Each item in the Request Catalog can be configured to run its own unique Progressive Capture allowing you to set specific information to be captured for that request and it can run its own Business Process Workflow to define how each request will be fulfilled.
+
[[file:hornbill-document-library.png|Request Catalog|link=https://docs.hornbill.com/servicemanager-user-guide/service-portfolio/request-catalog/]]
 +
<!--
  
−
== Where Do I Configure Service Catalog items? ==
+
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
 +
__NOTOC__[[Main Page|Home]] > [[Service Manager]]  > [[Service Portfolio]] > [[Services Request Configuration]] > Request Catalog
 +
</div>
 +
{|style="width: 100%"
 +
|- valign="top"
 +
|style="width:73%"|
 +
==Introduction==
 +
The Service Request Catalogs provide a structured way of promoting the available types of requests for a particular Service. Items in the Request Catalog are available to subscribed users of a Service on the Hornbill Portals and can also be accessed by Support Staff to provide a standard way of raising a particular type of request.  Each item in the Request Catalog can be configured to run its own unique Capture Script allowing you to prompt for information required for that request and it can run its own Business Process Workflow to define how that request will be fulfilled.
  
−
To configure a new Service Catalog item or edit an existing one, you need the Services Manager role associated to your Hornbill User account. Possessing this role will make the Services menu item visible to you:
+
|style="width:5%"|
−
Select the Service Manager icon from the navigation bar and then Services. 
+
|
 +
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
  
−
* Add or edit Catalog items to an existing Service by selecting the Service and navigating to the Request Configuration tab.
+
== Related Articles ==
−
* Create a New Service and then navigate to the Request Configuration tab to create Catalog items for the new Service.
+
:* [[Managing Request Catalog Visibility]]
 +
:* [[Services Request Configuration]]
 +
:* [[Business_Process_Designer|Business Process Designer]]
 +
:* [[Intelligent Capture Designer]]
 +
:* [[Service_Manager_Settings|Service Manager System Settings]]
 +
|}
  
−
== Creating a Service Catalog Item ==
+
{{#ev:youtube|3Nl9KP4DkjU|400|right}}
  
−
Catalog Items can be created against both the Incident and Service Request types. This allows you to define which request type any requests will be created as, when the Catalog Item is used.
+
== Administration ==
 +
In order to create and manage the Request Catalogs the following User Roles are needed to perform the different actions
  
−
It is possible to create Catalog items for both the Incident and Service Request Types against the same Service, and for the Catalog Items to appear together under the Service when viewed by customers on the portals, or by analysts logging requests using Progressive Capture.
+
* Service Manager Role - Required to View and Access the Services forms where the Request Catalogs are created
 +
* Progressive Capture Manager Role - Required to create and modify and Progressive Capture Scripts to be used with a Catalog Item
 +
* Business Process Manager Role - Required to create and modify any Workflow to be used with a Catalog Item
  
−
To Create a New Catalog Item select the + Catalog Item button under the Catalog Item section of either the Incident or Service Request Tab depending on which type of request you want the Catalog Item to be raised as.
+
Catalog items can be created to support Incident Management, Change Management and Request Fulfilment
  
−
Complete the Fields for the new Catalog Item:
 
  
−
* Title – The name for the Catalog Item, which will be displayed on the portals for customers, and for Analysts in Progressive Capture
+
[[File:Information.png|14px|text-top|Information]] By default Change Catalog Items can't be raised from the Customer or Service Portal.
−
* Description – Provide information which describes the purpose of the Catalog Item, this will be displayed on the portals for customers and Analysts in progressive Capture
 
  
−
* Configuration – Progressive Capture – Select from defined scripts which can ask the customer or analyst pertinent questions when raising a request for the catalog item
+
Enabling system setting: '''guest.servicemanager.portal.additionalRequestTypes.change''' will allow Change Catalog items marked as '''Portal''' or '''Both''' visibility to be visible on the Portals.
−
**Each catalog item can have its own set of questions and these can be configured using the progressive capture utility <Link>
+
* Please beware that enabling this setting will also allow customers to see any historical changes which have been raised and they have been set as the customer of the Changes (even if no Change Catalog Items were used on the Change records).
−
 
−
* Configuration – Business Process – Select which fulfilment process will be invoked and followed when a request is raised for the Catalog Item
 
−
** Fulfilment processes can be configured using the Business Process utility <Link>
 
−
*Icon – Select an Icon which will represent the Catalog Item on the portals and in progressive capture
 
−
* Visibility – Decide if the Catalog Item will be visible and selectable on just the portals, or just in progressive capture to analysts in service manager or to both.
 
−
* Language – By Default an English version of the Catalog Item, will be created.  It is possible to create the Catalog Item in multiple different languages, should you need to promote the Catalog to users in different languages on the portals or to the analysts in progressive capture.
 
  
−
Status
+
== Creation ==
 +
[[File:ServiceCatalogItemLIst.png |right |400px]]
 +
Catalog Items can be created for Incidents, Service Requests and Changes under the Request Configuration section of a Service.
  
−
It is possible to create the Catalog Item in Draft, or published Status.
+
# On the Service form select the Request Configuration tab
 +
# Locate the section titled ''Catalog Items''
 +
# Click on the ''Add Catalog Item'' button
  
−
* Draft – Is not visible on the portals or in progressive capture
+
=== Features ===
−
* Published – Is visible on the portals or in progressive capture
+
* Title – The name for the Catalog Item, which will be displayed on the portals for customers, and to support staff in Progressive Capture
−
* Retired - Is not visible on the portals or in progressive capture
+
* Description – Provide information which describes the purpose of the Catalog Item. This will be displayed on the portals for customers and to support staff in progressive Capture
 +
* Progressive Capture – Select from defined scripts which can ask the customer or support agent pertinent questions when raising a request for this Catalog Item
 +
* Business Process – Select which workflow will be invoked and followed when a request is raised for this Catalog Item
 +
* Icon – Select an Icon which will represent the Catalog Item in portals and in progressive capture
 +
* Visibility – Decide if the Catalog Item will be available on just the portals, or just to support staff, or to both
 +
* Language –  Select the language that this Catalog Item is being written in.  This will default to the language that is currently being used in the user's session
 +
* Draft and Published Statuses
 +
** Draft – Is not visible on the portals or in progressive capture
 +
** Published – Is visible on the portals or in progressive capture
  
−
== Managing Catalog Items ==
+
== Managing ==
 +
The available Catalog Items are displayed in a list under the Catalog Items section.  From this list there are three options available
 
* Ordering Catalog Items – It is possible to influence the order in which the Catalog Items will appear on the portals (under the Service) by dragging and dropping to reorder the Catalog Items.
 
* Ordering Catalog Items – It is possible to influence the order in which the Catalog Items will appear on the portals (under the Service) by dragging and dropping to reorder the Catalog Items.
 +
* Managing Catalog Visibility - it is possible to configure which service subscribers can view each catalog item
 
* Update – It is possible to edit the details or status or to add additional languages to the Catalog Item by selecting the update Cog icon
 
* Update – It is possible to edit the details or status or to add additional languages to the Catalog Item by selecting the update Cog icon
 
* Delete – It is possible to permanently delete the Catalog Item by selecting the Delete Bin icon
 
* Delete – It is possible to permanently delete the Catalog Item by selecting the Delete Bin icon
 +
 +
[[File:Information.png|14px|text-top|Information]] If this list is empty, subscribed users for this Service will not have an option to raise a request from the portals for this request type.
 
[[Category: Service Manager]]
 
[[Category: Service Manager]]
 +
 +
== Intelligent Capture ==
 +
 +
The Request Catalog Items have been created in a way to allow each Catalog Item to be published to either Portal Users, Support Staff, or both.  Publishing a Catalog Item to both of these groups enables a member of the support team to raise a request on behalf of a user while following the same steps that the user would experience in the portals.  This ensures that the same information is captured no matter what the source is.
 +
[[File:PCServiceFormCatalog.png |400px|right|Capture Service Form]]
 +
=== Service Details Form ===
 +
The Service Details Form is required to give a support person the ability to select a Catalog Item when raising an Incident or Service Request. Selecting a service on the Service Details form will expose any available Catalog Items for that service.
 +
 +
* If no Catalog Items have been defined, the Service can be selected and the current progressive capture will continue to run
 +
* If one or more Catalog Items have been defined, either the Service can be selected to continue with the current progressive capture or one of the individual Catalog Items can be selected which will run a new progressive capture that is specific to that item.
 +
 +
=== Portal Only Catalog Items ===
 +
The creation of a Progressive Capture Script that is only going to be available to users of the portals is as straight forward as going to Administration and creating collection of forms and questions that the user will be stepped through to raise the appropriate request. 
 +
 +
When building a Progressive Capture Script for this purpose there is only one thing to keep in mind.  There are particular progressive capture forms that are not designed for use by portal users.  If these forms are added to these progressive capture scripts they will simply be skipped and not visible to the user on the portals.  These include the following forms:
 +
 +
* Customer Search
 +
* Co-worker Search
 +
* Contact Search
 +
* Service Details
 +
* Request Type
 +
* Customer Request Type
 +
* Analyst Assignment
 +
 +
=== Support Staff Only Catalog Items ===
 +
When a support person begins the steps of raising a request, they will start by clicking on the Raise New option or select a particular type of request, such as an Incident, or Service Request.  Each of these will run its own Progressive Capture Script.  Within any of these Progressive Capture Scripts the Service Details form may be included. It is this Service Details form that displays the list of available Catalog Items for each Service.  If one of these Catalog Items is selected, a new Progressive Capture Script will be launched.
 +
 +
It is possible that some of the information collected in the initial Progressive Capture Script will be relevant to the Catalog Item specific Progressive Capture Script.  In order to maintain this information between the two Progressive Capture Scripts, the same Progressive Capture forms must be included in both Scripts.  For example if you use the Customer Search form in the initial Progressive Capture, and you want retain the selected customer in the next script, the next script must also include the Customer Search form.  If information collected in the initial script is no longer relevant to the Catalog Item, simple leave that form out of the Catalog Item script.
 +
 +
=== Shared Catalog Items ===
 +
In some cases you may be able to use the same Catalog Item in both the Portal and the for the Support Staff. Using the considerations mentioned in the previous two sections, you can build a progressive capture script that lets you include Support specific forms which are skipped and not visible in the portals, but they can be added to retain information that the support person needs.
 +
 +
== Language ==
 +
If you are working in a multilingual environment you can publish each Catalog Item in a number of different languages. Any user that has a matching language set against their profile will see this Catalog in their preferred language.
 +
 +
=== Add a Translation ===
 +
The Language option provides a list of all of the different languages that this Catalog Item has been translated into.  A newly created Catalog Item will only show the language that was selected at the time of creation. To add a new translation click on the ''Add Translation'' button which will expose the options for publishing this in another language
 +
* Language - Select the new language that you wish to add
 +
* Translate - Clicking this button will take the original title and description from the default language and automatically translate these fields using Google Translate.  The Title and Description fields will be automatically populated with this translation.  These fields can also be manually edited to either add your own translation or used to correct any mistakes made by the automatic translation
 +
:: [[File:Information.png|14px|text-top|Information]] Clicking on the ''Translate'' button will overwrite any information that is already held in the Title and Description fields.
 +
 +
=== Update a Translation ===
 +
* Delete Translation - Clicking on this button will delete the language translation that is currently selected in the Language pick list.
 +
:: [[File:Information.png|14px|text-top|Information]] The default language translation cannot be deleted, therefore this button in not available when the default language is selected. The default language is a fallback and is displayed to a user who is using a language that does not have an associated translation available.
 +
* Update - If a manual change has been made to either the Title or Description fields, to save these changes by clicking on the ''Update'' button
 +
* Preview Google Translate - This is a sub-action of the ''Update'' button which is accessed by clicking on the arrow next to ''Update''.  This will translate the Title and Description fields using the default translation without saving it.  This Preview can then be saved using the main ''Update'' button.
 +
* Update with Google Translate - This is a sub-action of the ''Update'' button which is accessed by clicking on the arrow next to ''Update''.  This will automatically translate and save the Title and Description fields.
 +
-->
 +
[[Category:HDOC]][[Category:Videos]]

Latest revision as of 20:31, 16 February 2024

This document can now be found at its new location in the Hornbill Document Library.

Request Catalog

Retrieved from "https://wiki.hornbill.com/index.php?title=Request_Catalog&oldid=31970"