Difference between revisions of "Intelligent Capture Designer"

From Hornbill
Jump to navigation Jump to search
 
(58 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
+
This document can now be found at its new location in the [https://docs.hornbill.com/servicemanager-config/customize/intelligent-capture-designer/ Hornbill Document Library].
__NOTOC__[[Main Page|Home]] > [[Administration]] > Progressive Capture Designer
+
 
</div>
+
[[file:hornbill-document-library.png|Intelligent Capture Designer|link=https://docs.hornbill.com/servicemanager-config/customize/intelligent-capture-designer/]]
{|style="width: 100%"
+
<!--
|- valign="top"
+
 
|style="width:73%"|
+
{{DISPLAYTITLE:Intelligent Capture Designer}}
 +
{{breadcrumb|[[Main Page|Home]] > [[Configuration]] > Intelligent Capture Designer|Configuration}}
 +
{{Section|
 
== Introduction ==
 
== Introduction ==
Progressive Capture is a graphical workflow tool that provides a new and simple way to define the capturing of information for a particular application. An application that uses Progressive Capture will include a number of small forms for collecting information related to the application. These forms can be optionally added, ordered, and branched depending on the information being captured.
+
Intelligent Capture is a graphical workflow tool that provides a new and simple way to define the capturing of information for a particular application. An application that uses Intelligent Capture will include a number of small forms for collecting information related to the application. These forms can be optionally added, ordered, and branched depending on the information being captured.
|style="width:5%"|
 
 
|
 
|
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|  
+
{{rightBox|Related Articles|
== Related Articles ==
+
:* [[Intelligent Capture Design Validation and Errors]]
:* [[Progressive Capture Workflow|Service Manager Progressive Capture]]
+
:* [[Progressive Capture Workflow|Service Manager Intelligent Capture]]
|}
+
:* [[Project_Manager_Progressive_Capture|Project Manager Intelligent Capture]]
 +
}}
 +
}}
  
 
== Nodes ==
 
== Nodes ==
When building a progressive capture script there are a few different nodes that are available to use when considering your design
+
When building a capture workflow there are a few different nodes that are available to use when considering your design
  
 
:* '''Start'''
 
:* '''Start'''
::Every progressive capture flow will have a ''Start'' node.  This is the entry point for all progressive capture scripts.
+
::Every capture workflow will have a ''Start'' node.  This is the entry point for all capture scripts.
 
:* '''Form'''  
 
:* '''Form'''  
 
::You can choose from a number of pre-configured small forms (in Form Properties) and place them in the sequence you need.
 
::You can choose from a number of pre-configured small forms (in Form Properties) and place them in the sequence you need.
Line 26: Line 29:
 
::Allows a custom expression to alter the flow to show different PCF's.
 
::Allows a custom expression to alter the flow to show different PCF's.
 
:* '''Switch'''
 
:* '''Switch'''
::Allows you to link progressive capture's together and seamlessly switch from one to another
+
::Allows you to link capture workflows together and seamlessly switch from one to another
 
:*'''End'''
 
:*'''End'''
::Every progressive capture flow will have at least one of these to end the flow.
+
::Every capture flow will have at least one of these to end the flow.
 +
:*'''Cancel'''
 +
::The Cancel node allows the capture workflow to exit without any further processing.  This behaves the same as if the user had selected the cancel button that is available when filling out a capture.  The user will be returned to where the Intelligent Capture was initiated from.
  
 
==Branches==
 
==Branches==
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1000px">
+
[[File:pcf_decision1.png |right|300px|decision node based on request summary]] 
In progressive capture, branches allow the workflow designer to send the analyst down different routes to potentially collect different information depending on the choices that are made on progressive capture forms. It is important to remember that a branch node will always inherit the outcomes from its parent progressive capture forms. This means that if you place a branch node after the request details form (as shown in the below screenshot), the only pieces of data that you can make a decision on are the Summary and Description fields (only 2 fields on this default form).
+
[[File:pcf_decision2.png |right|300px|decision node based on request summary]] 
<div class="mw-collapsible-content">
+
In Intelligent Capture, branches allow the workflow designer to send the user down different routes to potentially collect different information depending on the choices that are made on capture forms.  
[[File:pcf_decision1.png |800px|decision node based on request summary]]  [[File:pcf_decision2.png |500px|decision node based on request summary]]  
+
* It is important to remember that a branch node will always inherit the outcomes from its parent capture forms. This means that if you place a branch node after the request details form (as shown in the screenshot), the only pieces of data that you can make a decision on are the Summary and Description fields (only 2 fields on this default form).
 +
* When branching to a new capture it is important to ensure that all Custom Forms have unique names to prevent mapped fields from being overwritten.
 +
 +
 
 +
===Custom Expressions===
 +
[[File:Custom_Expression_Branching_PC.png |right|400px|multiple outcomes]]
  
To add a custom expression to a decision node you must first connect the decision node to the next node in the flow. You can then click the linking line and define your custom expression. You can define multiple outcomes from a decision node, however you must always have at least one valid outcome, otherwise the progressive capture flow could potentially have nowhere to go which will make it error.
+
To add a custom expression to a branch node you must first connect the decision node to the next node in the flow.  
 +
* You can then click the linking line and define your custom expression.  
 +
* You can define multiple outcomes from a branch node, however, you must always have at least one valid outcome, otherwise, the capture workflow could potentially have nowhere to go which will make it error.
 +
:* A branch node can have a maximum of '''three''' outcomes.  If you require more than three outcomes you can link one '''branch''' node to another '''branch''' node using a '''No Match''' link and you can then add an additional outcome option to the second or subsequent '''branch''' node.
 +
* You can use variable values from any form which has been used in the capture workflow prior to the branch question for example from the '''Customer Search''' form you may use the '''Customer Type''' variable to branch on
 +
* You can branch on a global variable such as where the capture is being used.  For example, if it is being used by an analyst in the user app you may want to branch to different forms compared to if the same capture was being used by a customer on either the customer or service portals '''(Global Variable -> Portal Type (Service Desk / Portals)'''
  
[[File:pcf_decision3.png |800px|multiple outcomes]]  [[File:pcf_decision4.png |800px|no match decision]]
+
<br>
</div>
+
<br>
</div>
 
  
==Switch Process==  
+
==Switch Capture==  
  
In Progressive Capture the Switch Process node provides the ability to seamlessly move to or link Progressive Capture flows together.  One example of where this maybe useful is in Service Manager when choosing a Request Catalog item from the '''Services''' Progressive Capture form, the switch process can be used to switch to the the Progressive Capture flow which is assigned to the chosen Request Catalog item.  
+
In Intelligent Capture, the Switch Capture node provides the ability to seamlessly move to or link capture workflows together.  One example of where this may be useful is in Service Manager when choosing a Request Catalog item from the '''Services''' capture form, the switch process can be used to switch to the capture flow which is assigned to the chosen request catalog item.  
  
Using this node replaces the previous behaviour of jumping from an initial progressive capture to another, and in essence any forms used in both are evaluated and re-used when jumping, it also removes the need to evaluate which forms in the second progressive capture to use, and any issues associated with progressive capture forms being skipped.  
+
Using this node replaces the previous behaviour of jumping from an initial capture workflow to another, and in essence, any forms used in both are evaluated and re-used when jumping, it also removes the need to evaluate which forms in the second capture workflow to use, and any issues associated with capture forms being skipped.  
  
Using this node, will in effect continue from the initial progressive capture, into the next progressive capture rather than replace it.  This means it does not need to evaluate which forms to skip, it simply ignores any forms already used in the initial progressive capture.  
+
Using this node, will in effect continue from the initial capture workflow, into the next capture workflow rather than replace it.  This means it does not need to evaluate which forms to skip, it simply ignores any forms already used in the initial capture.  
  
Advantages of using the Switch Process Node
+
Advantages of using the Switch Capture Node
  
 
* When switching processes the UI for the analyst is  smooth as you are linking one process to another not replacing one with another
 
* When switching processes the UI for the analyst is  smooth as you are linking one process to another not replacing one with another
* The ability to return / revisit the forms in the initial process capture flow, once you have switched or linked to a second process capture flow in order to change values / choices or even change which progressive capture to switch / link too.
+
* The ability to return / revisit the forms in the initial process capture flow, once you have switched or linked to a second process capture flow in order to change values / choices or even change which pcapture to switch / link too.
* You don't need to include the same forms in both Progressive Captures, for example the Customer Search form could just be used in the initial progressive capture, and removed from the catalog item progressive capture (obviously if it already exists it will simply be ignored).
+
* You don't need to include the same forms in both captures, for example, the Customer Search form could just be used in the initial capture, and removed from the catalog item capture (obviously if it already exists it will simply be ignored).
  
 
'''Example'''  [[File:SwitchProcessConfig.png|right|thumb]]
 
'''Example'''  [[File:SwitchProcessConfig.png|right|thumb]]
  
 
Following the use of the Services Details form, you may include a '''Branch''' node, and have two outcomes.
 
Following the use of the Services Details form, you may include a '''Branch''' node, and have two outcomes.
* 1.  Using a Custom Expression, perform a check to see if ''''Service details -> catalogProgressiveCaptureId''' '''Is Set''' (if a request catalog item has been selected)  from here link to the '''Switch Process''' node
+
* 1.  Using a Custom Expression, perform a check to see if ''''Service details -> catalogProgressiveCaptureId''' '''Is Set''' (if a request catalog item has been selected)  from here link to the '''Switch Capture''' node
 
* 2.  Using another Custom Expression perform the same check but set this to '''Is Not Set''' (a Service rather than a request catalog item has been selected) and build your logic accordingly, equally you could define multiple other outcomes from this branch node to reflect the different service choices and paths you wish to take.
 
* 2.  Using another Custom Expression perform the same check but set this to '''Is Not Set''' (a Service rather than a request catalog item has been selected) and build your logic accordingly, equally you could define multiple other outcomes from this branch node to reflect the different service choices and paths you wish to take.
  
On the Switch Process node, you can configure this to link to a specific new process, or use a '''Variable''' to link to the progressive capture linked to the request catalog item which has been chosen.  In this example this is what we will do and the Variable to use would be '''Service details -> catalogProgressiveCaptureId'''
+
On the Switch Capture node, you can configure this to link to a specific new process, or use a '''Variable''' to link to the capture linked to the request catalog item which has been chosen.  In this example, this is what we will do and the Variable to use would be '''Service details -> catalogProgressiveCaptureId'''
 +
 
 +
* '''Note:''' with the introduction of the Switch Capture option, the behaviour will alter slightly on the '''Services Details''' form, is as much as the user will now have to select the '''Next''' button if they are selecting either the Service or the Request Catalog Item in order to progress the capture workflow.  Previously if a Request Catalog Item was chosen the capture would immediately progress without the need to click '''Next'''.
 +
 
 +
== [[Customised Forms]] ==
 +
 
 +
As well as standard forms, Hornbill also provide the ability to create your own custom forms. With custom forms, you can create multiple questions of different field types for analysts and customers to answer during capture.
 +
: '''New''' - A Never Skip configuration option has been added, which can be set to '''True''', this will ensure that this form is never bypassed in your capture workflow, even if custom questions have default values set, and the questions are not set to mandatory.  This will ensure the user will always be presented with the form to at least validate the default choices, or change them if required.
 +
 
 +
::[[Customised Forms|Read more...]]
  
* '''Note:''' with the introduction of the Switch Process option, the behaviour will alter slightly on the '''Services Details''' form, is as much as the user will now have to select the '''Next''' button if they are selecting either the Service or the Request Catalog Item in order to progress the progressive capture.  Previously if a Request Catalog Item was chosen the progressive capture would immediately progress without the need to click '''Next'''.
+
== [[Mapping Fields from Customised Forms]] ==
  
 +
When creating customised forms, and custom questions the default behaviour is for the question and answer to be visible on the request form in a '''Questions''' collapsable section.  It is also possible to map the answer from a custom question to one of the default fields on a request.
 +
 +
::[https://docs.hornbill.com/servicemanager-config/customize/mapping-fields-from-customized-forms/ Read more...]
  
 
==Sharing and Visibility==
 
==Sharing and Visibility==
  
Progressive capture owners will be able to view their own captures, and captures which have been shared with them from the Progressive Capture  List.   
+
Intelligent capture owners will be able to view their own captures, and captures which have been shared with them from the capture workflow list.   
  
 
When creating or editing a capture it is possible via the '''Manage Process Settings''' and '''Grant Access To''' option to share your process with:
 
When creating or editing a capture it is possible via the '''Manage Process Settings''' and '''Grant Access To''' option to share your process with:
Line 77: Line 103:
 
* Groups - Configured via the Organisational group structure
 
* Groups - Configured via the Organisational group structure
  
It is possible to share captures with multiple users, roles and groups.  Once a capture has been shared, the user will be able to view the capture from the '''Progressive Capture''' list.  
+
It is possible to share captures with multiple users, roles and groups.  Once a capture has been shared, the user will be able to view the capture from the '''Intelligent Capture''' list.  
  
 
To remove visibility to a specific User, Role or Group simply select the '''Trash Can''' icon next to the item you wish to stop sharing the capture with.
 
To remove visibility to a specific User, Role or Group simply select the '''Trash Can''' icon next to the item you wish to stop sharing the capture with.
Line 84: Line 110:
 
* Home > System > Settings > Advanced
 
* Home > System > Settings > Advanced
  
==Default Form Configuration==
+
== Intelligent Capture Options ==
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1000px">
 
Default forms can be customised
 
<div class="mw-collapsible-content">
 
When selecting a default Hornbill PCF there are two ways in which you can customise it:
 
 
 
:# '''Mark as Mandatory''' - Setting this option to true means that a value or values will need to be provided by the analyst before they can advance to the next progressive capture form. The default setting for each form is false. Mandatory fields are indicated by the vertical red bar on the left edge of the field. If a field is required and you attempt to move to the next PCF without providing a value, you will be shown an error message.
 
 
 
[[File:pcf_mandatory_designer.png |400px|mandatory setting in the progressive capture designer]]  [[File:pcf_mandatory_userApp.png |800px|mandatory setting enforced in the user app]] 
 
 
 
::2. '''Define Additional Display Fields''' - Certain PCF's have the ability to display additional information such as the Organisation Details and Customer Search forms. A Hornbill administrator can select which additional data is displayed when an analyst selects a value from the selected progressive capture form.
 
 
 
[[File:pcf_additionalDisplay_designer.png |400px|In the progressive capture designer]]  [[File:pcf_additionalDisplay_userApp.png |800px|additional display fields shown in the user app]]
 
</div>
 
</div>
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1000px">
 
 
 
==Customised Forms ==
 
 
 
As well as standard forms, Hornbill also provide the ability to create your own custom forms. With custom forms, you can create multiple questions of different field types for analysts to answer during progressive capture.
 
: '''New''' - A Never Skip configuration option has been added, which can be set to '''True''', this will ensure that this form is never bypassed in your progressive capture flow, even if custom questions have default values set, and the questions are not set to mandatory.  This will ensure the user will always be presented with the form to at least validate the default choices, or change them if required.
 
<div class="mw-collapsible-content">
 
[[File:New_PC_Custom_Form.png|600px]]
 
 
 
=== Node Properties ===
 
 
 
* '''Custom Form Name''' - The display name for the node on the progressive capture designer
 
* '''Purpose''' - A text field to record the purpose of the custom form (optional)
 
 
 
=== Form Settings ===
 
 
 
* '''Language''' - A default language version of the custom form is provided, but you can opt to create different language versions of the custom form by selecting another available language and populating the labels, answers in different languages.
 
* '''Form Id''' - This is the unique identifier for the custom form, this can be used later to identify the answers to your questions when using the Hornbill [[Business Process Designer |Business Process Workflow]] engine.
 
*'''Form Prompt''' - This is any text you wish to appear with the custom form to help identify it's purpose
 
*'''Never Skip Form''' - This option can be set to True if you want to ensure the form is not bypassed in the progressive capture flow, when moving from one PC flow to another  (this is not required if using the Progressive Capture '''Switch Process''' node option)
 
 
 
=== Form Fields ====
 
 
 
The form fields are the questions you wish to ask on the custom from.
 
::* You can add new questions by selecting the '''add field'' button
 
::* You can edit an existing question by selecting the note and pencil icon of an existing question
 
::* You can delete an existing question by using the trash can icon of an existing question
 
::* You can re-order how the questions will appear by using the up and down arrows to move the questions into the required order.
 
 
 
[[File:pcf_customForm2_formProperties.png |right|300px|form properties including form id and form prompt]]
 
 
 
=== Field Properties ===
 
 
 
* '''Field Id''' - This is the unique id for the question on the custom form.  This can normally be left, unless you are wanting to map the answer from this question to a custom field on a request, where a field mapping needs to be given.  Read about [[  Progressive_Capture_Designer#Mapping_Fields_from_Customised_Forms| field mappings]]
 
* '''Label''' - This will be the label used to represent the question on the custom form
 
* '''Description''' - You can use this field to provide hints / tips or advice on how to complete the answer to this specific question
 
 
 
=== Field Flags ===
 
 
 
* '''Show this field in summary panel once form is completed''' - Tick this option if you want the question and answer to appear on the right hand side confirmation panel during the progressive capture flow
 
* '''This field requires a value to be provided''' - Tick this option is you want to make the answering of this question Mandatory
 
* '''This field will be visible on the form''' - Tick this option if you want the field to be visible on the form - sometimes this is not needed, if you are passing a fixed value into a field and  you can hide this from the user
 
* '''This field will be read only''' - Tick this option if you wish to use the field to be for '''information only'''
 
* '''This field will be visible in read mode if it has no value'''
 
 
 
=== Field Type Settings ===
 
 
 
* '''Field Type''' - This specifies the type for the field you are adding
 
::* '''Single line text field''' - Use this option if you want to present the user with a single line input box
 
::* '''Multi line text field''' - Use this option if you want to present the user with a multi-line input box
 
::* '''Static checkbox group''' - Use this option if you want the user to select one or multiple values from a definable checkbox list
 
::* '''Dynamic checkbox group''' - Use this option if you want the user to select one or multiple values from a pre-defined checkbox list (choosing which simple list to use as a data provider)
 
::* '''Static drop down select box''' - Use this option if you want the user to select one option from a definable select box list
 
::* '''Dynamic drop down select box''' - Use this option if you want the user to select one option from a pre-defined select box list (choosing which simple list to use as a data provider)
 
::* '''Static radioset''' - Use this option if you want the user to select one option from a definable radio button set
 
::* '''Dynamic radioset''' - Use this option if you want the user to select one option from a pre-defined radio button set (choosing which simple list to use as a data provider)
 
::* '''Date Control''' - Use this option if you only require the user to  provide a date
 
::* '''Date & Time Control''' - Use this option if you require the user to provide both a date and time
 
::* '''Orion user group picker''' - Use this option if you want the user to select a group or groups from the pre-defined organisational groupings
 
::* '''Label''' - Use this option if you want to add a separator into the questions being asked, or on the answers section of the request
 
 
 
* Different field types will have different configuration options including:
 
 
 
* Ability to set default values
 
* Ability to define values for static checkbox, static select box, static radio set options (display name and value)
 
 
 
 
 
[[File:pcf_customForm3_formProperties.png |400px|form properties - static drop down selection box]]  [[File:pcf_customForm4_formProperties.png |400px|form properties - date time picker]]  [[File:pcf_customForm5_formProperties.png |400px|form properties - multi line text input]]  [[File:pcf_customForm4_userApp.png |500px|form summary in user app]]
 
 
 
Analyst view when logging a request:
 
 
 
[[File:pcf_customForm2_userApp.png |800px|Custom PCF in user app]]    [[File:pcf_customForm3_userApp.png |800px|Custom PCF in user app]]
 
</div>
 
</div>
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1000px">
 
 
 
==Mapping Fields from Customised Forms==
 
 
 
When creating customised forms, and custom questions the default behaviour is for the question and answer to be visible on the request form in a '''Questions''' collapsable section.  It is also possible to map the answer from a custom question to one of the default fields on a request.
 
 
 
<div class="mw-collapsible-content">
 
 
 
When creating a custom question on a customised form, each question will require a Field ID to be specified, it is here that the mapping can be performed. When defining the Field ID, if you use any of the following values, the answer to this question will be mapped to the field you have specified.
 
 
 
[[File:Mapping_Custom_Fields.png|600px]]
 
 
 
===Available Fields to Map to===
 
 
 
* '''Summary''' - To map to this field the Field ID needs to be set as '''h_summary'''
 
* '''Description''' - To map to this field the Field ID needs to be set as '''h_description'''
 
* '''Custom Fields a - p''' - To map to any of the custom fields the Field ID need to be set using the following format '''h_custom_a''' or appropriate for the custom field you would like to map too.
 
 
 
When custom questions have been mapped to a default request field, the question and answer are still available in the '''Questions''' section on a request as well as the default fields mapped too.
 
* This will allow for the original answer to be retained
 
* The default fields values can be changed once logged
 
 
 
===Considerations===
 
 
 
* If the Default '''Request Details''' form is used in your progressive capture flow, and you try to map to h_summary or h_description, the values will not overwrite or be written to the summary or description fields, but the custom questions and answers will still be written to the '''Questions''' section on the request.
 
* If the same mapping is used on different custom forms in your progressive capture flow, the first mapping will be written to the specified default field on the request, and any subsequent mapping to the same field will not overwrite this value, but will be written to the '''Questions''' section on the request.
 
 
 
===Using Custom Questions and Answers in Email Templates & Measures===
 
 
 
If you have a requirement to include the answers to custom questions in email templates within your business process, it is now possible to utilise the above mapping to write the answers to the custom questions into default fields which are immediately available to use as variables when creating your email templates.
 
 
 
By using the above mapping to any of the requests custom fields, when creating your email template, simply look for the '''Extended Information''' options available from the variables drop down pick list. They will look like this: '''<nowiki>{{Extended Information.H_custom_x}}</nowiki>'''.  The Extended Information options are listed as 1 through to 20 and these equate to the custom fields a through to p which you will have mapped to.  By selecting the required variable in your email template, this will pass through the answer from your custom question which has been mapped to the corresponding custom field.
 
  
* '''Update -  From Service Manager 2.41''' mapped answers are also written to the custom columns in the primary h_itsm_requests table (custom a-p), this will allow the custom fields to be used when defining email template variables using the available custom fields, and also as criteria when creating measures in the Advanced Analytics.  This update only applies to data in mapped fields for requests logged after the release of Service Manager 2.41.  The mapped answers are still also mapped to the above Extended Information table.
+
Each capture workflow has a number of configuration options
  
</div>
+
:* '''Download'''
</div>
+
:: Download the definition file - downloads to a .txt file, a copy of the current capture workflow
[[Category:Administration]]
+
:* '''Upload'''
 +
:: Upload a pcf.txt file to the capture workflow - this will replace the current capture workflow content
 +
:* '''Print'''
 +
:: Print out a document that provides a graphical representation of the capture workflow
 +
:* '''Save''' (Validate, Activate, De-activate)
 +
:: After the creation or editing of a capture workflow, your workflow needs to be saved and then activated to make it available for use.  Any capture workflow that you wish to keep but do not have available for use can be deactivated.
 +
-->
 +
 
 +
[[Category:HDOC]]

Latest revision as of 19:57, 11 April 2024

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

Intelligent Capture Designer