| Table of Contents | ||||
|---|---|---|---|---|
|
...
Select a "Start Event" from the list of events. The Start Event is the purpose for the Escalation and, when triggered, begins the Escalation's life cycle. For example, a User could select Service Desk Workflow Assigned as the Start Event. In this instance, the Escalation process would begin whenever an SD item's Workflow is assigned to one or more Workers. Notice that the list of possible events includes both System events, those delivered as part of PCR-360 as well as custom Sequence Events which may be created to supplement the base events.
...
In addition to specifying a series of actions for an Escalation, Users want to restrict the conditions under which those actions are executed. Criteria act as a filter (think of the Grid's Search and Filter mechanisms) that prevent an Escalation from beginning unless the data provided matches its conditions.
...
Set it as the Event that generates Notifications. Just as some System Events can automatically generate Notifications (alerting a Worker they have been assigned to a Service Order, sending an Administrator notice when a Purchase Order is approved, etc.), Sequence Events can do the same, utilizing the power of Criteria to generate the Notification to specific conditions. For instance, John Doe requested he not be sent Workflow Assignment emails because he has the Service Desk's "Assigned Workflow" Grid open with an auto-refresh Perspective so he can see new assignments as they come in. Set them as Abort Events on other Escalations. Using System Events to abort an Escalation aborts that Escalation regardless of the situation which is often desirable. However, using Criteria gives control over the conditions under which the Sequence Event is generated so the targeted Escalation only aborts under the defined Criteria. In this use case, the chain of events looks like this:
...
- A customer emails the Service Desk, and the Inquiry is converted to an Order. The initial Workflow is assigned to Mary.
- The assignment begins an Escalation ('Workflow Assignment – Action Required') that sends Mary an email.
- A second Sequence waits 30 minutes before sending a message to her Workgroup Manager.
- The Escalation already has "Service Desk Item Viewed" selected as an Abort Event. Once anyone opens the Incident, the Escalation stops, and her manager does not get an email.
- Ten minutes after the Workflow was assigned, the Requester emails again: Please cancel the original request.
- The CSR opens the Service Desk item and changes its status to "Void".
- The actual results:
- Mary's manager doesn't get an email because the CSR opened the Incident, not Mary.
- The Escalation that would send an email to her Manager should be aborted.
- Mary should be notified of the Voided item (but only when it's been VOIDED, not just that its status changed).
...
Service Host REST Escalations are Specialized Escalation Sequences that can be used to interface with outside data sources. Read more here: Exchanging Data With External Data Stores.
Setting Up Escalations To Utilize The Service Host
...
- Go to Admin > Escalations / Notifications > Escalations.
- Open a new Escalation.
- Select a Start Event before adding Sequences. This is to help the Sequence form know what 'Data Variables' it can use. Select "New Estimate Created" as the Start Event.
- Open a new Sequence on the Sequence tab. Set the Sequence # "10", and Time To Wait "0m".
- Select "Service Host REST Escalation" from the Type list.
- When the form updates, choose the Service Host to use ("Sample REST Host" in the example above).
- Set the "Host API Path". This will be the part of the URL that differs from one command to another.
- If the API uses a query string (as described above), do not include it in the Host API Path.
- If there is no additional path to the API URL, enter "/" as the API Path value.
- Set the "Request Type" to match the type of request to make.
- POST (Create)
- PATCH (Change)
- PUT (Replace)
- DELETE
- In the "API Options" use the JSON editor to define the request to be sent to the API. This is a map of field names the API expects with values from PCR-360.
Compare this sample to the "Add Order" command from our Service Host example:
Users can also use items from the "Available Template Data" list to append variable placeholders to the Value to send. These variables (formatted as ##VARIABLE_NAME##) will be replaced with the actual value from the Event when the Sequence is executed. The selected item from the list will always be inserted at the current cursor position in the editor, but can be cut/paste them to other positions in the text as needed. - UDFs are also supported in the Event Variables that can be added to the API Value. When selecting one, there will be a variable name like ##UDF_12345## instead of the label. This ensures the unique UDF ID is used for looking up the correct value to replace the variable with. Should we use a label, and the label changes or contains errant characters, the variable substitution would fail.
- Save the Sequence and close the Sequence form. To use this Escalation to perform other tasks, including other calls to the same or other APIs, set up separate Sequences for those actions.
- Click the Criteria tab and open a new Criteria. However, notice UDFs that apply to the data object the Start Event is generated from are available in the list of data Criteria to can check before the Escalation begins its work. There are also additional Comparison types to choose from for better refinement of acceptable data conditions.
- Save a Criteria if desired.
- Finally, save the new Escalation.
With this sample, when a new Estimate is created in Service Desk, this Escalation will check any Criteria set in place. If ALL of the criteria pass, the Sequence(s) will execute, sending data to the API set up in Service Hosts.
Service Host SOAP Escalation Setup
This is a sample Escalation that will use the Service Host set up previously. It will execute using the "New Service Request Created" Event. Add a single Sequence and a single Criteria that must match for the Escalation to execute at all.
- Go to Admin > Escalations / Notifications > Escalations
- Open a new Escalation.
- Select a Start Event before adding Sequences. This is to help the Sequence form know what data variables it can use. Select "New Service Request Created" as the Start Event.
- Open a new Sequence on the Sequence tab. Set the Sequence # "10", and Time To Wait "0m".
- Select "Service Host SOAP Escalation" from the Type list.
- When the form updates, choose the Service Host to use ("Sample REST Host" in the example above).
- Set the "Target Host". This will define the Service Host that is going to be interacting with this Escalation.
- Set the "Target Method". This will define what endpoint the Escalation is going to be sent to. The expected fields to be sent will be automatically populated.
- Fill in the "API Options" to be sent to the endpoint.
- Save the Sequence and close the Sequence form. To use this Escalation to perform other tasks, including other calls to the same or other endpoints, set up separate Sequences for those actions.
- Click the Criteria tab and open a new Criteria. This operates the same as previous versions. Notice that UDFs which apply to the data object the Start Event is generated from can be found in the list of data Criteria that can be checked before the Escalation begins its work. There are also additional Comparison types to choose from for better refinement of acceptable data conditions.
- Save a Criteria if desired.
- Finally, save the new Escalation.
With this sample, when a new Service Request is created in Service Desk, this Escalation will check any Criteria set in place. If ALL of the Criteria pass, the Sequence(s) will execute, sending data to the endpoint set up in Service Hosts.
...
A User can review the results of all Escalation Sequences here. Double-click a Log item to open it, the result data is laid out as a JSON object with various information about the Sequence execution. For an API Sequence, "curlResponse", "curlInfo", and "curlError" message keys are present. These can help identify problems in the setup of the Service Host or Escalations, or indicate successful execution of sending data to the API. Currently, no processing is done to the response data sent back from the API. It is simply logged here for reference.
...