Tutorial: Escribir, implementar y depurar código X++

La experiencia de desarrollador unificada para aplicaciones financieras y operativas le permite escribir código en su computadora de desarrollo local y ejecutarlo dentro de un servicio en la nube. Existe una separación de funcionalidad entre estos dos niveles (local y en la nube).

• Nivel de desarrollo: contiene los metadatos de finanzas y operaciones y cualquier código fuente X++ en su computadora de desarrollo local
• Nivel de ejecución: sitio alojado en la nube que almacena los datos comerciales y ejecuta código X++

En este artículo se muestra cómo:

1. Escribir y compilar una clase X++ ejecutable
2. Implementar la clase en el tiempo de ejecución de la nube
3. Depurar el código X++ implementado

Comencemos desarrollando una clase X++ ejecutable para usarla como ejemplo. La única tarea de la clase es registrar un mensaje en el Infolog. Lo importante aquí no es lo que hace la clase ejecutable, sino cómo la compilamos, ejecutamos y depuramos. Si desea obtener más información sobre el lenguaje X++, consulte la referencia de programación.

Requisitos previos

Debería tener acceso a un entorno de desarrollador unificado, las herramientas de extensiones de Visual Studio instaladas y configuradas en su máquina de desarrollador y conectadas al mismo entorno. Es importante mantener los cambios de metadatos en su máquina de desarrollador implementados en el entorno conectado. Más información : Instalar y configurar herramientas de desarrollo

Crear un modelo

Empezamos por crear un modelo en Visual Studio.

1. Inicie Visual Studio y elija Continuar sin codigo.

2. Elija la opción del menú Extensiones>Dynamics 365>Gestión de modelos>Crear modelo.... Si no ve esta opción de menú, no tiene la extensión requerida de Visual Studio instalada.

3. Ingrese un nombre de modelo de "MyTestModel" cuando se lo solicite el formulario, proporcionando información relevante para el resto de la información requerida.

   

4. En el siguiente paso del formulario, elija Crear nuevo paquete.

   

5. Elija todos los modelos referenciados. Solo necesita especificar dependencias en los paquetes Application Platform y Application Foundation en este ejemplo trivial.

   

6. Seleccione Próximo varias veces hasta que se haya creado el paquete.

Agregar y compilar la clase X++ ejecutable

Crear un proyecto y una clase X++ en Visual Studio siguiendo estos pasos.

1. Crear un proyecto en Visual Studio que contiene la clase ejecutable. El nombre de la clase no es importante aquí. Para este ejercicio, mantenga el nombre predeterminado que es FinanceOperations3.
2. Agregue una clase ejecutable al proyecto en Explorador de soluciones haciendo clic derecho en el proyecto y eligiendo Agregar>Nuevo elemento.
3. Seleccione una Clase ejecutable en el menú Código en Elementos de Dynamics 365 y llámelo "MyRunnableClass". Visual Studio abre una ventana con la plantilla para una clase ejecutable que proporciona un método main estático que se llama mientras se ejecuta la clase ejecutable.
4. Agregue el siguiente código X++ al método main. Dado que aquí solo proporcionamos una implementación de token, agregue una llamada para registrar un mensaje de cadena en el registro de información:

internal final class MyRunnableClass
{
    public static void main(Args _args)
    {
        Info('Hello World from the Server Side');
    }
}

Compile la clase para asegurarse de no haber introducido ningún error en este código. La compilación se realiza seleccionando Construir en el menú contextual del proyecto.

Implementar la clase

Todo el trabajo que hemos realizado hasta ahora se ha realizado del lado del cliente. El compilador X++ y las herramientas relacionadas se instalan localmente, junto con los metadatos que definen la aplicación que estás desarrollando. En Visual Studio, puede usar el elemento de menú Configurar metadatos para administrar la configuración con la que está trabajando.

Ahora ha llegado el momento de ejecutar el código y, para ejecutarlo, debe implementar el código en el nivel del servidor (nube). Para esta operación, utilice el elemento de menú en Extensión>Dynamics 365>Implementar>Implementar modelos en un entorno en línea. El cuadro de diálogo que aparece le permite seleccionar los paquetes que desea implementar. En este caso, debe seleccionar "MyTestModel". Puede encontrar fácilmente ese modelo utilizando el campo de búsqueda en la parte superior de la lista de paquetes. En la parte inferior del cuadro de diálogo, vea los paquetes a los que se hace referencia. Dado que estos paquetes son parte del código que envía Microsoft, no es necesario implementarlos porque ya están instalados en el nivel del servidor.

En este punto, está accediendo a punto de conexión en la nube, por lo que, a menos que ya haya iniciado sesión, es probable que necesite autenticarse y conectarse al entorno. Utilice sus credenciales de Microsoft Dataverse para conectarse a Dataverse y seleccione la solución con la que trabajar. Después de una breve espera, se completará la autenticación.

Puede seguir el progreso de la implementación navegando al menú desplegable "FinOps Cloud Runtime" en la ventana de salida de Visual Studio. Una vez que se complete la implementación, podrá ver la información de registro siguiendo el enlace que se muestra en la ventana de resultados.

Depurar el código implementado

Una vez que haya compilado el código del proyecto y lo haya subido a la nube punto de conexión, el binario estará listo para ejecutarse. Para verificar que todo está bien con el código de clase compilado, depúrelo.

1. En Visual Studio, configure las opciones de depuración para cargar los símbolos para su paquete y también para los paquetes ApplicationPlatform y ApplicationFoundation.

   Para configurar las opciones, comience abriendo las opciones del menú Extensiones y vaya a la pestaña de depuración. La página Depuración muestra opciones para cargar símbolos. Asegúrese de indicar que desea cargar los elementos de su solución y también los paquetes ApplicationFoundation y ApplicationPlatform.

2. Establezca un punto de interrupción en la línea donde llamamos al método Info y luego presione la flecha verde en la barra de herramientas, o use el método abreviado de teclado F5, para comenzar a depurar.

   Se abre una ventana del navegador con una URL que designa la clase ejecutable. Después de un rato, el navegador carga el formulario que muestra que el corredor de clases está activo y está ejecutando la clase MyRunnableClass. A continuación, el depurador carga los símbolos de su proyecto y la ejecución se detiene en el punto de interrupción.

3. Presione F5 para continuar la ejecución y luego vea que el panel Registro de información en Visual Studio muestra el mensaje que ingresamos en el Registro de información usando la llamada al método Info.

4. Actualice la ventana del navegador, que recarga la URL.

   Verá que el punto de interrupción se carga inmediatamente. El depurador todavía se está ejecutando y el mensaje de salida aparece por segunda vez en el registro de información sin reiniciar el depurador. Esta técnica es especialmente útil al ejecutar formularios. Siempre puede actualizar el navegador y el formulario se cargará nuevamente sin ningún retraso causado por la carga de los símbolos.

Probemos eso ahora. En lugar de volver a escribir tediosamente nuestro propio formulario, utilice un formulario que ya exista. Comience usando el formulario SysUserSetup que le permite configurar la coloración (tema) utilizada para representar los formularios. Cambiaremos la URL para abrir el formulario SysUserSetup en lugar de ejecutar la clase cambiando el elemento de menú (mi), esa parte que designa el elemento del menú para iniciar el corredor de clases. La URL terminará con algo similar a esto:

https://<environment>?prt=initial&debug=vs&activityid=\<unchanged>&cmp=DAT&mi=SysUserSetup

Ahora verá el formulario que le permite elegir los colores.

Ahora establezcamos un punto de interrupción en el formulario.

1. Abre el Explorador de aplicaciones desde el menú Ver.
2. Introduzca la cadena SysUserSetup type:"form" en la barra de búsqueda en la ventana del Explorador de aplicaciones.
3. Seleccione el formulario y seleccione Ver código para abrir el editor con el código fuente de este formulario.
4. De esa forma, establezca un punto de interrupción en el método selectionChange en el control ThemeChooser. Este código se activa cuando el usuario selecciona un nuevo tema de color.
5. En la ventana del navegador, seleccione uno de los cuadrados de colores, digamos el rojo. Llegarás al punto de ruptura.
6. Continúe la ejecución pulsando F10 o F5. Se golpea otro cuadrado de color y se activa nuevamente el punto de interrupción.
7. Puede observar a los locales, establecer nuevos puntos de interrupción y realizar diversas tareas de depuración.

Resumen

A modo de resumen, aquí hay un resumen y los puntos que se deben aprender de este ejercicio.

Empezamos usando Visual Studio para crear una clase ejecutable simple. Después de la compilación, el paquete debía enviarse a la nube punto de conexión para su ejecución. El código X++ solo se puede ejecutar en la nube, por lo que realizamos una operación de implementación. Una vez que se completó la implementación, ejecutamos el código estableciendo un punto de interrupción y ejecutando el depurador. Luego iniciamos un formulario desde el navegador y notamos que los puntos de interrupción se alcanzaban correctamente cuando se usaba el formulario, y no tuvimos que reiniciar el depurador para que eso sucediera. De hecho, el depurador se puede iniciar usando la opción Iniciar depurador en el menú Extensión. Luego puede ingresar una URL en el navegador, ejecutar el escenario para depurar y se alcanzarán los puntos de interrupción.

Consulte también

Experiencia de desarrollo unificada para finanzas y operaciones | Charla técnica Dynamics 365 FastTrack
Pruebas unitarias en la experiencia unificada del desarrollador
Crear y administrar entornos en el Power Platform Centro de administración
Administrar aplicaciones Dynamics 365