LOTUS CONNECTORS
Connectivity
The Connectivity options are described below.
These advanced options extend the capabilities of LEI to take advantage of specific Notes data structures and design elements. The options let you specify, for example, view-based selection criteria that manage the hierarchical structure of Notes. Connection Options also permit you to define data translation and manipulation. The options are divided into the following groups:
General Options The General Options can apply to the source or destination database, depending on whether the connection is used by the activity as the source or target connection.
This field is disabled if anything other than "Do Not Enforce Form Design" is selected. For information about how to use computed subforms and enable form design, see the "Considerations" section later in this chapter.
Selection Options The Selection Options section is used to configure the document level options used by the activity. These are used to limit the documents that the activity selects from the source. Several options can be combined, but the filtering is cumulative. A document must satisfy all options to be selected. These options can apply to the source or destination database, depending on whether the connection is used by the activity as the source or target connection, and apply to the creation of a result set.
This option enables you to select a form from the database specified in the "Notes Database" field in the Connectivity section of the Connection Document. When you click this option, a Form Selection page opens. Click a form from the list and then click OK on the Form election page to display that form name and open the Fields to use From Form option.
Fields to Use From Form: Once you select a form, the fields contained on that form are displayed. Check the field names that you wish to use.
Note Any field selection here is ignored when this connection is used in a Replication activity. To tailor field selection for replication, explicitly map the fields in the Mapping section of the Replication Activity Document.
When used in a Notes to Notes transfer, the result in the destination database is not hierarchical and all documents are copied at the same level.
To use this option from an activity with manual field mapping, add a field LCXHIER to both field lists (this is not necessary for automatic field mapping by name or position).
Note If the option "Fetch View Column Data" is used for selection, this option is required and will be automatically selected.
This option only affects document selection through an explicit Notes formula, such as a Direct Transfer activity or the LC LSX Connection.Execute method. It does not affect generic selection such as done by Replication activities.
This option applies only when a Notes database is the source. It has no effect when the connection document is used to connect to a destination.
The database selected in the Connection Document must be indexed and a view must be selected in "View to Use for Selection" to support this option.
This option only affects document selection through an explicit Notes formula, such as a Direct Transfer activity or the LC LSX Connection.Execute method. It does not affect generic selection such as those done by Replication activities.
If the name of an existing view is entered, the documents appearing in that view will be selected by the activity. This option replaces and ignores any command statement specified in the activity. By default, only top-level documents are included, although other options allow the view contents to be altered. Documents not in the view are ignored. When used with ordering or timestamps in Replication activities, this field indicates the name of the view to use for these operations. When performing primary key replication, supplying a view name can improve performance by not requiring the database to be re-indexed with every activity run. When no view is specified, a temporary view is still created and an event is logged suggesting use of a permanent view name.
Note If you use this option with a Direct Transfer activity that contains a Select Statement and choose a view as the source, the Select Statement in the Direct Transfer activity will be ignored.
When the view is the wrong format or doesn't exist, checking the "Allow View Creation/Modification (Replication Activity Only)" option (see below) allows the activity to create or overwrite that view in its own format. This option overwrites the view when modifying an existing view.
Allow View Creation/Overwrite (Replication Activity Only) -- This option allows the activity to modify or create the view if it doesn't already exist or doesn't have the proper formatting. It is required for timestamp replication when a view is specified. This option is only available for Replication activities.
If this form's Document Option "Case insensitive view searches" is selected, then the view columns will be set to sort case-insensitive.
Note When you use a permanent view to support keyed searches, such as those used by Replication activities, and an existing view needs to be altered (as is always true for timestamp replication), that view will be deleted and a new view will be created.
When running a Polling activity, entries in the trigger statement field are not operational if you have selected a permanent view for the connection.
The agent specified will further refine the documents selected. The agent is executed on the result set produced by the command (or selection) statement in either a Direct Transfer activity or a Command activity.
Note This option is only valid if the connection will be used in a Direct Transfer or Command activity.
To use this option from an activity with manual field mapping, add a field LCXFILE to both field lists (this is not necessary for automatic field mapping by name or position).
To use this option from an activity with manual field mapping, add a field LCXCOMP to both field lists (this is not necessary for automatic field mapping by name or position).
If the "Truncate Data When Necessary" option is set in the Activity Document, LEI truncates the text field to the maximum length indicated here before transfer. If the Truncate Data option is not checked, any record with one or more fields greater than this limit is not transferred, and LEI logs the error "Data overflow."
Understanding Destination Column Data Types To use any of these options with transfers to a database other than Notes, you must already have columns available in the destination metadata. The columns are added as the last columns in the metadata (one for each of the fields in the order listed below).
Some Notes Connection options add a special field to the result set. This field is automatically handled by a Notes target, but must be explicitly defined in a non-Notes target. When using LEI Replication between two Notes databases, these options must be selected in parallel, for both the source and target connections, to properly map within the Replication activity.
The destination database column types must reflect the following Notes data types:
Note If you are replicating from an external Notes database that contains multi-value fields to a SQL database and would like to have the values appear in the SQL database without spaces between them, do not use data transformation formulas to trim out the spaces. If you do, the spaces will still appear and the replication activity will continuously update.
Data Transformation The Data Transformation section provides options for executing formulas to transform data.
The following table describes the Data Transformation options.
Transformation formulas should be prefixed with “select @all;”. For example, to assign a field value, enter the formula <select @all; FIELD NewField := “New Value”;>.
Data Creation The Data Creation section provides options for managing data creation with the Notes database during processing of any activities associated with the Connection.
The following table describes the Data Creation options.
select column1, column2 from table where SendTo="name@email.com"
To use this option successfully, the LEI Notes ID must have sufficient access to the database to enable modification of Notes replication settings.
Encrypt Enabled Fields -- Encrypts all enabled fields in the form of the target document.
Private Encyption Key(s) -- To use private encryption keys (the default is to use the public key), provide one or more private encryption key names, separated by commas or semicolons in this field. These keys must be available on the LEI server.
For more information on encryption, see Domino Designer Help.
This option should not be selected when the target Domino server is part of a Domino cluster because the database may be created in an inconsistent state. When the target is a Domino cluster, create the database using a Notes client prior to running the LEI activity.