migrate-dataset

Migrate NetSuite SuiteAnalytics Datasets between accounts via SuiteCloud Developer Framework.

6|6|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Orderful/orderful-netsuite-skills --skill migrate-dataset
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-dataset
Source: https://github.com/Orderful/orderful-netsuite-skills/tree/main/skills/migrate-dataset
Command: npx skills add https://github.com/Orderful/orderful-netsuite-skills --skill migrate-dataset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill migrates a SuiteAnalytics Dataset from one NetSuite account to another using SDF, including the workbook-required validation workaround and customer filter adjustments needed for the dataset to return data in production.

Core Features & Use Cases

  • SDF bootstrap & interactive auth setup for moving datasets between sandbox and production with expect-driven OAuth prompts.
  • Dataset + translation collection import to preserve the column-label translation dependencies required by the dataset.
  • Workbook-required deploy strategy using a placeholder workbook imported from the source account, then safely sed-swap references to avoid brittle hand-authored workbook XML.
  • Customer-ID filter swap to prevent silent “zero rows” failures in production when datasets include per-customer entity filters.
  • Post-deploy REST registration to create and link the dataset to SuiteApp using customrecord_orderful_pkg_data_src for correct 856 generation.
  • Operational guardrails that help you recover from misleading “file upload error” deploy failures and verify what actually landed.

Quick Start

Tell me to migrate the dataset from sandbox to prod by SDF and register it for customer <target-customer-id>.

Frequently Asked Questions about migrate-dataset

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a NetSuite SuiteAnalytics Dataset from sandbox to production?

Migrating a NetSuite SuiteAnalytics Dataset between accounts requires using the SuiteCloud Developer Framework to import the dataset and translation dependencies, deploy a placeholder workbook, swap customer-ID filters, and register the dataset via REST API.

Why does my NetSuite dataset return zero rows after promoting it to production?

A NetSuite dataset returns zero rows in production when per-customer entity filters are not updated. You must perform a customer-ID filter swap during the SDF deployment to prevent silent data filtering failures.

How does the SuiteCloud Developer Framework handle workbook validation during dataset migration?

The SuiteCloud Developer Framework handles workbook validation by deploying a placeholder workbook imported from the source account, then safely sed-swapping dataset references to avoid brittle hand-authored workbook XML errors.

Do I need to preserve translation collections when migrating a NetSuite dataset?

Yes, you need to preserve translation collections when migrating a NetSuite dataset. Importing the dataset and translation collection together ensures the required column-label translation dependencies remain intact in the target account.

How do I register a migrated dataset for Orderful packaging data sources in NetSuite?

To register a migrated dataset for Orderful packaging data sources in NetSuite, perform a post-deploy REST step that creates and links the dataset to the SuiteApp using the customrecord_orderful_pkg_data_src record for correct 856 generation.

What causes misleading file upload errors during NetSuite SDF dataset deployment?

Misleading file upload errors during NetSuite SDF dataset deployment can occur due to workbook reference issues. Operational guardrails help you recover from these failures and verify what actually landed in the target account.