Lucky Setup - Salesforce

This guide will show you how to install the Lucky Shopify App, connect to your account, as well as register and update products in Lucky.

Nick Scherer
39 steps
4 minutes

Salesforce

Demandware

Download Lucky Cartridge from AppExchange

Navigate to [https://appexchange.salesforce.com/](https://appexchange.salesforce.com/)

Search for "lucky" and Select "Lucky Cartridge for B2C Commerce"

Click here.

Click here. Click "Visit Provider"

Create or Locate Business Manager Credentials

Navigate to https://{YOUR_REALM_NAME}-{YOUR_INSTANCE_ID}.dx.commercecloud.salesforce.com/on/demandware.store/Sites-Site/

Click the Profile icon.

Click "Manage Access Keys"

Click "Generate Access Key"

Click "Generate"

Copy the generated Access Key and paste it in "password" field in dw.json file.

NOTE: The next steps require some technical knowledge including command line usage

You will need to install npm package sgmf-scripts before uploading Lucky Cartridge

Unzip the Lucky Cartridge download zip file and then open in any editor. Create a new `dw.json` file at the root project level. Your credentials should look something like this: { "username": "[myemail@email.com](mailto:myemail@email.com)", "password": "my-password", "hostname": "[myrealm-myinstanceid.dx.commercecloud.salesforce.com](http://myrealm-myinstanceid.dx.commercecloud.salesforce.com)", "code-version": "SFRA_AP_08_17_2023" }

While in the project root directory of your cartridge download, run this command in a UNIX based terminal: `npm run uploadCartridge` If successful, you will see output that looks something like this: npm run uploadCartridge > luckylocal@0.0.1 uploadCartridge /Users/myusername/Downloads/lucky-salesforce-app > sgmf-scripts --uploadCartridge plugin_luckylocal && sgmf-scripts --uploadCartridge bm_luckylocal { 'file-upload': false, 'cartridge-upload': false, 'directory-create': false, 'file-delete': false } [11:28:36] Successfully uploaded cartridge: plugin_luckylocal [11:28:36] Done! { 'file-upload': false, 'cartridge-upload': false, 'directory-create': false, 'file-delete': false } [11:28:37] Successfully uploaded cartridge: bm_luckylocal [11:28:37] Done!

Upload Lucky Metadata

Click "Open menu item submenu"

Click "Import & Export"

Click "Upload"

Click this file field. Click "Upload" Click "Import & Export"

Click "Import"

Click this radio button.

Click "Next >>"

Click "Import"

Add Lucky Cartridges to Business Manager and your ecommerce Site

Click "Manage Sites"

Click "RefArch"

Click "Settings"

Click the "Cartridges" field.

Insert "bm_luckylocal:plugin_luckylocal:" BEFORE "app_storefront_base"

Click "Apply"

Click "Manage Sites"

Click "Business Manager"

Insert "bm_luckylocal:plugin_luckylocal:" BEFORE "bm_app_storefront_base"

Click "Apply"

Grant Lucky App permissions

Under "Administration", click "Roles & Permissions"

Click "Administrator" Click "Business Manager Modules"

Under "Select Context", choose "Organization" and click "Apply"

Click all checkboxes next to Lucky Local or Lucky Local Locator Click "Update"

Create & Configure Lucky Service

Click "Administration"

Click "Services"

Click "New" Click the "Name" field. Type "lucky.service" Click the checkbox "Enabled" Click the "Log Name Prefix" field. Type "lucky" Click the checkbox "Communication Log Enabled" Click "Apply"

Once confirmed, click "Administration" Click "Lucky Local".

Please reach out the Lucky team (dev@luckylabs.io) to receive your login credentials before continuing forward.

Enter your Lucky login credentials and click "Login"

SUCCESS: Your Salesforce store is now setup and ready to use Lucky

Lucky Setup - Salesforce

This guide will show you how to install the Lucky Shopify App, connect to your account, as well as register and update products in Lucky.

Nick Scherer
39 steps
4 minutes

Salesforce

Demandware

Download Lucky Cartridge from AppExchange

Navigate to [https://appexchange.salesforce.com/](https://appexchange.salesforce.com/)

Search for "lucky" and Select "Lucky Cartridge for B2C Commerce"

Click here.

Click here. Click "Visit Provider"

Create or Locate Business Manager Credentials

Navigate to https://{YOUR_REALM_NAME}-{YOUR_INSTANCE_ID}.dx.commercecloud.salesforce.com/on/demandware.store/Sites-Site/

Click the Profile icon.

Click "Manage Access Keys"

Click "Generate Access Key"

Click "Generate"

Copy the generated Access Key and paste it in "password" field in dw.json file.

NOTE: The next steps require some technical knowledge including command line usage

You will need to install npm package sgmf-scripts before uploading Lucky Cartridge

Upload Lucky Metadata

Click "Open menu item submenu"

Click "Import & Export"

Click "Upload"

Click this file field. Click "Upload" Click "Import & Export"

Click "Import"

Click this radio button.

Click "Next >>"

Click "Import"

Add Lucky Cartridges to Business Manager and your ecommerce Site

Click "Manage Sites"

Click "RefArch"

Click "Settings"

Click the "Cartridges" field.

Insert "bm_luckylocal:plugin_luckylocal:" BEFORE "app_storefront_base"

Click "Apply"

Click "Manage Sites"

Click "Business Manager"

Insert "bm_luckylocal:plugin_luckylocal:" BEFORE "bm_app_storefront_base"

Click "Apply"

Grant Lucky App permissions

Under "Administration", click "Roles & Permissions"

Click "Administrator" Click "Business Manager Modules"

Under "Select Context", choose "Organization" and click "Apply"

Click all checkboxes next to Lucky Local or Lucky Local Locator Click "Update"

Create & Configure Lucky Service

Click "Administration"

Click "Services"

Click "New" Click the "Name" field. Type "lucky.service" Click the checkbox "Enabled" Click the "Log Name Prefix" field. Type "lucky" Click the checkbox "Communication Log Enabled" Click "Apply"

Once confirmed, click "Administration" Click "Lucky Local".

Please reach out the Lucky team (dev@luckylabs.io) to receive your login credentials before continuing forward.

Enter your Lucky login credentials and click "Login"

SUCCESS: Your Salesforce store is now setup and ready to use Lucky