Upgrading from Magento 1
Our Magento 2 extensions retain the same database layout for most aspects of the extension easing migration from Magento 1 and Magento 2. Information that carries over automatically
- settings
- export status to Xero
- invoice linking information between Magento and Xero
We generally advise to have the Magento 2 extension installed already during the migration. We suggest the following process to ensure no interruption:
- Order and install our Magento 2 extension
- Make sure that all orders have been exported to Xero from your Magento 1 site
- Run Migration - see below for additions to the Magento Data Migration Tool
while we believe the export status is migrated over we suggest setting the export start date on the Magento 2 site to the day of the migration
Magento Data Migration Tool - Fooman Connect Additions
To migrate the extension data please add the following to your migration.
In your class-map.xml file add
<classmap xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="urn:magento:module:Magento_DataMigrationTool:etc/class-map.xsd"> <!-- Fooman Connect: Xero --> <rename> <from>foomanconnect/system_salesProductAccountOptions</from> <to>Fooman\Connect\Model\System\SalesProductAccountOptions</to> </rename>
In your settings.xml add
<settings xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="urn:magento:module:Magento_DataMigrationTool:etc/settings.xsd"> ... <value> <transform> <path>foomanconnectxero/connect/apikey</path> <handler class="\Migration\Handler\Encrypt" /> </transform> <transform> <path>foomanconnectxero/connect/apisecret</path> <handler class="\Migration\Handler\Encrypt" /> </transform>
In your map.xml file add
<map xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="urn:magento:module:Magento_DataMigrationTool:etc/map.xsd"> <source> <document_rules> <!-- Fooman Connect: Xero --> <ignore> <field>foomanconnect_creditmemo.xero_last_validation_errors</field> </ignore> <ignore> <field>foomanconnect_invoice.xero_last_validation_errors</field> </ignore> <ignore> <field>foomanconnect_order.xero_last_validation_errors</field> </ignore> <ignore> <field>foomanconnect_item.xero_last_validation_errors</field> </ignore> <!-- End Fooman Connect: Xero --> ... </document_rules> <field_rules> <!-- Fooman Connect: Xero --> <ignore> <field>sales_flat_quote_item.xero_rate</field> </ignore> <ignore> <field>sales_flat_order.xero_rate</field> </ignore> <ignore> <field>sales_flat_order_item.xero_rate</field> </ignore> <ignore> <field>tax_calculation_rate.xero_rate</field> </ignore> <!-- End Fooman Connect: Xero -->
After migration has completed please set up the mapping of the tax rates as that information would not have migrated. Please see these here: https://magento2-support.fooman.co.nz/article/1301-4-map-tax-rates