Extensiones compatibles

Puede personalizar Dynamics 365 Customer Engagement (on-premises) mediante herramientas que están disponibles en la aplicación web deDynamics 365 Customer Engagement (on-premises) o que se describen en Servicios web de Dynamics 365 Customer Engagement. Estas personalizaciones están admitidas y se pueden actualizar.

Las personalizaciones realizadas con otros métodos que no sean los que aquí se describen no están admitidas y podrían causar problemas durante la instalación de actualizaciones y mejoras de Dynamics 365 Customer Engagement (on-premises). Consulte Personalizaciones no admitidas para obtener más información.

Se admiten los temas cubiertos en los artículos técnicos publicados en sitios de Microsoft, como Learn, pero podrían no ser actualizables.

Personalizaciones mediante una aplicación web de Dynamics 365 Customer Engagement (on-premises)

Hay diversas herramientas incluidas en Dynamics 365 Customer Engagement (on-premises) que puede usar para personalizarla. Las personalizaciones realizadas mediante las herramientas y aplicaciones web de Dynamics 365 Customer Engagement (on-premises) son totalmente compatibles y actualizables.

Se pueden usar los siguientes métodos de personalización para generar personalizaciones completamente compatibles:

Nota:

Completamente compatible significa que el soporte técnico para programadores puede proporcionar ayuda para las personalizaciones y que el soporte técnico para aplicaciones puede ayudar a los clientes a ejecutar dichas modificaciones.

Para obtener más información sobre el uso de las herramientas de personalización en la aplicación web, consulte el Manual de personalización (Dynamics 365 Customer Engagement (on-premises)).

Personalizaciones con el SDK de Dynamics 365 Customer Engagement (on-premises)

Los servicios web de Dynamics 365 Customer Engagement, los artículos técnicos y el código de ejemplo publicados en este sitio y la información publicada por el equipo de soporte técnico Developer de Dynamics 365 Customer Engagement (on-premises) se incluyen en el área de personalizaciones mediante Servicios web de Dynamics 365 Customer Engagement. Las acciones y niveles específicos de compatibilidad y capacidad de actualización se describen más adelante en este artículo.

Servicios web de Dynamics 365 Customer Engagement (on-premises)

El uso de los servicios web es completamente compatible. La lista de servicios web incluye: servicio de detección, servicio de organización (SDK), servicio de datos de la organización, la API Web y el servicio de implementación. Nos esforzamos por mantener las API compatibles con versiones anteriores, pero nos reservamos el derecho de cambiar las API para más características. Los atributos de entidad también pueden cambiar en versiones futuras. Para obtener más información, vea Escribir código para aplicaciones Dynamics 365 Customer Engagement (on-premises) (servicios web)

JavaScript del lado del cliente

Puede usar JavaScript en Dynamics 365 Customer Engagement (on-premises) en tres áreas:

  • Controladores de eventos para script de formularios: puede configurar controladores de eventos de formulario para invocar funciones definidas en los recursos web de JavaScript.

  • Comandos de la barra de comandos (cinta de opciones): puede usar los elementos de <CustomRule> o <JavaScriptFunction> para definir acciones que invoquen funciones definidas en los recursos web de JavaScript.

  • Recursos web e IFRAMEs: puede usar los recursos web de JavaScript dentro de recursos web HTML. Los elementos IFRAMES configurados para permitir scripting entre sitios o los scripts dentro de recursos web HTML incluidos en un formulario pueden interactuar con los métodos documentados Xrm.Page o Xrm.Utility dentro del formulario mediante la referencia primaria.

    Todas las interacciones con las páginas de aplicación de Dynamics 365 Customer Engagement (on-premises) solo se deben realizar por medio de los métodos documentados en Referencia de API de cliente. No se admite el acceso directo al modelo de objetos de documento (DOM) de cualquier página de aplicación de Dynamics 365 Customer Engagement (on-premises). No se recomienda el uso de jQuery en los scripts y comandos de formularios. Más información: Scripting del cliente en Customer Engagement (on-premises) mediante JavaScript.

    Puede abrir formularios, vistas, cuadros de diálogo e informes de Dynamics 365 Customer Engagement (on-premises) con los métodos que se explican en Abrir formularios, vistas, cuadros de diálogo e informes con una dirección URL.

Personalización de la cinta de opciones

Se admite el uso de RibbonDiffXml para agregar, quitar u ocultar elementos de la cinta de opciones. Se admite la reutilización de los comandos de la cinta de opciones definidos por Dynamics 365 Customer Engagement (on-premises); sin embargo, nos reservamos el derecho de cambiar o dejar de usar los comandos disponibles. No se admite la reutilización de las funciones de JavaScript definidas dentro de los comandos de la cinta de opciones.

Archivo de solución

Se admite la modificación del archivo de una solución no administrada como se describe en esta documentación. Algunas tareas de personalización se realizan mediante estos pasos:

  • Exportar un componente de la solución como una solución no administrada.

  • Extraer el contenido del paquete de solución.

  • Editar el archivo customizations.xml.

  • Volver a empaquetar el archivo de solución.

  • Importar la solución modificada.

    Nota:

    Los cambios en el archivo Customizations.xml deben cumplir el esquema de CustomizationsSolution.xsd. Para obtener más información, vea Esquemas usados en Dynamics 365 Customer Engagement (on-premises).

Las siguientes tareas admitidas requieren este procedimiento:

  • Personalización de la cinta de opciones.
  • Personalización de la navegación de la aplicación con el mapa del sitio.
  • Personalización del formulario y el panel con FormXml.
  • Personalización de la consulta guardada.

Plug-ins

La capacidad para crear la lógica de negocios personalizada con el mecanismo de complemento que se describe en esta documentación es completamente compatible y se puede actualizar. Esta característica está disponible para todas las implementaciones de Dynamics 365 Customer Engagement (on-premises), incluidos las implementaciones locales, IFD y en línea. Sin embargo, los complementos solo se pueden registrar y ejecutar en el espacio aislado (aislamiento) de Dynamics 365 Customer Engagement (on-premises). Más información: Complementos para ampliar Dynamics 365 Customer Engagement (on-premises)

La acción de agregar los ensamblados de complementos y de actividad de flujo de trabajo personalizada a la carpeta %installdir%\server\bin\ se admite únicamente en las instalaciones de servidor locales e IFD de Dynamics 365 Customer Engagement (on-premises).

Flujo de trabajo

La capacidad para crear las actividades de flujo de trabajo personalizadas (ensamblados) que se llamarán desde las reglas de flujo de trabajo es completamente compatible y se puede actualizar. Esta característica está disponible para Dynamics 365 Customer Engagement (on-premises) local, IFD y Online. Sin embargo, las actividades de flujo de trabajo personalizadas solo se pueden registrar y ejecutar en el espacio aislado (aislamiento) de Dynamics 365 Customer Engagement (on-premises). Más información: Automatizar los procesos de negocio en Customer Engagement

La capacidad para editar flujos de trabajo XAML es completamente compatible y se puede actualizar. Sin embargo, esta característica está disponible para Dynamics 365 Customer Engagement (on-premises) e IFD solo. Más información: Automatizar los procesos de negocio en Customer Engagement (on-premises).

Compatibilidad con las versiones de .NET Framework

Aquí se describen las consideraciones sobre compatibilidad del código personalizado escrito con Microsoft .NET Framework 4.6.2.

  • Cualquier cliente de servicio web creado mediante Microsoft .NET Framework 4.6.2 (o versiones posteriores) que llame a los servicios web de Dynamics 365 Customer Engagement (on-premises) es totalmente compatible con Dynamics 365 Customer Engagement (on-premises).

    Importante

    Debe crear cualquier aplicación de cliente personalizada usando Microsoft .NET Framework 4.6.2 o posterior. A partir de la versión 9 de Dynamics 365 Customer Engagement (on-premises), solo se permite conectarse a las aplicaciones que usan seguridad de nivel de transporte (TLS) 1.2 o superior. TLS 1.2 no es el protocolo predeterminado usado por .NET Framework 4.5.2, pero está en .NET Framework 4.6.2.

    El cumplimiento de este estándar más elevado para la seguridad solo se aplica a la versión 9 de Dynamics 365 Customer Engagement (on-premises) en este momento. Si sus clientes están diseñados para conectarse a cualquier versión o tipo de implementación, puede preparar compilando de nuevo la aplicación para utilizar .NET Framework 4.6.2. Más información: Entrada de blog: Próximas actualizaciones de seguridad de conexión de Dynamics 365 Customer Engagement (on-premises)

  • Se admite cualquier ensamblado de .NET que se cree con Microsoft .NET Framework 4.6.2 para su uso en Dynamics 365 Customer Engagement (on-premises) como un ensamblado de complemento de Dynamics 365 Customer Engagement (on-premises) o como actividad de flujo de trabajo personalizado de Dynamics 365 Customer Engagement (on-premises).

  • Se admite cualquier visualización (gráfico) creada con .NET Framework 4.5.2 .

Más información: Visual Studio y .NET Framework

Personalizaciones no admitidas

Las modificaciones en Dynamics 365 Customer Engagement (on-premises) que se realizan sin usar los métodos descritos en esta documentación o las herramientas de Dynamics 365 Customer Engagement (on-premises) no se admiten y no se conservan durante las actualizaciones o mejoras de Dynamics 365 Customer Engagement (on-premises). No se admite nada que no esté reflejado en esta documentación y en los documentos relacionados. Además, las modificaciones no admitidas podrían provocar problemas cuando se actualice a través de la instalación de revisiones o Service Packs, o mejoras de Dynamics 365 Customer Engagement (on-premises). Para reducir al mínimo los problemas de actualización y mejoras, no modifique ningún archivo de Dynamics 365 Customer Engagement (on-premises) que no haya creado usted mismo.

Esta es una lista de los tipos de acciones no admitidas por los que recibimos preguntas frecuentes:

  • Modificaciones en cualquier archivo .aspx, .css, .htm, .js, .xml, .jpg o .gif o la adición de archivos en los wwwroot directorios de la aplicación Dynamics 365 Customer Engagement (on-premises), Dynamics 365 Customer Engagement (on-premises) o Dynamics 365 Customer Engagement (on-premises) ubicados en Archivos de programa\Dynamics 365 Customer Engagement (on-premises). Sin embargo, si ha realizado cambios en estos archivos, estos archivos se comprueban para determinar si existen modificaciones y no se sobrescribirán.

  • Modificaciones en el sitio web de Dynamics 365 Customer Engagement (on-premises) (configuración del archivo y del sitio web). Las aplicaciones personalizadas se deben instalar en un sitio web diferente. Entre las modificaciones no admitidas se incluyen cambios en las listas de control de acceso (ACL) del sistema de archivos de cualquier archivo en Dynamics 365 Server.

  • El uso de certificados de cliente no es compatible. Si configura el sitio web de Dynamics 365 Customer Engagement (on-premises) para solicitar certificados de cliente de IIS, recibe errores de autenticación para cualquier aplicación que se hubiera desarrollado con el SDK.

  • Modificaciones en el esquema físico de la base de datos, que no sean agregar o actualizar índices. Dichas modificaciones incluyen cualquier acción realizada en la base de datos sin usar las capacidades de personalización del sistema en la aplicación web o usar las API de metadatos que se describen en esta documentación de SDK. No se admite la modificación de tablas, procedimientos almacenados ni vistas en la base de datos. Tampoco se admite que se agreguen tablas, procedimientos almacenados ni vistas a la base de datos debido a problemas de integridad referencial o actualización. En el caso de las implementaciones locales de Dynamics 365 Customer Engagement (on-premises), se admite la adición de índices según las directrices de la documentación de Implementar y administrar Microsoft Dynamics 365 Customer Engagement (on-premises). Estas restricciones se aplican a todas las bases de datos de Dynamics 365 Customer Engagement (on-premises) y a la base de datos local de Dynamics 365 for Outlook.

    Importante

    Cuando modifica la base de datos sin usar los métodos compatibles para la personalización del sistema, corre el riesgo de que se presenten problemas durante la instalación de actualizaciones y mejoras.

  • Cambios de datos (registros) en la base de datos de Dynamics 365 Customer Engagement (on-premises) con comandos de SQL o cualquier tecnología que no sea la que se describe en esta documentación.

  • Hacer referencia a las bibliotecas de vínculos dinámicos (DLL) de Dynamics 365 Customer Engagement (on-premises) que no sean las que se enumeran aquí:

    • Microsoft.Crm.Outlook.Sdk.dll
    • Microsoft.Crm.Sdk.Proxy.dll
    • Microsoft.Xrm.Sdk.dll
    • Microsoft.Xrm.Sdk.Data.dll
    • Microsoft.Xrm.Sdk.Deployment.dll
    • Microsoft.Xrm.Sdk.Workflow.dll
    • Microsoft.Xrm.Tooling.Connector.dll
    • Microsoft.Xrm.Tooling.CrmConnectControl.dll
    • Microsoft.Xrm.Tooling.PackageDeployment.CrmPackageExtentionBase.dll
    • Microsoft.Xrm.Tooling.WebResourceUtility.dll

  • El uso de interfaces de programación de aplicaciones (API) que no sean las API documentadas en los servicios web: API web, servicio de organización, servicio de implementación, servicio de detección y servicio de datos de la organización.

  • Para lograr el aspecto y el comportamiento de Dynamics 365 Customer Engagement (on-premises), la reutilización de cualquier control de interfaz de usuario de Dynamics 365 Customer Engagement (on-premises), incluidos los controles de cuadrícula. Estos controles se pueden cambiar o sobrescribir durante una actualización. No se recomienda usar ni modificar el archivo Default.css en la carpeta de instalación raíz de Dynamics 365 Customer Engagement (on-premises).

  • La reutilización de cualquier código JavaScript de Dynamics 365 Customer Engagement (on-premises), incluidos los comandos de la cinta de opciones. Este código puede cambiar o sobrescribirse durante una actualización.

  • Las modificaciones a cualquiera de los formularios de Dynamics 365 Customer Engagement (on-premises) o agregar nuevos formularios, como páginas .aspx personalizadas, directamente en Office Outlook o realizar cambios en archivos .pst. Estos cambios no se actualizan.

  • Realizar personalizaciones excepto cuando se usan las herramientas admitidas de Dynamics 365 Customer Engagement (on-premises) disponibles sin conexión en Dynamics 365 for Outlook.

  • El uso de HttpModules personalizados para insertar HTML/DHTML en los formularios de Dynamics 365 Customer Engagement (on-premises).

  • No se admite la creación de un ensamblado de complementos para un ensamblado de Dynamics 365 Customer Engagement (on-premises) estándar (Microsoft.Crm.*.dll) ni realizar una actualización o eliminar un pluginassembly creado en una plataforma.

  • No se admite la creación de una aplicación de Internet Information Services (IIS) dentro del sitio web de Dynamics 365 Customer Engagement (on-premises) para cualquier VDir y específicamente dentro de la carpeta ISV. La carpeta <crmwebroot>\ISV ya no es compatible.

  • No se admite la edición de un archivo de solución para editar cualquiera de los componentes de la solución que no sean las cintas de opciones, los formularios, SiteMap o las consultas guardadas. Para obtener más información, consulte Soporte para editar el archivo de personalización. No se admite la definición de nuevos componentes de la solución mediante la edición del archivo de solución. No se admite la edición de los archivos de recursos web exportados con una solución. Excepto por los pasos que se documentan en Mantener soluciones administradas, no se admite la edición del contenido de una solución administrada.

  • No se admite el almacenamiento en caché de la biblioteca de aplicaciones de Silverlight.

  • No se admite la visualización de un formulario de entidad dentro de un IFrame incrustado en otro formulario de entidad.

  • Los ensamblados de Workflow y de complemento deben contener toda la lógica necesaria dentro del dll respectivo. Los complementos pueden hacer referencia a algunos ensamblados .NET principales. Sin embargo, no se admiten las dependencias de ensamblados .NET que interactúen con las APIs de Windows de bajo nivel, como la interfaz de diseño gráfico. Anteriormente, Dynamics 365 Customer Engagement permitía que los ensamblados hicieran referencia a estas interfaces, pero para cumplir nuestros estándares de seguridad, son necesarios cambios en este funcionamiento.

Consulte también

Elegir su estilo de desarrollo para código administrado
Escribir código para Dynamics 365 Customer Engagement (on-premises) (servicios web)
Ejemplo de script en aplicaciones de Customer Engagement (on-premises) mediante JavaScript

  • Last updated on