Estoy seguro de que muchos de nosotros hemos tenido que desarrollar algún tipo de librería en .NET para solucionar algo en Dynamics 365 Finance and Operations. Creas un proyecto de C#, lo compilas y añades la referencia en tu proyecto de FnO. ¡Ya no tienes que hacer eso! Puedes añadir el proyecto a tu repositorio de código, compilarlo en tu pipeline y ¡la DLL se añade al deployable package!

He estado haciendo estas pruebas a raíz de una conversación en Yammer, y a pesar de que he conseguido compilar .NET y X++ en la misma pipeline sin problemas, he encontrado algun problema o limitación.

Si quieres leer más sobre builds, releases y el ALM de desarrollo de Dynamics 365 puedes leer mi guía sobre MSDyn365 y Azure DevOps ALM.

Compila .NET en tu pipeline

Nota: lo que muestro aquí está hecho con la pipeline hospedada en Azure pero debería ser posible hacerlo con el agente self-hosted (la vieja máquina de build vaya).

El paso de compilar de las pipelines llama a msbuild.exe que también puede compilar .NET. Si comprobamos los logs del paso lo veremos:

msbuild.exe builds C# projects and our X++ ones too!
msbuild.exe compila proyectos de C# y los de X++ también!

Hay que recordar que X++ es ahora parte de la familia de .NET… un primo segundo o algo asi.

Añade y compila proyectos .NET a tu pipeline de Dynamics 365 2
Carpeta Build

Si has leído mi post sobre las builds hospedadas en Azure habréis visto que pongo las soluciones que referencian todos mis modelos en una carpeta llamada Build en la raíz de mi árbol de código (imágen izquierda).

Esto es solo una preferencia personal que me ayuda a mantener los archivos .config y la solución que uso para compilar los modelos en un sitio único.

Al usar una solución y decirle al proceso de build que use sólo esa tengo todo más bajo control.

Añadir un proyecto de C# a FnO

El primer paso será crear un proyecto de Finance and Operations. Cuando lo tengamos hacemos clic derecho en la solución y seleccionamos «Add new project». Luego seleccionamos un proyecto de tipo Visual C# y Class Library:

Añade y compila proyectos .NET a tu pipeline de Dynamics 365 3
Proyecto de C# en Dynamics 365
Añade y compila proyectos .NET a tu pipeline de Dynamics 365 4

Ahora deberíamos tener una solución con un proyecto de FnO y otro de C# (imágen derecha).

Para hacer esta demo crearé una clase llamada Calculator con un único método con 2 parámetros de tipo decimal que devuelve su suma. Un método suma.

Ahora compilamos el proyecto de C# únicamente, no toda la solución. Esto creará la DLL en la carpeta bin del proyecto. Tenemos que hacerlo antes de añadir la referencia al proyecto de Dynamics 365.

Hacemos click derecho en el nodo References del proyecto de FnO y seleccionamos «Add Reference…»:

Añade y compila proyectos .NET a tu pipeline de Dynamics 365 5
Añadimos una referencia al proyectro de FnO

Se abrirá una ventana y tendríamos que ver el proyecto de C# en la pestaña «Projects»:

Añade y compila proyectos .NET a tu pipeline de Dynamics 365 6
Añadir referencia de C# a un proyecto de Dynamics 365

Lo seleccionamos y hacemos clic en el botón Ok. Esto añadirá el proyecto de C# como referencia a nuestro proyecto de FnO, pero todavía tenemos que hacer una cosita o la pipeline no compilará. Tenemos que añadir a mano la referencia que acabamos de crear. Así que hacemos clic derecho en la referencia y seleccionamos «Add to source control»:

Añade y compila proyectos .NET a tu pipeline de Dynamics 365 7
Añadimos la referencia al control de código

En el proyecto de FnO añadimos una Runnable Class, llamaremos a la librería de C# ahí:

Añadimos la solución al control de código si no lo hemos hecho y nos aseguramos que todos los objetos están añadidos también antes de hacer el check-in.

Build pipeline

Si voy a mi repositorio de Azure DevOps veremos esto:

Añade y compila proyectos .NET a tu pipeline de Dynamics 365 8
Proyectos y objetos

Podéis ver que he puesto la solución en la carpeta Build. Como decía al principio esto es mi preferencia personal, y lo hago para tener las soluciones que se usan para compilar el código bajo control y ordenaditas.

En mi pipeline de build me aseguro de que estoy usando esa solución:

Añade y compila proyectos .NET a tu pipeline de Dynamics 365 9
Compilar solución de Dynamics 365

Ejecuto la pipeline y cuando termina podemos ver una línea en el log del paso de compilar en la que pone:

Y si nos descargamos el DP, lo descomprimimos, vamos a AOSService\Packages\files y descomprimimos el archivo que hay ahí y abrimos su carpeta bin, veremos nuestra DLL:

Añade y compila proyectos .NET a tu pipeline de Dynamics 365 10
¡Victoria!

¡Trabajo hecho!

Cosas que no me gustan/entiendo/tengo que investigar

Siempre he hecho esto con una única solución y un único proyecto de C#. Tengo algunas dudas sobre cómo funcionará esto con varios proyectos de C#, modelos, soluciones, etc.

Por ejemplo, si un modelo tiene una dependecia de una DLL, pero se compila antes que se genere la DLL, la compilación fallará. Estoy seguro que hay una forma de resolver estas dependencias igual que la hay para las dependencias entre proyectos de FnO dentro de una solución.

O igual podría intentar compilar todo el código C#/.NET primero, empaquetarlo en un nuget y usar las DLLs más tarde en la build de FnO, algo parecido a lo que explica Paul Heisterkamp en su blog.

De todas formas, es vuestra elección el decidir como gestionar vuestros proyectos de C# y qué solución se ajusta más a vuestra forma de trabajar, pero por lo menos ya tenéis algo por lo que empezar 🙂

¡Suscríbete!

Recibe un correo cuando se publique un nuevo post

Write A Comment

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.

¡NO sigas este enlace o serás bloqueado en este sitio!