---
description: >-
  Workflow templates are pre-built Request Details windows with predefined field
  values. They include prebuilt workflows, featuring the tasks and approvals
  that will execute when a request is created fr
---

# Workflow Template Administration

These can be used to define and implement a range of repeatable defined processes, such as implementing Standard Changes, developing Service Level Requirements, or managing the production of complex documents such as Service Quality or Improvement Plans.

Each request for change created in ASM Core is based on a workflow template. To create a request without any details, simply create a workflow template without any information on it.

You can also create component workflows, which are workflows that are generic across a number of workflow templates.

Workflow templates can be used for:

* Requests logged by a user through the Self Service Portal. Any request submitted by a user from the Portal results in a request automatically logged in the main application based on the selected workflow template.
* Requests logged as a result of an event or Inbound Action.

## Viewing Workflow Templates <a href="#viewing" id="viewing"></a>

{% hint style="info" %}
### Before you start

You must have **Template Security** selected in the Template tab of your **Workflow Management** security role.
{% endhint %}

1.  Select ≡ > **Admin** > **Workflow Template**.

    The **Workflow Template Administration** window appears. Use the filter parameters displayed:

<table><thead><tr><th width="257">Select Workflow Process</th><th>If you have several workflow processes, use the drop-down list to select the one you wish to view.</th></tr></thead><tbody><tr><td>Display</td><td><p>Use the options to select the templates you want to display.</p><p><strong>All Templates</strong> lists all of the templates that have been created on your system. This is the default option.</p><p><strong>Templates by Type</strong> shows templates based on a selected request type and activates the list and options below. Use the button to display the drop-down list, and select the request type.</p><p>Select the <strong>Hunting</strong> options:</p><table><thead><tr><th>None</th><th>This is the default setting. In this case, the templates that have been created with the specific request type selected are displayed.</th></tr></thead><tbody><tr><td>Up</td><td>When you select a type, the system displays the names of any templates created with that type, plus any ‘parent templates’; i.e. templates created from a type of which the current stencil is a sub-type.</td></tr><tr><td>Down</td><td>When you select a type, the system displays the names of any templates created with that type, plus any ‘child templates’; i.e., templates created from a sub-type of the current type.</td></tr></tbody></table></td></tr><tr><td>Show in List</td><td><p>To view current templates, select <strong>Active Templates</strong>. Select <strong>Deleted Templates</strong> to see deleted templates.</p><p>You cannot create requests from deleted templates.</p></td></tr><tr><td>Show List by</td><td>Select <strong>Workflow</strong> to display the workflow templates, or <strong>Component Workflow</strong> to display the Component Workflow templates.</td></tr></tbody></table>

From here you can create, update, delete or clone templates.

## Creating a Workflow Template <a href="#creating" id="creating"></a>

You can create a template for a specific workflow process with predefined tasks. The templates can be based on a request type and workflow process.

Depending upon your organization’s requirements, you can create a very detailed template with task dependencies and component workflows or just a simple template without any tasks, budgets and more. You can create a request without any details by creating a template and leaving the details blank. You can select extension fields defined through ASM Designer as an item for which to create a Condition or Action for a Conditional Branching Task within a Workflow Template.

{% hint style="info" %}
### Before you start

You must have **Template Admin** selected in the Requests tab of your **Workflow Management security role**.
{% endhint %}

Workflow templates can be created in one of the following ways:

* **creating a new template** using the **Workflow Template Administration window** (as explained below)

{% @arcade/embed flowId="pFUYwAdeMvYBaFRfwBpF" url="https://app.arcade.software/share/pFUYwAdeMvYBaFRfwBpF" %}

* **cloning it** using Workflow Template Administration, and then updating the details
* by **converting an existing request into a workflow template**. To do this, you search for a saved request, and in the **Request Search** browse table, select the required request and then select  from the toolbar.
  1. Select **Admin** > **Workflow Template**.
  2. Select **New**. The **Workflow Templates** or **Workflow Components** dialog box appears, depending on your selection in the previous step.
  3. Type a relevant name for the workflow template or workflow component in the **Workflow Template Name** field.
  4. Select **OK**. The **Workflow Template \<name> Details** window appears. This window is similar to the **Request Details** window.

{% hint style="info" %}
**You can now specify information on all fields as you would in a request**, such as link CMDB items, create tasks, set action dates for the tasks, create task dependencies, specify task assignment, set agreements for the requests and tasks created from this template, and finally specify request assignment.&#x20;

**In the Dependency Diagram, you can link tasks to form a sequence or in parallel**, simply by joining multiple tasks to a single predecessor or joining several tasks sequentially. Your workflow template can be as detailed or as generic as you want it to be. You can even create a blank template for a workflow process.&#x20;

\*\*When you open a task in the dependency diagram on a template or a workflow component, the task opens in Review mode.
{% endhint %}

5. Insert any workflow components required by displaying the dependency diagram, and then selecting the component workflow icon.  All available workflow components are listed. Select the one you want to insert, and click **OK**.  See also:

{% embed url="https://docs.alemba.com/asm/setup-and-configure-asm/designing-configuring-your-system/workflow-template-administration/steps-for-workflow-request-template-creation/managing-tasks-adding-tasks-to-the-dependency-diagram/task-types-in-the-task-palette" %}

{% embed url="https://docs.alemba.com/asm/setup-and-configure-asm/designing-configuring-your-system/workflow-template-administration/steps-for-workflow-request-template-creation/managing-tasks-adding-tasks-to-the-dependency-diagram" %}

5. Any tasks you create for a workflow template will have an additional field on the **Task Details** window: <mark style="color:red;">**Request Status on Completion**</mark>, where you should update the request with the specified status once the current task is closed.&#x20;

{% hint style="warning" %}
Some features are not available from the workflow template details, such as the ability to perform asset management transactions, you will need a **Manage CMDB task** for this action.
{% endhint %}

## Renaming a Workflow Template or Moving a Template to a different Workflow Process

You can rename workflow templates or move them to other process folders.

To rename a template:

1. Select **Admin** > **Workflow Template**.
2. Locate the template you wish to move or rename.
3. Select ![](https://content.gitbook.com/content/nJaXUpCs46xyHtlQSUZo/blobs/vWKcSyUM9fqAQeUcuviA/image.png)
4. The **Workflow Templates** dialog box appears. Here you can change the Template title and assigned Workflow Process:

<figure><img src="https://content.gitbook.com/content/nJaXUpCs46xyHtlQSUZo/blobs/M1KNHUF2ppcnFzqmm6sC/Screenshot%202023-08-23%20at%2012.21.14%20PM.png" alt=""><figcaption></figcaption></figure>

## Selecting the Screen Set to Use With Your Workflow

To set the Self Service Portal submission form to use when Users log requests using this workflow template through the Self Service Portal, select the **Screen Set** explorer option.

{% @arcade/embed flowId="bBRkAQfMqA1UASBpcfuK" url="https://app.arcade.software/share/bBRkAQfMqA1UASBpcfuK" %}

## Assigning Workflow Templates

{% hint style="danger" %}
If you do not assign the template to a governing body (Workflow Management Group) the SSP will display a "Forward to" box on the submission screen and the user submitting the request will be forced to choose where to send the request. &#x20;

The request should be assigned to the group with ultimate responsibility for assuring the request is fulfilled.  This may not necessarily be the group that will do the work - those assignments are handled on the tasks themselves.

Additionally, if you do not assign a task, the workflow will stall on that task and fail to progress. &#x20;

**Best Practice:**  All workflows and tasks must be assigned.
{% endhint %}

When assigning a task from a workflow template (or forwarding an inactive task), the request manager can specify multiple recipients for the task. When the task is activated as part of a request, ASM Core will automatically create a copy of the task and forward it to each recipient.&#x20;

When specifying recipients, you can also select field values, such as Logging Analyst, rather than specifying particular analysts or groups.

Once a task assigned to multiple recipients is activated, cloned and assigned to each analyst, the original task from which the cloned tasks were created no longer exists. Therefore, you can only forward active tasks to single recipients. If additional people need to be assigned the task after it has already activated, request managers can manually add these tasks to the workflow.

If you have reached the **Workflow Template Forward** window by clicking the **Assign** button on a template, an **Unassign** button appears on the window after the request is assigned to an Analyst. To unassign a request, select the current managing analyst/group from the list and click **Unassign** to remove them as the default manager for this template.

## Prevent Analysts from Taking Action on (Taking Over) Requests

It may seem counterintuitive to assign a request template to a group and then prevent them taking action on it, but that is exactly what you should do in _**most**_ cases.

**The request is not a work item in and of itself, it is rather a container that holds the work items and aggregates the information gathered from those items (tasks, approvals, etc...) onto the request.  We don't actually work a request; we work its tasks.  There is normally never a need to action a request.**

It is generally best not to take action on a request, because we work them through their tasks.  When you allow analysts to take action on requests, they lock (or sometimes even close) the request and prevent the automation from executing or moving forward as it should.  They also tend to ignore the tasks assigned to them which prevents the workflow from progressing as it was designed.&#x20;

{% hint style="info" %}
**Best Practice:** Uncheck the **Request Take Over** from all but Manager and System Admin security roles.

This will prevent analysts taking over requests and therefore locking them.  It will force them to work the request through the task tickets instead and ensure your workflows progress as they were designed.
{% endhint %}

{% @arcade/embed flowId="el9jg5lyJXYrBgImz4qL" url="https://app.arcade.software/share/el9jg5lyJXYrBgImz4qL" %}

## Cloning a Workflow Template <a href="#cloning" id="cloning"></a>

If you wish to create a template that is very similar to one that already exists, you can clone the existing template and then update it to make the necessary changes.

{% hint style="info" %}
### Before you start

You must have **Template Admin** selected in the Requests tab of your **Workflow Management security role**.
{% endhint %}

1. View the templates.
2. Select the template you want to clone from the list.
3. Select **Clone**.
4. In the **Workflow Name** dialog box, type the name for the new template. You can also change the workflow process in this window.
5. Select **OK**.
6. The **Workflow Template Details** window appears. Make the necessary changes.
7. You must click **"Save"** to save your new template.

## Deleting a Workflow Template or Component Workflow <a href="#deleting" id="deleting"></a>

You can delete workflow templates or component workflows on the Workflow Template Administration window.

1. View your templates or components by name or type.
2. Select the workflow template or component.
3. Select **Delete**. A message appears prompting you to confirm the deletion.
4. If there are existing IPK Request Workflows that are using the template you are deleting, you will be prompted with a warning message. If you choose to continue deleting the template, any IPK Request Workflows using this template will then have an asterisk, ‘\*’, succeeding its name.
5. Confirm the deletion.
