Compartir a través de

Tipos de actividades de automatización HAT en Unified Service Desk

  • Artículo

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 las actividades de automatización HAT y usarlas, consulte Uso de actividades de automatización HAT.

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

Las actividades de acción proporcionan funcionalidades de acceso y administración de acciones de UII. A continuación se indican las diferentes actividades relacionadas con acciones disponibles.

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 las 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. A continuación se indican las diferentes actividades relacionadas con contextos disponibles.

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 Microsoft.Uii.AifServices.ISsoLookupService.

HostApplication
Hospeda la interfaz de usuario de la aplicación. Usa los datos de configuración de Hospedaje de aplicaciones especificados al configurar el control hospedado en Unified Service Desk en el servidor de Microsoft Dataverse para determinar el modo de hospedaje. Para obtener más información sobre la especificación del 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. A continuación se indican las diferentes actividades relacionadas con DDA disponibles.

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 de Unified Service Desk, consulte Configurar auditoría y diagnósticos en Unified Service Desk.

    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__): Posted implicit action exception:  Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web browser is busy and cannot be stopped.   

WF/Automation <GUID> exception: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web browser is busy and cannot be stopped.
    • 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 sobre la configuración de controles hospedados en Unified Service Desk, consulte Crear y administrar aplicaciones hospedadas de UII.

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 en el archivo de configuración de la aplicación. Esta acción tiene las siguientes propiedades:

  • OptionKey como cadena: se usa para leer la configuración de Opción desde Unified Service Desk. Para obtener más información acerca de distintas opciones, consulte 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.

Vea también

Crear automatizaciones HAT
Integration Application Framework de UII
Uso de adaptadores basados en datos