Una actualización de plataforma también puede ser una oportunidad para limpiar código heredado. En Dynamics 365 Finance & Operations, los modificadores client y server de los métodos X++ ya no describen una elección entre dos capas de ejecución.
Qué está confirmado
Las notas oficiales de la plataforma 10.0.48 indican que estos modificadores generan advertencias y recomiendan quitarlos del código existente y no utilizarlos en desarrollos nuevos. Microsoft explica que respondían a la arquitectura de AX 2012 y que actualmente los métodos se ejecutan en el servidor. Consultar las notas oficiales de 10.0.48.
Alcance de esta guía: resolver las advertencias documentadas. No se afirma que se conviertan en errores de compilación en 10.0.50: esa fecha y ese comportamiento no han quedado confirmados con una fuente primaria en esta revisión.
Preparación
Trabaje sobre una rama de código y un ambiente de desarrollo con las herramientas de Dynamics 365 y la versión de compilador correspondiente. Conserve un resultado de compilación previo para comparar. Identifique qué modelos mantiene su equipo y cuáles pertenecen a terceros; para estos últimos, solicite una versión corregida al proveedor.
Procedimiento propuesto
- Localizar: revise las advertencias del compilador y busque las palabras completas
clientyserveren el código fuente de los modelos mantenidos. - Clasificar: confirme manualmente que cada coincidencia sea un modificador en la declaración de un método. Una coincidencia en un comentario, literal de texto o identificador no debe eliminarse automáticamente.
- Corregir: retire solo el modificador obsoleto. Mantenga el nombre, los parámetros, el tipo de retorno, la visibilidad, los demás modificadores y el cuerpo del método.
- Revisar: inspeccione las diferencias del control de versiones. Evite mezclar esta limpieza con cambios funcionales.
- Compilar: compile los modelos afectados y ejecute después la compilación habitual de integración. Compare advertencias y errores con la línea base.
- Validar: ejecute las pruebas de los procesos que utilizan esos métodos. Si intervienen procesos batch, incluya su ejecución en las pruebas.
Qué debe demostrar la revisión
- Los cambios se limitan a los modificadores identificados.
- Las advertencias asociadas desaparecen en los métodos corregidos.
- No aparecen errores nuevos atribuibles al cambio.
- Los escenarios funcionales seleccionados conservan sus resultados esperados.
Estas comprobaciones son una propuesta de trabajo editorial; no representan pruebas ejecutadas sobre una solución concreta. Retirar un modificador obsoleto tampoco certifica que todo el código migrado desde AX sea compatible con la plataforma actual.
Errores que conviene evitar
No haga un reemplazo global de palabras sobre toda la carpeta de metadatos. No edite paquetes binarios ni código estándar para ocultar advertencias. Si una dependencia de terceros conserva estos modificadores, registre el hallazgo y gestione su actualización con el responsable del componente.
El cambio debe seguir el proceso normal de revisión, construcción y despliegue de la solución. La desaparición de una advertencia es una evidencia técnica acotada, no una garantía general de ausencia de regresiones.
Recomendación
Incorpore esta limpieza al mantenimiento del código X++ y conserve las evidencias de compilación y pruebas en la revisión del cambio. Es una tarea concreta para reducir ruido en los registros y facilitar la lectura del código, sin depender de una fecha futura de retirada que todavía no esté verificada.
Fuentes
- Microsoft Learn: actualizaciones de plataforma 10.0.48, apartado Developer tools / X++.