Establish Connection Between Your BambooHR Trial and Open Connectors

1. In your SAP Integration Suite home page, under Capabilities section, look out for the tile Extend Non-SAP Connectivity. Choose Discover Connectors.

   

   You’re now directed to the Open Connectors web page.

2. Choose Connectors.

   

   You see a catalog of various third-party applications that are supported by Open Connectors.

1. In the list, look out for Bamboo HR and choose API Docs.

   

   You see a list of operations that are supported by BambooHR via REST APIs.

2. Choose Authenticate Instance to connect to your BambooHR system.

   

3. Enter a name for the instance.

4. In the Company Name field, enter the domain name that you created for your BambooHR trial. You’ve copied this value in Preparing Your BambooHR Trial Account.

5. In the API Key field, enter the API Key that you generated for your BambooHR trial. You’ve copied this value in Preparing Your BambooHR Trial Account.

6. Choose Create Instance.

   

You’ve now successfully created a BambooHR connector instance. In this step, you test an API to fetch employee details from the sample data that is available in your BambooHR trial account.

1. Choose Test in the API docs.

   

2. In the list of APIs, look out for the category employees and choose the GET API /employees.

   This API fetches a list of all employees (sample data) in your BambooHR trial system.

   

3. To test the API, choose Try it out and Execute.

   You see a successful response with response code 200 and a response body containing employees data from your BambooHR trial system.

   

   You’ve now successfully established a connection between your BambooHR trial system and the Open Connectors capability of SAP Integration Suite.

In a later tutorial of this mission, you’ll establish an integration between Cloud Integration and BambooHR through Open Connectors. For this integration to work as expected, Open Connectors must authenticate you using a user credential.

In this step, you’ll create security material in Cloud Integration that takes care of this authentication.

1. In the successful API response, copy the authorization values for the properties User, Organization, and Element. You can find them in the Curl area above the server response you just received.

   

2. In your SAP Integration Suite home page, choose Monitor > Integrations and APIs.

   In case Open Connectors had opened in the same tab, click SAP Integration Suite at the top left to navigate to the SAP Integration Suite home page.

3. In the Manage Security section, choose Security Material.

4. Choose Create > User Credentials.

5. Enter a name for the user credentials.

6. For Type, select OpenConnectors.

7. Paste the values that you copied from Open Connectors. Choose Deploy.

   

In a later tutorial of this mission, you will have to provide a request to this GET /employees API so that Cloud Integration invokes it.

In the successful API response, copy the Request URL.