:Revision=1
:html
<<
128.123
DirectFail-Object|DirectFail
--
On the one hand, the IP-Object DirectFail enables the activation of the direct-error system and on the other the data transfer from the direct-error step to the system.

Since the direct-error step hasn't got any test step parameters, the step data is transferred with the DirectFail IP Object (similarly to the synthesized measured values).
>>


<<
128.123.2
Procedures of the DirectFail-Object|Procedures
--
>>
<<
128.123.2.1
DirectFail.Call|Call
--
<!DEF>
procedure <!TW>DirectFail.Call;
<!TXT>
It works like a click on the direct error button. It is effective only if the button is active as well.
>>

<<
128.123.2.2
DirectFail.Enable|Enable
--
<!DEF>
procedure <!TW>DirectFail.Enable (rOn : real);
<!TXT>
Enables (<!PW>rOn=<!RW>true) or disables (<!PW>rOn=<!RW>false) the Direct Error button. Overwrites the specification from the basic setup, but not permanently, so after the next reset the specification of the basic setup is reapplied.
>>

<<
128.123.2.3
DirectFail.File|File
--
<!DEF>
procedure <!TW>DirectFail.File (sFileName : string);
<!TXT>
Sets the interpreter step to be used for the Direct Error Step. Overwrites the specification from the basic setup, but not permanently, so after the next reset the specification of the basic setup is reapplied.
>>

<<
128.123.2.5
DirectFail.Set|Set
--
<!DEF>
procedure <!TW>DirectFail.Set (sIdent : string; .Value : real|string);
<!TXT>
Sets an attribute of the measured value generated by the Direct Error Step. 

The attributes are addressed by their names. The data type of the <!PW>value must match the type of the attribute.

Currently defined attributes and the data types: 

<!STBL>
<!+>Name<!+>Data type(s)<!+>Description<!>
<!>Info<!>String<!>Designation<!>
<!>LowerLimit<!>Real<!>LowerLimit<!>
<!>UpperLimit<!>Real<!>UpperLimit<!>
<!>Unit<!>String<!>Unit<!>
<!>Precision<!>Real (0..9)<!>Decimal places<!>
<!>SaveData<!>Real (bool)<!>Save measured value ?<br>0 / <!RW>false : no<br>1 / <!RW>true  : yes<!>     
<!>Duration<!>Real<!>Duration of the test step<!>
<!ETBL>

The characteristics can be overwritten as often as necessary. The names can be specified with lower- or upper case.

Contrary to the synthetic measured values (<!RW>MeasData.New), for the Direct Error Measured Value, the <!RW>MeasValue (measured value) and the <!RW>StepResult (result of the step) characteristics do not have to be set directly; they are set with the system procedures <!RW>SetValue and <!RW>SetStepResult as it is done in case of the normal test steps.
>>
