Nav

SAP Connector Release Notes

The Mule Runtime supports SAP integration through our Anypoint Connector for SAP, which is an SAP-certified Java connector that leverages the SAP Java Connector (JCo) libraries.

Version 3.0.1 - December 2, 2016

Compatibility

Software Version

Mule Runtime

3.5.x or higher

Anypoint Studio

5.x and higher

Java

7, 8

SAP Solution

ECC 6.0 or higher

Supported modules

SAP CRM, SAP ERP, SAP SRM, SAP SCM, and any other modules compatible with the NetWeaver platform.

Features

  • Enhanced DataSense for IDocs - For every IDoc field, additional information is displayed as part of the UI label: the data type, its length and a description.

Fixed in this Release

  • XML External Entities (XXE) vulnerability - By default, XML parsers are weakly configured and are therefore vulnerable to XML External Entity attacks (e.g. disclosure of confidential data, denial of service, server side request forgery) when the application parses XML input. To prevent XXE, DTDs (External Entities) have been completely disabled in all the XML parsers used by the connector.

  • Metadata retrieval results in timeout - This is a result of additional information being displayed to enhance DataSense in version 3.0.0. The implementation has been improved and timeout is no longer being triggered. However, metadata generation takes a bit longer than in previous versions.

    Due to the metadata retrieval timeout fix, both Input and Output tabs in DataSense UI display the same information (import, export, tables, etc). When using DataWeave, make sure you select the correct Input / Ouptut parameters.
  • IDoc attributes "BEGIN" and "SEGMENT" not displayed in DataSense - Regression issue introduced in version 3.0.0. Now both DataSense UI and DataWeave correctly display these attributes, which are required to properly build the XML of a given IDoc.

    DataSense will display unwanted fields, such as: @begin and @segment. This is DS default behaviour when working with XML data. Skip these when binding data with DataWeave.
  • Redundant XSD attribute names - To improve readability, the sap prefix has been removed from the XSD/XML template. Attributes sapOptional, sapType, sapLength and sapDescription have been renamed to optional. dataType, length and description respectively.

  • Parameters of type XSTRING are passed as String - XSTRING represents a byte array in ABAP. This data type was not being handled by the connector. The value was passed without any conversion. In this version, XSTRING parameters are received as a Base64 string (the user is in charge of encoding it) and converted to a byte array.

  • Connector hangs when application is redeployed - This occurs when deploying an application that uses an Inbound endpoint inside a Mule EE Standalone distribution. When un-deploying the app and performing a second re-deploy attempt, the Mule Runtime gets stuck and does not finish deploying it completely (the log will end at New app 'my-sap-app' instead of Started app 'my-sap-app'). As a workaround, the default value of operationTimeout has been changed from 0 (zero) -Mule would block forever until the JCo server operations to execute- to 30 (thirty) seconds. For previous versions of the connector, where the default value is 0, the workaround is to explicitly declare operationTimeout with a value greater than 0, similarly to the example below:

<sap:inbound-endpoint connector-ref="SAP" operationTimeout="5" type="idoc" ... />

Known Issues

  • Though the Connector hangs when application is redeployed a workaround has been provided in the previous section. The underlying issue persists and will be addressed in a future release.

  • Destination Provider reference gets lost after hot redeploy of an application (i.e. modifying the mule-config.xml)

Version 3.0.0 - May 17, 2016

SAP connector version 3.0.0 was released and packaged with Anypoint Studio 6.0.0.

Compatibility

Software Version

Mule Runtime

3.5.x or higher

Anypoint Studio

5.x and higher

Java

7, 8

SAP Solution

ECC 6.0 or higher

Supported modules

SAP CRM, SAP ERP, SAP SRM, SAP SCM, and any other modules compatible with the NetWeaver platform.

Features

  • Supports definition of SAP JCo Client Extended Properties using MEL.

  • Metadata generated at inbound endpoint by SAP is now organized by input and output.

  • Enhanced DataSense, displaying additional information:

    • For Functions and BAPIs, it is now possible to identify tables and structures, optional and required fields, the 'real' data type associated with them (such as Char, Number), their length and a description. For IDocs, segments are also clearly labeled.

Fixed in this Release

  • Support for XML Version 1 was removed for Functions/BAPIs. This means that attribute xmlVersion is deprecated and templates for V1 no longer can be exported.

  • Connection Pool for outbound requests didn’t work when configured from the connector global configuration because it was missing the property jcoExpirationTime, needed along with jcoPeakLimit and jcoPoolCapacity to establish the connection pooling.

    • When set to a value above "0", the connector should support connection pooling.

Known Issues

  • Destination Provider reference gets lost after hot redeploy of an application (i.e. modifying the mule-config.xml)

Version 2.2.8 - January 28, 2016

Compatibility

The MuleSoft Enterprise Java Connector for SAP connector is compatible with:

Software Version

Mule Runtime

3.5.x or higher

Anypoint Studio

5.x

Java

7

SAP R/3

Release 3.1 or higher

SAP ERP

6.0 EhP 7 (SAP_APPL 607) or higher

Features

  • Transaction ID (TID) has been added as a property of the Mule Message. Thus, when sending or receiving IDocs, the user will be able to call RFC-enabled Function Modules on SAP (INBOUND_IDOCS_FOR_TID and OUTBOUND_IDOCS_FOR_TID) to retrieve the IDoc number.

Fixed in this Release

  • Java’s UTF-8 encoding had not been recognizing initial character BOM (Byte Order Marker).

  • Metadata retrieval in DataSense for BAPI names containing slashes ("/"), e.g. "/DSD/ME_GETLIST_TR", is fixed.

Known Issues

  • Destination Provider reference gets lost after hot redeploy of an application (i.e. modifying the mule-config.xml)

Version 2.2.7 - July 1, 2015

Compatibility

The MuleSoft Enterprise Java Connector for SAP connector is compatible with:

Software Version

Mule Runtime

3.5.x or higher

Anypoint Studio

5.x

Java

7

SAP R/3

Release 3.1 or higher

SAP ERP

6.0 EhP 7 (SAP_APPL 607) or higher

Features

  • None

Fixed in this Release

  • Compatibility issue with Anypoint Studio 5.2: when making a BAPI call or sending an IDoc, the SAP outbound endpoint could not parse an XML input built with a DataWeave Message Transformer.

  • XML version 2 parser displayed confusing ERROR messages expected when defining the record type.

  • The "MINIMAL" metadata mode now generates sample rows for tables.

Known Issues

  • Destination Provider reference gets lost after hot-redeploy of an application (i.e. modifiying the mule-config.xml)

Version 2.2.6 - June 17, 2015

Compatibility

The MuleSoft Enterprise Java Connector for SAP connector is compatible with:

Software Version

Mule Runtime

3.5.x or higher

Anypoint Studio

5.x

Java

7

SAP R/3

Release 3.1 or higher

SAP ERP

6.0 EhP 7 (SAP_APPL 607) or higher

Features

  • Added demo examples to public site, available for download at SAP Connector Demos

  • Extended multi-tenancy support to all the connection parameters (jcoAsHost, jcoUser, jcoLang, jcoClient, jcoPasswd & jcoSysnr) so that the connections can be defined dynamically in runtime. This way, the connector can now be used in real multi-tenant scenarios within Data Gateway.

  • Set the correct mimeType for payload to each message created by the SAP Transport in order to be fully compatible with the new Data Framework.

Fixed in this Release

  • Operation timeout cannot be configured for SAP Inbound Endpoint.

  • XML definition not removed from config file after deletion from Studio GUI.

  • NullPointerException when using Scallable Node Controller (SNC) and the password attribute is null. The SNC connection mode uses digital certificates to execute the authentication and hence no username and password are required.

  • Defective IDoc to XML conversion after upgrading to SAPJCo 3.0.13 and SAPidoc 3.0.12.

Known Issues

  • Destination Provider reference gets lost after hot-redeploy of an application (i.e. modifiying the mule-config.xml)

Version 2.2.5 - November 28, 2014

Compatibility

The MuleSoft Enterprise Java Connector for SAP connector is compatible with:

Software Version

Mule Runtime

3.5.x or higher

Anypoint Studio

5.x

Java

7

SAP R/3

Release 3.1 or higher

SAP ERP

6.0 EhP 7 (SAP_APPL 607) or higher

Features

  • Full-featured SAP Editor - SAP Editor includes more options to browse SAP objects (IDocs & Functions), display complete details of the selected SAP Object metadata (XML Template and/or XSD) and export the data to the desired directory. DataSense has also been improved in order to reload metadata whenever any of the following changes: SAP Object, Type (IDoc / Function), Output XMl, XML Version.

  • Support for IDoc Extensions - Is is now possible to generate the metadata structure for a custom IDoc.

  • Support for XML version 2 - It is set as the default XML version to configure a BAPI request.

  • Improved DataSense metadata discovery - for SAP Objects, Type (IDoc/Function), Output XML and XML Version. It also provides better coverage of failure messages.

Fixed in this Release

  • Inbound endpoint support for qRFC doesn’t work with IDocs.

  • Nested BAPI structures cannot be parsed when trying to convert from XML to JCoFunction.

  • When parsing a JCo response with empty tables using XML version 2, an empty row is attached to them.

  • Failure to convert a BAPI result to XML.

  • Object finder doesn’t return inbound IDocs, only outbound.

  • XML parsers cannot process IDocs or BAPIs with slash (/) character in their name.

  • BAPI tables with name-less fields cannot be processed.

  • Inbound endpoint fails in some Mule Cluster configurations.

  • JCo library generates classloader leaks (only when JCo dependencies and the SAP connector lib are in the application lib directory and the latter is redeployed).

Known Issues

  • Operation timeout cannot be configured for SAP Inbound Endpoint.

  • Destination Provider reference gets lost after hot-redeploy of an application (i.e. modifiying the mule-config.xml)