String
SAP Connector 5.9 Reference - Mule 4
Anypoint Connector for SAP (SAP Connector) enables the integration of data to and from external systems based on SAP NetWeaver.
Starting with version 5.0, SAP Connector also supports connecting to an on-premises instance of SAP S/4HANA. |
Limitations
-
For SAP Connector versions 5.4.0 and earlier, multiple servers deployed on the same Mule runtime engine with the same PROGRAM_ID, GATEWAY_SERVICE, and GATEWAY_HOST cannot be created by the JCo library. If you attempt to create two servers with the same PROGRAM_ID, GATEWAY_SERVICE, and GATEWAY_HOST, only one server is created. To work around this, you can use two different Mule runtime engines or use the same PROGRAM_ID with two different GATEWAY_HOSTs.
-
SAP Connector does not support Bitronix Transaction Manager.
-
The Document Listener and Function Listener sources do not support Mule transactions. Although the Transactional action and Transaction type parameters (on the Advanced tab) are available for both sources, the transactional feature is not implemented.
-
The reconnection strategy on SAP Listeners (Document Listener and Function Listener) relies exclusively on the JCo library, which means that the Mule reconnection mechanism has no impact on reconnections.
-
The JCO Server that runs in the background manages the reconnection when there is a connection issue. The JCo RFC provider recognizes a communication error between the Java server and the ABAP gateway and attempts to reconnect. If the first reconnection fails, the next reconnection attempt occurs after waiting for one second. If the reconnection fails again, the reconnection wait time doubles from one second to two seconds, until eventually it reaches the default maximum waiting period of 3600 seconds, or one hour. Set the maximum reconnection timeout using the
-Djco.server.max_startup_delay=<reconnect delay in seconds>
JMV parameter. -
The
XSTRING
data format in SAP is a binary blop format. To submit values in anXSTRING
field, you must use the toHex function to base-32 encode the binary within the XML submitted to the RFC step.
Configuration
Default Configuration for SAP Connector.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Name |
Name for this configuration. Connectors reference the configuration with this name. |
x |
||
Connection |
Connection types for this configuration. |
x |
||
Expiration Policy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
|||
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||
Default Idocument Version |
String |
Default IDoc version. |
|
|
Disable Jco Internal Cache |
Boolean |
Flag that indicates whether to use the JCo internal cache. Set this flag to |
|
|
Evaluate Response Flag |
Boolean |
Flag that indicates if an error response throws an exception or enables the user to handle it as another result. This flag is an exception or logging mechanism used to specify whether a message throws an exception (E) or is treated as a result with a warning (W). If you set the flag to If you set the flag to |
|
|
Log Trace Flag |
Boolean |
Flag that indicates whether to log the trace on the Mule server. Set this flag to |
|
|
Use SAP Format |
Boolean |
Determines whether to support the Mule 3 format for returning SAP values. Used in the
|
|
|
Use SAP Format On Function Listener |
Boolean |
Determines whether to support the Mule 3 format for returning SAP values. Used to parse a
|
|
Certificate Connection Type
Relies on an X509 certificate to authenticate the user.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
SAP system number |
String |
Two-digit system number (sysnr) of the SAP system. |
x |
|
SAP client ID |
String |
Three-digit client number. Leading zeros are preserved if they appear in the number. |
x |
|
Destination Name |
String |
Identifier of the destination generated by this connector. If none is set, a random value is created. |
||
Login language |
String |
Language code used by the connector. The language determines the code page used for communicating between the SAP adapter and the application server. |
|
|
Extended Properties |
Object |
Used to pass in all the database server-specific connection parameters. |
||
X.509 Certificate |
String |
Path to the X.509 certificate. This is required when the connector is working as a client. |
||
Application server host |
String |
Host of the SAP application server. |
||
Message server configuration |
Configuration for message server usage. |
|||
Enable RFC tracing on server |
Boolean |
Enables or disables RFC trace on the server. |
|
|
Enable CPIC tracing on server |
Enumeration, one of:
|
Enables or disables CPIC trace on the server. |
||
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
Kerberos Connection Type
Implements the Kerberos protocol to authenticate and authorize the user.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
SAP system number |
String |
Two-digit system number (sysnr) of the SAP system. |
x |
|
SAP client ID |
String |
Three-digit client number. Leading zeros are preserved if they appear in the number. |
x |
|
Destination Name |
String |
Identifier of the destination generated by this connector. If none is set, a random value is created. |
||
Login language |
String |
Language code used by the connector. The language determines the code page used for communicating between the SAP adapter and the application server. |
|
|
Extended Properties |
Object |
Used to pass in all the database server-specific connection parameters. |
||
Application server host |
String |
Host of the SAP application server. |
||
Message server configuration |
Configuration for message server usage. |
|||
Enable RFC tracing on server |
Boolean |
Enables or disables RFC trace on the server. |
|
|
Enable CPIC tracing on server |
Enumeration, one of:
|
Enables or disables CPIC trace on the server. |
||
Kerberos Config File Path |
String |
Path to the krb5.conf file. |
x |
|
Keytab File Path |
String |
Path to the keytab file. |
x |
|
GSS Library Path |
String |
Path to the gss library. |
x |
|
Principal |
String |
Principal that the connector uses to log in to SAP. |
x |
|
Client SNC Partner Name |
String |
The |
x |
|
Client SNC My Name |
String |
The |
x |
|
Server SNC Partner Name |
String |
The |
||
Server SNC My Name |
String |
The |
||
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
Simple Connection Provider Connection Type
Connects using a username and password.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
SAP system number |
String |
Two-digit system number (sysnr) of the SAP system. |
x |
|
SAP client ID |
String |
Three-digit client number. Leading zeros are preserved if they appear in the number. |
x |
|
Destination Name |
String |
Identifier of the destination generated by this connector. If none is set, a random value is created. |
||
Login language |
String |
Language code used by the connector. The language determines the code page used for communicating between the SAP adapter and the application server. |
|
|
Extended Properties |
Object |
Used to pass in all the database server-specific connection parameters. |
||
Username |
String |
Username the connector uses to log in to SAP. |
x |
|
Password |
String |
Password associated with the login username. |
x |
|
Application server host |
String |
Host of the SAP application server. |
||
Message server configuration |
Configuration for message server usage. |
|||
Enable RFC tracing on server |
Boolean |
Enables or disables RFC trace on the server. |
|
|
Enable CPIC tracing on server |
Enumeration, one of:
|
Enables or disables CPIC trace on the server. |
||
Reconnection |
When the application is deployed, a connectivity test is performed on all connectors. If set to |
Sources
Document Listener
<sap:document-listener>
Listens for incoming IDocs.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Gateway Host |
String |
Name of the host running the gateway server. This is the name of the host running the gateway handler. SAP Gateway is a development framework used to connect non-SAP applications to SAP applications. You can configure the SAP Gateway host to be the trusted system using an RFC destination. |
x |
|
Gateway Service |
String |
Service port for the gateway service of the SAP system. To use the name instead of the port, you must map the gateway service name to the gateway service port. |
x |
|
Program ID |
String |
SAP system program ID that is registered on the gateway. Must be unique for the given gateway. |
x |
|
Connection Count |
Number |
Number of connections to register on the gateway. If there is more than one connection, handler requests are processed in parallel. For example, if two connections are set, this creates two handler workers or threads that handle requests in parallel, almost like having two sources start together. |
|
|
Idoc Type Filter Regex |
String |
Expression to filter all incoming IDocs by type. |
||
Idoc Type Extension Filter Regex |
String |
Expression to filter all incoming IDocs by type extension. |
||
Message server host |
String |
Host of the message server. |
||
Message server port |
String |
Message server name or port number. |
||
System ID |
String |
System ID of the system the message server belongs to. |
||
Group |
String |
Logon group defined in ABAP that identifies a set of application servers. |
||
Update interval |
String |
How often the message server fetches the list of application servers. |
||
IDoc Render Options |
IDoc rendering options. |
|||
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||
Transactional Action |
Enumeration, one of:
|
Type of beginning action that sources take regarding transactions. |
|
|
Transaction Type |
Enumeration, one of:
|
Type of transaction to create. Availability depends on Mule version. |
|
|
Primary Node Only |
Boolean |
Determines whether to execute this source on only the primary node when running Mule instances in a cluster. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Redelivery Policy |
Defines a policy for processing the redelivery of the same message. |
|||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Function Listener
<sap:function-listener>
Listens for incoming BAPI functions.
Name | Type | Description | Default Value | Required | ||
---|---|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|||
Gateway Host |
String |
Name of the host running the gateway server. This is the name of the host running the gateway handler. SAP Gateway is a development framework used to connect non-SAP applications to SAP applications. You can configure the SAP Gateway host to be the trusted system using an RFC destination. |
x |
|||
Gateway Service |
String |
Service port for the gateway service of the SAP system. To use the name instead of the port, you must map the gateway service name to the gateway service port. |
x |
|||
Program ID |
String |
SAP system program ID that is registered on the gateway. Must be unique for the given gateway. |
x |
|||
Connection Count |
Number |
Number of connections to register on the gateway. If there is more than one connection, handler requests are processed in parallel. For example, if two connections are set, this creates two handler workers or threads that handle requests in parallel, almost like having two sources start together. |
|
|||
Targeted Function |
String |
Name of the function to receive. Filters the incoming BAPI functions by their names. |
||||
Message server host |
String |
Host of the message server. |
||||
Message server port |
String |
Message server name or port number. |
||||
System ID |
String |
System ID of the system the message server belongs to. |
||||
Group |
String |
Logon group defined in ABAP that identifies a set of application servers. |
||||
Update interval |
String |
How often the message server fetches the list of application servers. |
||||
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||||
Transactional Action |
Enumeration, one of:
|
Type of beginning action that sources take regarding transactions. |
|
|||
Transaction Type |
Enumeration, one of:
|
Type of transaction to create. Availability depends on Mule version. |
|
|||
Primary Node Only |
Boolean |
Determines whether to execute this source on only the primary node when running Mule instances in a cluster. |
||||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||||
Redelivery Policy |
Defines a policy for processing the redelivery of the same message. |
|||||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
|||||
Response |
Binary |
Source response.
|
|
Operations
Asynchronous Remote Function Call (Deprecated)
<sap:async-rfc>
This operation is deprecated. Use the Asynchronous Remote Function Call operation instead.
This operation works only with JCo 3.0.x.
Executes a BAPIFunction over a queued Remote Function Call (qRFC).
A qRFC is an extension of a transactional RFC (tRFC) that ensures that individual steps are processed in sequence. This guarantees that multiple logical unit of work (LUW) transactions are processed in the order specified by the application.
tRFC can be serialized using inbound and outbound queues, hence the name queued RFC. qRFC is best used as an extension of tRFC to define a processing sequence. Use qRFC to guarantee that several transactions are processed in a predefined order.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Function Name |
String |
Name of the function to execute. |
x |
|
Content |
Binary |
BAPIFunction to execute. |
|
|
Transaction Id |
String |
ID that identifies an RFC so that the RFC runs only once. |
x |
|
Queue Name |
String |
Name of the queue on which the RFC executes. This applies for qRFC since each tRFC call that is processed is given a queue name by the application. A queue name and version are required for each qRFC transaction. |
||
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||
Transactional Action |
Enumeration, one of:
|
Type of joining action that operations take regarding transactions. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Asynchronous Remote Function Call
<sap:asynchronous-remote-function-call>
This operation works only with JCo 3.1.x and expects valid XML content in the response.
Executes a BAPIFunction over a queued Remote Function Call (qRFC) and throws an SAP:INVALID_INPUT
error when the provided payload is invalid according to JCo library checks.
A qRFC is an extension of a transactional RFC (tRFC) that ensures that individual steps are processed in sequence. This guarantees that multiple logical unit of work (LUW) transactions are processed in the order specified by the application.
tRFC can be serialized using inbound and outbound queues, hence the name queued RFC. qRFC is best used as an extension of tRFC to define a processing sequence. Use qRFC to guarantee that several transactions are processed in a predefined order.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Function Name |
String |
Name of the function to execute. |
x |
|
Content |
Binary |
BAPIFunction to execute. |
|
|
Transaction Id |
String |
ID that identifies an RFC so that the RFC runs only once. |
x |
|
Queue Name |
String |
Name of the queue on which the RFC executes. This applies for qRFC since each tRFC call that is processed is given a queue name by the application. A queue name and version are required for each qRFC transaction. |
||
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||
Transactional Action |
Enumeration, one of:
|
Type of joining action that operations take regarding transactions. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Confirm Transaction
<sap:confirm-transaction-id>
Confirms to the server that a transaction is successful.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Transaction ID (TID) |
String |
ID of the transaction to confirm. |
x |
|
Transactional Action |
Enumeration, one of:
|
Type of joining action that operations take regarding transactions. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Get Function
<sap:get-function>
Retrieves a BAPIFunction based on its name.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Function Name |
String |
Name of the function to retrieve. |
x |
|
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||
Transactional Action |
Enumeration, one of:
|
Type of joining action that operations take regarding transactions. |
|
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Retrieve IDoc
<sap:retrieve-idoc>
Retrieves an IDoc structure based on its key.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
IDoc Name |
String |
Key that contains the required information to retrieve the IDoc. |
x |
|
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||
Transactional Action |
Enumeration, one of:
|
Type of joining action that operations take regarding transactions. |
|
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Send IDoc
<sap:send>
Sends an IDoc to SAP over an RFC. An RFC can be one of two types for IDocs:
-
Transactional (tRFC)
A special form of asynchronous Remote Function Call (aRFC). tRFC ensures transaction-like handling of processing steps that were originally handled autonomously. tRFC is an asynchronous communication method that executes the called function module in the RFC server only once, even if the data is sent multiple times due to a network issue. The remote system does not need to be available at the time the RFC client program is executing a tRFC. The tRFC component stores the called RFC function, along with the corresponding data, in the SAP database under a unique transaction ID (TID). tRFC is similar to aRFC since it does not wait at the target system (similar to a registered post). If the system is not available, the data is written into aRFC tables with a transaction ID (SM58) that is chosen by the scheduler RSARFCSE and runs every 60 seconds. tRFC is best used as an extension of asynchronous RFC secure communication between systems.
-
Queued (qRFC)
An extension of tRFC. qRFC ensures that individual steps are processed in sequence. Use qRFC to guarantee that multiple LUWs (Logical Unit of Work transactions) are processed in the order specified by the application. tRFC can be serialized using inbound and outbound queues, hence the name queued RFC (qRFC). qRFC is best used as an extension of tRFC to define a processing sequence. Implement qRFC if you want to guarantee that several transactions are processed in a predefined order.
Both tRFC and qRFC have a TID handler.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
IDoc Name |
String |
Name of the IDoc to execute. |
x |
|
Content |
Binary |
IDoc to execute. |
|
|
Version |
String |
Version on the IDoc. |
||
Transaction Id |
String |
ID that identifies an RFC so that the RFC runs only once. |
||
Queue Name |
String |
Name of the queue on which the RFC executes. This applies for qRFC since each tRFC call that is processed is given a queue name by the application. A queue name and version are required for each qRFC transaction. |
||
IDoc Parsing Options |
IDoc parsing options. |
|||
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||
Transactional Action |
Enumeration, one of:
|
Type of joining action that operations take regarding transactions. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Start SAP Transaction
<sap:create-transaction-id>
Creates a transaction ID to use as part of future calls.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Transactional Action |
Enumeration, one of:
|
Type of joining action that operations take regarding transactions. |
|
|
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Synchronous Remote Function Call (Deprecated)
<sap:sync-rfc>
This operation is deprecated. Use the Synchronous Remote Function Call operation instead.
This operation works only with JCo 3.0.x.
Executes a BAPIFunction over a synchronous Remote Function Call (sRFC). sRFC requires both the systems (client and server) to be available at the time of communication or data transfer. sRFC is the most common type and is used when a result is required immediately after the execution of sRFC. sRFC is a means of communication between systems where acknowledgments are required.
The resources of the source system wait at the target system and ensure that they deliver the message or data with ACKD. The data is consistent and reliable for communication. If the target system is not available, the source system resources wait until the target system is available. This can lead to the processes of the source system going into Sleep/RFC/CPIC mode at the target systems, which blocks these resources. Use sRFC for communication between systems, and communication between an SAP web application server and an SAP GUI.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Function Name |
String |
Name of the function to execute. |
x |
|
Content |
Binary |
BAPIFunction to execute. |
|
|
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||
Transactional Action |
Enumeration, one of:
|
Type of joining action that operations take regarding transactions. |
|
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Synchronous Remote Function Call
<sap:synchronous-remote-function-call>
This operation works only with JCo 3.1.x and expects valid XML content in the response.
Executes a BAPIFunction over a synchronous Remote Function Call (sRFC) and throws an SAP:INVALID_INPUT
error when the provided payload is invalid according to JCo library checks. sRFC requires both the systems (client and server) to be available at the time of communication or data transfer. sRFC is the most common type and is used when a result is required immediately after the execution of sRFC. sRFC is a means of communication between systems where acknowledgments are required.
The resources of the source system wait at the target system and ensure that they deliver the message or data with ACKD. The data is consistent and reliable for communication. If the target system is not available, the source system resources wait until the target system is available. This can lead to the processes of the source system going into Sleep/RFC/CPIC mode at the target systems, which blocks these resources. Use sRFC for communication between systems, and communication between an SAP web application server and an SAP GUI.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Function Name |
String |
Name of the function to execute. |
x |
|
Content |
Binary |
BAPIFunction to execute. |
|
|
Encoding |
String |
Canonical name of the encoding. Refer to Oracle’s supported encodings. |
||
Transactional Action |
Enumeration, one of:
|
Type of joining action that operations take regarding transactions. |
|
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Object Types
Expiration Policy
Configures an expiration policy strategy.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Idle Time |
Number |
Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
||
Time Unit |
Enumeration, one of:
|
Time unit for the Max Idle Time field. |
IDoc Parse Parameter Group
IDoc parsing options.
Field | Type | Description | Default Value | Required | ||
---|---|---|---|---|---|---|
Parse With Field Value Checking |
Boolean |
Indicates whether to enable the field value checking mechanism in accordance with the respective IDoc field metadata when parsing. |
|
|||
Parse Ignore Unknown Fields |
Boolean |
Indicates whether to ignore unknown fields when parsing, for example, when parsing with older IDoc metadata. |
|
|||
Parse Ignore Invalid Char Errors |
Boolean |
Indicates whether to ignore character range check errors in accordance with the declared XML specification version when parsing. When using this option, invalid characters within field values are accepted, although the XML document to parse might contain characters that are not in the valid character range. |
|
|||
Parse Without Field Data Type Checking |
Boolean |
Indicates whether to disable the field data type checking mechanism in accordance with the respective IDoc field metadata when parsing.
|
|
|||
Parse Refuse Unknown XML Version |
Boolean |
Indicates whether to refuse XML documents that declare an unknown XML specification version, for example, a potential future XML specification version 1.2 or 2.0. |
|
|||
Parse Refuse XML Version10 |
Boolean |
Indicates whether to refuse XML documents that don’t use XML specification version 1.0 or that don’t contain an XML declaration header. |
|
|||
Parse Refuse XML Version11 |
Boolean |
Indicates whether to refuse XML documents that use XML specification version 1.1. |
|
|||
Parse Accept Only Xml Version10 |
Boolean |
Indicates whether to accept only XML documents that use XML specification version 1.0 or that don’t contain an XML declaration header. |
|
|||
Parse Accept Only Xml Version11 |
Boolean |
Indicates whether to accept only XML documents that use XML specification version 1.1 or that don’t contain an XML declaration header. |
|
|||
Parse Accept Only Xml Version10 To11 |
Boolean |
Indicates whether to accept only XML documents that use XML specification version 1.0 or 1.1 or that don’t contain an XML declaration header. |
|
IDoc Render Parameter Group
IDoc rendering options.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Render IDoc Empty Tags |
Boolean |
Indicates whether to include all empty tags in the resulting XML document. |
|
|
Render IDoc Ignore Invalid Char Errors |
Boolean |
Indicates whether to ignore character range check errors in accordance with the used XML specification version. |
|
|
Render IDoc Ignore Tag Escape Errors |
Boolean |
Indicates whether to ignore escape character errors within XML tags in accordance with the used IDocXML format |
|
|
Render IDoc Omit Xml Declaration |
Boolean |
Indicates whether to omit the XML declaration section in the resulting XML document. |
|
|
Render IDoc Optional Encoding Decl |
Boolean |
Indicates whether to write an optional XML encoding declaration attribute into the resulting XML document. |
|
|
Render IDoc Substitute Invalid Chars |
Boolean |
Indicates whether to substitute invalid characters within IDoc field values with the number sign |
|
|
Render IDoc With CR |
Boolean |
Indicates whether to insert |
|
|
Render IDoc With CRLF |
Boolean |
Indicates whether to insert |
|
|
Render IDoc With LF |
Boolean |
Indicates whether to insert |
|
|
Render IDoc With Tabs And CR |
Boolean |
Indicates whether to insert |
|
|
Render IDoc With Tabs And CRLF |
Boolean |
Indicates whether to insert |
|
|
Render IDoc With Tabs And LF |
Boolean |
Indicates whether to insert |
|
|
Render IDoc Xml10 |
Boolean |
Indicates whether to create an XML document compliant with XML specification version 1.0. |
|
|
Render IDoc Xml11 |
Boolean |
Indicates whether to create an XML document compliant with XML specification version 1.1. |
|
Message Server
You can configure a message server with multiple gateways that can be passed to the Document Listener source to distribute the load and improve performance. For more information, refer to Configure Multiple Gateways.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Host |
String |
Host of the message server. |
x |
|
System Id |
String |
System ID of the SAP system. |
x |
|
Port |
Number |
Port with which the connector logs into the message server. |
||
Group |
String |
Group of SAP application servers. |
||
Router |
String |
SAP router string to use for a system protected by a firewall. |
Reconnect
Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
||
Count |
Number |
How many reconnection attempts the Mule app can make. |
Reconnect Forever
Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
Reconnection
Configures a reconnection strategy for an operation.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Fails Deployment |
Boolean |
What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy:
|
||
Reconnection Strategy |
Reconnection strategy to use. |
Redelivery Policy
Configures the redelivery policy for executing requests that generate errors. You can add a redelivery policy to any source in a flow.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Redelivery Count |
Number |
Maximum number of times that a redelivered request can be processed unsuccessfully before returning a REDELIVERY_EXHAUSTED error. |
||
Use Secure Hash |
Boolean |
Whether to use a secure hash algorithm to identify a redelivered message. |
||
Message Digest Algorithm |
String |
Secure hashing algorithm to use if the Use Secure Hash field is |
||
Id Expression |
String |
One or more expressions that determine when a message was redelivered. This property can be set only if the Use Secure Hash field is |
||
Object Store |
Object Store |
Configures the object store that stores the redelivery counter for each message. |
Repeatable File Store Stream
Configures the repeatable file-store streaming strategy by which Mule keeps a portion of the stream content in memory. If the stream content is larger than the configured buffer size, Mule backs up the buffer’s content to disk and then clears the memory.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
In Memory Size |
Number |
Maximum amount of memory that the stream can use for data. If the amount of memory exceeds this value, Mule buffers the content to disk. To optimize performance:
|
||
Buffer Unit |
Enumeration, one of:
|
Unit for the In Memory Size field. |
Repeatable In Memory Stream
Configures the in-memory streaming strategy by which the request fails if the data exceeds the MAX buffer size. Always run performance tests to find the optimal buffer size for your specific use case.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Initial Buffer Size |
Number |
Initial amount of memory to allocate to the data stream. If the streamed data exceeds this value, the buffer expands by Buffer Size Increment, with an upper limit of Max In Memory Size value. |
||
Buffer Size Increment |
Number |
Amount by which the buffer size expands if it exceeds its initial size. Setting a value of |
||
Max Buffer Size |
Number |
The maximum amount of memory to use. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower than or equal to zero means no limit. |
||
Buffer Unit |
Enumeration, one of:
|
Unit for the Initial Buffer Size, Buffer Size Increment, and Buffer Unit fields. |