Connector Command

<< Click to Display Table of Contents >>

Navigation:  Development > Client > Redis/JSON >

Connector Command

 

Connector Commands are used throughout DTS to activate and deactivate connectors in components. From a Client's perspective, it will receive Connector Commands to signal the Activation or Deactivation of connectors targeted by the projects currently open in the Client. It may also receive Kick Connector Commands to be notified that it no longer has access to a certain project.

Activation commands will contain the full description of the Connector, including descriptors for all collections, routines and types involved.

 

 

{

 "name" : "",

 "projectName" : "",

 "connectorEntry" : {

         "name" : "",

         "type" : "",

         "channel" : "",

         "replicaCount" : "",

         "parametersContainer" : {

                 "development" : {},

                 "testing" : {},

                 "production" : {}

         },

         "collections" : [

                 <CollectionResources>

         ],

         "remotes" : [

                 <RemoteCallResources>

         ],

         "types" : [

                 <TypeResources>

         ]

 },

 "reconnect" : false,

 "reason" : ""

}

 

Attribute

Value

Note

name

The name of the command

"ACTIVATE_CONNECTOR", "DEACTIVATE_CONNECTOR" or "KICK"

projectName

The name of the project that is the subject of the command

 

connectorEntry

Wrapper for the descriptor of the connector that is the subject of the command

Not used for KICK commands

 

name

The name of the connector

 

 

type

The type code of the connector

 

 

channel

Channel assigned to the connector

Not applicable to Client

 

replicaCount

Maximum number of producers

Not applicable to Client

 

parametersContainer

Wrapper for the connection parameters to a connector's data source.

Not applicable to Client

 

collections

The list of collections that the connector can serve as CollectionResource objects

These are full descriptions of the collections served, with fields, types and constraints (only present on activation)

 

remotes

The list of remote calls that the connector can serve as RemoteCallResource objects

These describe the details of the native routines that can be accessed with full descriptions of inputs and outputs (only present on activation

 

types

The list of non-trivial data types that the connector relies on as TypeResource objects

These are full descriptions of any structure types present in any fields or parameters served by the connector (only present on activation)

reconnect

Only for KICK commands - whether or not a reconnect should be attempted

 

reason

Only for KICK commands - the reason for being kicked

 

 

 

 

The response the client must provide to a Connector Command Request is the "DONE" acknowledgment string. If the request generated errors, the response should be null and the error should be included in the response message's error attribute.