The ConnectionConfigurationSetType is an ObjectType representing one or more Connection configurations. Connections are grouped in a set, for example, to allow sharing communication model configurations by multiple Connections; see 5.5.6.2.3 and 5.5.6.2.4 for appropriate use cases.

ConnectionConfigurationSets are generated and deployed to the ConnectionManager (see Figure 11 label 3). The ConnectionManager may expose the ConnectionConfigurationSet in its AddressSpace.

If a ConnectionConfigurationSet is exposed in the AddressSpace, its representation serves two purposes: making Connection configurations available for modification by standard Clients (see Figure 11 label 4) and providing an interface to trigger the processing of such Connection configurations.

A ConnectionConfigurationSet may only be modified by a standard Client as follows:

With these mechanisms, the generator of the ConnectionConfigurationSet is able to specify and restrict the allowed changes.

For an overview of the ConnectionConfigurationSetType with its related types, see Figure 35. For examples, see Annex E.

The ConnectionConfigurationSetType is illustrated in Figure 37.

image040.png

Figure 37 – ConnectionConfigurationSetType illustration

The ConnectionConfigurationSetType is formally defined in Table 84 and Table 85.

Table 84 – ConnectionConfigurationSetType definition

Attribute

Value

BrowseName

4:ConnectionConfigurationSetType

IsAbstract

False

References

NodeClass

BrowseName

DataType

TypeDefinition

Other

Subtype of the 0:BaseObjectType defined in OPC 10000-5

0:HasComponent

Object

4:ConnectionConfigurationSetStateMachine

4:ConnectionConfigurationSetStateMachineType

M

0:HasProperty

Variable

4:Edit

0:Boolean

0:PropertyType

O, RO

4:HasConnectionConfiguration

Object

4:<Connection>

4:ConnectionConfigurationType

MP

4:HasCommunicationFlowConfiguration

Object

4:<CommunicationFlow>

4:CommunicationFlowConfigurationType

MP

4:HasServerAddress

Variable

4:<ServerAddress>

4:ServerAddressDataType

4:ServerAddressType

MP

4:HasAutomationComponentConfiguration

Object

4:<AutomationComponentConfiguration>

4:AutomationComponentConfigurationType

MP

0:HasProperty

Variable

4:RollbackOnError

0:Boolean

0:PropertyType

M

0:HasComponent

Object

5:Lock

5:LockingServicesType

M

0:HasComponent

Variable

4:SecurityKeyServer

4:SecurityKeyServerAddressDataType

4:SecurityKeyServerAddressType

O

ConformanceUnits

UAFX ConnectionManager Base

Table 85 – ConnectionConfigurationSetType additional references

SourceBrowsePath

Reference Type

IsForward

TargetBrowsePath

4:<ServerAddress>

4:ToAutomationComponentConfiguration

True

4:<AutomationComponentConfiguration>

4:<AutomationComponentConfiguration>

4:ToConnectionEndpointConfiguration

True

4:<Connection>

4:Endpoint1

4:<AutomationComponentConfiguration>

4:ToConnectionEndpointConfiguration

True

4:<Connection>

4:Endpoint2

ConnectionConfigurationSetStateMachine contains the current State of this ConnectionConfigurationSet. See 6.9 for a formal definition of the state machine.

If Edit is present, the ConnectionConfigurationSet supports editing. If Edit is TRUE, the ConnectionConfigurationSet is currently being edited by a Client. See 6.7.3 on editing a ConnectionConfigurationSet.

<Connection> represents one or more instances of ConnectionConfigurationType, which defines Connection configurations to be established. For a formal definition, see 6.10.

<CommunicationFlow > represents one or more instances of CommunicationFlowConfigurationType, which defines communication model-specific configuration to apply to a Connection. For a formal definition, see 6.13. There may be fewer instances of this type than ConnectionConfigurations.

<ServerAddress> represents one or more instances of ServerAddressType, which define addressing information for AutomationComponents. For a formal definition, see 9.2. There may be fewer instances of this type than ConnectionConfigurations.

<AutomationComponentConfiguration> represents one or more AutomationComponents. In addition, it holds the parameters used for Asset verification. For a formal definition, see 6.14.

RollbackOnError indicates the behaviour that should be followed when there is an error on Connection establishment. If this Property is TRUE and an error occurs during the Connection establishment sequence, processing of the set will stop, and all established Connections that are part of this set shall be closed (see 6.7.4.3.1).

It is recommended that the system integrator Client use the Role ConfigureAdmin as defined in Clause 5.9 for accessing this Object. It is recommended that modifiable content of the ConnectionConfigurationSet has the write privilege for the Role ConfigureAdmin as defined in Clause 5.9.

Lock is an instance of LockingServicesType, defined in OPC 10000-100, which provides the basic locking functionality. A ConnectionConfigurationSet that is not in editable mode shall be locked to the ConnectionManager and blocked from any changes (the Client is set to NodeId of the ConnectionManager, and the user is set to “CM”). A Client can call the EditConnectionConfigurationSets Method on a ConnectionManager to release the Lock from the ConnectionManager and assign it to the Client that issued the EditConnectionConfigurationSets Method Call (for additional details, see 6.7.3).

The optional SecurityKeyServerAddress defines the location of the SKS to be used for PubSub security configuration of this ConnectionConfigurationSet. For a formal definition, see 9.3.

NOTE:   Depending on the environment, the list may contain the address of a GDS acting as SKS, the address of the ConnectionManager itself if providing SKS functionality, or other SKS within the network.

The ToAutomationComponentConfiguration Reference is used to link a ServerAddress to AutomationComponentConfiguration (see 6.14). The ServerAddress provides the Connection information to address the referenced AutomationComponent.

The ToConnectionEndpointConfiguration Reference is used to link an AutomationComponentConfiguration to ConnectionEndpointConfigurations (see 6.11).

The ToOutboundFlow Reference is used to link a ConnectionEndpointConfiguration to a PubSubCommunicationFlowConfiguration (see 6.13.3). This Reference defines the PubSub- specific configuration to be used for the transmission of output data related to this ConnectionEndpoint. It shall be present if an out bound PubSub flow is configured.

The ToInboundFlow Reference is used to link a ConnectionEndpointConfiguration to a SubscriberConfiguration (see 6.13.3.3). This Reference defines the PubSub- specific configuration to be used for the reception of input data related to this ConnectionEndpoint. It shall be present if an in-bound PubSub flow is configured.

A ConnectionEndpointConfiguration shall have at most one ToOutboundFlow and at most one ToInboundFlow reference.

The References used to link a ConnectionEndpointConfiguration to Client / Server specific communication configuration will be defined in a later version of this document.

NOTE   For an overview of how to configure the various Connection types, see Annex E.