Partager via


EXECUTE Function

Runs a report in preview or processing-only mode without showing the request page in the client. The function gets the request page parameter values as an input parameter string from a RUNREQUESTPAGE Function call.

Note

The OnOpen and OnClose triggers on the request page will run even though the request page is not shown.

Syntax

REPORT.EXECUTE (Number, Parameters[,RecordRef])  

Parameters

Number
Type: Integer

The ID of the report that you want to run. To specify the report from a list, on the View menu, choose Symbols.

If the report that you specify does not exist, then a run-time error occurs.

Parameters
Type: Text or Code

A string of request page parameters as XML to use to run the report. The parameter string is typically retrieved from the return value a RUNREQUESTPAGE Function function call.

RecordRef
Type: RecordRef

The RecordRef that refers to a record in a table.

Remarks

You typically use this function together with the RUNREQUESTPAGE Function function. The RUNREQUESTPAGE function runs a report request page without actually running the report, but instead, returns the parameters that are set on the request page as a string. You can then call the EXECUTE function to get the parameter string and run the report.

For a simple example that illustrates how to use the EXECUTE function, see example in the RUNREQUESTPAGE Function function topic.

See Also

Reports
Request Pages
SAVEAS Function
PRINT Function