为编码自动化中的服务创建连接

本节帮助您创建从使用连接（例如编码自动化中的 GSuite.Activities 和 Excel.Activities）的服务访问 API 时所需的连接。

首先在 Integration Service 中创建一个连接。可以在编码自动化项目的同一组织和租户内访问这些连接。在编码自动化中，使用 connections 对象访问先前在 Integration Service 中创建的连接，然后访问相应的 API。

完成自动化并将其发布到 Orchestrator 后，如果需要，可以覆盖在代码中设置的原始连接配置。

先决条件

在 Integration Service 中创建连接：

1. 转到“Integration Service”，然后选择 Studio 连接的租户。
2. 导航到“连接”。
3. 选择“添加连接”，然后为以下应用程序之一创建连接：
   • Google 云端硬盘
   • Gmail
   • Google 表格
   • Microsoft Office 365

步骤

1. 从最初创建连接的同一组织和租户中打开现有编码自动化。
2. 在 Execute() 正文中，输入 connections，然后按 Ctrl + Space 以查看可用连接。
   根据先前创建 connection 的应用程序，您可以从以下连接类型中进行选择：

   • Google 云端硬盘
   • Gmail
   • Google 表格
   • Excel
   • OneDrive
   • O365 邮件
3. 通过添加 Orchestrator 文件夹和子文件夹名称以及所需的特定连接地址，进一步配置连接。使用下划线分隔此信息。
   例如，Orchestrator 中 My Workspace 文件夹和 My Gmail Worskapce 子文件夹与 [e-mail] 地址的 Gmail 连接应在代码中编写为：connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com。

   建议

   我们建议您一步创建连接，以避免潜在错误。 我们还建议您为连接创建一个变量。 这样，如果 Integration Service 中发生更改，您将避免在整个自动化过程中更新连接的每个实例。 使用以下方法：

   var myGmailConnection = connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

   避免在两个单独的步骤中创建连接，例如：

   var myGmailConnection = connections.Gmail;
   myGmailConnection.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

4. 建立connection后，您可以通过该connection访问特定于服务的相关 API。
   例如，如果您按如下方式设置了 Gmail 连接： var myGmailConnection = connections.Gmail.My_Workspace_john_doe_gmail.com ，则可以通过myGmailConnection使用该服务的 API。

覆盖 Orchestrator 中的连接

1. 将项目发布到 Orchestrator。
2. 转到已发布项目的 Orchestrator 订阅源。
3. 转到已发布的流程，然后选择 “编辑”。
4. 在“流程配置”中，选择包含已配置连接的编码自动化作为入口点。
5. 在“包要求” 中，找到并选择编码自动化的相应连接类型。

   请务必谨慎选择编码自动化的连接类型，因为列表中也会显示项目中 XAML 文件的连接。

6. 连接运行时，识别并选择您计划与该连接相关联的帐户地址。

已知限制

仅当导入的项目与原始库项目位于同一租户中时，导出的库的默认连接才适用于其他项目。