使用Salesforce CLI连接Salesforce on Alibaba Cloud CRM环境

更新时间:
复制为 MD 格式

描述:

Salesforce CLI 是一个强大的命令行界面工具,具体内容请参考文档:https://developer.salesforce.com/tools/salesforcecli

通常,Salesforce国际版可以直接使用Salesforce CLI工具。Salesforce on Alibaba Cloud CRM由于环境差异,需要使用OAuth的方式将Salesforce CLI连接到您的组织(Org),为确保流程的顺畅和安全,请参照本文档进行操作指引。

步骤:

  1. 此链接下载并安装Salesforce CLI。关于Salesforce CLI配置的更多详细信息,请参阅此链接

    1. 选择合适的版本安装Salesforce CLI;

    2. 安装完成后,重启命令提示符(Command Prompt)或终端(Terminal)以确保sfdx可执行文件可用;

    3. 运行sfdx以确保安装成功。

      image

  2. 在您的环境中创建新的外部客户端应用程序管理器(External Client App Manager)

    1. 登录到您的组织(Org);

    2. 在设置(Setup)中,使用快速查找框(Quick Find)输入“外部客户端应用程序管理器(External Client App Manager)”,然后选择“外部客户端应用程序管理器(External Client App Manager)”;

    3. 在右上角,点击“新建外部客户端应用程序(New External Client App)”创建新的应用程序;

    4. 填写基本信息,如名称和您的电子邮件地址。

      image

  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))。

        image

    3. 关闭“对于支持的授权流,需要适用于代码交换 (PKCE) 扩展的证明密钥(Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows)”。

      image

    4. 点击保存(Save)。

  4. 在选项卡“设置(Settings)”下的“Oauth 设置(Oauth Settings)”中“使用者密钥和密码(Consumer Key and Secret)”,复制使用者密钥(Consumer Key)和使用者密码(Consumer Secret)。

    image

  5. 使用以下命令来测试Salesforce连接。 sf org login web -d -r <您的域名URL> -i <使用者密钥>。

    image

    注意,对于“sf org open”,Mac需要设置这两个环境变量:

    export SF_DISABLE_DNS_CHECK=true

    export SF_DOMAIN_RETRY=0

    Windows系统上为:

    SF_DISABLE_DNS_CHECK=true

    SF_DOMAIN_RETRY=0

  6. 输入使用者密码(Consumer Secret)并按回车键,CLI将打开一个新的浏览器窗口以登录到您的组织,请输入您的用户名和密码。

  7. 在下一页点击“允许(Allow)”,

  8. 输入以下命令来检查组织是否已经连接:

    sf org list

    Salesforce CLI已经成功地连接到您的组织。

    补充说明:

    Visual Studio Code应用,请从这个链接下载。

    Visual Studio Code的Salesforce扩展,请参考这个链接