Registrar un complemento para su implementación local
Los complementos y las actividades personalizadas de flujo de trabajo son el código personalizado que desarrolla para ampliar la funcionalidad de Dynamics 365 Customer Engagement (on-premises) existente. Antes de que se pueda usar un complemento o una actividad de flujo de trabajo, se debe registrar con el servidor. Puede descargar un complemento y una herramienta personalizada de actividad de flujo de trabajo.
La información general sobre el registro de complementos y ensamblado de flujo de trabajo personalizado puede encontrarse en los temas de Dataverse Registrar un complemento y Registrar el ensamblado. La información siguiente es específica el desarrollo complementos local.
Aunque este tema se centra sobre todo en complementos, la mayoría de la información también es aplicable a las actividades de flujo de trabajo personalizado. Una diferencia entre los dos es que para que los ensamblados de actividad de flujo de trabajo personalizado, puede registrar solo el ensamblado. Para los complementos, puede registrar el ensamblado de complementos y uno o varios pasos por complemento. Para obtener más información acerca de las actividades de flujo de trabajo personalizadas, consulte Actividades de flujo de trabajo personalizadas (ensamblados de flujo de trabajo).
Importante
No registre ningún complemento ni actividad de flujo de trabajo personalizada a menos que se obtenga de una fuente de confianza y confiable.
Almacenamiento de complementos
Para una implementación local, los complementos que no se registran en el espacio asilado se pueden almacenar en la base de datos de Dynamics 365 Server o en el sistema de archivos en disco. Se recomienda que almacene los complementos listos para producción en la base de datos de Dynamics 365 Customer Engagement (on-premises) , en vez de en disco. Los complementos almacenados en la base de datos se distribuyen entre varios Dynamics 365 Servers en un clúster del centro de datos. El almacenamiento en disco resulta útil para depurar los complementos mediante Visual Studio. Sin embargo, puede depurar un complemento almacenado en la base de datos. Para obtener más información, consulte Depurar un complemento.
Los complementos registrados en el espacio asilado se deben almacenar en la base de datos independientemente de la implementación de Dynamics 365 Customer Engagement (on-premises) (local, IFD o en línea).
Implementación
Para instalaciones de Dynamics 365 Customer Engagement (on-premises) locales o con conexión a Internet (IFD), cuando implemente complementos de otro equipo en el disco de Dynamics 365 Server (implementación en disco), se debe copiar el ensamblado de complementos manualmente en el servidor antes del registro. El ensamblado debe ser implementado en la carpeta <installdir>\Archivos de programa\Microsoft CRM\server\bin\assembly de cada servidor donde se va a ejecutar el complemento.
El registro de complementos se debe realizar después de que se haya copiado el ensamblado a la carpeta …\bin\assembly del servidor para evitar la situación en que un usuario del sistema ocasiona que se genere un evento en Dynamics 365 Customer Engagement (on-premises) pero el ensamblado de complementos registrado aún no existe en el servidor. Para la implementación de la base de datos del servidor, el ensamblado de complementos se copia automáticamente durante el registro de complementos de manera que la situación anterior no es un problema.
Dependiendo del diseño del complemento, los complementos pueden requerir que se ejecuten otros ensamblados a los que se hace referencia. Independientemente de si implementa el complemento en la base de datos o en disco, si el complemento requiere que se ejecuten otros ensamblados, debe poner las copias de estos ensamblados en la caché de ensamblados global en cada servidor donde se ejecuta el complemento.
Para mover un complemento de un entorno de desarrollo a un servidor de almacenamiento provisional o un servidor de producción
- En el equipo de implementación, compile el código del complemento. No incluya la información de depuración. Optimice el complemento para obtener rendimiento.
- Registre el complemento en la base de datos de Dynamics 365 Server.
- Mediante la aplicación web de Dynamics 365 Customer Engagement (on-premises) , cree una solución o use una existente y agregue el complemento a esa solución.
- Después de agregar cualquier otro componente que desee a la solución, exporte la solución.
- Importe la solución en el servidor de almacenamiento provisional o de producción.
Restricciones de seguridad
Existe una restricción de seguridad que permite registrar complementos solo a los usuarios con privilegios. Para los complementos que no se registran en el espacio aislado (aislamiento), la cuenta de usuario del sistema bajo la que se registra el complemento debe existir en el grupo Administradores de implementaciones de Administrador de implementaciones. Solo la cuenta de usuario del administrador del sistema o cualquier cuenta de usuario incluida en el grupo Administradores de implementaciones puede ejecutar el Administrador de implementaciones.
Importante
Para los complementos sin aislar, si no se puede incluir la cuenta de usuario de registro en el grupo Administradores de implementaciones da lugar a que se emita una excepción durante el registro de complementos. La descripción de la excepción indica que "no dispone de privilegios suficientes para completar la operación de creación para una entidad de SDK".
Para los complementos registrados en el espacio asilado (modo aislado), la cuenta de usuario del sistema en la que el complemento se va a registrar debe tener el rol de administrador del sistema. La suscripción en el grupo Administradores de implementaciones no es obligatoria.
Vea también
Desarrollo de complementos
Depurar un complemento
Empaquetar y distribuir las extensiones con soluciones de Dynamics 365 Customer Engagement (on-premises)