使用Data Loader连接Salesforce on Alibaba Cloud CRM环境
描述:
Data Loader是一个客户端应用程序,用于大量导入或导出数据。使用它可以对Salesforce记录进行插入、更新、删除或导出操作。
具体内容请参考文档:https://developer.salesforce.com/tools/data-loader。
在Salesforce on Alibaba Cloud CRM环境中使用Data Loader进行数据操作时,您可以选择以下两种认证方式:
- OAuth
- 密码认证(Password Authentication)
需要特别说明的是,密码认证方式可以直接应用于Salesforce on Alibaba Cloud CRM环境中。
若您选择通过OAuth进行认证,为确保流程的顺畅和安全,请参照本文档进行操作指引。
步骤:
- 按照此链接中的补助下载并安装Data Loader。如有需要,请安装Azul Zulu OpenJDK(Azul Platform Core),具体内容请参照此篇文章。
- 登录环境后,点击屏幕右上方的齿轮图标,选择“设置”(Setup);
- 在快速查找(Quick Find)中输入“Data Loader”,从搜索结果中点击“Data Loader”;
- 点击“下载”(Downloads),您将会被重定向到外部网站;
- 选择Windows或MacOS版本,并点击最新版本进行下载。
- 在您的环境中创建新的连接的应用程序(Connected App)。
- 登录到您的组织(org);
- 在设置(Setup)中,使用快速查找框(Quick Find)输入“应用程序管理器(App Manager)”,然后选择“应用程序管理器(App Manager)”;
- 在右上角,点击“新建连接的应用程序(New Connected App)”创建新的连接的应用程序(Connected App);
- 填写基本信息,如名称和您的电子邮件地址。
- 勾选“启用OAuth设置(Enable OAuth Settings)”。
-
对于回调URL(Callback URL),请输入“http://localhost:1717/OauthRedirect”。如果端口1717(默认端口)在您本地计算机上已被占用,请指定一个可用的端口。请确保sfdxproject.json文件中oauthLocalPort属性为新端口。例如,如果您将回调URL(Callback URL)设置为“http://localhost:1919/OauthRedirect”,则sfdxproject.json文件中:"oauthLocalPort" : "1919"。
- 选择选定的OAuth范围(Selected OAuth Scopes):
- 通过API管理用户数据(api)(Manage user data via APIs (api));
- 通过Web浏览器管理用户数据(web)(Manage user data via Web browsers (web));
- 随时执行请求(refresh_token, offline_access)(Perform requests at any time (refresh_token, offline_access))。
-
关闭“对于支持的授权流,需要适用于代码交换 (PKCE) 扩展的证明密钥(Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows)”。
- 点击保存(Save)。
-
- 在下一页点击“API(启用 OAuth 设置)”下的“管理客户详情信息(Manage Consumer Details)”,复制使用者密钥(Consumer Key)和使用者密码(Consumer Secret)。
-
使用Data Loader之前,首先测试连接的应用程序(Connected App),检查下面的URL是否正常工作:
https://<您的域名URL>/services/oauth2/authorize?response_type=code&client_id=<使用者密钥>&redirect_uri=https://<您的域名URL>/services/oauth2/success将URL复制到新浏览器中,输入户名和密码之后,结果如下图。
-
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的设置。 -
根据您的实际使用情况,修改下面的参数,以生产环境(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应用程序,新的配置就会被应用。
- 点击执行Data Loader,点击“Export”按钮,在界面上勾选“OAuth”,选择“Production”,然后点击“Log in”按钮。
- 点击“Allow” 和 "Continue"按钮。
-
切换回Data Loader界面,点击“Next”,然后选择对象和字段,导出数据。
- 本页导读