Configure the Web Services (SOAP) Output adapter by specifying values for the SOAP Output transporter, the ESP connector (EspSubscriber), and Event Stream Processor.
XML Element | Description |
---|---|
Log4jProperty |
Type: string (Optional) Specify a full path to the log4j.properties logging file you wish to use. The default value is $ESP_HOME/adapters/framework/config/log4j.properties. |
The ESP Subscriber module obtains data from an ESP project and passes it along to a transporter or formatter module.
XML Element | Description |
---|---|
Module |
(Required) Element containing all information for this module. It contains a type attribute for specifying the module type. For example, espconnector. |
InstanceName |
Type: string (Required) Instance name of the specific module you want to use. For example, MyInputTransporter. |
Name |
Type: string (Required) Name of the module as defined in the modulesdefine.xml file. For example, <TransporterType>InputTransporter. |
Next |
Type: string (Required) Instance name of the module that follows this one. |
BufferMaxSize |
Type: integer (Advanced) Capacity of the buffer queue between this module and the next. The default value is 10240. |
Parameters | (Required) Section containing the EspSubscriberParameters elements. |
EspSubscriberParameters |
(Required) Element containing elements for the ESP subscriber. |
ProjectName |
Type: string (Required if running adapter in standalone mode; optional if running in managed mode) Specifies the unique project tag of the ESP project to which the adapter is connected. For example, EspProject2. This is the same project tag that you specify later in the adapter configuration file in the Name element within the Event Stream Processor (EspProjects) element. If you are starting the adapter with the ESP project to which it is attached (running the adapter in managed mode), you do not need to set this element as the adapter automatically detects the project name. |
StreamName |
Type: string (Required if running adapter in standalone mode; optional if running in managed mode) Name of the ESP stream from which the adapter subscribes to data. If you are starting the adapter with the ESP project to which it is attached (running the adapter in managed mode), you do not need to set this element as the adapter automatically detects the stream name. |
GDMode |
Type: boolean (Advanced) If set to true, the adapter runs in guaranteed delivery (GD) mode and all GD-related parameters become required. Default value is false. |
GDKeyColumnName |
Type: string (Advanced) Specifies column name in the Flex operator holding the GD key. The GD key is a constantly increasing value that uniquely identifies every event regardless of the opcode in the stream of interest. No default value. |
GDOpcodeColumnName |
Type: string (Advanced) Specifies name of column in Flex operator holding opcode. The opcode is the operation code (for example, inserts, update, or delete) of the event occurring in the stream of interest. No default value. |
GDBatchSize |
Type: integer (Advanced) Specifies number of records after which the control window must be updated with the latest GD key. Default value is 3. |
GDPurgeInterval |
Type: integer (Advanced) Specifies number of records after which to purge the Flex operator. Default value is 1000. |
GDControlStream |
Type: string (Advanced) Specifies name of the control window in the GD setup. The control window is a source stream that informs the Flex operator of which data has been processed by the adapter and can be safely deleted. No default value. |
The SOAP Output transporter connects to a Web service, converts Event Stream Processor data into Web services request format, and outputs it to a Web service.
XML Element | |
---|---|
BasicAccessAuthentication |
(Required only if using HTTP basic access authentication) Stores the credentials used to authenticate against a Web service that is set up with HTTP basic access authentication. Element containing the credentials, User, Password, RSAKeyStore, RSAKeyStorePassword and EncryptionAlgorithm elements for WS policy security. |
credentials |
(Optional) Element containing the User, Password, RSAKeyStore, RSAKeyStorePassword and EncryptionAlgorithm elements. |
User |
Type: string (Required) Specifies the user name required to connect to the Web service. |
Password |
Type: string (Required) Specifies the password required to connect to the Web service. Includes an encrypted attribute indicating whether the Password value is encrypted. Default value is false. If set to true, the password value is decrypted using RSAKeyStore and RSAKeyStorePassword. |
RSAKeyStore |
Type: string (Optional) Specify the location of an RSA keystore file which contains the key used to encrypt or decrypt the password set in the Password element. |
RSAKeyStorePassword |
Type: string (Optional) Stores the password to the RSA keystore file specified in the Keystore element. |
EncryptionAlgorithm |
Type: string (Optional) Specifies the algorithm that is used to decrypt the password specified in the Password element, if encrypted. For example, RSA. |
element | Description |
---|---|
WSPolicy |
(Required only if using WS policy security) Element containing the credentials, User, Password, RSAKeyStore, RSAKeyStorePassword, policyClass, and param elements for WS policy security. |
credentials |
(Optional) Element containing the User, Password, RSAKeyStore, and RSAKeyStorePassword elements. |
User |
Type: string (Optional) Specifies the user name required to connect to the Web service. |
Password |
Type: string (Optional) Specifies the password required to connect to the Web service. Includes an "encrypted" attribute indicating whether the Password value is encrypted. Default value is false. If set to true, the password value is decrypted using RSAKeyStore and RSAKeyStorePassword. |
RSAKeyStore |
Type: string (Optional) Specify the location of an RSA keystore file which contains the key used to encrypt or decrypt the password set in the Password element. |
RSAKeyStorePassword |
Type: string (Optional) Stores the password to the RSA keystore file specified in the Keystore element. |
policyClass |
Type: string (Required only if using WS policy security) Specifies the plugin class to use that provides the policy information to the system. This class must extend from the class com.sap.esp.adapter.ws.security.WSPolicy. |
param |
Type: string (Optional) Specifies the elements needed by the security mechanism of the WS policy. Includes "name" and "value" attributes. |
element | Description |
---|---|
TransportUsernameToken |
(Required only if using transport level security) Element containing the credentials, User, Password, RSAKeyStore, RSAKeyStorePassword, and EncryptionAlgorithm elements. This type of security uses a username/token which is signed at the transport level. |
credentials |
(Required) Element containing the User, Password, RSAKeyStore, RSAKeyStorePassword, and EncryptionAlgorithm elements. Specifies credentials for transport level security. |
User |
Type: string (Required) Specifies the user name required for connecting to the Web service. |
Password |
Type: string (Required) Specifies the password required to connect to the Web service. Includes an "encrypted" attribute indicating whether the Password value is encrypted. Default value is false. If set to true, the password value is decrypted using RSAKeyStore and RSAKeyStorePassword. |
RSAKeyStore |
Type: string (Optional) Specify the location of an RSA keystore file which contains the key used to encrypt or decrypt the password set in the Password element. |
RSAKeyStorePassword |
Type: string (Optional) Stores the password to the RSA keystore file specified in the Keystore element. |
EncryptionAlgorithm |
Type: string (Optional) Specifies the algorithm that is used to decrypt the password specified in the Password element, if encrypted. For example, RSA. |
element | Description |
---|---|
workingDir |
Type: string (Required) Element containing the proxy, host, port, and nonProxyHost elements. The directory where temporary adapter files are written. These files are cleaned up when the adapter shuts down. |
proxy |
(Optional) Element containing the host, port, and nonProxyHosts elements. These properties specify a proxy server address through which the HTTP traffic is routed. This is often required in corporate networks, such as SAP, as individual machines do not connect directly to the external internet. |
host |
Type: string (Optional) If the adapter needs to connect through a proxy, specify the host of the proxy through which the adapter is connecting. |
port |
Type: integer (Optional) If the adapter needs to connect through a proxy, specify the host of the proxy through which the adapter is connecting. |
nonProxyHosts |
Type: string (Optional) Specify the host names which should not be routed through the proxy host. These are addresses located within the intranet that can be reached directly. |
Event Stream Processor elements configure communication between Event Stream Processor and the Web Services (SOAP) Output adapter.
XML Element | Description |
---|---|
EspProjects |
(Required) Element containing elements for connecting to Event Stream Processor. |
EspProject |
(Required) Element containing the Name and Uri elements. Specifies information for the ESP project to which the adapter is connected. |
Name |
Type: string (Required) Specifies the unique project tag of the ESP project which the EspConnector (publisher/subscriber) module references. |
Uri |
Type: string (Required) Specifies the total project URI to connect to the ESP project. For example, esp://localhost:19011/ws1/p1. |
Security |
(Required) Element containing all the authentication elements below. Specifies details for the authentication method used for Event Stream Processor. |
User |
Type: string (Required) Specifies the user name required to log in to Event Stream Processor (see AuthType). No default value. |
Password |
Type: string (Required) Specifies the password required to log in to Event Stream Processor (see espAuthType). Includes an "encrypted" attribute indicating whether the Password value is encrypted. The default value is false. If set to true, the password value is decrypted using RSAKeyStore and RSAKeyStorePassword. |
AuthType |
Type: string (Required) Method used to authenticate to the Event Stream Processor. Valid values are:
If the adapter is operated as a Studio plug-in, AuthType is overridden by the Authentication Mode Studio start-up parameter. |
RSAKeyStore |
Type: string (Dependent required) Specifies the location of the RSA keystore, and decrypts the password value. Required if AuthType is set to server_rsa, or the encrypted attribute for Password is set to true, or both. |
RSAKeyStorePassword |
Type:string (Dependent required) Specifies the keystore password, and decrypts the password value. Required if AuthType is set to server_rsa, or the encrypted attribute for Password is set to true, or both. |
KerberosKDC |
Type: string (Dependent required) Specifies host name of Kerberos key distribution center. Required if AuthType is set to kerberos. |
KerberosRealm |
Type: string (Dependent required) Specifies the Kerberos realm setting. Required if AuthType is set to kerberos. |
KerberosService |
Type: string (Dependent required) Specifies the Kerberos principal name that identifies an Event Stream Processor cluster. Required if AuthType is set to kerberos. |
KerberosTicketCache |
Type: string (Dependent required) Specifies the location of the Kerberos ticket cache file. Required if AuthType is set to kerberos. |
EncryptionAlgorithm |
Type: string (Optional) Used when the encrypted attribute for Password is set to true. If left blank, RSA is used as default. |