Connectors have two types of configuration properties: standard configuration properties and adapter-specific configuration properties. You must set the values of these properties before running the adapter with the Connector Configurator, a tool provided with the WebSphere Business Integration Adapters. When you have finished specifying values for the connector's configuration properties, Connector Configurator saves the values in a repository where it will be available to the adapter upon startup.
You use Connector Configurator to configure connector properties:
Standard configuration properties provide information that all adapters use. See Appendix A, Standard configuration properties for connectors for documentation of these properties.
The connector obtains its configuration values at startup. During a run-time session, you may want to change the values of one or more connector properties.
To determine whether a property is dynamic or static, refer to the update method column in Connector Configurator.
Note that logging and tracing parameters are standard configuration properties. For more information about setting up logging and tracing, refer to Appendix A, Standard configuration properties for connectors.
Application-specific connector configuration properties provide information needed by the connector at run time. They also provide a way for you to change static information or logic within the connector without having to recode and rebuild it.
To view and configure these properties, select the Connector Configurator Application Config Properties tab to add or modify configuration properties. For more information, see Appendix B, "Connector Configurator"..
Table 3 lists the application-specific configuration properties for the connector, along with their descriptions and possible values.
Table 3. Application-specific configuration properties for Lotus Domino
Property | Description | Type | Default value |
---|---|---|---|
DominoServerName |
machine name of Domino server | string | none |
ApplicationUserName |
Domino user name | string | none |
ApplicationPassword |
Domino user password | string | none |
EventDBName
|
Domino event database name | string | BIALD_EventTable.nsf |
DocumentBOName
|
Name of the business object for Lotus Domino | string | DominoDocument |
ForceSave
|
When the adapter is processing a Create or Update request, if ForceSave is true, the document is saved even if someone else edits and saves the document while the adapter is processing the request. The last version of the document is the one that is saved; the earlier version is discarded. If false, and someone else edits the document while the adapter is processing the request, the MakeResponse property determines the outcome. | Boolean | false |
MakeResponse
|
When the adapter is processing a Create or Update request, if ForceSave is false and MakeResponse is true, the current document becomes a response to the original document. If MakeResponse is false, the save is cancelled. If ForceSave is true, the MakeResponse property has no effect. | Boolean | true |
ForceDelete
|
When the adapter is processing a Delete request, if ForceDelete is true the document is removed even if another user modifies the document after the adapter opens it. If false, the document is not removed if another user modifies it. | Boolean | false |
InDoubtEvents
|
Recovery options for InProgress events. Possible values: Reprocess, FailOnStartup, LogError, or Ignore. Refer to Table 4 for descriptions of these options. | string | Reprocess |
DateFormats |
Possible formats of Created and LastModified dates for incoming business objects. When a business object is received from the integration broker, the Domino adapter must convert its Created and LastModified dates to the Java format understood by the Lotus Domino server. Multiple formats can be specified, separated by a semicolon (;). The adapter will compare the incoming date with the specified formats in the order listed. If no format is specified, the date format on the adapter's host system is used.The date format must conform to that required by the java.text.SimpleDateFormat API in the Java 2 Platform, Standard Edition (J2SE) v1.3.1. | string |
MM/dd/yy hh:mm aaa; MM/dd/yy |
You must configure DominoServerName, ApplicationUserName, and ApplicationPassword. If a server name, user name, and password are defined in the business object received from the broker, then these are used to establish the adapter's session with the Domino server. If the business object does not contain any of these items, the adapter uses the values defined for them in the configuration file.
Table 4 defines the possible values for InDoubtEvents. An
in-doubt event is one that was being processed when the adapter terminates,
and before the adapter could update the event status to indicate whether the
event was either successfully sent or failed. When the adapter is
restarted, it checks the event table for events that were in progress and take
action depending upon which option has been configured for the InDoubtEvents
property.
Table 4. Possible values for InDoubtEvents property