通过

HAT 自动化活动的类型

  • 项目

 

发布日期： 2016年11月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2013,Dynamics CRM 2015,Dynamics CRM 2016

您可以使用各类 托管应用程序工具包 (HAT) 自动化活动来自动化您的托管应用程序。 要查看和使用 HAT 自动化活动，请参阅 使用 HAT 自动化活动。

本主题内容

应用程序集成框架（AIF）操作活动

AIF 上下文活动

DDA 活动

应用程序集成框架（AIF）操作活动

操作活动提供了访问和管理 UII 操作 的功能。 下表描述了各类可用的操作活动。

活动

说明

DoAction

在同一应用程序或其他托管应用程序内执行操作。 此操作具有以下属性：

  • ApplicationName：执行 DoAction的应用程序。 强制。

  • ActionData：执行操作所需的数据。 可选。

  • ActionName 使用 ApplicationName 属性内指定的托管应用程序进行注册的操作名称。 强制。

GetActionData

从调用工作流程或自动化的操作中检索数据。 将返回具有ActionData 属性的值。

SetActionData

添加数据至当前操作。

指定 ActionData 参数内操作所需的数据。

RegisterActionForEvent

注册操作，以便在事件发生时启动。 此操作具有以下属性：

  • ActionApplication：用来注册 UII 操作的应用程序的名称。 强制。

  • ActionName：启动事件时执行的应用程序操作的名称。 强制。

  • ApplicationName：用来启动事件的应用程序的名称。 强制。

  • ControlName：用来启动事件的控件的名称。 可选。

  • EventName：藉由应用程序/控件启动的事件的名称。

UnRegisterActionForEvent

取消注册以前使用 RegisterActionForEvent 活动进行注册的操作。 取消注册的事件不再执行。 此操作具有以下属性：

  • ActionApplicationName: 用来注册 UII 操作的应用程序的名称。

  • ActionName：启动事件时已经执行的应用程序操作的名称。

  • ApplicationName：用来启动事件的应用程序的名称。

  • ControlName：用来启动事件的控件的名称。

  • EventName：藉由应用程序或控件启动的事件的名称。

CloseDynamicApp

从自动化内关闭某个动态托管应用程序。 您可以使用此操作以编程方式关闭 Unified Service Desk内的某个动态托管应用程序。

指定您想要关闭的 ApplicationName 参数内的动态托管应用程序的名称。

有关动态托管应用程序的更多信息，请参阅 动态 UII 托管应用程序。

StartDynamicApp

从自动化内启动某个动态托管应用程序。

指定您想要启动的 ApplicationName 参数内的动态托管应用程序的名称。

FocusApp

从自动化内对某个应用程序设置关注。

指定您想要设置灌注的 ApplicationName 参数内的动态托管应用程序的名称。

AIF 上下文活动

允许从自动化访问 AIF 上下文的上下文活动。 下表描述了各类可用的上下文活动。

活动

说明

GetContext

从上下文中检索指定密钥的值。 将返回具有 ContextValue 属性的值。

指定在 ContextKey 属性内检索的上下文密钥。

SetContext

设置上下文内指定密钥的值。 此操作具有以下属性：

  • ContextKey：将要设置的上下文密钥。

  • ContextData：亦可输入被设置为 ContextKey内指定的上下文的数据。

GetCredential

从指定应用程序的上下文检索用户凭据。 此操作具有以下属性：

  • ApplicationName：应用程序的名称。

  • UserName: 用户名。

  • Password：密码。

> [!NOTE] >

要从自定义存储区检索凭据，开发人员需要提供用以执行 ISsoLookupService 接口的类。

HostApplication

托管应用程序的 UI。 它使用指定的应用程序托管配置数据，同时配置 Unified Service Desk（位于 Microsoft Dynamics 365 服务器上）内的托管控件，以确定托管模式。 有关指定 Unified Service Desk 中应用程序的托管模式的更多信息，请参阅 创建和管理 UII 托管应用程序。

DDA 活动

数据驱动适配器 (DDA) 活动可用于存取绑定中指定的控件。 下表描述了各类 DDA 活动。

活动

说明

ControlFinder

找到托管应用程序内的控件。 操作会返回 True，如果能在 ControlFound 属性内找到控件，否则将会返回 False。 如果您要使用异常处理程序来执行依赖性活动，您可以设置 ExceptionsMask 属性。 此操作具有以下属性：

  • ApplicationName：可以托管控件的应用程序的名称。 强制。

  • ControlName：应用程序内的控件名称。

  • ExceptionsMask：指明您是否想要显示异常，如果未找到控件。 默认设置为 False。

> [!NOTE] >

如果您配置的工作流正阻止UI 线程，并且您已指定 ControlFinder 活动的 SleepInterval 和超时参数，须配置操作以异步运行。

ExecuteControlAction

执行控件的默认操作。 例如，如果控件是按钮，则默认操作是单击。 此操作具有以下属性：

  • ApplicationName：可以托管控件的应用程序的名称。

  • ControlName：应用程序内的控件名称。

GetControlValue

从应用程序中的控件内检索值。 将返回具有 ControlValue 属性的值。 此操作具有以下属性：

  • ApplicationName：可以托管控件的应用程序的名称。

  • ControlName：必须检索其值的应用程序中的控件的名称。

> [!NOTE] >

使用带多行文本控件的 GetControlValue 活动时，将会忽略所有新的行字符，并返回单一字符串。

SetControlValue

设置应用程序内控件的值。 此操作具有以下属性：

  • ApplicationName：可以托管控件的应用程序的名称。

  • ControlName：必须设置其值的应用程序中的控件的名称。

  • ControlValue：输入要设置的值。

> [!NOTE] >

使用带多行文本控件的 SetControlValue 活动时，将会忽略所有新的行字符，并返回单一字符串。

Navigate

指定 Web 应用程序导航所至的 URL。 例如，当用户执行任务时，您可以使用 Navigate 活动强制 Web 应用程序导航至特定 URL。 此操作具有以下属性：

  • ApplicationName：可以托管控件的应用程序的名称。

  • URL：指定 URL 和查询字符串。

备注

不应在 Web 浏览器同时调用的 Navigate 活动。 如果是，您将会收到以下错误：

AutomationAdapter (app=Contact,action=__SetControlValue__): 已公布隐式操作异常: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web 浏览器正忙，不能停止。 WF/自动化 <GUID> 异常: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web 浏览器正忙，不能停止。

  • 至于目标应用程序上工作的 Navigate 活动，您必须配置 Unified Service Desk 内的托管应用程序，以使用自动化适配器 (HAT)，并提供自动化 XML 字段内的以下绑定：

    <DataDrivenAdapterBindingsCollection>

<DataDrivenAdapterBindings> <Type>Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.WebDataDrivenAdapter, Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter</Type> <Controls/> </DataDrivenAdapterBindings> </DataDrivenAdapterBindingsCollection>

有关配置 Unified Service Desk 内的托管控件的更多信息，请参阅 创建和管理 UII 托管应用程序。

Audit

从自动化内创建审核条目。 此操作具有以下属性：

  • Audit Flag：审核标志的名称。

  • Log data：审核标志值的值。

有关 Unified Service Desk内各类审核标志的信息，请参阅配置统一服务台内的审核（位于 Unified Service Desk 管理指南内）。

ConfigReader

从自动化内读取配置值。 该活动将从“选项”设置内读取（位于 Unified Service Desk 或应用程序配置文件中）的配置。 此操作具有以下属性：

  • OptionKey 作为字符串：用于从如下目标读取“选项”设置：Unified Service Desk。 有关各选项的详细信息，请参阅 TechNet：管理 Unified Service Desk 的选项。

  • XPath 作为字符串：用于读取应用程序配置文件。

  • QueryResult 作为字符串：搜索结果。

InitstringReader

可使您从自动化内读取 InitString 内容。 此操作具有以下属性：

  • XPath 作为字符串：用于读取应用程序配置文件。

  • QueryResult 作为字符串：搜索结果。

另请参阅

创建 HAT 自动化
UII 应用程序集成框架
使用数据驱动适配器 (DDA)

Unified Service Desk 2.0

© 2017 Microsoft。 保留所有权利。 版权