Reference property

App.Reference

A reference to the app object. App objects hold various useful properties related to the app. There is only one app object, and it is typically named App.

Referencing the app object is useful when writing formulas for the IncludedFields property of open report buttons, email report buttons, server relay buttons and reset buttons. When an app object is included in the IncludedFields array, it causes all fields to be included.

This property is a read-only property, meaning that no formula can be assigned to it.

Referencing the app object from formulas

When referencing the app object from a formula, there is no need to write .Reference,Reference after the app object name if a reference is sought. These formulas are equivalent when associated with the IncludedFields property of email report buttons:

{ App }{ App }
{ App.Reference }{ App,Reference }

Above, the IncludedFields property is looking for an array of references. As App can return a reference through its Reference property, .Reference,Reference is implied.

Examples

{ App }{ App }

This formula is associated with the IncludedFields property of an open report button and causes all fields of the app to be included in the report.

{ App.Reference }{ App,Reference }

This formula is associated with the IncludedFields property of an open report button and causes all fields of the app to be included in the report. Writing out the Reference property in formulas (by writing App.ReferenceApp,Reference) is rarely necessary.

IF(ResetAllFields, { App }, Field1:Field10)IF(ResetAllFields; { App }; Field1:Field10)

This formula is associated with the IncludedFields property of a reset button. If the ResetAllFields switch field is toggled to its "on" position, all fields are reset (courtesy of the app object being part of the first array). Otherwise, only Field1, Field10 and all fields that appear between them are reset.