Depure un complemento registrado local

  • Artículo

Puede obtener información general sobre la depuración de complementos en el tema Depurar un complemento de Dataverse. Los siguientes pasos describen cómo depurar un complemento que se ejecuta en Dynamics 365 Customer Engagement (on-premises).

Nota

Otra método para depuración un complemento que se ejecute en el espacio aislado en cualquier tipo de implementación es usar el servicio de seguimiento. Para obtener más información sobre cómo realizar un seguimiento, consulte Registro y seguimiento. Para obtener más información sobre la depuración, incluido un tutorial, consulte el tema Depurar un complemento de Dataverse.

 

Depurar un complemento

  1. Registre e implemente el ensamblado de complemento.

    Si existe otra copia del ensamblado en la misma ubicación y no puede sobrescribir esa copia porque está bloqueada por Dynamics 365 Customer Engagement (on-premises), debe reiniciar el proceso de servicio que estaba ejecutando el complemento. Consulte la tabla mostrada a continuación para el proceso de servicio adecuado. Más información: Registrar e implementar complementos

  2. Configure el depurador.

    Adjunte el depurador al proceso en el Dynamics 365 Server que ejecutará el complemento. Consulte la siguiente tabla para identificar el proceso.

    Configuración del registro de complementos Proceso de servicio
    Online w3wp.exe
    sin conexión Microsoft.Crm.Application.Hoster.exe
    complementos registrados asincrónicos (o ensamblados de flujo de trabajo personalizados) CrmAsyncService.exe
    espacio aislado (modo de aislamiento) Microsoft.Crm.Sandbox.WorkerProcess.exe

    Si hay varios procesos que se ejecutan en el mismo archivo ejecutable, por ejemplo varios procesos w3wp.exe, adjunte el depurador a todas las instancias del proceso ejecutable que se está ejecutando. A continuación, defina uno o varios puntos de interrupción en el código del complemento.

  3. Pruebe el complemento.

    Ejecute la aplicación de Dynamics 365 Customer Engagement (on-premises), u otra aplicación personalizada que use el SDK, y realice la acción que sea necesaria para que el complemento se ejecute. Por ejemplo, si un complemento está registrado para un evento de creación de cuentas, cree una nueva cuenta.

  4. Depure el código del complemento.

    Realice los cambios necesarios en el código de modo que se comporte de la forma deseada. Si se cambia el código, compile el código en un ensamblado y repita los pasos 1 a 4 de este procedimiento según sea necesario. Sin embargo, si cambia los números de versión principales o secundarios del ensamblado de complemento, debe anular el registro de la versión anterior del ensamblado y registrar la nueva. Más información: Registrar e implementar complementos

  5. Registre el complemento en la base de datos.

    Después de que se haya completado el ciclo de edición/compilación/implementación/prueba/depuración para el complemento, anule el registro del ensamblado de complemento (en disco o GAC) y vuelva a registrar el complemento en la base de datos de Dynamics 365 Customer Engagement (on-premises). Más información: Registrar e implementar complementos

Propina

Es posible depurar un complemento implementado en la base de datos. El archivo de símbolos (.pdb) del ensamblado de complementos compilado se debe copiar a la carpeta <crm-root>\Server\bin\assembly y Servicios de información de Internet (IIS) del servidor y a continuación se debe reiniciar . Después de que la depuración se haya completado, debe quitar el archivo de símbolos y restablecer IIS para evitar que el proceso que estaba ejecutando el complemento consuma memoria adicional.

Para obtener más información sobre cómo depurar un complemento usando la herramienta de generador de perfiles de complementos, consulte Depure un complemento.

Depurar un complemento de espacio aislado

Es importante realizar estos pasos antes de la primera ejecución de un complemento de espacio aislado. Si el complemento ya se ha ejecutado, cambie el código del ensamblado causante del cambio del hash del ensamblado en el servidor, o reinicie el Servicio de procesamiento de espacios aislados de Dynamics 365 Customer Engagement (on-premises) en el servidor de espacios aislados.

Configuración del servidor local

El proceso de host de espacios aislados supervisa el proceso de trabajo del espacio aislado que ejecuta el complemento. El proceso de host comprueba si el complemento deja de responder, si excede los umbrales de memoria, etc. Si el proceso de trabajo no responde en 30 segundos, se cerrará. Si desea depurar un complemento de espacio aislado, debe deshabilitar esta función de apagado. Para deshabilitar la característica de apagado, establezca la siguiente clave del Registro en 1 (DWORD):

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM\SandboxDebugPlugins

Depurar el complemento

Siga estos pasos para depurar un complemento de espacio aislado.

  1. Registre el complemento en el espacio aislado (modo aislado) e impleméntelo en la base de datos del Dynamics 365 Server.

  2. Copie el archivo de símbolos (.pdb) del ensamblado de complementos compilado en la carpeta server\bin\assembly del servidor que ejecuta el proceso de trabajo de espacios aislados denominado Microsoft.Crm.Sandbox.WorkerProcess.exe. Este es el servidor que hospeda el rol Servicio de procesamiento de espacios aislados.

  3. Siga las instrucciones de los pasos 2 a 4 mostrados al principio de este tema.

    Para obtener más información sobre cómo depurar un complemento usando la herramienta de generador de perfiles de complementos, consulte Depure un complemento.

Vea también

Desarrollo de pluggins
Depurar un complemento
Registrar e implementar complementos
Escribir un complemento