This documentation supports the 25.1 version of BMC Helix Change Management.To view an earlier version, select the version from the Product version menu.

Creating and modifying tasks


A task is a unit of work that needs to be completed as a step in resolving a change request. If resolving a change request requires more then one step or action, you can create tasks. Dividing the change request into separate tasks helps you to better manage and monitor the change request as it moves toward resolution.

After you add tasks to a request, if for some reason the request is not saved or updated, the tasks related to the request are saved as orphaned tasks in the system.

Important

The SYS:CLN:TA@00:05-StartCleanup escalation, which is run every 24 hours, deletes any task that is in the Inactive state longer than a defined retention period, or that does not have any parent record associated with it.



Before you begin

To add tasks, you must have the following requisite permissions:

  • You must have the User or Master permissions for the parent ticket type to add a task to it or modify an existing task.
    For example, to add a task to an incident, you must be an Incident User or Incident Master.
  • You must also belong to the support group assigned to that ticket.


To add a task

The following video explains the process of adding tasks to a ticket.



icon_play.pnghttps://youtu.be/pxGMEGHsDOk

  1. Open the change request to which you need to add the task.
  2. On the Tasks tab, select Add Task.
  3. Select one of the following choices. 
    • From scratch—Select this option to add a task from scratch, or to add an ad hoc task. For an ad hoc task, provide a task title and description.
    • From template—Select this option to add a task from a single task template or task group template. Problem investigations and known errors do not support the use of templates.
      From a template in the Progressive Web App work order and incident screens, you can add multiple tasks to an incident or a work order ticket. If you add multiple tasks to a ticket, these tasks are assigned the same sequence number.

      image-2023-3-29_10-44-31.png

  4. (Optional) If you are using a template, you can search for a template by typing part of the name in the search field or filter the list of templates by using the following criteria:

     Type

    Activity type

    Single Tasks

    Manual—An action (for example, replacing a cable) is performed by a person

    Automatic—A predefined instruction is automatically executed by the task

    Task Groups

    Standard—A flow mechanism establishes how the tasks relate to each other

    Sequencing—Sequencing strictly specifies the order of tasks

    The tasks in a task group are displayed as a nested table in the Select task template pane. After you add a task group to a change request , the child tasks are not displayed under the task group. You must expand the task group to view the child tasks.
    image-2023-3-29_10-46-47.png

  5. Select the task that you want to add.
  6. Enter the mandatory details.
  7. Save the task.

To update a task

You can update the task to add or edit the following changes:

  • Schedule start and stop time
  • Attachments
  • Assignee assignment
  • Categorization

To assign a task

You can assign a task to the same person, to several people, or to a support group. The person or support group to whom the task is assigned is the task implementer. After a task or task group is assigned to a task implementer, the task implementer receives notifications to perform each of the assigned tasks. Task implementers log their progress as they complete each task. When a task is assigned to task implementer, it appears in the Ticket Console as separate ticket. When you open the task, it has a link back to the parent ticket, which you can open to see the full context of the task.

When you add or edit a task, you can assign it to yourself by using the Assign to me link. The Assign to me link is displayed only if you belong to the same support group to which the task is assigned. 

  • If you are part of only one support group, after you click the Assign to me link, the task is assigned to you without opening the Update Assignment pane.
  • If you are part of multiple support groups, when you click the Assign to me link, the Update Assignment pane is displayed on the task profile. The system searches for support groups to which you belong across all support companies, support organizations, and support groups. You must select one of the search results and save the selection. For more information, see Learning-about-Change-Management.

To reorder tasks

If the priority of planned tasks changes, you can change the task sequence as required. Task sequencing is available for change requests and activity (from release) tickets. When you include task group templates, task templates, or ad hoc tasks in a change request, they are automatically assigned a sequence number in the order in which you add them to the change request. More than one task can have the same sequence number. Tasks with the same sequence number are considered peers, which can be completed in any order.

  1. Open a change request.
  2. On the Tasks tab, change the value in the Sequence field of the task whose sequence you want to change.
  3. Click Save.

When reordering tasks, consider the following points:

  • A logged-in user who can add tasks can also change the sequence.
  • Only Staged tasks can be reordered.
  • A task that is a part of a task group cannot be moved outside the parent task group. However, the entire task group can be moved as a single unit.
  • A task cannot be moved above a task or task group that is closed or bypassed. 
  • Child tasks with the Standard task group cannot be moved. Only child tasks with the Sequencing task group can be moved internally.
  • Nested tasks are read-only and cannot be reordered. 
  • Nested task groups can be reordered, but tasks within nested task groups cannot be reordered.
  • For Change Management tasks, when task phasing is enabled, you cannot drag a task from its existing phase to another phase. The same rule applies to task groups.
  • When you move a staged task above an active task or task group, the sequence number of the staged task changes to the same as that of the active task and updates the status to Pending. For example, you drag a staged task above an active task with a sequence of 3, the status of the staged task is changed to Pending and its sequence is updated to 3.

To view the task flow

The task flow determines the sequence in which the task group templates and the task templates are generated at runtime.

Click Task Flow to see a read-only view of the task and task group that is related to the template. 
If the task group template contains other task group templates, these likely already have a flow established between the task group templates or task templates that they contain.

To view the task flow correctly in the PWA screens, the administrator must specify the base URL for the Mid Tier from the Default Web Path field on the AR System Administration: Server Information form. For more information, see Setting performance and security options.

Run phase-specific tasks in a change request  

In change requests, you can add tasks and specify the phase in which you want to run them. For more information about enabling task phase management, see Configuring-change-rules.


Instructions for classic interfaces

View instructions for Mid Tier

To modify a task

  1. Select a change record and under Details and Tasks, click Show Tasks.
  2. From the Assigned Tasks table in the Change Management console, select a task, and then click View.
  3. On the Task Management form, update the fields.
  4. Click the Work Info tab.
  5. Define a work info history entry for the task, and then click Save.

To close a task

Important

After a task is closed, it cannot be reopened.

  1. Select a change record and click Show Tasks under Details and Tasks.
  2. From the Assigned Tasks table in the Change Management console, select a task, and then click View.
  3. Click the Assignment tab, and then update the time that you have spent on the task.
  4. Click the Work Info tab, and then define an entry in the Work Info History field.
  5. At the top of the Task form, set the Status to Closed. 
  6. (Optional) Send an email notice to notify the task requester that the task is complete. Use this notification to ask the task requester to review and validate the work that you performed. 
  7. Select a status reason to describe how the task was closed, and then click Save.

To cancel a task

  1. In the Change form, open a change request.
  2. Click the Tasks tab.
  3. Select a task, and then click Cancel.
    The task status is set to Closed.

If the task has related configuration items (CIs), you can update any CI costs that are affected by this cancellation. For more information, see Relating-items-to-the-change-request.

To add financial information to a task

  1. Select a change record and click Show Tasks under Details and Tasks.
  2. From the Assigned Tasks table in the Change Management console, select a task, and then click View.
  3. Click the Financials tab, and then enter the budgeted estimated total time in hours.
  4. When you finish the task, enter the actual total time.
  5. Enter your calculation unit type; for example, flat rate.
  6. Save the change request. 
    The information is calculated and rolled up into the change request. 
    When you are assigned a task, you can contribute financial information for the task. However, you can only calculate charges for the change inside the change request.

To automatically copy parent categorization information to the task

You can create a task by using an existing task template, or add an ad hoc task to a record. For work orders, change records, and incident records, the Summary and Priority information on the task is prepopulated with the values of the parent record.

Additionally, you can also copy the categorization information from the parent record.

  1. Open the record and click the Tasks tab.
  2. Add an ad hoc task to the record manually or by using an existing task template.
    The Summary and Priority information is automatically populated with the values defined in the parent record.
  3. Add other task details on the Task form.
  4. On the task form, click the Copy Parent Data option to copy the parent categorization information to the task.

The task categorization values are populated with the values from the parent record.

To relate an ad hoc task to a change request

You can relate an ad hoc task to the change request. The status of these tasks can be Staged, Assigned, Pending, Work in Progress, or Closed. You can manually set the assignment for any task. Finally, if you close the task, you must select whether you are canceling the task or completing it as a success or failure.

When you relate an ad hoc task to a change request, the following information from the change request gets populated in the task.

  • Summary
  • Change location
  • Requester
  • Requested by
  1. Open the change request, and then click the Tasks tab.
  2. In the Request Type field, select Ad hoc, and then click Relate.
    The Task form is displayed with certain fields in the form completed with the data from the change request. You can click the Open link next to the Request ID field to open the parent change request.
  3. Enter the values in the following required fields:
    • Name—Enter a descriptive name of the task.
    • Summary—Enter a brief description of the task.
      The Type field is set by default to Manual when you create an ad hoc task.
  4. In the General tab, enter information about the company.
    The default value for the Company field matches the contents of the Change Location field in the Change form. Your task can be assigned to a different department or company.
  5. On the Requester tab, enter the information about the user who is defining the task (Requester) and the intended target of the task (Requested For).

    Important

    If you update the Requested For information after creating a task for the change request, the information is not updated in the task.

    However, any new tasks after the update, include the updated Requested For information.

    Some information is completed by default from the Requested By information of the change request. For example, the Requester Company field is automatically populated based on the default support group of the user who is creating the ad hoc task.

  6. In the Categorization tab, enter the information about the product and operational categorizations.
  7. In the Assignment/Dates tab, enter values in the following fields to assign the task:
    • Assignee Group—Optionally, select a task implementer group from the list.
    • Assignee—Optionally, select a task implementer from the list.
      The assignment engine automatically assigns the task when the task is generated, but you can override this assignment by manually assigning the task.

      Important

      When a task is assigned to a user, the task is staged, but the notification is not sent to the assignee until the task is activated.

      For more information about assignment configuration, see Configuring-task-assignments.

    • Scheduled Start Date—Optionally, enter an estimated start date.
    • Scheduled End Date—Optionally, enter an estimated end date.
      Set the Start Date and End Date to be different from the dates of the parent change request.
  8. In the Relationships tab, search for and then relate configuration items, LDAP objects, and software library items that are needed with this task.
    Additionally, you can execute any quick actions like Update Attributes, Explore CI, or get Related Relationships for the task.
  9. Click Save.
  10. To notify the assignee, reopen the task and in the Assignment tab, select the appropriate option from the Notify Assignee field.

Important

You must save and reopen the task to add Work Info details or attachments.


To automatically create tasks by relating a task template to a change request

You can relate a predefined task or task group template to the change request. The Calbro Services sample data includes a best practice task group and task templates that you can use.

In addition, special templates were created for the integration with BMC Configuration Automation for Clients (previously known as BMC Configuration Management). Other templates might have been added by your application administrator.

  1. Open the change request.
  2. Click the Tasks tab.
  3. Select Task Group Template or Task Template from the Request Type field, and then click Relate.
    All template types for all categories are listed in the Select Template dialog box.
  4. From the hierarchical list of tasks in the Select Template dialog box, select the appropriate template for the task that you are adding, and then click Relate.
    • To expand a category in the hierarchy, click the arrow beside the category name. 
    • The list of templates that you see in the Select Template dialog box represents all of the templates that are associated with the category that you selected earlier. For example, if you select Change Management System (the default top-level category for Change Management), the system displays all of the Change Management task templates in the list. If you highlight a second-level category, the list in the dialog box displays all of the templates available under that level.
  1. (Optional) You can filter the list by selecting the type or category of the template. You can also select both these options. To filter the list:
    1. Select the type of template:
      • With task group templates, select Standard or Sequencing.
      • With task templates, select Manual, Automatic, or ALL.
    2. (Optional) From the Category list, select which application the task belongs to, for example, Change Management System.
      The available task groups or tasks for that selection appear in the list. The categorization of the change request determines which list items appear.
  2. (Optional) Click View to see more details about the task group or task template.
  3. If a relevant task set is displayed on the list to include with the change request, select it, and then click Relate.
  4. Define a numerical sequence of the tasks.
  5. When you finish adding the templates, save the change request.

To enable all the task templates for change-initiated job

You can select a task template specific to change-initiated job use case.

In the Select Template dialog box, you must enable the following criteria: 

  • Type as Automatic
  • Automatic Command as Scheduled Job

Select Template.png


To automatically create tasks to check whether a change has been approved

Create an automatic task that polls a specified field on a specified form (the TMS:SampleApprovalForm is provided out-of-the-box) to see whether an approval has been obtained. If the field on the form is not NULL, an approval has been obtained. The automatic task that is created is closed after the approval is obtained (Status = Closed and Status Reason = Success).

After the automatic task is instantiated and becomes active, an initial check is done to see whether approval has been obtained. Approval checking is done through filters that set zTmpExecuteTask to CHECKAPPROVAL on the Task form. At the same time, the AutomaticIntervalTime is also set based on the Automatic Interval and Unit fields from the Task Template form.

If an approval is obtained, the task is closed, and the AutomaticIntervalTime is set to NULL.

If an approval is not obtained, a TMS:TAS:GetDataInterval escalation is sent every fifteen minutes to check whether the AutomaticIntervalTime is greater than (or equal to) the current time. If it is, the escalation sets zTmpExecuteTask = CHECKAPPROVAL on the Task form, which starts the approval checking process. This process is repeated until the approval is obtained or the task times out. The timeout values must be set on the Task Template form for the timeout to occur.

The example used in the following procedure is provided out-of-the-box for Change Management:

  1. Create a change request.
  2. Click the Tasks tab.
  3. Select the Task Template request type, and then click Relate.
  4. Relate the Check Approval automatically task template to the change request.
  5. Use the Process Flow Status bar to move the change request to the Implementation In Progress status. 
    The status of the task is set to Waiting.
  6. Open the Sample Task Approval form and search for the sample approval record.
  7. Update the record (for example, In the Approved By field, enter your name).
  8. Wait at least 15 minutes until the TMS:TAS:GetDataInterval escalation fires. 
    This escalation checks the Automatic interval.
  9. Refresh the change request until the status of the task is set to Closed.

To assign a task

  1. On the Tasks tab of the Change form, select a parent task or child task that is related to the change request, and then click View.
  2. On the Assignment tab, select the group or person to work on the task, and then click Save
    The implementer for that task is notified of the task assignment.

To assign all tasks in a change request

  1. Open the change request in the Change form.
  2. Set the Status field to Scheduled. 
    The change request is set to Scheduled and the status of the first task is set to Assigned.

To reassign a task

  1. To view a list of tasks, click Show Tasks under Details and Tasks.
  2. In the Assigned Tasks table on the Change Management console, select the task to reassign, and then click View.
  3. On the Assignment tab, select the group or person to whom you want to assign the task in the Assignee Group or Assignee field.
  4. Ensure that the Notify Assignee field is set to Yes, and then click Save
    Until the new implementer accepts the task assignment, you are assigned to the task and have responsibility for it.

To track the time you spend on a task

You can track the time and efforts spent for tasks by using the Dates tab.

The following fields are displayed on the Dates tab:

Field

Description

Scheduled Start Date+

The scheduled start date for the task. Depending on the configuration that you set for Action On Scheduled Dates Change while configuring change rules, an error message or a warning might be displayed when the change request is in between Planning In Progress and the Scheduled status.

Scheduled End Date+

The scheduled end date for the task.

Time Segment Action

This field lists the time segment options. For more information, see Registering-time-segments-in-Change-Management.

Actual Start Date+

This field gets populated automatically with the date and time at which the task is saved after the first task moves to the Work in Progress status.

Actual End Date+

This field gets populated automatically with the date and time at which the task was saved after the status is moved to the Closed status.

Activate Time

This field gets populated automatically with the date and time at which a task moves from the Staged state to an active state.

Duration in Minutes

This field shows the time spent on the task.

This value is calculated by using the Closed Time value (on the Assignment tab) and the Activate Time value. The value is calculated as follows:
(Closed Time - Activate Time) ÷ 60

The End Time and Activate Time are measured in seconds and then divided by 60 to display the time in minutes.

Assign Time

This field gets populated automatically with the date and time when the task assignment is saved.

Create Date

This field gets populated automatically with the date and time when the task was created.

Modified Date

This field gets populated automatically with the date and time when the task was last modified and saved.

Closed Time

This field gets populated automatically with the date and time when the task status is moved to Closed. This field is displayed only after the Task status is set to Closed.

User Data

This field displays the User ID of the user who submitted the task and who last modified the task.

You can track the time that you spend for tasks. For example, you are assigned to multiple tasks and want to track the time that you spend on each task to know on which task you spend the most time. 

  1. Open the task.
  2. Click the Assignment tab on the Task form.
  3. To automatically track the time spent working on tasks, use the Start Clock and Stop Clock options.
    1. When you start the task, click Start Time, and then click Save.
    2. When you finish working on the task, click Stop Clock, and then click Save.
      You can use the start and stop clock buttons as many times as required. Each successive time, the new time is added to the value in the Total Time Spent field. The time is automatically calculated, based on when you click the buttons.
  4. To manually track the time spent working on tasks, enter the number of hours or minutes in the Time Spent field, and then click Save.
    The time that you enter is added to the value in the Total Time Hours and Minutes fields.
  5. To add the tracking information to the log:
    1. After you save the information for tracking the time spent on the tasks, click the Assignment tab on the Task form.
    2. Click Effort Log.
    3. Enter information in the effort log, and then click Add to Effort Log.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*