Required Resource Attributes (Oracle Waveset 8.1.1 Deployment Guide)

Oracle Waveset 8.1.1 Deployment Guide

Required Resource Attributes

The following table describes required resource attributes that are supplied in the skeleton adapter files.

Table 10–5 Resource Attributes in Skeleton Adapter Files


Required Resource Attribute	Description
`RA_HOST`	Resource host name. This attribute corresponds to the Host field on the Resource Parameters page.
`RA_PORT`	Port number used to communicate with the resource. This attribute corresponds to the Port field on the Resource Parameters page.
`RA_USER`	Name of a user account that has permission to connect to the resource. The field name varies on the Resource Parameters page.
`RA_PASSWORD`	Password for the account specified by `RA_USER`. This attribute corresponds to the Host field on the Resource Parameters page.

The next table describes required Active Sync-specific attributes that are defined in the ACTIVE_SYNC_STD_RES_ATTRS_XML string of the Active Sync class.

Table 10–6 Active Sync-Specific Attributes Defined in ACTIVE_SYNC_STD_RES_ATTRS_XML


Required Resource Attribute	Description
`RA_PROXY_ADMINISTRATOR`	Waveset administrator for authorization and logging. This attribute corresponds to the Proxy Administrator field in the Waveset display. You do not define this value in the adapter Java file. Instead, an administrator enters this information when defining a specific instance of this resource type.
`RA_FORM`	Form that processes incoming attributes and maps them to view attributes. This attribute corresponds to the Input Form field.
`RA_MAX_ARCHIVES`	Specifies the number of log files to retain. If you specify `0`, then a single log file is re-used. If you specify `-1`, then log files are never discarded.
`RA_MAX_AGE_LENGTH`	Specifies the maximum time before a log file is archived. If you specify zero, then no time-based archival occurs. If the `RA_MAX_ARCHIVES` value is zero, then the active log is truncated and reused after this time period.
`RA_MAX_AGE_UNIT`	Specify seconds, minutes, hours, days, weeks, or months. Use this value with `RA_MAX_AGE_LENGTH`.
`RA_LOG_LEVEL`	Logging level (0 disabled; 4 very verbose). This attribute corresponds to the Log Level field in the Waveset display.
`RA_LOG_PATH`	Absolute or relative path for the log file. This attribute corresponds to the Log File Path field in the Waveset display.
`RA_LOG_SIZE`	Maximum log file size. This attribute corresponds to the Maximum Log File Size field in the Waveset display.
`RA_SCHEDULE_INTERVAL`	Pop-up menu of the supported scheduling intervals (second, minute, hour, day, week, month).
`RA_SCHEDULE_INTERVAL_COUNT`	Number of intervals between scheduled periods (for example, 10 minutes has an interval count of 10 and an interval of minute). Not necessary for Active Sync-enabled adapters.
`RA_SCHEDULE_START_TIME`	Time of the day to run. For example, if you specify 13:00 and set the interval to week, the adapter runs at 1 P.M. once a week. Not necessary for Active Sync-enabled adapters.
`RA_SCHEDULE_START_DATE`	Date to start scheduling. Setting date to `20020601`, the interval to `month`, and the time to `13:00` starts the adapter on June 1st and runs once a month at 1 P.M. Not necessary for Active Sync-enabled adapters.

This table describes required Active Sync-specific attributes that are defined in the ACTIVE_SYNC_EVENT_RES_ATTRS_XML string of the Active Sync class.

Table 10–7 Active Sync-Specific Attributes Defined in ACTIVE_SYNC_EVENT_RES_ATTRS_XML


Required Resource Attribute	Description
`RA_PROCESS_RULE`	Name of a `TaskDefinition` or a rule that returns the name of a `TaskDefinition` to run for every record in the feed. This attribute overrides all others.
`RA_CORRELATION_RULE`	Rule that returns a list of strings of potentially matching users/accountIDs, based on the resource account attributes in the account namespace.
`RA_CONFIRMATION_RULE`	Rule that confirms whether a user is a match.
`RA_DELETE_RULE`	Rule that determines whether a delete detected on the resource is processed as an IAPI delete event, or as an IAPI update event.
`RA_CREATE_UNMATCHED`	If set to `true`, creates unmatched accounts. If false, do not create the account unless the process rule is set and the workflow it identifies determines that a create is warranted. Default is `true`.
`RA_RESOLVE_PROCESS_RULE`	Rule that determines the workflow to run when there are multiple matches using the confirmation rule on the results of the correlation rule.
`RA_POPULATE_GLOBAL`	Indicates whether to populate the global namespace in addition to the `activeSync` namespace. Default is `false`.