Depurar actividades de flujo de trabajo

Artículo
06/23/2023

Puesto que las extensiones personalizadas del flujo de trabajo son ensamblados de .NET Framework puede depurarlas con métodos muy similares a cómo se depuran los complementos.

Uso de la herramienta de registro de complementos

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

Una vez que ha descargado la PRT, haga clic en PluginRegistration.exe para ejecutarlo.

Instale el generador de perfiles

Desde la PRT puede instalar la solución de generador de perfiles haciendo clic en el botón Instalar el generador de perfiles.

El botón de instalación del generador de perfiles en la herramienta de registro de complementos.

Esta solución agrega la capacidad de capturar el contexto que se pasa a la actividad de flujo de trabajo y permite una reproducción que puede usar para depurar la lógica del código localmente con Visual Studio.

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

Generador de perfiles de complementos en la herramienta de registro de complementos.

Generar un prefil de una actividad de flujo de trabajo

Para generar un perfil de una actividad de flujo de trabajo, haga clic con el botón secundario en Generador de perfiles de complementos y seleccione Iniciar flujo de trabajo de generar perfiles.

Iniciar flujo de trabajo de generar perfiles.

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

cuadro de diálogo de configuración del generador de perfiles.

Campo	Descripción
Workflow	Seleccione la acción de flujo de trabajo que contiene la actividad de flujo de trabajo que desea depurar.
Pasos	Seleccione los pasos específicos dentro del flujo de trabajo que desea depurar.
Especificar almacenamiento del perfil	Se recomienda que elija Persistir en entidad.
Establecer configuración del generador de perfiles	Si está trabajando con un sistema donde el flujo de trabajo se ejecuta con frecuencia, puede reducir el impacto del rendimiento eligiendo limitar el número de perfiles que se capturan.
Incluir configuración segura	Esto proporciona la opción de evitar ver potencialmente datos confidenciales que se pueden pasarse como configuración segura.

Haga clic en Aceptar para guardar la configuración.

Nota

En el momento de redactarse este texto puede ver el error siguiente:

Error al definir los valores del generador de perfiles de actividad de flujo de trabajo.

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 generador de perfiles se guardó correctamente. El error ocurre porque el proceso de generación perfiles de una actividad personalizada de flujo de trabajo creará una copia del flujo de trabajo y deshabilitará el flujo de trabajo original y la copia. Será necesario configurar de nuevo la copia cuyo perfil se ha generado y activarla para capturar un perfil. Consulte los siguientes pasos para obtener más información.

Capturar un perfil

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

Nota

A menos que esté trabajando en la solución del sistema Predeterminado, no puede ver 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 está trabajando, necesita hacer clic en Agregar existente y agregar esta copia a la solución.

Los flujos de trabajo desactivados deben tener un aspecto similar al siguiente:

Flujo de trabajo copiado en el Explorador de soluciones.

Cuando se copia el flujo de trabajo, parte de la configuración se pierde. Si intenta activar el flujo de trabajo copiado, recibirá 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 configurar de nuevo las propiedades Iniciar cuando del flujo de trabajo. En este caso, deseamos establecer el flujo de trabajo para que se inicie cuando el campo Nombre de cuenta cambie:

Iniciar cuando el campo cambia de valor.

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

Cuadro de diálogo de selección de campo Iniciar cuando el campo cambia de valor.

El flujo de trabajo copiado del perfil también se cambiará a un flujo de trabajo de segundo plano (asincrónico). Será más fácil comprobar un flujo de trabajo en tiempo real (forma sincrónica), 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 copiado del perfil y actívelo.

En una aplicación con conexión con la instancia de Dataverse, o con los servicios web, actualice el valor 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 finalice antes de avanzar al paso siguiente. Vaya a Configuración > Trabajos del sistema y compruebe que el flujo de trabajo se realizó correctamente.

Detener el generar perfiles

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

Para detener el generar perfiles, anule el registro del flujo de trabajo mediante PRT.

Detener el flujo de trabajo de generar perfiles.

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

Importante

El flujo de trabajo que se copió seguirá estando desactivado. Deberá reactivarlo manualmente si desea que se aplique.

Depurar el ensamblado.

En el PRT, haga clic en Reproducir ejecución de complementos.
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 la actividad de flujo de trabajo. Se usan solo para complementos.
En el 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 - custom navegando a Configuración > Extensiones > Perfiles de complementos.
Haga clic en Seleccionar para cerrar el cuadro de diálogo.
En el campo Ubicación de ensamblado, haga clic en las elipses (...) para agregar la ubicación del ensamblado que contiene la actividad de flujo de trabajo que está depurando.
Abra el proyecto de actividad de flujo de trabajo en Visual Studio.
Agregue un punto de pausa a una línea en el método Execute de la actividad de su flujo de trabajo.
Del menú Depurar, seleccione Asociar al proceso….
Busque en el proceso PluginRegistration.exe.

Sugerencia

El filtro de búsqueda le ayudará a encontrarlo más rápido. El identificador del proceso (PID) asignado al proceso será distinto para cada sesión. El PID se muestra en el diálogo Reproducir ejecución de complementos en Seguimientos de complementos.
Haga clic en Adjuntar para adjuntar su depurador Visual Studio a la aplicación de PRT que ejecutará la reproducción de proceso.
En el diálogo Reproducir ejecución de complementos de PRT, haga clic en el botón Iniciar la ejecución.