Edit Task Information

Access the Task Editor from the Tasks Pane icon bar to add or edit tasks. Select a task and click the Add or Edit icon and use the Task Editor to add or edit general information, scheduling and action information, and an optional conditional status expression.

NOTE: To change information in the Task Editor, select the check box above the information to change, update the value, and then click Save. If you do not select the check box, the Save button does not display.

 

 

Info

Use the Info section of the Task Editor to add general information about the task. The description you add in this section displays in the task’s details.

Info Section on Editor Page  

Task Editor Info Field Definitions

Info

Name

The description that displays to users assigned to the task.

Notification Type

Configure when users are notified by email about task changes.

  • None

  • On Preparation

  • On Preparation, Recall, and Rejection

  • On Preparation, Recall, Rejection, and Approval

  • On Preparation, Recall, Rejection, Approval, and Unapproval

See Set up Task Notifications.

Categories 1–3

The list of categories maintained by your Task Manager Administrator. These categories are informational only.

Instructions

Select an instructions file from the list to use with the task or select the default (From Group) to have the task inherit any instruction files from its task group. Instruction files that display in the list have been uploaded and included as instructions for a task.

See:

Description

 

Enter text describing the task. Administrators can use this field for quick task identification and for understanding what the task is about.

See Set up Descriptions to Identify Tasks.

Role

The Role section of the Task Editor lets you set up the roles for the task. Each user can only perform one role on a single task in a specific time period.

Role Section Editor Page  

Task Editor Role Field Definitions

Role

Preparer/Preparer Group

The Preparer or Preparer Group assigned to prepare the task.

Approvers 1–4/Approver Group

The user or group assigned to approve the task once prepared by the Preparer.

There are different levels of approvers, and each approver has specific permissions related to their role for a task. Multiple levels of approvers are beneficial for complex tasks that require multiple reviewers to ensure quality. Assign a maximum of four approvers to a task.

A user can take action on a task as their assigned role or any role below or act as preparer.

  • Approver 1 on a task can approve at level 1 on that task.

  • Approver 2 on a task can approve at levels 1 and 2 on that task.

  • Approver 3 on a task can approve at levels 1–3 on that task.

  • Approver 4 on a task can approve at levels 1–4 on that task.

After a user prepares or approves a task, they cannot take action on it again. An administrator cannot assign the same user to more than one security role.

Approvers can run Document Management, Open URL, and Open Dashboard tasks for review before approving. All other task types require Preparer rights when running.

Tasks in public groups can only be run by a Preparer or Approver. Viewers, Preparers, and Approvers can view the task.

Viewer Group

The Viewer Group assigned to access the task.

Viewers can view task details, comments, attachments, and instructions, but they cannot perform actions on tasks.

Approval Levels

There are different levels of approval. Each level requires an additional approver. Set this option to 0 to remove the requirement for approval, which means the task only needs to be prepared.

Schedule

The Schedule section of the Task Editor lets you set up task scheduling, timing, and priority.

 

Task Editor Schedule (UTC) Field Definitions

Schedule

Work Day

Work Day is the number of days in relation to the period close date (0, +1, -1) (-1, 0, +1). All dates and times used for comparison are based on UTC (GMT) time zone for consistency. This can be any valid positive or negative integer. Task Manager validates the value as a valid positive or negative integer and displays a message if the value is not an integer.

Start Hour/Offset

The time on the Work Day in user time that the Task is due. All dates and times used for comparison are based on UTC (GMT) time zone for consistency.

Duration

The length of the task in hours or days.

Holiday Profile

Select a Holiday Profile to assign to this task to offset dates.

Frequency

Frequency is the workflow time period in which the task takes place. If the task frequency is empty, the task will have the same frequency set on the task group. If the frequency on the individual task is different from the task group, it will show what the individual task displays.

For example, if the group is 1-12 and the task is set to 3,6,9, or 12, then the task only shows quarterly.

Priority

An informational indicator to users that enables them to prioritize their work. Valid options are High, Medium, and Low.

Is Milestone

When set to Yes, Is Milestone adds a diamond shape to the Gantt chart indicating significant progress points that need to be met for success of the task group.

Action

The Action section of the Task Editor is where you determine the action type of the task. The selected action type determines the additional fields used to define how the task runs. The Action section does not display if multiple tasks are selected for editing.

 

Task Editor Action Field Definitions

Action

Action Type

Action Type indicates the type of task to complete. One or more additional fields can display based on the Action Type selected. Select the appropriate information displayed in these fields to support the selected Action Type.

See Action Types.

Any security in place for each of these actions remains in effect. For example, if creating a task that sends a user to a dashboard for which they do not have access, they do not see any of the dashboard components.

Status and approval updates for tasks with certain Action Types happen automatically when taking associated actions in OneStream. Other tasks must have status and approval values updated manually.

Status

Use the Status section of the Task Editor to define any conditions required for the task.

 

Conditional Status Expression

Select Conditional Status Expression to create situational overrides for task dependencies. Create an XFBR business rule that specifies what condition needs to be met and include the conditional statement in the field.

NOTE: XFBR is a script that you or the Administrator must create.

In the previous example, MyBRStringRule is the business rule name and MyBRStringFunction is the function name.

NOTE: This conditional statement points to a custom XFBR business rule to suit the conditional requirements. You can include additional rule arguments.

If the condition is met (success), nothing returns, and the associated task completes. If not met (failure), the condition returns a string, and the custom statement displays in the business rule. Include in this custom statement an explanation of why the task is running and the message to display upon failure.

Conditional status is not meant to override task dependents. It is meant to add external restrictions (for example, test if GL is closed before allowing workflow completion).

See documentation on XFBR Business Rules in the Design and Reference Guide for more information.

Validation

The Validation section of the Task Editor shows the status of the selected task or tasks as well as the summary of information from the other sections (Info, Role, Schedule, Action, and Status).

The grid displays errors related to security role validations. It will display in real time if any user is assigned to more than one security role on the same task. Other validations are done to the name and description fields (length, uniqueness, and special characters used that are not allowed) and workday (validates it is an integer) that display in a message after you click Save. Only changes with no errors are processed when you click Save.

 

Right-click the row to export the information or change the column settings.