# Exercise - Sync Salesforce data using IBM App Connect Enterprise

In this lab you will create App Connect flows to sync client data in the **IBM Trader Lite** app to Salesforce. This will occur whenever a user of the **IBM Trader Lite** app creates a portfolio for a new client or accesses the data of an existing client.

In order to accomplishment this at a minimum 2 flows are needed:

1. A URL driven flow to push a new client to a Salesforce contact when the **IBM Trader Lite** app creates a portfolio for a new client
2. An Event driven flow to push changes to the **IBM Trader Lite** app whenever a contact's data is updated in Salesforce

The architecture of the app is shown below:

![Architecture diagram](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YkKVvzKQw7CrP7_D-%2Fsync%2Fb66e7de31cb279ab49a31680097fc29738bd2adf.png?generation=1618606165333592\&alt=media)

The **portfolio** microservice invokes the REST endpoint of the new flow whenever a new client is created or read by the app and this results in a new contact being created in, or read from Salesforce.

This lab is broken up into the following sections:

1. [Prerequisites](#prerequisites)
2. [Sign up for Salesforce Developer Edition](#section-1-sign-up-for-salesforce-developer-edition)
3. [Create a Salesforce Connected App](#section-2-create-a-salesforce-connected-app)
4. [Setup connectivity to Salesforce in App Connect Designer](#section-3-setup-connectivity-to-salesforce-in-app-connect-designer)
5. [Create the flows in App Connect Designer](#section-4-create-the-flows-in-app-connect-designer)
6. [Create an Integration Server instance and deploy your flows](#section-5-create-an-integration-server-instance-and-deploy-your-flows)
7. [Get the REST endpoint of your App Connect Flow](#section-6-get-the-rest-endpoint-of-your-app-connect-flow)
8. [Test your App Connect Flow with Trader Lite](#section-7-test-your-app-connect-flows-with-trader-lite)
9. [Summary](#summary)

> **Note**: You can click on any image in the instructions below to zoom in and see more details. When you do that just click on your browser's back button to return to the previous state.

## Prerequisites

The *TraderLite* application needs to be up and running on your cluster. If you've completed the API Connect and/or the Salesforce integration labs then you will have the app running already. If you have not completed either of those labs, follow the installation instructions in this [FAQ](https://ibm-developer.gitbook.io/cloudpakforintegration-workshop/faq#traderlite-application-installation) before continuing to step 1 below.

## Section 1: Sign up for Salesforce Developer Edition

1.1 In your browser go to the following URL to sign up for Salesforce Developer Edition - a full featured version of the Salesforce Lightning Platform.

> **Note:** If you already have access to the Salesforce Developer Edition or a paid version of Salesforce, skip to **Step 1.2**.

[Salesforce Developer Edition signup](https://developer.salesforce.com/signup)

1.2 Enter the required information and follow the prompts to complete the signup process.

## Section 2: Create a Salesforce Connected App

In this section you'll create a *Connected App* in Salesforce so that the App Connect flows that you create later will be able to access your Salesforce data.

2.1 Login to [Salesforce](https://www.salesforce.com)

2.2 Click on your avatar (top right) and select **Switch to Salesforce Classic** from the context menu.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YkKVvzKQw7CrP7_D-%2Fsync%2F274754aeac998e457e183db9ff93aac0f542f76a.png?generation=1618606164093076\&alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sflogin.png)

2.3 Click on **Setup**.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YkKVvzKQw7CrP7_D-%2Fsync%2F20749d802db47553605c75210dc68895c2901367.png?generation=1618606160577314\&alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sfsetup.png)

2.4 In the left navigation area, scroll down to the **Build** section, expand **Create** and click on **Apps**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YkKVvzKQw7CrP7_D-%2Fsync%2Faf456e870ba636e72e981964908143ba87d359b7.png?generation=1618606162717777\&alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sfcreateapp.png)

2.5 Scroll down to the **Connected Apps** section and click on **New**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YkKVvzKQw7CrP7_D-%2Fsync%2Fbc2c4a4883f4bae181321677884e41ab2f35171f.png?generation=1618606159632589\&alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sfconnectedapp.png)

2.6 Fill in the required values for a new Connected App

a. Set the **Connected App Name** property to `IBM App Connect`

b. Set the **API Name** to `IBM_App_Connect`

c. Enter your email address as the **Contact Email**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YkKVvzKQw7CrP7_D-%2Fsync%2F4e28228600eedb35138d049339e585da9962267e.png?generation=1618606163854737\&alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sfnewconnectedapp.png)

2.7 Configure the OAuth settings

* Select the **Enable OAuth Setting** check box.
* Set the **Callback URL** to `https://www.ibm.com`
* Under **Selected OAuth Scopes** select **Manage user data via APIs (api)** and click the arrow under the **Add** label

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-27965bda257a725fd3366539fefeb6c0e4896e16%2Fsfoauth.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sfoauth.png)

2.8 Scroll down to the bottom of the web page and click **Save**. You should see a message indicting that the Connected App can take up to 10 minutes to take effect. Click **Continue**.

2.9 In the **API (Enable OAuth Settings)** section click on **Manage Consumer Details**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-b53bf0632f75224140318ed8074c442cd0d220e0%2Fmanage-consumer-details.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/manage-consumer-details.png)

2.10 You should be prompted for a Two-Factor Authentication prompt for a Verification code. Ener the code you received and click **Verify**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-ab29530e893aa7e9fb3cce27a8d3be722045af00%2Fsf-2fa-code.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sf-2fa-code.png)

2.11 Copy the **Consumer Key** and **Consumer Secret** to a text file. You will need them later to connect to Salesforce.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-48ea91685f50f2c7d8da168e170563a7cd1cb6be%2Fkey-and-secret.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/key-and-secret.png)

2.12 Click on your user name and select **My Settings**. On the left under the **Personal** section click on **Reset My Security Token**. Click on the **Reset Security Token** button.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YkKVvzKQw7CrP7_D-%2Fsync%2F985fd182f0e5c4e013e4c340b45c9cc5e7fcca55.png?generation=1618606158715788\&alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/reset-security-token.png)

2.13 Check your email for the email address that you use as your Salesforce username. You should receive an email from Salesforce with the subject **Your new Salesforce security token**. Copy the **Security Token** to the same text file that you used for the **Consumer Key** and **Consumer Secret**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YkKVvzKQw7CrP7_D-%2Fsync%2F615bbedd5c8fdd8fc37d10290262c6532a94c489.png?generation=1618606165311954\&alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sfsectoken.png)

> **Note:** Please wait 5-10 minutes before continuing to the next section.

## Section 3: Setup connectivity to Salesforce in App Connect Designer

App Connect Designer is a component of Cloud Pak for Integration that provides an authoring environment in which you can create, test, and share flows for an API. You can share your flows by using the export and import functions, or by adding them to an Asset Repository for reuse.

3.1 Go to your Workshop Information page and click on the App Connect Designer component link. (**Note:** if you no longer have the Workshop Information page available see [these instructions](https://ibm-developer.gitbook.io/cloudpakforintegration-workshop/docs/pre-work)).

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-55a339f47f34f6ed69b43623d65ede257cda9c3f%2Fnav-to-des.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/nav-to-des.png)

3.2 If prompted to login enter the credentials on the Workshop Information page

3.3 Click the **Catalog** icon

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-3acac248cbf617a36bc7e4e4e210a9a92f29893b%2Fappdesignercatalog.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/appdesignercatalog.png)

3.4 Expand **Salesforce** and then click **Connect**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-c7f891458aa326ffd3df0471535959b84c1c105e%2Fsf-connect.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sf-connect.png)

3.5 For **Authorization method** select **Provide a username,password, and client credentials (OAUTH2...** and click **Continue**

3.6 Enter the following values referring to the text file from the previous section where you saved your Salesforce credentials.

* For the **Login URL** enter `https://login.salesforce.com`
* For the **Username** enter the email you use to login to Salesforce
* For the **Password** enter the password you use to login to Salesforce. Then append the value of the **Security Token** (that you saved in the previous section) to the password. For example if your password is `foo` and your security token is `bar` you would enter `foobar` into the password field.
* For the **Client Id** copy and past the value of the **Consumer Key** (that you saved in the previous section).
* For the **Client Secret** copy and past the value of the **Consumer Secret** (that you saved in the previous section).

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-4ffbf56d814a2c64d48209a73cfc7c378e20ec43%2Fsfconnectionform.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sfconnectionform.png)

> **NOTE**: If you receive an error that the connection to Salesforce failed, then it is recommended to re-check the credentials and try again. You can re-enter the credentials for this account by clicking on the three dots next to the account name and clicking **Update Account** from the subsequent menu. The previous details are cleared, so you will need to enter them all again.

3.7 Click on **Connect**.

## Section 4: Create the flows in App Connect Designer

4.1 In App Connect Designer, click the **Dashboard** icon.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-4bf561d53c0493d49648c25b08693b728f102512%2Fdashboard.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/dashboard.png)

4.2 Click **New** and select **Flows for an API**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-1bbd99addcdbd36bfa6d5724594cf6c59af26a6a%2Fnewflow.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/newflow.png)

4.3 Name the flow `sfpush1`. Name the model `Client`

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-3a859d907e028ebe86a8cf0fcbe4f8ad9f1a6952%2Fflowname.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/flowname.png)

4.4 Click **Create Model**

4.5 Next you will add the properties of the input data for your flow.

> **Note**: Name them exactly as instructed (including matching case) so that your flow will work with the *TraderLite* app.

* Enter `ClientId` as the first property and then click **Add property +**
* Enter `FirstName` as the next property and then click **Add property +**
* Enter `LastName` as the next property and then click **Add property +**
* Enter `Email` as the next property and then click **Add property +**
* Enter `MobilePhone` as the next property

When you're done the screen should look like the following:

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-9bb85595fa8d2adbcd6b4a5e79213fa1153e8d6a%2Fmodelproperties.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/modelproperties.png)

4.6 Click **Operations** and then select **Create Client**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-605d9c77f1993446435dc70d8857fb63aa2871d3%2Foperation.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/operation.png)

4.7 Click **Implement flow**

4.8 Click on the **+** icon.

* Scroll down to Salesforce
* Select your account from the dropdown
* Expand **Contacts**
* Click **Create Contact**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-894b4023f2d712e24136ff8d6ef0fd109eed435e%2Fimplementflow1.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/implementflow1.png)

4.9 Next you'll map the properties from your model to the Salesforce Contact properties. The properties have the same names as their Salesforce equivalents so click on **Preview 6 mapping suggestions** and then **Apply suggestions** to complete the mapping.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-de55bc910bd1c8dffeaae8acd5a8f55078ba4b70%2Fautomatchfields.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/automatchfields.png)

4.10 Click on **Response** to configure what will be returned by the flow. Click in the text box for the **Client Id** property and then click on icon to the right of the text field. Select **Contact ID** as the mapping.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-59ac1a50ab022c33890810a3a81c55cfe2d8f8e1%2Fresponsedata.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/responsedata.png)

4.11 Next you'll test the flow to make sure it works. Click on Salesforce icon (the middle part of the flow) and then click on the edit icon.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-d89995b0e7e9f8f5a8131b67f2184ec40b2d57cc%2Ftestparams.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/testparams.png)

4.12 Click on **Request body parameters** and then expand the Object below it

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-55596532c133e3efd96c0de801ef82f11d79a828%2Ftestparams2.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/testparams2.png)

4.13 Click on **Regenerate sample data** and then set the **Client Id** to blank. This value will be generated by Salesforce and returned.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-fbd65a391a98b93e8ec2bb76a59d7c4950e2e11b%2Fedittestparams.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/edittestparams.png)

4.14 Click the "Try It" icon shown in the above screenshot. Click **Continue** when prompted and then verify that the operation returns a 200 HTTP status code.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-262ddd0810b0e7e199f05c301c8488dfe8b12f0d%2Fviewdetails.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/viewdetails.png)

4.15 Click **View details** to see the raw data returned from the call to Salesforce. Click **Done** (top of screen)

4.16 Next you'll build a reverse flow. One that will call an API in the TraderLite app whenever a Salesforce contact is updated. In your browser right click on the following link, right click and select **Save Link As ...** from the context menu. Save the file *sfsync.json* to your local system. This is an OpenAPI definition of the API in TraderLite that will update client data.

[sfsync.json](https://raw.githubusercontent.com/IBMStockTraderLite/traderlite-cp4i/master/appconnect/sfsync.json)

4.17 back in App Connect Designer click on the **Catalog** icon and then click on **+** to add your API.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-b7854f47fcdfa1d6192a7760baf2990709370600%2Fcatalogapis.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/catalogapis.png)

4.18 Select **OpenAPI** as the **Document type** and drag or select the *sfsync.json* file you just downloaded

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-f2c34b3df7593fcbcbdf7a7beb8e059a562148f3%2Fadd-api-icon.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/add-api-icon.png)

4.19 Click **Next** and then click **Import API**

4.20 Scroll down to your imported API (**Salesforce Sync for Trader Lit**), click on the down arrow and then on **Connect**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-5368e15959d9b5bee521ec617ab628039db8e079%2Fconnectapi.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/connectapi.png)

4.21 Accept the default values and click **Connect** again

4.22 Click on the **Dashboard** icon

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-685a5be9bcb810417347ed1a7fe988530ab69f39%2Fdashboard2.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/dashboard2.png)

4.23 Click **New** and select **Event-driven flow**

4.24 Name the flow `sfevent1`,

4.25 Expand the Salesforce section and select your specific account (e.g. `Account 1`). Under **Contacts** select **Updated contact**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-b3129a7a45f972daa475d2833ea8f057052f7cb7%2Fupdatedcontact.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/updatedcontact.png)

4.26 Click the **+** icon. Expand your **Salesforce Sync for Trader Lit** API and click on **PUT /salesforce/contacts**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-98f7f2e9e8c4de94cc72154932e48502eb35a7e2%2Fsfsyncapi.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sfsyncapi.png)

4.27 Click **Preview 4 mapping suggestions** to start the field mappings between the Salesforce contact and your API. Click **Apply suggestions**.

4.28 Place your cursor in the **ClientId** field and then click the icon right next to the field. Select the Salesforce **Contact ID** field

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-661275e77a0078d3405761212be3c5e2e257e89e%2Ffieldsmapped.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/fieldsmapped.png)

4.29 Click on the **Dashboard** icon at the left

4.30 Export your `sfevent1` flow by clicking on the 3 period icon and selecting **Export..** from the context menu.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-270d3ac25e1153084d21e2326b02245b21e14cc3%2Fexportevt.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/exportevt.png)

4.31 Select **Runtime flow asset (BAR)** and click **Export**

4.32 Click **Save**

4.33 Repeat for your `sfpush1` flow, also selecting **Runtime flow asset (BAR)** and saving to your local system.

## Section 5: Create an Integration Server instance and deploy your flows

In this step you'll create an Integration Server instance and deploy your flows to it.

5.1 Go to your Workshop Information page and click on the **App Connect Dashboard** component link. (**Note:** if you no longer have the Workshop Information page available see [these instructions](https://ibm-developer.gitbook.io/cloudpakforintegration-workshop/docs/pre-work)).

5.2 If prompted to login enter the credentials on the Workshop Information page.

5.3 Click **Deploy integrations**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-a1f17b4ee22955cfc2642cfd07d86440421c1e4d%2Fdashboardui.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/dashboardui.png)

5.4 Select the **Quick start integration** tile and click **Next**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-717c42367e0c132cf2658d060405efec6219c539%2Fqsdesint.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/qsdesint.png)

5.5 Upload your `sfevent1.bar` file and click **Next**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-967668e017ed07ea19a155501fef8e2d76f8a5d6%2Fsfeventsbar.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/sfeventsbar.png)

5.6 Wait until you see an existing configuration loaded (it can take a few seconds during which time it asks you to create a new config - ignore that) . Once the config loads, select the **Accounts** type and leave the others unchecked. Click **Next**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-73a7bc4d3235d9ea41b1bf69be824121b848251f%2Faccountfile.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/accountfile.png)

> **Note**: Without *Accounts* checked, your flow will not work when deployed . This allows the secret with your Salesforce credentials to be accessible to the deployed flow.

5.7 Name the server `sfevent1`.

5.8 Ensure that the **Designer flows mode** is set to **local**, the **Designer flows type** is set to **event-driven-or-api-flows** and click **Create** .

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-c95a7c7c52a87e2961fe338314344fdf1e244b73%2Fserver-details.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/server-details.png)

5.9 It will take a while for the server to provision so you can continue deploying the other flow. Click **Deploy integrations**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-283648933e364f3e1aef0c0dcf8d6db2c2bc3928%2Fcreate-server2.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/create-server2.png)

5.10 Select the **Quick start integration** tile and click **Next**

5.11 Upload your `sfpush1.bar` file and click **Next**

5.12 Select the **Accounts** type and leave the others unchecked. Click **Next**

> **Note**: Without *Accounts* checked, your flow will not work when deployed . This allows the secret with your Salesforce credentials to be accessible to the deployed flow.

5.13 Name the server `sfpush1`.

5.14 Ensure that the **Designer flows mode** is set to **local**, the **Designer flows type** is set to **api-flows** and click **Create** .

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-7ade65ec584ad3a86125eda716db4c7f0ab0a9cc%2Fserver-details2.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/server-details2.png)

5.15 Wait for both servers be in the **Ready** state. They will take about 2 or 3 minutes.

> **Note:** You may have to refresh the page to get the latest server status

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-59aa286d8a5e98e114927d8502ffbd3fa3992da3%2Fserversdeployed.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/serversdeployed.png)

## Section 6: Get the REST endpoint of your App Connect Flow

6.1 In the App Connect Dashboard click on the tile for your `sfpush1` server

6.2 Click on the API tile to see the details of the flow's API

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-91bb10f6a5cc912ac72849234cc4a08dacb7331f%2Fapitile.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/apitile.png)

6.3 You should see the details of your flow's API

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-5357cdc402aaead4c01de1408ed70a89196d4d10%2Fapidetails.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/apidetails.png)

6.4 Copy the **Endpoint** and save it in a text file.

## Section 7: Test your App Connect Flows with Trader Lite

7.1 Go to the OpenShift console of your assigned cluster. Select the **student1** project. In the navigation on the left select **Installed Operators** and select the **TraderLite Operator**

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-f3d6d02866be001976ab62ce500ac28433b1a0dc%2Fselect-traderlite-operator.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/select-traderlite-operator.png)

7.2 Click on the **TraderLite app** tab

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YkKVvzKQw7CrP7_D-%2Fsync%2Ff0b7b1e10d5d786a0398c3559e9c36e6a5ef40c2.png?generation=1618606159132170\&alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/traderlite-crd.png)

7.3 Click on the 3 periods to the right of the existing TraderLite CRD and select **Edit TraderLite** from the context menu.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-67ff4ac506ef9bbd00f3868995b0b60eacba7103%2Fselect-traderlite-crd.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/select-traderlite-crd.png)

7.4 Scroll down to line 211 and change the **enabled** field value to *true* and paste the endpoint of your API flow that you saved earlier as the **url** value on line 215.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-42b89acaafbe123d78ca0d8b47feaef2ab7648e1%2Fenable-sf-integration.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/enable-sf-integration.png)

7.5 Click **Save**.

7.6 In the navigation area on the left select **Pods** in the **Workloads** section. You should see that a new instance of the Portfolio pod has been started.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-6cebab30711d84c8a6a9509fb411b5e740e3d112%2Fportfolio-restart1.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/portfolio-restart1.png)

7.7 Wait until the new pod is in the **Ready** state and the previous pod has terminated before continuing.

> **Note**: You will know the traderlite-portfolio-xxxxx pod is in a ready state when the `Ready` column shows `1/1`. You will also see that the created column will have a recent timestamp value.

7.8 In the left navigation click on **Routes** (in the **Networking** category) and then click on the icon next to the url for the **tradr** app (the UI for TraderLite)

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-b283f8864090971da1282a9ffb7a6cc796fb8321%2Ftraderlite-run-tradr.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/traderlite-run-tradr.png)

7.9 Log in using the username `stock` and the password `trader`

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-086df65a2bd3352f86bced6d635a1a167df5f10f%2Fstock-trader-login.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/stock-trader-login.png)

7.10 Click **Add Client** and fill in the form. You must use valid email and phone number formats to avoid errors.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-3399b0b09324087f64cd1fd721f51b26f2be4141%2Fnew-client.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/new-client.png)

7.11 Click **Save**

7.12 Click on the **Portfolio ID** of the new client to see the details of the portfolio

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-59165c1aae1488bf544061022e544d02ff989e24%2Fnew-portfolio.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/new-portfolio.png)

7.13 Click on the **Client Details** tab. Because the TraderLite app is now calling your *sfpushnnn* flow whenever a new client is created, you should see a Salesforce Contact Id in the form of a link.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-8af85fb81b2ded01b57cf97d7410411e1d111a53%2Fclient-details.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/client-details.png)

7.14 Right click on the Contact Id link and select **Open Link in New Tab** to see the contact in Salesforce (you may be prompted for your Salesforce credentials)

> **Note**: If the link does not work because of geo specific URLs for Salesforce, login in to Salesforce by yourself and look at the new contact. The easiest way to find the new contact is to enter the first and last name in the search bar in Salesforce.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-067234cdbaa4dd69a5ee86189d0da69b8aa0f13c%2Fedit-contact.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/edit-contact.png)

7.15 Now test your reverse flow (i.e. when a contact is modified in Salesforce). Click on the **Edit** button for the contact and change the mobile number. Click **Save**.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-b92ee44af6c8788701779055d85c67739c60fd61%2Fedit-contact2.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/edit-contact2.png)

7.16 Go back to the tab with the TraderLite app and refresh the page with the Client Details. Click on the **Client Details** tab and verify that the phone number has been updated with the new value you added in Salesforce.

[![](https://1545196524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0YkKVvzKQw7CrP7_D-%2Fuploads%2Fgit-blob-e3c3a8a822bf48b5d94b85738eba240e4277208f%2Fupdated-client-details.png?alt=media)](https://github.com/IBM/cloudpakforintegration-workshop/blob/master/docs/exercise-app-connect/images/updated-client-details.png)

## Summary

Congratulations ! You successfully completed the following key tasks in this lab:

* Connected to Salesforce
* Created an App Connect designer flow to push client data to Salesforce contacts.
* Created an Event Driven flow to push Salesforce contact updates to the TraderLite App via an API call
* Deployed the flows as Integration Servers in App Connect Dashboard
* Tested the flow with the Trader Lite app.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ibm-developer.gitbook.io/cloudpakforintegration-workshop/docs/exercise-app-connect.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.