Lotus Notes Fetch Wizard

You can retrieve data from a Lotus Notes database, for example a name or an address, to a StreamServe Process. Instead of updating all your StreamServe Projects, you can update the Lotus Notes database and retrieve the correct information from the database.

The Lotus Notes Fetch wizard inserts a code block in a script in the Process. The code block generated by the wizard retrieves data from the Lotus Notes database. It uses a variable in the Event to identify the value to be retrieved from the Lotus Notes database, and stores the retrieved data in a variable in the Process.

Requirements

A Lotus Notes client, version 4.5 or higher, must be installed on the same computer as Design Center. The notes.ini file in the Lotus Domino or Lotus Notes installation refers to the Lotus ID file which must contain data for authenticating read access to the Lotus Notes database.

Specifying the search criteria

If more than one document in the Lotus Notes database matches the specific criteria, data will only be returned from the first document that is found. Increasing the number of search criteria will result in a more accurate search.

The Lotus Notes Fetch wizard cannot check the validity of the criteria you specify. If you use invalid search criteria, the Lotus Notes Fetch Wizard will return a blank line, or the variable name, instead of the variable in the output document or data flow.

Retrieving data from more than one document

Each Lotus Notes Fetch wizard operation will return data from one document. If you want to retrieve data from more than one document, you will have to specify a Lotus Notes fetch for each document.

The generated code block

The syntax of the generated code block follows the StreamServe scripting language.

You can move an entire code block, but not specific sections of a generated code block. If you do, the generated code block may not work properly.

You can have multiple code blocks in the same script. However, the fetch wizard does not support generated blocks inside blocks, for example

    if(...)
    {
    // Generated block 1
    }
    else
    {
    // Generated block 2
    }
    // Generated block 3

Editing a code block generated by the wizard

You should always use the Lotus Notes Fetch wizard to edit generated code blocks. Editing code blocks any other way may result in failure to retrieve data from the Lotus Notes database.

Limitation

The Lotus Notes Fetch Wizard does not support Unicode, you can only use ASCII.