Difference between revisions of "Service Manager Business Process Workflow"

From Hornbill
Jump to navigation Jump to search
 
(429 intermediate revisions by 9 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/workflows/using-workflows-with-service-manager Hornbill Document Library].
__NOTOC__[[Main Page|Home]] > [[Administration]] > [[Service Manager Administration |Service Manager]] > Business Process Workflow
+
 
</div>
+
[[file:hornbill-document-library.png|Service Manager Workflow|link=https://docs.hornbill.com/servicemanager-config/customize/workflows/using-workflows-with-service-manager]]
{|style="width: 100%"
+
<!--
|- valign="top"
+
 
|style="width:73%"|
 
== Introduction ==
 
The Service Manager Business Process Workflow is used to automate the processing of the requests that have been raised.  This page contains information on the Service Manager specific automated tasks that can be used in the [[Business Process Designer]] to build unique and powerful processes for your requests.
 
|style="width:5%"|
 
|
 
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
 
  
== Related Articles ==
+
{{bluebanner|[[Main Page|Home]] > [[Administration]] > [[Service Manager Administration |Service Manager]] > Business Process Workflow|[[:Category:Administration|Index]]}}
 +
{{IntroAndLinks|
 +
The Service Manager Business Process Workflow is used to automate the processing of the requests that have been raised.  This page contains information on the Service Manager automated tasks that can be used in the [[Business Process Designer]] to build unique and powerful processes for your requests.|
 
:* [[Business Process Designer]]
 
:* [[Business Process Designer]]
 
:* [[Request Variables]]
 
:* [[Request Variables]]
|}
+
:* [[Core Hornbill Automations]]
 +
}}
 +
 
  
 
==Boards==
 
==Boards==
Use the Boards nodes to automatically add, move or remove a Request from an existing Board. Requests can be added to one or multiple Boards in Service Manager, and can be moved between Lists on specified Boards automatically.
+
'''Please Note:''' Service Manager Boards have now been deprecated and replaced with [[Board_Manager|'''Hornbill Board Manager''']]. The available Board Manager business process operations are outlined [[Board_Manager_Business_Process_Workflow|'''here''']]. Use the Boards nodes to automatically add, move or remove a Request from an existing Board. Requests can be added to one or multiple Boards in Service Manager, and can be moved between Lists on specified Boards automatically.
  
<!-- ******************************************************************************************* -->
+
{{BPMAutomation|AddCommentToBoard|Add Comment To Board|
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
[[File:bpmaddcommenttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmaddcommenttoboard.png]]|
<div id="AddCommentToBoard"></div>
+
Use this node to manually add a Comment card to a Service Manager Board at the required stage in a process.|
* Add Comment To Board
+
{{bullet1|Board|The name of the Service Manager Board on which the Comment card will be added}}
<div class="mw-collapsible-content">
+
{{bullet1|List|The name of the list from the above specified board to which the Comment card will be added}}
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
+
{{bullet1|Comment|The actual comment, as it will appear on the card on the Board}}
::{|
+
}}
|- valign="top"
+
 
|style="width:700px"|
+
{{BPMAutomation|addRequesttoBoard|Add Request to Board|
[[File:bpmaddcommenttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmaddcommenttoboard.png|Add Comment to a Board]]
+
[[File:bpmaddrequesttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/96/Bpmaddrequesttoboard.png]]|
==== Add Comment To Board ====
+
This operation will automatically add a request to a selected Service Manager Board or move a request from one list to another.  This particularly works well on a Board where users have been given View Access only and the BPM takes control of all the card movements.|
Use this node to manually add a Comment card to a Service Manager Board at the required stage in a process.
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
==== Options ====
+
{{bullet1|Board|The name of the Service Manager Board on which the Request card will be added}}
:* '''Board'''
+
{{bullet1|List|The name of the list from the above specified board to which the Request card will be added}}
:: The name of the Service Manager Board on which the Comment card will be added
+
}}
:* ''' List '''
+
 
:: The name of the list from the above specified board to which the Comment card will be added
+
{{BPMAutomation|removeRequestFromBoard|Remove Request from Board|
:* '''Comment'''
+
[[File:bpmremoverequestfromboard.png|thumb|link=https://wiki.hornbill.com/images/0/07/Bpmremoverequestfromboard.png]]|
:: The actual comment, as it will appear on the card on the Board.
+
Use this option to remove a Request from a Service Manager Board at a specific stage in a process.|
|}
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
</div>
+
{{bullet1|Board|The name of the Service Manager Board from which the Request card will be removed}}
</div>
+
}}
</div>
 
<!-- **************************************END OF OPERATION DOCUMENTATION***************************************************** -->
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="addRequestToBoard"></div>
 
* Add Request to Board
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
::{|
 
|- valign="top"
 
|style="width:700px"|
 
[[File:bpmaddrequesttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/96/Bpmaddrequesttoboard.png |Add Request to Board]]
 
==== Add Request to Board ====
 
This operation will automatically add a request to a selected Service Manager Board or move a request from one list to another.  This particularly works well on a Board where users have been given View Access only and the BPM takes control of all the card movements.
 
==== Options ====
 
:* '''Request Id'''
 
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
 
:* '''Board'''
 
:: The name of the Service Manager Board on which the Request card will be added
 
:* '''List'''
 
:: The name of the list from the above specified board to which the Request card will be added
 
<br>
 
<br>
 
|}
 
</div>
 
</div>
 
</div>
 
<!-- **************************************END OF OPERATION DOCUMENTATION***************************************************** -->
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="AddUniqueIdForAnchor"></div>
 
* Remove Request from Board
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
::{|
 
|- valign="top"
 
|style="width:700px"|
 
[[File:bpmremoverequestfromboard.png|thumb|link=https://wiki.hornbill.com/images/0/07/Bpmremoverequestfromboard.png|Remove Request from Board]]
 
==== Remove Request from Board ====
 
Use this option to remove a Request from a Service Manager Board at a specific stage in a process. 
 
==== Options ====
 
:* '''Request Id'''
 
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
 
:* '''Board'''
 
:: The name of the Service Manager Board from which the Request card will be removed.
 
<br>
 
<br>
 
|}
 
</div>
 
</div>
 
</div>
 
<!-- ************************************************END OF OPERATION DOCUMENTATION************************************************** -->
 
  
 
==Change Requests==
 
==Change Requests==
 
Use these nodes at any stage in a process to automate Change Request specific actions.
 
Use these nodes at any stage in a process to automate Change Request specific actions.
 +
===Get Information===
  
<!-- ********************************START OF OPERATION DOCUMENTATION*************************************************** -->
+
{{BPMAutomation|getChangeInformation|GetInformation|
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
[[File:bpmgetchangeinfo.png|thumb|link=https://wiki.hornbill.com/images/3/34/Bpmgetchangeinfo.png]]|
<div id="addToChangeCalendar"></div>
+
Use this Hornbill Automation to get extended change information from a Change Request.|
* Add to Change Calendar
+
{{bullet1|Backout Plan|Get the Backout Plan for the change}}
<div class="mw-collapsible-content">
+
{{bullet1|Change Category|Get the category set against the change}}
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
+
{{bullet1|Change Justification|Get the Justification information from the change}}
::{|
+
{{bullet1|Change Type|Get the Change Type}}
|- valign="top"
+
{{bullet1|Communication Plan|Get the Communication Plan for the change}}
|style="width:700px"|
+
{{bullet1|Disruption Level|Get the Disruption Level for the change}}
[[File:bpmaddtochangecalendar.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmaddtochangecalendar.png|Add to Change Calendar]]
+
{{bullet1|End Time|Get the time when the change is set to be completed}}
==== Add to Change Calendar ====
+
{{bullet1|Implementation Plan|Get the Implementation Plan}}
Use this node to automatically add a change request to the Change Calendar. Use the configuration settings to set the start and end times for the change based on the time this node is invoked in the process.  As an example if this node is the first action in a process, then it will use the log time as the Now time, and the Start and End times you configure will be based off that time.
+
{{bullet1|Is Scheduled|Get information about if the change is scheduled or not}}
==== Options ====
+
{{bullet1|Proposed End Time|Get the proposed end time of the change}}
:* '''Request ID'''
+
{{bullet1|Proposed Start Time|Get the proposed start time of the change}}
::This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto
+
{{bullet1|Security Implication|Get any security implications that have been added to the change}}
:* '''Start Time From Now'''
+
{{bullet1|Start Time|Get the start time for the change}}
:: Set the ''Start Time'' for this change based on years, months, days, hours, or minutes from when this node is reached in the workflow
+
{{bullet1|Support Plan|Get the support plan for the change}}
:* '''End Time From Now'''
+
{{bullet1|Test Plan|Get the test plan for the change}}
:: Set the ''End Time'' for this change based on years, months, days, hours, or minutes from when this node is reached in the workflow
+
}}
:* '''Start Time (From Variable)
 
:: Set the ''Start Time'' for this change from a BPM Variable
 
:* '''End Time (From Variable)
 
:: Set the ''End Time'' for this change from a BPM Variable
 
:* '''Enforce Freeze Periods'''
 
:: Set this to ensure that the Start or End Dates are not set within a Change Freeze Period
 
:* '''Update Timeline'''
 
:: Include a Timeline update on the request when this node has completed
 
|}
 
</div>
 
</div>
 
</div>
 
<!-- **************************************END OF OPERATION DOCUMENTATION***************************************************** -->
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
=== Suspend ===
* Remove from Change Calendar
 
<div class="mw-collapsible-content">
 
::ChangeRequests > Update > Remove from Change Calendar
 
  
Use this node to automatically remove the Change from the Change Calendar.   
+
{{BPMAutomation|waitForChangeType|Wait For Change Type|
[[File:Remove_From_Calendar.png|600px]]
+
[[File:bpmwaitforchangetype.png|thumb|link=https://wiki.hornbill.com/images/0/09/Bpmwaitforchangetype.png]]|
</div>
+
Use this Hornbill Automation to suspend the Business Process until a Change Type has been set on the Change Request|
</div>
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus when using this suspend node.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.  When this date and time is reached, the BPM will automatically continueAn outcome of ''Expired'' will be provided to allow for a decision node to be placed after this operation to determine how the expired operation will be managed.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|waitForRequestSchedule|Wait For Request Schedule|
* Change Type
+
[[File:bpmwaitforrequestschedule.png|thumb|link=https://wiki.hornbill.com/images/b/b3/Bpmwaitforrequestschedule.png]]|
<div class="mw-collapsible-content">
+
Use this node to pause the process and await the scheduling of the Change Request in the Change Calendar|
::ChangeRequests > Update > Change Type
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus when using this suspend node.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.  When this date and time is reached, the BPM will automatically continue.  An outcome of ''Expired'' will be provided to allow for a decision node to be placed after this operation to determine how the expired operation will be managed.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
Use this node to update the Change Type 
+
=== Update Request ===
[[File:Change_Type.png|600px]]
 
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|addToChangeCalendar|Add to Change Calendar|
* Wait for Request Schedule
+
[[File:bpmaddtochangecalendar.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmaddtochangecalendar.png]]|
<div class="mw-collapsible-content">
+
Use this node to automatically add a change request to the Change Calendar. Use the configuration settings to set the start and end times for the change based on the time this node is invoked in the process.  As an example if this node is the first action in a process, then it will use the log time as the Now time, and the Start and End times you configure will be based off that time. |
::ChangeRequests > Suspend > Wait for Resquest Schedule
+
{{bullet1|Request ID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Start Time From Now|Set the ''Start Time'' for this change based on years, months, days, hours, or minutes from when this node is reached in the workflow}}
 +
{{bullet1|End Time From Now|Set the ''End Time'' for this change based on years, months, days, hours, or minutes from when this node is reached in the workflow}}
 +
{{bullet1|Start Time (From Variable)|Set the ''Start Time'' for this change from a BPM Variable}}
 +
{{bullet1|End Time (From Variable)|Set the ''End Time'' for this change from a BPM Variable}}
 +
{{bullet1|Enforce Freeze Periods|Set this to ensure that the Start or End Dates are not set within a Change Freeze Period}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
}}
  
Use this node to pause the process and await the scheduling of the Change Request in the Change Calendar
+
{{BPMAutomation|removeFromChangeCalendar|Remove from Change Calendar|
* Optional use the Action Focus option to focus the request on the '''Schedule''' action on the action bar, when awaiting this action.
+
[[File:bpmremovefromchangecalendar.png|thumb|link=https://wiki.hornbill.com/images/8/82/Bpmremovefromchangecalendar.png]]|
 +
Use this node to automatically remove the Change from the Change Calendar|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
}}
  
[[File:Suspend_await_schedule.png|600px]]
+
{{BPMAutomation|changeType|Change Type|
</div>
+
[[File:bpmchangetype.png|thumb|link=https://wiki.hornbill.com/images/1/1c/Bpmchangetype.png]]|
</div>
+
Use this automation to update the Change Type field on the Change Request|
 +
{{bullet1|Request ID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Change Type|Select from the pick list which type of Change will be set on this change}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
}}
  
==Releases==
+
== Known Errors ==
Use this node at any stage in a process to automate Release specific actions.
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
Use these nodes at any stage in a process to automate Known Error specific actions.
* Add to Change Calendar
+
=== Get Information===
<div class="mw-collapsible-content">
 
::Releases > Update > Add to Change Calendar
 
  
Use this node to automatically add the Release to the Change Calendar.
+
{{BPMAutomation|Known_Error_Details|Known Error Details|
* Use the configuration settings to set the start and end times for the release based on the time this node is invoked in the process. As an example if this node is the first action in a process, then it will use the log time as the Now time, and the Start and End times you configure will be based off that time.
+
[[File:bpmknownerrordetails.png|thumb|link=https://wiki.hornbill.com/images/c/ca/Bpmknownerrordetails.png]]|
 +
Use this node to get the Accepted Solution, Root Cause, and the Workaround from a known error record.|
 +
{{bullet1|RequestID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
}}
  
[[File:Release_Add.png|600px]]
+
=== Update Known Error ===
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Update_Known_Error_Details|Update Known Error Details|
* Remove from Change Calendar
+
[[File:bpmupdateknownerror.png|thumb|link=https://wiki.hornbill.com/images/6/6d/Bpmupdateknownerror.png]]|
<div class="mw-collapsible-content">
+
Use this node to update the workaround and root cause on a Known Error record.|
::Releases > Update Request > Remove from Change Calendar
+
{{bullet1|RequestID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Root Cause|Use this option to set the Root Cause of the known error record}}
 +
{{bullet1|Workaround|Use this optino to set the Workaround for the known error record}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update. Choosing anything other than Customer will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
Use this node to automatically remove the Release from the Change Calendar. 
 
[[File:Release_Remove.png|600px]]
 
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Release Type
 
<div class="mw-collapsible-content">
 
::Releases > Update Request > Release Type
 
  
Use this node to update the Release Type 
+
==Problem Records==
[[File:Release_type.png|600px]]
+
Use these nodes at any stage in a process to automate Problem Record specific actions.
</div>
+
=== Get Information ===
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Problem_Details|Problem Details|
* Wait for Request Schedule
+
[[File:bpmproblemdetails.png|thumb|link=https://wiki.hornbill.com/images/c/cc/Bpmproblemdetails.png]]|
<div class="mw-collapsible-content">
+
Use this node to get the Accepted Solution, Root Cause, and the Workaround from a problem record.|
::Releases> Suspend > Wait for Request Schedule
+
{{bullet1|RequestID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
}}
  
Use this node to pause the process and await the scheduling of the Release in the Change Calendar
+
=== Suspend ===
* Optional use the Action Focus option to focus the request on the '''Schedule''' action on the action bar, when awaiting this action.
 
  
[[File:Release_Schedule.png|600px]]
+
{{BPMAutomation|waitForProblemWorkaround|Wait for Workaround|
</div>
+
[[File:bpmwaitforproblemworkaround.png|thumb|link=https://wiki.hornbill.com/images/3/3b/Bpmwaitforproblemworkaround.png]]|
</div>
+
Use this node to suspend the BPM Workflow and wait for a workaround to be added to the Problem Record.|
 +
{{bullet1|RequestID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus while the process is suspended}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.  When this date and time is reached, the BPM will automatically continue.  An outcome of ''Expired'' will be provided to allow for a decision node to be placed after this operation to determine how the expired operation will be managed.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
==Request Connections==
+
=== Update Problem ===
  
Use the Request Connections node at any stage in a process to automatically add additional contact's and or co-worker's to a request and define their connection type to the request. Other options include automatically emailing connections of different types, and removing one or all connections at any stage.
+
{{BPMAutomation|Update_Problem_Details|Problem Details|
 +
[[File:bpmproblemdetails.png|thumb|link=]]|
 +
Use this node to update the workaround and root cause on a Problem Record.|
 +
{{bullet1|RequestID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Root Cause|Use this option to set the Root Cause of the problem record}}
 +
{{bullet1|Workaround|Use this optino to set the Workaround for the problem record}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update. Choosing anything other than Customer will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Add Connection
 
<div class="mw-collapsible-content">
 
::RequestConnections> Connections > Add Connection
 
  
Use this node to add a new connection to the request.
 
  
Configuration options include:
+
==Releases==
 +
Use this node at any stage in a process to automate Release specific actions.
 +
=== Suspend ===
  
:* '''Connection Type''' - By Default this will include interested and Impacted but will also show any custom Connection Types which have been defined in the Simple Lists, and '''requestConnectionType''' optionUse this option to define what relationship the Connection will have to the request.
+
{{BPMAutomation|waitForReleaseType|Wait for Release Type|
:* '''Co-worker''' - Choose which internal user will be added as a connection to the request
+
[[File:bpmwaitforreleasetype.png|thumb|link=https://wiki.hornbill.com/images/0/0b/Bpmwaitforreleasetype.png]]|
:* '''Contact''' - Choose which external user will be added to a connection to the request
+
Use this Hornbill Automation to suspend the Business Process until a Release Type has been set on the Release record|
:* '''Co-worker(From Variable)''' - Use the user id (h_user_id) from the h_sys_accounts table, or from the variable picker and picking the value returned from the user picker in a progressive capture custom form
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
:* '''Contact(From Variable)''' - Use the contact id (h_pk_id) from the h_sys_contacts table or or from the variable picker and picking the value returned from the user picker in a progressive capture custom form
+
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus when using this suspend node.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.  When this date and time is reached, the BPM will automatically continue. An outcome of ''Expired'' will be provided to allow for a decision node to be placed after this operation to determine how the expired operation will be managed.}}
 +
}}
  
It is possible to add a single Co-Worker and Contact to a request in a single node, but it is not mandatory to do so.  
+
{{BPMAutomation|waitforrelaseschedule|Wait for Request Schedule|
 +
[[File:bpmwaitforreleaseschedule.png|thumb|link=https://wiki.hornbill.com/images/a/a4/Bpmwaitforreleaseschedule.png]]|
 +
Use this node to pause the process and await the scheduling of the Release in the Change Calendar|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus when using this suspend node.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.  When this date and time is reached, the BPM will automatically continue.  An outcome of ''Expired'' will be provided to allow for a decision node to be placed after this operation to determine how the expired operation will be managed.}}
 +
}}
  
[[File:Screen Shot 2019-05-22 at 12.24.42.png|600px]]
+
=== Update Request ===
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|addreleasetocalendar|Add to Change Calendar|
* Email Connections
+
[[File:bpmaddreleasetocalendar.png|thumb|link=https://wiki.hornbill.com/images/1/1a/Bpmaddreleasetocalendar.png]]|
<div class="mw-collapsible-content">
+
Use this node to automatically add the Release to the Change Calendar|
::RequestConnections> Connections > Email Connections
+
{{bullet1|Request ID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Start Time From Now|Set the ''Start Time'' for this change based on years, months, days, hours, or minutes from when this node is reached in the workflow}}
 +
{{bullet1|End Time From Now|Set the ''End Time'' for this change based on years, months, days, hours, or minutes from when this node is reached in the workflow}}
 +
{{bullet1|Start Time (From Variable)|Set the ''Start Time'' for this change from a BPM Variable}}
 +
{{bullet1|End Time (From Variable)|Set the ''End Time'' for this change from a BPM Variable}}
 +
{{bullet1|Enforce Freeze Periods|Set this to ensure that the Start or End Dates are not set within a Change Freeze Period}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
}}
  
Use this node to email connections of the request.  
+
{{BPMAutomation|removeReleaseFromCalendar|Remove from Change Calendar|
 +
[[File:bpmremovereleasefromcalendar.png|thumb|link=https://wiki.hornbill.com/images/e/ec/Bpmremovereleasefromcalendar.png]]|
 +
Use this node to automatically remove the Release from the Change Calendar|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
}}
  
Configuration options include:
+
{{BPMAutomation|updateReleaseType|Release Type |
 +
[[File:bpmupdatereleasetype.png|thumb|link=https://wiki.hornbill.com/images/4/47/Bpmupdatereleasetype.png]]|
 +
Use this node to update the Release Type|
 +
{{bullet1|Request ID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Release Type|Select from the pick list which type of Release will be set on this release}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
}}
  
:* '''Mailbox Name''' - Specify the mailbox from which the email will be sent
 
:* '''Email Template''' - Specify the email template which will be sent
 
:* '''Recipients''' - Specify if the email should be sent to '''All''' users, '''Internal''' users only, or '''External''' users only of the following '''Connection Type'''
 
:* '''Connection Type''' - Specify which connection types should receive the email notification
 
  
[[File:Connections_Email.png|600px]]
 
  
</div>
+
==Request Connections==
</div>
+
Use the Request Connections node at any stage in a process to automatically add additional contact's and or co-worker's to a request and define their connection type to the request.  Other options include automatically emailing connections of different types, and removing one or all connections at any stage.
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|AddConnection|Add Connection|
* Remove All Connections
+
[[File:bpmaddconnection.png|thumb|link=https://wiki.hornbill.com/images/a/ae/Bpmaddconnection.png]]|
<div class="mw-collapsible-content">
+
Use this node to add a connection to a request|
::RequestConnections> Connections > Remove All Connections
+
{{bullet1|Request ID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Connection Type|By Default this will include interested and Impacted but will also show any custom Connection Types which have been defined in the Simple Lists, and '''requestConnectionType''' option.  Use this option to define what relationship the Connection will have to the request.}}
 +
{{bullet1|Co-worker|Choose which internal user will be added as a connection to the request}}
 +
{{bullet1|Contact|Choose which external user will be added to a connection to the request}}
 +
{{bullet1|Co-worker(From Variable)|Use the user id (h_user_id) from the h_sys_accounts table, or from the variable picker and picking the value returned from the user picker in a progressive capture custom form. Be sure to use the ''Raw'' value from the progressive capture outcome and not the ''Display Name''}}
 +
{{bullet1|Contact(From Variable)|Use the contact id (h_pk_id) from the h_sys_contacts table or or from the variable picker and picking the value returned from the user picker in a progressive capture custom form. Be sure to use the ''Raw'' value from the progressive capture outcome and not the ''Display Name''}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this node has completed}}
 +
}}
  
Use this node to remove connections from the request.
+
{{BPMAutomation|EmailConnections|Email Connections|
 +
[[File:bpmemailconnections.png|thumb|link=https://wiki.hornbill.com/images/3/3c/Bpmemailconnections.png]]|
 +
Use this node to email connections of the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Mailbox Name|Specify the mailbox from which the email will be sent}}
 +
{{bullet1|Email Template Entity|This option can be set with the Entity name (e.g. Requests, ChangeRequests) that the supplied Email Template belongs to. The Entity name can be found in ''Templates'' Tile within the Hornbill Admin Tool. If not supplied, this option will be set to "Requests"}}
 +
{{bullet1|Email Template|Specify the email template which will be sent}}
 +
{{bullet1|Recipients|Specify if the email should be sent to '''All''' users, '''Internal''' users only, or '''External''' users only of the following '''Connection Type'''}}
 +
{{bullet1|Connection Type|Specify which connection types should receive the email notification}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this node has completed}}
 +
}}
  
Configuration options include:
+
{{BPMAutomation|RemoveAllConnections|Remove All Connections|
 +
[[File:bpmremoveallconnections.png|thumb|link=https://wiki.hornbill.com/images/9/9d/Bpmremoveallconnections.png]]|
 +
Use this node to remove connections from the request|
 +
{{bullet1|Request Id|The request id of the request the connection(s) are being removed from. This should be set to Auto}}
 +
{{bullet1|Recipients|Controls which request connections are removed. Set to ''Auto'' to remove all connections or filter by Connection Type}}
 +
{{bullet1|Connection Type|Specify which connection types should be removed from the request}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this node has completed}}
 +
}}
  
:* '''Recipients''' - Specify if the connections to be removed should be '''All''' users, '''Internal''' users only, or '''External''' users only of the following '''Connection Type'''
+
{{BPMAutomation|RemoveConnection|Remove Connection|
:* '''Connection Type''' - Specify which connection types should be removed from the request
+
[[File:bpmremoveconnection.png|thumb|link=https://wiki.hornbill.com/images/5/55/Bpmremoveconnection.png]]|
 +
Use this node to remove specific connections from the request.|
 +
{{bullet1|Request Id|The Request Id of the request the connection(s) are being removed from. This should be set to Auto}}
 +
{{bullet1|CoWorker|Choose which internal user will be removed from the request }}
 +
{{bullet1|Contact|Choose which external user will be removed from the request}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this node has completed}}
 +
}}
  
[[File:Connections_Remove_All.png|600px]]
 
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Remove Connection
 
<div class="mw-collapsible-content">
 
::RequestConnections> Connections > Remove Connection
 
  
Use this node to remove specific connections from the request.
+
==Request Members==
 
 
Configuration options include:
 
 
 
:* '''Co-worker''' - Choose which internal user will be removed from the request
 
:* '''Contact''' - Choose which external user will be removed from the request
 
 
 
It is possible to remove a single Co-Worker and Contact from a request in a single node, but it is not mandatory to do so.
 
 
 
[[File:Connections_Remove.png|600px]]
 
</div>
 
</div>
 
  
==Request Members==
+
Use the Request Members node at any stage in a process to automatically add or remove another analyst or subject matter expert into a Request. Members can be added even if they do not have the rights to view the request type, nor the requests which belong to the team against which the request belongs. The added Member's rights will be elevated just for the specific Request. Members can be notified about being added via Hornbill Notifications, and or email depending on the following Service Manager system setting: '''guest.app.requests.notification.notificationType.members'''
  
Use the Request Members node at any stage in a process to automatically add or remove another analyst or subject matter expert into a Request.
+
{{BPMAutomation|AddRequestMember|Add Request Member|
 +
[[File:bpmaddrequestmember.png|thumb|link=https://wiki.hornbill.com/images/2/2c/Bpmaddrequestmember.png]]|
 +
Use this node to add Service Manager analysts to the request. This option allows you to automatically add additional analysts to the request to assist with the resolution or as interested parties.|
 +
{{bullet1|Request Id|The Request Id of the request the connection(s) are being removed from. This should be set to Auto}}
 +
{{bullet1|Member|This option can contain the Co-worker to be added as a Request member. If supplied, "Member (From Variable)" option will be ignored.}}
 +
{{bullet1|Member (From Variable)|This option can contain the Co-worker to be added as a Request member. If supplied, "Member (From Variable)" option will be ignored}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|RemoveRequestMember|Remove Request Member|
* Add Request Member
+
[[File:bpmaremoverequestmember.png|thumb|link=https://wiki.hornbill.com/images/3/3c/Bpmaremoverequestmember.png]]|
<div class="mw-collapsible-content">
+
Use this option to remove members from a request.| 
::Members > Add Request Member
+
{{bullet1|Request Id|The Request Id of the request the connection(s) are being removed from. This should be set to Auto}}
 +
{{bullet1|Member|This option can contain the Co-worker to be removed from the Request members. If supplied, "Member (From Variable)" option will be ignored}}
 +
{{bullet1|Member (From Variable)|This option can contain the Id of a Co-worker (h_user_id in h_sys_accounts table). This option should only be supplied if "Member" option is not set}}
 +
}}
  
Use this node to add Service Manager analysts to the request.  This option allows you to automatically add additional analysts to the request to assist with the resolution or as interested parties.
 
  
:* Members can be added even if they do not have the rights to view the request type, nor the requests which belong to the team against which the request belongs.  The added Member's rights will be elevated just for the specific request.
 
:* Members can be notified about being added via Hornbill Notifications, and or email depending on the following Service Manager system setting: '''guest.app.requests.notification.notificationType.members'''
 
  
Specify which Analyst to add
+
== Request Notices ==
  
[[File:at_requestMembers_members_addRequestMember.png|600px]]
+
Use this Hornbill Automation to add or remove a notice which is displayed at the top of the request.
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Add_Notice|Add Notice|
* Remove Request Member
+
[[File:bpmaddrequestnotice.png|thumb|link=https://wiki.hornbill.com/images/6/6f/Bpmaddrequestnotice.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to add a notice to the top of the request|
::Members > Remove Request Member
+
{{bullet1|Request ID|The Request Id of the request the connection(s) are being removed from. This should be set to Auto}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Timeline Visibility|Choose what level of visibility will be automatically applied to this update. Choosing anything other than Customer will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
  
Use this option to remove members from a request.   
+
{{BPMAutomation|Remove_Notice|Remove Notice|
 +
[[File:bpmremoverequestnotice.png|thumb|link=https://wiki.hornbill.com/images/6/6d/Bpmremoverequestnotice.png]]|
 +
Use this Hornbill Automation to remove one or all notices on a request|
 +
{{bullet1|Request ID|The Request Id of the request the connection(s) are being removed from. This should be set to Auto}}
 +
{{bullet1|Notice ID|The ID of the notice that needs removing. This can be taken as a variable from the output of the Hornbill Automation that created the notice}}
 +
{{bullet1|Notice Type|This will remove notices of the selected type.  Information or Alert}}
 +
{{bullet1|Notice Text Contains|Remove any notice that contains this text}}
 +
{{bullet1|Notice Source|Remove notices based on the source.  Either BPM Workflow or Manually added notices.}}
 +
{{bullet1|Notice Visibility|Remove notices that are set to a particular VisibilityPortals, Service Desk, or Both}}
 +
}}
  
:* Select which member to remove
 
  
[[File:at_requestMembers_members_removeRequestMember.png|600px]]
 
</div>
 
</div>
 
  
 
==Requests==
 
==Requests==
 +
  
 
==== Access Control ====
 
==== Access Control ====
Line 326: Line 342:
 
Use the Access Control to lock or unlock the Details section or the Actions on a request.  Only users with the appropriate application right (update locked requests) will be able to modify the details or use an Action once locked. This right has been added to the following roles: Incident Management Full Access, Change Management Full Access, Problem Management Full Access, Release Management Full Access, Service Request Full Access, and Service Desk Admin.
 
Use the Access Control to lock or unlock the Details section or the Actions on a request.  Only users with the appropriate application right (update locked requests) will be able to modify the details or use an Action once locked. This right has been added to the following roles: Incident Management Full Access, Change Management Full Access, Problem Management Full Access, Release Management Full Access, Service Request Full Access, and Service Desk Admin.
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|LockRequestActions|Lock / Unlock Request Actions|
* Lock / Unlock Request Actions
+
[[File:bpmlockrequestactions.png|thumb|link=https://wiki.hornbill.com/images/3/3a/Bpmlockrequestactions.png]]|
<div class="mw-collapsible-content">
+
Locks or Unlocks the selected Actions on on a request.  This includes sections that are associated to the actions|
::Requests > Access Control > Lock / Unlock Actions
+
{{bullet1|Lock Update|Prevents the manual adding of an update to the Timeline}}
 +
{{bullet1|Lock Callback|Prevents the use of the Phone action}}
 +
{{bullet1|Lock Attach|Prevents the use of the Attach Action and the Attachments section of the request}}
 +
{{bullet1|Lock Link|Prevents the linking of requests to this request and stops the removal of linked requests in the requests section}}
 +
{{bullet1|Lock Linked Services|Prevents the linking of Services to this request and stops the removal of linked Services in the requests section}}
 +
{{bullet1|Lock Email|Prevents the sending of email}}
 +
{{bullet1|Lock Change Customer|Prevents the changing of the customer}}
 +
{{bullet1|Lock Assign|Prevents the request from being manually assigned or re-assigned}}
 +
{{bullet1|Lock Connections|Prevents further Connections from being added the removal of existing connections in the Connections section}}
 +
{{bullet1|Lock Escalate|Prevents the manual changing of the Priority}}
 +
{{bullet1|Lock Asset|Prevents the adding or removing of an asset}}
 +
{{bullet1|Lock Workaround|Prevents the accepting of a workaround being added on a Known Error}}
 +
{{bullet1|Lock Publish|Prevents the publishing of a Problem or Known Error record to the Self Service Portal}}
 +
{{bullet1|Lock Board|Prevents the request from being added to a board}}
 +
{{bullet1|Lock Schedule|Prevents the scheduling of a Change Request}}
 +
{{bullet1|Lock Solution|Prevents the ability to accept a solution provided to an Incident from a Problem or Known Error}}
 +
{{bullet1|Lock Resolve|Prevents a request from manually being resolved}}
 +
{{bullet1|Lock Cancel|Prevents a request from being cancelled}}
 +
{{bullet1|System Timeline Update|Use the provide System Timeline Update to show that a lock or unlock has taken place}}
 +
{{bullet1|Manual Timeline Update|Provide a custom Timeline Update message when a lock or unlock has taken place}}
 +
}}
 +
 
 +
{{BPMAutomation|LockRequestDetails|Lock Request Details|
 +
[[File:bpmlockrequestdetails.png|thumb|link=https://wiki.hornbill.com/images/5/59/Bpmlockrequestdetails.png]]|
 +
Locks the Details section of a request from this point on in the workflow.  Only users that have the '''update locked requests''' application right assigned to one of their roles will be able to update the request details.|
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
  
Locks or Unlocks the selected Actions on on a request.  This includes sections that are associated to the actions
+
{{BPMAutomation|UnlockRequestDetails|Unlock Request Details|
 +
[[File:bpmunlockrequestdetails.png|thumb|link=https://wiki.hornbill.com/images/7/7d/Bpmunlockrequestdetails.png]]|
 +
Unlocks the Details section of a request from this point on in the workflowAll users that have access to the request will be able to edit the Details section of the request.|
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
  
:* '''Lock Update'''
 
:: Prevents the manual adding of an update to the Timeline.
 
:* '''Lock Callback'''
 
:: Prevents the use of the Phone action
 
:* '''Lock Attach'''
 
:: Prevents the use of the Attach Action and the Attachments section of the request
 
:* '''Lock Link'''
 
:: Prevents the linking of requests to this request and stops the removal of linked requests in the requests section
 
:* '''Lock Linked Services'''
 
:: Prevents the linking of Services to this request and stops the removal of linked Services in the requests section 
 
:* '''Lock Email'''
 
:: Prevents the sending of email
 
:* '''Lock Change Customer'''
 
:: Prevents the changing of the customer
 
:* '''Lock Assign'''
 
:: Prevents the request from being manually assigned or re-assigned
 
:* '''Lock Connections'''
 
:: Prevents further Connections from being added the removal of existing connections in the Connections section
 
:* '''Lock Escalate'''
 
:: Prevents the manual changing of the Priority
 
:* '''Lock Asset'''
 
:: Prevents the adding or removing of an asset
 
:* '''Lock Workaround'''
 
:: Prevents the accepting of a workaround being added on a Known Error
 
:* '''Lock Publish'''
 
:: Prevents the publishing of a Problem or Known Error record to the Self Service Portal
 
:* '''Lock Board'''
 
:: Prevents the request from being added to a board
 
:* '''Lock Schedule'''
 
:: Prevents the scheduling of a Change Request
 
:* '''Lock Solution'''
 
:: Prevents the ability to accept a solution provided to an Incident from a Problem or Known Error
 
:* '''Lock Resolve'''
 
:: Prevents a request from manually being resolved
 
:* '''Lock Cancel'''
 
:: Prevents a request from being cancelled
 
:* '''System Timeline Update'''
 
:: Use the provide System Timeline Update to show that a lock or unlock has taken place
 
:* '''Manual Timeline Update'''
 
:: Provide a custom Timeline Update message when a lock or unlock has taken place
 
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
==== Assessment ====
* Lock Request Details
+
Use the Assessment node to initiate an Impact Assessment on a request
<div class="mw-collapsible-content">
 
::Requests > Access Control > Lock Request Details
 
  
Locks the Details section of a request from this point on in the workflowOnly users that have the '''update locked requests''' application right assigned to one of their roles will be able to update the request details. 
+
{{BPMAutomation|ImpactAssessment|Impact Assessment|
 +
[[File:bpmimpactassessment.png|thumb|link=https://wiki.hornbill.com/images/e/e1/Bpmimpactassessment.png]]|
 +
This Hornbill Automation will present an Impact Assessment option on the ''Escalate Action'' of a request.  When selected a user will be taken through a number of defined questions, and determined by their responses, an impact level will be automatically applied to the request.|
 +
{{bullet1|Assessment|The name of the assessment that you wish to run on the request}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this updateChoosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
  
[[File:accesscontrollock.png|600px]]
+
====Assets====
 +
Use these Hornbill Automations for managing assets that are associated to the request
  
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
{{BPMAutomation|Add_All_Owned_by_Customer|Add All Owned by Customer|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
[[File:Add_All_Owned_by_Customer.png|thumb|link=https://wiki.hornbill.com/images/1/16/Add_All_Owned_by_Customer.png]]|
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update. Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.  
+
Add all assets that are owned by the customer to the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|System Timeline Update|Indicates whether or not a system update is made to the request timeline. Default is No. This option is superseded by the Manual Timeline Update.}}
 +
{{bullet1|Manual Timeline Update|Freetext update to the request timeline. This supersedes the option System Timeline Update.}}
 +
{{bullet1|Timeline Visibility|The request timeline post visibility. If not specified, the application option value will be used.}}
 +
}}
  
</div>
+
{{BPMAutomation|Add_Generic_Assets_Owned_by_Customer|Add Generic Assets Owned by Customer|
</div>
+
[[File:Add_Generic_Assets_Owned_by_Customer.png|thumb|link=https://wiki.hornbill.com/images/5/53/Add_Generic_Assets_Owned_by_Customer.png]]|
 +
Add assets that are owned or used by the customer that belong to the General class of asset|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Asset Type|The type of Generic assets to associate to the request.}}
 +
{{bullet1|System Timeline Update|Indicates whether or not a system update is made to the request timeline. Default is No. This option is superseded by the Manual Timeline Update.}}
 +
{{bullet1|Manual Timeline Update|Freetext update to the request timeline. This supersedes the option System Timeline Update.}}
 +
{{bullet1|Timeline Visibility|The request timeline post visibility. If not specified, the application option value will be used.}}
 +
{{bullet1|Used By|Associate assets that are Used By the Request Customer, rather than Owned By.}} 
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Add_Computer_System_Assets_Owned_by_Customer|Add Computer System Assets Owned by Customer|
* Unlock Request Details
+
[[File:Add_Computer_System_Assets_Owned_by_Customer.png|thumb|link=https://wiki.hornbill.com/images/1/1b/Add_Computer_System_Assets_Owned_by_Customer.png]]|
<div class="mw-collapsible-content">
+
Add assets that are owned or used by the customer that belong to the Computer System class of asset|
::Requests > Access Control > Unlock Request Details
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Asset Type|The type of Computer System assets to associate to the request.}}
 +
{{bullet1|System Timeline Update|Indicates whether or not a system update is made to the request timeline. Default is No. This option is superseded by the Manual Timeline Update.}}
 +
{{bullet1|Manual Timeline Update|Freetext update to the request timeline. This supersedes the option System Timeline Update.}}
 +
{{bullet1|Timeline Visibility|The request timeline post visibility. If not specified, the application option value will be used.}}
 +
{{bullet1|Used By|Associate assets that are Used By the Request Customer, rather than Owned By.}}
 +
}}
  
Unlocks the Details section of a request from this point on in the workflow. All users that have access to the request will be able to edit the Details section of the request.
+
{{BPMAutomation|Add_Computer_Peripheral_Assets_Owned_by_Customer|Add Computer Peripheral Assets Owned by Customer|
 +
[[File:Add_Computer_Peripheral_Assets_Owned_by_Customer.png|thumb|link=https://wiki.hornbill.com/images/0/07/Add_Computer_Peripheral_Assets_Owned_by_Customer.png]]|
 +
Add assets that are owned or used by the customer that belong to the Computer Peripheral class of asset|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Asset Type|The type of Computer Peripheral assets to associate to the request.}}
 +
{{bullet1|System Timeline Update|Indicates whether or not a system update is made to the request timeline. Default is No. This option is superseded by the Manual Timeline Update.}}
 +
{{bullet1|Manual Timeline Update|Freetext update to the request timeline. This supersedes the option System Timeline Update.}}
 +
{{bullet1|Timeline Visibility|The request timeline post visibility. If not specified, the application option value will be used.}}
 +
{{bullet1|Used By|Associate assets that are Used By the Request Customer, rather than Owned By.}}
 +
}}
  
[[File:accesscontrolunlock.png|600px]]
+
{{BPMAutomation|Add_Mobile_Device_Assets_Owned_by_Customer|Add Mobile Device Assets Owned by Customer|
 +
[[File:Add_Mobile_Device_Assets_Owned_by_Customer.png|thumb|link=https://wiki.hornbill.com/images/2/2c/Add_Mobile_Device_Assets_Owned_by_Customer.png]]|
 +
Add assets that are owned or used by the customer that belong to the Mobile Device class of asset|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Asset Type|The type of Mobile Device assets to associate to the request.}}
 +
{{bullet1|System Timeline Update|Indicates whether or not a system update is made to the request timeline. Default is No. This option is superseded by the Manual Timeline Update.}}
 +
{{bullet1|Manual Timeline Update|Freetext update to the request timeline. This supersedes the option System Timeline Update.}}
 +
{{bullet1|Timeline Visibility|The request timeline post visibility. If not specified, the application option value will be used.}}
 +
{{bullet1|Used By|Associate assets that are Used By the Request Customer, rather than Owned By.}}
 +
}}
  
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
{{BPMAutomation|Add_Network_Device_Assets_Owned_by_Customer|Add Network Device Assets Owned by Customer|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
[[File:Add_Network_Device_Assets_Owned_by_Customer.png|thumb|link=https://wiki.hornbill.com/images/3/38/Add_Network_Device_Assets_Owned_by_Customer.png]]|
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update. Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.  
+
Add assets that are owned or used by the customer that belong to the Network Device class of asset|
</div>
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
</div>
+
{{bullet1|Asset Type|The type of Network Device assets to associate to the request.}}
 +
{{bullet1|System Timeline Update|Indicates whether or not a system update is made to the request timeline. Default is No. This option is superseded by the Manual Timeline Update.}}
 +
{{bullet1|Manual Timeline Update|Freetext update to the request timeline. This supersedes the option System Timeline Update.}}
 +
{{bullet1|Timeline Visibility|The request timeline post visibility. If not specified, the application option value will be used.}}
 +
{{bullet1|Used By|Associate assets that are Used By the Request Customer, rather than Owned By.}}
 +
}}
  
==== Assessment ====
+
{{BPMAutomation|Add_Printer_Assets_Owned_by_Customer|Add Printer Assets Owned by Customer|
Use the Assessment node to instigate an Impact Assessment on a request
+
[[File:Add_Printer_Assets_Owned_by_Customer.png|thumb|link=https://wiki.hornbill.com/images/8/8b/Add_Printer_Assets_Owned_by_Customer.png]]|
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
Add assets that are owned or used by the customer that belong to the Printer class of asset|
* Impact Assessment
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
<div class="mw-collapsible-content">
+
{{bullet1|Asset Type|The type of Printer assets to associate to the request.}}
:Using this option will present an Impact Assessment option on the ''Escalate Action'' of a request. When selected a user will be taken through a number of defined questions, and determined by their responses, an impact level will be automatically applied to the request.
+
{{bullet1|System Timeline Update|Indicates whether or not a system update is made to the request timeline. Default is No. This option is superseded by the Manual Timeline Update.}}
 +
{{bullet1|Manual Timeline Update|Freetext update to the request timeline. This supersedes the option System Timeline Update.}}
 +
{{bullet1|Timeline Visibility|The request timeline post visibility. If not specified, the application option value will be used.}}
 +
{{bullet1|Used By|Associate assets that are Used By the Request Customer, rather than Owned By.}}
 +
}}
  
:* '''Assessment'''
+
{{BPMAutomation|Add_Software_Assets_Owned_by_Customer|Add Software Assets Owned by Customer|
:: The name of the assessment that you wish to run on the request
+
[[File:Add_Software_Assets_Owned_by_Customer.png|thumb|link=https://wiki.hornbill.com/images/5/5a/Add_Software_Assets_Owned_by_Customer.png]]|
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
Add assets that are owned or used by the customer that belong to the Software class of asset|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update. Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.  
+
{{bullet1|Asset Type|The type of Software assets to associate to the request.}}
</div>
+
{{bullet1|System Timeline Update|Indicates whether or not a system update is made to the request timeline. Default is No. This option is superseded by the Manual Timeline Update.}}
</div>
+
{{bullet1|Manual Timeline Update|Freetext update to the request timeline. This supersedes the option System Timeline Update.}}
 +
{{bullet1|Timeline Visibility|The request timeline post visibility. If not specified, the application option value will be used.}}
 +
{{bullet1|Used By|Associate assets that are Used By the Request Customer, rather than Owned By.}}
 +
}}
  
====Assignment====
+
{{BPMAutomation|Add_Telecoms_Assets_Owned_by_Customer|Add Telecoms Assets Owned by Customer|
 +
[[File:Add_Telecoms_Assets_Owned_by_Customer.png|thumb|link=https://wiki.hornbill.com/images/a/a9/Add_Telecoms_Assets_Owned_by_Customer.png]]|
 +
Add assets that are owned or used by the customer that belong to the Telecoms class of asset|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Asset Type|The type of Telecoms assets to associate to the request.}}
 +
{{bullet1|System Timeline Update|Indicates whether or not a system update is made to the request timeline. Default is No. This option is superseded by the Manual Timeline Update.}}
 +
{{bullet1|Manual Timeline Update|Freetext update to the request timeline. This supersedes the option System Timeline Update.}}
 +
{{bullet1|Timeline Visibility|The request timeline post visibility. If not specified, the application option value will be used.}}
 +
{{bullet1|Used By|Associate assets that are Used By the Request Customer, rather than Owned By.}}
 +
}}
  
Use the Assignment node to automatically assign a request to different request stakeholders or teams.
+
{{BPMAutomation|Create_Generic_Asset|Create Generic Asset|
 +
[[File:Create_Generic_Asset.png|thumb|link=https://wiki.hornbill.com/images/7/70/Create_Generic_Asset.png]]|
 +
Creates a new General asset within Asset Management and links the new asset to the request from which it was created.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Create_Computer_System_Asset|Create Computer System Asset|
* Assign to Service Team
+
[[File:Create_Computer_System_Asset.png|thumb|link=https://wiki.hornbill.com/images/c/c9/Create_Computer_System_Asset.png]]|
<div class="mw-collapsible-content">
+
Creates a new Computer System asset within Asset Management and links the new asset to the request from which it was created.|
::Requests > Assignment > Assign to Service Team
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
Assign to Service Team assigns the request to the team that supports the service. If no team supports the service that the request is logged against then the request is not assigned. If more than one team supports the service, the request is assigned to the team that has supported the service the longest. This automated task does not assign the request to an individual within the team(s) supported by the service.
+
{{BPMAutomation|Create_Computer_Peripheral_Asset|Create Computer Peripheral Asset|
 +
[[File:Create_Computer_Peripheral_Asset.png|thumb|link=https://wiki.hornbill.com/images/c/c2/Create_Computer_Peripheral_Asset.png]]|
 +
Creates a new Computer Peripheral asset within Asset Management and links the new asset to the request from which it was created.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets. Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
[[File:Assign_Service_Team.png|600px]]
+
{{BPMAutomation|Create_Mobile_Device_Asset|Create Mobile Device Asset|
 +
[[File:Create_Mobile_Device_Asset.png|thumb|link=https://wiki.hornbill.com/images/3/33/Create_Mobile_Device_Asset.png]]|
 +
Creates a new Mobile Device asset within Asset Management and links the new asset to the request from which it was created.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
{{BPMAutomation|Create_Network_Device|Create Network Device Asset|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
[[File:Create_Network_Device_Asset.png|thumb|link=https://wiki.hornbill.com/images/4/4f/Create_Network_Device_Asset.png]]|
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update. Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
+
Creates a new Network Device asset within Asset Management and links the new asset to the request from which it was created.|
</div>
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
</div>
+
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Create_Printer_Asset|Create Printer Asset|
* Assign to Team
+
[[File:Create_Printer_Asset.png|thumb|link=https://wiki.hornbill.com/images/b/bf/Create_Printer_Asset.png]]|
<div class="mw-collapsible-content">
+
Creates a new Printer asset within Asset Management and links the new asset to the request from which it was created.|
::Requests > Assignment > Assign to Team
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
Use this option to assign the request to a specific team.   
+
{{BPMAutomation|Get_All_Assets|Get All Assets|
 +
[[File:Get_All_Assets.png|thumb|link=]]|
 +
Get a comma delimited list of the asset names that have been associated with the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPMThis should be set to ''Auto''}}
 +
{{bullet1|Include Type|When set to Yes, it will return the Type of each asset as well as the asset name}}
 +
}}
  
[[File:Assign_To_Team.png|600px]]
+
{{BPMAutomation|Get_All_Generic_Assets|Get All Generic Assets|
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
[[File:Get_All_Generic_Assets.png|thumb|link=]]|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
Get a comma delimited list of the asset names that belong to the Generic Class of asset that have been associated with the request|
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
</div>
+
{{bullet1|Assets Type|The type of Generic assets to to get a list of}}
</div>
+
{{bullet1|Include Type|When set to Yes, it will return the Type of each asset as well as the asset name}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Get_All_Computer_Peripheral_Assets|Get All Computer Peripheral Assets|
* Assign to Owner
+
[[File:Get_All_Computer_Peripheral_Assets.png|thumb|link=]]|
<div class="mw-collapsible-content">
+
Get a comma delimited list of the asset names that belong to the Computer Peripheral Class of asset that have been associated with the request|
::Requests > Assignment > Assign to Owner
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Assets Type|The type of Computer Peripheral assets to get a list of}}
 +
{{bullet1|Include Type|When set to Yes, it will return the Type of each asset as well as the asset name}}
 +
}}
  
Use this option to assign the request to a specific Service Manager analyst.
+
{{BPMAutomation|Get_All_Mobile_Device_Assets|Get All Mobile Device Assets|
 +
[[File:Get_All_Mobile_Device_Assets.png|thumb|link=]]|
 +
Get a comma delimited list of the asset names that belong to the Mobile Device Class of asset that have been associated with the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Assets Type|The type of Mobile Device assets to to get a list of}}
 +
{{bullet1|Include Type|When set to Yes, it will return the Type of each asset as well as the asset name}}
 +
}}
  
:* Define which team the request will be assigned to
+
{{BPMAutomation|Get_All_Network_Device_Assets|Get All Network Device Assets|
:* Define which analyst within the above team, the request will be assigned to
+
[[File:Get_All_Network_Device_Assets.png|thumb|link=]]|
 +
Get a comma delimited list of the asset names that belong to the Network Device Class of asset that have been associated with the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Assets Type|The type of Network Device assets to get a list of}}
 +
{{bullet1|Include Type|When set to Yes, it will return the Type of each asset as well as the asset name}}
 +
}}
  
[[File:Assign_To_Owner.png|600px]]
+
{{BPMAutomation|Get_All_Printer_Assets|Get All Printer Assets|
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
[[File:Get_All_Printer_Assets.png|thumb|link=]]|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
Get a comma delimited list of the asset names that belong to the Printer Class of asset that have been associated with the request|
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
</div>
+
{{bullet1|Assets Type|The type of Printer assets to get a list of}}
</div>
+
{{bullet1|Include Type|When set to Yes, it will return the Type of each asset as well as the asset name}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Get_All_Software_Assets|Get All Software Assets|
* Assign to Request Creator
+
[[File:Get_All_Software_Assets.png|thumb|link=]]|
<div class="mw-collapsible-content">
+
Get a comma delimited list of the asset names that belong to the Software Class of asset that have been associated with the request|
::Requests > Assignment > Assign to Request Creator
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Assets Type|The type of Software assets to get a list of}}
 +
{{bullet1|Include Type|When set to Yes, it will return the Type of each asset as well as the asset name}}
 +
}}
  
Use this option to automatically assign the request to the Service Manager analyst who created / raised the request via Progressive Capture
+
{{BPMAutomation|Get_All_Telecoms_Assets|Get All Telecoms Assets|
 +
[[File:Get_All_Telecoms_Assets.png|thumb|link=https://wiki.hornbill.com/images/0/04/Get_All_Telecoms_Assets.png]]|
 +
Get a comma delimited list of the asset names that belong to the Telecoms Class of asset that have been associated with the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Assets Type|The type of Telecoms assets to get a list of}}
 +
{{bullet1|Include Type|When set to Yes, it will return the Type of each asset as well as the asset name}}
 +
}}
  
[[File:Assign_Request_Creator.png|600px]]
+
{{BPMAutomation|Update_All_Assets_-_General_Information|Update All Assets - General Information|
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
[[File:Update_All_Assets_-_General_Information.png|thumb|link=https://wiki.hornbill.com/images/5/57/Update_All_Assets_-_General_Information.png]]|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
Update the General Information attributes of all assets that are associated to the request|
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update. Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
</div>
+
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
</div>
+
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Update_Computer_Assets_-_Additional_Properties|Update Computer Assets - Additional Properties|
* Assign to Most Available Analyst
+
[[File:Update_Computer_Assets_-_Additional_Properties.png|thumb|link=https://wiki.hornbill.com/images/a/a6/Update_Computer_Assets_-_Additional_Properties.png]]|
<div class="mw-collapsible-content">
+
Update the Additional Properties attributes of assets belonging to the Computer class that are associated to the request|
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
::{|
+
}}
|- valign="top"
 
|style="width:700px"|
 
[[File:Assign_Most_Available.png|thumb|link=https://wiki.hornbill.com/images/8/83/Assign_Most_Available.png|Assign to Most Available Analyst BPM Operation]]
 
Using ''Assign to Most Available Analyst'' is a great way to automatically assign out requests to the members of a team.  This operation works on the basis of capacity. The system will look through the members of the selected team and will assign the request to the member who has the least amount of open requests. If more than one team member have an equal number of open requests and have the least amount of assigned requests, the system will allocate the request to the team member who has had the greatest amount of time pass since their last assignment.
 
  
The system will take into account the user status which is found on their profile. If the user status is set to anything other than 'Available' that user/analyst/team member will not be considered as a request owner
+
{{BPMAutomation|Update_Computer_Assets_-_General_Information|Update Computer Assets - General Information|
 +
[[File:Update_Computer_Assets_-_General_Information.png|thumb|link=https://wiki.hornbill.com/images/a/a8/Update_Computer_Assets_-_General_Information.png]]|
 +
Update the General Information attributes of assets belonging to the Computer class that are associated to the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
:* '''Request Id'''
+
{{BPMAutomation|Update_Computer_Peripheral_Assets_-_Additional_Properties|Update Computer Peripheral Assets - Additional Properties|
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
+
[[File:Update_Computer_Peripheral_Assets_-_Additional_Properties.png|thumb|link=https://wiki.hornbill.com/images/c/cd/Update_Computer_Peripheral_Assets_-_Additional_Properties.png]]|
:* '''Team'''
+
Update the Additional Properties attributes of assets belonging to the Computer Peripheral class that are associated to the request|
:: Select the team that you would like to participate in the Round Robin Assignment.  This is a mandatory setting and must be set to Manual and have a team assigned.
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
:* '''Include Offline Users'''
+
}}
:: This takes into account if the user is logged into Hornbill and have an active session. The default behavior (Auto) is to include offline users.  Set this option to ''No'' if you don't want requests assigned to users that are not online.
 
:* '''System Timeline Update'''
 
::Select if the default system text will be added to the timeline for this action
 
:* '''Manual Timeline Update'''
 
:: Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 
:* '''Visibility'''
 
:: Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
 
|}
 
</div>
 
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Update_Computer_Peripheral_Assets_-_General_Information|Update Computer Peripheral Assets - General Information|
* Assign on Round Robin Basis
+
[[File:Update_Computer_Peripheral_Assets_-_General_Information.png|thumb|link=https://wiki.hornbill.com/images/9/93/Update_Computer_Peripheral_Assets_-_General_Information.png]]|
<div class="mw-collapsible-content">
+
Update the General Information attributes of assets belonging to the Computer Peripheral class that are associated to the request|
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
::{|
+
{{bullet1|Operational State|Update the operational state of the assets. Options include pre-production, operational, and retired}}
|- valign="top"
+
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
|style="width:700px"|
+
{{bullet1|Sub State|Update the sub state of the asset}}
[[File:bpmroundrobin.png|thumb|link=https://wiki.hornbill.com/images/4/41/Bpmroundrobin.png|Round Robin BPM Operation]]
+
{{bullet1|Company|Update the company that the assets should be associated to}}
Using the ''Assign Round Robin'' is a great way to automatically assign out requests to the members of a team . The system will look through the members of the selected team and will assign the request to the member who has had the greatest amount of time pass since their last assignment. The system will take into account the user's status which is found on their profile. If the user's status is set to anything other than 'Available' that user will not be considered for assignment. This does not take into account the volume of requests assigned to each user.
+
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was aquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the desposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
:* '''Request Id'''
+
{{BPMAutomation|Update_Mobile_Device_Assets_-_Additional_Properties|Update Mobile Device Assets - Additional Properties|
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
+
[[File:Update_Mobile_Device_Assets_-_Additional_Properties.png|thumb|link=https://wiki.hornbill.com/images/a/a4/Update_Mobile_Device_Assets_-_Additional_Properties.png]]|
:* '''Team'''
+
Update the Additional Properties attributes of assets belonging to the Mobile Device class that are associated to the request|
:: Select the team that you would like to participate in the Round Robin Assignment.  This is a mandatory setting and must be set to Manual and have a team assigned.
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
:* '''Include Offline Users'''
+
}}
:: This takes into account if the user is logged into Hornbill and have an active session. The default behavior (Auto) is to include offline users.  Set this option to ''No'' if you don't want requests assigned to users that are not online. In order for Round Robin to work effectively, users must become disciplined in logging off Hornbill via the User menu located to the top right. Simply closing the browser window does not end a users session.
 
:* '''System Timeline Update'''
 
:: Select if the default system text will be added to the timeline for this action
 
:* '''Manual Timeline Update'''
 
:: Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 
:* '''Visibility'''
 
:: Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
 
|}
 
</div>
 
</div>
 
</div>
 
  
====Authorisation Decision====
+
{{BPMAutomation|Update_Mobile_Device_Assets_-_General_Information|Update Mobile Device Assets - General Information|
 +
[[File:Update_Mobile_Device_Assets_-_General_Information.png|thumb|link=https://wiki.hornbill.com/images/1/18/Update_Mobile_Device_Assets_-_General_Information.png]]|
 +
Update the General Information attributes of assets belonging to the Mobile Device class that are associated to the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
Use the Authorisation Decision node to mark on a Change or Service Request form if an authorisation decision has been made.
+
{{BPMAutomation|Update_Network_Device_Assets_-_Additional_Properties|Update Network Device Assets - Additional Properties|
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
[[File:Update_Network_Device_Assets_-_Additional_Properties.png|thumb|link=https://wiki.hornbill.com/images/0/03/Update_Network_Device_Assets_-_Additional_Properties.png]]|
* Approved
+
Update the Additional Properties attributes of assets belonging to the Network Device class that are associated to the request|
<div class="mw-collapsible-content">
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
::Requests > Authorisation Decision > Approved
+
}}
  
[[File:Authoirsation_Approved.png|600px]]
+
{{BPMAutomation|Update_Network_Device_Assets_-_General_Information|Update Network Device Assets - General Information|
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
[[File:Update_Network_Device_Assets_-_General_Information.png|thumb|link=https://wiki.hornbill.com/images/1/19/Update_Network_Device_Assets_-_General_Information.png]]|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
Update the General Information attributes of assets belonging to the Network Device class that are associated to the request|
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update. Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
</div>
+
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
</div>
+
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Update_Printer_Assets_-_Additional_Properties|Update Printer Assets - Additional Properties|
* Rejected
+
[[File:Update_Printer_Assets_-_Additional_Properties.png|thumb|link=https://wiki.hornbill.com/images/a/a4/Update_Printer_Assets_-_Additional_Properties.png]]|
<div class="mw-collapsible-content">
+
Update the Additional Properties attributes of assets belonging to the Printer class that are associated to the request|
::Requests > Authorisation Decision > Rejected
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
[[File:Authorisation_Rejected.png|600px]]
+
}}
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
 
</div>
 
</div>
 
  
====Collaboration====
+
{{BPMAutomation|Update_Printer_Assets_-_General_Information|Update Printer Assets - General Information|
 +
[[File:Update_Printer_Assets_-_General_Information.png|thumb|link=https://wiki.hornbill.com/images/1/19/Update_Printer_Assets_-_General_Information.png]]|
 +
Update the General Information attributes of assets belonging to the Printer class that are associated to the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
Use the Collaboration node to post an automated update onto a public workspace at any stage in a process.  This will be visible to members of the specified workspace, on the timeline of the workspace and their Newsfeeds.   
+
{{BPMAutomation|Update_Software_Assets_-_Additional_Properties|Update Software Assets - Additional Properties|
 +
[[File:Update_Software_Assets_-_Additional_Properties.png|thumb|link=https://wiki.hornbill.com/images/9/91/Update_Software_Assets_-_Additional_Properties.png]]|
 +
Update the Additional Properties attributes of assets belonging to the Software class that are associated to the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPMThis should be set to ''Auto''}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Update_Software_Assets_-_General_Information|Update Software Assets - General Information|
* Comment on Existing Public Workspace Post
+
[[File:Update_Software_Assets_-_General_Information.png|thumb|link=https://wiki.hornbill.com/images/e/e3/Update_Software_Assets_-_General_Information.png]]|
<div class="mw-collapsible-content">
+
Update the General Information attributes of assets belonging to the Software class that are associated to the request|
::Requests > Collaboration > Comment on Existing Public Workspace Post
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
Use this node should you wish to automate the adding of a comment to an existing Post in a workspace.
 
* Using this node will always look to add the comment to the '''Most''' recent '''Post''' from the '''Request''' in the workspace.
 
  
An example use case for this node, is to include the Comment Update after key milestones for a request > Logged, In progress, Resolved, Closed or Change Accepted, Scheduled, Implemented, Reviewed. This will allow members of the workspace to stay informed about request progress without the need to monitor lists or queues.  
+
{{BPMAutomation|Update_Telecoms_Assets_-_Additional_Properties|Update Telecoms Assets - Additional Properties|
* This node will only be applicable if the '''Post to Public Workspace''' Node has been used and a Post already exists from the request in a Workspace.
+
[[File:Update_Telecoms_Assets_-_Additional_Properties.png|thumb|link=https://wiki.hornbill.com/images/a/a4/Update_Telecoms_Assets_-_Additional_Properties.png]]|
 +
Update the Additional Properties attributes of assets belonging to the Telecoms class that are associated to the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to ''Auto''}}
 +
}}
  
:* Specify the name of the Workspace to post to
+
{{BPMAutomation|Update_Telecoms_Assets_-_General_Information|Update Telecoms Assets - General Information|
:* Define the content for the post
+
[[File:Update_Telecoms_Assets_-_General_Information.png|thumb|link=https://wiki.hornbill.com/images/e/e7/Update_Telecoms_Assets_-_General_Information.png]]|
:* Define if the timeline of the Request should be updated
+
Update the General Information attributes of assets belonging to the Telecoms class that are associated to the request|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Operational State|Update the operational state of the assets.  Options include pre-production, operational, and retired}}
 +
{{bullet1|State|Update the state of the assets.  Options include active, current, and archived}}
 +
{{bullet1|Sub State|Update the sub state of the asset}}
 +
{{bullet1|Company|Update the company that the assets should be associated to}}
 +
{{bullet1|Name|Update the name of the assets}}
 +
{{bullet1|Notes|Upldate the notes for the assets}}
 +
{{bullet1|Owned By|Update the owner of the assets}}
 +
{{bullet1|Used By|Update who uses the assets}}
 +
{{bullet1|Department|Update the department that the asset is associated to}}
 +
{{bullet1|Description|Update the asset description}}
 +
{{bullet1|Booking|Update if the asset is available for booking}}
 +
{{bullet1|Purpose|Update the purpose of the assets}}
 +
{{bullet1|Last Audited Date|Update the last audit date for the assets}}
 +
{{bullet1|Location Type|Update the type of location where the asset is}}
 +
{{bullet1|Location|Update the Location of the assets}}
 +
{{bullet1|Country|Update the country where the asset is located}}
 +
{{bullet1|Building|Update the building where the asset is located}}
 +
{{bullet1|Room|Update the room where the asset is}}
 +
{{bullet1|Rack|Update the rack where the asset is located}}
 +
{{bullet1|U Height|Update the U height location in the rack}}
 +
{{bullet1|U Position|Update the U position of the asset in the rack}}
 +
{{bullet1|Site|Update the site where the asset is located}}
 +
{{bullet1|Floor|Update the Floor where the asset is located}}
 +
{{bullet1|Geo Location|Update the Geo-location where the asset is located}}
 +
{{bullet1|Static|Update if the asset is a static or not}}
 +
{{bullet1|Cost|Update the cost of the asset}}
 +
{{bullet1|Asset Tag|Update the Asset Tag}}
 +
{{bullet1|Order Number|Update the Order number}}
 +
{{bullet1|Invoice Number|Update the Invoice number}}
 +
{{bullet1|Maintenance Cost|Update how much the annual maintenance cost of the asset is}}
 +
{{bullet1|Maintenance Reference|Update the Reference to the maintenance contract}}
 +
{{bullet1|Supplier ID|Update the ID of the asset supplier}}
 +
{{bullet1|Supplier Contract|Update the name of the Supplier Contract associated to the asset}}
 +
{{bullet1|Product ID|Update the Product ID}}
 +
{{bullet1|Order Date|Update the Order date}}
 +
{{bullet1|Received Date|Upldate the receive date}}
 +
{{bullet1|Cost Center|Update the cost center}}
 +
{{bullet1|Acq. Method|Update the method of how the asset was acquired}}
 +
{{bullet1|Warranty Start|Update the start of the warranty date}}
 +
{{bullet1|Warranty Expires|Update the warranty expiry date}}
 +
{{bullet1|Supported By|Update who supports this asset}}
 +
{{bullet1|Maintenance Notice Period|Update the notice period for Maintenance contract renewal}}
 +
{{bullet1|Maintenance Termination Period|Update the termination period for the asset}}
 +
{{bullet1|Annual Maintenance Review Date|Update the annual maintenance review date}}
 +
{{bullet1|Scheduled Retired Date|Update the date that the asset set to retire on}}
 +
{{bullet1|Actual Retired Date|Update the date that the asset was retired on}}
 +
{{bullet1|Disposal Reason|Update why the asset was disposed of}}
 +
{{bullet1|Disposal Price|Update how much it cost to dispose of the asset}}
 +
{{bullet1|Disposal Code|Update the disposal code}}
 +
{{bullet1|Beneficiary|Update who the beneficiary of the asset is}}
 +
{{bullet1|Depreciation Method|Update the depreciation method}}
 +
{{bullet1|Depreciation Start Date|Update when the asset cost starts deprecating }}
 +
{{bullet1|Depreciation Value|Update the current depreciation value}}
 +
{{bullet1|Residual Value|Update the residual value}}
 +
}}
  
[[File:Comment_on_a_public_post.png|600px]]
+
====Assignment====
</div>
+
Use the Assignment node to automatically assign a request to different Service Manager users or teams.
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|AssignToServiceTeam|Assign to Service Team|
* Comment on Request Source Post
+
[[File:bpmassigntoserviceteam.png|thumb|link=https://wiki.hornbill.com/images/6/6e/Bpmassigntoserviceteam.png]]|
<div class="mw-collapsible-content">
+
Assign to Service Team assigns the request to the team that supports the service. If no team supports the service that the request is logged against then the request is not assigned. If more than one team supports the service, the request is assigned to the team that has supported the service the longest. This automated task does not assign the request to an individual within the team(s) supported by the service.|
: Use this option when the source of the request is from a post in order to post a comment back to this source post.
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
::Requests > Collaboration > Comment on Request Source Post
+
{{bullet1|Use Request Service|Choose whether or not to use the service of the request. The default is No. If this parameter is set to Yes, it will override any other service specified as an input parameter}}
 +
{{bullet1|Service|The Service ID of the service which is supported by the team to be assigned to the request}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update. Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
  
:* Specify the content to be included in the comment
+
{{BPMAutomation|AssignToTeam|Assign to Team|
:* Specify if you would like the Request ID and Summary to be included in the comment
+
[[File:bpmassigntoteam.png|thumb|link=link=https://wiki.hornbill.com/images/8/8a/Bpmassigntoteam.png|Assign to Team]]|
:* Define if the timeline of the Request should be updated
+
Use this option to assign the request to a specified team.  |
 +
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
 +
{{bullet1|Team|Select a team from the list of available teams that have been defined under the Organizational Data in Administration}}
 +
{{bullet1|Team (From Variable)|Assign to a Team based on a variable that has been populated using Progressive Capture or through the Get Information nodes}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than ''Customer'' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
  
[[File:Comment_on_a_public_post.png|600px]]
+
{{BPMAutomation|AssignToOwner|Assign to Owner|
</div>
+
[[File:bpmassigntoowner.png|thumb|link=https://wiki.hornbill.com/images/e/e9/Bpmassigntoowner.png]]|
</div>
+
Use this option to assign the request to a specific Service Manager analyst.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.}}
 +
{{bullet1|Team|The Team ID to be applied to the request}}
 +
{{bullet1|Owner|The user ID to be applied to the request}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|AssignTOwnerVariable|Assign to Owner (Variable)|
* Post to Public Workspace
+
[[File:bpmassigntoownervariable.png|thumb|link=https://wiki.hornbill.com/images/e/e9/Bpmassigntoowner.png]]|
<div class="mw-collapsible-content">
+
Use this option to assign the request to a specific Service Manager analyst using a dynamic value provided by a runtime variable that has been populated using Progressive Capture or through the Get Information nodes|
::Requests > Collaboration > Post to Public Workspace
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
 +
{{bullet1|Team|Select a team from the list of available teams that have been defined under the Organizational Data in Administration. If no team specified and if the designated owner is a member of multiple teams, the team that gets assigned will be the first team in a list of owner teams ordered by team name.}}
 +
{{bullet1|Owner|Assign to an analyst based on a variable that has been populated using Progressive Capture or through the Get Information nodes}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than ''Customer'' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
Use this node should you wish to automate the '''Posting''' to a specific workspace, and to it's members at one or multiple points in your business process. This will allow you to post important information to Collaboration users pertaining to the request against which your business process is running.
+
{{BPMAutomation|AssignToRequestCreator|Assign to Request Creator|
 +
[[File:bpmassigntorequestcreator.png|thumb|link=https://wiki.hornbill.com/images/7/7c/Bpmassigntorequestcreator.png]]|
 +
Use this option to automatically assign the request to the Service Manager analyst who created / raised the request via Progressive Capture|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.}}
 +
{{bullet1|Team|The Team ID to be applied to the request}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
One example of it's use would be during a Change Request, to let interested parties / stakeholders (Workspace Members) know that the Change had been accepted, scheduled and would therefore be being deployed.  The member's of the workspace may not be Service Manager subscribed users, but their Collaboration subscription would enable them to be kept informed about Change, Problem,  or Major Incident notifications by receiving notifications about the automated '''Posting''' from this node to their workspaces.  
+
{{BPMAutomation|AssignToMostAvailableAnalyst|Assign to Most Available Analyst|
 +
[[File:bpmassigntomostavailable.png|thumb|link=https://wiki.hornbill.com/images/2/2c/Bpmassigntomostavailable.png]]|
 +
Using ''Assign to Most Available Analyst'' is a great way to automatically assign out requests to the members of a teamThis operation works on the basis of capacity. The system will look through the members of the selected team and will assign the request to the member who has the least amount of open requests. If more than one team member have an equal number of open requests and have the least amount of assigned requests, the system will allocate the request to the team member who has had the greatest amount of time pass since their last assignment.
  
:* Specify the name of the Workspace to post to
+
The system will take into account the user status which is found on their profile. If the user status is set to anything other than 'Available' that user/analyst/team member will not be considered as a request owner|
:* Define the content for the post
+
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.}}
:* Define if the request id will be included in the post
+
{{bullet1|Team|Select the team that you would like to participate in the Round Robin Assignment.  This is a mandatory setting and must be set to Manual and have a team assigned.}}
:* Define if the request Summary will be included in the post
+
{{bullet1|Include Offline Users|This takes into account if the user is logged into Hornbill and have an active session. The default behavior (Auto) is to include offline users.  Set this option to ''No'' if you don't want requests assigned to users that are not online. If all the team members are off-line, the request will be assigned to just the team. In order for this to work effectively when taking into account users logged in status, users will need to be disciplined in logging off Hornbill. Simply closing the browser window does not end a users session(s). We would also strongly recommend that you disable the allow multi-logon option on your instance, otherwise taking into consideration a users Logged On status will be unreliable.}}
:* Define if the post to the Workspace will be appended to the timeline of the request
+
{{bullet1|Exclude On-hold Requests|If set to "Yes", when determining a user's availability, any requests that are on-hold will not be included when calculating availability. The default value is "No"}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
  
[[File:at_requests_collaboration_postToPublicWorkspace.png|600px]]
+
{{BPMAutomation|RoundRobin|Assign on Round Robin Basis|
</div>
+
[[File:bpmroundrobin.png|thumb|link=https://wiki.hornbill.com/images/4/41/Bpmroundrobin.png|Round Robin BPM Operation]]|
</div>
+
Using the ''Assign Round Robin'' is a great way to automatically assign out requests to the members of a team . The system will look through the members of the selected team and will assign the request to the member who has had the greatest amount of time pass since their last assignment. The system will take into account the user's status which is found on their profile. If the user's status is set to anything other than 'Available' that user will not be considered for assignment. This does not take into account the volume of requests assigned to each user.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Team|Select the team that you would like to participate in the Round Robin Assignment.  This is a mandatory setting and must be set to Manual and have a team assigned}}
 +
{{bullet1|Include Offline Users|This takes into account if the user is logged into Hornbill and have an active session. The default behavior (Auto) is to include offline users.  Set this option to ''No'' if you don't want requests assigned to users that are not online. In order for Round Robin to work effectively when taking into account users login status, users must become disciplined in logging off Hornbill via the User menu located to the top right. Simply closing the browser window does not end a users session. We would also strongly recommend that you disable the allow multi-logon option on your instance, otherwise taking into consideration a users Logged On status will be unreliable.}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
  
===Deprecated===
+
==== Authorisation Decision ====
 +
Use the Authorisation Decision node to mark on a Change or Service Request form if an authorization decision has been made.
 +
{{BPMAutomation|Approved|Approved|
 +
[[File:bpmapproved.png|thumb|link=https://wiki.hornbill.com/images/5/56/Bpmapproved.png]]|
 +
Use this Authorisation Decision node to mark on a Change or Service Request as being approved. The status of ''Approved'' will be displayed in the Information panel on the request.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
 +
{{BPMAutomation|Rejected|Rejected|
 +
[[File:bpmrejected.png|thumb|link=https://wiki.hornbill.com/images/d/d5/Bpmrejected.png]]|
 +
Use this Authorization Decision node to mark on a Change or Service Request as being rejected. The status of ''Rejected'' will be displayed in the Information panel on the request.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
 +
{{BPMAutomation|Clear|Clear|
 +
[[File:bpmclearauthorization.png|thumb|link=https://wiki.hornbill.com/images/2/21/Bpmclearauthorization.png]]|
 +
Use this Authorization Decision node to clear a previous authorization decision that was added to the request. Once cleared, the authorization decision will no longer show in the Information Panel.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
This section contains nodes which have been superseded. These nodes will continue to operate on existing business processes, but new enhanced versions of these options have been introduced.
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
====Collaboration====
* Request Questions - Superseded by '''Requests > Get Information > Progressive Capture Answers'''
 
<div class="mw-collapsible-content">
 
::Requests > Get Request Information > Request Questions
 
  
Use this option before a '''Decision''' node, if you want to load into the process the '''Answers''' from a specific Progressive Capture Custom FormBy selecting this option, you can specify the custom form id and it's answers will be loaded and available to evaluate by the following '''Decision''' node.   
+
Use the Collaboration node to post an automated update onto a public workspace at any stage in a process.  This will be visible to members of the specified workspace, on the timeline of the workspace and their News Feeds.   
  
:* Specify the form_id from the Progressive Capture you wish to use.
+
{{BPMAutomation|CommentOnPost|Comment on Existing Public Workspace Post|
 +
[[File:bpmcommentonpost.png|thumb|link=https://wiki.hornbill.com/images/d/d3/Bpmcommentonpost.png]]|
 +
Use this node to automate the adding of a comment to an existing Post in a workspace. It will always look to add the comment to the most recent post from the request in the workspace. An example use case for this node, is to include the Comment Update after key milestones such as Logged, In progress, Resolved, Closed or Change Accepted, Scheduled, Implemented, Reviewed.  This will allow members of the workspace to stay informed about request progress without the need to monitor lists or queues. This node will only be applicable if the '''Post to Public Workspace''' Node has been used and a Post already exists from the request in a Workspace.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Workspace|The ID of the workspace where the comment will be posted}}
 +
{{bullet1|Content|The content of the comment to be added to the post}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
}}
 +
{{BPMAutomation|CommentOnRequestSourcePost|Comment on Request Source Post|
 +
[[File:bpmcommentonsourcepost.png|thumb|link=https://wiki.hornbill.com/images/8/88/Bpmcommentonsourcepost.png]]|
 +
Use this option when the source of the request is from a post in order to post a comment back to this source post.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Content|The content of the comment to be added to the post}}
 +
{{bullet1|Include Id|Include the Request Id in the comment which will include a link in the comment, back to the request}}
 +
{{bullet1|Include Summary|Include the Summary of the request in the comment as part of the link back to the request}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
}}
 +
{{BPMAutomation|PostToPublicWorkspace|Post to Public Workspace|
 +
[[File:bpmposttoworkspace.png|thumb|link=https://wiki.hornbill.com/images/3/38/Bpmposttoworkspace.png]]|
 +
Use this node to add a new post to a specific workspace. This will allow you to post important information to Collaboration users pertaining to the request.
  
An example of the use of this node could be if you have created a custom form which asked questions about a new start, and one of these questions was to determine which Department they would be joining, it is feasible in your business process that you may wish to check the answer value, and if it was '''Sales''' then branch in one direction, and if it was '''Accounts''' you may want to branch in another direction.  Using the Get Request Information > Request Questions and defining the specific form will allow these answers to be evaluated.
+
One example of it's use would be during a Change Request, to let interested parties / stakeholders (Workspace Members) know that the Change had been accepted, scheduled and would therefore be being deployed.  The member's of the workspace may not be Service Manager subscribed users, but their Collaboration subscription would enable them to be kept informed about Change, Problem, or Major Incident notifications by receiving notifications about the automated '''Posting''' from this node to their workspaces. |
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
{{bullet1|Workspace|The ID of the workspace where the comment will be posted}}
 +
{{bullet1|Content|The content of the comment to be added to the post}}
 +
{{bullet1|Include Id|Include the Request Id in the comment which will include a link in the comment, back to the request}}
 +
{{bullet1|Include Summary|Include the Summary of the request in the comment as part of the link back to the request}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
}}
  
[[File:Get questions.png|600px]]
 
</div>
 
</div>
 
  
 
====Email Notifications====           
 
====Email Notifications====           
 
 
Use the Email Notification nodes to send email templates to different Request stakeholders.  Configuration options include recipient, which email template to use and which mailbox to send the email from.
 
Use the Email Notification nodes to send email templates to different Request stakeholders.  Configuration options include recipient, which email template to use and which mailbox to send the email from.
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Email Contact
 
<div class="mw-collapsible-content">
 
::Requests > Email Notification > Email Contact
 
 
[[File:Email_Contact.png|600px]]
 
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
 
</div>
 
</div>
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Email Co-worker
 
<div class="mw-collapsible-content">
 
::Requests > Email Notification > Email Co-worker
 
 
[[File:Email_Coworker.png|600px]]
 
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
 
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|EmailContact|Email Contact|
* Email Customer
+
[[File:bpmemailcontact.png|thumb|link=https://wiki.hornbill.com/images/6/68/Bpmemailcontact.png]]|
<div class="mw-collapsible-content">
+
Use this node to send an email to a contact that has a contact record stored in Hornbill|
::Requests > Email Notification > Email Customer
 
  
[[File:Email_Customer.png|600px]]
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
{{bullet1|Contact|Select a contact from the searchable pick list. Only contacts that have records stored in Hornbill will be available}}
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
{{bullet1|CC|Comma separated email addresses to send as Carbon Copy recipients}}
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.  
+
{{bullet1|BCC|Comma separated email addresses to send as Blind Carbon Copy recipients}}
</div>
+
{{bullet1|Mailbox Name|Select the Hornbill Mailbox from which you want this sent. If this is not set, it will use the default mailbox for the Service that the request has been raised under}}
</div>
+
{{bullet1|Email From|Select the email address that you want listed as the sender.}}
 +
{{bullet1|Email Template Entity|Select the Entity from which you want to use the associated Email Templates. For example select the Change Request Entity to use email templates that contain variables which are specific to this entity. Leave this as ''Auto'' to use the default ''Request'' entity.}}
 +
{{bullet1|Email Template|Select the email template that you want to use for this email}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than ''Customer'' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|EmailCoworker|Email Co-worker|
* Email Customer's Manager
+
[[File:bpmemailcoworker.png|thumb|link=https://wiki.hornbill.com/images/b/b3/Bpmemailcoworker.png]]|
<div class="mw-collapsible-content">
+
Use this node to send an email to a Co-worker that has a user account in Hornbill|
::Requests > Email Notification > Email Customer's Manager
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
 +
{{bullet1|Co-worker|Select a Co-worker from the searchable pick list. Only Co-workers that have accounts in Hornbill will be available}}
 +
{{bullet1|Co-worker (From Variable)|Set a Co-worker from a variable}}
 +
{{bullet1|CC|Comma separated email addresses to send as Carbon Copy recipients}}
 +
{{bullet1|BCC|Comma separated email addresses to send as Blind Carbon Copy recipients}}
 +
{{bullet1|Mailbox Name|Select the Hornbill Mailbox from which you want this sent. If this is not set, it will use the default mailbox for the Service that the request has been raised under}}
 +
{{bullet1|Email From|Select the email address that you want listed as the sender.}}
 +
{{bullet1|Email Template Entity|Select the Entity from which you want to use the associated Email Templates. For example select the Change Request Entity to use email templates that contain variables which are specific to this entity. Leave this as ''Auto'' to use the default ''Request'' entity.}}
 +
{{bullet1|Email Template|Select the email template that you want to use for this email}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than ''Customer'' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
[[File:Email_Customers_Manager.png|600px]]
+
{{BPMAutomation|EmailCustomer|Email Customer|
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
[[File:bpmemailcustomer.png|thumb|link=https://wiki.hornbill.com/images/2/23/Bpmemailcustomer.png]]|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
Use this node to send an email to the customer that is associated to the request|
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.  
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
</div>
+
{{bullet1|CC|Comma separated email addresses to send as Carbon Copy recipients}}
</div>
+
{{bullet1|BCC|Comma separated email addresses to send as Blind Carbon Copy recipients}}
 +
{{bullet1|Mailbox Name|Select the Hornbill Mailbox from which you want this sent. If this is not set, it will use the default mailbox for the Service that the request has been raised under}}
 +
{{bullet1|Email From|Select the email address that you want listed as the sender.}}
 +
{{bullet1|Email Template Entity|Select the Entity from which you want to use the associated Email Templates. For example select the Change Request Entity to use email templates that contain variables which are specific to this entity. Leave this as ''Auto'' to use the default ''Request'' entity}}
 +
{{bullet1|Email Template|Select the email template that you want to use for this email}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than ''Customer'' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|EmailCustomerManager|Email Customer Manager|
* Email External Address
+
[[File:bpmemailcustomermanager.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmemailcustomermanager.png]]|
<div class="mw-collapsible-content">
+
Use this node to send an email to the Manager of the customer that is associated to the request|
::Requests > Email Notification > Email External Address
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
 +
{{bullet1|CC|Comma separated email addresses to send as Carbon Copy recipients}}
 +
{{bullet1|BCC|Comma separated email addresses to send as Blind Carbon Copy recipients}}
 +
{{bullet1|Mailbox Name|Select the Hornbill Mailbox from which you want this sent. If this is not set, it will use the default mailbox for the Service that the request has been raised under}}
 +
{{bullet1|Email From|Select the email address that you want listed as the sender.}}
 +
{{bullet1|Email Template Entity|Select the Entity from which you want to use the associated Email Templates. For example select the Change Request Entity to use email templates that contain variables which are specific to this entity. Leave this as ''Auto'' to use the default ''Request'' entity. }}
 +
{{bullet1|Email Template|Select the email template that you want to use for this email}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than ''Customer'' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
[[File:Email_External_Address.png|600px]]
+
{{BPMAutomation|EmailExternalAddress|Email External Address|
:* '''External Address''' - Add one or more email addresses that are not held within Hornbill.  Multiple email address must be separated by a comma
+
[[File:bpmemailexternal.png|thumb|link=https://wiki.hornbill.com/images/4/4a/Bpmemailexternal.png]]|
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
Use this node to send an email to one or more email addresses that are not available within Hornbill|
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.  
+
{{bullet1|External Addresses|Add one or more email addresses that are not held within Hornbill.  Multiple email address must be separated by a comma. '''Note:''' Please ensure there is no trailing comma. This will create an additional, empty, address which will cause an error.}}
</div>
+
{{bullet1|CC|Comma separated email addresses to send as Carbon Copy recipients}}
</div>
+
{{bullet1|BCC|Comma separated email addresses to send as Blind Carbon Copy recipients}}
 +
{{bullet1|Mailbox Name|Select the Hornbill Mailbox from which you want this sent. If this is not set, it will use the default mailbox for the Service that the request has been raised under}}
 +
{{bullet1|Email From|Select the email address that you want listed as the sender.}}
 +
{{bullet1|Email Template Entity|Select the Entity from which you want to use the associated Email Templates. For example select the Change Request Entity to use email templates that contain variables which are specific to this entity. Leave this as ''Auto'' to use the default ''Request'' entity.}}
 +
{{bullet1|Email Template|Select the email template that you want to use for this email}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than ''Customer'' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|EmailOwner|Email Request Owner|
* Email Request Owner
+
[[File:bpmemailowner.png|thumb|link=https://wiki.hornbill.com/images/e/ea/Bpmemailowner.png]]|
<div class="mw-collapsible-content">
+
Use this node to send an email to the owner of the request|
::Requests > Email Notification > Email Request Owner
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
 +
{{bullet1|CC|Comma separated email addresses to send as Carbon Copy recipients}}
 +
{{bullet1|BCC|Comma separated email addresses to send as Blind Carbon Copy recipients}}
 +
{{bullet1|Mailbox Name|Select the Hornbill Mailbox from which you want this sent. If this is not set, it will use the default mailbox for the Service that the request has been raised under}}
 +
{{bullet1|Email From|Select the email address that you want listed as the sender.}}
 +
{{bullet1|Email Template Entity|Select the Entity from which you want to use the associated Email Templates. For example select the Change Request Entity to use email templates that contain variables which are specific to this entity. Leave this as ''Auto'' to use the default ''Request'' entity.}}
 +
{{bullet1|Email Template|Select the email template that you want to use for this email}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than ''Customer'' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
[[File:Email_Request_Owner.png|600px]]
 
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
 
</div>
 
</div>
 
  
 
====Get Request Information====
 
====Get Request Information====
Use the Get Request Information node at any stage in a process and preceding another process node when you want to make the variables of the Request available.  Variables may include Customer, Status, Site, Priority, or any Answers to Customer defined questions from different Progressive capture forms or attributes of the customer or organisation of the request the business process is running against.
+
Use the Get Request Information node at any stage in a process and preceding another workflow node when you want to make the variables of the Request available.  Variables may include Customer, Status, Site, Priority, or any Answers to Customer defined questions from different Progressive capture forms or attributes of the customer or organisation of the request the business process is running against.
  
<!-- ******************************************************** Customer Details ********************************************************************* -->
+
{{BPMAutomation|Category_Details|Catagory Details|
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
[[File:bpmgetcategorydetails.png|thumb|link=]]|
* Customer Details
+
Use this automation to get information about the logging or closure categories. |
<div class="mw-collapsible-content">
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
::Requests > Get Request Information > Customer Details
+
}}
  
Use this option at the start of a stage or preceding a task / authorisation / decision node to load the Customer's organisations details (variables) into the stage, and to make them available to other node operations where you may wish to specify or refer to '''Variable''' values from the customer of the request.
+
{{BPMAutomation|Customer_Details|Customer Details|
 +
[[File:bpmgetcustomerdetails.png|thumb|link=https://wiki.hornbill.com/images/3/3a/Bpmgetcustomerdetails.png]]|
 +
Use this option at the start of a stage or preceding a task, authorisation, or decision node to load the Customer's organisations details (variables) into the stage, and to make them available to other node operations where you may wish to specify or refer to '''Variable''' values from the customer of the request.|
 +
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
 +
}}
  
:* If you are using the decision node, and want to branch the process based on the Customers department, site, job title or any of the custom fields for the customer, you will need to use the Get Request Information >  Customer Details node at the beginning of the stage, or before the decision node in order to see any variable values be available to evaluate against in the Custom Expression builder.
+
{{BPMAutomation|Source_Email_Details|Source Email Details|
 +
[[File:bpmsourceemaildetails.png|thumb|link=https://wiki.hornbill.com/images/a/ad/Bpmsourceemaildetails.png]]|
 +
When the origin of a Request is an email (i.e. raised via Routing Rules or Email View), this option can be used to retrieve the details of the email message. This includes FROM address, TO address, subject, content, date sent and date received. You can use the Variable Picker or the Expressions Builder to make a decision on the retrieved details.|
 +
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
 +
}}
  
[[File:Customer_Details.png|600px]]
+
{{BPMAutomation|Organisation_Details|Organisation Details|
</div>
+
[[File:bpmorganisationdetails.png|thumb|link=https://wiki.hornbill.com/images/1/1c/Bpmorganisationdetails.png]]|
</div>
+
Use this option at the start of a stage or preceding a task, authorisation, or a decision node to load the Customer's Organisations details to make them available as variables to other node operations where you may wish to specify or refer to values from the customer's organisation associated to the request.|
 +
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
 +
}}
  
<!-- ******************************************************** Organisation Details ********************************************************************* -->
+
{{BPMAutomation|GetRequestInfoOwner|Owner Details|
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
[[File:getrequestownerbpm.png|thumb|link=https://wiki.hornbill.com/images/8/8b/Getrequestownerbpm.png]]|
* Organisation Details
+
Use this operation when you need to use information about the owner of the request for making decisions or to populate other BPM operations with this data.  This operation will populate a number of variables that represent the information about the owner of the request.|
<div class="mw-collapsible-content">
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
::Requests > Get Request Information > Organisation Details
+
}}
  
Use this option at the start of a stage or preceding a task / authorisation / decision node to load the Customer's Organisations details (variables) into the stage, and to make them available to other node operations where you may wish to specify or refer to '''Variable''' values from the customer's organisation of the request.
+
{{BPMAutomation|GetRequestInfoRequestDetails|Request Details|
 
+
[[File:getrequestdetailsbpm.png|thumb|link=https://wiki.hornbill.com/images/b/bb/Getrequestdetailsbpm.png]]|
:* If you are using the decision node, and want to branch the process based on the Industry of the Customers Organisations, or their address, or any customer fields for the customers Organisations you will need to use the Get Request Information >  Organisation Details node at the beginning of the stage, or before the decision node in order to see any variable values be available to evaluate against in the Custom Expression builder.
+
Use this operation when you need to use information held within a request for making decisions or to populate other BPM operations with this data.  This operation will populate a number of variables that represent the information held within a request.|  
 
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
[[File:Org_Details.png|600px]]
+
}}
</div>
 
</div>
 
 
 
<!-- ******************************************************** Owner Details ********************************************************************* -->
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="GetRequestInfoOwner"></div>
 
* Owner Details
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
::{|
 
|- valign="top"
 
|style="width:700px"|
 
[[File:getrequestownerbpm.png|thumb|link=https://wiki.hornbill.com/images/8/8b/Getrequestownerbpm.png|Get Request Owner Details BPM]] Use this operation when you need to use information about the owner of the request for making decisions or to populate other BPM operations with this data.  This operation will populate a number of variables that represent the information about the owner of the request. 
 
 
 
:* '''Request Id'''
 
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
 
<br>
 
<br>
 
The Variables that are available after this operation has been used include the following:
 
 
 
{|
 
|- valign="top"
 
|style="width:300px"|
 
 
 
* First Name
 
* Last Name
 
* Job Title
 
* Site
 
* Manager
 
* Primary Email Address
 
* Primary Phone Number
 
* Mobile Phone Number
 
* Interests
 
* Personal Interests
 
* Qualifications
 
* Skills
 
* Gender
 
* Religion
 
* Nationality
 
* Country
 
* Language
 
|style="width:300px"|
 
* Company
 
* Company Custom 1
 
* Company Custom 2
 
* Company Custom 3
 
* Company Custom 4
 
* Company Custom 5
 
* Company Custom 6
 
* Division
 
* Division Custom 1
 
* Division Custom 2
 
* Division Custom 3
 
* Division Custom 4
 
* Division Custom 5
 
* Division Custom 6
 
* Costcenter
 
* Costcenter Custom 1
 
* Costcenter Custom 2
 
* Costcenter Custom 3
 
|style="width:300px"|
 
* Costcenter Custom 4
 
* Costcenter Custom 5
 
* Costcenter Custom 6
 
* Department
 
* Department Custom 1
 
* Department Custom 2
 
* Department Custom 3
 
* Department Custom 4
 
* Department Custom 5
 
* Department Custom 6
 
* Customer Custom 1
 
* Customer Custom 2
 
* Customer Custom 3
 
* Customer Custom 4
 
* Customer Custom 5
 
* Customer Custom 6
 
* Customer Custom 7
 
* Customer Custom 8
 
|}
 
 
 
 
 
|}
 
</div>
 
</div>
 
</div>
 
 
 
<!-- ******************************************************** Request Details ********************************************************************* -->
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="GetRequestInfoRequestDetails"></div>
 
* Request Details
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
::{|
 
|- valign="top"
 
|style="width:700px"|
 
[[File:getrequestdetailsbpm.png|thumb|link=https://wiki.hornbill.com/images/b/bb/Getrequestdetailsbpm.png|Get Request Request Details BPM]] Use this operation when you need to use information held within a request for making decisions or to populate other BPM operations with this data.  This operation will populate a number of variables that represent the information held within a request.   
 
 
 
:* '''Request Id'''
 
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
 
<br>
 
<br>
 
The Variables that are available after this operation has been used include the following:
 
 
 
{|
 
|- valign="top"
 
|style="width:300px"|
 
* Assigned Team
 
* Assigned Team (For Tasks)
 
* Authorisation (Approved/Rejected)
 
* Catalog Item
 
* Catalog Item Id
 
* Change Type
 
* Closure Category
 
* Created By
 
* Customer
 
* Customer Company
 
* Customer Manager
 
* Customer Primary Email Address
 
* Customer Primary Phone Number
 
* Customer Secondary Email Address
 
* Customer Secondary Phone Number
 
* Customer Type (Coworker/Contact)
 
* Date Logged
 
* Description
 
* Fix By Date
 
|style="width:300px"|
 
* Impact
 
* Linked Requests
 
* Logging Category
 
* Owner
 
* Owner (For Tasks)
 
* Previous Task Owner
 
* Priority
 
* Release Type
 
* Reopen Count
 
* Resolution
 
* Respond By Date
 
* Request Assigned (Yes/No)
 
* Scheduled End Date
 
* Scheduled Start Date
 
* Service
 
* Service Id
 
* Service Level
 
* Service Level Agreement
 
* Site
 
* Source (Analyst/Email/Post/Request/Self Service)
 
* Status
 
* Sub Status Name
 
* Summary
 
|style="width:300px"|
 
* Time Logged
 
* Urgency
 
* Within Fix Time (Yes/No)
 
* External Reference Number
 
* Within Response Time (Yes/No)
 
* Custom Field A
 
* Custom Field B
 
* Custom Field C
 
* Custom Field D
 
* Custom Field E
 
* Custom Field F
 
* Custom Field G
 
* Custom Field H
 
* Custom Field I
 
* Custom Field J
 
* Custom Field K
 
* Custom Field L
 
* Custom Field M
 
* Custom Field N
 
* Custom Field O
 
* Custom Field P
 
* Custom Field Q
 
|}
 
 
 
 
 
|}
 
</div>
 
</div>
 
</div>
 
 
 
<!-- ****************************************************** Progressive Capture Answers ******************************************************* -->
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Progressive Capture Answers
 
<div class="mw-collapsible-content">
 
::Requests > Get Request Information > Progressive Capture Answers
 
  
 +
{{BPMAutomation|Progessive_Capture_Answers|Progressive Capture Answers|
 +
[[File:bpmprogressivecaptureanswers.png|thumb|link=https://wiki.hornbill.com/images/d/d7/Bpmprogressivecaptureanswers.png]]|
 
Use this option before a '''Decision''' node, if you want to load into the process the '''Answers''' from Progressive Capture Custom Forms.  By selecting this option, you can load and make available the answers to progressive capture custom forms, to then evaluate in following '''Decision''' nodes.   
 
Use this option before a '''Decision''' node, if you want to load into the process the '''Answers''' from Progressive Capture Custom Forms.  By selecting this option, you can load and make available the answers to progressive capture custom forms, to then evaluate in following '''Decision''' nodes.   
  
An example of the use of this node could be if you have created a custom form which asked questions about a new start, and one of these questions was to determine which Department they would be joining, it is feasible in your business process that you may wish to check the answer value, and if it was '''Sales''' then branch in one direction, and if it was '''Accounts''' you may want to branch in another direction.  Using the Get Request Information > Progressive Capture Answers will allow these answers to be evaluated in a supporting business process.
+
An example of the use of this node could be if you have created a custom form which asked questions about a new start, and one of these questions was to determine which Department they would be joining, it is feasible in your business process that you may wish to check the answer value, and if it was '''Sales''' then branch in one direction, and if it was '''Accounts''' you may want to branch in another direction.  Using the Get Request Information > Progressive Capture Answers will allow these answers to be evaluated in a supporting business process.|
[[File:Progressive_Capture_Answers.png|600px]]
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
</div>
+
}}
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Service_Details|Service Details|
* Service Details
+
[[File:bpmservicedetails.png|thumb|link=https://wiki.hornbill.com/images/1/10/Bpmservicedetails.png]]|
<div class="mw-collapsible-content">
+
Use this operation to extract details of the service that is set against a request in order to use the Service Details to use with decision node outcomes within your workflow.|
Use this operation to extract details of the service that is set against a request in order to use the Service Details to use with decision node outcomes within your workflow. The following variables are populated
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
 +
}}
  
:* Custom Fields A - F
+
{{BPMAutomation|GetRequestInfoRequestDetails|Site Details|
:* Feedback Enabled
+
[[File:getrequestsitebpm.png|thumb|link=https://wiki.hornbill.com/images/0/0a/Getrequestsitebpm.png]]|
:* Portal Visibility
+
Use this operation when you need to use information held within a request for making decisions or to populate other BPM operations with this site details.  This operation will populate a number of variables that represent the site information held within a request.|
:* Portfolio Status
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
:* Service Category
+
}}
:* Service Name
 
:* Service Owner ID
 
:* Service Owner Name
 
:* Status
 
[[File:bp_get_info_service.png|600px]]
 
</div>
 
</div>
 
  
<!-- ******************************************************** Site Details ********************************************************************* -->
+
{{BPMAutomation|GetTeamDetails|Team Details|
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
[[File:getteamdetails.png|thumb|link=https://wiki.hornbill.com/images/a/a2/Getteamdetails.png]]|
<div id="GetRequestInfoRequestDetails"></div>
+
Use this operation when you need to get information about the team that the request is assigned to. This can be used for making decisions or to populate other BPM operations with this team details.  Team Manager and Team Lead information can also be returned to help with notifications and assignments for important requests.|
* Site Details
+
{{bullet1|Request ID|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.}}
<div class="mw-collapsible-content">
+
}}
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
::{|
 
|- valign="top"
 
|style="width:700px"|
 
[[File:getrequestsitebpm.png|thumb|Get Request Site Details BPM]] Use this operation when you need to use information held within a request for making decisions or to populate other BPM operations with this site details.  This operation will populate a number of variables that represent the site information held within a request.
 
 
 
:* '''Request Id'''
 
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
 
<br>
 
<br>
 
The Variables that are available after this operation has been used include the following:
 
 
 
{|
 
|- valign="top"
 
|style="width:300px"|
 
* Building
 
* Country
 
* Company ID
 
* Company Name
 
* Notes
 
|style="width:300px"|
 
* Site Code
 
* Site ID
 
* Site Name
 
* Type
 
|}
 
 
 
|}
 
</div>
 
</div>
 
</div>
 
  
 
====Integration====
 
====Integration====
Line 1,074: Line 1,829:
 
</div>
 
</div>
  
<!-- ******************************************************** START OF NEW REQUEST ********************************************** -->
+
->
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="integrationnewrequest"></div>
 
<div id="integrationnewrequest"></div>
Line 1,117: Line 1,872:
 
</div>
 
</div>
 
</div>
 
</div>
<!-- **************************************END OF OPERATION DOCUMENTATION***************************************************** -->
+
 
  
 
====Linked Requests====
 
====Linked Requests====
 
Use the Linked Requests node to automatically post updates and resolve linked Requests.  Linked requests are those that have been linked using the Link Action Item on a request form.   
 
Use the Linked Requests node to automatically post updates and resolve linked Requests.  Linked requests are those that have been linked using the Link Action Item on a request form.   
  
<!-- ******************************* START OF RESOLVE LINKED REQUESTS ******************************************************** -->
+
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Resolve Linked Requests
 
* Resolve Linked Requests
Line 1,165: Line 1,920:
 
</div>
 
</div>
  
<!-- **************************************START OF UPDATE LINKED REQUESTS***************************************************** -->
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Update Linked Requests
 
* Update Linked Requests
Line 1,197: Line 1,951:
 
</div>
 
</div>
 
</div>
 
</div>
<!-- **************************************END OF OPERATION***************************************************** -->
+
 
 +
 
  
 
==== Log Requests ====
 
==== Log Requests ====
 
Use the Log Request to automatically raise another request at a particular point in the workflow.  
 
Use the Log Request to automatically raise another request at a particular point in the workflow.  
<!-- ****************************************************** START OF OPERATION ***********************************************************  -->
+
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="LogNewChange"></div>
 
<div id="LogNewChange"></div>
Line 1,212: Line 1,967:
 
[[File:bpmlognewchange.png|thumb|link=https://wiki.hornbill.com/images/d/da/Bpmlognewchange.png|Log New Change]]
 
[[File:bpmlognewchange.png|thumb|link=https://wiki.hornbill.com/images/d/da/Bpmlognewchange.png|Log New Change]]
 
:* '''Request ID'''
 
:* '''Request ID'''
:: This is an automatic options and should be set to ''Auto''
+
:: This is an automatic option and should be set to ''Auto''
 
:* ''' Summary'''  
 
:* ''' Summary'''  
 
:: To add a summary to the new request, set to ''Manual'' and provide the required text for the summary
 
:: To add a summary to the new request, set to ''Manual'' and provide the required text for the summary
 
:* ''' Description'''  
 
:* ''' Description'''  
 
:: To add a description to the new request, set to ''Manual'' and provide the required text for the description  
 
:: To add a description to the new request, set to ''Manual'' and provide the required text for the description  
 +
{{bullet1|Customer (Co-worker)|The ID of the Customer to assign to the request}}
 +
{{bullet1|Customer (Contact)| The ID of the Contact to assign to the request}}
 
:* ''' Service '''
 
:* ''' Service '''
 
:: To add a Service to the new request, set to ''Manual'' and select a Service from the pick list.  If a Service is specified without a Catalog Item, the BPM workflow set against this request type on the Service Configuration will be used on the new request.
 
:: To add a Service to the new request, set to ''Manual'' and select a Service from the pick list.  If a Service is specified without a Catalog Item, the BPM workflow set against this request type on the Service Configuration will be used on the new request.
Line 1,225: Line 1,982:
 
:* ''' Category '''
 
:* ''' Category '''
 
:: To add a Request Category to the new request, set to ''Manual'' and click on the edit button to open the Category selector.
 
:: To add a Request Category to the new request, set to ''Manual'' and click on the edit button to open the Category selector.
 +
:* ''' Change Type'''
 +
:: To set a Change Type, set to ''Manual'' and select the change type from the pick list
 
:* ''' Team '''
 
:* ''' Team '''
 
:: To add a Team to the new request, set to ''Manual'' and select a team from the pick list  
 
:: To add a Team to the new request, set to ''Manual'' and select a team from the pick list  
Line 1,253: Line 2,012:
 
:* ''' Copy Status? '''
 
:* ''' Copy Status? '''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 +
:* ''' Copy Questions? '''
 +
:: To use the same answers to the questions section on the originating request, set to ''Manual'' and select ''Yes''
 +
{{Bullet1|Copy Assets|Copy the assets that are associated to the original request. Set to ''Manual'' and select ''Yes''}}
 
:* ''' System Timeline Update '''
 
:* ''' System Timeline Update '''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
Line 1,264: Line 2,026:
 
</div>
 
</div>
  
<!-- ****************************************************** START OF OPERATION ***********************************************************  -->
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="LogNewIncident"></div>
 
<div id="LogNewIncident"></div>
Line 1,280: Line 2,041:
 
:* ''' Description'''  
 
:* ''' Description'''  
 
:: To add a description to the new request, set to ''Manual'' and provide the required text for the description  
 
:: To add a description to the new request, set to ''Manual'' and provide the required text for the description  
 +
{{bullet1|Customer (Co-worker)|The ID of the Customer to assign to the request}}
 +
{{bullet1|Customer (Contact)| The ID of the Contact to assign to the request}}
 
:* ''' Service '''
 
:* ''' Service '''
 
:: To add a Service to the new request, set to ''Manual'' and select a Service from the pick list.  If a Service is specified without a Catalog Item, the BPM workflow set against this request type on the Service Configuration will be used on the new request.
 
:: To add a Service to the new request, set to ''Manual'' and select a Service from the pick list.  If a Service is specified without a Catalog Item, the BPM workflow set against this request type on the Service Configuration will be used on the new request.
Line 1,316: Line 2,079:
 
:* ''' Copy Status? '''
 
:* ''' Copy Status? '''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 +
:* ''' Copy Questions? '''
 +
:: To use the same answers to the questions section on the originating request, set to ''Manual'' and select ''Yes''
 +
{{Bullet1|Copy Assets|Copy the assets that are associated to the original request. Set to ''Manual'' and select ''Yes''}}
 
:* ''' System Timeline Update '''
 
:* ''' System Timeline Update '''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
Line 1,326: Line 2,092:
 
</div>
 
</div>
 
</div>
 
</div>
<!-- ****************************************************** START OF OPERATION *********************************************************** -->
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="LogNewKnownError"></div>
 
* Log New Known Error
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
::{|
 
|- valign="top"
 
|style="width:700px"|
 
[[File:bmplognewke.png|thumb|link=https://wiki.hornbill.com/images/f/ff/Bmplognewke.png|Log New Known Error]]
 
:* '''Request ID'''
 
:: This is an automatic options and should be set to ''Auto''
 
:* ''' Summary'''
 
:: To add a summary to the new request, set to ''Manual'' and provide the required text for the summary
 
:* ''' Description'''
 
:: To add a description to the new request, set to ''Manual'' and provide the required text for the description
 
:* ''' Service '''
 
:: To add a Service to the new request, set to ''Manual'' and select a Service from the pick list.  If a Service is specified without a Catalog Item, the BPM workflow set against this request type on the Service Configuration will be used on the new request.
 
:* ''' Catalog Item '''
 
:: To add a Catalog Item to the new request, set to ''Manual'' and provide the name of the Catalog Item.  If both a Service and Catalog Item are specified, the BPM workflow set against the Catalog item will be used on the new request.
 
:* ''' Priority '''
 
:: To add a Priority to the new request, set to ''Manual'' and select a Priority from the pick list
 
:* ''' Category '''
 
:: To add a Request Category to the new request, set to ''Manual'' and click on the edit button to open the Category selector.
 
:* ''' Team '''
 
:: To add a Team to the new request, set to ''Manual'' and select a team from the pick list
 
:* ''' Owner '''
 
:: To add an Owner to the new request, set to ''Manual'' and select start typing the name of the user and then select them from the pick list
 
:* ''' Site '''
 
:: To add a Site to the new request, set to ''Manual'' and select a Site from the pick list
 
:* ''' Status '''
 
:: To set the status on the new request, set to ''Manual'' and select a status from the pick list
 
:* ''' Copy Customer? '''
 
:: To use the same Customer as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' Copy Summary? '''
 
:: To use the same Summary as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' Copy Description? '''
 
:: To use the same Description as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' Copy Service? '''
 
:: To use the same Service as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' Copy Priority? '''
 
:: To use the same Priority as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' Copy Category? '''
 
:: To use the same Category as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' Copy Team? '''
 
:: To use the same Team as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' Copy Owner? '''
 
:: To use the same Owner as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' Copy Site? '''
 
:: To use the same Site as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' Copy Status? '''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 
:* ''' System Timeline Update '''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
 
:* ''' Manual Timeline Update '''
 
:: To provide a unique Timeline Update in the new request, set to ''Manual'' and click on the edit button to open the text window to add your unique timeline entry.
 
:* ''' Visibility'''
 
:: Set the Visibility of the Timeline Entry if one is provided.
 
|}
 
</div>
 
</div>
 
</div>
 
  
<!-- ****************************************************** START OF OPERATION *********************************************************** -->
+
{{BPMAutomation|LogNewKnownError|Log New Known Error|
 +
[[File:Log_New_Known_Error.png|thumb|link=https://wiki.hornbill.com/images/c/c6/Log_New_Known_Error.png]]|
 +
Use this Hornbill Automation to create a new Known Error Record|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Summary|To add a summary to the new known error, set to ''Manual'' and provide the required text for the summary}}
 +
{{bullet1|Description|To add a description to the new known error, set to ''Manual'' and provide the required text for the description}}
 +
{{bullet1|Service|To add a Service to the new known error, set to ''Manual'' and select a Service from the pick list.  If a Service is specified without a Catalog Item, the BPM workflow set against this known error on the Service Configuration will be used on the new request.}}
 +
{{bullet1|Catalog Item|To add a Catalog Item to the new known error, set to ''Manual'' and provide the name of the Catalog Item.  If both a Service and Catalog Item are specified, the BPM workflow set against the Catalog item will be used on the new known error.}}
 +
{{bullet1|Priority|To add a Priority to the new known error, set to ''Manual'' and select a Priority from the pick list}}
 +
{{bullet1|Category|To add a Request Category to the new known error, set to ''Manual'' and click on the edit button to open the Category selector.}}
 +
{{bullet1|Team|To add a Team to the new know error, set to ''Manual'' and select a team from the pick list}}
 +
{{bullet1|Owner|To add an Owner to the new request, set to ''Manual'' and select start typing the name of the user and then select them from the pick list}}
 +
{{bullet1|Site|To add a Site to the new know error, set to ''Manual'' and select a Site from the pick list}}
 +
{{bullet1|Status|To set the status on the new request, set to ''Manual'' and select a status from the pick list}}
 +
{{bullet1|Root Cause|To add a root cause to the known error, set to ''Manual'' and provide the root cause text or set using a variable}}
 +
{{bullet1|Workaround|To add a workaround to the known error, set to ''Manual'' and provide the workaround text or set using a variable}}
 +
{{bullet1|Copy Customer?|To use the same Customer as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Summary?|To use the same Summary as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Description?|To use the same Description as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Service?|To use the same Service as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Priority?|To use the same Priority as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Category?|To use the same Category as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Team?|To use the same Team as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Owner? |To use the same Owner as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Site?|To use the same Site as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Status?|To use the same Status as the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Questions?|To use the same answers to the questions section from the originating request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Root Cause?|To use the same Root Cause as the originating problem record, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Copy Workaround?|To use the same Workaround as the originating problem record, set to ''Manual'' and select ''Yes''}}
 +
{{Bullet1|Copy Assets|Copy the assets that are associated to the original request. Set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|System Timeline Update|To include a Timeline entry in the new known error to record the raising of the new request, set to ''Manual'' and select ''Yes''}}
 +
{{bullet1|Manual Timeline Update |To provide a unique Timeline Update in the new known error, set to ''Manual'' and click on the edit button to open the text window to add your unique timeline entry.}}
 +
{{bullet1|Visibility|Set the Visibility of the Timeline Entry if one is provided.}}
 +
}}
 +
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="LogNewProblem"></div>
 
<div id="LogNewProblem"></div>
Line 1,441: Line 2,179:
 
:* ''' Copy Status? '''
 
:* ''' Copy Status? '''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 +
:* ''' Copy Questions? '''
 +
:: To use the same answers to the questions section on the originating request, set to ''Manual'' and select ''Yes''
 +
{{Bullet1|Copy Assets|Copy the assets that are associated to the original request. Set to ''Manual'' and select ''Yes''}}
 
:* ''' System Timeline Update '''
 
:* ''' System Timeline Update '''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
Line 1,452: Line 2,193:
 
</div>
 
</div>
  
<!-- ****************************************************** START OF OPERATION *********************************************************** -->
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="LogNewRelease"></div>
 
<div id="LogNewRelease"></div>
Line 1,476: Line 2,216:
 
:* ''' Category '''
 
:* ''' Category '''
 
:: To add a Request Category to the new request, set to ''Manual'' and click on the edit button to open the Category selector.
 
:: To add a Request Category to the new request, set to ''Manual'' and click on the edit button to open the Category selector.
 +
{{Bullet1|Release Type|Set the Release Type for this Release. The options are driven from the 'releaseRequestType' Simple List.}}
 
:* ''' Team '''
 
:* ''' Team '''
 
:: To add a Team to the new request, set to ''Manual'' and select a team from the pick list  
 
:: To add a Team to the new request, set to ''Manual'' and select a team from the pick list  
Line 1,504: Line 2,245:
 
:* ''' Copy Status? '''
 
:* ''' Copy Status? '''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 +
:* ''' Copy Questions? '''
 +
:: To use the same answers to the questions section on the originating request, set to ''Manual'' and select ''Yes''
 +
{{Bullet1|Copy Assets|Copy the assets that are associated to the original request. Set to ''Manual'' and select ''Yes''}}
 
:* ''' System Timeline Update '''
 
:* ''' System Timeline Update '''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
Line 1,515: Line 2,259:
 
</div>
 
</div>
  
<!-- ****************************************************** START OF OPERATION *********************************************************** -->
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="LogNewRequest"></div>
 
<div id="LogNewRequest"></div>
Line 1,531: Line 2,274:
 
:* ''' Description'''  
 
:* ''' Description'''  
 
:: To add a description to the new request, set to ''Manual'' and provide the required text for the description  
 
:: To add a description to the new request, set to ''Manual'' and provide the required text for the description  
 +
{{bullet1|Customer (Co-worker)|The ID of the Customer to assign to the request}}
 +
{{bullet1|Customer (Contact)| The ID of the Contact to assign to the request}}
 
:* ''' Service '''
 
:* ''' Service '''
 
:: To add a Service to the new request, set to ''Manual'' and select a Service from the pick list.  If a Service is specified without a Catalog Item, the BPM workflow set against this request type will be used on the new request.
 
:: To add a Service to the new request, set to ''Manual'' and select a Service from the pick list.  If a Service is specified without a Catalog Item, the BPM workflow set against this request type will be used on the new request.
Line 1,567: Line 2,312:
 
:* ''' Copy Status? '''
 
:* ''' Copy Status? '''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 
:: To use the same Status as the originating request, set to ''Manual'' and select ''Yes''
 +
:* ''' Copy Questions? '''
 +
:: To use the same answers to the questions section on the originating request, set to ''Manual'' and select ''Yes''
 +
{{Bullet1|Copy Assets|Copy the assets that are associated to the original request. Set to ''Manual'' and select ''Yes''}}
 
:* ''' System Timeline Update '''
 
:* ''' System Timeline Update '''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
 
:: To include a Timeline entry in the new request to record the raising of the new request, set to ''Manual'' and select ''Yes''
Line 1,581: Line 2,329:
 
{{infobox|Using these options in your business processes, please be aware of where you are invoking them / placing them in the workflow, and  in turn which business processes are going to be invoked against the new Incident or Service Request raised.  Please avoid scenario's where one business process may invoke the logging of a new request, where the new request's business process immediately is configured to log a new request which again has a business process which again logs another request immediately creating a loop. The result of which may be a lot of unwanted requests.  In the event this occurs, disable the causing business process and resolve the issue.}}
 
{{infobox|Using these options in your business processes, please be aware of where you are invoking them / placing them in the workflow, and  in turn which business processes are going to be invoked against the new Incident or Service Request raised.  Please avoid scenario's where one business process may invoke the logging of a new request, where the new request's business process immediately is configured to log a new request which again has a business process which again logs another request immediately creating a loop. The result of which may be a lot of unwanted requests.  In the event this occurs, disable the causing business process and resolve the issue.}}
  
====Request Service====
 
  
Use the Request Service node, if you wish to automate the availability status setting of the service associated to a request.  It can be useful to automate the settings of of a services availability status to both the support community and the subscribed customers of a service, both when a request has been raised and or when it has been resolved, and normal service and availability is resumed.
+
=== Questions ===
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Delete_Questions|Delete Questions|
* Update Service Status
+
[[File:bpmdeletequestions.png|thumb|link=https://wiki.hornbill.com/images/2/26/Bpmdeletequestions.png]]|
<div class="mw-collapsible-content">
+
This Hornbill Automation will delete the entire Questions section on a request.  This can be used to remove this information once it has performed its use and it no longer required.  |
:* '''Request ID''' - This is an automatic options and should be set to ''Auto''
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
:* '''Status''' - Select the Status to set the Service's Availability too, or choose No Status if no Status is required to be displayed for the Service.
+
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
:* '''Status Message''' - An optional message to be displayed alongside the Status - this will be visible to both analysts supporting the service, and customers subscribed to the service.
+
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
[[File:Update_Request_Service_Status.png|centre|600px]]
+
{{bullet1|Timeline Visibility|Choose what level of visibility will be automatically applied to this update. Choosing anything other than Customer will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
</div>
+
}}
</div>
 
 
 
===Suspend===
 
 
 
Use the Suspend node if you wish to suspend the progress of the process until a defined action is performed manually on the Request.  This could include waiting for a Priority to be set, a Customer added, Ownership set or the Resolution defined.  Configuration options include the ability to specify the context (which Action Bar icon) the Request will appear in whilst waiting for the Suspend (manual action) to be performed.
 
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Await Expiry
 
<div class="mw-collapsible-content">
 
::Requests > Suspend > Await Expiry
 
::Use this suspend node to suspend a Request's Business Process until the expire period has been reached.
 
:* '''Expire Period'''
 
::This option determines when the stage expires. A Duration must be supplied (e.g. 8 Hours). If the expiry date/time is known, ignore this option and set 'Expire Date/Time' option instead. If supplied, the value in 'Expire Date/Time' option will be ignored.
 
:* '''Expire Date/Time'''
 
::This option determines when the stage expires. A Date/Time value must be supplied (e.g. 2040-01-01T12:00:00Z) - This value can be injected from the Variable Picker. If the expiry date/time is not known, ignore this option and set 'Expire Period' option with a duration instead. If supplied, the value in 'Expire Date/Time' option will be ignored.
 
[[File:Suspend_Await_Expiry.png|600px]]
 
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Wait for List of Request Authorisers
 
<div class="mw-collapsible-content">
 
::Use this suspend node to present an Authorization Action on a request form that lets you manually assign authorisers at a particular point in the BPM Workflow.  Once all authorisers have been submitted, an authorisation task will be sent to all the selected users (''Requests > Suspend > List of Request Authorisers'')
 
:* '''Action Focus'''
 
:: Sets the Action Item on a request that will be in focus.  When using this suspend node, it is recommended to select the ''Authorisation'' action item.
 
:* '''Authorization Type'''
 
:: There are three available Authorization Types.  ''Individual'' - Only one of the selected authorizers will be required to approve the authorization in order to proceed.  ''Majority'' - At least half of the selected authorizers will be required to approve the authorization in order to proceed.  ''Unanimous'' - All of the selected authorizers must approve the authorization in order to proceed.
 
:* '''Service Owner'''
 
:: Selecting ''Yes'' will automatically include the owner of the service that the requests is raised against, to the list of authorizers
 
:* '''Linked Service Owners'''
 
:: Selecting ''Yes'' will automatically include the owners of the services that are linked to the request, to the list of authorizers
 
:* '''Linked Assets Owners'''
 
:: Selecting ''Yes'' will automatically include the owners of the assets that are linked to the request, to the list of authorizers
 
  
:[[File:Information.png|14px|text-top|Information]] Once the authorisers have been submited the ''Auto Assign Authorisation'' BPM node is used to distribute the authorisation tasks.  The ''Auto Assign Authorisation'' BPM Node must follow the ''Wait for List of Request Authorisors'' BPM Node, either immediately after or later on in the workflow at the point when you want the authorisations to be sent out.
 
[[File:WaitforlistofApprovers.png|600px]]
 
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
===Request Service===
* Wait for Request Closure
 
<div class="mw-collapsible-content">
 
::Requests > Suspend > Wait for Request Closure
 
  
[[File:Suspend_Wait_Close.png|600px]]
+
Use the Request Service node, if you wish to automate the availability status setting of the service associated to a request, or to automate adding related services of the request service to the request.
</div>
 
</div>
 
  
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
* Wait for Request Closure Category
+
* Add Related Services
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
::Requests > Suspend > Wait for Request Closure Category
+
:* '''Request ID''' - This is an automatic option and should be set to ''Auto''
 +
:* '''Relationship Type''' - Select which services to relate to the request, based on their relationship type to the request service.
 +
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 +
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 +
:* '''Visibility''' -  Choose what level of visibility will be automatically applied to this update. Choosing anything other than Customer will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
  
[[File:Closure_Category.png|600px]]
+
[[File:update_related_services_bpm.png|centre|600px]]
 
</div>
 
</div>
 
</div>
 
</div>
  
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
* Wait for Customer
+
* Update Service Status
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
::Requests > Suspend > Wait for Customer
+
:* '''Request ID''' - This is an automatic options and should be set to ''Auto''
 
+
:* '''Status''' - Select the Status to set the Request Service's Availability too, or choose No Status if no Status is required to be displayed for the Service.
[[File:at_requests_suspend_waitForCustomer.png|600px]]
+
:* '''Status Message''' - An optional message to be displayed alongside the Status - this will be visible to both analysts supporting the service, and customers subscribed to the service.
</div>
+
[[File:Update_Request_Service_Status.png|centre|600px]]
 
</div>
 
</div>
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Wait for Request Description
 
<div class="mw-collapsible-content">
 
::Requests > Suspend > Wait for Request Description
 
  
[[File:Suspend_Request_Description.png|600px]]
 
</div>
 
</div>
 
  
<!-- *******************************START OF WAIT FOR REQUEST EMAIL OPERATION DOCUMENTATION *********************************** -->
+
===Suspend===
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="waitForRequestEmail"></div>
 
* Wait for Request Email
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
::{|
 
|- valign="top"
 
|style="width:700px"|
 
[[File:bpmwaitforrequestemail.png|thumb|link=https://wiki.hornbill.com/images/a/a1/Bpmwaitforrequestemail.png|Wait for Request Email]]
 
  
==== Wait for Request Email ====
+
Use the Suspend nodes if you wish to suspend the progress of the workflow until a defined action is performed manually on the Request.  This could include waiting for a Priority to be set,  a Customer added, Ownership set or the Resolution defined.  Configuration options include the ability to specify the context (which Action Bar icon) the Request will appear in whilst waiting for the Suspend (manual action) to be performed.  
Use this node to suspend the BPM Workflow and wait for an email to be sent from the request.
 
  
==== Options ====
+
{{BPMAutomation|Await_Expiry|Await Expiry|
:* '''RequestID'''
+
[[File:bpmwaitforexpiry.png|thumb|link=https://wiki.hornbill.com/images/2/29/Bpmwaitforexpiry.png]]|
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto.
+
Use this suspend node to suspend a Request's workflow until the expire period has been reached.|
:* '''Action Focus'''
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
:: Sets the Action Item on a request that will be in focus. When using this suspend node.
+
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
:* '''Expire Period'''
+
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue. This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.  If you wish to use a date/time for expiry, set this option to "ignore" and set the'Expire Date/Time' option below instead.}}
:: Set a date and time for which this operation will expire. When this date and time is reached, the BPM will automatically continue. An outcome of ''Expired'' will be provided to allow for a decision node to be place after this operation to determine how the expired operation will be managed.
+
{{bullet1|Expiry Date/Time|This option determines when the node expires. A date/time value must be supplied (e.g. 2040-01-01T12:00:00Z) which can be injected from the Variable Picker. If the "expire period" option has been set, any value in this 'Expire Date/Time' option will be disregarded.}}
|}
+
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
</div>
+
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
</div>
+
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
</div>
+
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
<!-- **************************************END OF OPERATION DOCUMENTATION***************************************************** -->
+
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Wait_for_Request_Authorisers|Wait for List of Request Authorisers|
* Wait for External Reference
+
[[File:bpmwaitforlistofapprovers.png|thumb|link=https://wiki.hornbill.com/images/8/89/Bpmwaitforlistofapprovers.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to present an Authorization Action on a request form that lets you manually assign authorisers at a particular point in the BPM Workflow.  Once all authorisers have been submitted, an authorisation task will be sent to all the selected users (''Requests > Suspend > List of Request Authorisers'')|
::Requests > Suspend > Wait for External Reference
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Authorisation Type|There are three available Authorization Types.  ''Individual'' - Only one of the selected authorizers will be required to approve the authorization in order to proceed.  ''Majority'' - At least half of the selected authorizers will be required to approve the authorization in order to proceed.  ''Unanimous'' - All of the selected authorizers must approve the authorization in order to proceed.}}
 +
{{bullet1|Use Previous Authorisers|If a list of authorisers had previously been selected in a preceding authorisation, selecting 'Yes' will reuse this list of authorisers}}
 +
{{bullet1|Service Owner|Selecting ''Yes'' will automatically include the owner of the service that the requests is raised against, to the list of authorizers}}
 +
{{bullet1|Linked Services Owners|Selecting ''Yes'' will automatically include the owners of the services that are linked to the request, to the list of authorizers}}
 +
{{bullet1|Linked Assets Owners|Selecting ''Yes'' will automatically include the owners of the assets that are linked to the request, to the list of authorizers}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
  
[[File:Suspend_Request_External.png|600px]]
+
:[[File:Information.png|14px|text-top|Information]] Once the authorisers have been submited the ''Auto Assign Authorisation'' BPM node is used to distribute the authorisation tasks.  The ''Auto Assign Authorisation'' BPM Node must follow the ''Wait for List of Request Authorisors'' BPM Node, either immediately after or later on in the workflow at the point when you want the authorisations to be sent out.
</div>
+
}}
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Wait_for_Attachment|Wait for Attachment|
* Wait for Linked Services
+
[[File:bpmwaitforattachment.png|thumb|link=https://wiki.hornbill.com/images/6/67/Bpmwaitforattachment.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until an attachment has been added to the request|
: Use this suspend option when a request needs to have a linked service added before the process can continue
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
::Requests > Suspend > Wait for Linked Service
+
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
</div>
+
{{BPMAutomation|Wait_for_Request_Closure|Wait for Request Closure|
</div>
+
[[File:bpmwaitforclosure.png|thumb|link=https://wiki.hornbill.com/images/0/0a/Bpmwaitforclosure.png]]|
 +
Use this Hornbill Automation to suspend a Request's workflow until the request has a status of ''closed''.|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<!-- *******************************START OF OPERATION DOCUMENTATION******************************************************** -->
+
{{BPMAutomation|Wait_for_Request_Closure_Category|Wait for Request Closure Category|
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
[[File:bpmwaitforclosurecategory.png|thumb|link=https://wiki.hornbill.com/images/2/2b/Bpmwaitforclosurecategory.png]]|
<div id="waitForLinkedRequestUpdate"></div>
+
Use this Hornbill Automation to suspend a Request's workflow until the Closure Category has been set.|
* Wait for Linked Request Update
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
<div class="mw-collapsible-content">
+
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
+
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
::{|
+
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
|- valign="top"
+
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
|style="width:700px"|
+
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
[[File:bpmwaitforlinkedrequestupdate.png|thumb|link=https://wiki.hornbill.com/images/f/fc/Bpmwaitforlinkedrequestupdate.png|Wait for Linked Request Update]]
+
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
==== Wait for Linked Request Update ====
+
{{BPMAutomation|Wait_for_Customer|Wait for Customer|
Use this node to suspend the BPM Workflow and wait for an update to be made on a linked request.
+
[[File:bpmwaitforcustomer.png|thumb|link=https://wiki.hornbill.com/images/a/a2/Bpmwaitforcustomer.png]]|
 +
Use this Hornbill Automation to suspend a Request's workflow until the Customer has been set.|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
==== Options ====
+
{{BPMAutomation|SuspendAndWaitForFeedback|Wait for Feedback|
:* '''RequestID'''
+
[[File:bpmswaitforfeedback.png|thumb|link=https://wiki.hornbill.com/images/8/83/Bpmswaitforfeedback.png]]|
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto.
+
Use this Hornbill Automation to suspend a Request's workflow until the Customer has provided feedback on the request.|
:* '''Request Type'''
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
:: This limits the suspend to only wait for updates from linked requests of the selected type
+
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
:* '''Linked Request ID'''
+
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
:: This limits the suspend to only wait for updates from a linked request with provided Request ID.  This can use variables to automatically populate this information.
+
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
:* '''Contains'''
+
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
:: Include a string of text which will match the text within the linked request's timeline
+
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
:* '''Expire Period'''
+
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
:: Set a date and time for which this operation will expire.  When this date and time is reached, the BPM will automatically continue.  An outcome of ''Expired'' will be provided to allow for a decision node to be place after this operation to determine how the expired operation will be managed.
+
}}
|}
 
</div>
 
</div>
 
</div>
 
<!-- **************************************END OF OPERATION DOCUMENTATION***************************************************** -->
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Wait_for_Request_Description|Wait for Request Description|
* Wait for Request Owner
+
[[File:bpmwaitfordescription.png|thumb|link=https://wiki.hornbill.com/images/a/ad/Bpmwaitfordescription.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until a description has been provided on the request.|
:Use this suspend option when a request does not currently have an owner.
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
::Requests > Suspend > Wait for Request Owner
+
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:at_requests_suspend_waitForRequestOwner.png| 600px]]
+
{{BPMAutomation|Wait_for_Document|Wait for Document|
</div>
+
[[File:bpmwaitfordocument.png|thumb|link=]]|
</div>
+
Use this Hornbill Automation to suspend a Request's workflow until a document from Document Manager has been linked to the request|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|waitForRequestEmail|Wait for Request Email|
* Wait for New Request Owner
+
[[File:bpmwaitforrequestemail.png|thumb|link=https://wiki.hornbill.com/images/a/a1/Bpmwaitforrequestemail.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until an email has been sent from the request.|
:Use this suspend option when the request already has an owner, but it is in a state where it is waiting for a reassignment.  
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
::Requests > Suspend > Wait for New Request Owner
+
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:Suspendwaitfornewowner.png| 600px]]
+
{{BPMAutomation|Wait_for_External_Reference|Wait for External Reference|
</div>
+
[[File:bpmwaitforexternalreference.png|thumb|link=https://wiki.hornbill.com/images/9/9c/Bpmwaitforexternalreference.png]]|
</div>
+
Use this Hornbill Automation to suspend a Request's workflow until an external reference has been provided.|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Wait_for_Impact_Assessment|Wait for Impact Assessment|
* Wait for Request Off Hold
+
[[File:bpmwaitforimpactassessment.png|thumb|link=https://wiki.hornbill.com/images/c/c9/Bpmwaitforimpactassessment.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until an Impact Assessment has been completed|
::Requests > Suspend > Wait for Request Off Hold
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:Suspend_wait_offhold.png|600px]]
+
{{BPMAutomation|Wait_for_Linked_Assets|Wait for Linked Assets|
</div>
+
[[File:bpmwaitforlinkedassets.png|thumb|link=https://wiki.hornbill.com/images/d/df/Bpmwaitforlinkedassets.png]]|
</div>
+
Use this Hornbill Automation to suspend a Request's workflow until one or more Assets have been linked to the request|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|waitForLinkedRequest|Wait for Linked Request|
* Wait for Request Priority
+
[[File:bpmwaitforlinkedrequest.png|thumb|link=https://wiki.hornbill.com/images/5/51/Bpmwaitforlinkedrequest.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until a linked request has been added|
::Requests > Suspend >  Wait for Request Priority
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Request Type|This limits the suspend to only wait for updates from linked requests of the selected type}}
 +
{{bullet1|Linked Request ID|This limits the suspend to only wait for updates from a linked request with provided Request ID.  This can use variables to automatically populate this information.}}
 +
{{bullet1|Contains|Include a string of text which will match the text within the linked request's timeline}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:at_requests_suspend_waitForRequestPriority.png|600px]]
+
{{BPMAutomation|waitForLinkedRequestsCompletion|Wait for Linked Requests Completion|
</div>
+
[[File:bpmwaitforlinkedrequestscompletion.png|thumb|link=https://wiki.hornbill.com/images/0/05/Bpmwaitforlinkedrequestscompletion.png]]|
</div>
+
This automation suspends the workflow and waits for linked requests to be of a specified status before being allowed to continue.|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Resolved linked requests are completed|(Yes, No) "resolved" request status constitutes the completion of a linked request (Default: Yes).}}
 +
{{bullet1|Closed linked requests are completed|(Yes, No) "closed" request status constitutes the completion of a linked request (Default: Yes)}}
 +
{{bullet1|Cancelled linked requests are completed|(Yes, No) "cancelled" request status constitutes the completion of a linked request (Default: Yes)}}
 +
{{bullet1|Action Focus| This option determines the Action Tab that a Request will focus on while the process is suspended.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
* Wait for Request Category
 
<div class="mw-collapsible-content">
 
::Requests > Suspend >  Wait for Request Category
 
 
[[File:Suspend_Request_Category.png|600px]]
 
</div>
 
</div>
 
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|waitForLinkedRequestUpdate|Wait for Linked Request Update|
* Wait for Request Resolution
+
[[File:bpmwaitforlinkedrequestupdate.png|thumb|link=https://wiki.hornbill.com/images/f/fc/Bpmwaitforlinkedrequestupdate.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until an update has been made on a linked request.|
::Requests > Suspend > Wait for Request Resolution
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Request Type|This limits the suspend to only wait for updates from linked requests of the selected type}}
 +
{{bullet1|Linked Request ID|This limits the suspend to only wait for updates from a linked request with provided Request ID.  This can use variables to automatically populate this information.}}
 +
{{bullet1|Contains|Include a string of text which will match the text within the linked request's timeline}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:at_requests_suspend_waitForRequestResolution.png|600px]]
+
{{BPMAutomation|Wait_for_Linked_Services|Wait for Linked Services|
</div>
+
[[File:bpmwaitforlinkedservice.png|thumb|link=https://wiki.hornbill.com/images/6/61/Bpmwaitforlinkedservice.png]]|
</div>
+
Use this Hornbill Automation to suspend a Request's workflow until an external reference has been provided.|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Wait_for_New_Request_Owner|Wait for New Request Owner|
* Wait for Request Site
+
[[File:bpmwaitfornewrequestowner.png|thumb|link=https://wiki.hornbill.com/images/5/54/Bpmwaitfornewrequestowner.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until the ownership of the request has been changed from one owner to another.|
::Requests > Suspend > Wait for Request Site
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:Suspend_Request_Site.png|600px]]
+
{{BPMAutomation|Wait_for_Request_Off_Hold|Wait for Request Off Hold|
</div>
+
[[File:bpmwaitforoffhold.png|thumb|link=https://wiki.hornbill.com/images/3/3d/Bpmwaitforoffhold.png]]|
</div>
+
Use this Hornbill Automation to suspend a Request's workflow until the request status has come off hold.|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Wait_for_Request_Owner|Wait for Request Owner|
* Wait for Status Change
+
[[File:bpmwaitforowner.png|thumb|link=https://wiki.hornbill.com/images/e/ec/Bpmwaitforowner.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until an owner has been assigned to the request.|
: Use this suspend mode to wait for a change from a particular status. A decision node can follow this to determine the new status and the workflow that follows.  This is particularly useful for managing two stage closure where options for resolving, closing, and re-opening can take place. (Requests > Suspend > Wait for Request Summary)
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
:* '''Action Focus'''
+
{{BPMAutomation|Wait_for_Request_Priority|Wait for Request Priority|
:: Sets the Action Item on a request that will be in focus. When using this suspend node.
+
[[File:bpmwaitforpriority.png|thumb|link=https://wiki.hornbill.com/images/b/b5/Bpmwaitforpriority.png]]|
:* '''From Status'''
+
Use this Hornbill Automation to suspend a Request's workflow until a priority has been set on the request.|
:: Set the status that you want to suspend the workflow until that particular status has changed. An example would be to set this as ''Resolved'' so when it changes from this status to either ''Open'' or ''Closed'' you can branch using a decision node to manage the process for the new status. If  using a decision node and custom expression ensure you use '''Status.Open''' Etc in your condition rather than just '''Open'''.
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
:* '''Expire Period'''
+
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
:: The ''Expire Period'' will automatically come out of the suspend mode and progress the workflow.  If there are no changes to the ''From Status'' within the expiry period a decision node can be used to include steps in your process when this occurs. This could be used for automatic closure of the request as the result of the Expiry Period being met.
+
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continueThis is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:bp_suspend_wait_status_change.png|600px]]
+
{{BPMAutomation|Wait_for_Request_Category|Wait for Request Category|
</div>
+
[[File:bpmwaitforrequestcategory.png|thumb|link=https://wiki.hornbill.com/images/b/b2/Bpmwaitforrequestcategory.png]]|
</div>
+
Use this Hornbill Automation to suspend a Request's workflow until a category has been set on the request.|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Wait_for_Request_Resolution|Wait for Request Resolution|
* Wait for Request Summary
+
[[File:bpmwaitforrequestresolution.png|thumb|link=https://wiki.hornbill.com/images/f/f5/Bpmwaitforrequestresolution.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until the request status has been set to resolved.|
::Requests > Suspend > Wait for Request Summary
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:Suspend_Request_Summary.png|600px]]
+
{{BPMAutomation|Wait_for_Request_Site|Wait for Request Site|
</div>
+
[[File:bpmwaitforrequestsite.png|thumb|link=https://wiki.hornbill.com/images/4/4b/Bpmwaitforrequestsite.png]]|
</div>
+
Use this Hornbill Automation to suspend a Request's workflow until a site has been linked to the request.|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Wait_for_Status_Change|Wait for Status Change|
* Wait for Request Team
+
[[File:bpmwaitforstatuschange.png|thumb|link=https://wiki.hornbill.com/images/0/04/Bpmwaitforstatuschange.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until the status of the request has changed from one status to another.|
::Requests > Suspend > Wait for Request Team
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|From Status|The workflow will only continue when the request is changed from this status}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:at_requests_suspend_waitForRequestTeam.png|600px]]
+
{{BPMAutomation|Wait_for_Request_Summary|Wait for Request Summary|
</div>
+
[[File:bpmwaitforrequestsummary.png|thumb|link=https://wiki.hornbill.com/images/4/47/Bpmwaitforrequestsummary.png]]|
</div>
+
Use this Hornbill Automation to suspend a Request's workflow until the summary has bee set against the request|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
+
{{BPMAutomation|Wait_for_Request_Team|Wait for Request Team|
* Wait for Request Update
+
[[File:bpmwaitforrequestteam.png|thumb|link=https://wiki.hornbill.com/images/4/46/Bpmwaitforrequestteam.png]]|
<div class="mw-collapsible-content">
+
Use this Hornbill Automation to suspend a Request's workflow until an team has been assigned to the request.|
::Requests > Suspend > Wait for Request Update
+
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
[[File:Suspend_Request_Update.png|600px]]
+
{{BPMAutomation|Wait_for_Request_Update|Wait for Request Update|
</div>
+
[[File:bpmwaitforrequestupdate.png|thumb|link=https://wiki.hornbill.com/images/c/c2/Bpmwaitforrequestupdate.png]]|
</div>
+
Use this Hornbill Automation to suspend a Request's workflow until an update, using the Update Action has been added to the request.|
 +
{{bullet1|Request Id|In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request}}
 +
{{bullet1|Action Focus|Sets the Action Item on a request that will be in focus.}}
 +
{{bullet1|Expire Period|The length of time to wait until the node expires and the workflow will automatically continue.  This is based on the Working Time Calendar defined in the setting '''guest.app.timer.defaultCalendar'''.}}
 +
{{bullet1|Add Notice|Select Yes to add a notice to the top of the request}}
 +
{{bullet1|Notice Type|The type of notice (Alert or Information). The default value is "Information".}}
 +
{{bullet1|Notice Text|The text that will be displayed. This has a limit of 255 characters}}
 +
{{bullet1|Notice Visibility|The visibility of the notice (Portals | Service Desk | Both). The default value is "Service Desk"}}
 +
}}
  
====Update Request====
+
===Update Request===
  
 
Use the Update Request node to automatically update the values of specific Request attributes at any stage in the process.  Examples being updating the Logging or Closing Categories of a Request.
 
Use the Update Request node to automatically update the values of specific Request attributes at any stage in the process.  Examples being updating the Logging or Closing Categories of a Request.
Line 1,862: Line 2,738:
 
Specify the logging category which will associated to the request.  This is typically used where the category of the request is known based on the business process being associated against a specific request catalog item, and as such the analyst is not required to make a manual assessment and categorisation.  
 
Specify the logging category which will associated to the request.  This is typically used where the category of the request is known based on the business process being associated against a specific request catalog item, and as such the analyst is not required to make a manual assessment and categorisation.  
  
[[File:Logging_Category.png|600px]]
+
[[File:updateRequestCategoryNew.jpg|700px]]
 +
:* '''Category''' - This option will prompt you to select a Category. If supplied, "Category (From Variable)" option will be ignored.
 +
:* '''Category (From Variable)''' - This option requires you to provide the Id of a Category (Value of h_id column in h_sys_profiles table). This can be used when a field that is driven by a Simple List made up of Categories is set up in a Progressive Capture. This option should only be supplied if "Category" option is not set.
 
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
Line 1,877: Line 2,755:
  
 
[[File:Closure_Category.png|600px]]
 
[[File:Closure_Category.png|600px]]
 +
:* '''Category''' - This option will prompt you to select a Category. If supplied, "Category (From Variable)" option will be ignored.
 +
:* '''Category (From Variable)''' - This option requires you to provide the Id of a Category (Value of h_id column in h_sys_profiles table). This can be used when a field that is driven by a Simple List made up of Categories is set up in a Progressive Capture. This option should only be supplied if "Category" option is not set.
 
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
Line 1,882: Line 2,762:
 
</div>
 
</div>
 
</div>
 
</div>
 +
  
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
* Custom Fields
+
<div id="UpdateCustomer"></div>
 +
* Update Customer
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
::Requests > Update Request > Custom Fields
+
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 +
::{|
 +
|- valign="top"
 +
|style="width:700px"|
 +
[[File:bpmupdatecustomer.png|thumb|Update Customer|link=https://wiki.hornbill.com/images/f/f5/Bpmupdatecustomer.png]]
 +
==== Update Customer ====
 +
Use this node to automatically add or update a request with a Customer
 +
==== Options ====
 +
{{Bullet1|Request ID|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{Bullet1|Co-Worker|Select a Co-worker that will be used as the customer of the request}}
 +
{{Bullet1|Contact|Select a Contact that will be used as the customer of the request}}
 +
{{Bullet1|Co-worker (From Variable)|Use a variable to populated the customer, based on a Co-worker ID}}
 +
{{Bullet1|Contact (From Variable)|Use a variable to populate the customer, based on a contact ID}}
 +
{{Bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{Bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{Bullet1|Visibility|Choose what level of visibility will be automatically applied to this update. Choosing anything other than Customer will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
|}
 +
</div>
 +
</div>
 +
</div>
  
This provides the ability to update any or all of the custom fields of a request.  The input box is single line only and values should be restricted to 255 characters which is the defined max length for all custom fields.  When populating custom fields please pay attention to the type of value you are populating, and ensure this is compatible with the type of field you have specified for the corresponding custom field in the request type and service form designer in the user interface.  
+
{{BPMAutomation|updateCustomFields|Update Custom Fields|
 +
[[File:updateCustomFields.png|thumb|link=https://wiki.hornbill.com/images/4/49/UpdateCustomFields.png]]|
 +
This provides the ability to update any or all of the custom fields of a request.  The input box is single line only and values should be restricted to 255 characters which is the defined max length for all custom fields.  When populating custom fields please pay attention to the type of value you are populating, and ensure this is compatible with the type of field you have specified for the corresponding custom field in the request type and service form designer in the user interface.|
 +
{{bullet1|Custom Field A - T & Custom Field 21 to 40|Populate the required custom field(s) with the value(s) that you wish to update the custom field(s) with. This can be text and/or attributes from the Variable Picker.}}
 +
{{bullet1|Append Text|This determines if the supplied value of the custom field, should append any existing value of the custom field. By default this is set to replace any existing value, with the value defined here.}}
 +
{{bullet1|Format Checkbox Value|This option determines whether the value from a checkbox (i.e. Outcome Field from a Human Task) is formatted to remove the square brackets and double quotes. By default, this option is set to "No".}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action.}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action.}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
}}
  
[[File:Update_Request_Custom_Fields.png|600px]]
 
:* '''Custom Field a - q''' - populate the required custom fields with the values you wish to update the custom fields with.  This can be with both text, and or request / question / task variables.
 
:* '''Append Text''' - This determines if the supplied value of the custom field, should append any existing value of the custom field. By default this is set to replace any existing value, with the value defined here.
 
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
 
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.
 
</div>
 
</div>
 
  
<!-- **************************************************** START OF UPDATE DETAILS ************************************************************** -->
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px" id="Details">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px" id="Details">
 
* Details
 
* Details
Line 1,926: Line 2,827:
 
</div>
 
</div>
 
</div>
 
</div>
<!-- **************************************************** END OF UPDATE DETAILS ************************************************************** -->
 
  
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
Line 1,945: Line 2,845:
 
</div>
 
</div>
  
<!-- **************************************************** START OF FIRST TIME FIX ************************************************************** -->
+
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px" id="Details">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px" id="Details">
 +
<div id="FirstTimeFix"></div>
 
* First Time Fix
 
* First Time Fix
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
Line 1,976: Line 2,877:
 
</div>
 
</div>
 
</div>
 
</div>
<!-- **************************************************** END OF FIRST TIME FIX ************************************************************** -->
+
 
  
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
Line 1,991: Line 2,892:
 
:* '''On Hold Period'''
 
:* '''On Hold Period'''
 
:: Enter the number of Years, Months, Days, Hours, and Minutes that the request will be on hold for.
 
:: Enter the number of Years, Months, Days, Hours, and Minutes that the request will be on hold for.
:* '''On Hold Period (ISO Timestamp)'''
+
:* '''On Hold Period Apply Working Time Calendar'''
:: Using the [[Utilities Integration Bridge|Utility BPM Integration Call]], pass a date using a variable to this option.
+
:: Set this to ''Yes'' to apply the WTC that is associated to the request to be used.  This will ensure that the request comes off hold during work hours.
 
:* '''Reason'''
 
:* '''Reason'''
 
:: Include information that describes the reason for the request being placed on-hold.
 
:: Include information that describes the reason for the request being placed on-hold.
Line 2,037: Line 2,938:
 
</div>
 
</div>
 
</div>
 
</div>
 +
 +
{{BPMAutomation|Update_Service|Service|
 +
[[File:bpm_update_service.png|thumb|link=https://wiki.hornbill.com/images/1/13/Bpm_update_service.png]]|
 +
Use this Hornbill Automation to change the currently assigned Service and Request Catalog Item. This can be used in conjunction with assign operations to move a request that has been raised under the wrong service and team.|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM. This should be set to Auto}}
 +
{{bullet1|Service|Select the Service that will be associated to the request}}
 +
{{bullet1|Catalog Item|Select the Request Catalog Item that will be associated to the request}}
 +
{{bullet1|Assess BPM|When set to 'Yes', the Request's process will be cancelled and a new instance of the new Service's or Catalog's process will be spawned. The process will not be cancelled if the new Service or Catalog's process is the same as the Request's current process.}}
 +
{{bullet1|Update Timeline|Include a Timeline update on the request when this automation has completed}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update. Choosing anything other than Customer will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals}}
 +
}}
 +
  
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
Line 2,049: Line 2,963:
 
</div>
 
</div>
 
</div>
 
</div>
 +
  
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 +
<div id="UpdateSite"></div>
 
* Site
 
* Site
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
::Requests > Update Request > Site
+
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 +
::{|
 +
|- valign="top"
 +
|style="width:700px"|
 +
[[File:bpmupdatesite.png|thumb|link=https://wiki.hornbill.com/images/0/03/Bpmupdatesite.png|Update Site]]
  
Use this node to set the '''Site''' of the request.  The configuration options include pre-defining the '''Site''' from the full list of Sites, which have been created in Organisational structure, and if the setting of the '''Site''' should be marked on the timeline of the request.
+
==== Site ====
 
+
Use this node to set the ''Site'' of the request.  The configuration options include pre-defining the ''Site'' from the full list of Sites, which have been created in Organisational structure or from a variable.
[[File:Update_Site.png|600px]]
+
==== Options ====
:* '''System Timeline Update''' - Select if the default system text will be added to the timeline for this action
+
:* '''Request ID'''
:* '''Manual Timeline Update''' - Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
+
:: In almost all cases, this should be set to ''Auto'' which will take the global variable for the request ID that the BPM is associated and apply all selected options to this request.
:* '''Visibility''' - Choose what level of visibility will be automatically applied to this update.  Choosing anything other than '''Customer''' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.  
+
:* '''Site'''
 +
:: Select from the list of available sites as defined under the Organizational Data in Administration
 +
:* '''Site ID (From Variable)'''
 +
:: Use a variable that has been populated from Progressive Capture to set the Site.  The Group Picker option on the Custom Progressive Capture form will be the most common way of providing the Site ID in a variable.
 +
:* '''System Timeline Update'''  
 +
:: Select if the default system text will be added to the timeline for this action
 +
:* '''Manual Timeline Update'''  
 +
::Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action
 +
:* '''Visibility'''
 +
:: Choose what level of visibility will be automatically applied to this update.  Choosing anything other than ''Customer'' will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.  
 +
|}
 +
</div>
 
</div>
 
</div>
 
</div>
 
</div>
Line 2,132: Line 3,063:
 
</div>
 
</div>
  
====Request Timers====
+
 
 +
===Request Timers===
  
 
Use the Request Timer nodes at any stage in the process to either start or stop the Response and or Resolution timers.  It is not a perquisite to have to use any timers within processes or to have to use both Response and Resolution timers when timers are used.
 
Use the Request Timer nodes at any stage in the process to either start or stop the Response and or Resolution timers.  It is not a perquisite to have to use any timers within processes or to have to use both Response and Resolution timers when timers are used.
 +
 +
There are some settings that control the default behaviour of the Service Level Timers.  The settings provided to pause or stop the resolution timer when resolving a request are as follows:
 +
 +
:* ''app.request.pauseResolutionTimerOnResolve''  (Default OFF)
 +
:* ''app.request.resumeResolutionTimerOnReopen''  (Default OFF)
 +
:* ''app.request.stopResolutionTimerOnResolve''    (Default ON) 
 +
:* ''app.request.stopResolutionTimerOnClose''      (Default OFF)
 +
<br>
 +
{{bullet1|Using settings to control resolution timers|You should choose the relevant settings to meet your needs, but note that app.request.stopResolutionTimerOnResolve will take precedence over app.request.pauseResolutionTimerOnResolve so ensure only the one you want to use is enabled.}}
 +
 +
{{bullet1|Using BPM nodes to control resolution timers|If you are using this BPM node to control resolution timers the four settings above should all be turned off; If any settings are enabled then they will take precedence over BPM actions. To enable pause/resume of a resolved request you can add the Timer > Pause Resolution Timer or Timer > Resume Resolution Timer BPM nodes as required in your BPM process.}}
 +
<br>
  
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
Line 2,179: Line 3,123:
 
</div>
 
</div>
 
</div>
 
</div>
 +
 +
{{BPMAutomation|Pause_Resolution_Timer|Pause Resolution Timer|
 +
[[File:Pause_Resolution_Timer.png|thumb|link=https://wiki.hornbill.com/images/5/58/Pause_Resolution_Timer.png]]|
 +
Use this Hornbill Automation to pause the currently running Resolution Timer.  This is particularly useful in 2 stage closers where the timer can be paused during the resolution stage and then resumed if the request is reopened|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
}}
 +
 +
{{BPMAutomation|Resume_Resolution_Timer|Resume Resolution Timer|
 +
[[File:Resume_Resolution_Timer.png|thumb|link=https://wiki.hornbill.com/images/c/c0/Resume_Resolution_Timer.png]]|
 +
Use this Hornbill Automation to resume Resolution Timer that has been paused.  This is particularly useful in 2 stage closers where the timer can be paused during the resolution stage and then resumed if the request is reopened|
 +
{{bullet1|Request Id|This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''}}
 +
}}
 +
 +
==Services==
 +
 +
Operations specific to services related to the request service
 +
 +
{{BPMAutomation|Update_Realated_Services|Update Related Services|
 +
[[File:Update_Related_Services_BPM.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmaddcommenttoboard.png]]|
 +
Use this node to update the status of services related to a request at the required stage in a process, this is different from the service the request is logged against|
 +
{{bullet1|RequestId|This is an automatic option and should be set to Auto}}
 +
{{bullet1|Relationship Type|Select which services to update the status of, based on their relationship type to the request service}}
 +
{{bullet1|Status|The Status to set the related services too}}
 +
{{bullet1|Status Message|Any message to be visible alongside the Status of the related services}}
 +
{{bullet1|System Timeline Update|Select if the default system text will be added to the timeline for this action}}
 +
{{bullet1|Manual Timeline Update|Select Yes to override the default System timeline Text, and add your own text which will appear in the timeline update for this action}}
 +
{{bullet1|Visibility|Choose what level of visibility will be automatically applied to this update. Choosing anything other than Customer will result in the customer not seeing the update in the timeline of their requests on the Service or Customer Portals.}}
 +
 +
}}
 +
 +
==Assets==
 +
 +
Automations specific to an asset entity which can be used as part of Auto Tasks on an asset.
 +
 +
{{BPMAutomation|Get_Asset_Information|Get Asset Information|
 +
[[File:Get_Asset_Information_BPM.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmgeetassetinfo.png]]|
 +
Use this node to get information about a specified asset.|
 +
{{bullet1|Asset Id|This is an automatic option and should be set to Auto when used with an asset entity.}}
 +
 +
}}
  
 
[[Category:Service Manager]]
 
[[Category:Service Manager]]
 +
-->
 +
[[Category:HDOC]]
 +
<!-- http://127.0.0.1:3000/service-manager-config/customize/bpm/service-manager-business-processes -->

Latest revision as of 20:34, 8 May 2024

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

Service Manager Workflow