SFDX Data Migrator

Plugin Salesforce DX pour la migration intelligente de données entre environnements Salesforce avec gestion automatique des dépendances.

À propos

SFDX Data Migrator est un plugin pour Salesforce CLI qui vous permet de migrer des enregistrements Salesforce spécifiques entre différents environnements (orgs), tout en préservant automatiquement leurs relations et dépendances. Contrairement aux outils de migration standard, ce plugin analyse récursivement toutes les dépendances d'un enregistrement et les migre dans l'ordre approprié.

Auteur : Samir CHIBOUT
Version : 1.0.0

Fonctionnalités clés

• Migration intelligente : Identification et extraction automatique d'un enregistrement et de toutes ses dépendances
• Analyse récursive : Détection des relations parent-enfant et recherche approfondie des dépendances
• Mode simulation : Prévisualisation des opérations sans modifier les données
• Mode exécution : Migration complète avec préservation des relations
• Simple à utiliser : Une seule commande avec des paramètres intuitifs

Prérequis

• Salesforce CLI installé
• Node.js (v14.0.0 ou ultérieur)
• Authentification préalable aux orgs Salesforce source et cible

Installation

# Installation via NPM
npm install -g sfdx-data-migrator

# Ou directement depuis GitHub
sfdx plugins:install https://github.com/samir-chibout/sfdx-data-migrator

Vérifiez l'installation avec :

sfdx plugins

Le plugin sfdx-data-migrator devrait apparaître dans la liste.

Utilisation

Syntaxe de base

sfdx data:migrator -u <source-org-alias> -t <target-org-alias> --recordid <salesforce-record-id> [-e]

Paramètres

| Paramètre | Alias | Description | Obligatoire | |-----------|-------|-------------|-------------| | --username | -u | Alias ou nom d'utilisateur de l'org source | Oui | | --targetusername | -t | Alias ou nom d'utilisateur de l'org cible | Oui | | --recordid | -r | ID Salesforce de l'enregistrement à migrer | Oui | | --execute | -e | Activer le mode d'exécution (sans ce flag, fonctionne en mode simulation) | Non |

Exemples

Mode simulation (par défaut) :

sfdx data:migrator -u "[email protected]" -t "[email protected]" --recordid "003J9000009SbHTIA0"

Cette commande analysera l'enregistrement et ses dépendances, puis affichera un rapport de ce qui serait migré, sans effectuer de modifications.

Mode exécution :

sfdx data:migrator -u "[email protected]" -t "[email protected]" --recordid "003J9000009SbHTIA0" -e

Cette commande effectuera la migration complète de l'enregistrement et de toutes ses dépendances.

Processus de migration

1. Validation : Vérification des connexions aux orgs source et cible
2. Identification : Détermination du type d'objet Salesforce à partir de l'ID
3. Analyse : Exploration récursive des relations et dépendances de l'enregistrement
4. Extraction : Récupération de toutes les données nécessaires de l'org source
5. Insertion : Création des enregistrements dans l'org cible, en respectant l'ordre des dépendances
6. Mapping : Maintien des relations entre les objets en utilisant les nouveaux IDs

Bonnes pratiques

• Toujours utiliser le mode simulation d'abord pour vérifier les enregistrements qui seront migrés
• Vérifier que vous disposez des permissions suffisantes dans les deux orgs
• Sauvegarder les données critiques avant d'exécuter la migration
• Préparer une stratégie de rollback en cas de problème

Limites connues

• Sensible aux règles de validation complexes dans l'org cible
• La migration de certains types d'objets spéciaux peut nécessiter une configuration supplémentaire
• Les fichiers et pièces jointes peuvent nécessiter un traitement spécial

Résolution des problèmes

Dépannage courant

1. Erreur d'authentification :

   Vérifiez vos connexions avec : sfdx force:org:display -u <org-alias>

2. Échec lors de l'analyse des dépendances :

   Essayez de limiter la profondeur de la récursion en ajoutant l'option --depth <niveau>

3. Problème d'insertion dans l'org cible :

   Vérifiez les règles de validation dans l'org cible qui pourraient bloquer l'insertion

Contribution

Les contributions sont les bienvenues ! Pour contribuer :

1. Forkez le dépôt
2. Créez une branche pour votre fonctionnalité (git checkout -b feature/ma-fonctionnalite)
3. Committez vos changements (git commit -m 'Ajout d'une nouvelle fonctionnalité')
4. Poussez vers la branche (git push origin feature/ma-fonctionnalite)
5. Ouvrez une Pull Request

Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

Contact

Pour toute question ou suggestion, veuillez contacter Samir CHIBOUT.