How akutishevsky/salesforce-migrator works
Salesforce Migrator is a VS Code extension for moving Salesforce metadata and records between authorized orgs. The user selects source and target orgs, then follows either the metadata path (browse and select components, retrieve/deploy) or the records path (choose objects and fields, export or perform DML). The extension views orchestrate services, Salesforce CLI commands, and REST/Bulk API clients. The README documents capabilities such as folder-based metadata, SOQL, progress, cancellation, and job monitoring; several of these details are not visible in the sampled excerpts, so only documented or indexed relationships are shown.
Main entry points: RecordsMigrationExport.ts Record Export · RecordsMigrationDml.ts Record DML · HtmlService.ts Webview HTML · extension.ts Extension Entry
Components 17
Extension and Orgs
- Extension Entry
src/extension.ts - Org Selector
src/views/OrgSelectorView.ts - Org Service
src/services/OrgService.ts
Metadata Migration
- Metadata Browser
src/views/MetadataSelectorView.ts - Selected Metadata
src/views/MetadataSelectionView.ts - Metadata Catalog
src/services/MetadataService.ts - Deployment Webview
src/webviews/MetadataDeploymentWebview.ts
Records Migration
- Object Selector
src/views/RecordsSelectorView.ts - Object Catalog
src/services/ObjectService.ts - Record Export
src/webviews/RecordsMigrationExport.ts - Record DML
src/webviews/RecordsMigrationDml.ts
Services and APIs
- Webview HTML
src/services/HtmlService.ts - Salesforce CLI
src/services/SfCommandService.ts - Salesforce REST
src/api/SfRestApi.ts - Bulk API 2.0
src/api/SfBulkApi.ts
Other components
- VS Code User
- Salesforce Org
Connections 33
- VS Code User → Extension Entry: activates extension
src/extension.ts - Extension Entry → Org Selector: registers views
src/extension.ts - Extension Entry → Metadata Browser: registers views
src/extension.ts - Extension Entry → Selected Metadata: registers views
src/extension.ts - Extension Entry → Object Selector: registers views
src/extension.ts - Org Selector → Org Service: fetches orgs
src/views/OrgSelectorView.ts - Org Service → Salesforce CLI: runs CLI
src/services/OrgService.ts - Metadata Browser → Metadata Catalog: lists metadata
src/views/MetadataSelectorView.ts - Metadata Browser → Selected Metadata: updates selection
src/views/MetadataSelectorView.ts - Metadata Browser → Deployment Webview: opens deployment
src/views/MetadataSelectorView.ts - Metadata Catalog → Salesforce CLI: runs CLI
src/services/MetadataService.ts - Deployment Webview → Metadata Catalog: uses metadata service
src/webviews/MetadataDeploymentWebview.ts - Deployment Webview → Org Service: gets org details
src/webviews/MetadataDeploymentWebview.ts - Object Selector → Object Catalog: lists objects
src/views/RecordsSelectorView.ts - Object Catalog → Salesforce CLI: runs CLI
src/services/ObjectService.ts - Object Selector → Record Export: opens export
src/views/RecordsSelectorView.ts - Object Selector → Record DML: opens DML
src/views/RecordsSelectorView.ts - Record Export → Record DML: opens with file
src/webviews/RecordsMigrationExport.ts - Record Export → Bulk API 2.0: runs bulk query
src/webviews/RecordsMigrationExport.ts - Record Export → Salesforce REST: uses REST API
src/webviews/RecordsMigrationExport.ts - Record Export → Org Service: gets org details
src/webviews/RecordsMigrationExport.ts - Record DML → Bulk API 2.0: runs bulk DML
src/webviews/RecordsMigrationDml.ts - Record DML → Salesforce REST: describes objects
src/webviews/RecordsMigrationDml.ts - Record DML → Org Service: gets org details
src/webviews/RecordsMigrationDml.ts - Org Selector → Webview HTML: composes view
src/views/OrgSelectorView.ts - Metadata Browser → Webview HTML: composes view
src/views/MetadataSelectorView.ts - Deployment Webview → Webview HTML: composes view
src/webviews/MetadataDeploymentWebview.ts - Object Selector → Webview HTML: composes view
src/views/RecordsSelectorView.ts - Record Export → Webview HTML: composes view
src/webviews/RecordsMigrationExport.ts - Record DML → Webview HTML: composes view
src/webviews/RecordsMigrationDml.ts - Salesforce CLI → Salesforce Org: invokes Salesforce CLI
src/services/SfCommandService.ts - Salesforce REST → Salesforce Org: sends REST requests
src/api/SfRestApi.ts - Bulk API 2.0 → Salesforce Org: sends bulk requests
src/api/SfBulkApi.ts