Skip to main content

Release 3.3.0

Overview & Summary

ZoneExtract 3.3.0 was released on 7th September 2026 and brings significant improvements to scalability, observability, and administration across NetSuite environments. Key highlights in this release include:

  • Real-time Observability: Introduction of the new ZoneExtract Requests Monitor UI, delivering end-to-end visibility into queued, running, and historical exports.

  • Higher Data Throughput: Expanded pagination limits that enable extraction of much larger datasets without splitting saved searches.

  • Simplified Configuration Migration: Seamless export/import of both Export Definitions and linked Connectors between sandbox and production accounts.

  • Automated Setup & Permissions: Automatic Export ID synchronization and expanded ZoneExtract Admin role permissions for smoother out-of-the-box operations.

  • Enhanced System Reliability: Robust error handling preventing SearchTask abort loops, payload overflow crashes, and legacy schema upgrade issues.

Enhancements (5)

  • ZoneExtract Requests Monitor: Introduced a dedicated Requests Monitor UI and transitioned to a queue-based execution model. This provides administrators with real-time visibility into active and upcoming runs, granular execution history per connector, bulk-management capabilities, and safe error-log tracking. (ZR-2532)

  • Increased Pagination Limit: Expanded pagination limits to allow significantly larger record sets to be exported without requiring administrators to split data across multiple saved searches. (ZR-2143)

  • Configuration Export/Import with Connectors: Extended the Export Configuration utility to include linked Connectors alongside Export Definitions, streamlining configuration migration between NetSuite environments. (ZR-2558)

  • Automatic Export ID Population: Automated the population and synchronization of the Export ID on Export Definition records with the underlying Saved Search or Dataset, ensuring consistent file naming and eliminating manual identifier setup. (ZR-2615)

  • ZoneExtract Admin Role Permissions: Updated the standard ZoneExtract Admin role definition with missing permissions—including ZoneReporting configurations and transaction searches—to ensure users with this role can execute all background tasks and SuiteApp features without encountering permission violations. (ZR-2583)

Maintenance/Bug Fixes (4)

  • SearchTask Abort Loop: Resolved an issue where stale, failed, or expired backend NetSuite SearchTask IDs caused subsequent scheduled export runs to abort repeatedly, ensuring failed task IDs are properly cleared so future scheduled runs execute normally. (ZR-2969)

  • Oversized Log Payloads (EXCEEDED_MAX_FIELD_LENGTH): Handled character limit overflows on Export Request status fields during heavy logging or deep error stack events, preventing runtime crashes and ensuring tasks transition gracefully to a failed state. (ZR-2586)

  • Legacy Migration Schema Safeguards: Added dynamic schema checks to migration scripts to ensure accounts upgrading from legacy bundles missing the Source Type field migrate smoothly without throwing SSS_INVALID_SRCH_COL script errors. (ZR-2617)

  • Import Name Fallback: Added a fallback mechanism for record names during configuration imports to prevent import errors when definitions or connectors are missing name values. (ZR-2623)

Frequently Asked Questions (FAQ)

1. What is the new Requests Monitor and where do I find it?

The ZoneExtract Requests Monitor is a centralized dashboard within NetSuite that provides visibility into current queue activity, execution progress, recent completions, and detailed logs for failed requests. You can access it directly under the ZoneExtract > Requests Monitor menu.

2. Do I need to manually update permissions for our ZoneExtract Admins?

If your users are assigned the standard ZoneExtract Admin role provided by the SuiteApp bundle/bundle update, the new permissions (such as transaction search access and ZoneReporting configurations) will update automatically. If you use a customized version of the Admin role, review the updated standard role permissions and replicate the newly added permissions to your custom role.

3. How does the increased pagination limit impact existing export configurations?

No changes are required to your existing Export Definitions. Larger searches and datasets will automatically benefit from the increased page capacity, reducing the need to maintain partitioned searches or staggered export schedules.

4. How does the Configuration Export/Import handle credentials for Connectors?

When exporting configurations across environments (e.g., Sandbox to Production), connector settings, URLs, and mapping structures are migrated. However, for security compliance, sensitive authentication credentials or tokens must be re-entered and validated directly in the target environment.

5. Will existing scheduled exports be affected during the upgrade?

No. The upgrade introduces automated cleanup for stale SearchTask records, ensuring queued and scheduled exports continue without manual intervention or lock-ups.


 

Was this article helpful?