Loading

Procédure de configuration lors de l'utilisation de Data Loader en mode par lot

Date de publication: Feb 27, 2025
Description
Cette section décrit la procédure d'exécution de Data Loader en mode par lot, à l'aide de l'insertion par exemple.
Résolution
Tout d'abord, générez une clé de cryptage à utiliser pour le fichier de configuration. 
 
Générer une clé de cryptage à partir de l'invite de commande Windows (pour Data Loader version 42 ou antérieure)

1. Accédez au répertoire d'installation de Data Loader. 

[cd C:\Program Files (x86)\salesforce.com\Data Loader\bin] 

2. Générez une clé de cryptage à l'aide de n'importe quelle chaîne. Remplacez <texte descriptif> par n'importe quelle chaîne dans la commande. 

[encrypt.bat -g <texte descriptif>] 

3. Copiez la partie *************** dans la console de sortie dans un fichier texte et enregistrez-la sous « key.txt ». Cette clé est utilisée pour chiffrer le mot de passe dans une étape ultérieure. 

[security.EncryptionUtil main (EncryptionUtil.java:304) - ***************] 

Générez une clé de cryptage à partir de l'invite de commande Windows (pour Data Load version 43 ou 44)

1. Accédez au répertoire d'installation de Data Loader. 

[cd C:\Program Files (x86)\salesforce.com\Data Loader\bin] 

2. Générez une clé de cryptage. Remplacez <chemin vers le fichier key> dans la commande par n'importe quel répertoire et un nom de fichier (avec l'extension de fichier .key). Si <chemin vers le fichier key> n'est pas spécifié, un fichier de clé de cryptage est généré en tant que « C:\Utilisateurs\<nom_utilisateur_Windows>\.dataloader\dataLoader.key ».

[encrypt.bat -k<chemin vers le fichier key> ] 

3. Vérifiez qu'une clé de cryptage est générée. Ce fichier est utilisé pour chiffrer le mot de passe dans une étape ultérieure. 

Par exemple : [Le fichier clé « C:\Utilisateurs\<nom_utilisateur_Windows>\.dataloader\dataLoader.key » a été créé !] 

 

Générer une clé de cryptage à partir de l'invite de commande Windows (pour Data Loader version 45 ou ultérieure)

1. Accédez au répertoire d'installation de Data Loader. 

[C:\Utilisateurs\<nom_utilisateur_Windows>\dataloader\<version_Dataloader>\bin]

2. Générez une clé de cryptage. Remplacez <chemin vers le fichier key> dans la commande par n'importe quel répertoire et un nom de fichier (avec l'extension de fichier .key). Si <chemin vers le fichier key> n'est pas spécifié, un fichier de clé de cryptage est généré en tant que « C:\Utilisateurs\<nom_utilisateur_Windows>\.dataloader\dataLoader.key ».

[encrypt.bat -k<chemin vers le fichier key> ] 

3. Vérifiez qu'une clé de cryptage est générée. Ce fichier est utilisé pour chiffrer le mot de passe dans une étape ultérieure. 

Par exemple : [Le fichier key « C:\Utilisateurs\<nom_utilisateur_Windows>\.dataloader\dataLoader.key » a été créé !] 

 
Ensuite, créez un mot de passe de cryptage. 

Créer un mot de passe de cryptage pour le nom d'utilisateur de connexion (pour Data Loader version 42 ou antérieure)

À l'aide de la clé de cryptage, convertissez le mot de passe Data Loader en un mot de passe de cryptage. Remplacez <mot de passe> par le mot de passe que Data Loader utilise pour se connecter à Salesforce, et <chemin de fichier> par le répertoire où est stocké le fichier « key.txt ». Exécutez la commande dans l'invite de commande. 

[encrypt.bat -e <mot de passe> "<chemin du fichier> \key.txt"] 

 

Créez un mot de passe de cryptage pour le nom d'utilisateur de connexion (pour Data Loader version 43 ou ultérieure)

À l'aide du fichier de clé de cryptage, convertissez le mot de passe Data Loader en un mot de passe de cryptage. Remplacez <mot de passe> par le mot de passe que Data Loader utilise pour se connecter à Salesforce, et <chemin de fichier> par le répertoire où est stocké le fichier « .key ». Exécutez la commande dans l'invite de commande. 

Par exemple : [encrypt.bat -e <mot de passe> "C:\Utilisateurs\<Windows Username> \.dataloader\dataloader.key"] 

 
## Remarque 1 ## 
Le mot de passe de cryptage est utilisé comme mot de passe de connexion pour Salesforce dans le fichier de configuration. De plus, un cryptage est utilisé pour protéger le mot de passe dans le fichier de configuration. 
 
## Remarque 2 ## 
Généralement, le mot de passe pour se connecter à Data Loader est différent du mot de passe pour se connecter à Salesforce et un jeton de sécurité est requis. Pour obtenir un jeton de sécurité, reportez-vous à l'article ci-dessous : 
 
 
Ensuite, créez un fichier de mappage pour le fichier d'entrée et le fichier de sortie. 
 
Créer un fichier de mappage de champs pour le fichier d'entrée et l'élément d'objet Salesforce 
1. Créez un fichier de mappage de champs et indiquez l'extension de fichier .sdl. 
2. Créez un fichier de mappage de champs selon la syntaxe ci-dessous. 
 
La section suivante montre un exemple de configuration. 
 
<Exemple de mappage pour les colonnes d'insertion de données> 
----- 
SLA__C=SLA__c 
BILLINGCITY=BillingCity 
----- 
 
## Remarque ## 
Comme cet exemple concerne une insertion de données, la colonne de gauche est configurée pour la source de données et la colonne de droite pour le champ de destination (Salesforce) 
Pour en savoir plus sur chaque élément, reportez-vous à l'article ci-dessous : 
 
 
 
 
Ensuite, créez un fichier de configuration Data Loader. 
 
Créer un fichier de configuration pour que Data Loader traite les données 
 
1. Depuis le répertoire d'installation de Data Loader [\samples\conf], copiez le fichier [process-conf.xml]. 
2. modifiez le fichier [process-conf.xml] avec les informations de chaque fichier requis pour vos informations de connexion, votre configuration et vos processus. 
 
<Exemple de configuration> 
----- 
<entry key="sfdc.endpoint" value="https://login.salesforce.com"/> 
<entry key="sfdc.username" value="hogehoge@test"/> 
<entry key="sfdc.password" value="******encryption key*****"/> 
<entry key="process.encryptionKeyFile" value="key.txt"/> //(Pour Data Loader version 42 et antérieure)
<entry key="process.encryptionKeyFile" value="C:\Users\<nom_utilisateur_Windows>\.dataloader\dataLoader.key"/> //(Pour Data Loader version 43)
<entry key="process.mappingFile" value="test.sdl"/> 
<entry key="dataAccess.name" value="test_data.csv"/> 
<entry key="sfdc.debugMessages" value="true"/> 
<entry key="sfdc.debugMessagesFile" value="testMap.sdl"/> 
<entry key="process.outputSuccess" value="C:\test\success.csv"/> 
<entry key="process.outputError" value="C:\test\error.csv"/> 
<entry key="dataAccess.type" value="databaseWrite"/> 
 
----- 
 
  • sfdc.endpoint : URL Salesforce de l'organisation (https://login.salesforce.com, par exemple)
  • sfdc.username : nom d'utilisateur que Data Loader utilise pour se connecter 
  • sfdc.password : valeur du mot de passe de cryptage 
  • process.encryptionKeyFile : clé de cryptage ou fichier de clé de cryptage utilisé(e) pour créer le mot de passe de cryptage
  • process.mappingFile : chemin et nom de fichier du fichier de mappage de champs 
  • dataAccess.Name : chemin et nom du fichier de données contenant les comptes à importer 
  • sfdc.debugMessages : élément de dépannage. Spécifiez [true/false] si nécessaire 
  • sfdc.debugMessagesFile : chemin et nom de fichier du fichier pour stocker les messages SOAP 
  • process.outputSuccess : chemin et nom de fichier du fichier journal de réussite 
  • process.outputError : chemin et nom de fichier du fichier journal d'erreur 
  • dataAccess.type : entrez le type de fichier et le type d'entrée/sortie [ex. : csvRead, databaseWrite] du fichier journal de la ligne de commande 
 
 
Pour en savoir plus sur chaque élément, reportez-vous aux articles ci-dessous : 
 
 
 
 
Enfin, exécutez le processus dans la ligne de commande. 
 
Exécuter le processus dans la ligne de commande et traiter les données 
Exécutez le processus dans la ligne de commande. 
Remplacez <chemin du fichier process-conf.xml> par le chemin de répertoire contenant process-conf.xml, et <process name> par le processus spécifié dans process-conf.xml.
 
[process.bat "<chemin du fichier process-conf.xml>" <nom du processus>] 
 
* [Le processus spécifié dans process-conf.xml] fait référence au processus des beans, qui correspond à la partie "" dans [bean id="*****"]. 
 
Une fois les étapes ci-dessus terminées, Data Loader peut être utilisé dans la ligne de commande, au lieu de l'interface utilisateur graphique.
 
Ressources disponibles : 
 
 
 
Numéro d’article de la base de connaissances

000386154

 
Chargement
Salesforce Help | Article