How-to: Migration of Pack & Ship

Pack & Ship moves from being a separate extension to being part of the main Mobile WMS solution.

"ShipIT 365 Connector" and "LogTrade Connector" by Tasklet are discontinued and replaced by new extensions delivered directly from Idyn and LogTrade

Please contact Tasklet Service Desk if you have any questions.

Migration Steps

About This Guide

• You risk losing data. It is very important to follow this guide in detail to ensure data migration
• Do you have customizations for 'ShipIT 365 Connector by Tasklet" or "LogTrade Connector by Tasklet", then you need another process. Please contact Tasklet Service desk

The following data will be migrated:

• "Pack & Ship"
• "ShipIT 365 Connector by Tasklet" or "LogTrade Connector by Tasklet" (If Used)
• Customizations with table extensions for "Pack & Ship"
  
  

Step 1 "Update Mobile WMS"

Publish and Install "Mobile WMS" 5.41 or later (with Pack & Ship as a feature)

Step 2 "Prepare your customization" (If used)

(This step will require assistance from a Business Central developer)

If you have any customizations dependent on Pack & Ship, you need to update your code.

All existing objects from Pack & Ship have been renamed from MOS ObjectName to MOB ObjectName when moved into Mobile WMS.

1. Replace dependency from Pack & Ship to Mobile WMS in the app.json file in your custom project
2. Update dependency on Mobile WMS to version 5.41.0.0
3. Search and replace 'MOS' with 'MOB' in your customized code to reference the renamed object and events now located in Mobile WMS
   1. Make sure to use these settings when using the replace function in VS Code
      1. 'Match Case'
      2. 'Match whole word'
4. Verify the result,
5. Update your version number and re-compile your customization
   
   Example of the recommended use of the Replace function in VS Code: 
   
   

Step 3 "Request Migration tool"

Contact the Tasklet Service desk and get the Pack & Ship Migration tool

• We will complete this Checklist to ensure that you are ready
• You will receive a direct download link to Pack & Ship Migration tool

After downloading, you must Publish and Install the Pack & Ship Migration tool.

Step 4 "Run Pack & Ship Data Backup"

You must do this for each company that is using Mobile WMS.

Open the page 'Mobile WMS Setup' and manually run 'Pack & Ship Data Backup' 

This will migrate the Pack & Ship data and backup any table extension data from customizations and Connectors.

The migration tool will automatically create and use an internal Field mapping tool to handle the from-field and to-field mapping.

You can verify the data has been backed up by looking at the page  "Mobile Pack & Ship Migration Data" found on Mobile WMS Setup → Pack & Ship Migration Tool → Intermediate Table

More details are available on this page Pack & Ship Migration Tool

Step 5 "Update connector extension" (If Used)

• This step is only required if you are using one of the two connectors provided by Tasklet: 'ShipIt 365 Connector' or 'Logtrade Connector'
• Important - this must be done before running step 7 "Pack & Ship Data Restore"

Two new connectors will be available through our partners Idyn and LogTrade, either from AppSource or direct download from their partner websites.

• ShipIT365 Connector by Idyn (Expected released in September 2023)

• LogTrade Connector by LogTrade (Released June 19. 2023)

When you have identified the new connector, relevant for your solution you must publish and Install the new version of the Connector.

Step 6 "Update customization" (If used)

• This step is only required if you have any customization for Pack & Ship
• Important - this must be done before running step 7 "Pack & Ship Data Restore"

If you have any customizations on Pack & Ship you must publish and Install the new version you prepared in Step 2

It´s important to use the option 'Schema Sync = Force' when publishing the new extension.

This is because your old customization could contain table extensions based on the old Pack & Ship tables.

They are no longer available and should now be created as table extensions based on the new Pack & Ship tables within Mobile WMS.

Example: 

Step 7 "Run Pack & Ship Data Restore"

Open the page 'Mobile WMS Setup' and manually run 'Pack & Ship Data Restore' 

You must do this for each company that is using Mobile WMS. More details available on Pack & Ship Migration tool

Please verify that your data is migrated as expected.

• This will restore any table extension data from customizations and Connectors using the setup provided in Migration Step 1
• Pack & Ship as a feature is automatically enabled
• All active users in Business Central and mobile devices must log out and back in to start using the new features
  
• 

Step 8 "Uninstall Pack & Ship"

• Failing to remove the old extensions will disrupt Pack & Ship features on mobile device

The old separate Pack & Ship extension is no longer required.

Uninstall and unpublish all the dependent extensions in this sequence:

1. "Mobile WMS - Pack & Ship - Migration Tool (PTE)"
2. Customization extension (if used)
3. Connector extension (if used)
4. "Mobile WMS - Pack & Ship"

Step 9 "Complete"

The migration process is complete, and the new Pack & Ship feature in Mobile WMS is enabled and ready to use.