System Data - Mass Update

The Mass Update feature in CMiC allows users to propagate a value to all the records found in the queried set of records.  This feature is designed to allow mass update of specific columns in specific programs only.

There will be no valid list of values (LOVs) for the mass updateable columns pop-up list and users must enter valid values to avoid any validation errors upon saving.

Mass Updateable Screens

The following programs allow Mass Update on specific columns only:

  • Job Billing > Contract Entry

  • Job Billing > G/C Prepare Billing

Contract Entry – Mass Updateable Screen

Pgm: JBCONT – Contract Entry; standard Treeview path: Job Billing > Contracts > Enter Contract – Billing Codes tab

As framed in red above, the Contract Entry screen has a [Mass Update] button on the Block Toolbar for the Billing Codes tab.

When clicked, the [Mass Update] button launches a pop-up (Define Mass Update Values), with the following fields that correspond to the columns of the table, where users enter valid values as required:

Pop-up window launched from the [Mass Update] button on the Job Billing’s Contract Entry screen (standard Treeview path: Job Billing > Contracts > Enter Contract – Billing Codes tab)

The following are the mass updateable columns in the Contract Entry screen:

Updateable Column

Detail

Type

Type

WM

Weight Measure

Group 1

Group Code 1

Group 2

Group Code 2

Group 3

Group Code 3

Group 4

Group Code 4

Group 5

Group Code 5

Inv Fmt

Invoice Format Code

Job

Job Code

Cost Code

Cost Code

Cat

Category Code

Ret. Code

Retainage Code

Users may query/filter for a specific set of records for mass update of values.

Also, users may enter values in one or more columns for mass update purposes and press [Apply] to propagate the values to the queried set of records.

The [Close] button will close the pop-up without updating the column values.

Once columns reflect the mass updated values, users must explicitly click [Save] to commit the updates to the database. The program will validate the entries and commit them if all the values are valid. Errors will be displayed if there are any invalid values entered by users.

G/C Prepare Billing – Mass Updateable Screen

Pgm: JBBILL2 – Prepare Billing; standard Treeview path: Job Billing > Billing > G/C Prepare Billing

As framed in red above, the G/C Prepare Billing screen has a [Mass Update] button on the Block Toolbar of the Group 1 Summary to Group 5 Summary tabs, and on the Bill Code Detail tab.

When clicked, a pop-up (Define Mass Update Values) opens up with the following fields used to update the corresponding columns.

The following are the mass updateable columns in the G/C Prepare Billing screen:

Updateable Column Detail

% Completed

Completed Percentage

Ret. %

Retainage Percentage

Users may enter numbers with decimal places for mass updating, but the process will round the same to two decimal places upon update of detail records.

Users may query/filter for specific set of records for mass update of values.

Also, users may enter values in either or both columns for mass update and press [Apply] to propagate the % values to the queried set of records.

[Close] will close the pop-up without updating the column values.

Once columns reflect the mass updated values, users must explicitly save the action to commit the updates to the database, and then click on [Recalc. Billings] button to recalculate billings to update the billing values. The program will validate the entries and adjust the retention %, which may be different from the mass update value in some cases. This is due to the existing rules to validate and adjust the retention % when recalculating billings.