Versions Compared

Key

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

Why migrate from unstructured to structured address format?

...

Steps to migrate addresses structure:

  1. ???? Make sure the companies import from your financial system to Workbench supports (has been updated) to import the import of company addresses in the new format. (What about SUN or any other flat file based exports?)Note that SUN company import is a custom procedure for each client and it will need to be updated as each client finds the need to migrate to this new address.

    1. Financial Systems supported:

      1. Xero API

      2. MYOB AccountRight API

      3. MYOB Advanced API

      4. SAP B1 API

      5. Business Central

  2. Change control parameter 'BETA FEATURE - Structured Addresses' to Yes.

  3. If you want to have an idea of the before and after and how thenew the new address structure looks like, you can test one company: make a change on the company on your financial system and revert it; then import into Workbench.???? All companies need to be bulk updated in the financial system so they come through to Workbench and update the new address fields.

  4. On your financial integration screen in Workbench, back date the last updated date, save and import companiesleave only Companies ticked and save. Then perform the import so all Company addresses are updated with the new format.
    Below is an example of the Xero integration screen, and how only Companies are selected to be imported and Last Update was backdated to way back in the past to ensure all companies come accross.
    Once the import is finished, you can tick all documents again, and save.

  5. After switching to the new address structure:

    1. the Jobs that have addreses from these companies will have the Job Site address fields empty.

    2. Purchase Orders will still have the Delivery address name selected but the new fields will be empty.

      1. !!!! Old POs will lose the delivery address data.

        Image RemovedImage Removed

        The old text box with the address will be displayed. However, if the PO is unaproved, as soon as the PO is on edit mode only the new address fields will display and the Address Title will need to be re-selected in order to populate the address fields.

        Image Added


    3. Service Logs will still have the Address name selected but the new address fields will be empty.

      1. !!!!old Service logs will lose original site addresses.

        Image Removed
    There is a utility
      1. The old text box with the address will be displayed. However, if the Log is Re-opened & Unfinalised, as soon as the Log is on edit mode only the new address fields will display and the Address Title will need to be re-selected in order to populate the address fields.

        Image Added


  6. Run the utility wbUtilityInitialiseStructuredJobAddresses to populate the new address fields on Job’s Site address.

    1. Re-initialise Addresses = Yes: If the structured fields are set already on a job then when set to yes this will overwrite them.

    2. Re-initialise Addresses = No: If the structured fields are set already on a job then when set to no theese these fields will not be overwritten with the data from the selected Address Name.



...