Salesforce 数据加载器技术文档

2024-12-20 19:25:39作者：何将鹤

1. 安装指南

系统要求

Java 运行环境 (JRE)：安装和运行数据加载器需要 JRE。请查阅最新版本的安装说明以获取所需的 JRE 版本。

支持的操作系统

数据加载器官方支持 Windows 和 macOS。其他所有操作系统均不受支持。具体支持的 macOS 和 Windows 版本以及 CPU 架构请参见对应版本的发行说明。

安装步骤

Windows 和 macOS： 请按照以下链接中的说明进行安装：
- macOS 安装指南
- Windows 安装指南
Linux：
1. 解压数据加载器 zip 文件
2. 将 install.command 重命名为 install.sh
3. 在终端中运行以下命令：./install.sh

2. 项目使用说明

运行 GUI 模式

Windows 和 macOS： 请按照文档中的说明运行数据加载器。
Linux： 在命令行中输入以下命令：
```
./dataloader.sh
```
或者
```
java -jar dataloader-x.y.z.jar
```

运行批处理模式

Windows： 请参考Windows 批处理模式中的说明。

Linux： 执行以下命令：

./dataloader_console <配置文件夹包含 process-conf.xml 和 config.properties 文件> <进程名称> run.mode=batch

或者

java -jar dataloader-x.y.z.jar <配置文件夹包含 process-conf.xml 和 config.properties 文件> <进程名称> run.mode=batch

3. 项目 API 使用文档

本项目提供的命令行工具用于创建加密密钥文件、加密密码或解密密码。

创建加密密钥文件

执行以下命令以在 macOS 或 Linux 上生成加密密钥文件：

./dataloader_console -k [<加密密钥文件>] run.mode=encrypt

或者

java -jar dataloader-x.y.z.jar -k [<加密密钥文件>] run.mode=encrypt

加密密码

执行以下命令以在 macOS 或 Linux 上加密密码：

./dataloader_console -e <明文密码> [<加密密钥文件>] run.mode=encrypt

或者

java -jar dataloader-x.y.z.jar -e <明文密码> [<加密密钥文件>] run.mode=encrypt

解密密码

执行以下命令以在 macOS 或 Linux 上解密密码：

./dataloader_console -d <加密密码> [<加密密钥文件>] run.mode=encrypt

或者

java -jar dataloader-x.y.z.jar -d <加密密码> [<加密密钥文件>] run.mode=encrypt

4. 项目安装方式

通过以下方式之一安装数据加载器：

通过 Git：

git clone git@github.com:forcedotcom/dataloader.git
cd dataloader
git submodule init
git submodule update
mvn clean package -DskipTests

或者

./dlbuilder.sh

完成后，会在本地 Git 克隆的根目录下生成 dataloader_v<x.y.z>.zip 文件。

通过 IDE 远程调试： 在 Git 克隆的根目录下运行以下命令：

./rundl.sh -d

或者

java -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005 -cp target/dataloader-x.y.z.jar com.salesforce.dataloader.process.DataLoaderRunner salesforce.config.dir=./configs

登录后查看全文