SAP Connector 5.9 Studio Configuration | MuleSoft Documentation
# SAP Connector 5.9 Studio Configuration
Install SAP Connector and configure the connector in Anypoint Studio. First install the SAP Java Connector (JCo) libraries that you obtain from SAP and then you can create an app containing one or more SAP Connector operations. Studio enables you to create an app and access the app from a browser.
To configure SAP Connector in Anypoint Studio:
  1. Add the connector to your Mule project.
  2. Configure the SAP connector.
  3. Configure an input source for the connector.


## Add the Connector to Your Mule Project
Add SAP Connector to your Mule project to automatically populate the XML code with the connector’s namespace and schema location and to add the required dependencies to the project’s `pom.xml` file:
  1. In the **Mule Palette** view, click **(X) Search in Exchange**.
  2. In the **Add Dependencies to Project** window, type `sap` in the search field.
  3. Click **SP Connector** in **Available modules**.
  4. Click **Add**.
  5. Click **Finish**.


Adding a connector to a Mule project in Studio does not make that connector available to other projects in your Studio workspace.
## Select a Source Operation
  1. In Anypoint Studio, click the **Mule Palette** and type `sap`.
  2. Choose an operation. If you want your app to start when an object is sent from SAP, choose either of the following operations and drag the operation to the **Source** area of the Studio canvas.
     * **Document source** listens for a change to an IDoc. When an IDoc changes, your app executes
     * **Function source** listens for a change to an SAP function module. When the targeted function module changes, your app executes.
See the SAP Connector Reference for field values. If you chose the **Document source** or **Function source** operation, proceed to the next section to install the SAP libraries.
  3. Alternatively, you can configure an input source for this connector such as an **HTTP Listener** , or **Scheduler** , and drag the operation to the Studio canvas. An HTTP Listener enables you to start your app from a browser. A Scheduler starts your app at a specific time.
  4. Install the SAP libraries.


## Install SAP Libraries
To use SAP libraries in your Mule project, you must first download the libraries to your computer. You can use the three libraries in Anypoint Studio directly, without conversion. You must have an SAP ID to download the libraries.
The file types for each library depend on your operating system:
  * sapidoc3.jar
  * sapjco3.jar
  * sapjco3.dll

  
---  
  * sapidoc3.jar
  * sapjco3.jar
  * libsapjco3.jnilib

  
  * sapidoc3.jar
  * sapjco3.jar
  * libsapjco3.so

  
SAP Connector supports SAP JCo libraries versions 3.0.x and 3.1.x.   
---  
After you install the libraries, you can customize the global element properties and test the connection.
## Configure the Libraries in Anypoint Studio
After installing the SAP Connector in Studio and adding the connector to your Mule project, configure the libraries.
  1. Double-click the connector in the flow.
  2. Click the plus sign (**+**) on the right of the **Connector Configuration** field. This screen appears:


### Install the IDOC Library
  1. Click **Add Dependency**.
  2. In the **Install** menu, click **Browse** to locate the library file.
  3. Specify a unique group ID, artifact ID, and version.
  4. Click **Finish** or, if you want to cancel, click **Remove Dependency**.


### Install the JCO Library
  1. Click **Add Dependency**.
  2. In the **Install** menu, click **Browse** to locate the library file.
  3. Specify a unique group ID, artifact ID, and version.
  4. Click **Finish** or, if you want to cancel, click **Remove Dependency**.


### Install the JCO Native Library
  1. Click **Add Dependency**.
  2. In the **Install** menu, click **Browse** to locate the library file.
On MacOS, starting with JCO version 3.1.2, the native library extension was changed from `jnilib` to `dylib`.
    1. After installing the library from the local machine:
    2. Navigate to the bottom of the **Shared Folder** window.
    3. Select **Any** , and then select the `dylib` native library.
    4. In the **Install file into local repository** window, enter values for the following fields:
       * **Group ID**
       * **Artifact ID**
  3. Specify a unique group ID, artifact ID, and version.
  4. Click **Finish** or, if you want to cancel, click **Remove Dependency**.


When you are finished installing the libraries, the configuration screen appears as follows with green check marks for each successfully installed library:
## Test the Connection
  1. Sign into your SAP login to get the information you need to configure the remaining **Global Element Properties** fields as described in Configure in Studio.
  2. Click **Test Connection** to ensure that you have the correct login information.


## Configure the Connector
If you need more than one SAP Connector instance in your Mule project, you can create a global SAP element. The SAP Connector object holds the configuration properties that allow you to connect to the SAP server.
To create a configuration for SAP Connector, complete the following steps:
  1. Go to **Global Elements** section and click **Create**.
  2. Select either **SAP Inbound** or **SAP Outbound** in the **Connector Configuration** section.
  3. In the **General** tab pane, enter the required parameters for defining an SAP connection, which your SAP system administrator can supply.


The SAP global element properties allow you to define connection properties as well as to add the required SAP dependencies to your project.
For ease of use, SAP Connector shows only the most common properties as connector parameters. To configure a property that is not listed in the **Properties** panel, see the Define Extended Properties topic.
The minimum required attributes to define are:
Field | Description  
---|---  
**Application Server Host** |  SAP endpoint  
Username of an authorized SAP user  
Password credential of an authorized SAP user  
**System Number** |  System number used to connect to the SAP system  
The SAP client ID (usually a number) used to connect to the SAP system  
**Login Language** |  The language to use for the SAP connection. For example, `EN` for English.  
As a best practice, use property placeholder syntax to load the credentials in a more simple and reusable way.
Click **Test Connection** to verify that the connection to the SAP instance is correct. If the credentials are correct you should see the `Test Connection Successful` message.
## View the App Log
To check for problems, you can view the app log as follows:
  * If you’re running the app from Anypoint Platform, the output is visible in the Anypoint Studio console window.
  * If you’re running the app using Mule from the command line, the app log is visible in your OS console.


Unless the log file path is customized in the app’s log file (`log4j2.xml`), you can also view the app log in the default location `MULE_HOME/logs/<app-name>.log`.
## Next
After configuring this connector in Studio, see the Additional Configuration Information topic for more configuration topics.
## See Also
  * Introduction to Anypoint Connectors
  * MuleSoft Help Center