Extensiones admitidas

  • Artículo

Puede personalizar Dynamics 365 Customer Engagement (on-premises) con las herramientas disponibles en la aplicación web de Dynamics 365 Customer Engagement (on-premises) o con aquellas que se describen en los 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 MSDN o este, pero podrían no ser actualizables.

Personalizaciones con la aplicación web de Dynamics 365 Customer Engagement (on-premises)

Hay una variedad de herramientas que se incluyen con Dynamics 365 Customer Engagement (on-premises) que puede utilizar para personalizarlo. Las personalizaciones realizadas con las herramientas y la aplicación web de Dynamics 365 Customer Engagement (on-premises) son completamente compatibles y se pueden actualizar por completo.

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 utilizando el SDK de Dynamics 365 Customer Engagement (on-premises)

Los servicios web de Dynamics 365 Customer Engagement, artículos técnicos y el código de ejemplo publicado en este sitio, así como la información publicada por el equipo de soporte técnico para desarrolladores de Dynamics 365 Customer Engagement (on-premises) se incluyen en el área de personalizaciones usando los servicios los 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 tema.

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

El uso de los servicios web es completamente compatible. Esto incluye: servicio de detección, servicio de organización, 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 las características adicionales. Los atributos de entidad también pueden cambiar en versiones futuras. Para obtener más información, consulte Escribir código para Dynamics 365 Customer Engagement (on-premises) (servicios Web).

JavaScript del lado del cliente

Puede usar JavaScript dentro de 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 elemento de Document Object Model (DOM) de ninguna de las páginas 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 de cliente en Customer Engagement (on-premises) usando JavaScript

    Puede abrir Dynamics 365 Customer Engagement (on-premises) formularios, vistas, cuadros de diálogo e informes con los métodos que se explican en apertura de 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 utilizados 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.

Complementos

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), incluidas las implementaciones locales, IFD y en línea. Sin embargo, los complementos solo se pueden registrar y ejecutar en el espacio aislado (modo aislado) 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 las implementaciones locales, IFD y en línea de Dynamics 365 Customer Engagement (on-premises). Sin embargo, las actividades de flujo de trabajo personalizadas solo se pueden registrar y ejecutar en el espacio aislado (modo aislado) 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 únicamente para las implementaciones locales e IFD de Dynamics 365 Customer Engagement (on-premises). Más información: Automatización de procesos empresariales en Customer Engagement (on-premises)

Compatibilidad con las versiones de .NET Framework

A continuación se describen las consideraciones sobre compatibilidad del código personalizado escrito con Microsoft .NET Framework 4.6.2..

  • Cualquier cliente de servicio web creado con Microsoft .NET Framework 4.6.2. o posterior que llama a los servicios web de Dynamics 365 Customer Engagement (on-premises) es completamente compatible en 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 Dynamics 365 Customer Engagement (on-premises) versión 9, solo podrán conectar las aplicaciones que utilizan Seguridad de capa 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.

    La aplicación de esta norma de seguridad más estricta sólo se aplicará a Dynamics 365 Customer Engagement (on-premises) versión 9 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 admiten todos los ensamblados .NET creados con Microsoft .NET Framework 4.6.2. para usar en Dynamics 365 Customer Engagement (on-premises) como un ensamblado de complemento de Dynamics 365 Customer Engagement (on-premises) o como una actividad de flujo de trabajo personalizada de Dynamics 365 Customer Engagement (on-premises).

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

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 Dynamics 365 Customer Engagement (on-premises) no se admiten ni se mantienen durante la instalación de 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, los Service Pack 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.

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

  • Modificaciones en los archivos .aspx, .css, .htm, .js, .xml, .jpg o .gif o la incorporación de archivos en los directorios wwwroot de la aplicación Dynamics 365 Customer Engagement (on-premises), las herramientas de Dynamics 365 Customer Engagement (on-premises) o los archivos de 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 el sitio web). Las aplicaciones personalizadas se deben instalar en un sitio web diferente. Esto incluye las modificaciones 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, recibirá 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. Esto abarca 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. Para las implementaciones locales de Dynamics 365 Customer Engagement (on-premises), se admite la operación de agregar índices según las directrices que se especifican en la documentación Implementación y administración de Microsoft Dynamics 365 Customer Engagement (on-premises). Esto se aplica a todas las bases de datos de Dynamics 365 Customer Engagement (on-premises) y 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 cualquier biblioteca de vínculos dinámicos (DLL) de Dynamics 365 Customer Engagement (on-premises) que no sean las siguientes:

    • 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 conseguir la apariencia y el comportamiento de Dynamics 365 Customer Engagement (on-premises), la reutilización de cualquiera de los controles de la 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 actualizarán.

  • 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 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 ningún 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, el mapa del sitio 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 puede mostrar un formulario de entidad en 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.

Vea también

Elegir su estilo de desarrollo para código administrado
Escribir código para Dynamics 365 Customer Engagement (on-premises) (servicios web)
Scripting del cliente en Customer Engagement (on-premises) con JavaScript