IEstimateVersion.UpdateMinuteValues (String, Object, String, Object, WhereConditionType, Boolean) Method

Updates a field value of multiple minutes based on a test condition. The search is performed on all WBS tasks.
Sub UpdateMinuteValues( _ 
ByVal UpdateColumnName As String, _ 
ByVal NewValue As Object, _ 
ByVal WhereColumnName As String, _ 
ByVal WhereValue As Object, _ 
ByVal WhereType As WhereConditionType, _ 
ByVal WhereIsCaseSensitive As Boolean
)
This language is not supported or no code example is available.
void UpdateMinuteValues( 
string UpdateColumnName
object NewValue
string WhereColumnName
object WhereValue
WhereConditionType WhereType
bool WhereIsCaseSensitive 
)
This language is not supported or no code example is available.

Parameters

UpdateColumnName
string

The mnemonic of the minute column to be updated.

NewValue
object

The new value to be set in the column.

WhereColumnName
string

The mnemonic of the minute column to be tested.

WhereValue
object

The value to be tested in the condition.

WhereType
WhereConditionType

The type of test to be performed.

WhereIsCaseSensitive
bool

Indicates whether the test is case sensitive.

Exception type Condition

QdvApiException

A problem occurred.

Remarks
 
This method tests for the condition the minutes of each WBS task in the estimate. The database of the estimate and overhead minutes are NOT processed. The condition is specified with WhereColumnName, WhereValue, WhereType and WhereIsCaseSensitive parameters. If the condition is satisfied, the UpdateColumnName column of the minute will be updated with the new value.

This method overload searches only in WBS. It doesn't process the database of the estimate neither the overhead minutes. If you want to search them, you need to use another method overload which takes Tasks parameter.

This method requires the internal cache to be up to date, which is ususally the case, but there are some exceptions and you need to refresh it manually, see below.

Some methods use the internal cache for retrieving the minutes data. This is for performance reasons, especially, when one minute is accessed multiple times. These are (let's name them group 1): 
GetFieldValue
SetFieldValue
SetFieldValue
UpdateValuesConditionally
UpdateMinuteValues.

And there are some methods that modify the minutes data, but they don't update the internal cache for performance reasons. These are (let's name them group 2): 
ClearRowValues
DeleteRow
InsertRows
InsertSetAtRow
InsertSetAtRow
GroupRows
UngroupRows
UpdateRowsFromDatabases.

So if you use the methods from group 2, you should update the internal cache manually before you call any method from the group 1. The cached data can be updated and retrieved with GetFullData method. You can update the cache also with the IWbs.Refresh method, but is it slower, because it does much more work.

See IMinute documentation for details about hidden "FreeField" field.

function to get info about these tasks. GetMultipleTaskInGanttAssignation field refers to only one task, the function returns a string which contains the unique description of the task. When the TaskInGantt field refers to several tasks, the function returns "<Multi>". Then you have to use the TaskInGantt When the

For historical reasons, this method doesn't throw any exception in case of any error. Instead, the error will be stored as a global error (if it was empty) in IGlobalErrors

Version
 
Available since QDV 7.13.0001.

.NET Framework

Supported in: 4.8, 4.7, 4.6, 4.5.2

In this article

Definition