The SAP RFC communication point provides the ability to execute Remote Function Calls (RFCs) on a SAP server from within Rhapsody.

Supported Operational Modes: Output , Out -> In.

  • Output
    The SAP RFC communication point uses the message to execute the RFC. This is typically used to update data in the SAP server, for example by inserting the contents of an IDoc message into the SAP server.
  • Out -> In
    The SAP RFC communication point uses the message to execute the RFC. The results of the remote function call is used to populate the message for further processing by Rhapsody. This is typically used to lookup missing data from the SAP server, so that message fields can be filled in the message.

Configuration Properties

Property

Description

Connection Settings

Specifies how the SAP server connection details will be obtained.

  • From Config File (default).
  • Manual Setting.
SAP Router

The SAP Router string. Typically the format of this string is: /H/<server>/S/<port> where server is the IP address or name of your server that is entitled to access SAP's network, and port is the SAP Router port. If you use the default port (3299), then you can omit the section /S/<port>. Refer to your SAP documentation for more information on SAP Router strings.

This option is only available when Connection Settings is set to Manual Setting

SAP Host Name

The hostname or IP address of the SAP server.

This option is only available when Connection Settings is set to Manual Setting

System Number

The SAP system number.

This option is only available when Connection Settings is set to Manual Setting

SAP Client

The ID of the SAP client on the SAP server.

This option is only available when Connection Settings is set to Manual Setting

User Name

The username to use when connecting to the SAP server.

This option is only available when Connection Settings is set to Manual Setting

Password

The password to use when connecting to the SAP server.

This option is only available when Connection Settings is set to Manual Setting

SAP Language

The language to use to communicate with the SAP server. This must be a valid ISO 639-1 language code.

This option is only available when Connection Settings is set to Manual Setting

Configuration File

This is an XML file that controls how the communication point interacts with the SAP server. 

To launch the SAP RFC Configuration Editor, click the Create Configuration link (if a configuration has not yet been created) or the Edit Configuration link (if a configuration exists) in the Configuration File field. Refer to SAP Configuration Editor for details. 

Alternatively, to add an existing configuration:

  1. Click the Browse button in the Configuration File field to display the Windows® Open dialog.
  2. Search for and add the configuration file to the communication point.
  3. To update the configuration file, click the Edit Configuration link. The SAP RFC Configuration Editor is then displayed, which enables you to edit the configuration file.
Definition File Identifies the message definition used to parse a message. The SAP RFC communication point can be configured to extract fields from the message to use in the remote function call, or to insert the results of an RFC into message fields. If this is done, a message definition is required so the message can be parsed.
Conversion Error Behavior

Specifies whether conversion errors encountered when inserting data into a SAP table should be treated as message errors or ignored:

  • Treat As Message Errors (default).
  • Ignore Conversion Errors.

A conversion error typically happens when the wrong data type is used, for example trying to insert a string into a numeric field.

It is not recommended to ignore conversion errors unless you have some specific requirement to do this. Ignoring conversion errors could potentially result in loss or corruption of data.