Skip to main content

Getting Started

Installation​

The Australia/New Zealand Accelerator is available on Microsoft AppSource and is available for a free trial.

Subscription​

You must activate at least a trial subscription to use the app. You do not have to enter payment details to start a trial. This link shows you how to activate the app.

You must add payment details before your trial expires. This link shows you how to update your subscription.

You can find out about the pricing of the extension here.

Permissions​

The app includes three permission sets, which are detailed below.

Permission SetPurpose
BASIC_ACC_TSL - Accelerator - Basic (All)You must assign this permission set to all users to prevent permission errors even when not using a specific feature. The permission setup only provides the most basic permissions to set up tables and other tables the system uses. Users can print outbound documents with this permission set, provided they have the base app permissions required to access the underlying data.
USER_ACC_TSL - Accelerator - UserYou must assign this permission set to users that generate EFT Transfers.
SUPER_ACC_TSL - Accelerator - Super (Admin)You must assign this permission set to users responsible for configuration. It provides full access to all tables for the app.
note

The app only includes permissions for the features added by the app. Therefore, you must also assign users the relevant base app permissions.

Upgrade instructions​

Migrating from the Per-Tenant version​

We have provided a migration tool to migrate your data from the per-tenant version to the AppSource version of the app. This tool is only available to Theta consultants.

Prerequisites​

  • Australia/New Zealand Accelerator (PTE) - version 24.0.15.0 or greater.
  • Migrate PTE AU/NZ Accelerator to AppSource - version 24.0.0.0 or greater.
  • Refactor any custom extensions dependent on the Australia/New Zealand Accelerator (PTE). In most cases, the refactoring will be straightforward as we have maintained feature parity between the two editions of this app.

Process - Business Central​

caution
  1. Please ensure you run through this process in a sandbox environment and perform the necessary testing before proceeding to do this in production.
  2. It is important to follow these instructions in sequence and that you do not uninstall the Australia/New Zealand Accelerator (PTE) before you install the AppSource version.
  1. Upgrade to the latest Australia/New Zealand Accelerator (PTE) version.
  2. Install the Australia/New Zealand Accelerator from AppSource.
  3. Install the Migrate PTE AU/NZ Accelerator to AppSource app. The data migration happens during the installation process and runs for all companies.
  4. Open the Data Migration Summary to perform a high-level check of the data migration. You can check this in all companies. Navigation

Navigation

  1. Uninstall the Migrate PTE AU/NZ Accelerator to AppSource app. Do not unpublish the app yet.
  2. Uninstall the Australia/New Zealand Accelerator (PTE) app. Do not unpublish the app yet. This will also uninstall any custom extensions dependent on the Australia/New Zealand Accelerator (PTE)** (if applicable).
  3. If applicable, install custom extensions dependent on the Australia/New Zealand Accelerator.
  4. Perform smoke testing to ensure the extension works as expected.
Important

If you have configured Azure Blob Storage, you will need to re-enter the secrets in the Australia/New Zealand Accelerator app.

Rollback​

The process described has a fail-safe, as we have not deleted the data from the PTE at this point. If you encounter any issues, you can follow these steps to revert to the PTE version:

  1. Reinstall the Australia/New Zealand Accelerator (PTE) app and any dependent apps.
  2. Reinstall the Migrate PTE AU/NZ Accelerator to AppSource app.
  3. Open the the Data Migration Summary and select the Revert Permissions Back to PTE action.
  4. Uninstall and unpublish the Migrate PTE AU/NZ Accelerator to AppSource app.
  5. Uninstall the Australia/New Zealand Accelerator AppSource app.

Final Steps​

caution

After carrying out the steps below, you cannot revert to the Per-Tenant version of the app. Only commence with these steps once you are confident that the migration has been successful.

As a final step, once you have validated the migration outcome, you can remove all the data related to the Australia/New Zealand Accelerator (PTE) app. To do this:

  1. Reinstall the Australia/New Zealand Accelerator (PTE) app.
  2. Reinstall the Migrate PTE AU/NZ Accelerator to AppSource app.
  3. Uninstall and unpublish the Migrate PTE AU/NZ Accelerator to AppSource app.
  4. Uninstall the Australia/New Zealand Accelerator (PTE) app and specify to Delete Extension Data.
  5. Unpublish the Australia/New Zealand Accelerator (PTE) app.

See Also​

tip