Registry / data / sfdx-migration-automatic

sfdx-migration-automatic

library4.2.3jsnpmunverified

sfdx-migration-automatic is an SFDX plugin for Salesforce data migration, enabling dump/load of record data to/from CSV files between orgs. Current version 4.2.3, released under Apache-2.0 license. It provides three commands: `automig:dump` (export records to CSV), `automig:load` (import records from CSV), and `automig:package` (create package for managed migration). Works with Salesforce DX plugin-based architecture, using the `sfdx` CLI. Key differentiators: focus on CSV-based data migration with id mapping and configurable scope. Maintained by stomita, compatible with Node >=8.0.0.

data

npm install sfdx-migration-automatic

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SFDX-MIGRATION-AUT

sfdx-migration-automatic

datajavascriptv4.2.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

plugin

✓ sfdx plugins:install sfdx-migration-automatic

✗ npm install sfdx-migration-automatic (not a library, must be installed as SFDX plugin)

This is not a JS importable package, it provides CLI commands when installed as a sfdx plugin.

Shows how to install the plugin and run dump/load commands to migrate Salesforce data via CSV.

# Install plugin sfdx plugins:install sfdx-migration-automatic # Set target org (default dev hub) sfdx config:set defaultdevhubusername=myOrg@example.com # Dump Account and Contact records to csv/ sfdx automig:dump -o Account,Contact -d csv/ # Load data from csv/ into another org sfdx automig:load -d csv/ -u targetOrg@example.com # Or use a config file sfdx automig:dump -f config/dump-config.json

Debug

Known issues

gotchaPlugin must be installed as a Salesforce DX plugin, not as a regular npm package. Using require() or import will not work.

fix

Run sfdx plugins:install sfdx-migration-automatic.

affects: >=0.0.0

gotchaCommands are executed via sfdx CLI, not through JavaScript. This is not a programmable library.

fix

Use sfdx automig:dump/load from terminal or CI scripts.

affects: >=0.0.0

deprecatedSFDX CLI is being replaced by Salesforce CLI (sf). This plugin may not be compatible with 'sf' commands.

fix

Check if plugin works with 'sf' commands or use the new Salesforce CLI plugin system.

affects: >=4.0.0

gotchaNode version requirement is >=8.0.0; older Node versions may cause errors.

fix

Use Node >= 10.0.0 for optimal compatibility.

affects: >=4.2.3

gotchaData migration commands do not automatically handle parent-child relationships; use idmap for reference fields.

fix

Use the --idmap option to generate and reuse ID maps.

affects: >=0.0.0

gotchaThe plugin uses API version from sfdx-project.json; inconsistent API versions may cause incompatible field names.

fix

Set --apiversion to match source and target orgs.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module '@salesforce/core'

SFDX plugin not fully installed; missing dependencies.

fix

Run sfdx plugins:install sfdx-migration-automatic to install plugin and its dependencies.

Error: This command requires a default org or target username

No Salesforce org configured.

fix

Set a default org: sfdx config:set defaultusername=myOrg@example.com or use -u flag.

Error: No such command "automig:dump"

Plugin not installed or command name misspelled.

fix

Run sfdx plugins:install sfdx-migration-automatic and check available commands with sfdx help automig.

Error: getaddrinfo ENOTFOUND login.salesforce.com

Network issue or Salesforce API unreachable.

fix

Check internet connection and firewall settings; ensure DNS resolves login.salesforce.com.

Upgrade

Version history

4.2.3latest on npm

Audit

Dependencies

@salesforce/corerequiredCore Salesforce DX library for authentication, config, logging

@salesforce/commandrequiredBase class for SFDX commands

csv-parserequiredCSV parsing for load command

csv-stringifyrequiredCSV generation for dump command

Agent activity

24 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/stomita/sfdx-migration-automatic ↗

packagesfdx-migration-automatic ↗

homepagehttps://github.com/stomita/sfdx-migration-automatic ↗