Leggere in inglese Modifica

Condividi tramite

ErrorInfo.RecordId([RecordId]) Method

  • Articolo

Version: Available or changed with runtime version 8.0.

Specifies the record ID of the record that the error relates to.

Syntax

AL 
[RecordId := ]  ErrorInfo.RecordId([RecordId: RecordId])

Nota

This method can be invoked using property access syntax.

Parameters

ErrorInfo
 Type: ErrorInfo
An instance of the ErrorInfo data type.

[Optional] RecordId
 Type: RecordId
The record ID of the ErrorInfo

Return Value

[Optional] RecordId
 Type: RecordId
The current record ID of the ErrorInfo.

Remark

You can use the RecordId property to transfer data from the code where an error message is shown to the user to the codeunit and method(s) executed by fix-it/show-it actions or where you handle collected errors.

For more information about how to develop actionable errors, see Actionable errors.

For more information about how to handle multiple collected errors, see Collecting errors.

Example (get the RecordId property)

AL 
procedure myErrorHandlerProc(MyErrorInfo: ErrorInfo)
var 
    TheRecordId: RecordId;
begin
    TheRecordId := MyErrorInfo.RecordId();

    // do something with the data (now you can get the table number of the row or a record ref to the row)
end

Example (set the RecordId property)

AL 

var 
    MyErrorInfo: ErrorInfo;
    MyTableRec: Record "MyTable";
begin
    // setup the error info object: Define Message, DetailedMessage etc.

    // set identifiers for the fix-it action codeunit (or for the AL runtime in case of a show-it action)
    MyErrorInfo.RecordId := MyTableRec.RecordId;
    MyErrorInfo.SystemId := MyTableRec.SystemId;
    MyErrorInfo.TableId := Database::"MyTable";

    // setup fix-it or show-it action(s) for the error info object

    Error(MyErrorInfo);
end

ErrorInfo Data Type
Actionable errors
Collecting Errors
Error handling
Get Started with AL
Developing Extensions