IEstimate.RunQdvRequest (String, Int32, Int32, Int32, ref MacroExecutionError) Method

Executes a QDV request. If any anomalies are added by the request, a window with the list will be automatically displayed when the request has finished.
Sub RunQdvRequest( _ 
ByVal requestName As String, _ 
ByVal wbsScope As Integer, _ 
ByVal includeDbOfEstimate As Integer, _ 
ByVal includeOverheadMinute As Integer, _ 
ByRef executionError As MacroExecutionError
)
This language is not supported or no code example is available.
void RunQdvRequest( 
string requestName
int wbsScope
int includeDbOfEstimate
int includeOverheadMinute
ref MacroExecutionError executionError 
)
This language is not supported or no code example is available.

Parameters

requestName
string

The request name (not a request ID).

wbsScope
int

The WBS scope of the request execution. 1 means '001', 0 means no task from the WBS.

includeDbOfEstimate
int

Indicates whether to include also database of estimate into request execution scope. 1 means yes, 0 means no.

includeOverheadMinute
int

Indicates whether to include also overhead minute into request execution scope. 1 means yes, 0 means no.

executionError
MacroExecutionError

Returns the errors produced by the request execution.

Remarks
 
Execution of requests affects the Anomalies property. When a request is started, the anomalies are automatically cleared. When a request has finished, the anomaly list is checked whether it contains any anomalies added with an "Append_Anomaly_List" verb. If the list is not empty, a window with the list will be automatically displayed. And the Anomalies property will be correctly set. So the anomalies can be accessed programmatically through the Anomalies property.

The execution stops on the first error. This error is then returned in the executionError argument. Since the MacroExecutionError is a structure, you cannot test it for null reference (Nothing in Visual Basic), when the method finishes. Instead, test its MacroExecutionError.ErrorMessage property. When you call the method, set the MacroExecutionError.ErrorMessage property to null reference (Nothing in Visual Basic) and when the method finishes, test whether the value is null reference (Nothing in Visual Basic) or an empty string.

Version
 
Available since QDV 7.13.0001.

.NET Framework

Supported in: 4.8, 4.7, 4.6, 4.5.2

In this article

Definition