The following feature is new in Ignition version 8.1.8
Click here to check out the other new features
This function is used in Python Scripting.

Description

Adds a new OPC UA connection. 

Syntax

system.opcua. addConnection(name, description, discoveryUrl, endpointUrl, securityPolicy, securityMode, settings )

  • Parameters

String name - Name to assign to the new connection. 

String description - Description assigned to the new OPC UA connection. 

String discoveryUrl - Endpoint URL to use for discovery services.

String endpointUrl  - Endpoint URL to use for session services. 

String securityPolicy - The name of the SecurityPolicy to use. See the Security Policy table below for possible values. 

String securityMode - The name of the MessageSecurityMode to use. See the Message Security Mode table below for possible values.

Dictionary[String, Any] settings - A dictionary of additional settings to apply to the connection. See the Settings table for a table of possible keys.  

  • Returns

Nothing

  • Scope

Gateway, Perspective Session

Security Policy

Below is a listing of supported values for the securityPolicy argument:

None
Basic128Rsa15
Basic256
Basic256Sha256
Aes128_Sha256_RsaOaep
Aes256_Sha256_RsaPss

Message Security Mode

Below is a listing of supported values for the messageSecurityMode argument:

None
Sign
SignAndEncrypt

Settings 

Below is a listing of supported values for the settings argument: 

KeyData Type
ENABLEDBoolean
DISCOVERYURLString
ENDPOINTURLString
SECURITYPOLICYString
SECURITYMODEString
USERNAMEString
PASSWORDString
HOSTOVERRIDEString
CONNECTTIMEOUTInteger
ACKNOWLEDGETIMEOUTInteger
REQUESTTIMEOUTInteger
SESSIONTIMEOUTInteger
MAXPEROPERATIONInteger
MAXREFERENCESPERNODEInteger
MAXPENDINGPUBLISHREQUESTSInteger
MAXPENDINGPUBLISHREQUESTSInteger
MAXNOTIFICATIONSPERPUBLISHInteger
MAXMESSAGESIZEInteger
MAXARRAYLENGTHInteger
MAXSTRINGLENGTHInteger
TYPEDICTIONARYFRAGMENTSIZEInteger
KEEPALIVEFAILURESALLOWEDInteger
KEEPALIVEINTERVALInteger
KEEPALIVETIMEOUTInteger
BROWSEORIGINString
CERTIFICATEVALIDATIONENABLEDBoolean
KEYSTOREALIASString
KEYSTOREALIASPASSWORDString
FAILOVERENABLEDBoolean
FAILOVERTHRESHOLDInteger
FAILOVERDISCOVERYURLString
FAILOVERENDPOINTURLString
FAILOVERHOSTOVERRIDEString
Code Examples
Code Snippet
# The following could be used to connect to Ignition's OPC UA server. 
system.opcua.addConnection(
	"test",
	"test desc",
	"opc.tcp://localhost:62541/discovery",
	"opc.tcp://localhost:62541",
	"Basic256Sha256",
	"SignAndEncrypt",
	{
	"username":"opcuauser",
	"password":"password"
	}
)
Keywords

system opcua addConnection, opcua.addConnection