Required Adaptor Service Builder Configuration

Builder Property Description Example Notes

uuid

Adaptor UUID

aa8b8a53-b49f-47f7-a9cd-bd5e0ff909bc

Obtained when registering the Adaptor with YOUnite

clientId

Client ID

6ccb861b-0400-423c-94d6-1df32096de34

Obtained when registering the Adaptor with the YOUnite Server. Used to authenticate with the message bus.

clientSecret

Client Secret

f744544d-d1cf-4561-9d50-27a9fef8d076

Obtained when registering the Adaptor with the YOUnite Server. Used to authenticate with the message bus.

messageBusUrl

URL of the Message Bus

tcp://YOUnite-mb.example.com:61616

Address of the message bus

Optional Adaptor Service Builder Configuration

Builder Property Description Example Default Value Notes

assemblyConcurrency

Message bus concurrency for data virtualization events (i.e. federated GET).

1

1

Concurrency for incoming assembly messages, ie, number of threads that will handle incoming messages. These are federated GET requests. Expressed as a range, ie "1-5" or a single value indicating the maximum (with an implied minimum of 1).

autoStartDataListener

Automatically start the data listener when the connection to YOUnite has been established

true

true

Can be set to false to allow the application to manually start the data listener

changeListener

Register a ChangeListener for a domain version

None

For each domain version register either a Datasource OR a DomainVersionHandler and ChangeListener

concurrency

Message bus concurrency for data events

1

1

Concurrency for incoming data messages, ie, number of threads that will handle incoming messages. Note that this could lead to messages being processed out of order, though they are guaranteed to be processed in order based on their message grouping (the default is unique ID of the record, ie the DR UUID).

datasource

Register a Datasource for a domain version

None

A Datasource must be registered for each domain version that the adaptor is capable of handling or the adaptor will fail to start.

enableMetrics

Enable metrics

true

true

Metrics log the number of incoming and outgoing messages over various intervals.

hooks

Hooks to execute code before/after start and stop or on an error

None*

*When useDefaultHooks=true, default hooks are used for sourceDataListeners (see below)

messagePostProcessor

Post processor for outgoing JMS messages

None

This could be used to add headers to messages, or modify the payload before the message is sent to YOUnite.

metricsLogInterval

Interval in milliseconds to display the metrics in the adaptor logs.

3,600,000

3,600,000 (one hour)

opsConcurrency

Message bus concurrency for operational messages

1

1

Concurrency for incoming ops messages, ie, number of threads that will handle incoming messages. These are messages with adaptor status information and metadata, request for stats, shutdown requests. Expressed as a range, ie "1-5" or a single value indicating the maximum (with an implied minimum of 1).

sessionCacheSize

JMS Session cache size

10

10

Specifies the size of the cache of sessions to be used for JMS communication.

useDefaultHooks

Use the default hooks for the sourceDataListeners (if any)

true

true

The default hooks start each sourceDataListener on AFTER_START and stop each sourceDataListener on BEFORE_STOP and ON_ERROR.