Upgrading to version 2.0

Learn how to upgrade from previous version to version 2.0.

Use the following instructions to upgrade from a previous version of the Digital River app for Salesforce Lightning to version 2.0. If installing a new version of this app, see Install the Digital River app for instructions.

Note: If you previously used the Digital River app with an Aura storefront and are implementing the LWR storefront, we recommend you perform all steps in Integrating the Digital River app as you would for a new environment.

If you use the Digital River app with an Aura storefront and will still have an Aura storefront after the upgrade, continue with the steps below.

Note: If upgrading from version 1.1 or later, you only need to perform Steps 1, 7, and 8.

1. Install the latest version of the Salesforce Lightning app as described in Step 1. Note: A known Salesforce bug exists for setting default values on designer attributes. You can work around this by clicking through all designer attributes and Saving whenever you add a new component to a screen. You should do this when upgrading to a new connector version, especially if a particular component is not rendering.

2. Update the Shipping Address subflow described in Configure the shipping address subflow. Note: We added some additional actions and components to this app version.

3. Update the Payments and Billing subflow described in Configure the Payment and Billing Address subflow as follows:

   1. Remove the Payment_Details resource. You can 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 from the Webhooks page on the Digital River Dashboard. See Step 11 for complete instructions.
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 2.0/3.58. Use the following instructions:

   1. Click Setup and select Setup from the drop-down 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.
   4. Find the Connector Version setting (Label) on the DR Connector Configurations page. Click Edit next to the Connector Version setting.
   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.
   6. Click Save after updating the version number and making all other listed changes. Return to the Home page.

8. If you sell to businesses, you must collect the Organization Name of the business in your UI. If you sell to individuals, skip this step. Add the Buyer Organization Name to your user interface. This component's API Name is Buyer_OrganizationName__c on the WebCart object. Collect this field's information on the user interface screen where you collect the Purchase Type from the shopper. This is typically done on the Shipping Address screen. If you use the drb2b_buyerInfo component, this field has already been added. If you do not use that component, add a new field to your user interface to collect the Organization name. See the Buyer info component for more details.