文档

使用Data Loader连接Salesforce on Alibaba Cloud CRM环境

更新时间:
一键部署

描述:

Data Loader是一个客户端应用程序,用于大量导入或导出数据。使用它可以对Salesforce记录进行插入、更新、删除或导出操作。
具体内容请参考文档:https://developer.salesforce.com/tools/data-loader

在Salesforce on Alibaba Cloud CRM环境中使用Data Loader进行数据操作时,您可以选择以下两种认证方式:

  1. OAuth
  2. 密码认证(Password Authentication)

需要特别说明的是,密码认证方式可以直接应用于Salesforce on Alibaba Cloud CRM环境中。
若您选择通过OAuth进行认证,为确保流程的顺畅和安全,请参照本文档进行操作指引。


步骤:

  1. 按照此链接中的补助下载并安装Data Loader。如有需要,请安装Azul Zulu OpenJDK(Azul Platform Core),具体内容请参照此篇文章
    1. 登录环境后,点击屏幕右上方的齿轮图标,选择“设置”(Setup);
    2. 在快速查找(Quick Find)中输入“Data Loader”,从搜索结果中点击“Data Loader”;
    3. 点击“下载”(Downloads),您将会被重定向到外部网站;
    4. 选择Windows或MacOS版本,并点击最新版本进行下载。
  2. 在您的环境中创建新的连接的应用程序(Connected App)。
    1. 登录到您的组织(org);
    2. 在设置(Setup)中,使用快速查找框(Quick Find)输入“应用程序管理器(App Manager)”,然后选择“应用程序管理器(App Manager)”;
    3. 在右上角,点击“新建连接的应用程序(New Connected App)”创建新的连接的应用程序(Connected App);
    4. 填写基本信息,如名称和您的电子邮件地址。
  3. 勾选“启用OAuth设置(Enable OAuth Settings)”。
    1. 对于回调URL(Callback URL),请输入“http://localhost:1717/OauthRedirect”。如果端口1717(默认端口)在您本地计算机上已被占用,请指定一个可用的端口。请确保sfdxproject.json文件中oauthLocalPort属性为新端口。例如,如果您将回调URL(Callback URL)设置为“http://localhost:1919/OauthRedirect”,则sfdxproject.json文件中:"oauthLocalPort" : "1919"。

    2. 选择选定的OAuth范围(Selected OAuth Scopes):
      1. 通过API管理用户数据(api)(Manage user data via APIs (api));
      2. 通过Web浏览器管理用户数据(web)(Manage user data via Web browsers (web));
      3. 随时执行请求(refresh_token, offline_access)(Perform requests at any time (refresh_token, offline_access))。
    3. 关闭“对于支持的授权流,需要适用于代码交换 (PKCE) 扩展的证明密钥(Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows)”。

    4. 点击保存(Save)。
  4. 在下一页点击“API(启用 OAuth 设置)”下的“管理客户详情信息(Manage Consumer Details)”,复制使用者密钥(Consumer Key)和使用者密码(Consumer Secret)。

  5. 使用Data Loader之前,首先测试连接的应用程序(Connected App),检查下面的URL是否正常工作:
    https://<您的域名URL>/services/oauth2/authorize?response_type=code&client_id=<使用者密钥>&redirect_uri=https://<您的域名URL>/services/oauth2/success

    将URL复制到新浏览器中,输入户名和密码之后,结果如下图。

  6. Data Loader应用程序中,config.properties文件位于默认的配置目录中,该目录安装在以下位置:

    对于MacOS:/Users/{userName}/dataloader/version/configs

    对于Windows:C:\Users{userName}\dataloader\version\configs

    请替换其中{userName}为您的实际用户名,version为Data Loader的实际版本号。
    这里的路径指的是Data Loader配置文件的存放位置,您可以在这里找到或修改Data Loader的设置。

  7. 根据您的实际使用情况,修改下面的参数,以生产环境(Production)为例:

    sfdc.oauth.clientid=<来自连接的应用程序的使用者密钥>
    
    sfdc.endpoint=https\://<您的域名URL>
    sfdc.oauth.environment=Production
    sfdc.oauth.redirecturi=https\://<您的域名URL>/services/oauth2/success
    sfdc.oauth.server=https\://<您的域名URL>
    sfdc.oauth.Production.server=https\://<您的域名URL>
    sfdc.oauth.Production.redirecturi=https\://<您的域名URL>/services/oauth2/success
    sfdc.oauth.Production.partner.clientid=<来自连接的应用程序的使用者密钥>

    完成配置后,保存 config.properties 文件,然后重启Data Loader应用程序,新的配置就会被应用。

     

  8. 点击执行Data Loader,点击“Export”按钮,在界面上勾选“OAuth”,选择“Production”,然后点击“Log in”按钮。


  9. 点击“Allow” 和 "Continue"按钮。


  10. 切换回Data Loader界面,点击“Next”,然后选择对象和字段,导出数据。

  • 本页导读
文档反馈