Depurar actividades de flujo de trabajo

Dado que las extensiones de flujo de trabajo personalizadas son ensamblados de .NET Framework, puede depurarlos mediante métodos muy similares a cómo depurar complementos.

Uso de la herramienta de registro de complementos

La Herramienta de registro de complementos (PRT) es una de las herramientas que puede descargar de NuGet. Más información: Herramientas de desarrollo de Dataverse.

Una vez que haya descargado el PRT, haga clic en PluginRegistration.exe para ejecutarlo.

Instalar el Perfilador

Desde el PRT, puede instalar la solución de perfilador para el complemento haciendo clic en el botón Instalar Perfilador.

Esta solución agrega la capacidad de capturar el contexto que se pasa a su actividad de proceso de trabajo y habilita la reproducción que puede usar para depurar la lógica en su código local con Visual Studio.

Cuando el generador de perfiles del complemento está instalado para la instancia de Microsoft Dataverse, lo verá en el PRT en la parte inferior de la lista de complementos registrados y actividades de flujo de trabajo personalizadas.

Perfilado de una actividad de flujo de trabajo

Para generar perfiles de una actividad de flujo de trabajo, haga clic con el botón derecho en plug-in Profiler y seleccione Iniciar flujo de trabajo de generación de perfiles.

Se abrirá el cuadro de diálogo Configuración del generador de perfiles, que proporcionará las siguientes opciones:

Campo	Description
Flujo de trabajo	Seleccione el flujo de trabajo que contiene la actividad de flujo de trabajo que desea depurar.
Pasos	Seleccione los pasos específicos dentro de ese flujo de trabajo que desea depurar.
Especificación del almacenamiento de perfiles	Se recomienda que elija Persistir en entidad.
Establecimiento de la configuración del generador de perfiles	Si está trabajando con un sistema en el que el flujo de trabajo se ejecuta con frecuencia, puede reducir el impacto en el rendimiento si elige limitar el número de perfiles que se capturan.
Incluir configuración segura	Esto proporciona la opción de evitar ver datos potencialmente confidenciales que se pueden pasar como configuración segura.

Haga clic en Aceptar para guardar la configuración.

Nota:

En el momento de redactar este documento, es posible que vea el siguiente error:

Los detalles de este error incluirán el mensaje: Automatic workflow cannot be published if no activation parameters have been specified.

La configuración del perfil se guarda correctamente. Este error se produce porque el proceso de generación de perfiles de una actividad de flujo de trabajo personalizada creará una copia del flujo de trabajo y deshabilitará tanto el flujo de trabajo original como la copia. Será necesario configurar de nuevo la copia cuyo perfil se ha generado y activarla para capturar un perfil. Consulte los pasos siguientes para obtener más información.

Capturar un perfil

Cuando se configura un perfil para el flujo de trabajo que contiene una actividad de flujo de trabajo personalizada, se crea una copia del flujo de trabajo original y tendrá el texto (Profiled) anexado al nombre. El original y la copia de los flujos de trabajo han sido desactivados.

Nota:

A menos que trabaje en la solución predeterminada del sistema, es posible que no vea el flujo de trabajo copiado porque se agrega a esa solución. Para ver el flujo de trabajo copiado en la solución en la que trabaja, debe hacer clic en Agregar existente y agregar esta copia a la solución.

Los flujos de trabajo desactivados deben tener este aspecto:

Cuando se copia el flujo de trabajo, se pierde parte de la configuración. Si intenta activar el flujo de trabajo copiado, obtendrá el siguiente error: An automatic process cannot be activated if no activation parameters have been specified. Add activation parameters, and then activate. ...

Esto significa que tiene que volver a configurar las propiedades Iniciar cuando del flujo de trabajo. En este caso, queremos establecer el flujo de trabajo para que se inicie cuando cambie el campo Nombre de cuenta:

Haga clic en el botón Seleccionar para elegir el campo Nombre de cuenta .

El flujo de trabajo del perfil copiado también se cambiará a un flujo de trabajo en segundo plano (asincrónico). Será más fácil probar un flujo de trabajo en tiempo real (sincrónico), por lo que en la barra de menús, haga clic en Convertir en un flujo de trabajo en tiempo real.

Guarde el flujo de trabajo del perfil copiado y actívelo.

En una aplicación conectada a su instancia de Dataverse o mediante los servicios web, actualice el valor del Nombre de Cuenta de una entidad de cuenta. Esto capturará una instancia del contexto pasada a la actividad personalizada de flujo de trabajo y la persistirá como un registro del perfil en el sistema.

Sugerencia

Si el flujo de trabajo es asincrónico, asegúrese de que se completa antes de pasar al paso siguiente. Vaya a Configuración > Trabajos del sistema y compruebe que el flujo de trabajo se realizó correctamente.

Detener la creación de perfiles

Una vez que haya capturado el perfil necesitará depurarlo, debe detener el generar perfiles del complemento.

Para detener la generación de perfiles, anule el registro del flujo de trabajo mediante el PRT.

Esto eliminará la copia del flujo de trabajo que se realizó.

Importante

El flujo de trabajo que se copió todavía se desactivará. Tendrá que reactivarlo manualmente si desea que se aplique.

Depurar el ensamblado.

1. En el PRT, haga clic en Reproducir ejecución del complemento.

2. En el diálogo Reproducir ejecución de complementos, en la pestaña Configuración, haga clic en el botón Descargar para seleccionar un Perfil.

   

   Nota:

   Las pestañas Configuración no segura, Configuración segura y Configuración no se usan para la depuración de actividades de flujo de trabajo. Solo se usan para plugins.

3. En el cuadro de diálogo Seleccionar perfil de CRM , elija el perfil más reciente que representa el que acaba de generar.

   

   Nota:

   Puede administrar perfiles capturados en la aplicación web Dynamics 365 - personalizada yendo a Configuración>Extensiones>Perfiles de complemento.

4. Haga clic en Seleccionar para cerrar el cuadro de diálogo.

5. En el campo Ubicación del ensamblado, haga clic en el botón de puntos suspensivos (...) para agregar la ubicación del ensamblado que contiene la actividad de flujo de trabajo que está depurando.

6. Abre tu proyecto Workflow Activity en Visual Studio.

7. Agregue un punto de pausa a una línea en el método Execute de la actividad de su flujo de trabajo.

   

8. En el menú Depurar , seleccione Asociar al proceso....

9. Busque en el proceso PluginRegistration.exe.

   Sugerencia

   El filtro de búsqueda le ayudará a encontrar esto más rápido. El identificador de proceso (PID) asignado al proceso será diferente para cada sesión. El PID se muestra en el cuadro de diálogo Ejecución del complemento de reproducción bajo Trazas del complemento.

   

10. Haga clic en Asociar para adjuntar el depurador de Visual Studio a la aplicación PRT que ejecutará la reproducción del proceso.

11. En el cuadro de diálogo Ejecución del complemento PRT Replay , haga clic en el botón Iniciar ejecución .

Debe ahora poder repasar el código y depurar la actividad de flujo de trabajo mediante Visual Studio.

Información adicional

Depurar complementos
Tutorial: Depurar un complemento