Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

Insert excerpt
_notes_installation_warning
_notes_installation_warning
nopaneltrue

Latest Versions

if you are using Magento 2.4.4 and above - follow the Magento 2.4.4 and Newer: Magento Extension  instruction

With Adobe Commerce 2.4.3 or under, see the table below.

Module

Version

Magento Commerce

(aka. OpenSource)

Adobe Commerce

(Adobe Commerce Cloud)

Adobe Commerce

(Adobe Commerce Cloud)

+ Native B2B extension

tnw/marketing

2.9.4

(tick)

(tick)

(tick)

tnw/soap-client

Insert excerpt
_tnw_soap-client
_tnw_soap-client
nopaneltrue

(tick)

(tick)

(tick)

tnw/salesforce

Insert excerpt
_tnw_salesforce
_tnw_salesforce
nopaneltrue

(tick)

(tick)

(tick)

tnw/sforceenterprise

Insert excerpt
_tnw_sforceenterprise
_tnw_sforceenterprise
nopaneltrue

(tick)

(tick)

(tick)

tnw/sforcecustomergroup

Insert excerpt
_tnw_sforcecustomergroup
_tnw_sforcecustomergroup
nopaneltrue

(tick)

(tick)

(tick)

tnw/sforcetierprice

Insert excerpt
_tnw_sforcetierprice
_tnw_sforcetierprice
nopaneltrue

(tick)

(tick)

(tick)

tnw/sforcerma

Insert excerpt
_tnw_sforcerma
_tnw_sforcerma
nopaneltrue

(error)

(tick)

(tick)

tnw/sforcequickorder

Insert excerpt
_tnw_sforcequickorder
_tnw_sforcequickorder
nopaneltrue

(tick)

(tick)

(tick)

tnw/sforceb2b

Insert excerpt
_tnw_sforceb2b
_tnw_sforceb2b
nopaneltrue

(error)

(error)

(tick)

tnw/b2b

Insert excerpt
_tnw_b2b
_tnw_b2b
nopaneltrue

(error)

(error)

(tick)

Installation/Upgrade Instructions

...

We advise installing Magento extensions via composer.

...

STEP 1 - Register new composer repository

Insert excerpt
_composer_config
_composer_config
nopaneltrue

STEP 2 - Enable maintenance mode

...

titleMagento maintenance mode
Code Block
bin/magento maintenance:enable
Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFFAE6

Before the upgrade process stop all background scripts on your server:

  • cron jobs

  • consumers - you can use some command like this:

    Code Block
    kill $(ps aux | grep 'queue:consumer[s]\?:start' | awk '{print $2}')

    ask your server admin to help with that

STEP 3 - Install

...

(warning) Follow Magento 2: Magento Extension Upgrade to 2.6 instructions only if you are using TNW_Salesforce 2.5. 

The following composer command should be used for Magento 2.3 or above

...

titleComposer command

...

the product via composer

Note

if you are using Magento 2.4.4 and above - follow the Magento 2.4.4 and Newer: Magento Extension  instruction

Expand
titleAdobe Commerce (Adobe Commerce Cloud): version 2.3.5 - 2.4.3

composer require

Insert excerpt
_install tnw/marketing
_install tnw/marketing
nopaneltrue
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

...

If you have previous module version already - use the upgrade commands instead:

...

titleComposer command

...

 
Insert excerpt
_install tnw/sforcequickorder
_install tnw/sforcequickorder
nopaneltrue
--no-update

composer upgrade tnw/marketing tnw/soap-client tnw/salesforce tnw/sforceenterprise tnw/sforcecustomergroup tnw/sforcetierprice tnw/sforcerma tnw/sforcequickorder

Expand
titleAdobe Commerce (Adobe Commerce Cloud) + B2B: version 2.3.5 - 2.4.3

composer require

Insert excerpt
_install tnw/marketing
_install tnw/marketing
nopaneltrue
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
Insert excerpt
_install tnw/sforceb2b
_install tnw/sforceb2b
nopaneltrue
tnw/b2b=
Insert excerpt
_tnw_b2b
_tnw_b2b
nopaneltrue
--no-update

composer

...

upgrade tnw/marketing tnw/soap-client tnw/salesforce tnw/sforceenterprise tnw/sforcecustomergroup tnw/sforcetierprice tnw/

...

titleComposer command

...

sforcerma tnw/sforcequickorder tnw/sforceb2b tnw/b2b

Expand
title

...

Panel
title*nix command

composer require tnw/soap-client=1.1.1 tnw/salesforce=2.5.30  tnw/sforcebusiness=2.5.27 tnw/sforceenterprise=2.5.21

...

titleIf you want only download packages without installation process
Magento Commerce (aka. Magento Open Source): version 2.3.5 - 2.4.3

composer require

Insert excerpt
_install tnw/marketing
_install tnw/marketing
nopaneltrue
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

...

/sforcequickorder
_install tnw

...

/sforcequickorder
nopaneltrue

...

--no-update

composer upgrade tnw/marketing tnw/soap-client tnw/salesforce tnw/sforceenterprise tnw/sforcecustomergroup tnw/sforcetierprice tnw/sforcequickorder

Follow Magento 2: Magento Extension Upgrade to 2.6 instructions only if you are using TNW_Salesforce 2.5. 

Warning

If you are still using Magento 2.2, use the following command to install an older version of our integration. The latest version of the integration only works with Magento platform version 2.3.5 and above.

composer require tnw/soap-client=1.1.1 tnw/salesforce=2.5.30  tnw/sforcebusiness=2.5.27 tnw/sforceenterprise=2.5.21

STEP 4 - Performing Magento upgrade

Insert excerpt
_after_installation
_after_installation
nopaneltrue

Info

Re-save

...

configuration

...

pages after the upgrade

Download composer packages

If you must download any of the modules via composer, use the example below:

Code Block
composer archive -fzip MODULE_NAME MODULE_VERSION

Example:

Code Block
composer archive -fzip tnw/soap-client 1.1.1
Note

Please be advised that we don’t recommend going this route. Our support does not cover installation issues and/or upgrades if this method is used.

Uninstall

excerpt-include
_uninstall tnw/salesforce
_uninstall tnw/salesforce
nopaneltrue

excerpt-include
_uninstall tnw/

...

sforceenterprise
_uninstall tnw/

...

sforceenterprise
nopaneltrue

If you want to remove all Database changes our module made, use the following sql queries:

Code Block
languagesql
alter table admin_user
    drop column  tnw_token;

alter table admin_user
    drop column  tnw_token_creed_at;

alter table customer_grid_flat
    drop column  sforce_account_id;

alter table customer_grid_flat
    drop column  sforce_id;

alter table customer_grid_flat
    drop column  sforce_lead_id;

alter table customer_grid_flat
    drop column  sforce_sync_status;

alter table magento_sales_invoice_grid_archive
    drop column  salesforce_id;

alter table magento_sales_order_grid_archive
    drop column  order_id_salesforce;

alter table magento_sales_order_grid_archive
    drop column  opportunity_id_salesforce;

alter table magento_sales_order_grid_archive
    drop column  sforce_sync_status;

alter table magento_sales_order_grid_archive
    drop column  sforce_detail_status;

alter table magento_sales_shipment_grid_archive
    drop column  salesforce_id;

alter table quote
    drop column  need_resync;

alter table sales_invoice_grid
    drop column  salesforce_id;

alter table sales_order_grid
    drop column  order_id_salesforce;

alter table sales_order_grid
    drop column  opportunity_id_salesforce;

alter table sales_order_grid
    drop column  sforce_sync_status;

alter table sales_order_grid
    drop column  sforce_detail_status;

alter table sales_shipment_grid
    drop column  salesforce_id;

drop table if exists salesforce_objects;

alter table store_website
    drop column  salesforce_id;

alter table store_website
    drop column  default_pricebook;

drop table if exists tnw_salesforce_cron_work;

drop table if exists tnw_salesforce_entity_prequeue;

drop table if exists tnw_salesforce_entity_queue_relation;

drop table if exists tnw_salesforce_entity_queue;

drop table if exists tnw_salesforce_field_mappings;

drop table if exists tnw_salesforce_log;

drop table if exists tnw_salesforce_mapper;

drop table if exists tnw_salesforce_objects;

drop table if exists tnw_salesforce_queue;




DELETE FROM `core_config_data` WHERE path LIKE 'tnw_%' OR path LIKE 'tnwsforce%';
DELETE FROM `eav_attribute_group` WHERE attribute_group_code = 'Salesforce';
DELETE FROM `eav_attribute` WHERE attribute_code = 'sforce_account_id';
DELETE FROM `eav_attribute` WHERE attribute_code = 'sforce_disable_sync';
DELETE FROM `eav_attribute` WHERE attribute_code = 'sforce_id';
DELETE FROM `eav_attribute` WHERE attribute_code = 'sforce_lead_id';
DELETE FROM `eav_attribute` WHERE attribute_code = 'sforce_pricebook_id';
DELETE FROM `eav_attribute` WHERE attribute_code = 'sforce_sync_status';
DELETE FROM `patch_list` WHERE patch_name LIKE 'TNW\\\\%';
DELETE FROM `setup_module` WHERE module LIKE 'TNW_%';

Your actual database may doesn’t have some changes described in these queries and you should use the -f flag for the mysql coomand to ignore unnecessary changes.

Example: save these queries to the cleanup.sql file and run queries with -f flag for the magentodb database:

Code Block
mysql -umysqladmin -ppassword magentodb -f < cleanup.sql

Remove our module codebase and run the db:upgrade and setup:di:compile commands.

Related articles

https://packagist.org/packages/tnw/soap-client