Microsoft Dynamics 应用程序作用域

UiPath.MicrosoftDynamics.Activities.MicrosoftDynamicsScopeActivity

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

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

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

工作方式

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

完成设置步骤。
如果“ 身份验证 类型”为 “客户端凭据”，请添加活动，否则为“不适用”。
- 有关更多信息，请参阅本指南中的凭据管理。
将“ Microsoft Dynamics 应用程序作用域 ”活动添加到您的项目中。
输入“ 连接 ”输入属性的值。
创建并输入MicrosoftDynamicsConnection变量作为“输出” 属性。
- 您可以在后续使用 Microsoft Dynamics 应用程序作用域 活动时使用此变量。

在活动正文中

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

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

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

属性

常见

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

连接

“身份验证 类型” - 要用于连接到 Dynamics 365 应用程序的身份验证类型。从下拉列表中选择一个项目。有两个选项：
- “密码凭据 ” - 如果选中，则通过用户提示（根据您在“ 提示 ” 属性中选择的选项）输入其 Dynamics 365 帐户的密码来完成身份验证。此选项仅适用于有人值守的自动化。
- 客户端凭据- 如果选中，则通过客户端密码完成身份验证。此选项适用于有人值守自动化和无人值守自动化。有关客户端凭据的更多信息，请参阅 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 属性（请参见下图）。