Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel12
maxLevel3
maxLevel2

Extension installation via composer for Magento 2.4.3

Latest Versions

Module

Version

Magento Commerce

(aka. OpenSource)

Adobe Commerce

(Adobe Commerce Cloud)

Adobe Commerce

(Adobe Commerce Cloud)

+ Native B2B extension

tnw/sforcecountrystate

Insert excerpt
_tnw_sforcecountrystate
_tnw_sforcecountrystate
nopaneltrue

(tick)

(tick)

(tick)

Installation/Upgrade Instructions

STEP 1 - Register new composer repository

Register PowerSync repository

Info

NOTE: These steps are only necessary when installing our software for the first time

Code Block
composer config repositories.powersync composer https://dist.powersync.biz

STEP 2 - Enable maintenance mode

Code Block
bin/magento maintenance:enable

STEP 3 - Install the product via composer

composer require

Insert excerpt
_install tnw/soap-client
_install tnw/soap-client
nopaneltrue
Insert excerpt
_install tnw/salesforce
_install tnw/salesforce
nopaneltrue
Insert excerpt
_install tnw/sforcecustomergroup
_install tnw/sforcecustomergroup
nopaneltrue
Insert excerpt
_install tnw/sforcetierprice
_install tnw/sforcetierprice
nopaneltrue
Insert excerpt
_install tnw/sforceenterprise
_install tnw/sforceenterprise
nopaneltrue
Insert excerpt
_install tnw/sforcerma
_install tnw/sforcerma
nopaneltrue
Insert excerpt
_install tnw/sforcequickorder
_install tnw/sforcequickorder
nopaneltrue
tnw/sforcecountrystate=
Insert excerpt
_tnw_sforcecountrystate
_tnw_sforcecountrystate
nopaneltrue
--no-update

Code Block
composer upgrade tnw/soap-client tnw/salesforce tnw/sforceenterprise tnw/sforcecustomergroup tnw/sforcetierprice tnw/sforcerma tnw/sforcequickorder tnw/sforcecountrystate

STEP 4 - Performing Magento upgrade

Insert excerpt
_after_installation
_after_installation
nopaneltrue

Info

Re-save configuration pages after the upgrade

Extension installation via composer for Magento 2.4.4

Latest Versions

Module

Version

Magento Commerce

(aka. OpenSource)

Adobe Commerce

(Adobe Commerce Cloud)

Adobe Commerce

(Adobe Commerce Cloud)

+ Native B2B extension

tnw/sforcecountrystate

Insert excerpt
_tnw_sforcecountrystate-2.4.4
_tnw_sforcecountrystate-2.4.4
nopaneltrue

(tick)

(tick)

(tick)

Installation/Upgrade Instructions

STEP 1 - Register new composer repository

Register PowerSync repository

Info

NOTE: These steps are only necessary when installing our software for the first time

Code Block
composer config repositories.powersync composer https://dist.powersync.biz

STEP 2 - Enable maintenance mode

Code Block
bin/magento maintenance:enable

STEP 3 - Install the product via composer

composer require

Insert excerpt
_install tnw/soap-client-2.4.4
_install tnw/soap-client-2.4.4
nopaneltrue
Insert excerpt
_install tnw/salesforce-2.4.4
_install tnw/salesforce-2.4.4
nopaneltrue
Insert excerpt
_install tnw/sforcecustomergroup-2.4.4
_install tnw/sforcecustomergroup-2.4.4
nopaneltrue
Insert excerpt
_install tnw/sforcetierprice-2.4.4
_install tnw/sforcetierprice-2.4.4
nopaneltrue
Insert excerpt
_install tnw/sforceenterprise-2.4.4
_install tnw/sforceenterprise-2.4.4
nopaneltrue
Insert excerpt
_install tnw/sforcerma-2.4.4
_install tnw/sforcerma-2.4.4
nopaneltrue
Insert excerpt
_install tnw/sforcequickorder-2.4.4
_install tnw/sforcequickorder-2.4.4
nopaneltrue
tnw/sforcecountrystate=
Insert excerpt
_tnw_sforcecountrystate-2.4.4
_tnw_sforcecountrystate-2.4.4
nopaneltrue
--no-update

Code Block
composer upgrade tnw/soap-client tnw/salesforce tnw/sforceenterprise tnw/sforcecustomergroup tnw/sforcetierprice tnw/sforcerma tnw/sforcequickorder tnw/sforcecountrystate

STEP 4 - Performing Magento upgrade

Insert excerpt
_after_installation
_after_installation
nopaneltrue

Info

Re-save configuration pages after the upgrade

Usage

Country State module provides you with the ability to import Countries and States from Salesforce to Magento

...

As a result, all Country State module options become available

...

Note

Important: Also you need to start related consumers:

  • tnwCountryStateUpdateConsumerAmqp

  • tnwCountryStateUpdateConsumerDb

Follow the manage message queues documentation and add the following listeners to your /app/etc/env.php file.

To Disable Country State module

...

As a result, all Country State module options will be hidden.

...

Country State module Connection to Salesforce

Country State module requires connection to Salesforce. You need to upload Metadata WSDL file and then click the Test Connection & Apply Salesforce changes button

...

To get Metadata WSDL file:

  • Go to Salesforce - Gears button - Setup

...

  • Start typing “API“ word into the “Search Setup“ field

  • Click on the “API integration” item in the Search list

...

  • Click on Generate Metadata WSDL link and save page content to file

...

  • go to Magento Admin panel - Salesforce (sidebar menu) - Country State - Country State Configuration tab

  • Click on the “Browse“ button and select the previously saved Metadate WSDL file

...

  • Click Save button

  • Click “Test Connection & Apply changes

...

Enable Automatic Update

The “Enable Automatic Update” option allows you to Enable/Disables Automatic Country State import. If disabled, the import still can be performed manually

...

  • go to Magento Admin panel - Salesforce (sidebar menu) - Country State - Country State Configuration tab

  • Click the “Update Now“ button

...

Manage Countries page

On Manage Countries page you could view all countries created in the Magento database

  • go to Magneto Admin panel - Sidebar menu - Salesforce icon

...

By clicking on “Manage Regions“ action link you will be able to view all regions/states created for selecte country

...

Use Cases

Create new Country

For example, you need to create a new country that is not listed among default Magento countries. You need to do next:

  • Go to Salesforce - Click on Gears button - Setup

...

  • Start typing the “picklist“ word into the “Search Setup“ field

  • Click on the “State and Country/Territory Picklists Data” item in the Search list

...

  • Click on “The Configure States, Countries, and Territories“ link

...

  • Click the “New Country/Territory“ button

  • Fill in all required fields and click Add button

...

  • go to Magento Admin panel - Salesforce (sidebar menu) - Country State - Country State Configuration tab

  • Click the “Update Now“ button

  • go to Magento Admin panel - Stores - Configuration - General - Country Options tab

  • Find the newly created country in Allow Countries list

...

  • check new country is available on Frontend

...

Create new States

In case when you need to create a new state for an existing country that is not listed among default Magento states. Do next:

Let try to add new states for Andorra

...

  • Go to Salesforce - Click on Gears button - Setup

...

  • Start typing the “picklist“ word into the “Search Setup“ field

  • Click on the “State and Country/Territory Picklists Data” item in the Search list

...

  • Click on “The Configure States, Countries, and Territories“ link

...

  • Click the “Edit” link near Andorra country

...

  • Click the “New State“ button

...

  • Fill in all required fields and click Add button

...

  • go to Magento Admin panel - Salesforce (sidebar menu) - Country State - Country State Configuration tab

  • Click the “Update Now“ button

  • Go to Magento Frontend and check new States are available for Andorra

...

  • Place order for new state and check synchronization with Salesforce

...

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@11ce5
sortmodified
showSpacefalse
reversetrue
typepage
cqllabel = "kb-how-to-article" and type = "page" and space = "IWS"
labelskb-how-to-article
Page Properties
hiddentrue

Related issues