Share via

Extensiones admitidas para Microsoft Dynamics 365

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Puede personalizar Microsoft Dynamics 365 (en línea y local) con las herramientas disponibles en la aplicación web de Microsoft Dynamics 365 o con aquellas que se describen en SDK de Microsoft Dynamics 365. 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 Microsoft Dynamics 365. Para obtener más información, vea Personalizaciones no admitidas.

Los temas que se tratan en los artículos técnicos publicados en MSDN en el Centro para programadores de CRM de MSDN están admitidos, pero es posible que no se pueden actualizar.

En este tema

Personalizaciones con la aplicación web de Microsoft Dynamics

Personalizaciones utilizando el SDK de Microsoft Dynamics 365

Compatibilidad con las versiones de .NET Framework

Personalizaciones no admitidas

Personalizaciones con la aplicación web de Microsoft Dynamics

Hay una variedad de herramientas que se incluyen con Microsoft Dynamics 365 que puede utilizar para personalizarlo. Las personalizaciones realizadas con las herramientas y la aplicación web de Microsoft Dynamics 365 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 de Microsoft Dynamics CRM 2016 y Microsoft Dynamics CRM Online.

Personalizaciones utilizando el SDK de Microsoft Dynamics 365

El SDK de Microsoft Dynamics 365, los artículos técnicos y el código de ejemplo publicados en el Centro para programadores de Microsoft Dynamics CRM, y la información publicada por el equipo de soporte técnico para programadores de Microsoft Dynamics 365 se incluyen en el área de personalización mediante SDK de Microsoft Dynamics 365. Las acciones y niveles específicos de compatibilidad y capacidad de actualización se describen más adelante en este tema.

SDK de Microsoft Dynamics 365

El uso de los servicios web es completamente compatible. Esto incluye: DiscoveryService, OrganizationService, Organization Data Service, el extremo de OData, el extremo de SOAP para aplicaciones modernas y el DeploymentService. 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, vea Amplíe Microsoft Dynamics 365 en el servidor y Administrar la implementación mediante el servicio web de implementación.

JavaScript del lado del cliente

Puede usar JavaScript dentro de Microsoft Dynamics 365 (en línea y local) 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> (RibbonDiffXml) o <JavaScriptFunction> (RibbonDiffXml) 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 Microsoft Dynamics 365 solo se deben realizar por medio de los métodos con los espacios de nombres Xrm.Page o Xrm.Utility documentados en Referencia de programación del lado del cliente. No se admite el acceso directo al elemento de Document Object Model (DOM) de ninguna de las páginas de aplicación de Microsoft Dynamics 365. No se recomienda el uso de jQuery en los scripts y comandos de formularios.Más información:b7840a25-f25e-409b-8b6a-0ef04c7ed9c4#BKMK_UsingjQuery

Puede abrir los formularios, las vistas, los diálogos y los informes de Microsoft Dynamics 365 con los métodos documentados en Abrir formularios, vistas, diálogos 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 Microsoft Dynamics 365; 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 SDK de Microsoft Dynamics 365. 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.

Los cambios en el archivo Customizations.xml deben cumplir el esquema de CustomizationsSolution.xsd. Para obtener más información, vea Schemas used in Microsoft Dynamics 365.

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 SDK de Microsoft Dynamics 365 es completamente compatible y se puede actualizar. Esta característica está disponible para todas las implementaciones de Microsoft Dynamics 365, 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 Microsoft Dynamics 365 (online).Más información:Escriba complementos para ampliar los procesos de negocio

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 Microsoft Dynamics 365.

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 Microsoft Dynamics 365. Sin embargo, las actividades de flujo de trabajo personalizadas solo se pueden registrar y ejecutar en el espacio aislado (modo aislado) de Microsoft Dynamics 365 (online).Más información:Automatizar procesos de negocio mediante proceso de Dynamics 365

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 Microsoft Dynamics 365.Más información:Automatizar procesos de negocio mediante proceso de Dynamics 365

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.5.2.

Cualquier cliente de servicio web creado con Microsoft .NET Framework 4.5.2 que llama a los servicios web de Microsoft Dynamics 365 es completamente compatible en Microsoft Dynamics 365.

Se admiten todos los ensamblados .NET creados con Microsoft .NET Framework 4.5.2 para usar en Microsoft Dynamics 365 como un ensamblado de complemento de Microsoft Dynamics 365 o como una actividad de flujo de trabajo personalizada de Microsoft Dynamics 365.

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

Personalizaciones no admitidas

Las modificaciones en Microsoft Dynamics 365 que se realizan sin usar las herramientas de SDK de Microsoft Dynamics 365 o de Microsoft Dynamics 365 no se admiten ni se mantienen durante la instalación de actualizaciones o mejoras de Microsoft Dynamics 365. No se admite nada que no esté documentado en el SDK de Microsoft Dynamics 365 y 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 Microsoft Dynamics 365. Para reducir al mínimo los problemas de actualización y mejoras, no modifique ningún archivo de Microsoft Dynamics 365 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 Microsoft Dynamics 365, las herramientas de Microsoft Dynamics 365 o los archivos de Microsoft Dynamics 365 ubicados en Archivos de programa\Microsoft Dynamics 365. 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 Microsoft Dynamics 365 (configuración del archivo y el sitio web). Las soluciones 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 el servidor de Microsoft Dynamics 365.

  • El uso de certificados de cliente no es compatible con SDK de Microsoft Dynamics 365. Si configura el sitio web de Microsoft Dynamics 365 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 Microsoft Dynamics 365, 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 CRM. Esto se aplica a todas las bases de datos de Microsoft Dynamics 365 y la base de datos local de Microsoft Dynamics 365 para Outlook.

    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 Microsoft Dynamics 365 con comandos de SQL o cualquier tecnología que no sea la que se describe en SDK de Microsoft Dynamics 365.

  • Hacer referencia a cualquier biblioteca de vínculos dinámicos (DLL) de Microsoft Dynamics 365 que no sean las siguientes:

    • Microsoft.Xrm.Sdk.dll

    • Microsoft.Crm.Sdk.Proxy.dll

    • Microsoft.Xrm.Sdk.Workflow.dll

    • Microsoft.Xrm.Sdk.Deployment.dll

    • Microsoft.Crm.Outlook.Sdk.dll

    • Microsoft.Crm.Tools.EmailProviders.dll

  • El uso de interfaces de programación de aplicaciones (API) que no sean las API documentadas en los servicios web DeploymentService, DiscoveryService, servicio de datos de la organización, extremo SOAP para recursos web y OrganizationService.

    Para conseguir la apariencia y el comportamiento de Microsoft Dynamics 365, la reutilización de cualquiera de los controles de la interfaz de usuario de Microsoft Dynamics 365, 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 Microsoft Dynamics 365.

  • La reutilización de cualquier código JavaScript de Microsoft Dynamics 365, 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 Microsoft Dynamics 365 o agregar nuevos formularios, como páginas .aspx personalizadas, directamente en Microsoft Office Outlook o realizar cambios en archivos .pst. Estos cambios no se actualizarán.

  • Realizar personalizaciones, excepto cuando se usan las herramientas admitidas de Microsoft Dynamics 365 disponibles sin conexión en Dynamics 365 para Outlook.

  • El uso de HttpModules personalizados para insertar HTML/DHTML en formularios de Microsoft Dynamics 365.

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

  • No se admiten los complementos ni las actividades de flujo de trabajo personalizadas de Microsoft Dynamics CRM 4.0.

  • No se admite el extremo de servicio (extremo de 2007) de Microsoft Dynamics CRM 4.0.

  • No se admite la creación de una aplicación de Internet Information Services (IIS) dentro del sitio web de Microsoft Dynamics 365 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, vea Cuándo modificar el archivo de personalizaciones. 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 mostrar un formulario de entidad en un IFrame incrustado en otro formulario de entidad.

Ver también

Elegir su estilo de desarrollo para Dynamics 365
Amplíe Microsoft Dynamics 365 en el servidor
Escriba código para formularios de Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright