Compartir a través de

Tipos de actividades de automatización HAT

  • Artículo

 

Publicado: noviembre de 2016

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Hay varios tipos de actividades de automatización de Kit de herramientas de aplicaciones hospedadas (HAT) que puede usar para automatizar sus aplicaciones hospedadas. Para ver y usar las actividades de automatización de HAT, consulte Uso de actividades de automatización HAT.

En este tema

Actividades de acción de Marco de integración de aplicaciones (AIF)

Actividades de contexto AIF

Actividades DDA

Actividades de acción de Marco de integración de aplicaciones (AIF)

Las actividades de acción proporcionan funcionalidad de acceso y administración de Acciones de UII. La siguiente tabla describe las distintas actividades de acción disponibles.

Actividad

Descripción

DoAction

Ejecuta una acción en la misma aplicación o en otra aplicación hospedada. Esta acción tiene las siguientes propiedades:

  • ApplicationName: La aplicación donde se ejecuta DoAction. Obligatorio.

  • ActionData: Datos necesarios para realizar la acción. Opcional.

  • ActionName Nombre de la acción que se registra con la aplicación hospedada especificada en la propiedad ApplicationName. Obligatorio.

GetActionData

Recupera los datos de la acción que invocó el flujo de trabajo o automatización. El valor se devolverá en la propiedad ActionData.

SetActionData

Agrega datos a la acción actual.

Especifique los datos que se requieren para la acción en el parámetro ActionData.

RegisterActionForEvent

Registra una acción para que se inicie cada vez que aparece un evento. Esta acción tiene las siguientes propiedades:

  • ActionApplication: Nombre de la aplicación con la que está registrada la acción de UII. Obligatorio.

  • ActionName: Nombre de la acción para la aplicación que se ejecutará cuando se inicie el evento. Obligatorio.

  • ApplicationName: Nombre de la aplicación que inicia el evento. Obligatorio.

  • ControlName: Nombre del control que inicia el evento. Opcional.

  • EventName: Nombre del evento iniciado por la aplicación/control.

UnRegisterActionForEvent

Elimina el registro de una acción que se registró anteriormente utilizando la actividad RegisterActionForEvent. El evento no registrado no se ejecutará más. Esta acción tiene las siguientes propiedades:

  • ActionApplicationName: Nombre de la aplicación con la que está registrada la acción de UII.

  • ActionName: Nombre de la acción para la aplicación que se habría ejecutado cuando se inició el evento.

  • ApplicationName: Nombre de la aplicación que inicia el evento.

  • ControlName: Nombre del control que inicia el evento.

  • EventName: Nombre del evento iniciado por la aplicación o control.

CloseDynamicApp

Cierra una aplicación hospedada dinámica desde la automatización. Puede usar esta acción para cerrar mediante programación una aplicación hospedada dinámica en Unified Service Desk.

Especifique el nombre de la aplicación hospedada dinámica en el parámetro ApplicationName que desea cerrar.

Para obtener más información sobre aplicaciones hospedadas dinámicas, consulte Aplicaciones hospedadas de UII dinámicas.

StartDynamicApp

Inicia una aplicación hospedada dinámica desde la automatización.

Especifique el nombre de la aplicación hospedada dinámica en el parámetro ApplicationName que desea abrir.

FocusApp

Establece el foco en una aplicación desde la automatización.

Especifique el nombre de la aplicación hospedada dinámica en el parámetro ApplicationName en el que desea establecer el foco.

Actividades de contexto AIF

Las actividades de contexto permiten el acceso del contexto AIF desde la automatización. La siguiente tabla describe las distintas actividades de contexto disponibles.

Actividad

Descripción

GetContext

Recupera un valor de la clave especificada del contexto. El valor se devuelve en la propiedad ContextValue.

Especifique la clave del contexto que se recuperará en la propiedad ContextKey.

SetContext

Establece el valor de la clave especificada en el contexto. Esta acción tiene las siguientes propiedades:

  • ContextKey: Clave del contexto que se establecerá.

  • ContextData: Opcionalmente, especifique los datos que se establecerán en el contexto especificado en ContextKey.

GetCredential

Recupera credenciales de usuario del contexto para la aplicación especificada. Esta acción tiene las siguientes propiedades:

  • ApplicationName: Nombre de la aplicación.

  • UserName: Nombre de usuario.

  • Password: Contraseña.

Nota

Para recuperar las credenciales de un almacén personalizado, el desarrollador necesita proporcionar una clase que implemente la interfaz de ISsoLookupService.

HostApplication

Hospeda la interfaz de usuario de la aplicación. Use los datos de configuración Hospedaje de aplicaciones especificados al configurar el control hospedado en Unified Service Desk en el servidor de Microsoft Dynamics 365 para determinar el modo de hospedaje. Para obtener más información sobre cómo especificar el modo de hospedaje para una aplicación en Unified Service Desk, consulte Crear y administrar aplicaciones hospedadas de UII.

Actividades DDA

Las actividades de adaptador basado en datos (DDA) proporcionan acceso a los controles especificados en los enlaces. La siguiente tabla describe varios actividades de DDA.

Actividad

Descripción

ControlFinder

Busca un control en la aplicación hospedada. La acción devuelve True si el control se encuentra en la propiedad de ControlFound; de lo contrario, devuelve False. Puede establecer la propiedad ExceptionsMask si desea usar el controlador de excepciones para ejecutar actividades dependientes. Esta acción tiene las siguientes propiedades:

  • ApplicationName: Nombre de la aplicación que hospeda el control. Obligatorio.

  • ControlName: Nombre del control en la aplicación.

  • ExceptionsMask: Indica si desea mostrar una excepción si el control no se encuentra. La configuración predeterminada es False.

Nota

Si un flujo de trabajo que ha configurado está bloqueando el subproceso de la UII y ha especificado los parámetros SleepInterval y Timeout para la actividad ControlFinder, la acción se debe configurar para ejecutarse asincrónicamente.

ExecuteControlAction

Ejecuta la acción predeterminada de un control. Por ejemplo, si el control es un botón, la acción predeterminada es clic. Esta acción tiene las siguientes propiedades:

  • ApplicationName: Nombre de la aplicación que hospeda el control.

  • ControlName: Nombre del control en la aplicación.

GetControlValue

Recupera un valor de un control en la aplicación. El valor se devuelve en la propiedad ControlValue. Esta acción tiene las siguientes propiedades:

  • ApplicationName: Nombre de la aplicación que hospeda el control.

  • ControlName: Nombre del control en la aplicación cuyo valor tiene que recuperarse.

Nota

Cuando se usa la actividad GetControlValue con un control de texto multilínea, todos los caracteres de nueva línea serán ignorados y se devuelve una sola cadena.

SetControlValue

Establece el valor de un control en la aplicación. Esta acción tiene las siguientes propiedades:

  • ApplicationName: Nombre de la aplicación que hospeda el control.

  • ControlName: Nombre del control en la aplicación cuyo valor tiene que establecerse.

  • ControlValue: Especifique el valor que se establecerá.

Nota

Cuando se usa la actividad SetControlValue con un control de texto multilínea, todos los caracteres de nueva línea serán ignorados y se devuelve una sola cadena.

Navigate

Especifica una dirección URL a la que navega una aplicación web. Por ejemplo, puede usar la actividad Navigate para forzar a una aplicación web a navegar a una dirección URL específica cuando un usuario realiza una tarea. Esta acción tiene las siguientes propiedades:

  • ApplicationName: Nombre de la aplicación que hospeda el control.

  • URL: Especifique la dirección URL junto con la cadena de consulta.

Nota

  • La actividad Navigate no se debe llamar simultáneamente en el explorador web. Si se llama, recibirá los siguientes errores:

    AutomationAdapter (app=Contact,action=__SetControlValue__): Excepción de acción implícita publicada:  Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: El explorador Web está ocupado y no se puede detener. WF/Automation <GUID> exception: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: El explorador web está ocupado y no se puede detener.

  • Para que la actividad Navigate funcione en la aplicación de destino, debe configurar la aplicación hospedada en Unified Service Desk para usar Adaptador de automatización (HAT), y proporcionar el siguiente enlace en el campo XML de automatización:

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

    Para obtener más información acerca de la configuración de controles hospedados en Unified Service Desk, consulte Crear y administrar aplicaciones hospedadas de UII.

Audit

Crea entradas de auditoría desde la automatización. Esta acción tiene las siguientes propiedades:

  • Audit Flag: Nombre del indicador de auditoría.

  • Log data: Valor del valor del indicador de auditoría.

Para obtener información acerca de los diferentes indicadores de auditoría en Unified Service Desk, Configuración de la auditoría en Servicios unificados en el Manual de administración de Unified Service Desk.

ConfigReader

Lee un valor de configuración desde la automatización. Esta actividad leerá la configuración desde la configuración Opción en Unified Service Desk o el archivo de configuración de la aplicación. Esta acción tiene las siguientes propiedades:

  • OptionKey como cadena: Usado para leer la configuración de Opción desde Unified Service Desk. Para obtener más información acerca de distintas opciones, consulte TechNet: Administrar opciones para Unified Service Desk.

  • XPath como cadena: Usado para leer el archivo de configuración de la aplicación.

  • QueryResult como cadena: Resultado de la búsqueda.

InitstringReader

Le permite leer el contenido InitString desde la automatización. Esta acción tiene las siguientes propiedades:

  • XPath como cadena: Usado para leer el archivo de configuración de la aplicación.

  • QueryResult como cadena: Resultado de la búsqueda.

Ver también

Crear automatización HAT
Marco de integración de aplicaciones de UII
Uso de adaptadores basados en datos (DDAs)

Unified Service Desk 2.0

© 2017 Microsoft. Todos los derechos reservados. Copyright