Desarrollo en Dynamics AX 2012 Jose Antonio Estevan Krasis Press Scribd PDF

Desarrollo en Microsoft
Dynamics AX 2012
Jos Antonio Estevan Estevan

DESARROLLO EN MICROSOFT DYNAMICS AX 2012
DERECHOS RESERVADOS 2014, respecto a la primera edicin en espaol, por
Krasis Consulting, S. L.
www.Krasis.com
ISBN: 978-84-941112-4-2
CREATIVIDAD
Diseo Cubierta: Pablo Iglesias Francisco y Natalia Matesanz Urea

Fruta Cubierta: La granada es una infrutescencia, fruto de un rbol llamado granado que alcanza
hasta cuatro metros de altura, de la familia de las Punicceas; pequea familia de rboles y arbustos,
cuyos frutos tienen semillas prismticas y rugosas.
La fruta posee una piel gruesa de color escarlata o dorada con tono carmes en el exterior y una gran
cantidad de semillas internas rodeadas de una jugosa pulpa de color rub. En oriente es considerada
como un smbolo del amor y de la fecundidad y sus virtudes han sido difundidas por poetas tan
conocidos como Garca Lorca.
Creamos los mejores cursos online en espaol para programadores
Por qu aprender con nosotros?

Porque creamos cursos online de calidad contrastada cuyos autores y
tutores son reconocidos expertos del sector, aprenders a tu ritmo de la
mano de un verdadero especialista y dejars de dar tumbos por internet
buscando cmo se hace cualquier cosa que necesites.
Quieres ms razones? Haz click aqu
Descubre nuestro catlogo!
Descubre tambin nuestros

Libros para programadores
Dedicado a mis padres, que me apoyaron siempre en lo que quise
hacer, muchas veces sin comprender del todo mis guerras. A mi
hermana, a quien la inspiracin siempre encuentra trabajando,
capaz de sonrer en mitad de los problemas.
Y por supuesto a Sulaica, que me anim a empezar, ha soportado

mis ausencias durante el proceso y, a pesar de ello, me empuj a
terminar cuando flaquearon las fuerzas [dem].
Agradecimientos
Tengo que agradecer a Jos Manuel Alarcn que creyera en el proyecto desde el principio, a
pesar de mi escasa disciplina. Por asumir el riesgo sin pensarlo demasiado y por el buen
trabajo que han hecho en Krasis Press para que esto salga adelante. Gracias tambin a Salina
Mar y Cristina de Microsoft Ibrica, por el prlogo y el apoyo mostrado hacia el proyecto.
Y gracias a ti, lector, permteme el tuteo. Porque si ests leyendo esto debo suponer que
has comprado el libro. Espero sinceramente que consigas aprender tanto como he aprendido
yo escribindolo, porque entonces todo el esfuerzo habr valido la pena.
La teora es cuando se sabe todo y nada funciona.

La prctica es cuando todo funciona y nadie sabe por qu.
En este caso hemos combinado la teora y la prctica:
nada funciona... y nadie sabe por qu.
Albert Einstein
iv
Contenido
AGRADECIMIENTOS ................................................................................................ iv
CONTENIDO ............................................................................................................... v
PRLOGO ................................................................................................................... xi
CAPTULO-1: INTRODUCCIN ...........................................................................13
1.- Qu es este libro? Quin debera leerlo?......................................................................... 13

2.- Qu NO es este libro? ........................................................................................................... 14
3.- Contenido.................................................................................................................................... 14
4.- Lets Code! .................................................................................................................................. 16
4.1.- El entorno (requerimientos) ....................................................................................... 16
4.2.- Hola mundo! .................................................................................................................. 17
4.3.- Demasiado fcil! ............................................................................................................ 19
CAPTULO-2: CONOCIENDO LA APLICACIN ..............................................23
1.- Arquitectura Externa (fsica)................................................................................................... 24

1.1.- Capa de presentacin (Cliente) ................................................................................. 24
1.2.- Capa de aplicacin (Servidor) ..................................................................................... 26
1.3.- Capa de datos ................................................................................................................. 27
2.- Arquitectura Interna (lgica) .................................................................................................. 28
2.1.- Capas................................................................................................................................. 28
2.2.- Modelos ............................................................................................................................ 31
3.- Instalacin y Configuracin Bsica ........................................................................................ 31
3.1.- Instalacin ........................................................................................................................ 32
3.2.- Configuracin.................................................................................................................. 34
4.- Funcionalidad Bsica.................................................................................................................. 39
4.1.- El cliente de Windows.................................................................................................. 40
4.2.- Tipos de formularios..................................................................................................... 41
4.3.- Navegacin ...................................................................................................................... 48
4.4.- Filtrado, ordenacin y seleccin de datos ............................................................... 49
4.4.1.- Opciones de la cadena de bsqueda ................................................................. 52
4.4.2.- Seleccin de registros........................................................................................... 53
CAPTULO-3: HERRAMIENTAS DE DESARROLLO ..........................................55
1.- Espacio de trabajo de desarrollo ........................................................................................... 55

2.- Application Object Tree (AOT) ........................................................................................... 56
2.1.- Diccionario de Datos (Data Dictionary) ................................................................. 58
2.2.- Macros .............................................................................................................................. 60
2.3.- Clases ................................................................................................................................ 61
v
vi Desarrollo en Microsoft Dynamics AX 2012
2.4.- Formularios (Forms) ..................................................................................................... 61

2.5.- Partes (Parts) .................................................................................................................. 61
2.6.- Data Sets .......................................................................................................................... 62
2.7.- SSRS Reports .................................................................................................................. 62
2.8.- Reports ............................................................................................................................. 62
2.9.- Visual Studio Projects ................................................................................................... 63
2.10.- Report Libraries............................................................................................................ 63
2.11.- Consultas (Queries)..................................................................................................... 63
2.12.- Jobs................................................................................................................................... 64
2.13.- Mens (Menus).............................................................................................................. 64
2.14.- Elementos de men (Menu Items) ........................................................................... 64
2.15.- Web ................................................................................................................................. 64
2.16.- Servicios (Services) ...................................................................................................... 65
2.17.- Grupos de servicios (Service Groups).................................................................... 65
2.18.- Flujo de trabajo (Workflow) ..................................................................................... 65
2.19.- Seguridad (Security) ..................................................................................................... 66
2.20.- Recursos (Resources) ................................................................................................. 66
2.21.- Archivos de Etiquetas (Label Files) .......................................................................... 67
2.22.- Referencias (References) ............................................................................................ 67
2.23.- Documentacin de ayuda (Help Documentation) ............................................... 67
2.24.- Documentacin del Sistema (System Documentation) ...................................... 68
3.- Etiquetas y Traduccin ............................................................................................................. 68
3.1.- Qu son las etiquetas? ................................................................................................ 68
3.2.- Crear un fichero de etiquetas .................................................................................... 70
3.3.- Manejo de etiquetas ...................................................................................................... 70
4.- Proyectos ..................................................................................................................................... 72
4.1.- Importar y exportar proyectos.................................................................................. 73
4.2.- Generacin automtica de proyectos ...................................................................... 76
5.- Editor X++ .................................................................................................................................. 78
5.1.- Scripts de cdigo y extensiones del editor ............................................................. 79
5.2.- Atajos de teclado ........................................................................................................... 81
6.- Compilador y Buenas Prcticas.............................................................................................. 82
6.1.- Herramienta AxBuild .................................................................................................... 86
7.- Depurador ................................................................................................................................... 87
7.1.- Atajos de teclado ........................................................................................................... 88
8.- Modelos y Model Store............................................................................................................ 89
8.1.- AXUtil, PowerShell y AXUtilLib para la gestin de modelos ............................ 91
8.2.- Crear un nuevo modelo............................................................................................... 93
8.3.- Modificar y exportar modelos (Publicar)................................................................. 95
8.4.- Importar modelos (Instalar) ........................................................................................ 97
8.5.- Eliminar modelos (Desinstalar) ................................................................................. 98
8.6.- Exportar e importar la Model Store (Desplegar desarrollos) ............................ 99
8.7.- Etiquetas y Modelos .................................................................................................... 101
9.- Control de Versiones (VCS) y cdigo fuente .................................................................. 104
9.1.- Funcionamiento del control de versiones ............................................................. 106
9.2.- Configurar el control de versiones ......................................................................... 107
9.3.- Sincronizar tu repositorio con el control de versiones..................................... 111
vi
Contenido vii
9.4.- Aadir, renombrar y eliminar objetos .................................................................... 112

9.5.- Proteger y desproteger (Check In/Check Out)................................................... 113
9.6.- Asociar un conjunto de cambios a elementos de trabajo ................................. 114
9.7.- Ver el historial de versiones ..................................................................................... 116
9.8.- Etiquetas y el control de versiones ......................................................................... 117
9.9.- Branches, Merges, Builds, etc ............................................................................... 118
9.10.- Control de versiones en la nube ............................................................................ 120
10.- Pruebas Unitarias (Unit Testing) ..................................................................................... 121
10.1.- Parmetros de pruebas unitarias ............................................................................ 122
10.2.- Crear pruebas unitarias ............................................................................................ 123
10.3.- Ejecutar pruebas unitarias ........................................................................................ 126
10.4.- Cobertura de cdigo ................................................................................................. 126
10.5.- Organizar y configurar casos de pruebas ............................................................. 127
10.6.- Nivel de aislamiento de las pruebas....................................................................... 128
11.- Ciclo de vida de las modificaciones (ALM) .................................................................... 129
11.1.- Mover desarrollos entre entornos ........................................................................ 130
11.2.- Cuntos entornos necesito? .................................................................................. 131
11.3.- Servidores propios o de terceros? ....................................................................... 133
11.4.- Cuntos servidores necesito? ................................................................................ 134
11.5.- AOS compartido o entorno de desarrollo aislado ............................................ 135
11.6.- TFS slo como VCS o tambin gestin de proyectos? ................................... 137
11.7.- Un proyecto de TFS para cada cliente/producto? ............................................ 138
12.- Otras Herramientas ............................................................................................................ 138
12.1.- Examinador de tablas ................................................................................................ 139
12.2.- Buscador ....................................................................................................................... 139
12.3.- Comparador ................................................................................................................ 140
12.4.- Contexto de jerarquas y Explorador de jerarquas.......................................... 142
12.5.- Referencia cruzada ..................................................................................................... 143
12.6.- Ingeniera inversa ........................................................................................................ 145
12.7.- Trazas de cdigo (Code Profiler)........................................................................... 146
12.8.- Grabador de tareas.................................................................................................... 148
12.8.1.- Gestor de tareas avanzado y Lifecycle Services ......................................... 149
CAPTULO-4: EL LENGUAJE X++ .......................................................................153
1.- Introduccin.............................................................................................................................. 153

2.- Nombrar Objetos, Variables y Mtodos ........................................................................... 154
3.- Tipos de datos .......................................................................................................................... 155
3.1.- Tipos de datos primarios ........................................................................................... 156
3.2.- Tipos de datos extendidos ........................................................................................ 157
3.3.- Enumerados Base (Base Enums) .............................................................................. 158
3.4.- Tipos de datos compuestos ...................................................................................... 160
4.- Funciones ................................................................................................................................... 165
5.- Sintaxis........................................................................................................................................ 166
5.1.- Comentarios y documentacin XML ..................................................................... 167
5.2.- Variables ......................................................................................................................... 169
5.3.- Expresiones y Operadores........................................................................................ 170
5.4.- Estructuras de control de ejecucin ....................................................................... 171
viii Desarrollo en Microsoft Dynamics AX 2012
6.- Macros ........................................................................................................................................ 174

7.- Registro de informacin (InfoLog) ...................................................................................... 177
8.- Excepciones y Control de errores ..................................................................................... 181
9.- Clases e Interfaces................................................................................................................... 184
9.1.- Declaracin de clases.................................................................................................. 184
9.2.- Interfaces........................................................................................................................ 186
9.3.- Mtodos de clase ......................................................................................................... 187
9.4.- Atributos en clases y mtodos ................................................................................. 192
9.5.- Ejecutar clases desde Menu Items ........................................................................... 192
10.- Manejo de datos ................................................................................................................... 193
10.1.- Seleccin de datos...................................................................................................... 194
10.2.- Insertar, Actualizar, Eliminar ................................................................................... 199
10.3.- Validaciones y actualizaciones en cascada ............................................................ 201
10.4.- Actualizaciones masivas ............................................................................................ 204
10.5.- Transacciones .............................................................................................................. 207
10.6.- Mtodos de tabla ........................................................................................................ 208
CAPTULO-5: EL MODELO DE DATOS .............................................................211
1.- Introduccin.............................................................................................................................. 211

2.- Tablas .......................................................................................................................................... 212
2.1.- Propiedades de tabla ................................................................................................... 213
2.2.- Mtodos de tabla ......................................................................................................... 214
2.3.- Campos de tabla (Fields)............................................................................................ 215
2.4.- Grupos de campos (Field Groups) .......................................................................... 218
2.5.- ndices y Claves (Indexes) ......................................................................................... 219
2.6.- Relaciones (Relations) ................................................................................................ 223
2.7.- Acciones de borrado (Delete Actions) .................................................................. 228
2.8.- Herencia de tablas ....................................................................................................... 228
2.9.- Tablas Temporales ...................................................................................................... 231
3.- Mapas (Maps) ............................................................................................................................ 233
4.- Consultas (Query Framwework) ....................................................................................... 234
4.1.- Consultas compuestas (Composite Query) ........................................................ 239
4.2.- Expresiones y funciones de filtro en rangos ......................................................... 240
4.3.- Insercin de registros masiva mediante una Query ........................................... 243
5.- Vistas (Views) .......................................................................................................................... 244
6.- Unidad de Trabajo (Unit of Work)..................................................................................... 246
7.- Date Effective Framework..................................................................................................... 247
7.1.- Configurar una tabla con validez en el tiempo ..................................................... 248
7.2.- Insertar registros ......................................................................................................... 250
7.3.- Actualizar registros ..................................................................................................... 250
7.4.- Eliminar registros ......................................................................................................... 252
7.5.- Seleccionar registros................................................................................................... 253
8.- Particiones ................................................................................................................................. 255
viii
Contenido ix
CAPTULO-6: LA INTERFAZ DE USUARIO (FORMULARIOS) ....................257
1.- Introduccin.............................................................................................................................. 257

2.- Gua de estilo............................................................................................................................ 258
3.- Crear un formulario................................................................................................................ 259
3.1.- Tipos de formulario .................................................................................................... 261
4.- Orgenes de Datos (Data Sources)..................................................................................... 268
4.1.- Propiedades de un origen de datos......................................................................... 270
4.2.- Propiedades de campos en un Data Source ......................................................... 272
4.3.- Orgenes de datos y el resto de frameworks....................................................... 273
5.- Diseos (Designs).................................................................................................................... 276
5.1.- Controles....................................................................................................................... 278
6.- Mtodos (Methods) ................................................................................................................ 288
6.1.- Mtodos en formularios............................................................................................. 289
6.2.- Mtodos especiales: display y edit ........................................................................... 290
6.3.- Mtodos en Orgenes de datos (Data Sources) .................................................. 292
6.4.- Ejemplo: Mtodos, Filtros y Controles no enlazados......................................... 294
7.- Partes (Parts) ............................................................................................................................ 295
8.- Ejecutar formularios (Menu Items y X++) ........................................................................ 297
9.- Dilogos y Barras de progreso............................................................................................. 299
CAPTULO-7: FRAMEWORKS .............................................................................303
1.- Introduccin.............................................................................................................................. 303

2.- Frameworks de desarrollo .................................................................................................... 305
3.- Trabajos por lotes (Batch Framework) ............................................................................. 307
4.- SysOperation Framework ..................................................................................................... 310
4.1.- El modelo (Data Contract) ...................................................................................... 311
4.2.- El controlador (Controller) ...................................................................................... 315
4.3.- La vista (UIBuilder) ...................................................................................................... 317
4.4.- Ejecucin de una clase SysOperation ..................................................................... 321
4.5.- Modos de ejecucin .................................................................................................... 322
5.- SysExtension Framework ...................................................................................................... 323
6.- Eventos y delegados (Eventing Framework) .................................................................... 325
7.- Frameworks y Patrones de diseo...................................................................................... 329
CAPTULO-8: INTEGRACIN CON .NET Y SERVICIOS WEB ....................331
1.- Compilador de X++ vs Cdigo CIL ................................................................................... 331

2.- Integracin con .NET y Visual Studio ................................................................................. 333
2.1.- Cdigo gestionado (Managed Code) ...................................................................... 335
2.2.- Proyectos Visual Studio vs Referencias en el AOT ............................................ 336
2.3.- Manejo de Excepciones y .NET Interop ................................................................ 338
2.4.- Ejemplo de proyecto Visual Studio en el AOT .................................................... 338
3.- Servicios Web .......................................................................................................................... 342
3.1.- Conceptos bsicos sobre servicios web en AX .................................................. 343
3.2.- Servicios de tipo documento .................................................................................... 346
3.3.- Servicios personalizados ............................................................................................ 353
x Desarrollo en Microsoft Dynamics AX 2012
4.- Servicios web y Excel! ........................................................................................................... 358
CAPTULO-9: INFORMES......................................................................................361
1.- Introduccin.............................................................................................................................. 361

2.- Arquitectura del framework de Reporting ....................................................................... 362
2.1.- Componentes que intervienen en la integracin................................................. 363
2.2.- Configuracin del servidor de informes ................................................................ 368
2.3.- Proyectos de Informes (Model Projects) ............................................................. 369
2.4.- Despliegue de informes al servidor......................................................................... 371
3.- Modelo de objetos del sistema de informes ................................................................... 373
3.1.- Modelo (Data Contract) ............................................................................................ 374
3.2.- Controlador (Controller).......................................................................................... 375
3.3.- Ejecutar y pre-visualizar un informe ....................................................................... 377
4.- Orgenes de datos ................................................................................................................... 379
4.1.- Query.............................................................................................................................. 382
4.2.- Business Logic (Report Data Methods) ................................................................. 383
4.3.- Report Data Provider (RDP) ................................................................................... 387
5.- Diseo de informes................................................................................................................. 391
5.1.- Ejemplo: Disear con SSRS y Visual Studio........................................................... 392
CAPTULO-10: LICENCIA, CONFIGURACIN Y SEGURIDAD ...................397
1.- Introduccin.............................................................................................................................. 397

2.- Licencia ....................................................................................................................................... 398
3.- Configuracin ........................................................................................................................... 400
3.1.- Configuracin por pases............................................................................................ 401
4.- Seguridad ................................................................................................................................... 403
4.1.- Elementos de seguridad en el AOT ........................................................................ 404
4.2.- Elementos que pueden asegurarse y niveles de acceso ..................................... 406
4.3.- Inferencia automtica de permisos.......................................................................... 408
4.4.- Extensibe Data Security Model (XDS) ................................................................... 410
4.5.- Security Development Tool for Dynamics AX 2012 ......................................... 415
4.6.- Seguridad y Date Effective Framework .................................................................. 416
4.7.- Seguridad y cdigo X++............................................................................................. 417
NDICE ANALTICO ...............................................................................................421
x
Prlogo
Ha sido una grata satisfaccin que Jos Antonio quisiera contar conmigo para
prologar su primer libro. Adems, el placer se ve aumentado si se percibe que la
publicacin va a ayudar a mejorar calidad de los profesionales expertos en
Soluciones de Gestin Empresarial en la comunidad hispano hablante, y por otra
parte a reconocer al grupo al que pertenece el autor. Una comunidad reconocida
por Microsoft por ser los profesionales ms valorados del sector, con un altsimo
conocimiento en su campo en este caso en Microsoft Dynamics AX, y que
aportan un gran valor a nuestro canal de distribucin.
Hoy en da y ms que nunca, la diferenciacin es la clave del xito
empresarial, y es la caracterstica comn de todas las compaas innovadoras y
competitivas. Cierto es que las soluciones ERP se han caracterizado
histricamente por ser monolticas y por su falta de flexibilidad. Todos los que
estamos alrededor de Microsoft Dynamics AX sabemos que ste trae un soplo de
aire fresco, ya que permite a las empresas modelar y automatizar procesos
empresariales (finanzas, comercial, logstica, produccin etc.) y planificar todos
los recursos de las compaas con la flexibilidad necesaria para incorporar esas
gotas de innovacin y diferenciacin.
Las necesidades de las empresas son cada vez mayores, y la inversin en
innovacin de los fabricantes tecnolgicos es cada vez ms alta. En el caso de
Microsoft Dynamics AX se generan dos actualizaciones cada seis meses, lo que
permite que la herramienta sea una de las ms competitivas del mercado,
adaptndola a las tendencias tecnolgicas. Por ejemplo, la ltima revisin del
producto ha incluido el soporte para desplegar la solucin en la nube.
La clave del xito no slo reside en la calidad del producto, sino tambin
en el servicio prestado por profesionales altamente cualificados, que sean capaces
xii Desarrollo en Microsoft Dynamics AX 2012
de plasmar las necesidades de todo tipo de organizaciones y sectores de actividad.

En los ltimos aos hemos visto como la demanda de este tipo de profesionales
expertos en Microsoft Dynamics AX se ha incrementado, y desde Microsoft
hemos impulsado toda una serie de iniciativas que, estamos seguros, ayudarn en
un futuro muy prximo a ampliar la comunidad de expertos en Microsoft
Dynamics AX.
Este libro recoge todos los aspectos relevantes para entender la solucin
Microsoft Dynamics AX desde un punto de vista tcnico. Desde la descripcin de
las funcionalidades bsicas de la herramienta, hasta cmo adaptar la misma o
desarrollar nuevas funcionalidades, adems de trucos, consejos y buenas prcticas
que, estoy segura, ayudarn a muchos.
GRACIAS Jos Antonio. Gracias por formar parte de esa comunidad de
MVPs de Microsoft Dynamics. Y sobre todo gracias por defender la necesidad
de desarrollar software de calidad e impulsar buenas prcticas alrededor del
mismo. Esperamos que esta sea una de las muchas publicaciones que lances y que
anime al resto de profesionales de Microsoft Dynamics a escribir sobre las
soluciones que ayudan en el da a da de las empresas, y que mejoran la
competitividad de las mismas.
Salina Mar Aragn, Product Marketing Manager Microsoft Dynamics CRM&ERP en Microsoft.
1
CAPTULO
Introduccin
Este captulo contiene una descripcin de los objetivos del libro, a quin va
dirigido, lo que se puede esperar de l, y tambin algunos puntos que no se deben
esperar. Sirve tambin como introduccin a los captulos que vamos a encontrar
a continuacin y para preparar el entorno de pruebas en el que se desarrollan los
ejemplos, con algunas demostraciones.
1.- QU ES ESTE LIBRO? QUIN DEBERA LEERLO?

La idea principal es iniciar a profesionales que ya son programadores de otros entornos
y necesitan empezar a desarrollar en Microsoft Dynamics AX 2012 rpidamente.
Tambin es apto para desarrolladores que trabajan con Microsoft Dynamics AX en
versiones anteriores y quieren refrescar conocimientos o descubrir las novedades de
esta versin, que desde el punto de vista tcnico son abundantes. Buena parte del
contenido, y sobre todo la filosofa de desarrollo, es vlida tambin para las versiones
anteriores.
Para la comprensin de algunos de los conceptos tratados, es importante entender que
este libro se basa en un sistema ERP (Enterprise Resource Planning) y que el contexto
de las capacidades de desarrollo que ofrece el producto, siempre estn orientadas a
funcionalidades de negocio, por lo que programadores que vengan de lenguajes de
propsito general (como java o .NET) pueden echar en falta algunas funcionalidades.
Por el contrario, a quienes vengan de otros sistemas ERP ms estrictos les parecer un
entorno tremendamente flexible. Se recomienda retrasar este juicio hasta conocer todas
las posibilidades (como se espera que sea el caso al finalizar la lectura de todos los
captulos).
13
14 Desarrollo en Microsoft Dynamics AX 2012
A pesar de que muchos de los temas tratados en el texto son novedades de Microsoft
Dynamics AX 2012, la mayora de los conceptos generales son vlidos para versiones
anteriores, aunque en la medida de lo posible se indicarn de manera especfica los
detalles que sean propios de esta versin en concreto.
2.- QU NO ES ESTE LIBRO?

Este libro no es un manual de programacin. Al lector se le suponen conocimientos
tcnicos bsicos y estar familiarizado con la programacin orientada a objetos. Tambin
ayudarn, aunque no son imprescindibles, conocimientos o experiencia en sistemas ERP
desde el punto de vista funcional o, en general, conocimientos de gestin empresarial
bsica (por ejemplo, qu es una factura o una cuenta contable).
Este libro tampoco es una gua completa de funcionalidades de Microsoft
Dynamics AX 2012; para eso hara falta un libro de este tamao para cada uno de los
mdulos funcionales, y es posible que ni as fuera posible llegar al mximo detalle.
Este libro pretende ser una buena gua tcnica con la que empezar y con la que
conocer todas las posibilidades, pero es imposible recopilar absolutamente todas las
opciones y detalles que incluye el sistema. Estos detalles concretos se pueden encontrar
en la documentacin disponible, por ejemplo en los portales MSDN y TechNet, por tanto
este libro no es un libro de referencia tcnica completa.
El objetivo es que tras la lectura se aprenda lo suficiente para poder empezar a trabajar
con el producto y saber qu, dnde y cmo buscar las referencias adecuadas fcilmente.
Durante el resto de captulos se incluirn enlaces a documentos y pginas de la
documentacin oficial, donde ampliar informacin sobre asuntos importantes. Casi todos
los documentos se encuentran en la biblioteca que se enlaza a continuacin. Conviene
tenerla siempre a mano, ya que muchos documentos se actualizan con cada versin
publicada del producto:
Enlace: Microsoft Dynamics Resource Library
http://www.microsoft.com/en-us/dynamics/resource-library.aspx
3.- CONTENIDO
El contenido del libro se divide en 10 captulos, cada uno dedicado a una parte importante
de la programacin en Microsoft Dynamics AX. Los captulos estn diseados para ser
ledos en ese orden, intentando que los conceptos se incluyan segn el orden en el que
se van necesitando, pero tambin pueden ser utilizados como gua de consulta de un tema
concreto. Cuando se nombra un concepto que todava no se ha introducido se incluye
una referencia al captulo relacionado.
Introduccin 15
Lo que se debe esperar de cada uno de ellos es lo siguiente:
1. Introduccin (Este captulo).
2. Conociendo la aplicacin: En este captulo se introduce la infraestructura

completa de Microsoft Dynamics AX, tanto la arquitectura fsica (el
software que se instala en los servidores) como la lgica (cmo se
estructuran los componentes y objetos de la aplicacin). Tambin se explica
el proceso de instalacin y la funcionalidad bsica, comn en todos los
mdulos, que debe respetarse en los nuevos desarrollos.
3. Herramientas de desarrollo: En este captulo se detallan todas las

herramientas de desarrollo disponibles. Desde el AOT, el editor de cdigo,
las herramientas auxiliares, el compilador, depurador y todas las
herramientas disponibles para el manejo de desarrollos, ciclo de vida de los
cambios y control de versiones.
4. El lenguaje X++: Captulo dedicado exclusivamente a explicar las

posibilidades del lenguaje X++ que vamos a utilizar en toda la aplicacin.
5. El modelo de datos: Dedicado a todos los componentes de los que

disponemos para el manejo de datos en la aplicacin. Desde los ms bsicos
como tablas, vistas y tipos de datos, hasta frameworks ms complicados para
el manejo avanzado de transacciones, fechas de validez de los datos, etc.
6. La interfaz de usuario: Dedicado al diseo de la parte visual de la

aplicacin, lo que llamamos El Cliente. Bsicamente se tratan los aspectos
de diseo de formularios y una introduccin a la gua de estilo.
7. Frameworks: Se explican los diferentes frameworks de desarrollo de los que

disponemos para realizar tareas propias del sistema, y que no han sido vistos
en captulos anteriores. Es importante conocerlos y utilizarlos, tanto para
ahorrar tiempo de desarrollo, como para hacer nuestros desarrollos
compatibles con el resto de la aplicacin.
8. Integracin con .NET y Servicios Web: Captulo dedicado a la integracin

de Microsoft Dynamics AX con aplicaciones externas. Bsicamente mediante
los mecanismos de integracin con el framework .NET, la construccin de
servicios web que expone el sistema, y el consumo de servicios web
externos.
9. Informes: Dedicado al framework de desarrollo de informes basado en

Microsoft SQL Reporting Services (SSRS).
10. Licencia, Configuracin y Seguridad: Por ltimo detallamos las opciones

de las que disponemos para limitar qu partes del sistema vamos a utilizar
en general, y de ellas, qu partes puede ver cada usuario, personalizando de
esta manera la experiencia de usuario principalmente mediante controles de

seguridad.
4.- LETS CODE!
Como durante el libro los primeros ejemplos se van a hacer esperar un poco, vamos a
adelantar la primera toma de contacto con el entorno, realizando unos pequeos ejemplos
que nos introducirn tanto al entorno como a las diferentes maneras de afrontar un
desarrollo en Microsoft Dynamics AX.
4.1.- El entorno (requerimientos)
Para la realizacin de estos ejemplos y los que vendrn en los siguientes captulos se
utiliza el entorno publicado por Microsoft en forma de mquina virtual de demostracin
en los portales PartnerSource y CustomerSource. A estos portales se tiene acceso si
trabajamos para un partner certificado para Microsoft Dynamics, o si como clientes
tenemos una licencia de Microsoft Dynamics activa, respectivamente.
Esta mquina virtual contiene una instalacin totalmente funcional de todos los
componentes de la aplicacin, con datos de prueba, lista para trabajar. Se puede descargar
de los siguientes enlaces:
https://mbs.microsoft.com/partnersource/deployment/methodology/vpc/ax2
012demotoolsmaterials.htm
https://mbs.microsoft.com/customersource/downloads/servicepacks/ax2012
demotoolsmaterials.htm
La mquina virtual no necesita instalacin, se puede hacer funcionar directamente,

mediante Hyper-V en Windows Server 2008 R2, Windows Server 2012 o Windows 8 (y
posteriores) y tambin convertirla a otros sistemas de virtualizacin (Virtual Box, por
ejemplo) para ejecutarla sobre Windows 7 o anteriores.
Desde la versin AX 2012 R3, si tenemos acceso a los nuevos LCS (Microsoft
Dynamics Lifecycle Services) podemos desplegar una mquina virtual demo en nuestra
cuenta de Microsoft Azure en unos pocos y sencillos pasos. De nuevo, para acceder a
este portal es necesario tener una cuenta activa en PartnerSource o CustomerSource.
Enlace: Microsoft Dynamics Lifecycle Services
https://lcs.dynamics.com
Durante el proceso de escribir todos los captulos he ido actualizando la mquina

virtual con las ltimas versiones, he trabajado con revisiones desde AX 2012 FP1
Introduccin 17
(Feature Pack 1, 6.0.947.862) hasta AX 2012 R3 (6.3.164.0) en Azure! Dado que no se

utiliza funcionalidad especfica de ninguna versin, funcionarn con cualquier AX 2012
en general.
Naturalmente, tambin se pueden realizar los ejemplos en un entorno instalado
manualmente o en una aplicacin existente. El proceso de instalacin y configuracin de
la aplicacin se detalla en el captulo 2 Conociendo la aplicacin.
4.2.- Hola mundo!
Como programador, s de primera mano que para aprender a programar, hay que
programar, y que el movimiento se demuestra andando. Ms adelante veremos por qu,
pero tengo que empezar diciendo que esto no es siempre as en Microsoft Dynamics AX.
Podemos realizar una gran cantidad de modificaciones sin necesidad de programar, pero
vamos a empezar con el tpico ejemplo para empezar a conocer el entorno.
Haremos el clsico hello-world y de esta manera probaremos que la instalacin de
Microsoft Dynamics AX 2012 de la que disponemos es vlida para realizar los ejemplos
que propondr en el resto del libro.
Lo primero es abrir un entorno de desarrollo, esto lo podemos hacer de varias

formas (ms adelante veremos algunas ms), pero de momento abrimos un
cliente desde el men de inicio en Inicio > Programas > Microsoft
Dynamics AX 2012 > Microsoft Dynamics AX 2012. Ver figura 1.
Figura 1.- Visin general del cliente de trabajo de Microsoft Dynamics AX 2012
Una vez dentro de la aplicacin, con el atajo de teclado Ctrl+Shift+W se abre

directamente un entorno de desarrollo.
Tambin podemos hacerlo mediante el botn Ventanas situado en la parte

superior-derecha del entorno de trabajo normal, utilizando la opcin Nuevo
espacio de trabajo de desarrollo. Ver figura 2.
Figura 2.- Nuevo espacio de trabajo de desarrollo
En el entorno de desarrollo, abrir el AOT (rbol de objetos de la aplicacin,

Application Object Tree), lo que puede hacerse de las siguientes formas:
o Pulsando el icono correspondiente en la barra de herramientas.
o Con el atajo de teclado Ctrl+D.
Despus, navegar al nodo Jobs, y crear uno nuevo (botn derecho en Jobs >
Nuevo Job). Ver figura 3.
Figura 3.- Crear un nuevo elemento en el AOT
Modificar el cdigo del Job para que quede como el siguiente:
static void CAP01_Demo(Args _args)

{
info("Hola mundo!!");
}
Al ejecutarlo (pulsando F5 o el botn correspondiente en el editor), el

resultado es una ventana del Registro de informacin (tambin llamado
Introduccin 19
InfoLog, veremos ms adelante toda su utilidad) mostrando el mensaje

indicado. Ver figura 4.
Figura 4- Salida de un mensaje por el InfoLog
4.3.- Demasiado fcil!
Quizs este ejemplo ha sido demasiado sencillo. Vamos a hacer un segundo ejemplo para
empezar a entender por qu en Microsoft Dynamics AX no es tan importante el cdigo
como en otros entornos o lenguajes. Para ello usaremos el entorno de desarrollo llamado
MorphX, que veremos en detalle en el Captulo 3 Herramientas de desarrollo.
En los primeros ejemplos se explicarn con detalle cada uno de los pasos, pero
conforme avancemos se obviarn los pasos descritos en ejemplos anteriores.
El objetivo de este ejemplo es la sencilla tarea de presentar un formulario al usuario
con la lista de clientes de la empresa actual. La tabla de clientes ya existe (obviamente)
en la aplicacin estndar, slo vamos a presentar algunos de sus campos en un formulario
que el usuario podr utilizar para consulta.
En el AOT navegar hasta Forms, clic derecho > Nuevo Form.
Clic derecho en el nodo Form1 (recin creado) > Propiedades. Ajustar la

propiedad Name a LabClientes.
Clic derecho en Data Sources > Nuevo DataSource. En el origen de datos

recin creado cambiar las siguientes propiedades: Name: CustTable; Table:
CustTable; AllowEdit: No; AllowCreate: No; AllowDelete: No.
Clic derecho en Designs > Propiedades. Cambiar las siguientes propiedades:

Caption: Demostracin; TitleDatasource: CustTable.
Clic derecho en Designs > Nuevo control > Grid. Ajustar las siguientes
propiedades en el Grid recin creado: Name: GridIdentification; Width:
Column width; Height: Column height; DataSource: CustTable;
DataGroup: Identification.
Figura 5.- Formulario de ejemplo
Guardar los cambios (mediante el botn correspondiente en la ventana del

AOT o Ctrl+Shift+S) y abrir el formulario haciendo clic derecho sobre l >
Abrir.
El resultado aproximado se encuentra en la figura 5.
Lo que acabamos de hacer paso a paso lo podemos resumir de la siguiente forma:
Crear un objeto de tipo Form en el AOT y ajustar sus propiedades.
Aadir un origen de datos (Data Source) al formulario y ajustar sus

propiedades para enlazarlo a una tabla del AOT (CustTable).
Aadir un componente al diseo del formulario, enlazarlo con el origen de

datos y elegir un grupo de campos automtico de los disponibles en el origen
de datos. Este grupo define qu campos se van a mostrar dependiendo de la
configuracin en la tabla.
Tambin se ajustan las propiedades visuales del control para que se adapte
al tamao del formulario y hacerlo redimensionable. Se puede comprobar
arrastrando la esquina inferior-derecha del formulario para cambiar su
Introduccin 21
tamao. Los formularios de la aplicacin siempre deben estar preparados

para funcionar en monitores de diferente tamao.
Esta es la manera en la que se desarrollan una gran parte de los cambios en MorphX.
Como se puede ver, mediante unos sencillos pasos (que an pueden ser ms sencillos,
como veremos ms adelante) hemos creado un formulario totalmente funcional sin
necesidad de introducir una sola lnea de cdigo. Comprobaremos que todo lo que se
pueda desarrollar sin programar nos va a suponer una ventaja a la hora de extenderlo,
mantenerlo e integrarlo con la funcionalidad actual, por lo que es aconsejable utilizar
cdigo slo cuando no haya ms remedio.
2
CAPTULO
Conociendo la aplicacin
Este captulo pretende dar una visin general de la arquitectura que forma una
solucin Microsoft Dynamics AX completa. Es importante comprender esta
arquitectura, ya que en buena medida condiciona la manera de pensar con la que
se afrontan los desarrollos que se van a ejecutar sobre ella. Tambin se hace un
repaso del proceso de instalacin de los componentes, su configuracin ms
importante, y la funcionalidad genrica de la aplicacin.
Es importante dejar claro que resultara imposible abarcar aqu todo el detalle de la
instalacin, configuracin y optimizacin de una solucin completa de Microsoft
Dynamics AX. Para ello, lo ideal es remitirse a la gua de instalacin oficial del producto
que se puede descargar de manera gratuita y se mantiene actualizada despus de cada
nueva revisin para reflejar los ltimos cambios.
White Paper: Microsoft Dynamics AX 2012 Guide: Installation
http://www.microsoft.com/en-us/download/details.aspx?id=12687
El objetivo de este captulo es comprender los componentes que forman una

instalacin Microsoft Dynamics AX totalmente funcional, cmo se relacionan estos
componentes entre ellos, dnde y cmo se instalan.
Afrontaremos este anlisis desde el punto de vista fsico cules son los componentes
que se deben instalar, dnde y para qu sirven y lgica cmo se organiza Microsoft
Dynamics AX internamente. Finalmente veremos la configuracin ms importante para
que todo funcione y repasaremos la funcionalidad genrica de la aplicacin. Con todo
23
este contexto aprendido, estaremos preparados para empezar a conocer el entorno de

desarrollo.
1.- ARQUITECTURA EXTERNA (FSICA)

El impacto que tiene una instalacin de Microsoft Dynamics AX completa en los
servidores es importante. Su instalacin no es un proceso intuitivo por lo que es
necesario hacer una planificacin mnima de los componentes, hasta para la instalacin
del entorno ms sencillo. Todos los componentes se pueden montar juntos o por
separado, y la mayora de ellos se instalan directamente desde el disco (o la ISO) de
instalacin del producto. Estos servidores deben estar dentro de un dominio de Active
Directory y desde la versin AX 2012 R3 estn certificados para instalarse en Microsoft
Azure en su versin IAAS (Infrastructure as a Service, o mquinas virtuales en la nube).
A grandes rasgos, organizamos los componentes de software que componen la
instalacin diferencindolos en 3 capas: capa de presentacin (cliente), capa de
aplicacin (servidor) y capa de datos (Microsoft SQL Server). Ver figura 1.
Figura 1.- Distribucin de componentes de la instalacin
Para que una instalacin de Microsoft Dynamics AX sea utilizable, como mnimo
habr que instalar un motor de bases de datos Microsoft SQL Server, un servicio AOS y
el cliente para Windows. sta ser la instalacin mnima que necesitaremos tambin para
desarrollar si incluimos las herramientas de desarrollo (otro cliente, como veremos ms
adelante).
1.1.- Capa de presentacin (Cliente)
En esta capa incluimos, tanto los componentes con los que los usuarios de Microsoft
Dynamics AX interactan durante su trabajo con la aplicacin, como los que utilizamos
los desarrolladores para la modificacin y ampliacin del sistema. El cliente principal es
el Cliente de Dynamics AX para Windows que usan los usuarios finales (es a lo que nos
referimos cuando hablamos simplemente de El cliente), pero no es el nico. Ver figuras
1 y 2.
Conociendo la aplicacin 25
Cliente Dynamics AX para Windows (tambin llamado Rich client o

simplemente Cliente): El cliente ejecuta la aplicacin MorphX desarrollada
en X++ y .NET mediante Visual Studio. Se comunica con el AOS mediante
RPC.
Es la principal forma de presentacin de Microsoft Dynamics AX a los

usuarios utilizando una tecnologa de renderizado propia llamada
IntelliMorph, que posiciona y ordena los controles en los formularios de
manera automtica. Profundizaremos sobre esto en el captulo 3 La interfaz
de usuario. Este cliente tambin presenta las pginas del Role Center, que
se generan en un navegador.
Enterprise Portal (tambin llamado cliente ligero o EP): Este cliente

tambin ejecuta la aplicacin MorphX con sus extensiones .NET,
aplicaciones propias de Visual Studio y Sharepoint Server. Se hospeda
mediante ASP.NET y Sharepoint junto a extensiones propias de Microsoft
Dynamics AX, que se comunican con el AOS mediante el .NET Business
Connector.
Cliente Office: Desde la versin Microsoft Dynamics AX 2012, existen add-

ins especficos para utilizar Microsoft Office Word y Excel como clientes de
Microsoft Dynamics AX tanto para lectura como para actualizacin de datos,
con algunas limitaciones. Se comunican con el AOS mediante servicios web.
Clientes de Terceros: Existen diferentes vas para conectar Microsoft

Dynamics AX con el exterior, por lo que se pueden encontrar mltiples
clientes desarrollados por terceros para cualquier plataforma,
comunicndose mediante BizTalk Server, MSMQ, servicios web, etc.
Profundizaremos sobre esto en el captulo 8 Integracin con .NET y
Servicios Web.
Tambin podemos incluir en esta capa los dos puntos de acceso a las herramientas
de desarrollo para Microsoft Dynamics AX, ya que ambas se instalan en el lado del
cliente:
MorphX: Todas las opciones de desarrollo de MorphX son accesibles desde

un cliente Microsoft Dynamics AX para Windows especfico para esta tarea
al que llamamos Entorno de desarrollo.
Visual Studio: Se utiliza para desarrollar extensiones (bibliotecas) para

Microsoft Dynamics AX, desarrollo de Enterprise Portal e informes SSRS.
En esta versin se puede utilizar tambin para realizar desarrollos
directamente mediante los objetos del AOT. Ampliaremos sobre esto en el
captulo 8 Integracin con .NET y Servicios Web.
1.2.- Capa de aplicacin (Servidor)
Application Object Server (AOS): Este servicio ejecuta la aplicacin

MorphX y el cdigo X++, gestiona la seguridad y las sesiones de los usuarios
conectados y publica los servicios web expuestos por la aplicacin.
En toda instalacin debe haber al menos un AOS, aunque la instalacin se

puede escalar instalando servicios adicionales y configurando balanceo de
carga para soportar ms usuarios concurrentes, o utilizarlos como servidores
dedicados para el procesado de trabajos por lotes o de informes.
Enterprise Portal Extensions: Estos componentes extienden una

aplicacin Sharepoint con funcionalidades propias de Microsoft Dynamics
AX. Estas extensiones se comunican con el AOS mediante el .NET Business
Connector y RPC, y con SSAS y SSRS mediante HTTP y HTTPS. Enterprise
Portal se puede instalar en un servidor dedicado o en cluster, como una
granja Sharepoint cualquiera.
.NET Framework: Se pueden referenciar componentes .NET desde X++.

Adems, la plataforma Microsoft Dynamics AX est profundamente
integrada con Windows Workflow Foundation (WWF) y Windows
Communication Foundation (WCF). Ampliaremos este tema en el captulo
8 Integracin con .NET y Servicios Web.
SSRS Reporting Extensions: Estos componentes extienden SSRS con

componentes especficos de Microsoft Dynamics AX. Se comunican con el
AOS mediante servicios WCF, y con SSAS mediante HTTP y HTTPS y
ofrecen ayuda para el manejo de objetos y estructuras propias de Microsoft
Dynamics AX desde informes SSRS estndar, incluyendo la seguridad y la
obtencin de datos en un formato manejable por los informes. Veremos esto
de forma ms amplia en el captulo 9 Informes.
Web Services: Microsoft Dynamics AX es capaz de consumir servicios web

externos publicados por terceros, as como publicar sus propios servicios
web hospedados tanto en el AOS como en IIS. La aplicacin estndar utiliza
estos servicios (publicados por defecto en el AOS) para su funcionamiento
normal. Trataremos este punto en el captulo 8 Integracin con .NET y
Servicios Web.
Figura 2.- Componentes externos de la instalacin
1.3.- Capa de datos
La capa de datos se limita bsicamente a una o varias instancias de Microsoft SQL Server.
Estos servidores albergarn la base de datos que contiene los datos de negocio de la
aplicacin, la base de datos que contiene los metadatos llamada Model Store (a partir de
la versin AX 2012 R2) y otra base de datos con la misma estructura que esta ltima
llamada Baseline, utilizada durante los cambios de versin o para comparar con
versiones anteriores. Tambin puede albergar las bases de datos necesarias para
Sharepoint y Reporting Services, as como las instancias de Analysis Services, etc.
Estas bases de datos pueden estar instaladas en el mismo servidor o en servidores
diferentes as como en cluster, tal como se diseara una instalacin de Microsoft SQL
Server cualquiera. Habitualmente, las bases de datos de Microsoft Dynamics AX
conviven con otras bases de datos en una misma instancia de Microsoft SQL Server, y
las destinadas al Reporting y Business Intelligence se instalan en servidores separados.
Aunque no hay ninguna limitacin y esto depender del escalado que se decida durante
la instalacin y posteriores optimizaciones.
2.- ARQUITECTURA INTERNA (LGICA)
Una vez comprendida la arquitectura externa, es importante conocer tambin de qu

manera se organiza la aplicacin internamente, ya que esta arquitectura condiciona y
sugiere las mejores prcticas a la hora de desarrollar y ampliar el producto.
Aunque entraremos en detalle ms adelante, conocer esta arquitectura interna es
imprescindible para mantener totalmente controlados los desarrollos y ampliaciones del
sistema, as como para copiar estos desarrollos de un entorno a otro. Por ejemplo, desde
el entorno que usamos para desarrollar, al entorno que utilizan los usuarios finales en
produccin. Resulta imprescindible desarrollar una buena estrategia de gestin de ciclo
de vida del producto para minimizar el tiempo y el impacto de las actualizaciones en el
entorno en produccin, y por tanto el tiempo de parada de la empresa.
Esta arquitectura, llamada Arquitectura Orientada a Modelos (Model Driven
Architecture), se explica con dos conceptos bsicos: Capa y Modelo. Mediante estas
dos estructuras se organizan y agrupan los objetos y el cdigo, que forman los elementos
bsicos del desarrollo en MorphX y se almacenan en el AOT. Profundizaremos sobre
estos conceptos en el captulo 3 Herramientas de desarrollo.
2.1.- Capas
Las unidades en las que podemos guardar y desplegar los desarrollos en Microsoft
Dynamics AX son lo que llamamos de manera genrica: Objetos. Un objeto puede ser
una tabla en la base de datos, un informe, un formulario, una clase, etc. pero tambin
existen objetos ms pequeos, como un ndice o un campo de una tabla.
Estos objetos son unidades irrompibles que se pueden crear, eliminar, importar y
exportar entre entornos, por lo que sern la unidad mnima de transporte de desarrollos
entre instalaciones; aunque existen herramientas para poder importar slo partes de estos
objetos de manera selectiva, como veremos. Por ejemplo, podemos importar slo un
mtodo de una clase, en lugar de la clase entera, o slo unos cuantos cambios de un
mtodo, una propiedad de un formulario, etc.
2.1.1.- Qu son las capas?

Las capas son una estructura jerrquica donde guardar estos objetos. Son fciles de
entender si las imaginamos como una pila de capas, una encima de otra, de manera que
el compilador mira la pila desde arriba y slo es capaz de ver el elemento de la pila que
est en la capa ms alta, que oculta a los elementos en niveles inferiores. Ver Figura 3.
El nmero de capas que tenemos accesibles en cada instalacin depender de nuestro
rol en el proyecto. Existen algunas capas que slo son modificables por Microsoft, otras
estn reservadas para soluciones desarrolladas por partners y resellers certificados (y
certificadas por Microsoft como tales) y otras estn disponibles tanto para partners como
para el cliente final (ver Tabla 1).
Figura 3.- Vista simplificada de las capas de objetos de la aplicacin
Existe una copia de cada capa que se llama igual que su capa principal, pero
terminado en P (de Parche). Estas copias se utilizan para desplegar los desarrollos y
ampliaciones que estn en pruebas, pendientes de validar, o que corrigen una
funcionalidad de manera temporal. Esto incluye los objetos que nos enva Microsoft para
corregir errores puntuales, que vendrn en la capa que consideren ms adecuada, desde
el ms pequeo hotfix, a los grandes Feature Pack o Cumulative Update.
Igual que Microsoft, tenemos que utilizar siempre la capa ms adecuada, que como
norma general ser la capa ms alta a la que tengamos acceso., En lneas generales ser
SLN/ISV si desarrollamos un producto certificado por Microsoft, VAR si trabajamos
para un partner proveedor del cliente final, CUS si trabajamos para un cliente final, y
USR queda libre y no debe utilizarse para desarrollar, sino que la utiliza el propio sistema
para guardar cambios menores que generan los propios usuarios. Estas normas se pueden
variar en entornos muy complejos, pero son un buen principio del que partir a la hora de
desarrollar nuestra metodologa.
Tabla 1.- Capas de objetos de la aplicacin en Microsoft Dynamics AX 2012
Propietario Capa Descripcin

SYS + SYP System: Es la capa ms baja, donde est la aplicacin
estndar desarrollada por Microsoft y las
localizaciones incluidas.
Microsoft GLS + GLP Globalization layer: Localizaciones no incluidas
todava en SYS.
FPK + FPP Feature Pack: Feature Packs desarrollados por
Microsoft.
SLN + SLP Solution Layer: Soluciones de terceros aprobadas
por Microsoft.
ISV y ISV + ISP Independent Software Vendor: Soluciones
Partner verticales desarrolladas por partners ISV.
VAR + VAP Value Added Reseller: Soluciones multi-cliente
desarrolladas por partners VAR.
CUS + CUP Customer: Funcionalidades especficas para un

cliente, a menudo desarrolladas por el propio cliente.
Partner y
USR + USP User: Funcionalidades propias de cada usuario,
Cliente
personalizacin y opciones especficas de la
instalacin.
2.1.2.- Para qu sirven?
Conocer el sistema basado en capas, y aprovecharse de l, aporta beneficios y

funcionalidades que resultan fundamentales para trabajar con el sistema. El primero y
principal es que slo tenemos acceso a las capas que tenemos asociadas, y no podemos
modificar el resto de ellas. De esta manera, un desarrollador en un partner no puede
modificar ni borrar cdigo estndar, ni un programador que trabaja para el cliente final
puede romper un desarrollo realizado por su partner.
De qu sirve un entorno de desarrollo si no puedo modificar la aplicacin estndar?
Ah es donde interviene el sistema de capas. No podemos modificar la aplicacin
estndar directamente, pero s podemos hacer una copia de estos objetos encima de la
aplicacin estndar, modificar y ampliar esta copia. El compilador va a utilizar siempre
la copia de la capa superior, que en cualquier caso se puede eliminar para recuperar el
objeto estndar, que qued oculto. Como veremos ms adelante, este proceso es
transparente para el usuario, y casi transparente para el desarrollador.
Lo nico que como desarrollador hay que configurar es el acceso, cuando se abre el
cliente de desarrollo, para trabajar en la capa adecuada. Esto se hace en la utilidad de
configuracin que se encuentra en Panel de Control > Herramientas administrativas >
Microsoft Dynamics AX Configuration Utility, en la pestaa Developer. Volveremos
sobre esta utilidad ms adelante, en este captulo. Si se elige una capa diferente de USR,
hay que configurar tambin la clave de licencia de esa capa, que Microsoft entrega al
partner junto a la licencia de la aplicacin. Evidentemente, Microsoft slo nos entrega
los cdigos de las capas a las que tenemos acceso.
Veamos un ejemplo supuesto de este funcionamiento:
En la aplicacin estndar (SYS), el cdigo de cliente se basa en un tipo de

datos string de 20 caracteres. Somos un partner (VAR), y nuestro cliente nos
ha pedido que lo ampliemos a 30 caracteres.
Vamos al tipo de datos que corresponde y cambiamos la propiedad de 20 a

30 caracteres. En este momento, el sistema crea una copia del tipo de datos
en la capa VAR con el nuevo valor actualizado. Al compilar el objeto, el
compilador utiliza la copia de la capa ms alta (la nueva) y sincroniza todo
el sistema con el nuevo cdigo de cliente de 30 caracteres, incluyendo los
campos de las tablas en Microsoft SQL Server al sincronizar la base de datos,
e incluyendo tambin todos los campos que representan un cdigo de cliente
en todas las tablas de la aplicacin y en formularios. Veremos cmo se
consigue esto ms adelante.
Supongamos que en una prxima versin del producto, Microsoft cambia

este valor a 50 caracteres. La utilidad de actualizacin de versiones detectara
un conflicto de propiedades entre capas, ya que el estndar quiere
modificarlo a 50 pero detecta que nosotros ya habamos hecho un cambio
sobre esa propiedad.
En ese momento sabemos que el estndar ha modificado un objeto que

nosotros a su vez habamos modificado en una capa superior, y tenemos la
posibilidad de mantener nuestro cambio (y dejarlo con 30 caracteres en la
capa superior) o eliminar nuestra capa y volver a la versin estndar. Esto
ltimo cambiara el campo a los nuevos 50 caracteres y evitara que el
sistema entre en conflicto en futuras actualizaciones. Si Microsoft vuelve a
cambiar esta propiedad o cualquier otra cosa en ese objeto la actualizacin
ser directa, ya a partir de ese momento no habr conflicto entre capas.
2.2.- Modelos
Un modelo es una agrupacin de objetos en una capa. Los modelos se han aadido en
esta versin para facilitar el despliegue y la integracin de funcionalidades de varios
fabricantes y evitar problemas a los que, de forma histrica, nos estamos enfrentando
desde las versiones iniciales de Microsoft Dynamics AX.
Como veremos en el captulo 3 Herramientas de desarrollo, la inclusin de los
modelos en el sistema es un cambio interno muy importante respecto a las versiones
previas del producto que, si bien no soluciona todos los problemas, s mejora mucho el
procedimiento y permite metodologas ms avanzadas (cercanas a la integracin
continua, incluso).
3.- INSTALACIN Y CONFIGURACIN BSICA
Como hemos visto a lo largo de este captulo, para que una instalacin de Microsoft
Dynamics AX sea funcional es necesario instalar y configurar unos componentes
mnimos: Un cliente, un servicio AOS y una base de datos.
El programa de instalacin incluye una instalacin simplificada (slo para entornos
64 bits) llamada Instalacin en un solo equipo, aunque es preferible realizar una
instalacin manual, ya que permite mayor flexibilidad. Adems, es algo que se tendr
que realizar muchas veces durante el trabajo con Microsoft Dynamics AX y es bueno
dominar el proceso en cualquier situacin.
Lo que vamos a ver, es una versin muy simplificada del proceso de instalacin y
configuracin bsica, la parte de la instalacin y configuracin que es relevante para un
desarrollador. Se pueden encontrar todos los detalles en la Gua de instalacin oficial,
enlazada al principio de este captulo.
3.1.- Instalacin
Ahora que estamos familiarizados con los componentes de Microsoft Dynamics AX,
vamos a realizar una instalacin personalizada para disponer de un entorno de pruebas
que nos servir durante el resto de captulos.
Figura 4.- Programa de instalacin de Microsoft Dynamics AX 2012
Para ello iniciaremos el programa de instalacin de Microsoft Dynamics AX 2012

desde el DVD o la ISO descargable (Figura 4), elegimos la opcin Instalar Componentes
de Microsoft Dynamics AX, y despus Instalacin personalizada, donde nos permite
escoger los componentes a instalar (Figura 5).
Como ya hemos comentado, estos componentes se pueden instalar en un solo
servidor, o en servidores diferentes ejecutando este instalador en cada uno de ellos. Para
la instalacin ms sencilla (mnima) elegiremos los siguientes:
Bases de datos
Application Object Server (AOS)
Cliente
Herramientas para programadores (al marcar esta opcin se marcan todos los
componentes necesarios para el desarrollo). Esta parte no es necesaria para
una instalacin mnima, o de produccin, pero s para una instalacin de
desarrollo como es nuestro caso (ver Figura 5).
Figura 5.- Seleccin de componentes de Microsoft Dynamics AX 2012
Despus de este paso, el instalador llega al punto ms crtico y desconcertante de la

instalacin, que es la validacin de requisitos previos. Desde este formulario se validan
los componentes previos necesarios para que funcionen los componentes que hemos
elegido en el paso anterior, por lo que la validacin cambia segn los componentes que
vayamos a instalar, y no ser necesario instalarlos todos en todos los servidores si se opta
por una instalacin distribuida.
Si bien este paso se ha simplificado mucho en esta versin, sigue siendo algo molesto.
En cada componente, aparte de marcar si ya est instalado o no, para los componentes
no instalados ofrece la posibilidad de instalarlos automticamente o directamente un

enlace que nos lleva a la pgina de descarga del componente concreto (ver Figura 6).
Figura 6.- Validacin de requisitos previos
3.2.- Configuracin
Una vez instalados, es necesario configurar los componentes, bsicamente para indicar
a cada uno dnde estn instalados los otros. Tambin se pueden configurar diversos
parmetros que sern tiles para la optimizacin, aunque no vamos a verlos todos al
detalle.
Toda la configuracin de Microsoft Dynamics AX 2012 se encuentra en las
Herramientas administrativas del Panel de Control de Windows de cada servidor,
separado en dos utilidades, dependiendo de los componentes instalados en cada uno:
Microsoft Dynamics AX 2012 Server Configuration: Esta utilidad se

encuentra en los servidores donde se haya instalado un AOS y sirve para
configurar este servicio. Es lo que llamaremos la configuracin del servidor.
Microsoft Dynamics AX 2012 Configuration: Esta utilidad se encuentra en

los equipos (clientes o servidores) donde se ha instalado algn cliente de
Microsoft Dynamics AX, ya sea el cliente de Windows o el .NET Business
Connector. Esto es lo que llamamos la configuracin del cliente.
3.2.1.- Configuracin del servidor (AOS)
Desde esta utilidad podemos configurar todos los servicios AOS que haya instalados en
un servidor (es habitual que haya ms de uno, sobre todo en entornos de desarrollo o
preproduccin). Contiene diversos parmetros que deciden ciertos comportamientos del
servicio. Los que nos interesan, de momento, son los siguientes:
Application Object Server Instance: Si en el servidor hay instalado ms de

un servicio, desde aqu podemos elegir cul de ellos queremos configurar.
Configuration: Podemos tener diferentes combinaciones de configuracin

almacenadas de manera que despus las podamos elegir en este desplegable
para cambiar entre ellas fcilmente. Es ms til en la configuracin de cliente
ya que la configuracin del servidor no suele cambiarse.
Application Object Server
o TCP/IP port y Services WSDL port: Indican el puerto de escucha

del AOS y de los servicios web asociados a esa instancia de AOS.
Estos puertos se indican en el proceso de instalacin aunque pueden
cambiarse siempre que no se repitan entre instancias en ejecucin
en el mismo servidor.
o Enable breakpoints to debug X++ code running on this server:

Este parmetro nos permitir incluir breakpoints desde nuestro
cliente, para poder depurar cdigo que se ejecuta en el servidor. Se
debe activar siempre en servidores de desarrollo, nunca en
produccin.
o Enable global breakpoints: Este parmetro es necesario para poder

depurar el cdigo invocado desde los Query Services. La mayor
parte de estas llamadas son las realizadas por Reporting Services, de
manera que este parmetro es importante para poder depurar los
informes que consumen estos servicios. Se debera activar siempre
en entornos de desarrollo, nunca en produccin.
o Enable the hot-swapping of assemblies for each development

session: Este parmetro nos permitir compilar y recompilar cdigo
en bibliotecas de .NET sin tener que reiniciar el AOS despus de
cada compilado (y generacin de una nueva versin del
ensamblado). Veremos su utilidad ms adelante. Es peligroso
activarlo en servidores de produccin, pero necesario en entornos
de desarrollo.
Database Connection
o Server name: Servidor Microsoft SQL Server donde estn las bases
de datos (incluida la Model Store a partir de AX 2012 R2).
o Database name: Nombre de la base de datos de Microsoft

Dynamics AX.
o Baseline database name: La base de datos baseline se utiliza para

el anlisis del cdigo durante la actualizacin de versiones
(upgrade). Contiene los metadatos de versiones anteriores y
sustituye a la antigua carpeta Old, que resida en la carpeta de la
aplicacin en el disco. Los datos importados se guardan en esta base
de datos que tiene la misma estructura que la Model Store para poder
compararlos antes de su integracin.
El resto de opciones las dejaremos en sus valores por defecto de momento, iremos
viendo algunas de ellas durante el resto del libro, aunque estn ms dedicadas a la
administracin y optimizacin del rendimiento que al desarrollo propiamente dicho.
3.2.2.- Configuracin del cliente

Desde esta utilidad configuramos a qu servidores AOS se conecta nuestro cliente, y
cmo el cliente se conecta a este AOS. En esta utilidad s es conveniente tener diferentes
configuraciones guardadas para poder cambiar rpidamente entre ellas. Por ejemplo, a
qu servidor conectar (como decamos antes, es comn tener varios) o el modo en que
nos conectamos a ellos (por ejemplo: para usar como un usuario normal o como
desarrollador, o para conectar a una capa u otra).
En la parte superior del formulario, Active configuration store indica de dnde se
est leyendo la configuracin. Por defecto el valor es [Registry], lo que implica que se
est utilizando informacin del registro de Windows del usuario activo en esta sesin.
Se puede cambiar este valor, para que el usuario utilice un fichero de configuracin
compartido, mediante la funcin del botn Manage > Set Configuration Store y
seleccionando un fichero de configuracin guardado previamente en una ruta de red. Si
se quiere volver a la configuracin propia para el usuario, se utilizar esta misma funcin
dejando en blanco la ruta del fichero.
En Configuration Target elegimos si la configuracin activa aplica al cliente
Windows (Local client) o al .NET Business Connector, y en Configuration elegimos
cul de las configuraciones disponibles estar activa actualmente para los clientes que se
ejecuten en la sesin. Suele haber diferentes configuraciones por servidor, entorno,
capas, etc. Por ejemplo: Servidor desarrollo capa VAR; Servidor produccin capa USR,
etc.
En las pestaas de configuracin encontramos los siguientes valores que son de
nuestro inters:
General: En esta pestaa configuramos las opciones generales de la

conexin a una aplicacin. Los ms importantes son:
o Partition y Company que indican la particin y la empresa activa

al iniciar la sesin. La empresa se puede cambiar en cualquier
momento desde el cliente Windows, pero la Particin slo puede
configurarse desde aqu.
o En Command to run at application startup se pueden configurar

parmetros que se pasarn al ejecutable y que se pueden recoger
desde X++ para ejecutar acciones al inicio de la aplicacin. Ver
clase SysStartupCmd y derivadas. Tambin se puede configurar un
mensaje que se mostrar al inicio y puede servir para identificar
entornos fcilmente (Startup message)
Connection: En esta pestaa se configura la lista de AOS a los que se

conectar mediante esta configuracin. El cliente intentar conectar al
primero, si la conexin no es posible continuar intentndolo con el
siguiente, etc.
Los datos importantes de la conexin son el nombre del servidor donde

est instalado el AOS y los puertos TCP/IP y WDSL que tiene configurados
ese servidor. Tambin se especifica el nombre de la instancia que, aunque
no es imprescindible para la conexin, servir para identificar el servidor al
que estamos conectados cuando estemos usando el cliente (ver Figura 7).
Tambin indicamos si se permite la impresin en las impresoras del servidor

(Connect to printers on the server) y si se encripta la conexin cliente-
servidor (Encrypt client to server communication). La primera debe
activarse en servidores de produccin aunque puede desactivarse en
servidores de desarrollo o pruebas para mejorar el rendimiento. La segunda
se suele activar en cualquier caso.
Developer
o Enable user breakpoints to debug code in the Business

Connector: Permite la interrupcin mediante breakpoints del
cdigo X++ ejecutado por sesiones del .NET Business Connector.
Slo se debe activar en entornos de desarrollo si se utiliza el .NET
BC. Nunca en produccin.
o Enable global breakpoints to debug code running in the

Business Connector or client: Permite la interrupcin mediante
breakpoints del cdigo X++ ejecutado por sesiones del .NET BC,
o del cliente Windows. Se debe activar en todos los entornos de
desarrollo, pero nunca en produccin. Para poder depurar las
sesiones de .NET BC es necesario activar estas dos ltimas
opciones; para depurar el cdigo del cliente, slo es necesario

marcar sta.
o Application object layer to open: Desde esta opcin se elige la

capa de objetos de aplicacin (ver Figura 3) a la que se conecta esta
configuracin.
La capa de desarrollo no se puede cambiar durante la sesin y para

conectar a varias capas, ser necesario abrir diferentes sesiones
modificando esta propiedad. Una vez abierta la sesin, cualquier
modificacin en los objetos del AOT se almacenar en esta capa.
o Development license code: Para poder utilizar capas de objetos de

la aplicacin superiores a USR, es necesario indicar una clave de
licencia (un cdigo alfanumrico). Estas claves las proporciona
Microsoft junto a la licencia de la aplicacin y son distribuidas por
el partner al cliente dependiendo de su contrato. No es posible
acceder a una capa para la que no se tiene clave de licencia.
Suelen almacenarse aqu diferentes configuraciones por capa con

sus cdigos de licencia para evitar recordarlos cada vez. Esto es
perfectamente normal pero cabe recordar que cualquier usuario que
tenga acceso a este formulario podr conectar con cualquiera de las
configuraciones almacenadas sin conocer la clave de licencia
correspondiente (que estar aqu guardado), e incluso podr
exportar la configuracin y llevrsela a otro equipo, por lo que
conviene proteger debidamente este acceso.
Lo que hemos visto en este punto se refiere a la configuracin necesaria para que el
cliente de Microsoft Dynamics AX 2012 para Windows se conecte a un servidor AOS.
Esta configuracin es obligatoria para empezar a trabajar, pero hay tambin una
configuracin que, como desarrolladores, es muy interesante, aunque no obligatoria. Me
refiero a mostrar informacin relevante en la barra de estado del cliente (ver Figura 7).
Ya hemos comentado varias veces que es comn tener diferentes entornos (para
desarrollo, para pruebas, el entorno real en produccin,), hemos hablado de conectar
a una u otra capa y de guardar nuestros desarrollos en un modelo. A nivel funcional,
como veremos, los datos que nos muestra el cliente estn asignados a una empresa, que
a su vez trabaja en una divisa (euros, dlares, etc.). Toda esta informacin puede ser
confusa, sobre todo si nuestros entornos no son iguales. Y no queremos entrar a un
entorno para hacer una prueba, y borrar por accidente datos de la aplicacin real. Para
esto es importante tener bien configurados los datos que nos muestra la barra de estado.
Esta configuracin se realiza para cada usuario, de manera que configurarla a nuestro
modo no va a afectar a cmo la ven los dems. Se encuentra en el cliente para Windows,
en Archivo > Herramientas > Opciones (o slo Herramientas > Opciones, en el entorno
de desarrollo), dentro de la pestaa Barra de estado.
Figura 7.- Barra de estado
Opciones interesantes y recomendadas para un desarrollador son, como mnimo, las

siguientes (ver Figura 7):
Mostrar actividad: Indica de manera grfica cundo el cliente est enviando

o recibiendo comunicacin del servidor AOS. Es til para ver si el cliente se
ha bloqueado o est procesando algo.
Mostrar capa de actividad: Revela la capa de objetos de la aplicacin a la

que estamos conectados (usr en la Figura 7 de ejemplo).
Mostrar cuenta de empresa: Nos dice la empresa en la que estamos

trabajando. Pulsando sobre ella (cec en la Figura 7 de ejemplo) podemos
cambiar de empresa rpidamente.
Mostrar id. de usuario: Nos informa del usuario con el que estamos
trabajando. Es til si trabajamos con varios usuarios, por ejemplo, para hacer
pruebas de seguridad y permisos.
Mostrar el nombre de AOS: Indica el AOS al que estamos conectados.

Muy til para saber siempre en qu entorno estamos (desarrollo, pruebas,
produccin,). Se muestra el nombre que se ha indicado en la configuracin
del cliente.
Mostrar el modelo actual: Muestra el modelo al que estamos conectados.

A este modelo se asignarn por defecto todos los cambios de objetos que
hagamos en la sesin. Pulsando sobre l (Libro AX2012 en la Figura 7 de
ejemplo) podemos cambiar el modelo seleccionado en cualquier momento.
4.- FUNCIONALIDAD BSICA
Como comentbamos en el captulo anterior, una particularidad muy importante del

desarrollo sobre Microsoft Dynamics AX para desarrolladores que vienen de otros
entornos, es que las modificaciones deben convivir de manera transparente con el resto
del sistema, tanto con el estndar desarrollado por Microsoft, como con modificaciones
realizadas por otros desarrolladores, o incluso por otras empresas.
Es por esto que para entender el porqu de muchos de los conceptos que veremos
durante el resto del libro, es importante conocer y comprender cmo funciona Microsoft
Dynamics AX a nivel funcional, ya que estos patrones y funcionalidades genricas se
tienen que respetar y mantener en cualquier modificacin o ampliacin que realicemos

en el sistema.
Consejo: Al desarrollar sobre Microsoft Dynamics AX, el objetivo es que sea

imposible diferenciar, desde el punto de vista del usuario, lo que es la aplicacin
estndar de lo que est modificado o es nuevo.
4.1.- El cliente de Windows
El punto de entrada a la aplicacin que se encuentra un usuario es siempre parecido a la

figura 8. Las posibles variaciones que pueden repercutir en el entorno dependen
directamente de la licencia que tenga contratada la empresa cliente, y de los mdulos que
tenga activos cada usuario, ya sea por licencia, por configuracin o por permisos.
Figura 8.- Visin general de Microsoft Dynamics AX 2012
En este momento podemos diferenciar los componentes de ms alto nivel del cliente
Microsoft Dynamics AX 2012 que se muestran en el esquema de la figura 9.
Figura 9.- Componentes del cliente Microsoft Dynamics AX 2012

Barra de direccin: Muestra una direccin que representa la posicin actual

en la aplicacin. Se utiliza nicamente para la navegacin, de tres maneras
diferentes: Se puede escribir una direccin concreta; se puede hacer clic en
elementos de la direccin y navegar hacia atrs o desplegar un elemento
para ver otros elementos en el mismo nivel. Ver figura 10.
Figura 10.- Barra de direccin
Barra de bsqueda: Se puede utilizar para buscar datos, elementos de

men, o en la ayuda de la aplicacin. Para que funcione se debe configurar
de manera especfica el componente Enterprise Search.
Barra de men: En este espacio se encuentra el men Archivo, a la

izquierda, y los mens Ventanas, Ver y Ayuda a la derecha. Aparecen mens
extra asociados a formularios especficos.
Barra de estado: Muestra diferentes datos del estado de la aplicacin, la

conexin (ver Figura 7), y ayuda sobre los campos de los formularios al
posicionarnos sobre ellos.
Panel de navegacin: Muestra los mdulos que el cliente tiene habilitados

as como el men de cada mdulo y el men de elementos favoritos. Este
panel es muy configurable desde el men Ver, en la barra de men.
Panel de contenido: Es el espacio de trabajo de la aplicacin, donde se

muestran los formularios al abrirlos.
Una caracterstica muy importante de la presentacin de la aplicacin a los usuarios

es el concepto de Roles. La captura de pantalla de la figura 8 est tomada con una licencia
de desarrollador por lo que se puede apreciar en el panel de navegacin que tiene
disponibles todos los mdulos, pero cuando se configura la seguridad, cada usuario solo
ve los mdulos para los que tiene permiso, haciendo ms sencilla la navegacin.
Profundizaremos sobre esto en el captulo 10 Licencia, Configuracin y Seguridad.
4.2.- Tipos de formularios
La gran mayora de formularios del cliente para Windows siguen unos patrones de diseo
determinados por el tipo de formulario que representan. Es bueno conocerlos para
respetar estos patrones cuando realicemos modificaciones o cuando diseemos nuestros
propios formularios. La estructura tpica de formularios segn su tipo se muestra en la

figura 11.
Figura 11.- Tipos de formulario
4.2.1.- Pginas de rea
Las pginas de rea se muestran al elegir un mdulo funcional mediante el Panel de

navegacin o la Barra de direccin y son el punto de entrada a cada mdulo. La pgina
ofrece la misma informacin que el men correspondiente del Panel de navegacin.
Figura 12.- Ejemplo de Pgina de tipo rea. rea de clientes

Las pginas de rea se disean de forma automtica basndose en los mens

definidos para cada mdulo. Es importante mantener la misma estructura que los mens
estndar y ubicar los nuevos elementos en el grupo apropiado. De otra manera sera
imposible para el usuario encontrar un nuevo elemento dentro de la enorme cantidad de
opciones que presenta el men estndar, incluso despus de verlo limitado para un Rol
especfico. Los mens de cada rea se estructuran siempre en los siguientes grupos:
Comn: Contiene las funcionalidades ms importantes de cada mdulo. En

algunos casos estos elementos son los que se visualizan fuera de cualquier
carpeta y suelen ser los de uso ms habitual.
Diarios: Posee elementos de tipo diario, existentes en la mayora de

mdulos. Son los formularios genricos de introduccin y registro de
transacciones manuales (asientos contables, cobros, pagos, movimientos de
inventario, de produccin, recuentos, etc.,).
Consultas: Posee formularios normalmente de slo lectura, para la consulta

de transacciones existentes e histricas.
Informes: Contiene el acceso a los informes del mdulo.
Peridico: Engloba elementos que realizan una funcin, un proceso

especfico sobre algunas transacciones determinadas. Por ejemplo, registrar
facturas, o planificar la produccin.
Configurar: Incluye los elementos de configuracin y parmetros de cada

mdulo.
4.2.2.- Pginas Role Center
La pgina Role Center es la pantalla que se abre inicialmente al ejecutar la aplicacin o

al elegir la opcin Pgina principal en la barra de direccin y es diferente para cada Rol,
como se puede ver en la Figura 13.
La pgina Role Center debe contener informacin til para el usuario de ese Rol; tal
como, estadsticas, grficos, indicadores, y cualquier elemento de Business Intelligence
que aporte valor al usuario.
Son pginas Sharepoint, por lo que se disean utilizando los diferentes Web Parts
disponibles que se pueden configurar o desarrollar nuevos. La realizacin de nuevos Web
Parts es algo propio de Sharepoint y excede el alcance de este libro.
Figura 13.- Ejemplo de Pgina de tipo Role Center
4.2.3.- Pginas Lista y Detalle

Las pginas de Lista suelen ser el punto de acceso a la mayora de tareas. Siempre que
tengamos que empezar una tarea buscando un registro concreto debemos tener una lista.
Contienen una lista de registros que muestran unos cuantos campos significativos,
pueden incluir una pequea vista previa en la parte inferior, filtros en la parte superior,
y una barra lateral con informacin que es relevante para el registro seleccionado
llamadas FactBoxes (cajas de hechos). Ver Figura 14.
Figura 14.- Ejemplo de Pgina de tipo Lista. Lista de clientes

Las pginas Detalle son similares pero en vez de una lista de registros, muestran todos
los campos de un slo registro. En versiones anteriores, estos formularios se organizaban
en pestaas, el nuevo diseo en Microsoft Dynamics AX 2012 se organiza mediante reas
desplegables llamadas FastTabs. Estos controles actan como pestaas, con la diferencia
de que se pueden desplegar varios a la vez y de que pueden mostrar algunos elementos
de resumen mientras estn cerradas. Ver Figura 15.
Figura 15.- Ejemplo de Pgina de tipo Detalle. Detalles de cliente
Se pueden editar varios registros a la vez utilizando la nueva Vista de cuadrcula,

mediante el botn correspondiente en la barra de estado.
Las botoneras que siempre hemos tenido disponibles a la derecha en los formularios,
en esta versin se han sustituido por el panel de acciones de la parte superior, con un
diseo tipo Ribbon similar a otros productos de Microsoft como el paquete Microsoft
Office.
Otra particularidad de Microsoft Dynamics AX 2012 es que los formularios se abren
por defecto en modo slo lectura. Para editar la informacin es necesario cambiar a
modo edicin mediante el botn de la barra de estado, el del panel de acciones (parte
superior) o mediante el atajo de teclado Ctrl+Shift+E. Cada usuario puede configurar
este comportamiento en las opciones de usuario, segn sus preferencias.
4.2.4.- Pginas Detalle con Transacciones
Estas son las pginas con formato maestro-detalle que podemos encontrar de manera
habitual en la aplicacin. En la figura 16 se puede ver un formulario de pedido de ventas
en modo edicin, donde se aprecian los datos de la cabecera y las lneas.
Figura 16.- Ejemplo de pgina de tipo Detalle con Transacciones. Pedidos de venta
Como novedad, podemos utilizar los nuevos FastTabs para plegar y desplegar las
reas de cabecera, lista de lneas y detalle de lneas, como se aprecia en la figura 17, sin
cambiar de formulario. Tambin podemos observar que se ha sustituido la botonera en
la parte derecha de versiones anteriores, por grupos de botones localizados a nivel de
lnea.
Figura 17.- Ejemplo de pgina de tipo Detalle con Transacciones. Lneas de pedido
Al modificar o disear nuevas pginas Detalle con Transacciones, hay que tener en
cuenta que a menudo son los formularios ms utilizados de la aplicacin. La mayora
de usuarios pasan gran parte de sus horas de trabajo utilizando formularios de este tipo
y por eso tanto su usabilidad como su rendimiento es crtico.
4.2.5.- Pginas especiales

Otra novedad de Microsoft Dynamics AX 2012 es el diseo especial que se ha llevado a
cabo en muchos formularios utilizando nuevos controles, y que es de agradecer, ya que
facilita la comprensin y el manejo de los datos representados. Reduce errores
provocados por la dificultad que haba en algunos casos para comprobar su coherencia.
En su mayora son formularios de configuracin, por ejemplo, ver figura 18.
Figura 18.- Ejemplo de pgina especial. Configuracin de estructuras contables
4.2.6.- Pginas en Enterprise Portal

No entraremos en detalle sobre el diseo para Enterprise Portal, pero es importante saber
que casi toda la aplicacin Microsoft Dynamics AX 2012 es utilizable mediante el cliente
web y por tanto existen tambin diferentes pantallas diseadas especialmente para este
uso, como vemos en la Figura 19.
Figura 19.- Ejemplo de pgina en Enterprise Portal. Pedido de ventas

A pesar de que la usabilidad del cliente Enterprise Portal tiene las particularidades
propias de ejecutarse en un navegador, el diseo y la organizacin de todos los
componentes debe mantenerse coherente con el diseo del cliente para Windows.
4.3.- Navegacin
Otra funcionalidad general que es importante mantener siempre que hagamos

modificaciones, es la navegacin del usuario a travs de los formularios y datos de la
aplicacin.
La base de la navegacin en Microsoft Dynamics AX 2012 son el Panel de
navegacin y la Barra de direccin que ya hemos visto. Podramos decir que son el
principio de cualquier accin, desde donde el usuario empieza el flujo de trabajo para
llevar a cabo sus tareas, pero el sistema no sera tan usable si hubiera que recurrir al men
en cada accin a realizar.
Gran parte de la fluidez en el trabajo con la aplicacin se basa en la navegacin entre
formularios permitiendo que un usuario profundice en los datos que est viendo para
llegar al mximo detalle posible. Esta funcionalidad siempre se ha llamado Ir al
formulario de la tabla principal en versiones anteriores, aunque en esta ltima se ha
resumido en Ver detalles. Ver figura 20.
Esta opcin de men existe en el men contextual de cualquier campo, en cualquier
formulario e incluso en muchos informes, siempre que el campo represente la clave
primaria de una tabla. Al pulsarlo nos llevar al formulario principal que represente esta
tabla. Como hemos visto en la Figura 20, si en el campo Cuenta de cliente representado
en cualquier formulario utilizamos la opcin Ver detalles, iremos al formulario de
clientes y ste se posicionar en el cliente que estbamos viendo.
Figura 20.- Ver detalles. Base de la navegacin en Microsoft Dynamics AX
Esta funcionalidad existe de manera nativa en todos los objetos estndar y existir en
todos los desarrollados siempre que stos se creen siguiendo las buenas prcticas de
desarrollo al respecto, haciendo saber al sistema las relaciones entre los datos y los
objetos implicados para representarlos, como veremos ms adelante.
Enlace: Best Practices for Microsoft Dynamics AX Development
http://msdn.microsoft.com/en-us/library/aa658028.aspx
4.4.- Filtrado, ordenacin y seleccin de datos
Una aplicacin como Microsoft Dynamics AX est diseada para manejar una gran
cantidad de datos, por lo que disponer de diversas y potentes opciones para filtrar estos
datos es obligatorio. Las opciones de filtrado han sido notablemente mejoradas en
Microsoft Dynamics AX 2012.
La forma ms comnmente utilizada es emplear el men contextual de cualquier
campo, en cualquier formulario. Como se puede ver en la Figura 20, existen cuatro
opciones referentes al filtrado y dos ms referentes a la ordenacin, que se repiten a lo
largo de la aplicacin. Todas estas opciones se basan en el Query Framework que
veremos ms adelante.
Filtrar por campo: Muestra un dilogo de texto en el que podremos escribir

una cadena de bsqueda sobre el campo seleccionado.
Filtrar por seleccin: Es similar al anterior pero no muestra ningn dilogo,

sino que filtra el campo seleccionado utilizando como cadena de bsqueda
el texto que actualmente haya en el propio campo.
Guardar filtro como: Como veremos ms adelante, los filtros que

utilizamos en formularios e informes pueden guardarse para que el usuario
pueda reutilizarlos en el futuro.
Quitar filtro/Ordenar: Elimina cualquier opcin de filtro y/o ordenacin

que actualmente est activa en el formulario, volviendo a los datos que se
muestran por defecto al ejecutarlo.
Orden ascendente/descendente: Ordena los datos del formulario por el

campo que est seleccionado.
Figura 21.- Opciones de filtrado. Filtro de cuadrcula activado.
Aparte de estas conocidas opciones del men contextual, en las pginas de lista que
ya hemos visto hay un rea especfica para las opciones de filtrado (ver figura 21). Lo
ms evidente es una caja de texto donde escribir la cadena de bsqueda y un selector con
los campos de filtro recomendados para ese formulario, aunque se puede elegir cualquier
campo.
Tambin vemos una pequea botonera con cuatro opciones similares a las que ya
hemos comentado:
Filtrar por seleccin: mismo funcionamiento que en el men contextual.
Filtrar por cuadrcula: activa el filtro por cuadrcula del formulario. Ver
figura 21.
Este filtro aade una nueva fila al grid del formulario, permitiendo escribir
una cadena de filtro en la partes superior de cada columna, y permitiendo
tambin que se puedan ver fcilmente los filtros activos.
Ordenacin/filtro avanzados: abre el formulario de opciones avanzadas

de filtrado. Ver figura 22.
Este formulario muestra la potencia de Microsoft Dynamics AX en cuanto al

filtrado de datos. Mediante este formulario podemos consultar, desde las
tablas implicadas en la consulta en la que se basa el filtro, hasta todos los
filtros activos sobre cualquier campo, as como la ordenacin.
En la pestaa Intervalo podemos consultar los filtros y aadir nuevos.

Cualquier campo de las tablas que se muestran en el rbol de la consulta se
puede agregar para filtrar por l y tambin para ordenar. En la pestaa
Ordenacin tenemos los campos por los que se ordena el resultado, y en la
pestaa Opciones de fecha tenemos una novedad de Microsoft Dynamics AX
2012 para mostrar slo datos vigentes en un rango de fechas. Todo esto lo
veremos en detalle en captulos sucesivos.
Tambin disponemos del men Modificar que incluye opciones de guardado

de filtros. Mediante estas opciones podemos guardar diferentes
configuraciones de filtrado para la consulta en cuestin, de manera que
podamos reutilizarlos ms adelante simplemente eligindolos en el
desplegable Seleccionar consulta.
Quitar filtro/Ordenar: mismo funcionamiento que en el men contextual.
Figura 22.- Opciones de filtro avanzadas

Otra opcin es el men contextual de filtros que aparece al pulsar el texto en color
verde que describe el filtro activo en el formulario (ver Figura 23).
Figura 23.- Opciones de filtrado completas
Todas las opciones que se incluyen en este men referentes a filtros, a ordenacin y
al guardado de filtros ya las hemos visto y su funcionamiento es el mismo, aunque este
punto de men puede ser ms accesible en algunos casos.
Consejo: Toda esta funcionalidad es uno de los puntos fuertes de la usabilidad

de Microsoft Dynamics AX, por lo que hemos de respetarla en todos los desarrollos
que hagamos que requieran de una seleccin de datos, como procesos, informes o
formularios de tipo lista.
El usuario espera una consulta cuando ejecuta un proceso, por lo que no
incluirla podra inducirlo a error o a confirmar acciones no deseadas.
4.4.1.- Opciones de la cadena de bsqueda
Al filtrar datos, tanto a nivel funcional como estamos viendo aqu, como a nivel de
programacin como veremos ms adelante, podemos utilizar una serie de comodines y
estructuras para realizar filtros complejos sobre los campos, similares a una especie de
SQL simplificado o incluso expresiones regulares sencillas.
Los comodines son los tpicos, a saber, asterisco (*) y signo de interrogacin (?) que
representan a cualquier texto, el primero, y a cualquier carcter (slo uno) el segundo.
De esta forma, para buscar todos los clientes que empiecen por A utilizaremos el texto
A*, ya que el texto A? slo devolvera los clientes que empiecen por A y slo tengan
dos caracteres.
Aparte de esto, podemos utilizar dos puntos normales seguidos (..) para representar
rangos. Estos rangos aplican a cualquier tipo de dato, desde nmeros, textos, hasta
cadenas y fechas. As, la cadena de texto A*..C* representa todos los clientes que
empiecen por A, B o C, la cadena 01/01/2013..31/01/2013 representa todos los das
del mes de enero de 2013 y la cadena 120..150 representa todos los nmeros entre 120
y 150, ambos inclusive. El rango puede estar abierto por alguno de sus lados, por ejemplo
para mostrar todos los registros desde principios de 2013 hasta hoy, usamos la cadena
01012013... El sistema es capaz de interpretar y convertir fechas sin utilizar las
barras inclinadas para representarlas, incluso es capaz de corregir algunas fechas
errneas. Por ejemplo, si en un campo de tipo fecha escribimos 300213 el sistema se dar
cuenta de que no existe el 30 de febrero y resolver la fecha 29 de febrero de 2013 como
el ltimo da del mes indicado.
Otra posibilidad es que queramos mostrar varios valores que no representen un rango
continuo, sino una lista de valores discretos o de otros rangos. Para eso usaremos varios
filtros separados por comas (,). Por ejemplo, para mostrar solamente los clientes C2 y
C4 usamos la cadena C2,C4 y para buscar los clientes que empiezan por X y los que
terminan en J usamos la cadena X*,*J.
Por ltimo, podemos utilizar el smbolo de exclamacin (!) para negar el resultado de
un rango, esto es, para mostrar los registros que no lo cumplen. Por ejemplo, para
obtener los artculos que no empiezan por A, usamos la cadena !A*.
Resumen: Opciones bsicas de la cadena de bsqueda
Caracteres comodn: * y ? (cualquier carcter o un solo carcter)
Rangos: X .. Y (dos puntos)
Unin de conjuntos: R1, R2 (coma)
Negacin: ! (exclamacin)
Estas cadenas de bsqueda se convierten en sentencias where de SQL que se

envan al servidor de base de datos. Las podemos aplicar en cualquier campo de
cualquier formulario, y en cualquier combinacin de cualquiera de los campos de
cualquier tabla. Es muy importante reflexionar sobre la afirmacin anterior. Abusar de
los filtros en tablas grandes y/o en campos no indexados puede tener consecuencias
graves en el rendimiento de la aplicacin.
4.4.2.- Seleccin de registros
La seleccin de registros en Microsoft Dynamics AX sigue las directivas de usabilidad

generales de Windows. Esto es, se pueden seleccionar rangos de registros consecutivos
utilizando el ratn y la tecla de maysculas (Shift) y tambin se pueden seleccionar
registros de manera no consecutiva utilizando el ratn y la tecla Control.
Hasta aqu todo normal. Aparte de esto, una novedad de Microsoft Dynamics AX 2012
es la nueva seccin izquierda de las listas de registros, que al pulsarlas activarn un check
en cada registro el cual posibilita su seleccin sin necesidad de usar la tecla Ctrl. Esto
nos permite algunas selecciones que no se podan realizar anteriormente, como por
ejemplo seleccionar un rango con la tecla de maysculas, y luego eliminar algunos

registros de la seleccin a discrecin mediante estos checks. Ver figura 24.
Figura 24.- Seleccin mltiple de registros
Tambin se ha aadido un check en la esquina superior-izquierda de las listas, donde

antes estaba el cuadrado de Seleccionar todo que selecciona todos los registros que se
estn visualizando en este momento en el Grid. No se marcarn los registros que no
cumplan el filtro actual. Si se eliminan los filtros actuales se volvern a mostrar todos
los registros, aunque la seleccin realizada previamente se conservar.
Podemos conseguir unas selecciones de registros muy flexibles combinando todas
estas opciones de seleccin, con las mltiples opciones de filtrado que ya hemos visto.
Creamos los mejores cursos online en espaol para programadores
Por qu aprender con nosotros?

Porque creamos cursos online de calidad contrastada cuyos autores y
tutores son reconocidos expertos del sector, aprenders a tu ritmo de la
mano de un verdadero especialista y dejars de dar tumbos por internet
buscando cmo se hace cualquier cosa que necesites.
Quieres ms razones? Haz click aqu
Descubre nuestro catlogo!
Descubre tambin nuestros

Libros para programadores

Desarrollo en Dynamics AX 2012 Jose Antonio Estevan Krasis Press Scribd PDF

Cargado por

Copyright:

Formatos disponibles

Desarrollo en Dynamics AX 2012 Jose Antonio Estevan Krasis Press Scribd PDF

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Desarrollo en Dynamics AX 2012 Jose Antonio Estevan Krasis Press Scribd PDF

Cargado por

Copyright:

Formatos disponibles

Desarrollo en Microsoft

Jos Antonio Estevan Estevan

DERECHOS RESERVADOS 2014, respecto a la primera edicin en espaol, por

Diseo Cubierta: Pablo Iglesias Francisco y Natalia Matesanz Urea

Por qu aprender con nosotros?

buscando cmo se hace cualquier cosa que necesites.

Quieres ms razones? Haz click aqu

Descubre nuestro catlogo!

Descubre tambin nuestros

Y por supuesto a Sulaica, que me anim a empezar, ha soportado

La teora es cuando se sabe todo y nada funciona.

CAPTULO-1: INTRODUCCIN ...........................................................................13

1.- Qu es este libro? Quin debera leerlo?......................................................................... 13

CAPTULO-2: CONOCIENDO LA APLICACIN ..............................................23

1.- Arquitectura Externa (fsica)................................................................................................... 24

CAPTULO-3: HERRAMIENTAS DE DESARROLLO ..........................................55

1.- Espacio de trabajo de desarrollo ........................................................................................... 55

2.4.- Formularios (Forms) ..................................................................................................... 61

9.4.- Aadir, renombrar y eliminar objetos .................................................................... 112

CAPTULO-4: EL LENGUAJE X++ .......................................................................153

1.- Introduccin.............................................................................................................................. 153

6.- Macros ........................................................................................................................................ 174

CAPTULO-5: EL MODELO DE DATOS .............................................................211

1.- Introduccin.............................................................................................................................. 211

CAPTULO-6: LA INTERFAZ DE USUARIO (FORMULARIOS) ....................257

1.- Introduccin.............................................................................................................................. 257

CAPTULO-7: FRAMEWORKS .............................................................................303

1.- Introduccin.............................................................................................................................. 303

CAPTULO-8: INTEGRACIN CON .NET Y SERVICIOS WEB ....................331

1.- Compilador de X++ vs Cdigo CIL ................................................................................... 331

4.- Servicios web y Excel! ........................................................................................................... 358

1.- Introduccin.............................................................................................................................. 361

CAPTULO-10: LICENCIA, CONFIGURACIN Y SEGURIDAD ...................397

1.- Introduccin.............................................................................................................................. 397

NDICE ANALTICO ...............................................................................................421

de plasmar las necesidades de todo tipo de organizaciones y sectores de actividad.

1.- QU ES ESTE LIBRO? QUIN DEBERA LEERLO?

2.- QU NO ES ESTE LIBRO?

Enlace: Microsoft Dynamics Resource Library

Lo que se debe esperar de cada uno de ellos es lo siguiente:

1. Introduccin (Este captulo).

2. Conociendo la aplicacin: En este captulo se introduce la infraestructura

3. Herramientas de desarrollo: En este captulo se detallan todas las

4. El lenguaje X++: Captulo dedicado exclusivamente a explicar las

5. El modelo de datos: Dedicado a todos los componentes de los que

6. La interfaz de usuario: Dedicado al diseo de la parte visual de la

7. Frameworks: Se explican los diferentes frameworks de desarrollo de los que

8. Integracin con .NET y Servicios Web: Captulo dedicado a la integracin

9. Informes: Dedicado al framework de desarrollo de informes basado en

10. Licencia, Configuracin y Seguridad: Por ltimo detallamos las opciones

esta manera la experiencia de usuario principalmente mediante controles de

4.- LETS CODE!

4.1.- El entorno (requerimientos)

La mquina virtual no necesita instalacin, se puede hacer funcionar directamente,

Enlace: Microsoft Dynamics Lifecycle Services

Durante el proceso de escribir todos los captulos he ido actualizando la mquina

(Feature Pack 1, 6.0.947.862) hasta AX 2012 R3 (6.3.164.0) en Azure! Dado que no se

4.2.- Hola mundo!

Lo primero es abrir un entorno de desarrollo, esto lo podemos hacer de varias