Portlet Factory, Version 6.1.2


 

Domino Formula builder

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 either a Domino Data Access builder or a Domino View & Form 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:

  1. Obtains the unique ID for the Domino document, if any, associated with the formula. The ID is contained in the Document UNID builder input.

  2. Retrieves the formula to be evaluated.

  3. Uses the Domino artifacts created by another other Domino builder to evaluate the function.

  4. Places the result on the requested page.

 

Quick tips

  • Provide a UNID

    Use a Domino View & 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.

Parent topic: Builder help


Library | Support |