El documento describe cómo crear controles personalizados (custom controls) en Microsoft Dynamics 365 CRM. Explica que los custom controls permiten personalizar la forma en que se muestran los datos, más allá de los controles estándar. Luego detalla los pasos para crear un custom control desde cero, incluyendo la construcción del manifiesto, el archivo Typescript y la importación al CRM. El ejemplo creado muestra las estrellas de calificación de un cliente de forma gráfica en lugar de numérica.

1. - Mayo 2019
Desarrollo de Custom Controls
o qué hacer cuando el cliente
te pide unicornios
multicolores en CRM
Javier Conesa
Fátima Aouladali

3. Javier Conesa
• Consultor Dynamics 365 en Avanade
• LinkedIn: https://www.linkedin.com/in/javierconesa/
• Contacto: javier.conesa.sanchez@gmail.com

4. ÍNDICE
 ¿Qué es un Custom Control ?
 Agregar Custom Control estándar
 ¿Qué necesitamos para hacer un Custom Control ?
 Importación a CRM
 Configuración en CRM
 Custom Control en Acción

5. ¿Qué es un Custom Control ?
Actualmente en CRM los datos se visualizan con los controles
estándar.
Por ejemplo, los campos de texto o numéricos siempre se
muestran en cajas simples de HTML, o los campos de tipo
conjunto de valores se muestran como desplegables.
Los Custom Controls nos permiten modificar la manera en la
que se visualizan los datos, haciendo así más atractiva la
interfaz de usuario. Podemos personalizar cualquier campo
de CRM y darle el aspecto que queramos.

6. ¿Qué es un Custom Control ?
Este es un campo numérico para representar
con icono el valor del campo.
Este es un conjunto de opciones en la que
cada opción se añade un icono
Campo de línea de texto que dependiendo
del valor sale un icono u otro
Campo numérico al que se le añade porcentaje
y dependiendo del valor cambia de color
Campo de línea de texto que dependiendo
del nivel de adquisición cambia la dirección
de la flecha
Campo numérico para representar el
valor de forma gráfica

7. Agregar Custom Control estándar
1 2 3
4

8. ¿Qué necesitamos para hacer un
Custom Control?
Actualmente la funcionalidad que permite desarrollar
tus propios Custom Controls se encuentra en fase de
Public Preview, por lo tanto no se da soporte oficial a
estos componentes.
Se espera que para el final de verano, principios de
otoño, esta funcionalidad estará disponible dentro de
Dynamics 365 de manera definitiva.

9. ¿Qué necesitamos para hacer un
Custom Control?
• Visual Studio (desde la versión 2015)
• Conocimientos de TypeScript / JavaScript
• Manejo básico de XML para el archivo del Manifiesto
del Control
• Imágenes (opcionales)
• Hoja de estilos CSS (si procede)
• Archivos de recursos (opcionales)

10. Manos a la obra…
Vamos a ver como crear un Custom Control desde cero. El
Control lo hemos llamado “Estrellas de Colores”:
Este Control nos permitirá visualizar de manera gráfica el valor de
un cliente expresado en “estrellas” en vez de numéricamente.
El Control tendrá varios parámetros importantes:
- El número de estrellas a resaltar
- El número de estrellas totales a pintar
- El color de las estrellas
- El tipo de figura… por si las estrellas no nos convencen…

11. Construcción del manifiesto
Si el campo enlazado u otro parámetro puede ser de varios tipos
entonces, se crea un grupo de tipos que admitirá ese campo
Lo más importante en el archivo del manifiesto es el control
de versiones, cuando queramos una actualización del
control siempre hay que cambiar la versión en este atributo
Aquí se definen los parámetros que se
van a utilizar para recuperar los datos

12. Estos son los tipos de campos
disponibles para la definición de
los parámetros

13. Archivo Typescript
Para desarrollar el Custom Control los métodos
esenciales que han de ir en el archivo son:
• init
• updateView
• getOutputs
• destroy

16. Importación a CRM
Para añadir los Custom Control a dynamics se puede importar
un archivo .zip con los siguientes elementos:
• Solution.xml
• Customizations.xml
• Content_Type.xml
• Controls

17. Customization.xml

18. Solution.xml

19. Content_Type.xml

20. Configuración en CRM
Para insertar un Custom Control personalizado se ha de
configurar de la misma manera que un control estándar

21. Custom Controls en Acción

22. ¿ Preguntas ?
El Custom Control se
intentará subir (el
unicornio también)

24. Agradecimientos especiales
 Antonio Wimmer
 Anthony Lamas
 Beatriz Rodriguez
 Daniel Melendez
 Daniel Perez
 Fátima Aouladali
 Miguel Taranilla
 Sara de Andrés
 Tania Victoria
 Diego Pecharroman
 Juan Ramón Aparicio

25. ¡Muchas gracias!