Compartir a través de


Prácticas de personalización compatibles y no compatibles

Los programadores que extiendan Dynamics 365 Customer Engagement (on-premises) tienen la responsabilidad de seguir las reglas y recomendaciones documentadas en el SDK: Prácticas recomendadas para desarrollar con Dynamics 365 Customer Engagement (on-premises). El SDK documenta las API disponibles para los desarrolladores y proporciona instrucciones sobre cómo usarlas mejor. Microsoft admite solo las API y prácticas documentadas en el SDK. Puede encontrar algo en Internet que describa cómo puede resolver un problema, pero si no usa las API documentadas en el SDK, no es compatible con Microsoft. Antes de que haga que un desarrollador aplique un cambio debe comprobar si usa métodos compatibles.

Si los programadores usan API y recomendaciones descritas en el SDK podemos estar seguros de comprobar si los cambios que realizamos en Customer Engagement tienen potencial para cancelar las personalizaciones existentes. Nuestro objetivo es que las personalizaciones de código escritas con métodos compatibles continuarán funcionando cuando las nuevas versiones o actualizaciones de aplicaciones Customer Engagement se publiquen. Es beneficioso porque puede actualizar a las nuevas versiones con las características mejoradas sin contar con programadores que cambien el código cada vez.

Si detectamos que un cambio en una nueva versión de aplicaciones Customer Engagement provocará que una personalización compatible se cancele, documentaremos cómo afecta e indicaremos cómo cambiar el código para corregirlo.

¿Que tipos de personalizaciones no se admiten con Dynamics 365 Customer Engagement (on-premises)?

Solo con que determinadas API y prácticas de programación no sean compatibles con Microsoft no significa que no funcionen. "No admitidas por Microsoft" significa exactamente lo que se indica: no puede obtener soporte técnico sobre estas API o prácticas de programación de Microsoft. No las probamos y no sabemos si algún cambio que hagamos puede cancelarlas. No podemos predecir qué sucederá si alguien cambia el código de su aplicación.

El programador que usa API y prácticas de programación no admitidas asume la responsabilidad para admitir su código. Deberán probar el código para asegurarse de que funciona.

Si elige usar personalizaciones no compatibles en la implementación de aplicaciones Customer Engagement debe asegurarse de documentar lo que hace y de tener una estrategia para quitar las personalizaciones antes ponerse en contacto con el soporte técnico de Dynamics 365 Customer Engagement (on-premises). Si necesita ayuda con personalizaciones no admitidas, póngase en contacto con el programador o la organización que las preparó.

Prácticas de personalización comunes no admitidas

La siguiente es una lista de prácticas de personalización habituales que no son compatibles. No se trata de una lista completa. Más información: Extensiones compatibles para Dynamics 365 Customer Engagement (on-premises): Personalizaciones no admitidas.

Interactuar con los elementos de Document Object Model (DOM) de la aplicación web mediante JavaScript
Cualquier biblioteca de JavaScript usada en cualquier lugar de la aplicación solo debe interactuar con API documentadas. Cuando los desarrolladores de JavaScript trabajan con aplicaciones que acceden con frecuencia a elementos DOM mediante nombres específicos. Puesto que Dynamics 365 Customer Engagement (on-premises) es una aplicación web, estas técnicas funcionan, pero es probable que se cancelen durante una actualización porque los nombres de los elementos a los que hacen referencia están sujetos a modificaciones en cualquier momento. Nos reservamos la derecha de realizar los cambios necesarios en la aplicación, lo que frecuentemente implica cambiar cómo se genera a la página. Agregar cualquier cambio que dependa de la estructura actual de la página significa que deberá invertir en probar y quizás en cambiar el código personalizado en estos scripts cada vez que aplique una actualización a la aplicación.

jQuery es una biblioteca muy común usada por los desarrolladores de JavaScript. El mayor beneficio de usar jQuery es que facilita a los desarrolladores el acceso y la creación de elementos DOM, que es exactamente lo que no se admite en las páginas de la aplicación de aplicaciones Customer Engagement. jQuery se recomienda cuando los desarrolladores están creando interfaces de usuario personalizadas con recursos web HTML, pero en las páginas de la aplicación de aplicaciones Customer Engagement, las API admitidas no requieren el uso de jQuery.

Usar objetos internos no documentados o métodos mediante JavaScript
Dynamics 365 Customer Engagement (on-premises) usa numerosos objetos de JavaScript dentro de las páginas. Un desarrollador de JavaScript puede descubrir estos objetos depurando una página y luego accediendo y reutilizando estos objetos. Nos reservamos el derecho de realizar los cambios necesarios en estos objetos, incluido eliminarlos o cambiar los nombres de los métodos. Si un script hace referencia a estos objetos, el script se interrumpirá si no se encuentran.

Vea también

Información general de creación y personalización de aplicaciones para Dynamics 365 for Customer Engagement (on-premises) versión 9