Zero-Out Data Process

Use the Zero-Out Data process to set budget, forecast, progress, or actual time-phased resource values to zero.

Process Settings

Below are the settings you must define for the Zero-Out Data process.

Setting Description Sample Value
ProcessID This setting informs Cobra to run the Zero-Out Data process. ZeroOutData
Project This setting refers to the Cobra project where you are setting values to zero.

The project name is case-sensitive. This setting is required.

Proj Adv 1
Action

Use this setting to specify the option you want to apply when running the Zero-Out Data process.

  • If the value is set to ZeroOutData, the process deletes all zero-value records for all periods.
  • If the value is set to DeleteExistingZeroValueResources, the process deletes only zero-value resources and all of its currency and non-currency results for all time-phased periods.

This setting is optional and the default value is ZeroOutData.

ZeroOutData
ClassList Use this setting to specify the cost classes that can be used for the process.

If the value is set to <All>, resources across all classes will be replaced.

This setting is required.

Actual,Earned
Criteria Use this setting to specify the selection criterion you want to use for the process. The selection criteria change based on the project. Some selection criteria include the following:
  • Total Project
  • Control Account
  • Work Package
  • WBS
  • OBS
  • WP
  • Resource Assignment
  • Progress Technique

The options are case-sensitive.

This setting is optional and the default value is Total Project.

Control Account
Selection

Use this setting to select the portion of the project for which to set the values to zero. The available options depend on the selections you made in the Criteria setting.

If you specify Total Project in the Criteria setting, the Selection setting will be left blank.

This setting is optional and has no default value.

1.1.1.1 / 1410
IncludeChildren
Use this setting to determine whether the process should run against the parent code and its children.
  • If the value is set to 1, the process runs against the parent code and its children.
  • If the value is set to 0, the process runs only against the parent code.

This setting is optional and the default value is 0.

0
DeleteZeroValueResources

Use this setting when the Action setting value is set to ZeroOutData.

Use this setting to determine whether all zero-value resources should be deleted when deleting all periods.

  • If the value is set to 1, all zero-value resources should be deleted when deleting all periods.
  • If the value is set to 0, zero-value resources are retained even when all periods are deleted.

This setting is optional and the default value is 0.

0
IncludeCompletedCAWP

Use this setting to determine whether the values of completed control accounts and work packages should also be set to zero.

  • If the value is set to 1, the process includes completed control accounts and work packages.
  • If the value is set to 0, only planned control accounts and work packages are affected.

This setting is optional and the default value is 0.

0
IncludeInProgressCAWP

Use this setting to determine whether the values of in-progress control accounts and work packages should also be set to zero.

  • If the value is set to 1, the process includes in-progress control accounts and work packages.
  • If the value is set to 0, only planned control accounts and work packages are affected.

This setting is optional and the default value is 0.

0
RunUpdateTotals

Use this setting to specify whether to run the Update Totals process after completing the Zero-Out Data process.

  • If the value is set to 1, the Update Totals process is run after completing the Zero-Out Data process.
  • If the value is set to 0, the Update Totals process is not run after completing the Zero-Out Data process.

This setting is optional and the default value is 0.

0
IncludeForecastClassesInUpdateTotals

If the specified class is a Forecast class with the Scale Retain EAC option set to Hours, Currency, or Hours and Currency, setting the value to 1 will include the Forecast class values when you run the Update Totals process after completing the Zero-Out Data process.

This setting is optional and the default value is 0.

0
Scope

Use this setting to specify the range over which you want to run the Zero-Out Data process.

  • If the value is set to All, all of the periods of the entire project are set to zero.
  • If the value is set to DateRange, the Zero-Out Data process is run for a specific date range.
This setting is optional and the default value is All.
DateRange
StartDateLabel

Use this setting if Scope=DateRange. This setting refers to a valid calendar label and is the starting date for the DateRange setting.

This setting is optional and the default value is the starting date for the DateRange setting.

01/31/2024
EndDateLabel

Use this setting if Scope=DateRange. This setting refers to a valid calendar label and is the ending date for the DateRange setting.

This setting is optional and the default value is the ending date for the DateRange setting.

01/31/2027

Sample Script

Below is a sample script file for the Zero-Out Data process.

[PROCESS001]
ProcessId=ZeroOutData
Project=Proj Adv 1
Action=ZeroOutData
ClassList=Actual,Earned
Criteria=Control Account
IncludeChildren=0
Selection=1.1.1.1 / 1410
DeleteZeroValueResources=0
IncludeCompletedCAWP=0
IncludeInProgressCAWP=0
RunUpdateTotals=0
IncludeForecastClassesOnUpdateTotals=0
Scope=DateRange
StartDateLabel=01/31/2024
EndDateLabel=01/31/2027