En nuestra última sesión de Power Platform Barcelona, nos adentramos de lleno en el terreno Pro-Code para hablar de robustez, extensibilidad y buenas prácticas en la plataforma. De la mano de Cristian Fernández (MVP de Microsoft y fundador de Creativity Park y miembro de Power Platform Barcelona), junto al resto del equipo de la comunidad, analizamos a fondo el papel de las Custom APIs en Dataverse y cómo acelerar su adopción gracias a la IA y a proyectos de código abierto como SparkCode.

Si te perdiste el directo o quieres repasar los puntos clave, aquí te dejamos el resumen completo de la sesión.

1. Perder el miedo al código (y el papel de la IA)

Dataverse y Power Platform ofrecen un potencial low-code enorme, pero tarde o temprano los proyectos complejos tocan techo y requieren lógica de negocio avanzada. Históricamente, el mundo Pro-Code ha generado cierta barrera de entrada, pero el panorama ha cambiado radicalmente:

  • Asistencia con IA: El uso de asistentes de código (como GitHub Copilot o Claude) reduce la curva de aprendizaje a mínimos históricos. Escribir la estructura básica de una clase en C# y delegar la lógica algorítmica es hoy cuestión de minutos.

  • Buenas prácticas no negociables: Como recalcamos en la sesión, el código compilado que sube a Dataverse (la DLL) no conserva el código fuente. Todo desarrollo debe vivir en un repositorio (GitHub, Azure DevOps). Confiar en descompilar ensamblados mediante herramientas externas es una fuente constante de deuda técnica y dolores de cabeza.

2. Custom API vs. Plugin: la diferencia fundamental

Una de las dudas más habituales al empezar es distinguir cuándo utilizar un Plugin tradicional y cuándo optar por una Custom API:

Concepto Plugin Custom API
Invocación Reactiva: Se dispara ante eventos de Dataverse (Create, Update, Delete, RetrieveMultiple...). Bajo demanda: Se invoca explícitamente mediante una llamada (desde cliente, API o flujo).
Punto de ejecución Pipeline de ejecución de Dataverse. Expuesto directamente en el endpoint Web API de Dataverse.
Contexto de tabla Habitualmente ligado a la entidad del mensaje. Puede ser vinculada (bound) a una tabla específica o desvinculada (unbound) para utilidad global.

Ambos comparten el 95% de su estructura en .NET (heredan de IPlugin e implementan el método Execute), pero la Custom API actúa como un servicio propio alojado dentro de tu tenant.

¿Desde dónde se pueden invocar?

  • Power Automate: A través de la acción «Realizar una acción enlazada / independiente» (Perform an unbound action) del conector de Dataverse.

  • Canvas Apps: Mediante Power Fx utilizando el objeto/tabla Environment.

  • Workflows clásicos: Siguen soportados y permiten extender procesos heredados.

  • Agentes y Copilot Studio: Vía HTTP o mediante acciones de Dataverse, lo que permite ejecutar operaciones complejas en el backend evitando consumo innecesario de créditos generativos.

  • Código externo: Directamente atacando la Web API de Dataverse desde aplicaciones cliente, Azure Functions o herramientas como Postman.

(Nota sobre licencias: Al ejecutarse y residir en el backend de Dataverse, invocar una Custom API desde flujos o Canvas Apps requiere licenciamiento Premium).

Esquema custom api dataverse

 

3. SparkCode: el framework para no reinventar la rueda

Así como en otros ámbitos de la ingeniería de software no se programa un motor desde cero para cada proyecto, en Dataverse tampoco deberíamos picar las mismas utilidades una y otra vez.

Cris presentó SparkCode (CreativitySpark/Spark-Code), una librería open-source pensada para importar como solución administrada y disponer de un catálogo listo para usar de Custom APIs categorizadas:

  1. Gestión de Datos y Conversiones:

    • Parseo directo de archivos CSV a JSON sin bucles interminables en Power Automate.

    • Consultas avanzadas con JSON Query para filtrar y transformar payloads complejos en un solo paso.

    • Conversiones de tipos (texto a número, fechas) para entornos donde las expresiones nativas se quedan cortas.

  2. Operaciones avanzadas sobre Dataverse:

    • Forzar refresco de columnas Rollup: Ejecutar el recálculo asíncrono de un campo calculado bajo demanda de forma inmediata.

    • Ejecución de SQL: Ideal para cruces masivos de datos (joins) donde FetchXML impone limitaciones o penaliza el rendimiento.

    • Conteo de registros de FetchXML y publicación de recursos web.

  3. Manipulación de ficheros y PDFs (On-Tenant):

    • Extracción de imágenes y rangos de páginas de documentos PDF (pasados en Base64).

    • Al ejecutarse como Custom API en el propio servidor de Dataverse, evita enviar documentación confidencial a servicios o APIs externas, resolviendo requerimientos estrictos de seguridad y cumplimiento normativo.

  4. El motor de plantillas (Liquid / Fluid):

    • Permite desacoplar el diseño HTML de las notificaciones respecto a los flujos de Power Automate.

    • A través de un recurso web HTML con sintaxis Liquid (similar a Power Pages / Shopify) y la librería Fluid, la API rellena automáticamente los campos del registro indicado, variables de entorno, la URL del entorno, logos o resultados de un FetchXML en un solo bloque renderizado.

4. Recursos y comunidad

El proyecto es de código abierto, incluye pruebas unitarias para cada componente y suites de test listas para desplegar:

  • Repositorio en GitHub: CreativitySpark/Spark-Code

  • Descarga e instalación: Disponible en la sección de Releases como solución administrada.

  • Contribuciones: La comunidad está abierta a Pull Requests; si tienes una Custom API que solucione una casuística común, ¡puedes sumarla al framework!