1. SuiteCloud Platform
  2. SuiteScript
  3. Transitioning To SuiteScript 2.1
  4. Transitioning To SuiteScript 2.1
  5. Choosing A Migration Path

Choosing A Migration Path

Use this topic to plan updates for customizations that use SuiteScript 1.0, SuiteScript 2.0, or SuiteScript 2.x patterns.

Whenever possible, convert legacy scripts to SuiteScript 2.1. SuiteScript 2.1 uses a newer JavaScript runtime and helps prepare your customizations for future NetSuite platform changes.

Prepare For Your Migration

Before you upgrade legacy scripts, complete the following preparation steps:

  1. Inventory scripts and customizations.

  2. Identify SuiteScript version and script type.

  3. Choose the update option in the following table.

  4. Convert or test in a sandbox.

  5. Review generated or converted code.

  6. Validate behavior and deployment metadata.

  7. After the scripts are approved, deploy them in your account.

Important:

Start with low-complexity scripts. This helps you become familiar with the migration process before updating more complex customizations.

Choose An Update Option

Use the following table to choose the option that matches the customization you want to update.

Note:

Automated tools and agent skills can accelerate migration, but you must review all generated code, object updates, and deployment changes before using them in production.

If you need to

Use this resource

Test current SuiteScript 2.0 server scripts in a SuiteScript 2.1 runtime before making code changes.

Enabling SuiteScript 2.1 at the Account Level

Test current SuiteScript 2.x server scripts in a SuiteScript 2.1 runtime before making code changes.

Enabling SuiteScript 2.1 at the Account Level

Automatically upgrade SuiteScript 1.0, 2.0, and 2.x scripts and custom objects to SuiteScript 2.1.

Updating Scripts Using the SuiteScript Agent Skill

Get AI-assisted help with code generation, refactoring, testing, or SDF project updates.

SuiteCloud Developer Assistant

Get guidance on manually transitioning from SuiteScript 1.0 to SuiteScript 2.1.

Transitioning from SuiteScript 1.0 to SuiteScript 2.1

Get guidance on manually transitioning from SuiteScript 2.0 to SuiteScript 2.1.

Transitioning from SuiteScript 2.0 to SuiteScript 2.1

Validate Script Changes

After you update a script, complete the following validation steps.

  1. Run the converted script in a sandbox environment.

  2. Test all entry points.

  3. Verify sublist behavior, searches, record operations, data handling, and error handling.

  4. Confirm that deployment records and SDF objects still reference the correct files.

  5. Compare behavior against the original customization.

Related Topics

General Notices