/
0. Bundle to SDF Migration Guide

0. Bundle to SDF Migration Guide

Overview

This page is intended only for customers currently using the bundle-based version of the Staria Poland Localization SuiteApp who will be transitioning to the new SDF-based version (v4.0.0) available through the NetSuite SuiteApp Marketplace.

The migration to SDF introduces a new deployment model, ensuring smoother updates, improved reliability, and long-term scalability.
To ensure a successful upgrade, please follow the preconditions and installation steps outlined below.

Required Action Before Upgrading to Version 4.0.0 (SDF)

Before upgrading to the SDF-based version, review the information below to confirm that your account meets all prerequisites and that no critical objects will be lost or overwritten during the transition.

If Your Account Is on Version 3.9.11

You’re on the correct architecture for the transition. However, do not install version 4.0.0 (SDF) immediately. Perform the steps below to prepare your environment before the actual upgrade.

If Your Account Is on Version 3.9.0 to 3.9.10

You are on a compatible structure, but you must first update to version 3.9.11 to align with the latest dependencies before proceeding with SDF migration. After updating to 3.9.11, follow the same preparation steps listed below.

If Your Account Is on a Version Older Than 3.9.0

Additional setup is required before migration. If your current version is 3.8.x or lower, complete the following first:

  1. Install the Staria Core Localization SuiteApp.
    See detailed steps here: https://staria.atlassian.net/wiki/spaces/SPLS/pages/1811120136

  2. Update the Poland Localization Bundle to version 3.9.11.
    This introduces the dependency on the Core SuiteApp required for the upcoming SDF version.

  3. Then continue with the preparation steps below.

Preparation Steps Before Installing Version 4.0.0 (SDF)

Once your account is on Poland Localization 3.9.11, perform the following in sequence:

  1. Install or update the Staria Core Localization SuiteApp to the latest version.
    This ensures all shared libraries and identifiers are in sync with the new SDF architecture.

  2. Update the Poland Localization Bundle to the latest 3.9.11 release.
    Confirm that the update is successful and no errors occurred during deployment.

    • Review custom objects for potential conflicts.
      Before installing the SDF version, carefully review whether any custom scripts, records, forms, or fields introduced by your organization may be overwritten or deleted during migration.

      • Export backups of affected objects if necessary.

      • Coordinate with your technical team to assess dependencies.

  3. Update the App ID from the Staria Core Localization SuiteApp.
    The new SDF architecture relies on App ID linkage between Core and Country SuiteApps. Ensure that your Core SuiteApp App ID is up to date before proceeding.

It is mandatory for the user to update their User Preferences before proceeding with the following steps.

  • Number of Rows in List Segments: 1,000

  • Show App ID field: True

image-20250612-091602.png

  1. Install the latest version of the Staria App ID Updater Tool (Bundle ID: 595360)

    image-20260310-162241.png

  2. Update the localization SuiteBundle you will be working with to the latest version (e.g., [STA] Poland Localisation {ID: 262737})

Carefully review the components on the Preview Bundle Update page before clicking the Update Bundle button.

image-20250612-092136.png

If there are existing components that will be duplicated, replaced, or deleted, please consult with the Product Team before proceeding with the update.

  1. Navigate to Customization > Scripting > Scripts

  2. View the [STA] AIU App ID Updater v2 (customscript_sta_aiu_v2) script

    image-20260310-162450.png

  3. Under the Deployments subtab, click the localization where the app id updater will run (e.g. [STA] AIU App ID Updater v2 (Poland) for Poland)

    image-20260310-162721.png

  4. On the Script Deployment page, click the link on the URL field to open the App Id Updater page

    image-20260310-162823.png

  5. Click the Start button to run the App ID Updater

You can switch tabs while the script is running, but do not close the page, as this will stop the process.

image-20260310-162930.png

  1. The banner will automatically update when the script is finished

    image-20260310-163035.png
    image-20260310-163505.png

Note: If you are seeing an “Offline” box on the lower right portion of the page, update the Processor Count to 2 or 1 as NetSuite could be experiencing a performance issue.

image-20260310-170136.png

  1. Proceed with the installation of the localization SuiteApp from the Marketplace

  2. Once the localization SuiteApp has been successfully installed from the Marketplace, uninstall the Staria App ID Updater Tool (Bundle ID: 595360)

Installing Version 4.0.0 (SDF)

  1. Go to Customization > SuiteApps to open the SuiteApp Marketplace.

  2. Search for Staria Poland Localization and click the result.

  3. Click Install to begin.

If the Install button is not visible, use our contact Support Portal Staria NetSuite Products Service Portal to have the SuiteApp provisioned. If you cannot. access the Portal, please contact the Staria NetSuite Products team via Teams.

  1. The button will change to Installing… once installation begins.

  2. Track progress via
    Customization > SuiteCloud Development > Installed SuiteApps.

  3. When complete, the status will display Complete.

Important: Do not uninstall the existing bundle before migrating.
Doing so will delete specific system objects and may lead to the irreversible loss of historical records and configurations.

Send an email to support@staria.com for questions or concerns regarding this topic.

©2024 Staria. All rights reserved. No part of this publication may be reproduced, distributed, or transmitted in any form or by any means, including photocopying, recording, or other electronic or mechanical methods, without the prior written permission of the publisher.