Microsoft Dynamics 应用程序作用域

UiPath.MicrosoftDynamics.Activities.MicrosoftDynamicsScopeActivity

Dynamics 365 活动使用 OAuth 和 Common Data Service 协议在 UiPath 和 Dynamics 365 应用程序之间建立经过身份验证的连接。 此连接授权机器人代表您调用 Web API 并访问资源。

要启用身份验证，请使用 Azure Active Directory (AAD) 在帐户租户中注册 Dynamics 365 应用程序。 注册应用程序会生成一个 应用程序（客户端）ID ，该 ID 与其他标识符一起用于建立对实例的身份验证访问。 有关更多信息，在构建第一个自动化项目之前，请参阅 设置 指南。

完成应用程序注册后，选择要使用的身份验证类型 (AuthenticationType)，并输入应用程序（客户端）ID (ClientId)、Dynamics 365 应用程序端点 (EndpointUrl)、目录（租户）ID (TenantId)，以及根据您选择的身份验证类型，您的客户端密码 (ClientSecret)。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成 设置 步骤。

2. 如果“ 身份验证 类型”为 “客户端凭据”，请添加活动，否则为“不适用”。

   • 有关更多信息，请参阅本指南中的 凭据管理 。
3. 将“ Microsoft Dynamics 应用程序作用域 ”活动添加到您的项目中。
4. 输入“ 连接 ”输入属性的值。
5. 创建并输入MicrosoftDynamicsConnection变量作为“输出” 属性。

   • 您可以在后续使用 Microsoft Dynamics 应用程序作用域 活动时使用此变量。

     
     

     

     
     

在活动正文中

要构建项目并在其他活动中启用“ 对象向导 ”，您必须通过单击“ 配置 ”按钮来使用“连接向导”。

要了解有关 连接向导的更多信息，请参阅“ 业务活动框架 ”页面。

注意： 在 连接向导 中配置字段不会填充 Microsoft Dynamics 应用程序作用域 属性。 该向导仅在设计时建立与 Microsoft Dynamics 365 应用程序的连接；在其他 Microsoft Dynamics 365 活动中启用 对象向导 。

属性

常见

• “显示名称”- 活动的显示名称。此字段仅支持 Strings 和 String 变量。

连接

• “身份验证 类型” - 要用于连接到 Dynamics 365 应用程序的身份验证类型。 从下拉列表中选择一个项目。 有两个选项：

  • “密码凭据 ” - 如果选中，则通过用户提示（根据您在“ 提示 ” 属性中选择的选项）输入其 Dynamics 365 帐户的密码来完成身份验证。 此选项仅适用于有人值守的自动化。
  • ClientCredentials - 如果选中，则通过 ClientSecret完成身份验证。 此选项适用于有人值守和无人值守的自动化。 有关客户端凭据的更多信息，请参阅 Microsoft 文档中的 使用客户端密码和证书 。
• “客户 端 ID” - 分配给已注册应用程序的自动生成的应用程序（客户端） ID。 此字段仅支持 String 变量。
  • 当您使用 Azure Active Directory (AAD) 注册应用程序时，系统会生成 客户端 ID 。 有关更多信息，请参阅设置指南的“ 注册应用程序 ”部分。
  • 如果“ 身份验证 类型”值为“客户端 凭据”，则 客户端 ID 与客户端密码相关 联。 由于这种关系，建议您按照设置指南的 “ 创建凭据资产 ”部分为此属性创建 String 变量。
  • 要为此属性创建并输入 String 变量，请使用活动输出凭据资产（请参阅下面的 示例 ）。
• “客户端密码” - 您的ServiceNow 实例的密码（与“ 用户名” 关联）。 输入 SecureString 变量。
  • 使用 Azure Active Directory ( AAD ) 注册应用程序时，可以生成客户端密码。 有关更多信息，请参阅设置指南的 创建客户端密码 部分。
  • 要创建 SecureString 变量，请参阅设置指南的 创建凭据资产 部分。
  • 要输入 SecureString 变量，请使用输出凭据资产的活动（请参阅下面的 示例 ）。
• EndpointUrl - 要连接到的 CRM 实例的 URL。 此字段仅支持 Strings 或 String 变量。

• “提示 ” - 指定密码凭据身份验证的 密码 提示行为。 从下拉列表中选择一个项目。 共有三个选项：

  • “自动 ” - 仅在需要凭据时显示提示。
  • “选择帐户 ” - 提示要求用户选择一个帐户，然后输入其凭据（在有多个帐户时使用）。
  • “始终” - 每次运行活动时都会显示提示（即使缓存中有令牌）。
• “租户 ID” - 分配给 Azure Active Directory (ADD) 租户的目录（租户）ID。 此字段仅支持 Strings 或 String 变量。

现有连接

• “现有 Microsoft Dynamics 连接” - 来自父 Microsoft Dynamics 应用程序作用域 活动的连接记录，您可以使用它来代替建立新连接。 输入 MicrosoftDynamicsConnection 变量。
  • MicrosoftDynamicsConnection 变量必须来自先前运行的 Microsoft Dynamics 应用程序作用域 活动（父级），该活动仍具有活动连接。
  • 如果无法使用此属性建立连接，请尝试重新运行父级 Microsoft Dynamics 应用程序作用域 活动。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• “ReportApiErrorAsException” - 选中后，使用此应用程序作用域的所有子活动都会在 BusinessActivityExecutionException 中报告 API 错误响应。 清除后，子活动将在“响应状态”输出属性中填充 API 错误消息，并继续执行工作流。 检查 ResponseStatus 属性以确认成功执行。

输出

• Microsoft Dynamics 连接 - 已建立连接的记录，可在此作用域活动中包含的其他 Microsoft Dynamics 应用程序作用域 活动中使用。 输入 MicrosoftDynamicsConnection 变量。 您可以将此变量传递给父作用域活动内的工作流中的作用域活动。
  • 例如，您可能有 3 个工作流。 第一个包括与已注册应用程序建立连接的父作用域活动（即父工作流）。 第二个工作流创建一个新的联系人记录，第三个工作流创建一个新的客户记录；两者都包含在父作用域活动中。
  • 工作流运行时，父作用域活动会将MicrosoftDynamicsConnection 变量传递给第二个和第三个工作流中的 ExistingMicrosoftDynamicsConnection 属性（请参见下图）。
    
    

    

    
    

示例

下图显示了活动依赖关系和输入/输出属性值的示例。