Dynamic Connection

Note: The Dynamic Connection activity cannot be used to create dynamic connections for invoking RFC/BAPIs in load-balancing mode.

General

In the General tab, you can maintain a reference to the SAP Connection shared resource and configure the activity accordingly to either create a dynamic connection or close an existing dynamic connection.

The following table lists the configurations in the General tab of the Dynamic Connection activity:

Field	Module Property?	Description
Name	No	Specify the name to be displayed as the label for the activity in the process.
SAP Connection	Yes	Click to select an SAP Connection shared resource. The SAP Connection shared resource establishes connections between the plug-in and the SAP system. If no matching SAP Connection shared resources are found, click Create Shared Resource to create one. For more details, see Creating and Configuring an SAP Connection. Note: The SAP Connection shared resource is used to provide default settings for any connection parameters that are not defined in the input of the activity.
Terminate Connection	No	Select this check box to terminate the dynamic connection when it is no longer required. This check box is the same as the Context End check box in the Advanced tab of the Invoke RFC BAPI in SAP activity. When a dynamic connection with the selected Transactional check box is used, if you want to end the transaction, you must select the Terminate Connection check box instead of selecting the Context End check box.
Transactional	No	Select this check box to enable the dynamic connection to be used with one or more RFC/BAPIs as part of a transaction. Note: As part of the same ActiveMatrix BusinessWorks process, using a dynamic connection with RFC/BAPIs running as a transaction or non-transaction is not supported.

Description

In the Description tab, you can enter a short description for the Dynamic Connection activity.

Input

In the Input tab, you can specify detailed information for the dynamic connection you want to configure for invoking RFC/BAPIs.

The following table lists the input elements in the Input tab of the Dynamic Connection activity:

Input Item	Data Type	Description
sessionID	String	Enter the session ID of the dynamic connection that is used for invoking RFC/BAPIs. The session ID has to be mapped when you are terminating an existing dynamic connection.
contextTimeout	Long	Enter the timeout value in milliseconds for the activity to wait for the subsequent activity to be invoked. The default value is 30000. This field is used only when the dynamic connection is used as part of a transaction. This input element is the same as the Commit Expiry(ms) field in the Advanced tab of the Invoke RFC/BAPI activity, and can be overwritten by the Commit Expiry(ms) field. Note: The module property of the long type cannot be left blank, and its value range does not include the negative numbers.
The following input elements are under the DynamicConnections node:
connectionType	String	Specify the type of the dynamic connection. The value of this input element is not case-sensitive. The value of 1 or dedicated indicates the dedicated connection. The value of 2 or logongroup indicates the SAP logon group connection. The value of 3 or snc indicates the SNC connection. For more information about SNC, see Working with Secure Communication.
appServer	String	Specify the SAP application server by using either the host name or IP address.
systemNumber	String	Specify the system number of the SAP system.
client	String	Specify the client number of the SAP system.
userName	String	Specify the user ID used to log on to the SAP system.
password	String	Specify the password for logging on to the SAP system. The password attribute is part of the XSD schema. You have to define a module property as the password type, and map the defined module property to the password. Note: This password is not required when you log on by using the SNC connection type.
systemName	String	Specify the ID of the SAP system. This field is required when using the connections of the logon group type.
msgServer	String	Specify the SAP message server used for load balancing. This field is required when using the connections of the logon group type.
groupName	String	Specify the name of the SAP logon group. This field is required when using the connections of the logon group type.
snc_mode	String	Specify whether to enable SNC connectivity. Set the value to 0 to disable SNC connectivity. Set the value to 1 to enable SNC connectivity.
snc_partnername	String	Specify the SNC name of the communication partner, which is an application server, if you set snc_mode to 1.
snc_qop	String	Specify the SNC quality of protection if you set snc_mode to 1. Set the value to 1 to apply authentication only. Set the value to 2 to apply integrity protection. Set the value to 3 to apply privacy protection. Set the value to 8 to apply the default protection. Set the value to 9 to apply the maximum protection.
snc_lib	String	Specify the path of the crypto libraries on the machine where the ActiveMatrix BusinessWorks process is running.
snc_bSSO		Specify whether to enable Single Sign-On (SSO). Set the value to 0 to disable SSO. Set the value to 1 to enable SSO.
snc_SSOrecv	String	Specify the string of the SSO logon ticket.
snc_x509	String	Specify the X.509 certificate that the SNC connection uses for authentication.
codePage	String	Specify the character sets used by SAP and databases. The default value is 1100.
language	String	Specify the language used to log on to the SAP system. If the value is not populated, the default language is English.
rfcTrace	String	Specify whether to enable RFC trace as part of the connection. Set the value to 0 to disable RFC trace. Set the value to 1 to enable RFC trace.
useSAPGUI	String	Specify whether to enable SAP GUI as part of the connection. Set the value to 0 to disable SAP GUI from carrying out debugging of RFCs. Set the value to 1 to enable SAP GUI to carry out debugging of RFCs. Set the value to 2 to enable SAP GUI to carry out debugging of RFCs until used by an invocation of an RFC.

Output

The Output tab displays the detailed information about the dynamic connection.

The following table lists the output elements in the Output tab of the Dynamic Connection activity:

Output Item	Data Type	Description
sessionID	String	Displays the session ID associated with the dynamic connection. This is the same session ID that is mapped to the input schema of the Invoke RFC/BAPI in SAP activity or the Dynamic Connection activity where the connection is being terminated.
CPIC_ID	String	Displays the CPIC ID associated with the dynamic connection as part of a transaction. The CPIC ID is provided for information purposes only.
The following input elements are under the DynamicConnections node:
connectionType	String	Displays the type of the dynamic connection. The value of this output element is not case sensitive. The value of 1 or dedicated indicates the dedicated connection. The value of 2 or logongroup indicates the SAP logon group connection. The value of 3 or snc indicates the SNC connection.
appServer	String	Displays the SAP application server specified by using either the host name or IP address.
systemNumber	String	Displays the system number of the SAP system.
client	String	Displays the client number of the SAP system.
userName	String	Displays the user ID used to log on to the SAP system.
password	String	Displays the password for logging on to the SAP system.
systemName	String	Displays the ID of the SAP system.
msgServer	String	Displays the SAP message server used for load balancing.
groupName	String	Displays the name of the SAP logon group.
snc_mode	String	Displays whether to enable SNC connectivity.
snc_partnername	String	Displays the SNC name of the communication partner, which is an application server, if you set snc_mode to 1.
snc_qop	String	Displays the SNC quality of protection if you set snc_mode to 1.
snc_lib	String	Displays the path of the crypto libraries on the machine where the ActiveMatrix BusinessWorks process is running.
snc_bSSO		Displays whether to enable SSO.
snc_SSOrecv	String	Displays the string of the SSO logon ticket.
snc_x509	String	Displays the X.509 certificate that the SNC connection uses for authentication.
codePage	String	Displays the character sets used by SAP and databases.
language	String	Displays the language used to log on to the SAP system.
rfcTrace	String	Displays whether to enable RFC trace as part of the connection.
useSAPGUI	String	Displays whether to enable SAP GUI as part of the connection.

Fault

In the Fault tab, you can find the error codes and error messages of the Dynamic Connection activity. See Error Codes for more detailed explanation of errors.

The following table lists error schema elements in the Fault tab of the Dynamic Connection activity:

Error Schema Element	Data Type	Description
`msg`	String	Displays the error message.
`msgCode`	String	Displays the error code.

Contents