Skip to main content

enosix Connector User Manual

enosix provides quicker, easier, and less costly data virtualization between SAP and virtually any front-end application built to support the enterprise. More details on enosix can be found on enosix.com.

This connector facilitates the integration with SAP without using SAP JCO libraries, complicated IDOC, RFC calls and complex transformations by using the certified enosix SAP Framework. It provides access to any SAP object configured through the enosix SAP Framework (eg. Sales Documents, Materials, Customers, etc.) with simple user-friendly field names.

Read through this user guide to understand how to configure a basic flow using the connector. Track feature additions, compatibility, limitations, and API version updates with each release of the connector using the Connector Release Notes. Review the connector operations and functionality using the demo application.

NOTE

If you would like to test out the enosix Connector in a trial environment please fill out this Trial Form

NOTE

If you'd like an overview, you can watch the enosix SAP Connector Video Walkthrough

Connection option(s)

enosix SAP connector supports two different connection mechanisms from 4.0.0 release.

  1. Basic authentication connection

  2. Pass through connection

You can see both connection mechanisms in this screen shot.

Connection options

Basic authentication connection : Standard username and password to connect SAP along with other required common parameters.

Basic authentication connection

Pass through connection : Bearer token used to connect SAP along with other required common parameters.

Pass through connection

Operations

Check Connection: This operation is helpful to run the health check in non-development environments.

Search: This operation is used to retrieve a paginated list of RIO (Rapid Integration Object) documents, matching the search criteria in enosix SAP framework.

Get: This operation is used to retrieve detailed RIO information from enosix SAP framework, for a given RIO type and key.

Create: This operation is used to create detailed RIO in enosix SAP framework, for a given RIO type.

Update: This operation is used to update the RIO based on the RIO type and key provided in enosix SAP framework.

Command: This operation is used to run set of commands supported by enosix SAP framework on RIO's.

Execute: This operation is used to call the RFC / BAPI functions from SAP using enosix SAP framework.

Operations

Prerequisites

This document assumes that you are familiar with Mule4, Anypoint Connectors, and Anypoint Studio. This page requires some basic knowledge of Mule Concepts, Components in a Mule Flow, and Global Elements

Hardware and Software Requirements

For hardware and software requirements, please visit the Hardware and Software Requirements page.

Mule Compatibility

Application/ServiceVersion
Mule Runtime4.3.x and later
Anypoint Studio7.13.x and later

enosix SAP Framework

To use this connector, you need to have a license for the enosix SAP Framework and have the framework configured.

Installing the Connector

You can install the connector in Anypoint Studio using the instructions in Installing a Connector from Anypoint Exchange.

Maven Dependency Information

After downloading and installing the connector, the enosix connector will be available inside a Mule application for use and will be packaged with the application. Using Anypoint Studio, it will add the Maven dependency automatically.

Check the pom.xml file and make sure you have the dependency

<dependency>
<groupId>com.enosix.mule</groupId>
<artifactId>enosix-connector</artifactId>
<version>4.0.0</version>
<classifier>mule-plugin</classifier>
</dependency>

Configuration

  1. After adding the enosix Connector dependency to your mule project, click on the Global Elements tab at the base of the canvas.
  2. In the Global Mule Configuration Elements screen, click Create.
  3. In the filter window, search for enosix and select the Enosix Config from the connector.

Connection tab

Field NameTypeValueRequired
URLStringEnter the SAP UrlX
UsernameStringEnter the SAP usernameX
PasswordStringEnter the SAP passwordX
XSD PathStringCreate a folder under mule project {mule_project}/src/main/resource/{enosix_xsd} and select this pathX
ClientintEnter the number for your SAP client
LanguageStringEnter a language to be passed on the sap-language parameter
Session ClosebooleanEnter whether to leave the session open or closed after each request. Defaults to TrueX
Response Timeout Unitjava.util.concurrent.TimeUnitEnter the unit of time to wait for a reply from the enosix SAP Framework. Defaults to SECONDS
Response TimeoutintEnter the amount of time to wait for a reply from the enosix SAP Framework

Example screenshot of General configuration tab

Global Config

Proxy tab

Proxy config supports the standard proxy configuration for http(s) calls. Proxy config has three options

TypeDescription
NoneNo proxy configuration and default
Edit InlineProxy config from UI with required Host, Port and optional Username, Password & Non proxy hosts
Global ReferenceThis supports mule stand bean defination for proxy

Example screenshot Proxy Edit Inline option

Proxy Config

TLS tab

TLS Configuration has three options

TypeDescription
NoneNo TLS configuration and default works for http based clients
Edit InlineThis is TLS configuration from UI and provide the details or Choose Insecure check box for https calls without TLS.
Global ReferenceThis supports TLS configuration as a global config.

Example screenshot of TLS Edit Inline option for https call with Insecure option.

Tls Config

Use the Test Connection button to confirm the provided values are valid and a successful connection to the enosix SAP Framework can be established.

Connector Namespace and Schema

When designing your application in Anypoint Studio, dragging operations provided by the enosix Connector onto the Anypoint Studio canvas will automatically populate the flow XML code with the connector namespace and schema location.

To add this manually, the Namespace and Schema Location values are:

SyntaxDescription
Namespacehttp://www.mulesoft.org/schema/mule/enosix
Schema Locationhttp://www.mulesoft.org/schema/mule/enosix/current/mule-enosix.xsd

Example Empty Mule Flow

<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:enosix="http://www.mulesoft.org/schema/mule/enosix"

xmlns="http://www.mulesoft.org/schema/mule/core"

xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/enosix http://www.mulesoft.org/schema/mule/enosix/current/mule-enosix.xsd">

<!-- Add your global configurations here -->

</mule>

Common use cases

Connectivity Check Flow

For validating the API has a successful connection to the enosix SAP Framework.

Check Connectivity Flow

Order Search Flow

Searching for sales documents, passing search criteria in from the payload of the API.

Order Search Flow

Order Search Flow

Order Search Operation Config

Order Search Operation Config

Get PO Flow

Get the detailed PO information from SAP based on the PO number provided as input key for any interested internal / external integration application.

Get PO Flow

Get PO Flow

Get PO Config

Get PO Config

Create Sales Document Flow

Create a new sales document in SAP from external / internal integrated application.

Create SalesDoc Flow

Create SalesDoc Flow

Create Config

Create Config

Update Customer Flow

Update the customer information from integrated internal / external application to SAP.

Update Customer Flow

Update Customer Flow

Update Config

Update Config

Sales Document Simulate Command Flow

Simulate the sales document in SAP (Not created in SAP) and use it for any integrated external / internal application.

Command Simulate Flow

Command Simulate Flow

Command Config

Command Config

Execute BAPI_MATERIAL_AVAILABILITY RFC flow

Call the material availability BAPI function using enosix SAP framework.

RFC Call Flow

RFC Call Flow

RFC Call Configuration

RFC Call Config