Crear automatización HAT en Unified Service Desk

Puede usar las actividades de automatización de Hosted Application Toolkit (HAT) para crear las automatizaciones para el proyecto de aplicación hospedado. Puede usar el inspector de User Interface Integration (UII) para hacer disponibles los controles de una aplicación para su uso en automatización. Aunque una automatización se inicia por una acción definida en una aplicación, puede tener acceso a controles definidos en todas las aplicaciones que ejecuten la sesión. Las automatizaciones también pueden interactuar con aplicaciones habilitadas sin automatización con actividades como actividades de contexto DoAction o Apppplication Integration Framework (AIF). Más información: Tipos de actividades de automatización HAT

Antes de agregar automatización a la aplicación, asegúrese de que ha inspeccionado todos los controles requeridos de la aplicación. para hacerlo, consulte Usar el inspector de UII para crear enlaces para la aplicación hospedada.

Crear automatización HAT

1. Abra el proyecto de aplicación que ha creado previamente con HAT donde desee agregar automatizaciones. Más información: Uso de HAT Software Factory para crear una aplicación hospedada. También puede crear un flujo de trabajo en un proyecto diferente, y luego agregarlo a la aplicación hospeda existente creada con HAT.

2. En Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto y seleccione Agregar>Nuevo elemento.

3. En el cuadro de diálogo Agregar nuevo elemento, seleccione Visual C#>Flujo de trabajo en el panel izquierdo, seleccione Actividad como tipo de proyecto, especifique un nombre apropiado y, a continuación haga clic en Agregar.

   

4. Esto agrega el flujo de trabajo de la actividad (XAML) en el proyecto, y abre XAML en el área del diseñador de actividades de flujo de trabajo donde puede colocar las actividades de automatización de HAT junto con otras actividades para diseñar su automatización.

   

5. Cree la automatización usando las actividades HAT, guarde el proyecto, y luego genérelo.

   El siguiente paso es establecer una acción para la aplicación HAT creada anteriormente y, a continuación asociar la acción con la automatización que acaba de crear.

Configurar una acción para ejecutar la automatización

En esta sección, configuraremos una acción de la aplicación para asociarla con la automatización que hemos creado en la sección anterior.

1. Abra el proyecto de aplicación HAT en Visual Studio, si aún no está abierto. Más información: Uso de HAT Software Factory para crear una aplicación hospedada.

2. En Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto de la aplicación HAT y seleccione Configuración de acción.

3. En el cuadro de diálogo Configuración de la acción, especifique el nombre de la acción y otros detalles, si fuera necesario. Para obtener información acerca de estos campos, consulte Configurar una acción para la aplicación hospedada.

4. En Automatización, en la lista Modo, seleccione Usar ensamblado de flujo de trabajo o Usar XAML de flujo de trabajo para asociar una automatización con la acción.

   

5. Haga clic en Seleccionar flujo de trabajo para especificar la automatización.

6. En el cuadro de diálogo Selector de flujo de trabajo, expanda el nombre del proyecto, y seleccione el flujo de trabajo (.xaml) que desea asociar con la acción, y después haga clic en Aceptar.

   

7. Si seleccionó:

   1. Usar ensamblado de flujo de trabajo en el paso 4, la información de tipo se rellena en el campo Tipo para la automatización seleccionada (flujo de trabajo).

   

   Nota

   Como la ruta absoluta al conjunto de flujo de trabajo no se menciona en el campo Tipo, debe copiar el archivo de ensamblado del flujo de trabajo en el directorio de instalación del cliente de Unified Service Desk para probar y utilizar la aplicación alojada y la automatización.

   2. Usar XAML de flujo de trabajo en el paso 4, el flujo de trabajo de XAML se rellena en el campo XAML para la automatización seleccionada (flujo de trabajo).

   

8. Si desea ejecutar la automatización en modo asincrónico, seleccione la casilla Async. La automatización se puede ejecutar de forma sincrónica o asincrónica.

   • En el modo sincrónico, la automatización se ejecuta en subproceso de la interfaz de usuario (UI) de Unified Service Desk y bloquea la interfaz de usuario hasta que finalice. El bloqueo de la interfaz de usuario puede resultar útil, ya que permite actualizar el estado de la interfaz de usuario de la aplicación en aislamiento. Para evitar que parezca que la interfaz de usuario no responde, mantenga los tiempos de ejecución de la automatización tan cortos como sea posible.

   • En modo asincrónico, la automatización no se ejecuta en el subproceso de la interfaz de usuario de Unified Service Desk hasta que deba interactuar con la interfaz de usuario.

9. Seleccione Guardar para crear la acción para desencadenar la automatización.

10. Guarde el proyecto y genérelo (Generar>Generar solución).

Comprobar el control hospedado HAT con automatización

1. Implementar la aplicación HAT en Unified Service Desk en un servidor de Microsoft Dataverse. Más información: Implementar la aplicación hospedada en Unified Service Desk

2. Copie los archivos necesarios (flujo de trabajo y ensamblados de aplicación HAT) al directorio de la aplicación cliente de Unified Service Desk (normalmente C:\Program Files\Microsoft Dynamics CRM USD \USD).

3. Ejecute el cliente Unified Service Desk y use el depurador para probar la aplicación hospedada HAT y la acción con automatización. En la pestaña Depurador, haga clic en la flecha abajo sobre la pestaña Llamadas a la acción para mostrar el área donde puede probar llamadas a la acción y acciones de User Interface Integration (UII).

4. Haga clic en la pestaña Acción directa:

   1. Seleccione el control hospedado y la acción que desee verificar.

   2. Haga clic en el icono ejecutar para probarlo.

   

   Para obtener más información sobre el uso del control hospedado Depurador, vea Problemas de depuración en Unified Service Desk en el Manual de administración de Unified Service Desk.

Propina

Para depurar la automatización, inicie Visual Studio como administrador, abra el proyecto de aplicación de HAT, y establezca el archivo ejecutable del cliente Unified Service Desk (UnifiedServiceDesk.exe) como el programa de inicio externo en las propiedades del proyecto. Además, establezca la ruta de salida de compilación del proyecto el directorio de instalación del cliente de Unified Service Desk. Cada vez que depure el proyecto, copiarán los ensamblados en el directorio de instalación del cliente de Unified Service Desk y el cliente se iniciará.

Ver automatizaciones de ejemplo

1. Descargue el paquete de SDK de UII y extráigalo.

2. En la carpeta <ExtractedFolder>\UII\SampleCode\UII\Hat\QsAutomationProject, abra el archivo Microsoft.Uii.QuickStarts.QsAutomationProject.csproj en Visual Studio.

3. Corrija las referencias de ensamblado que faltan en el proyecto estableciendo la ruta de referencia del proyecto (Proyecto>[Proyecto] Propiedades>Rutas de acceso de referencia) en la carpeta <ExtractedFolder>\UII\Bin\UII folder o al directorio de la aplicación cliente de Unified Service Desk (normalmente C:\Program Files\Microsoft Dynamics CRM USD\USD).

4. Compile el proyecto (Generar>Solución de compilación) para ver las automatizaciones de ejemplo (XAML). Cuando el proyecto se compile correctamente, haga doble clic en un archivo XAML en el Explorador de soluciones para ver la definición de automatización.

Vea también

Usar actividades de automatización de HATTipos de actividades de automatización de HATConfigurar una acción para la aplicación hospedada