[Name :=] FilterPageBuilder.ADDRECORD(ItemName, Record)

Parameters

ItemName

Type: Text

Assigns a name to the filter control.

The text displays as the caption for the filter control on the rendered filter page in the Microsoft Dynamics NAV client.

Note
Within the collection of filter controls on the filter page, you cannot assign the same ItemName to different table IDs; otherwise a runtime an error occurs.

Record

Type: Record

The record to use in the filter control.

Type: Text

The name assigned to the item or an empty string if an error occurred. An error message will be shown if the return value is not used.

In the filter page that is rendered in the Microsoft Dynamics NAV client, the ADDRECORD function defines a filter control for the specified table where the user can set filters on specific fields in the table.

Fields in the table that already have filters are automatically included in the filter control. Filters in the record passed to the function will not be modified by any function in the FilterPageBuilder object.

The following example initializes a filter page object that includes a filter control that uses the Date system table. The filter control has the caption of Date record. The example set two filters are on the Date record variable, which results in a filter control that includes two fields by default.

This example requires that you create the following variables in the C/AL Globals window.

	Copy Code
varDateItem := 'Date record'; varDateRecord.SETFILTER("Period End",'12122015D'); varDateRecord.SETFILTER("Period Start",'01012015D'); varFilterPageBuilder.ADDRECORD(varDateItem, varDateRecord);

Reference