@AbstractSimple (Formula Language)

Creates a short abstract of a text or rich text field. Simpler and more efficient than using @Abstract.

Note: This @function is new with Release 8.

Syntax

@AbstractSimple( bodyFields )

Parameters

bodyFields

Text or text list. Any number of fields containing the text to abstract. May be text or rich text fields. If Notes/Domino cannot locate a field by name, it uses the string literal instead. Enclose each field name in quotes and separate multiple names with colons: "Sales":"Figures".

CAUTION: Rich text fields are not part of a document until saved. If you want @AbstractSimple to work on additions and changes to the current document, you must first save and then recalculate the document.

Return value

abstractedText

Text or Text List. Returns the first 100 characters or first 2 paragraphs of text, whichever is smaller. All newline and tab characters are converted into spaces, and all empty paragraphs (containing only a newline character) are ignored. If the parameter is a single field, a text value is returned. If the parameter is a list of field names, then a text list is returned with each list element containing the abstracted text of the corresponding field in the parameter list.

If a field parameter is of an invalid type, or can't be found, the text returned is the string of the field parameter.

Note: If the behavior of @Abstract is desired, where the result is a single, space-separated, string of abstracted results, apply @Implode to the result of @AbstractSimple

Examples

  1. If the field "Verse" contains the rich text:
    One bright day
    in the middle of
    the night
    

    @AbstractSimple("Verse") returns:

    One bright day in the middle of
  2. If the field "Verse" contains the rich text:
    One bright day
    
    
    
    in the middle of

    @AbstractSimple("Verse") returns:

    One bright day in the middle of
  3. If the following fields are on a document:

    Field Name

    Type

    Value

    PersonName

    Text

    Sam Smith

    Address

    Text

    123 Shady Lane

    CityState

    Text

    Anytown, USA

    ZIP

    Numeric

    12345.00

    @AbstractSimple("PersonName" : "Address" : "CityState" : "ZIP") returns:

    Sam Smith : 123 Shady Lane : Anytown, USA : ZIP
    Note: The last element is "ZIP" because the field is numeric which is invalid for @AbstractSimple

  4. If the field "Critics" contains the text:
    When asked to comment on the movie, the reviewer stated that it was one of the year's best, and certainly would find a place on many award lists.

    @AbstractSimple("Critics") returns:

    When asked to comment on the movie, the reviewer stated that it was one of the year's best, and cert