Creating Task Virtual Resources

Owned by Stonebranch (Deactivated)
Jul 05, 2023
6 min read

Overview

Universal Controller lets you create Task Virtual Resource records by assigning Virtual Resources to tasks via a Virtual Resources tab in the task Details.

(You also can assign Virtual Resources to tasks via the Tasks tab in a Virtual Resource Details.)

A Task Virtual Resource defines a Virtual Resource dependency for a task.

Creating a Task Virtual Resource

There are two methods for creating Task Virtual Resources:

  1. The New button above a Task Virtual Resources list lets you either create a Task Virtual Resource by selecting a specific Virtual Resource or by specifying the Virtual Resource as a variable..
  2. The Edit button button above a Task Virtual Resources list lets you create and/or delete Task Virtual Resources for a task by selecting and/or de-selecting specific Virtual Resources.

New Task Virtual Resource

Step 1

Select a task from a Tasks list and, in the task Details for that task, click the Virtual Resources tab. The Task Virtual Resources list displays.
 

Step 2

Click the New button. The Task Virtual Resources Details dialog displays.
 

Step 3

Using the field descriptions, below, as a guide, complete the fields as needed.

Step 4

Click a Save button to save the record and return to the Task Virtual Resources list.

Step 5

If appropriate, repeat these steps for any additional Task Virtual Resources that you want to add.

Edit Task Virtual Resources

Step 1

Select a task from a Tasks list and, in the task Details for that task, click the Virtual Resources tab. The Task Virtual Resources list displays.
 

Step 2

Click the  button to display the Edit Member dialog.
 

 

  • The Collection window displays all Virtual Resources that have not been assigned to this task.
  • The Virtual Resource List window displays all Virtual Resources that have been assigned to this task.

Step 3

If you want to filter the tasks in the Collection window, click the filter icon (see Filtering for information about how to construct a filter.)

Step 4

Move virtual resources from the Collection window to the Virtual Resource List window:

  • To move a single virtual resource, double-click it or click it once and then click the > arrow.
  • To move multiple virtual resources, Ctrl-click them and then click the >  arrow.
  • To move all virtual resources, click the >> arrow.

To move virtual resources from the Virtual Resource List window to the Collection window:

  • To move a single virtual resource, double-click it or click it once and then click the < arrow.
  • To move multiple virtual resources, Ctrl-click them and then click the < arrow.
  • To move all virtual resources, click the << arrow.

Step 5

Click Save.

Task Virtual Resources Field Descriptions

The following table describes the fields and buttons in the Task Virtual Resources Details.

Field Name

Description

Details

This section contains details for the task virtual resource.

Resource

Allows you to select an existing Virtual Resource as a Task Virtual Resource for this task.
 
Clicking the Virtual Resources Details icon next to the Resource field allows you to create a new Virtual Resource, but that does not automatically add it to the list of Task Virtual Resources for this task.

Resource Variable

Indication of whether the Resource field is a reference field for selecting a specific Virtual Resource (unchecked) or a text field for specifying the Resource as a variable (checked). Use the format: ${variable name}. The variable must be a supported type as described in Variables and Functions.

Amount

Number of resource units required from the Virtual Resource.

Buttons

This section identifies the buttons displayed above and below the Step Action Details that let you perform various actions.

Save

Saves the new System Operation Step Action Details record in the Controller database.

Save & New

Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.

Save & View

Saves a new record in the Controller database and continues to display that record.

Update

Saves updates to the record.

Delete

Deletes the current record.

Refresh

Refreshes any dynamic data displayed in the Details.

Close

For pop-up view only; closes the pop-up view of this task.

Task Instance Details Virtual Resources Tab

Step 1

Open a task instance Detail.

Step 2

Click the Virtual Resources tab on the task instance Details to display the Virtual Resources lists for the task instance:

Step 3

Click the Details icon next to any resource on these list to view details about the resource.


Outstanding Requests

Outstanding requests by this task instance for the Virtual Resource.

Field Name

Description

Virtual Resource

Name of the Virtual Resource.

Resource Type

Type of Virtual Resource:

  • Renewable
  • Boundary
  • Depletable

Amount Requested

Number of Virtual Resource units requested for this task.

Updated By

User that last updated this record.

Updated

Date and time this record was last updated.


 

Note

To see Outstanding Requests, the task instance must be in in a Resource Wait state. For example, if a Virtual Resource has 10 units and the task requires all 10 units, launching the task twice will cause the second Task Instance to go into Resource Wait with an Outstanding Request for 10 units of the Virtual Resource.

Currently Using

Virtual Resources that this task instance is currently using.

Field Name

Description

Virtual Resource

Name of the Virtual Resource.

Resource Type

Type of Virtual Resource:

  • Renewable
  • Boundary
  • Depletable

Amount Requested

Number of Virtual Resource units requested.

Updated By

User that last updated this record.

Updated

Date and time this record was last updated.


Task Instance Virtual Resources

Task Instance Virtual Resources defined for this task instance.

Note

You also can create a Task Instance Virtual Resource for a task instance.

Field Name

Description

Resource

Name of the task instance virtual resource.

Resource Unresolved

Name of a variable that will be resolved at run time to the name of the Virtual Resource.

Resource Variable

Indication of whether the Resource field of this task instance virtual resource specifies a variable (Yes) or a Virtual Resource (No).

Resource Type

Type of Virtual Resource:

  • Renewable
  • Boundary
  • Depletable

Amount

Number of Virtual Resource units used.

Updated By

User that last updated this record.

Updated

Date and time this record was last updated.



Note:

Virtual Resource variables will be resolved by the Task Instance at run-time when checking if resources are required. The resolved values will not be saved; the Task Instance Virtual Resource List will continue to show unresolved values.

If a Virtual Resource variable cannot be resolved, the Task Instance will transition to a Start Failure status.

If a resolved Virtual Resource does not exist, the Task Instance will transition to a Start Failure status.

If there are duplicate Virtual Resources with conflicting Amount values, the Task Instance will transition to a Start Failure status.

Creating a Task Instance Virtual Resource

To create a virtual resource for a task instance:

Step 1

Display the Virtual Virtual Resources lists for a task instance.

Step 2

At the top of the Task Instance Virtual Resources list, click the  button to display a Task Instance Virtual Resource Details dialog.
 

Step 3

Select / enter values for the task instance virtual resource (see Task Virtual Resources Field Descriptions).

STep 4

Click the Save button to assign the virtual resource to this task instance.