Use the Domino Formula builder to display Domino® information on a page, but that information is not readily available in a view or as a field in a document.
The Domino Formula builder evaluates an arbitrary Domino formula and places the result on a page. For example, you can write a formula that extracts information from a Document and use the builder to place the result on a page that displays detailed information about that document.
The Domino Formula builder works with a Domino Data Access builder. The Domino Formula builder uses the Domino artifacts created by the other builder to communicate with the backend Domino server while evaluating the provided formula.
This builder performs the following high-level actions at runtime when a page containing its result is requested.
- Obtains the unique ID for the Domino document, if any, associated with the formula. The ID is contained in the Document UNID builder input.
- Retrieves the formula to be evaluated.
- Uses the Domino artifacts created by the other Domino builder to evaluate the function.
- Places the result on the requested page.
- Provide a UNID
Use a View and Form builder to display a set of documents contained in a Domino view. Also let the user select a specific document and thereby provide the Document UNID input for the Domino Formula builder.
- Scalar results expected
The builder assumes that the result of evaluating the formula is a scalar value. If the formula results in a vector of values, only the first item of the vector is placed on the page. To work around this limitation, consider rewriting the formula so that the result is a single string built from the content of the vector.
Domino Formula builder inputs
This topic describes the inputs for the Domino Formula builder.
Parent topic: Builder help
About using the builder call editor
Domino Data Access builder
Paging Assistant builder
Locating control builder calls on pages