Loading

Konfigurationsverfahren beim Verwenden von Data Loader im Batch-Modus

Veröffentlichungsdatum: Feb 27, 2025
Beschreibung
In diesem Abschnitt wird das Verfahren zum Ausführen von Data Loader im Batch-Modus mithilfe von "Einfügen" als Beispiel beschrieben.
Lösung
Generieren Sie zuerst einen Verschlüsselungsschlüssel, der für die Konfigurationsdatei verwendet wird. 
 
Generieren eines Verschlüsselungsschlüssels über die Windows-Eingabeaufforderung (für Data Loader-Version 42 oder früher)

1. Wechseln Sie zum Data Loader-Installationsverzeichnis. 

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

2. Generieren Sie einen Verschlüsselungsschlüssel mit einer beliebigen Zeichenfolge. Ersetzen Sie <Seed-Text> im Befehl durch eine beliebige Zeichenfolge. 

[encrypt.bat -g <Seed-Text>] 

3. Kopieren Sie den Teil mit *************** in der Ausgabekonsole in eine Textdatei und speichern Sie sie unter "key.txt". Dieser Schlüssel wird in einem späteren Schritt zum Verschlüsseln des Kennworts verwendet. 

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

Generieren eines Verschlüsselungsschlüssels über die Windows-Eingabeaufforderung (für Data Loader-Version 43,44)

1. Wechseln Sie zum Data Loader-Installationsverzeichnis. 

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

2. Generieren Sie einen Verschlüsselungsschlüssel. Ersetzen Sie <Pfad zur Schlüsseldatei> im Befehl durch ein beliebiges Verzeichnis und einen Dateinamen (mit der Dateierweiterung ".key"). Wenn <Pfad zur Schlüsseldatei> nicht angegeben ist, wird eine Verschlüsselungsschlüsseldatei als "C:\Users\<Windows-Benutzername>\.dataloader\dataLoader.key" generiert.

[encrypt.bat -k <Pfad zur Schlüsseldatei>] 

3. Überprüfen Sie, ob ein Verschlüsselungsschlüssel generiert wurde. Diese Datei wird in einem späteren Schritt zum Verschlüsseln des Kennworts verwendet. 

Beispiel: [Keyfile "C:\Users\<Windows-Benutzername>\.dataloader\dataLoader.key" was created!] 

 

Generieren eines Verschlüsselungsschlüssels über die Windows-Eingabeaufforderung (für Data Loader-Version 45 oder höher)

1. Wechseln Sie zum Data Loader-Installationsverzeichnis. 

[C:\Users\<Windows-Benutzername>\dataloader\<Dataloader-Version>\bin]

2. Generieren Sie einen Verschlüsselungsschlüssel. Ersetzen Sie <Pfad zur Schlüsseldatei> im Befehl durch ein beliebiges Verzeichnis und einen Dateinamen (mit der Dateierweiterung ".key"). Wenn <Pfad zur Schlüsseldatei> nicht angegeben ist, wird eine Verschlüsselungsschlüsseldatei als "C:\Users\<Windows-Benutzername>\.dataloader\dataLoader.key" generiert.

[encrypt.bat -k <Pfad zur Schlüsseldatei>] 

3. Überprüfen Sie, ob ein Verschlüsselungsschlüssel generiert wurde. Diese Datei wird in einem späteren Schritt zum Verschlüsseln des Kennworts verwendet. 

Beispiel: [Keyfile "C:\Users\<Windows-Benutzername>\.dataloader\dataLoader.key" was created!] 

 
Erstellen Sie dann ein Verschlüsselungskennwort. 

Erstellen eines Verschlüsselungskennworts für den Benutzernamen für die Anmeldung (für Data Loader-Version 42 oder früher)

Konvertieren Sie das Data Loader-Kennwort mithilfe des Verschlüsselungsschlüssels in ein Verschlüsselungskennwort. Ersetzen Sie <Kennwort> durch das Kennwort, das Data Loader zum Anmelden bei Salesforce verwendet, und <Dateipfad> durch das Verzeichnis, unter dem die Datei "key.txt" gespeichert ist. Führen Sie den Befehl in der Eingabeaufforderung aus. 

[encrypt.bat -e <Kennwort> "<Dateipfad>\key.txt"] 

 

Erstellen eines Verschlüsselungskennworts für den Benutzernamen für die Anmeldung (für Data Loader-Version 43 oder höher)

Konvertieren Sie das Data Loader-Kennwort mithilfe der Verschlüsselungsschlüsseldatei in ein Verschlüsselungskennwort. Ersetzen Sie <Kennwort> durch das Kennwort, das Data Loader zum Anmelden bei Salesforce verwendet, und <Dateipfad> durch das Verzeichnis, unter dem die Datei ".key" gespeichert ist. Führen Sie den Befehl in der Eingabeaufforderung aus. 

Beispiel: [encrypt.bat -e <Kennwort> "C:\Users\<Windows-Benutzername>\.dataloader\dataLoader.key"] 

 
## Hinweis 1 ## 
Das Verschlüsselungskennwort wird als Anmeldekennwort für Salesforce in der Konfigurationsdatei verwendet. Außerdem wird die Verschlüsselung verwendet, um das Kennwort in der Konfigurationsdatei zu schützen. 
 
## Hinweis 2 ## 
In der Regel unterscheidet sich das Kennwort zum Anmelden bei Data Loader vom Kennwort zum Anmelden bei Salesforce und ein Sicherheitstoken ist erforderlich. Informationen zum Abrufen eines Sicherheitstokens finden Sie im folgenden Artikel: 
 
 
Erstellen Sie als Nächstes eine Zuordnungsdatei für die Eingabedatei und die Ausgabedatei. 
 
Erstellen einer Feldzuordnungsdatei für die Eingabedatei und das Salesforce-Objektelement 
1. Erstellen Sie eine neue Feldzuordnungsdatei und geben Sie als Dateierweiterung ".sdl" an. 
2. Erstellen Sie eine Feldzuordnungsdatei entsprechend der folgenden Syntax. 
 
Im folgenden Abschnitt ist ein Konfigurationsbeispiel dargestellt. 
 
<Zuordnungsbeispiel für Spalten zum Einfügen von Daten> 
----- 
SLA__C=SLA__c 
BILLINGCITY=BillingCity 
----- 
 
## Hinweis ## 
Da es sich hierbei um ein Beispiel für eine Dateneinfügung handelt, wird die Spalte auf der linken Seite als Datenquelle und die Spalte auf der rechten Seite als Zielfeld (Salesforce) konfiguriert 
Details zu den einzelnen Elementen finden Sie im folgenden Artikel: 
 
 
 
 
Erstellen Sie als Nächstes eine Data Loader-Konfigurationsdatei. 
 
Erstellen einer Konfigurationsdatei für Data Loader zum Verarbeiten von Daten 
 
1. Kopieren Sie im Data Loader-Installationsverzeichnis [\samples\conf] die Datei [process-conf.xml]. 
2. Bearbeiten Sie die Datei [process-conf.xml] mit Informationen zu jeder Datei, die für Ihre Anmeldeinformationen, Konfiguration und Prozesse erforderlich sind. 
 
<Konfigurationsbeispiel> 
----- 
<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"/> //(Für Dataloader-Version 42 und früher)
<entry key="process.encryptionKeyFile" value="C:\Users\<Windows-Benutzername>\.dataloader\dataLoader.key"/> //(Für Dataloader-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: Der Salesforce-URL der Organisation (z. B. https://login.salesforce.com).
  • sfdc.username: Der Benutzername, den Data Loader zum Anmelden verwendet. 
  • sfdc.password: Der Wert des Verschlüsselungskennworts. 
  • process.encryptionKeyFile: Der Verschlüsselungsschlüssel oder die Verschlüsselungsschlüsseldatei, der bzw. die zum Erstellen des Verschlüsselungskennworts verwendet wird.
  • process.mappingFile: Der Pfad und der Dateiname der Feldzuordnungsdatei. 
  • dataAccess.Name: Der Pfad und der Dateiname der Datendatei, die die zu importierenden Accounts enthält. 
  • sfdc.debugMessages: Das Element für die Fehlerbehebung. Geben Sie [true/false] entsprechend an. 
  • sfdc.debugMessagesFile: Der Pfad und der Dateiname der Datei, in der SOAP-Meldungen gespeichert werden. 
  • process.outputSuccess: Der Pfad und der Dateiname der Erfolgsprotokolldatei. 
  • process.outputError: Der Pfad und der Dateiname der Fehlerprotokolldatei. 
  • dataAccess.type: Geben Sie den Dateityp und den Eingabe-/Ausgabetyp [z. B. csvRead, databaseWrite] der Protokolldatei für die Befehlszeile ein. 
 
 
Details zu den einzelnen Elementen finden Sie in den folgenden Artikeln: 
 
 
 
 
Führen Sie den Prozess abschließend in der Befehlszeile aus. 
 
Ausführen des Prozesses in der Befehlszeile und Verarbeiten der Daten 
Führen Sie den Prozess in der Befehlszeile aus. 
Ersetzen Sie <Dateipfad zu process-conf.xml> durch den Verzeichnispfad mit der Datei "process-conf.xml" und <Prozessname> durch den in "process-conf.xml" angegebenen Prozess.
 
[process.bat "<Dateipfad zu process-conf.xml>" <Prozessname>] 
 
* [The process specified in process-conf.xml] bezieht sich auf den Beans-Prozess, bei dem es sich um den Teil zwischen "" in [bean id="*****"] handelt. 
 
Sobald die oben genannten Schritte abgeschlossen sind, kann Data Loader anstelle der grafischen Benutzeroberfläche über die Befehlszeile verwendet werden.
 
Verfügbare Ressourcen: 
 
 
 
Nummer des Knowledge-Artikels

000386154

 
Laden
Salesforce Help | Article