# Upgrading to version 1.4

Use the following instructions to upgrade from a previous version of the Digital River app for Salesforce Lightning to version 1.4. If you're installing a new version of this app, see [Install the Digital River app](https://docs.digitalriver.com/salesforce-lightning/salesforce-lightning-b2b-commerce-app-1.4/integrate-the-salesforce-lightning-app/step-1-install-the-digital-river-app) for instructions.

{% hint style="info" %}
**Note:** If you are upgrading from version 1.1 or later, you only need to perform Step 1 and 7.
{% endhint %}

1. Install the latest version of the Salesforce Lightning app as described in [Step 1](https://docs.digitalriver.com/salesforce-lightning/salesforce-lightning-b2b-commerce-app-1.4/integrate-the-salesforce-lightning-app/step-1-install-the-digital-river-app).\
   **Note:** There is a known Salesforce bug related to setting default values on designer attributes. You can work around this by making sure to click through all designer attributes and Save whenever you add a new component to a screen. You should do this when upgrading to a new version of the connector, especially if a particular component is not rendering.

2. Update the Shipping Address subflow described in [Configure the shipping address subflow](https://docs.digitalriver.com/salesforce-lightning/salesforce-lightning-b2b-commerce-app-1.4/integrate-the-salesforce-lightning-app/step-17-integrate-the-digital-river-components-into-the-checkout-flow/subflow-configuration/configure-the-shipping-address-subflow).\
   **Note**: We added some additional actions and components to this version of the app.

3. Update the Payments and Billing subflow described in [Configure the Payment and Billing Address subflow](https://docs.digitalriver.com/salesforce-lightning/salesforce-lightning-b2b-commerce-app-1.4/integrate-the-salesforce-lightning-app/step-17-integrate-the-digital-river-components-into-the-checkout-flow/subflow-configuration/configure-the-payment-and-billing-address-subflow) as follows:
   1. Remove the `Payment_Details` resource. Note that you can choose to leave it as is, but it will no longer be used.
   2. Add the `db2b_paymentDetails` component to the `placeOrder` screen.

4. [Enable the order.cancelled event](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/webhooks/creating-a-webhook#step-3-create-webhooks) from the Webhooks page on the [Digital River Dashboard](https://dashboard.digitalriver.com/login). See [Step 11](https://docs.digitalriver.com/salesforce-lightning/salesforce-lightning-b2b-commerce-app-1.4/integrate-the-salesforce-lightning-app/step-11-set-up-webhooks) for complete instructions.\
   ![](https://474794349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlKR9Leh9OBazVU7KgFio%2Fuploads%2FLt44Jxs5hph1tKIuU3Dp%2Fenable%20order%20cancelled%20event.png?alt=media\&token=75f4c4b5-9bca-44b8-85a9-00a29a0e1df7)

5. Add a new picklist value called `partially_cancelled` to the `DR_Order_Item_State__c` field on the `OrderItem` object.

6. Add the following new picklist values to the `DR_Order_State__c` field on the `Order` object:
   1. `cancelled_by_dr`
   2. `cancelled_by_sf`
   3. `salesforce_failure`

7. Update the **Key** value for the **Connector Version** to version `1.4/3.24`. Use the following instructions<mark style="background-color:yellow;">:</mark>

   1. Click **Setup** ![](https://474794349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlKR9Leh9OBazVU7KgFio%2Fuploads%2FXfbzmPKl0nMS5FFkwelC%2FSetup.png?alt=media) and select **Setup** from the dropdown list.
   2. Type `Custom Metadata Types` in the **Quick Find** field and then click **Custom Metadata Types**. The **Custom Metadata Types** page appears with the **All Metadata Types** list.
   3. Locate the **DR Connector Configuration** metadata type from the lists (Label) and click the **Manage Records** action next to that type selection. \
      ![](https://474794349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlKR9Leh9OBazVU7KgFio%2Fuploads%2FVP1ZdDoplUQskpjAmFNh%2FCMDT_list_1.jpg?alt=media\&token=e1100581-97c1-40f1-babd-ca64cbd09e26)
   4. On the **DR Connector Configurations** page find the **Connector Version** setting (Label). Click **Edit** next to the **Connector Version** setting.\
      &#x20;![](https://474794349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlKR9Leh9OBazVU7KgFio%2Fuploads%2F0kwK84ZxUjNmCMIXnbHB%2FCMDT_version_2.jpg?alt=media\&token=6f7b7464-3d86-40cf-ae00-2919434c0716)
   5. Update the **Key** value for the **Connector Version** to the version mentioned at the beginning of this step or as instructed by your project manager.\
      ![](https://474794349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlKR9Leh9OBazVU7KgFio%2Fuploads%2F5Rwetg6YIG4g9tI3DThh%2FCMDT_key_3.jpg?alt=media\&token=cd0ec455-5958-4e99-8958-32086a4805e3)

8. Click **Save** after you have finished updating the version number and have made all other listed changes. Return to the **Home** page.
