Upgrading to version 1.6

Learn how to upgrade from previous version to version 1.6.

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

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 for setting default values on designer attributes exists. 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 1.6/3.31. 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 you have finished updating the version number and have made 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 Buyer info component for more details.