Dynamics NAV blog Español

Uso de controles extendidos en NAV 2009 R2 III

2012-02-01T04:03:00.000-08:00

Hola,

Continuamos con el ejemplo de este nuevo control extendido en C#. A continuación vamos a ver cómo desarrollar la parte de la lógica del control en C# e integrar la comunicación con Dynamics NAV correctamente. Para poder hacer un control extendido, hay que tener en cuenta los siguientes pasos fundamentales, hago un repaso rápido:

Nuestro proyecto tiene que tener referencia a la librería Microsoft.Dynamics.Framework.UI.Extensibility.
Nuestro proyecto debe encontrarse firmado.
No olvidar la sentencia [ControlAddInExport("NombreParaNav")]
Heredar la clase StringControlAddInBase

Todo esto se puede ver en más detalle en el post que publiqué hace bastante tiempo referente a los controles añadidos aquí.

Una vez que tenemos establecidas las bases necesarias para nuestro control, tenemos que definirlo. Para ello, vamos a utilizar un control que ya existe en el cliente de Roles, y vamos a modificar su comportamiento para que pueda hacer más acciones, el control a utilizar es la pila de documentos (stack, en inglés).

La librería que contiene los controles del cliente de roles, se denomina Microsoft.Dynamics.Framework.UI.Winforms.Controls, agregamos la refenrencia a nuestro proyecto.

Añadimos las sentencias Using para poder utilizar las clases correspondientes:

En este punto, establecemos el objeto que será la base de nuestro control extendido, y uno del tipo String para poder almacenar la ruta de fichero de texto que se arrastra dentro de nuestro objeto, y que regresará a Dynamics NAV para poder crear el vínculo.

Ahora tenemos que definir la construcción y creación de nuestro control, estableciendo el aspecto y eventos disponibles del mismo.

Algunos aspectos importantes a destacar de este proceso. Para poder utilizar la pila de documentos, (objeto stack) tenemos que utilizar también el objeto StackRenderer, que es el que se encarga de gestionar la visualización de la pila de documentos. Además de las propiedades mas habituales de cualquier control C# (posición, permitir arrastrar encima, transparencia…), la parte importante es añadir los dos eventos nuevos de arrastre DragDrop y DragEnter, para añadir este nuevo comportamiento a nuestro control. También es fundamental activar la propiedad AllowDrop a true.

NOTA: Aunque aparece disponible, no he conseguido acceder al parent del control ni nada parecido, se encuentra protegido. El cliente de NAV cerrará inmediatamente si intentamos acceder de esta forma a algún componente del cliente de roles.

Ahora llega el punto directamente relacionado con NAV, como podemos acceder desde NAV al control y viceversa? Pues bien, por un lado tenemos la propiedad Value del control que corresponde con el SourceExpresion que indiquemos al control desde NAV. Para ella, definiremos que el numero de documentos en pila corresponda con el SourceExpr de NAV.

Hasta aquí la propiedad Value es la misma que tratamos en el post anterior.

Ahora bien, tenemos que comunicar el control con NAV en algún punto, es decir, cuando se produzca el evento de arrastrar encima, tenemos que añadir la ruta obtenida del fichero a NAV para que cree un vínculo.

Para ello, por un lado dentro de NAV disponemos de un evento genérico para todos los controles de nuestras páginas OnControlAddIn. Dentro de ese evento, hacemos un ADDLINK dentro de la página de NAV correspondiente:

Por otro lado, indicamos la información a enviar y el id numérico del evento en la llamada de C#, dentro de nuestro propio evento C#, mediante la sentencia RaiseControlAddInEvent:

NOTA: En este caso sólo existe un evento que queramos controlar en NAV, si quisiéramos gestionar varios eventos en el control dentro de C# que disparen el evento de NAV, tendremos que utilizar el entero para evaluar y programar los comportamientos en NAV. Básicamente N eventos de C# corresponderán con un único evento NAV, controlando de qué evento se trata con el parámetro index.

Finalmente ya tenemos nuestro nuevo control extendido, reutilizando uno ya existente de roles, y ampliando su comportamiento dentro de NAV, relacionando los eventos del control propios de C# con los eventos de NAV, lo que nos otorga mayor capacidad de manejo e integración desde el control extendido con NAV.

Compilamos nuestro proyecto en C# y generamos la dll (Al final del post existe un link para poder descargar el codigo y dll). En este caso, para poder registrar nuestro control extendido, en lugar de utilizar las herramientas indicadas en post previos, he utilizado una nueva, que se encuentra desarrollada por Christian Abeln aquí:

http://blogs.msdn.com/b/cabeln/archive/2009/06/08/registration-tool-for-dynamics-nav-roletailored-client-add-ins.aspx

Se trata de un pack de objetos con un formulario con una codeunit que agiliza bastante el proceso. Por último, indicamos el control en la propiedad de la página de Dynamics NAV:

Con esto, ya tenemos nuestro nuevo control a la última moda con arrastrar y soltar para poder crear nuestros vínculos al documento que queramos, y con un aspecto muy visual, sin romper con el aspecto del cliente de roles.

Un saludo.

Enlaces a los ficheros utilizados en el ejemplo:

- Objetos Dynamics NAV (Ojo, Dynamics NAV 2009 R2)
- Proyecto Visual Studio 2008
- DLL Generada

Uso de controles extendidos en NAV 2009 R2 II

2012-01-24T08:29:00.000-08:00

Hola,

En este post vamos a proseguir con esta serie de post que tratan acerca de cómo programar en NAV 2009 R2 un control extendido, re-utilizando y ampliando el funcionamiento de un control extraído del cliente de roles, la pila de documentos.

Antes de comenzar con el desarrollo del control añadido en C#, tenemos que tener claro en el lado de Dynamics NAV como va a funcionar este control y que necesitamos que haga NAV con él.

En principio la necesidad es que el control sea capaz de indicarnos los vínculos que tiene un documento relacionados. Un registro solo consta de las siguientes funciones relacionadas con vínculos:

- ADDLINK: Esta función permite añadir un vínculo al registro actual, ya sea mediante una ruta a un fichero local en nuestro PC, una url web, etc..

- DELETELINK: Cuando un vínculo es generado, automaticamente se le asigna una clave numerica (ID), si pasamos este id al método el vínculo es borrado.

- DELETELINKS: Borra automaticamente todos los vínculos relacionados con un registro.

- COPYLINKS: Permite copiar vínculos entre registros diferentes.

- HASLINKS: Devuelve verdadero/falso si el registro asociado tiene vínculos.

NOTA: Los vínculos existen en NAV desde la versión 5.0. Anteriormente no existe esta funcionalidad.

Por tanto, no existe ningun modo estándar que nos permita conocer cuantos vínculos tiene relacionados un registro. Para poder conocer este dato, la solución propuesta es construir una función dentro de la tabla deseada que nos devuelva el numero de vinculos que tiene cada registro.

Lo primero de todo, es localizar y ver como se almacenan los vínculos. La tabla en cuestión que necesitamos es la tabla 2000000068, Record Link:

Esta tabla tiene como clave un numero entero, denominado LinkID, y las diferentes URL e información del vinculo. El campo importante es Record ID, que se trata de un dato del tipo RecordID. Este tipo de dato no es demasiado usual en los desarrollos de NAV, y sirve para identificar inequívocamente cada registro de una tabla. Para poder trabajar mejor con este tipo de dato, utilizo la variable RecordRef, tal y como vemos a continuación.

NOTA: Como utilizar las variabres recordref, fue tratado en este post: http://dynamicsnaves.blogspot.com/2010/11/uso-de-recordref-y-fieldref-en-nav.html

El método creado dentro de la tabla 112 Sales Invoice Header se llama ObtenerNumeroVinculos y contiene las siguientes variables:

ReferenciaRegistro RecordRef
TableInfo Record Table Information
RecordLink Record Record Link

La función retorna un entero, que es el número de registros de tipo vínculo que encuentra para un registro concreto, de la siguiente forma:

Para tratar de hacer el método lo más generalizado posible (fácilmente replicable para todas las tablas que necesitemos mediante copiar-pegar), a través de la tabla Table Information, obtenemos el numero de tabla actual. Luego ejecutamos el método OPEN para abrir la tabla obtenida, y GETTABLE, para obtener el registro concreto. Mediante un setrange, ya se puede conocer el numero de registros con el record id del registro actual, y devolverlo en el último momento, ya que la función devuelve un entero.

Con esto ya tendríamos la parte necesaria para conocer el numero de vínculos en cada registro. Llamando al método en la página de facturas de venta, como la SourceExpr de tipo campo, tenemos un cuadro de texto con el numero de vínculos.

Ahora falta añadir la funcionalidad de añadir un vinculo a nuestro registro. Esto lo haremos ya mediante el control propiamente desarrollado en C# y llamando a NAV, en siguientes post.

Nos leemos,
Un saludo.

El objeto de tipo tabla realizado en el post, aquí: http://dl.dropbox.com/u/52153328/Tabla112Vinculos.fob

Uso de controles extendidos en NAV 2009 R2 I

2012-01-19T15:54:00.000-08:00

Hola a todos,

Hace bastante tiempo, publiqué un breve post acerca de la creación de controles extendidos (Control addin) para el cliente de roles en NAV 2009 SP1.

NOTA: El link anterior es este: http://dynamicsnaves.blogspot.com/2010/07/uso-de-controles-extendidos-en-nav-2009.html

Tras esta breve toma de contacto, voy a tratar de profundizar en bastantes aspectos de los controles extendidos que resultan interesantes y dar una vuelta de tuerca a la reutilización de recursos existentes en el cliente de roles de Dynamics NAV para nuestros desarrollos. En el ejemplo que voy a tratar en esta nueva serie de post, voy a realizar un nuevo control extendido, pero éste va a tener alguna nueva peculiaridad que va a exigir que sea más completo que el visto anteriormente, teniendo mas integración con NAV que el anteriormente propuesto.

Con el nuevo control queremos arrastrar ficheros encima, y que de forma automática se genere un vínculo para la ficha de documento donde nos encontremos. Por otro lado, en la pila de documentos nos mostrará con un número la cantidad de vínculos disponibles que tenemos para ese documento.

La idea inicial es la siguiente, reutilizar el control de documentos del cliente de roles, modificando su comportamiento actual y reutilizándolo dentro de nuestro control extendido para el cliente de roles, mejorando la experiencia del usuario con la interfaz y agilizando el proceso de anexar documentos, sin dejar de lado la unificación del aspecto de nuestro control respecto a la interfaz de usuario que ya existe.

FIG.1 Detalle del control de documentos:

FIG. 2 Captura de funcionamiento:

Una vez que tenemos establecido el funcionamiento deseado, podemos comenzar a desarrollar, pero eso será en siguientes post.

Nos leemos,

Un saludo.

SMTP y envío de correos desde Dynamics NAV III

2012-01-11T04:50:00.000-08:00

Hola,

Voy a comenzar el 2012 cerrando el asunto del SMTP y el correo, o de una forma más genérica, como registrar un fichero dll que hayamos desarrollado en C# como clase para poder utilizarlo como un automatismo dentro de Dynamics NAV.

En el caso del ejemplo anterior, si hemos realizado los pasos descritos en el anterior post, al compilar nuestro proyecto desde VS2008, se informará de que no se puede iniciar un proyecto del tipo clase. Entonces debemos buscar los ficheros generados. En la carpeta de destino del proyecto, encontramos dos ficheros:

Para poder utilizar en Dynamics NAV este fichero, debemos registrar en cada equipo que utilicemos estos ficheros la dll para poder utilizarla en NAV como un automatismo. Diversas soluciones podréis encontrar en la red para este tema. En este caso, yo he optado por utilizar es la siguiente.

Copiamos en la carpeta de instalación classic Dynamics NAV, el fichero .dll y .tlb.
Creo un fichero bat, que utilizando el ejecutable del Framework de NET, regasm.exe le indicamos lo siguiente:

C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\regasm.exe "C:\Archivos de programa\Microsoft Dynamics NAV\60\Classic\DynamicsNAV.Mail.Avanzado.dll" /tlb:"C:\Archivos de programa\Microsoft Dynamics NAV\60\DynamicsNAV.Mail.Avanzado.tlb" /codebase /verbose

NOTA: Ojo, en algunas ocasiones esta sentencia me ha dado algún problema si el internet explorer se encuentra abierto, por tanto, recomiendo el tener cerrado el mismo cuando ejecutemos el batch.

Una vez registrado en el equipo, podemos utilizar la librería como un automation. Para ello, declaramos en el objeto que queramos una variable del tipo Automation. En este caso, buscamos dentro de los automation, uno que corresponda con el nombre DynamicsNAV_Mail_Avanzado, que es el nombre de nuestro proyecto en VS2008 , y dentro de él tendremos nuestra clase:

Para poder probar este nuevo automatismo, en mi caso, he realizado una pequeña codeunit con 2 variables y un poco de código:

Esta crea una variable del tipo automation de la clase desarrollada, indica los datos del mail tanto de formato y contenido, como origen y destino. Finalmente, el correo se envía mediante el método Send.
Adjunto al final del Post dejo links a los objetos de Dynamics NAV se encuentran tanto un ejemplo del fichero batch, renombrado a txt, como la dll y el tlb.

Con esto, ya podéis comenzar a desarrollar vuestras clases en C# y reutilizarlas desde NAV. Personalmente, creo que tiene mucha más potencia y es mejor el uso de interoperabilidad de forma nativa que trabajar con automatismos, pero todavía hay muchos clientes que se encuentran en versiones previas y no compatibles a esta funcionalidad, y la única forma de aprovechar la potencia de NET es mediante automatismos.

Nos leemos,
Un saludo.

Link del ejemplo: http://dl.dropbox.com/u/52153328/Ejemplo%20SMTP.zip

Off-Topic: Un apunte fuera del ámbito de NAV, pero dentro de las tecnologías de Microsoft. Durante el desarrollo de esta dll, surgió la oportunidad de utilizar esta misma dll desde visual basic para aplicaciones, creando una macro desde Project que mandara mail por SMTP. Puedo confirmar que esta forma de crear DLL y registrarlas sirve también para si queremos desarrollar nuestras propias librerías para alguna Macro de vbs correctamente y llamarlas después.

SMTP y envío de correos desde Dynamics NAV II

2011-12-30T01:08:00.000-08:00

Hola,

Tras el primer post enfocando la problemática actual con Dynamics NAV con el envío de correos SMTP, voy a proponer una solución desarrollada, a pesar de que existe un parche que soluciona el problema de forma estándar en versiones 2009. Debido a que ya existe una solución, no voy a explayarme en la programación, pero sí en como generar y registrar un fichero DLL válido para Dynamics NAV con VS2008 y C#.

Lo primero de todo es que para generar un componente de estas características, desde VS2008, seleccionamos un nuevo proyecto, e indicamos Biblioteca de clases:

Para poder hacer que una clase desarrollada en C# sea re-utilizable desde NAV, tenemos que tener en cuenta varios aspectos a la hora de desarrollarla. Lo primero de todo es incluir la librería System.Runtime.InteropServices dentro de las clausulas using de nuestra clase, tal que así:

El uso de esta librería es para poder tener los miembros necesarios para poder efectuar la interoperabilidad COM. Después de esto, hay que escribir varias sentencias necesarias para establecer los atributos necesarios para poder tener interoperabilidad:

Ojo, el ProgId debe ser el mismo que el nombre de nuestra clase. Se puede escoger entre los tipos de ClassInterface None y Autodual. Después, tenemos que indicar en el proyecto varias opciones para que nuestra clase funcione correctamente como COM.

En las propiedades del proyecto, dentro de la pestaña Aplicación, buscamos el botón de información de ensamblado. Dentro de esta información, marcamos “Crear ensamblado visible a través de COM”

Habilitamos la opción en “Registrar para interoperabilidad COM”, en la pestaña Generar:

Con esto, ya tenemos nuestro proyecto y clase preparados para poder definir los atributos y métodos que queramos utilizar en ella sin problema. En este caso concreto, he definido la clase de la siguiente forma, os muestro el diagrama: (adjunto el el fichero.cs con el detalle al final del post)

El método Send es el que tiene más complejidad, ya que es el que aplica los nuevos parámetros que la DLL de NAV no utiliza:

Lo mas importante de todo es definir los aspectos de la clase que son necesarios para poder utilizarla como COM, requisito fundamental para poder utilizar el DLL resultante desde NAV. Estas mismas operaciones deben ser completadas para poder desarrollar nuestros propios automatismos en C# para NAV.

En el siguiente post, aclararé por último como registrar una dll generada con un proyecto de estas características. Pero esto será al año que viene ;) espero que tengáis todos una feliz entrada de 2012, nos leemos!!

Un saludo.

El link al archivo de clase del ejemplo en VS2008, aquí: http://dl.dropbox.com/u/52153328/NavMailAvanzado.cs

SMTP y envío de correos desde Dynamics NAV I

2011-12-22T03:54:00.000-08:00

Hola,

Hoy voy a comenzar una mini serie de artículos acerca del envío de correos desde NAV mediante el servicio SMTP, y en nuestro NAV, más concretamente con la codeunit 400. Tras varias personas que he visto que preguntan por el blog y foros, he querido profundizar un poco más en el tema.

Lo primero de todo, en que consiste el SMTP. Las siglas corresponden con Simple Mail Transfer Protocol. Básicamente, lo que a nosotros nos interesa es que se trata de un servicio complejo de correo a través de servidores, tanto para recibir como para enviar correo. En el caso que nos ocupa, se trata de enviar correos desde NAV con las aprobaciones que tengamos parametrizadas en nuestro ERP. La gestión en NAV se hace a través de la Codeunit 400 SMTP Mail. Para parametrizar el funcionamiento de esta codeunit, se realiza desde Administración -> Administración de IT -> Configuración correo SMTP.

La parametrización existente permite introducir la siguiente información:

Servidor SMTP: Dirección del servidor SMTP de la empresa.

Autenticación:

Anónima: Sin autenticación.

NTLM: Recoge la autenticación del usuario NTLM.

Básica: Se introduce el usuario y el password para configurar el acceso al servidor.

Id Usuario: Id. Usuario configurado en caso de configuración básica.
Contraseña: Password configurado en caso de configuración básica.

Las comunicaciones por defecto de esta codeunit se efectúan con por el puerto 25. Este es el primer escollo, ya que, aunque se trata de un puerto estándar, este puerto no sirve para todos los servidores SMTP. Aquí se indica http://gotcal.com/index.php/2010/06/smtp-mail-functionality-in-pre-dynamics-nav-5-version/ que existe un parche para poder cambiar el funcionamiento de la codeunit 400 para que pueda ser parametrizado el puerto de acceso directamente desde NAV, y así poder utilizar mas servidores SMTP que tengan diferentes puertos.

No obstante, tras probar con este parche, finalmente he llegado a la conclusión de que si queremos utilizar el SMTP con otro tipo de servidores SMTP externos, como gmail o Hotmail, necesitamos poder mandar el correo habilitando SSL, que es un encriptado de seguridad necesario en el envío del mensaje, y lamentablemente, el automatismo 'Microsoft Navision Mail'.SmtpMessage’ no contiene la posibilidad de habilitar esta opción, requisito necesario para poder mandar un correo desde estos servidores (a fecha en la que escribo este post, al menos, es así).

Por tanto la CU 400 de forma nativa, aún permitiendo con el parche parametrizar el puerto, no puede enviar mails configurando el servidor SMTP de nuestra cuenta google corporativa (por ejemplo) para poder enviar las notificaciones.

Este post sirve de introducción de la funcionalidad SMTP disponible en NAV, y porqué no funciona con una cuenta de gmail o Hotmail. En principio la solución pasa por utilizar un servidor de correo Exchange que haga de puente. No obstante, en siguientes post voy a plantear una solución diferente, ya que podemos crear una librería que gestione el envío de correo de una forma más avanzada, y utilizarla en NAV directamente. Ya que en anteriores post siempre he planteado la posibilidad de utilizar interop, en este caso vamos a solucionarlo de la otra forma que tenemos para interactuar con componentes externos desde NAV, desarrollando un automatismo a partir de nuestra clase desarrollada en C#, y utilizándolo desde Dynamics NAV.

Nos leemos,
Un saludo.

EDITO: 23/12/2011. Gracias a un usuario del blog que ha comentado en esta misma entrada, he descubierto la existencia de un parche oficial que permite mejorar la funcionalidad SMTP, se encuentra aquí: http://support.microsoft.com/kb/2499881 (Requiere acceso a Partnersource o Customer Source).

Diseccionando el cliente de Roles : Centro de Roles - Actividades

2011-12-14T03:55:00.000-08:00

Hola,

En esta ocasión, voy a tratar de hacer un conjunto de post acerca del cliente de roles, para ir adentrando a aquellos desarrolladores que todavía no lo conozcan a como funcionan determinados aspectos del mismo que son completamente nuevos respecto al cliente clásico, y, mas concretamente, como se pueden desarrollar.

Lo primero de todo es conocer el concepto de Role Center, o centro de Roles. Microsoft Dynamics NAV ha cambiado toda la estructura de su aspecto visual y funcional, enfocándolo al concepto de roles. Esto consiste en definitiva en que cada usuario cuando se conecta con NAV sólo ve aquello que necesita ver relacionado con su puesto y funciones de trabajo dentro de la empresa.

El núcleo principal de esta nueva forma de uso, es el centro de roles. En este primer post vamos a ver el centro de roles a partir del que viene predefinido para procesar pedidos de venta.

En esta primera toma de contacto, vamos a ver en que consiste la página de actividades, una nueva página muy vistosa que indica mediante pilas de documentos las actividades que tiene que realizar el usuario.

Lo primero de todo es saber que objeto es el que corresponde con el centro de roles que estamos viendo. Si efectuamos un acerca de esta página en el cliente de roles para poder ver la info de la página, podemos ver el id de la pagina del cliente de roles, para buscarlo en el diseñador.

Podemos ver que un centro de roles es realmente una página Order Processor Role Center (9006). Abrimos el diseñador de objetos en la parte de objetos y nos situamos sobre nuestra pagina de rolecenter.

Abrimos el diseño de la misma con el botón design para ver el diseño de nuestro centro de roles. De todo lo que vemos disponible, la parte de actividades corresponde con la pagina
SO Processor Activities, que es la página que corresponde con las actividades.

Si vemos las propiedades de este elemento, con Ver->Properties, podemos ver en la propiedad PagePartID, el nombre de nuestra página para poder buscarla, en este caso es el mismo que podíamos ver anteriormente, SO Processor Activities. Con esto ya tenemos localizada la pagina, y podemos ver como está realizada para nuevos desarrollos o modificar una pagina de actividades que esté incluida en el estándar.

Ahora que ya sabemos como y que queremos ver, vamos a profundizar en como se realiza este tipo de página. Lo primero de todo, es averiguar en qué consiste el origen de datos de la página. Para ello vamos al diseño de la página SO Processor Activities (9060), y vemos las propiedades generales de la misma, de todas ellas la interesante es la propiedad SourceTable, que es idéntica a la utilizada en Formularios de cliente clasico, y nos informa de que tabla es el origen de datos de la pagina. En este caso la tabla de origen es Sales Cue (9053). Si vemos el diseño es como sigue:

El diseño de este tipo de tablas de actividades es siempre muy similar. Por un lado, la clave code de 10, para tener siempre un único registro en la tabla (Campo 1). Por otro lado, campos que cuenten registros de otras tablas, mediante campos calculados enteros (Campos 2-8). Por último, y estos si que son opcionales, campos del tipo flowfilter, para poder filtrar los valores de los calculados indicados anteriormente (Campos 20-21).

NOTA: Los campos calculados deben ser del tipo entero para poder mostrarse como pila de documentos.

Ahora vamos a ver el diseño de la página, y ya podemos ver la relacion entre el diseño de la pagina del cliente de roles y lo que vemos finalmente:

La clave del diseño de esta página es el subtipo de grupo que tenemos que aplicar, que es CueGroup (“Grupo de pila”). En el momento que aplicamos este subtipo especial de grupo, interpreta los campos indicados dentro de el como estas bonitas y vistosas pilas de documentos.
Ahora faltan dos aspectos del funcionamiento de la página que también son interesantes.

Primero definir las acciones que aparecen disponibles al lado de cada grupo de pila de documentos. Para poder definir estas acciones, tenemos que marcar cada grupo del tipo CueGroup en diseño e ir a Ver->Control Actions. Esas acciones son las que se muestran a la derecha en cada grupo.

A continuación tenemos que indicar que al hacer click en cada pila, abra los documentos correspondientes. Aunque tengamos definido el campo calculado correctamente y las propiedades de la tabla correctas, dentro de cada campo de los grupos de pila, tenemos que ir a Ver->Properties. Rellenamos la propiedad DrillDownID con el id del formulario que queramos ver al hacer click sobre la pila de documentos.

Por último podemos ver como gestiona el tema de hacer un registro, de forma similar a como se hace en los formularios de configuración. En el evento de OnOpenPage(), se indica el siguiente código:

Este codigo sirve por un lado para que siempre exista un registro en la tabla para las actividades, y por otro lado en este caso, para establecer los valores de los flowfilter definidos en la tabla, mostrando los campos de actividades que hayamos definido en un periodo entre unas fechas concretas en este caso (es lo mas habitual).

Ahora ya podemos ver el funcionamiento y diseño de estas paginas de una forma mas precisa, pudiendo modificar o crear nuestas propias paginas de actividades para nuestros centros de roles a partir de ver como funcionan las existentes.

Nos leemos,
Un saludo.

Utilidad para el desarrollo de informes.

2011-12-05T02:26:00.001-08:00

Hola,

Hoy voy a hacer un posteo bastante “diferente” de lo que viene siendo habitual, voy a compartir una pequeña herramienta desarrollada por mí mismo en C# que utilizo con Dynamics NAV para ayudarme en los desarrollos.

En este post voy a contaros en que consiste esta herramienta y como funciona, además de adjuntaros un link para aquellos que la querais descargar.

Dentro de las nuevas funcionalidades disponibles desde NAV 2009, una de ellas son los nuevos report en cliente de roles, como hemos visto en post anteriores. Para desarrollar con estos informes, una vez situados sobre el diseñador de informes integrado en NAV, hacemos click en ver layout, y esto abre el entorno de desarrollo Visual Studio que tengamos instalado en nuestra maquina con la definicion RDLC para el cliente de roles.

Ahora vemos las layout de RDLC así:

Yo llevo un tiempo desarrollando en NAV, y estoy bastante acostumbrado a la agilidad que supone el que mientras estás desarrollando un informe en modo clásico, en cualquier momento puedas hacer un acceso de teclado (Ctrl+R) y ver cómo evoluciona el informe sin necesidad de añadirlo al menú principal todavía,de una forma bastante ágil.

Pues bien, esta forma de usar el cliente clásico se ha perdido por el camino con el cliente de roles, y ahora, si queremos observar los cambios que hemos realizado en el cliente de roles, tenemos, o bien que añadir el informe al menú o crear un hyperlink (Conté anteriormente aquí como generar un hyperlink para un report) para poder ver el informe conforme vamos haciendo cambios.

Ejemplo de ventana de ejecutar hyperlink:

Esta aplicación que os propongo, sirve para recuperar en parte esa funcionalidad perdida, al menos en parte, y agilizar el trabajo. Esta aplicación queda residente en el reloj de Windows, y sirve principalmente para recuperar el Ctrl+R.

La ventana principal nos muestra dos pestañas, “Captura actual” y “Configuración roles”.

Ventana principal de la aplicación:

Dentro de la pequeña pestaña de configuración es donde metemos la información del servicio, servidor (Podemos indicar localhost para mas comodidad) y empresa. Si pulsamos el botón Salvar, esta configuración queda guardada para las siguientes ejecuciones del programa.

La pestaña Captura actual sirve para mostrar los datos del objeto capturado actual.

Esta captura consiste en que se recoge de la aplicacion de NAV de cliente clásico que esté ejecutándose (“finsql.exe”) en ese momento el identificador y tipo de objeto del caption de la ventana cuando pulsamos el botón objeto NAV, y si pulsamos el botón Run, ejecuta el objeto en cliente de roles (si puede ser ejecutado), mediante un hyperlink construido con los datos configurados en la pestaña Configuración. Si pulsamos el botón Objeto NAV, y después el Run, sucede esto:

1) Pulsamos el boton Objeto NAV, y recibimos la info de NAV.

2) Pulsamos Run, y se abre el cliente de roles con el objeto del que obtenemos la información.

La marca Capturar Ctrl+R de la pestaña Captura actual, es la más útil de todas. Si esta marca se encuentra activa, se avisa al usuario mediante mensaje por pantalla de que se encuentra activa la captura de teclado, y cada vez que se pulsen las teclas Ctrl+R, se captura el objeto actual, y se lanza en cliente de roles.

Esto provoca que cuando nos encontremos en el cliente clásico dentro del diseño de un informe, podamos hacer un Ctrl+R para ver como nos está quedando el informe en roles en cualquier momento, después de haber editado la capa layout con Visual Studio y guardado cambios, ojo.

Además, nos evita el trabajo de tener que generar los hyperlink cada vez que hacemos un cambio, la aplicación nos los genera de forma transparente. Esta pensada para ayudar en los informes, pero funciona de forma similar con las páginas, aunque en R2 en paginas ya funciona el botón RUN.

Por último, cuando la aplicación se encuentra minimizada se ve el icono en la bandeja con el reloj de Windows, podemos ver el menú de acciones disponibles así como maximizarla haciendo click con el botón derecho del ratón encima del icono de notificación.

En el menu de notificación, click boton derecho sobre el icono:

He testeado la aplicación en Windows XP y Windows 7, y funciona correctamente, si veis alguna comportamiento extraño, comentadlo por aquí. Por ultimo, he creado un pequeño instalador para que sea lo más fácil instalar y desinstalar.El link a la aplicación, es éste:

http://dl.dropbox.com/u/52153328/Instalador.exe

Espero que os sea útil.
Nos “leemos”,

Un saludo.

Automatismos Excel III, Ejemplo completo - Final.

2011-11-28T05:55:00.001-08:00

Hola,

Después de los anteriores post acerca de los automatismos de Excel, en este último, voy a tratar de exponer un ejemplo sencillo de cómo se puede aplicar todo lo visto anteriormente en un informe. Es un post un poco grande y denso, pero he preferido indicarlo todo en uno para que se pueda ver el proceso de creación de una forma general, aplicando todo lo visto.

Se trata de un informe Excel de listado de facturas emitidas, y la apariencia queda mas o menos así:

Lo primero de todo, es definir el modelo de datos y pensar como estructurar el código dentro de nuestro informe. En este caso, el modelo de datos es sencillo, se trata de utilizar la tabla facturas de venta registradas como un único Dataitem del informe.

Después, declaramos las variables y métodos a utilizar:

Name	DataType	Subtype	Length
ExcelApp	Automation	'Microsoft Excel 12.0 Object Library'.Application
Book	Automation	'Microsoft Excel 12.0 Object Library'.Workbook
Worksheets	Automation	'Microsoft Excel 12.0 Object Library'.Worksheets
Range	Automation	'Microsoft Excel 12.0 Object Library'.Range
Sheet	Automation	'Microsoft Excel 12.0 Object Library'.Worksheet
FileName	Text		250
i	Integer
existeHoja	Boolean
Fila	Integer

En este punto, poco que añadir, salvo que siempre hay que incluir una variable del tipo Integer (En este caso la variable Fila), para poder tener seguimiento en todo momento de en que numero de fila del fichero Excel que me encuentro para poder pintar, o hacer funciones, etc..

Para mayor comodidad, luego existen 3 métodos que gestionan directamente la creación/cierre del fichero Excel.

Name

CrearArchivoExcel

CerrarArchivoExcel

ExisteFichero

El dibujo de en qué disparadores tenemos que procesar los datos es más o menos el mismo siempre:

	Evento	Tarea
1	Report - OnInitReport()	Iniciamos nombre fichero
2	Report - OnPreReport()	Creamos fichero excel.
3	SalesInvHeader - OnPreDataItem()	Creamos cabecera de hoja.
4	SalesInvHeader - OnAfterGetRecord()	Rellenamos hoja.
5	SalesInvHeader - OnPostDataItem()	Totalizamos hoja rellenada.
6	Report - OnPostReport()	Cerrar fichero excel.

La forma de tratar mas comoda el inicio y fin del fichero, es utilizar dos métodos independientes que e encarguen de cada tarea. Iniciar el nombre del fichero con un valor facilita al usuario la introducción de datos,y que no tenga errores.
Por tanto, el modo de ubicar el código para empezar a generar el fichero es el que sigue:

El Método CrearArchivoExcel():

El Método para cerrar y guardar el fichero excel, y para comprobar si el fichero existe:

Una vez establecida la forma de abrir y cerrar el fichero de excel, tenemos que indicar el código para pintarlo. Una de las formas de aprovechar mejor los eventos de informe de NAV es utilizando los diferentes eventos del dataitem, el OnPredataitem() para pintar cabeceras de la hoja, en el OnAfterGetRecord() pintamos el detalle de la hoja, y en el evento OnPostDataItem() totalizamos la hoja.

Nota: En este caso, el informe sólo pinta una hoja, si necesitaramos pintar varias hojas más, estructurando el código de este modo, podemos pintar todas las hojas necesarias de nuestro informe.

Vayamos primero con el evento OnPreDataItem():

Como podemos ver en el código expuesto más arriba, el procedimiento que sigo, es asginar primero los valores de los caption, para tener la cabecera del informe, y luego damos formato. El motivo de utilizar la función FIELDCAPTION, es tener más facilidad de cara a posibles modificaciones de los nombres de los campos sin tener que modificar el core del informe. Veamos el codigo necesario para pintar las filas:

En el evento OnAfterGetRecord(), se asignan los valores a cada una de las filas que vamos pintando. Importante es tener en cuenta correctamente el contador e incrementarle para que vaya pintando cada fila de forma correcta. Por lo demás, hay que tener en cuenta ejecutar un CALCFIELDS para los campos calculados, y después dar formato tal y como queramos. Ya solo nos queda terminar de pintar las filas, el código es éste:

Por último, el evento OnPostDataItem(). Este evento se suele utilizar para totalizar valores de celdas, y para ajustar el tamaño de las mimas con el metodo de las celdas Autofit. No es obligatorio, pero la presentacion del informe queda mucho mejor con los tamaños de las celdas ajustados a los valores que contienen, en mi opinión. Respecto al tema de la totalización, es una de las razones por las que importa el llevar en todo momento un contador con las lineas al recorrer y asignar valores a las celdas, podemos asignar un valor que sea una función con valores de otras celdas, como en este caso la SUMA, totalizando el informe.

Después de todo esto, tenemos listo nuestro informe, y podemos empezar a pensar en como realizar otros tantos utilizando los automatismos de Excel.

Nos “leemos”,

un saludo.

Automatismos Excel II, las celdas.

2011-11-14T08:37:00.001-08:00

Hola de nuevo,

Continuo escribiendo acerca de los automation de NAVutilizados para conectarse con MS Excel, hoy voy a profundizar un poco másacerca de cómo utilizar los automation de una forma más avanzada a como lo hacede estándar Dynamics NAV, dando un formato mas profesional a nuestros informes Excel.

El núcleo principal de todos los informes en Excel, enconclusión, es cada celda de Excel, o, como viene siendo para losprogramadores, el objeto Range.

Recordemos rápidamente, un fichero Excel se compone delibros, cada libro de hojas, y cada hoja contiene sus celdas. Por tanto paraacceder a las celdas de una hoja determinada de un fichero Excel, tendríamosque hacer algo similar a esto, partiendo de las variables declaradas en el postanterior:

Donde NumeroHoja es una variable de tipo entero querepresenta el numero de hoja a la que queremos acceder del libro actual, yCoordenada es una variable Text de 10. La variable coordenada la podemosutilizar para referenciar dentro de nuestra hoja de una forma dinámica una celdaconcreta, y la propiedad Value el valor de la celda.

Es decir, Sheet.Range(‘A1’).Value sería el valor de estacelda:

En este punto hay que tener en cuenta el tipo de valor queasignamos, si Valor es una variable de texto, la celda quedará como texto, siValores una variable decimal, quedará decimal.

(Hay que tenerlo en cuenta si luego queremos hacersumatorios o demás con las celdas,ojo)

Una vez entendido el acceso a una celda concreta, podemoshacer varias cosas interesantes con las celdas, ayudándonos con las propiedadesdel objeto, voy a tratar de enumerar algunas:

- Poner bordes a la celda:

- Indicar que la fuente que representa el valor de la celdasea negrita, o cursiva:

- Cambiar la alineación del texto dentro de la celda:

- Cambiar el color del texto (con un valor entero de parámetro):

- Cambiar el color de la celda (ojo, no texto).

Estos dos métodos anteriores trabajan con parámetros enteros que representan varios colores, a gusto del cliente:

Negro	0
Blanco	16777215
Amarillo	65535
Verde	65280
Rojo	255
Azul	16711680
Turquesa	16776960
Magenta	16711935

- Formatear el valor de la celda con un valor:

- Cambiar tamaño de fuente. (Valor es una variable texto querepresenta el nuevo tamaño, por ejemplo,'10', en cadena de texto)

Estas son algunas de las propiedades más útiles (hay algunamás, pero estas son las más útiles). Juntando todo lo visto hasta ahora, tenemos un montón de formas de dejar nuestros datos en nuestros informes, pero, como lo podemos aplicara un informe propio desarrollado en NAV? En siguientes post plantearemos unejemplo concreto de generar un listado de facturas de venta emitidasdirectamente en Excel desde un informe NAV.

Nos “leemos”,

Un saludo.

PD: Edito: Según me indican las estadísticas de blogger, el blog ha superado la barrera de las 10.000 visitas!!! Muchas gracias a todos.

Automatismos en Excel, pt. 1

2011-11-02T09:09:00.000-07:00

Hola,

Hoy voy a escribir acerca de una serie de propiedades quetienen los automatismos Excel que pueden resultar de interés para generar uninforme. NAV ya contiene una tabla que maneja de forma transparente para eldesarrollador los automatismos de Excel (370 “Excel Buffer”), con resultadosbastante buenos, pero podemos ir un poco más allá, personalizando aún másnuestros informes generados en Excel desde Dynamics NAV.

Para aquellos que desconocen de que estoy hablando, unavariable del tipo automatismo (automation), en NAV sirve para manejar elcomportamiento de otra aplicación desde Dynamics NAV. Al tratarse el ERP de un productoen el que se imponen los desarrollos de informes para cuadros de mandos,resultados financieros, etc.…, y perteneciendo al fabricante Microsoft el producto, la integración con MS Office Excel,es una piedra angular en muchas de las implantaciones que se llevan a cabo.

No obstante, la documentación de cómo manejar losautomatismos de Excel es bastante floja, más allá de la tabla que ya vieneimplementada, y que se utiliza en análisis de dimensiones y esquemas decuentas, por ejemplo. En esta serie de post voy a tratar de explicar que másposibilidades tenemos con los automatismos de Excel.

Ojo, en el caso que comento, todos los objetos cuelgan de lalibreria“Microsoft Excel 12.0 Object Library”. En la imagen siguiente, desglosolos objetos más habituales utilizados al pintar en Excel:

Desglosando en partes, los automation más interesantes deExcel son:

- Application: Maneja unainstancia de la aplicación de Excel.

- Workbook: Maneja el librodentro de la aplicación.

- Worksheet: Maneja la hojadentro del libro.

- Range: Maneja la celdadentro de la hoja.

Una vez visto de forma general, en este primer post, voya explicar cómo crear un fichero Excel medianteautomation. Lo primero de todo es conocer como abrir un fichero que yatengamos localizado o crear uno nuevo desde NAV. Para ello necesitamos lassiguientes variables:

ExcelApp - 'MicrosoftExcel 12.0 Object Library'.Application

Book - 'MicrosoftExcel 12.0 Object Library'.Workbook

Sheet - 'MicrosoftExcel 12.0 Object Library'.Worksheet

FileName – Nombre de ficheroexistente

Veamos ahoraun ejemplo de metodo de apertura/generación de fichero Excel, con una nuevahoja denominada “Desglose”:

Variasanotaciones acerca de este código, primero referentes a las propiedadesutilizadas:

Esinteresante la propiedad Windows de la aplicación de Excel, nos indica elnumero de aplicaciones abiertas. Como se trabaja en memoria, para evitarerrores, es mejor obligar a que el Excel se encuentre cerrado, antes de tenerdesagradables consecuencias en memoria.
Lapropiedad visible, sirve para que no se vea la aplicación según la vamoscompletando con los automatismos. La heindicado a TRUE por tratarse de un ejemplo, peroes recomendable tenerla siempre false hasta que cerremos el fichero, siqueremos evitar errores. Si, por ejemplo, un usuario marca según damosvalores al Excel, el sistema mostrara un error de ejecución del automation.
Por últimouna propiedad a destacar es el caption de la app de la ventana, meramenteinformativo.

Respecto alas colecciones de objetos utilizadas, es interesante observar las del tipoActiveWorkBook (libro activo), y Worksheets (hojas del libro. Aquellos quehayan toqueteado con visual basic y vba, veréis que la notación es similar a lade estos lenguajes, pero adaptada al CAL.

Por últimoen este post, el código necesario para cerrar la aplicación Excel y salvar elfichero.

Para evitarel dialogo de sobreescribir, he optado por borrar el fichero si existe, con laconstante de FILE, ERASE. Lo único especial de estos métodos, es la propiedadde DisplayAlerts, perteneciente al ExcelApp, sirve para que no se muestren los errores algenerarse el fichero propios de la aplicación Excel (no los del automation,sino los del Excel propios). Esta propiedad al igual que la de Visible, esrecomendable establecerla a false hasta que tengamos el fichero generado, paraque no salgan mensajes según estamos generando el fichero.

Por último,no hay que olvidar el hacer un clear de la automation, para limpiar memoria conla variable. Con este código se puede generar un fichero de Excel normalmente,como por ejemplo desde un informe en sus eventos Pre-Report y Post-Report.

A lo largode siguientes post, nos adentraremos en como rellenar este fichero con datos deNAV dinamicamente, utilizando los objetos y propiedades de Excel medianteautomatismos.

Nos leemos,

Un saludo.

NAV Interop IV - Finale

2011-10-18T08:26:00.000-07:00

Hola,

Hoy, voy a terminar con los post acerca del tema de lainterop con Dynamics NAV. Después de implementar el tema del modulo que,utilizando interop, puede comunicarse con gmail, vamos a realizar la parte quecorresponde con la presentación de los datos, esto es, las páginas del clientede roles (también, esto se debe a la limitación importante de que sólo se puedeutilizar interop desde el cliente de roles).

Pues bien, lo primero es añadir una pequeña línea de códigoque se me pasó en el anterior post, necesaria para poder abrir varias bandejaspara cada usuario, esto es:

Justo antes de hacer cada INSERT de registro de bandeja de Gmail.

Esta línea es necesaria para poder ver la bandeja en el casode varios usuarios a la vez, para poder distinguir a que usuario correspondecada correo.

Lo primero de todo, es hacer una página de configuraciónpara que los usuarios den de alta su correo y password.

Se trata de un formulario de página normal, la únicasalvedad es que en la caja de texto del password hay que indicar la propiedad ExtendedDatatypea “Masked”, para que se oculte el valor de los caracteres.

Ahora bien, la página más interesante es la de mostrar elcorreo como tal. Veamos. Como se trata de un ejemplo, no he querido complicarel asunto con hilos y cosas similares, simplemente he utilizado un automationde NAV timer. Las variables a utilizar, son 2 globales:

NavTimer Automation 'NavisionTimer 1.0'.Timer

Gmail Codeunit Gmail

Costumbresde programador de NAV, no he buscado en más profundidad, pero seguro que puedehacer sin automatismos. De todos modos,esto sirve para que observemos como interop + automation pueden coexistirperfectamente.

Para poderutilizar el evento del NavTimer, establecemos en el automation la propiedadwithevents a Yes.

Para podercentralizar el tema de los correos, he definido un método, que lo que hace esborrar los correos de el usuario en cuestión, y cargarlos de nuevo con nuestracodeunit. Al abrir lapagina, establecemos el tiempo de de cada pasada por el método, y al cerrar,borramos los correos del usuario que tenga abierta la pagina, para poder abrirvarios usuarios su correo simultáneamente.

Por último,un pequeño detalle, aprovechando que guardamos el link del correo de gmail, enel evento OnAssistEdit(), llamamos al método HYPERLINK con el valor de nuestrocampo Vinculo.

Esta ultimaparte sirve para que cuando hagamos click en el titulo, abra nuestro navegadorweb con el correo que queremos ver. (Ojo, para que funcione correctamente,tenemos que estar logados en gmail con anterioridad). Con esto ya tenemosnuestra bandeja de entrada de Gmail en el cliente de roles de NAV, para que sepueda ver el correo de forma más cómoda.

Solo nosqueda añadir la pagina en nuestra pagina de roles del tipo “Role Center”, yestará a nuestra disposición.

Espero queos haya gustado.

Nos leemos,

Un saludo.

Evoluciona o muere.

2011-10-05T12:08:00.000-07:00

Hola,

Siempre me he considerado una persona a la que le gusta el tema de innovacion y demás. Hace poco me llego el aviso de estas nuevas variaciones de los diseños en los foros, y he decidido dar el salto.

Veréis que he optado por un cambio radical en el diseño del blog, ..tras varias pruebas y cambios en el diseño, este me ha parecido el mas ágil y visualmente sencillo a la par que concreto,se ve de una forma rápida y agil lo que se necesita ver, que en el fondo son los post y ejemplos que trato de contaros mes a mes.

Como todo, puede que me este equivocando...comentad lo que queráis en este post acerca de este nuevo cambio, a ver que os parece.

Nos leemos,

Un saludo.

PD: Tambien he comenzado a utilizar twitter, sigueme si quieres saber si hay entradas nuevas @borlpez.

NAV Interop III

2011-10-03T04:27:00.000-07:00

Hola de nuevo,

Sigo con el ejemplo que sirve para utilizar la interop, comunicando la bandeja de entrada de gmail. Antes de continuar, si eres nuevo, mejor que leas antes los post 1 y 2 acerca de este tema, para no despistarte.

Anteriormente describí un método que finalmente sirve para obtener un documento de XML con todos los datos de los correos no leidos de la bandeja de entrada de una cuenta de gmail. Al realizarse con interop, este documento se recoge en una variable del tipo Dotnet, mas concretamente una variable System.Xml,System.Xml.XmlDocument, denominada xmldomDoc.

Vamos a ver en este post como recorrer un documento de XML utilizando interop directamente desde NAV. Lo primero de todo, es declarar el método con sus variables y parámetros. El método va a denominarse ActualizarMail y tiene como parámetro una variable de registro de bandeja de entrada de gmail. Esto es porque al final, lo que queremos es almacenar el correo en algun sitio visible y manejable 100% por NAV.

Ahora vamos con las variables. Es necesario declarar el conjunto de variables necesario para acceder a los diferentes nodos y atributos del fichero. Por otro lado, recogemos los valores a introducir en la tabla en unas variables simples de texto y fecha, además de utilizar la tabla definida en el post 1 con la configuración de cada usuario (Usuario NAV, usuario google y contraseña de acceso). Por último, un par de variables del tipo entero para poder recorrer mediante bucle los elementos. Con todo, queda un conjunto de variables similar a este:

Name	DataType	Subtype	Length
xmlNodeList1	DotNet	System.Xml.XmlNodeList
xmlNodeList2	DotNet	System.Xml.XmlNodeList
xmlNodeList3	DotNet	System.Xml.XmlNodeList
xmlNodeList4	DotNet	System.Xml.XmlNodeList
xmldomElem1	DotNet	System.Xml.XmlNode
xmldomElem2	DotNet	System.Xml.XmlNode
xmldomElem3	DotNet	System.Xml.XmlNode
xmldomElem4	DotNet	System.Xml.XmlNode
xmldomElem5	DotNet	System.Xml.XmlNode
xmldomAttrib	DotNet	System.Xml.XmlAttribute
xmldomAttribCollec	DotNet	System.Xml.XmlAttributeCollection
NumeroCorreos	Integer
i	Integer
ii	Integer
idGmail	Text		250
FechaEntrada	Date
HoraEntrada	Time
TituloGmail	Text		100
DeGmail	Text		100
VinculoGmail	Text		250
FechaEntradaTexto	Text		250
FechaEntradaTex	Text		30
HoraEntradaTex	Text		30
ConfigMail	Record	Config. Correos Gmail

Después de todo esto, establecemos el código de nuestra función, similar al que sigue:

El procedimiento en si, es bastante sencillo, recogemos la lista de correos, y la recorremos, leyendo cada nodo o atributo y asignando su valor a una variable. En última instancia, todos los valores recogidos se insertan en nuestro registro y listo.

De todo el código, hay que destacar alguna cosilla interesante. Lo primero de todo, es que las variables utilizadas son en su mayoría Dotnet, luego hay que tener en cuenta siempre las creaciones de variables con sus correspondientes constructores o asignaciones. Después cabe destacar, que cada correo tiene un atributo bastante útil, denominado href, este atributo nos permite que, desde nuestro nav, podamos abrir un correo directamente en nuestro navegador web. (Ojo, el correo tiene que estar abierto previamente). Hay que formatear como sucede casi siempre, la fecha del correo para que coincida con un formato legible para NAV.

Con esto, ya tenemos todo el código necesario para obtener y leer el fichero xml con la información. En el siguiente post nos detendremos en la parte de presentación en las páginas del cliente de roles.

Nos leemos,

Un saludo.

NAV Interop II

2011-09-26T07:02:00.000-07:00

Hola,

Prosigo con el ejemplo de interoperabilidad del anterior post. Una vez determinado el modelo de datos, tenemos que pensar como y dondeintroducir el código necesario. En el caso de la interoperabilidad hay quetener en cuenta una limitación, la interop sólo sirve en el cliente de roles,fuera de él no se ejecuta y muestra un mensaje bastante claro acerca de estalimitación:

Esto implica que no podemos utilizar código de interopdentro de formularios de cliente clásico o report en capa clásica, el código tiene que ejecutarse desde cliente de roles, en definitiva. Con los módulos,si se llaman desde el cliente clásico, habría que controlar el código mediantela variable ISSERVICETIER, para provocar que el código con interop no sea utilizado fuera delcliente de roles. Al utilizar la interop, podemos seguir dos formas (en lamedida de lo posible, claro está) a la hora de realizar los desarrollos:

1) Desarrollandoíntegramente nuestra clase en .NET y utilizándola como un fichero de recurso ytipo de variable personalizada para nosotros. Para ello, hay que ubicar en eldirectorio add-ins de instalación que corresponda el fichero dll generado:

- Cliente clásico MicrosoftDynamics NAV\60\Classic\Add-ins

- NAV Server Microsoft Dynamics NAV\60\Service\Add-ins

- Microsoft Dynamics NAV\60\Roletailored Client\Add-ins

2) Utilizandodirectamente las clases que vienen “heredadas” del framework que tengamosinstalado en el sistema.

En este primer caso que planteo, he optado por utilizar loque ya existe del framework, ya que es mas que suficiente para trabajar, ytenemos el beneficio de que el framework ya se encuentra instalado en losequipos previamente.

Una vez vistas las limitaciones de la interop, y definidocomo vamos a trabajar con ella en este caso, veamos cómo construir el códigoque será el core de la integración con gmail. La estructura a seguir será lasiguiente, utilizando de base el modelo de datos del post anterior, vamos adesarrollar una codeunit que será la que gestione todo el tema de lacomunicación con el server de de correo de gmail. Para ello, he declarado una codeunit Gmail, condos métodos:

GetMailAtom, estemétodo se encargará de hacer la petición al servidor de gmail del fichero XMLque contenga los correos no leídos.

ActualizarMail,que se encargará de leer el fichero de XML obtenido y transformarlo enregistros de la tabla bandeja de entrada, creada en el post anterior.

En este post voy a hablar acerca del primer método,GetMailAtom. Una vez definida la codeunit, lo primero de todo es establecer lavariable de documento de XML que vamos a cargar en el primer método, ytransformar en el segundo. En este punto es importante tener claro que, aunquelos tipos de datos con los que se desarrolle en NET sean similares a los quepodamos utilizar con otro tipo de variables (por ejemplo, en este caso del documentode XML, podríamos trabajar con un automatismo de documento de XML), no sepueden asignar variables de diferente tipo entre ellas, a no ser que hagamospuentes, como por ejemplo en este caso seria guardar el fichero XML en unfichero físico y leer con un automatismo desde él. Este punto puede sonar unpoco a perogrullada, pero es interesante tenerlo en cuenta. Con esto, vamos acrear nuestra primera variable NET. Para ello, abrimos las variables globalesde la codeunit , indicamos el nombre xmldomDoc, y después indicamos comotipo de variable DotNet, que son los tipos variables nuevas para estosmenesteres. En Subtype, desplegamos con los 3 puntos, y tenemos que seleccionarel ensamblado al que pertenece la variable, de forma similar a como lo haríamoscomo con un automatismo. En este momento aparece la primera diferencia aresaltar, disponemos de dos pestañas diferentes, NAV y .NET. Estadiferenciación radica lo indicado anteriormente, la pestaña Dynamics NAVcorresponde con las clases propias desarrolladas e indicadas en la carpeta, yla pestaña .NET en las de la librería de framework instalada en la maquina.

Seleccionamos elensamblado para que quede de forma similar a como esta:

Name	DataType	Subtype
xmldomDoc	DotNet	System.Xml,System.Xml.XmlDocument

Ojo, cuando indico la información del subtipo en el blog, obvio laversión y la clave publica, para reducir la información y dejar lo masimportante, de que librería y que tipo de clase estamos utilizando.

Ahora declaramos las variables locales al primer método GetMailAtom, quedarían tal y comosigue:

- Parámetros:

Name	DataType	Length
CuentaGmail	Text	50
PasswordGmail	Text	30

- Variables locales:

Name	DataType	Subtype
webRequest	DotNet	System,System.Net.WebRequest
credentials	DotNet	System,System.Net.NetworkCredential
webResponse	DotNet	System, System.Net.WebResponse
reader	DotNet	mscorlib, System.IO.StreamReader
stream	DotNet	mscorlib,System.IO.Stream

Ya tenemos toda la estructura de variables y métodos de la Codeunit,podemos programar este primer método sin problema:

Que es lo que hacemos en el método? Primero una petición delfichero XML, le indicamos la autenticación necesaria, en función de losparámetros que vengan del método y recogemos la respuesta, primero como unflujo de datos, y a través de un Reader, lo convertimos en fichero XML,asignándole a la variable global que teníamos declarada de antes.

Con esto tenemos nuestro primer método que utiliza Interop.Como se puede observar, la potencia que nos otorga a la hora de desarrollo esinmensa, pero hay tanto recurso, que es necesario saber a dónde queremos llegarantes de desarrollar, para no perder el norte. Aquellos que seandesarrolladores de NAV íntegramente, y no conozcan nada de programación en NET,tendrán un reto más amplio por delante, para poder conocer bien como funcionaeste tipo de programación con Interop, opino que hay que saber también un pocode NET para poder utilizarlo aprovechando al máximo lo que nos ofrece (tipos dedatos, clases, etc..)

Como leer este XML nativo de NET y convertirlo a nuestros registros? ,en los siguientes post, cerraremos este punto.

Nos leemos,

Un saludo.

NAV Interop I, bandeja gmail en NAV.

2011-09-19T07:50:00.000-07:00

Hola a todos,

Hoy voy a comenzar una nueva serie de post acerca de una de las nuevas funcionalidades de Dynamics NAV 2009 R2, conocida como interoperabilidad. Esta nueva funcionalidad permite que Dynamics NAV pueda, de forma nativa utilizar librerias desarrolladas en C# directamente, ya sean librerias del framework o clases desarrolladas por nosotros mismos. Esto potencia muchisimo el desarrollo, ya que podemos utilizar los montones de recursos que existen de C# dentro de NAV.

Para este ejemplo de como utilizar la interoperabilidad de Dynamics NAV, voy a crear un modulo que sea capaz de obtener los correos que existen en la bandeja de entrada de una cuenta de gmail, e importarlos en NAV. Para ello, hay que recoger de un feed un xml (https://mail.google.com/mail/feed/atom) , previa autenticacion del usuario, y leerlo de una forma concreta recogiendo los datos y mostrandolo dentro de nuestro Dynamics NAV. Como siempre, antes de comenzar con el desarrollo puro y duro, voy a explicar como he establecido el modelo de datos necesario para recoger los datos.

En la primera tabla, denominada "Config. Correos Gmail", indico la relacion de cada usuario con su correspondiente cuenta gmail y su password, necesarios para poder autenticarse en el servicio web a posteriori. Esta tabla contiene los siguientes campos:

- User ID, code de 20 de longitud y clave de la tabla. Este campo lo he relacionado con la tabla User, y he utilizado la codeunit "Login Management" (418), en los eventos lookup y validate del campo para poder obtener un listado y validacion de usuarios. Está indicado como clave para que cada vez que un usuario se encuentra logueado, vea únicamente sus correos.

- Cuenta gmail, un Text de 50. Este campo contendrá la cuenta de Gmail completa (ejemplo@gmail.com).
- Password. Este campo contendrá la contraseña de la cuenta, lo he indicado como un text de 30.

La segunda tabla, denominada "Bandeja entrada gmail", contiene los correos propiamente dichos, su definicion consta de los siguientes campos:

- Id. Gmail, Text de 200, que contiene el identificador del mail, lo he dejado como clave.
- Fecha entrada, date.
- Hora entrada, time.
- Titulo, Text de 100.
- De, Text de 100.
- Vinculo, text de 250, vinculo al correo.
- Id. Usuario, code de 20.

Con esto, ya tenemos el modelo de datos, y la idea de lo que vamos a crear, en post posteriores iré describiendo como desarrollar el modulo en profundidad, en principo el objetivo es que quede algo así:

Nos "leemos".

Un saludo.

Reportando con Dynamics NAV pequeño video-tutorial 2.

2011-08-12T04:54:00.000-07:00

Hola,

Prosigo con la subida del video tutorial con la parte más interesante, el desarrollo en RDLC. Como en el anteior post, el link al archivo a descargar esta en el título.

Nos leemos,
Un saludo.

VIDEO 2: Desarrollo del informe en Dynamics NAV.

Unable to display content. Adobe Flash is required.

Reportando con Dynamics NAV pequeño video-tutorial.

2011-08-12T04:49:00.000-07:00

Hola a todos,

Tras unos cuantos dias sin novedades, y bastante tiempo sin postear...con las vacaciones y el verano haciendo estragos, voy a retomar el tema de los informes en RDLC.

Siguiendo con la tematica RDLC me encontraba ante una nueva problemática, demasiadas cosas que contar demasiado "visuales" (arrastra, haz click...) luego tras meditarlo he terminado por utilizar videos.

Voy a indicar con un pequeño video tutorial como hacer un pequeño informe en Dynamics NAV con RDLC, aplicando un poco de todo (navegar,gráficos, formato....). Lo he dividido en 2 partes, una indicando todo el modelo de datos y desarrollo en la capa más clásica y otra con el desarrollo puro y duro en Visual Studio

Teneis las vistas preliminares a continuación en este mismo post, con sus enlaces de descarga del fichero swf. en cada titulo del video. Son ficheros un poco pesados y las imagenes de alta resolución, lo he preferido a perder información...en siguientes videos mejoraré esta forma, espero que sirva de ayuda.

A continuacion posteo el otro video en otro post distinto.
Nos leemos,
Saludos.

VIDEO 1: Desarrollo del informe en Dynamics NAV.

Unable to display content. Adobe Flash is required.

"Reportando" con Dynamics NAV 2: Los inicios.

2011-06-22T01:00:00.000-07:00

Hola a todos,

Voy a continuar con el tema del diseño de informes en la capa RDLC. Mi objetivo para hoy es el siguiente, quiero obtener una lista de clientes lo más simple posible en esta nueva capa.

Para ello, tenemos que empezar desde el nivel más bajo, el cliente clásico. Con el asistente en unos pocos click sacamos un listado de cliente similar a esto:

Ahora, vamos a ver que pasa si ejecutamos el informe con la capa de presentación del cliente de roles. Lamentablemente, de momento no es posible ejecutarla directamente desde el cliente clásico (y puede que nunca lo sea, por lo que se dice, NAV 7 no dispondrá del cliente clásico con informes), por tanto, tenemos que crear un hyperlink para poder ejecutar el informe de clientes desde la presentación de roles. Inicio->Ejecutar, y escribimos los siguiente:

DynamicsNAV://ipservidornav/nombreservicio3ªcapa/nombreempresa/runreport?report=idreport

Para mi, que se trata del report 50001, dentro de nuestra amiga CRONUS, queda tal que así:

DynamicsNAV://localhost/dynamicsnav/CRONUS/runreport?report=50001

Ejecutamos y....espera, que es esto? Si no proponemos una capa de presentación RDLC,

el informe se muestra tal y como se encuentre en modo clásico. Ya lo tenemos!! ..............

Que vá, vamos a mejorarlo un poco más.

Aquí quiero hacer un inciso, desde el menú Herramientas, tenemos dos opciones:

Crear Layout Suggestion -> Intenta crear un informe a partir de los datos del clásico. Para mi gusto (apenas lo he utilizado demasiado, y poco en R2, no es demasiado util)
Delete Layout Suggestion -> Se elimina toda la capa RDLC de un solo click.

Vamos a crear el layout nuevo desde 0. Desde el mismo informe hacemos click en ver-Layout, y nos abre el VS studio,en blanco.Si nos fijamos en la zona izquierda del VS, tenemos un Origen de datos, Con el dataset y el result que son los datos que podemos pintar en el informe.

El origen de datos de la capa de RDLC, son los datos que vienen de las secciones de nuestro informe clásico. Nuestro cliente CSIDE propone los nombres de los datos a partir de la propiedad DataSetFieldName de cada control pintado en las secciones. Sï, precisamente por eso ahora surgen problemas cuando modificamos un informe existente, tenemos que tener cuidado con esta propiedad al copiar-pegar controles. Tambien nos indica en el origen de datos los caption para que podamos introducirlos en las cabeceras. Nuestro informe tiene que tener la siguiente estructura:

Si, es bastante sencillo, pero es una primera toma de contacto. Bien, lo primero que hay que tener en cuenta a la hora de desarrollar el informe, es que tenemos un diseñador mas complejo y moderno que el clásico en NAV.

Aunque podemos introducir tambien una cabecera y pie a nuestro informe, de momento no es necesario. Dentro del cuadro de herramientas a la izquierda, seleccionamos el objeto del tipo Tabla, y lo arrastramos a la sección Body del informe. Hacemos click con el botón derecho del raton encima de la tabla y seleccionamos “agregar columna”. Por defecto se indican 3 columnas, y necesitamos 4. Arrastramos los datos del origen de datos seleccionando con el raton y arrastrando a cada celda del objeto tabla:

Seleccionamos cada Origen de datos los que tienen el nombre terminado en caption, y lo indicamos en las celdas superiores de la tabla, que se indican con el símbolo
Seleccionamos los orígenes de datos cuyos nombes no son acabados en caption, y los indicamos en las filas, para que se repitan, el símbolo es
Por ultimo totalizamos el informe, añadiendo el campo Balance (LCY) en el pie de la tabla Automaticamente se introducirá como =Sum(Fields!Customer__Balance__LCY__.Value)

Ajustamos el valor de la sección body justo al tamaño de la tabla. Si hemos hecho todo correctamente, quedará el diseño de este modo:

Una vez finalizado el diseño, cerramos el editor de VS:

Pide guardar cambios, decimos que sí.
Al recoger el foco del informe, NAV nos avisa de que hemos cambiado el layout, le decimos que sí para que guarde los cambios.
Le decimos a NAV que guarde y compile el informe.

Personalmente, creo que este proceso es mejorable, además de tener que aceptar un monton de mensajes, no sabemos si algo está mal en el informe, hasta que guardamos al final desde NAV… en fin, esto es otra historia. Si hemos dejado nuestro diseño ok, nos quedará algo así:

Con esto tenemos el núcleo del informe, falta poner algunas cosas más, pero lo iremos viendo en siguientes post. Nos "leemos".

Un saludo.

"Reportando" con Dynamics NAV

2011-06-06T04:42:00.000-07:00

Hola,

Tras un tiempo sin escribir, (hay mucho trabajo por hacer!) voy a comenzar con un nuevo hito en la programación de NAV, bastante interesante, y, a medio-corto plazo, muy necesario.

Este nuevo hito se trata de la programación de informes en RDLC para el cliente de roles. Antes de empezar a meternos en harina, voy a explicar un poco las herramientas que hay actualmente para el diseño de informes, y en qué consisten los informes en Dynamics NAV.

Un informe es un tipo de objeto en NAV que puede suplir dos funciones muy importantes.

1) Por un lado, el informe en NAV, tal y como se entiende generalmente un informe para cualquier tipo de aplicación, presenta unos datos a un usuario de una determinada forma para que sean lanzados contra un soporte físico, bien sea impresora, bien sea mediante la vista preliminar en pantalla, o como un fichero en disco.

2) Por otro lado, en NAV también se utilizan para poder procesar conjuntos de datos mediante un proceso, actualizando registros de varias tablas simultáneamente etc. La facilidad que otorga NAV utilizando su implementación estándar para recorrer registros y actualizarlos de una o varias tablas simultáneamente, otorga a los informes una utilidad extra muy importante.

Llegados a este punto, hay dos tipos de herramientas para diseñar informes actualmente
(En versión NAV R2):

Tenemos los infomes clásicos, integrados en el cliente idem, que se efectuan con el Diseñador de informes de NAV. Estos informes son de apariencia más sencilla, y la interfaz para realizarlos esta integrada dentro del cliente clásico. Esta interfaz tiene bastantes limitaciones y los informes que se pueden obtener son más limitados.

Por otro lado, desde la version 2009, tenemos a nuestra disposición otra capa para los informes.Esta capa del informe esta definida en un XML estructurado, denominada RDLC (Report Definition Language Client-side).
Esta capa se guarda de forma conjunta al objeto normal (el informe de cliente clásico) en Dynamics NAV. Esta capa utiliza la funcionalidad de los SQL Server Reporting Services, creando un hibrido con la capa anterior, y otorgando nueva funcionalidad, diseño, y capacidades como la navegación desde los mismos informes.

Por tanto para poder comenzar, hay que tener instalado el diseñador de VS correspondiente. No todas las versiones son compatibles, os añado un link a este respecto de la msdn:

http://msdn.microsoft.com/en-us/library/dd568716.aspx

Hasta aqui, esta "pequeña introducción" que espero que no se os haya echo demasiado larga. En el siguiente post, comenzaremos a desarrollar un informe de esta nueva capa.

Un saludo.

Ojo: Respecto al tema de los datos nuevos que van añadidos al informe con esta capa, hay algo realmente interesante. Si creamos un informe en version 2009 o superior, con datos de la nueva capa, el informe se puede importar tranquilamente en una version inferior.. pero..si intentas acceder al diseño siempre dara un error grave, cerrando la aplicación. Hay que exportar en texto y borrrar la seccion RDLDATA, que es la que contiene la parte de la nueva capa antes de importar en la version antigua de NAV.

Controlando errores en Dynamics NAV ASSERTERROR : La sentencia desconocida.

2011-04-19T07:14:00.000-07:00

Hola,

Hoy voy a hablar de una función de sistema, denominada ASSERTERROR, de la cual no se podia encontrar documentación en la aplicación con la ayuda de ningún modo, y no aparece con F5 (al menos, no la he visto). Esta función sirve, principalmente, para controlar errores en tiempo de ejecución (Sí, esos errores tan inportunos que en un momento dado, paran la ejecución de un proceso, y hacen un Rollback al estado de la base de datos. Combinada con la sentencia GETLASTERRORTEXT, podemos tener un poco de control al estilo Try-Catch, directamente desde NAV.

Fijaos a continuación en el código que sigue:

Tal y como viene pasando hasta ahora, si a esta función le pasamos un fantástico 0, muestra un error como el que sigue, solo con lanzarlo:

Bueno, pues si usamos esta función, ASSERTERROR, que queda algo tal y como esto:

El sistema no da ningún error, y todo le parece correcto.

Entonces vayamos más allá, y usemos la otra función bastante útil, denominada GETLASTERRORTEXT, que recoge el texto del último error, y ricemos el rizo:

Con esto, conseguimos que el mensaje de error de tiempo de ejecución, sea un mensaje mucho menos agresivo, y que no detenga la ejecución del proceso en el que nos encontramos, el resultado quedaría así:

Con esto, podemos controlar mejor los errores de NAV, directamente desde el propio código CAL.

Nos leemos,

Un saludo.

Conectar WS de dynamics NAV desde vb script.

2011-03-28T08:57:00.000-07:00

Hola,

Han sido unos dias de mucho jaleo, sin tiempo para indicar nada nuevo ni reseñable en el blog..pero siguiendo con el tema de posibles integraciones de servicios web, se me ha planteado otra nueva posibilidad de integracion mediante servicios web con NAV, y quisiera contarosla.

Actualmente estoy trabajando con una herramienta de BI denominada QlikView. Esta herramienta sirve para conseguir analizar información en grandes dosis, proveniente de varios origenes de datos dispares, tanto por odbc como por ficheros excel, planos...y si, ficheros XML.

Además, puede utilizarse VB script desde dentro de esta herramienta para poder realizar módulos que utilizar en la aplicación.

Planteemos el siguiente caso. El cliente necesita leer de Dynamics NAV,pero este no se encuentra accesible mediante ODBC y queremos acceder a los datos de la aplicación mediante servicios Web.

Mediante el VB Script, de forma similar a como lo haciamos con Javascript, generando una peticion SOAP con un objeto XMLHttp, y recogiendo el resultado generado dentro de un XML, este fichero ya es legible por Qlikview. La única pega, es que el logueo del servicio web, tiene que hacerse con el usuario implicito que esta logueado en el documento de Qlikview, ya que no se pueden generar credenciales. Como este usuario es de Windows, puede tener acceso a NAV también, y listo.

El codigo necesario para poder leer de un servicio que lista el Nº, Nombre, Direccion y Saldo (dl) de los proveedores de la base de datos:

Para todos los que lo lean, la primera parte hasta la gestión del fichero XML es Vb script estándar, la continuación es la que tiene que ver con Qlikview.

NOTA: Hay que tener en cuenta, tal y como indico en el codigo, que desde la version 2009 Sp1, la creación de la petición Soap se ha vuelto mas delicada, y hay que indicar los espacios de forma similar a que funcione correctamente. En los ejemplos indicados anteriormente en el blog sucede lo mismo, siempre y cuando se utilice NAV 2009 SP1. Cosas del cambio de versión.

Al final, la conclusion es que teniendo los conceptos claros, NAV se puede integrar gracias a los servicios web con una gran variedad de softwares diferentes.

Saludos.

Llamando a servicios web de NAV desde NAV. Usando SAVEASPDF

2011-02-16T08:52:00.000-08:00

Hola,

Debido a diversos post que he ido revisando en tipsdbits, he comprobado que hay un desarrollo predominante en estas ultimas fechas, que es generar un PDF desde una factura de NAV o cualquier tipo de documento.

La forma mas habitual de realizar el desarrollo, es mediante el uso de automatismos de cualquiera de los software de las impresoras PDF que existen, bien sea bullzip, PDFCreator, etc...

Desde NAV 2009, los mismos informes de Nav, vienen "de serie" con una opcion para salvarlos como PDF (SAVEASPDF), la lástima es que esta funcion solo sirve cuando se llama desde el cliente de roles o desde un servicio web, no desde el cliente clásico.

Todo este planteamiento sirve de excusa, para poder rizar el rizo e ir mas allá. Podemos llamar a un servicio web de NAV desde él mismo, y que así se pueda ejecutar esta función y que no sea necesario el uso de automatismos.

La arquitectura del tema es bastante sencilla, publicamos un modulo como servicio web con un método para guardar en PDF lo que necesitemos, y en el mismo OnRun de la codeunit, llamamos al servicio publicado, para que se ejecute nuestro código a través de la capa de servicio, y consigamos lanzar el SAVEASPDF correctamente. Vamos a ponernos manos a la obra.

Lo primero es generar un módulo con el método que necesitamos para guardar como PDF, y publicarlo en web:

Este método es bastante sencillo, así que le complicado un poco. Para que quede todo correctamente organizado, genero una ruta de carpetas, utilizando el automatismo 'Microsoft Scripting Runtime'.FileSystemObject, para crear las carpetas.

Creo una estructura en árbol E:\Facturas_Clientes\NoCliente\FacturaNo.pdf Además, uso la funcionalidad ADDLINK, para indicar un vinculo con la ruta del documento generado, y poder abrirlo desde NAV y que quede relacionado con la factura.

Hasta aquí, se trata de un método normal de NAV. Ahora, vayamos con el tema de llamar al servicio web.

Lo segundo, en nuestro modulo, en el Run, indicamos el código necesario para poder guardar llamar al servicio web de NAV con automatismos de XML, y controlamos si surge algun error durante la ejecución,generando un xml. Las variables que he utilizado son:

Name	DataType	Subtype	Length
xmlHttp	Automation	'Microsoft XML, v6.0'.XMLHTTP
NAVServerName	Text		250
Company	Record	Company Information
XmlDoc	Automation	'Microsoft XML, v6.0'.DOMDocument
XmlNode	Automation	'Microsoft XML, v6.0'.IXMLDOMNode

Y el código, aquí está:

Tal y como he comentado en anteriores post de javascript, la clave es mandar una petición SOAP al servicio web de NAV, después, recojo la respuesta, y la evaluo, para ver si hay problemas o ha devuelto lo que necesito, que es el XML. Con la ruta donde se ha guardado.

Para que quede todo en una única codeunit, veréis que he indicado como Rec, la tabla de hístorico de cabecera de factura de venta. Así, se indica un botón en el histórico directamente, y listo.

El resultado queda como sigue:

Y con esto, aprovechamos la funcionalidad SAVEASPDF del cliente clásico, y además comprobamos que se pueden utilizar los servicios web desde NAV contra él mísmo.

Nos leemos.

Saludos.

Manejo de registros desde CAL.

2011-02-08T14:33:00.000-08:00

Hola,

Estan siendo unas semanas agotadoras, y apenas hay tiempo para escribir, y menos para plantear alguna cosa completa para poder postearla. Por tanto, este articulo voy a dedicarlo a cosas mas mundanas, como es el manejo de registros desde CAL. Voy a indicar un pequeño listado de las funciones mas comunes, y tratar de reflejar que hace cada una de ellas, y en mi modesta opinion, su utilidad diaria, y posibles pegas de rendimiento que pueden dar. Veamos:

Función GET para localizar un registro concreto

Que hace? Recupera el registro de una tabla por la clave primaria, devolviendo verdadero o falso si encuentra el registro.

Ejemplo: Cust.GET(NoCliente), devuelve verdadero o falso.

Opinión: Rápida y fácil de leer, no necesita más código. Útil si buscamos por campo clave.

Funciones para filtrar un conjunto de registros RESET,SETCURRENTKEY,SETFILTER,SETRANGE

Que hacen? Sirven para recuperar un registro o conjunto de registros que cumplen una serie de valores comunes en sus campos.

RESET -> Elimina los filtros establecidos en el registro previamente. Esto garantiza que cuando se efectúan unos filtros en un registro mediante código, no filtramos sobre registros que ya tengan un filtro anteriormente.

Ejemplo: Cust.RESET;

Opinión: Es un “clásico” del manejo de filtros con registros mediante código. Muy importante usarlo, y evita dolores de cabeza…

SETCURRENTKEY -> Establece la clave primaria que está utilizando un registro mediante código.

Ejemplo: Cust.SETCURRENTKEY(“No.”)

Opinión: Aunque pueda parecer poco útil, en procesos en los que efectuéis filtros por varios campos simultaneos antes de recorrer los registros, si son habituales y podeis, haced una clave secundaria y utilizar esta sentencia antes de aplicar los filtros, el rendimiento puede mejorar considerablemente.

SETFILTER -> Se utiliza para poder establecer un filtro complejo en un campo.

Ejemplo: Cust.SETFILTER(“No.”,’P*’);

Opinión: La más utilizada de todas las sentencias de filtros. Siempre debe ir acompañada de sentencias de recorrer registros (A continuación en este mismo post).

SETRANGE-> Se utiliza para poder establecer filtros simples, valores desde hasta.

Ejemplo: Cust.SETRANGE(“No.”,’P00001’,’ P00050’);

Opinión: La “otra” que se puede utilizar. Siempre se puede sustituir por un setfilter , pero para trabajar con fechas, valores numéricos, o booleanos, es mas comoda e intuitiva. Al igual que su “hermana” SETFILTER, debe utilizarse de forma conjunta con sentencias para recorrer registros.

Truquillo común ;) Cuando tengas dudas de lo que has filtrado, un ERROR(GETFILTERS) te evitará problemas.

Funciones para recorrer registros FIND,FINDFIRST,FINDLAST,FINDSET,NEXT

FIND Función unificada para recorrer registros, el todo en uno. Tiene un parámetro Wich, con el que se le indica a la función como debe actuar:

FIND(‘-’) Posiciona el conjunto de registros en el primero.

FIND(‘+’) Posiciona el conjunto de registros en el último.

FIND(‘=’) / FIND(‘<’)/ FIND(‘>’)…..sin palabras, para que voy a mentir.

Ejemplo: Cust.FIND(‘-’);

Opinion: Cuando empezé a programar en NAV, era muy amigo de utilizar esta sentencia para no tener que aprender las demás. El paso del tiempo me ha indicado que NUNCA debe utilizarse, (a pesar de que el código NAV la tenga) ya que causa una bajada de rendimiento en SQL bastante apreciable. Recomiendo dejar de usarlo cuanto antes…la indico para que se conozca, nada más.

FINDFIRST Se utiliza para posicionarse en el primer registro de un conjunto de registros. Devuelve Falso si no hay donde posicionarse.

Ejemplo: Cust.FINDFIRST;

Opinion: La función mas correcta. No usarla al moverse en registros, solo para posicionarse de forma inicial.

FINDLAST Se utiliza para posicionarse en el ultimo registro de un conjunto de registros. Devuelve Falso si no hay donde posicionarse.

Ejemplo: Cust.FINDLAST;

Opinion: La función mas correcta. No usarla al moverse en registros, solo para posicionarse de forma inicial.

FINDSET Se utiliza para obtener un conjunto de registros de forma ordenada.

Ejemplo: Cust.FINDSET;

Opinion: No la uso demasiado personalmente, pero puede ser útil en determinados casos. Relacionada directamente con el caché que tenemos establecido en NAV para la obtención de registros en memoria desde el SQL.

NEXT: Se utiliza para recorrer registros. Devuelve 0 si no hay mas registros, se puede indicar un numero negativo o positivo.

Ejemplo: REPEAT UNTIL Cust.NEXT(1)=0

Opinion: “Clásico” en el recorrido de registros. Fundamental.

Funciones para contar registros ISEMPTY, COUNT, COUNTAPROXX

ISEMPTY Devuelve verdadero o falto si no hay registros disponibles.

Ejemplo: Cust.ISEMPTY;

Opinion: Muy útil, evita bloqueos porque trabajamos directamente con el valor verdadero o falso, es mejor y mas que utilizar un FINDFIRST o FINDLAST.

COUNT Devuelve el numero de registros que tiene una variable record. Si hay filtros devuelve los registros filtrados.

Ejemplo: Cust.COUNT;

Opinion: Muy útil y preciso, pero el de peor rendimiento , evitar en la medida de lo posible..

COUNTAPPROX Devuelve el numero de registros aproximado.

Ejemplo: Cust.COUNTAPPROX.

Opinion: Si es posible, utilizalo.

Todas estas funciones son de uso cotidiano, espero que este articulo sirva para ver alguna nueva información sobre estas funciones. A continuación hablaré un poco mas detalladamente acerca de las transaccionalidades en Nav, pero eso será en otro post..

Nos leemos.
Un saludo.

Uso de codeunit/páginas con un cliente de C# en VS2008 (V)

2011-01-24T09:06:00.000-08:00

Hola,

Hoy voy a mejorar el ejemplo de anteriores post con el uso de un servicio web del tipo módulo. Son mas "programables" que los anteriores, pero en estos tenemos toda la responsabilidad del buen funcionamiento de los mismos (Control de errores, rendimiento,etc...).
Para poder utilizar un servicio de tipo módulo o codeunit, el principio es el mismo, se añade la referencia web a nuestro proyecto C#, y se crea una instancia del servicio, utilizando unas credenciales válidas y con acceso al ERP.

En el caso de nuestro ejemplo, vamos a utilizar la codeunit con dos funciones bien diferenciadas:
Una, de forma similar a una página, para leer datos referentes al cliente. En este caso, programamos a continuacion del evento de click en celda, y, con el No de cliente llamamos a nuestro servicio.

Dos, haciendo click en el boton bloquear, cambiaremos el estado del cliente a bloqueado, para no
poder efectuar mas operaciones con el cliente seleccionado. El codigo se encuentra en el click
del botón.

Para saber que cliente bloquear, me aprovecho del tag de la ventana para guardar el número de cliente seleccionado en todo momento, y con ese mismo llamo al metodo de mi servicio para bloquear.

Con todo esto tenemos ya un cliente perfectamente funcional (un poquito simple, pero ando justo de tiempo ;) ) con el que podemos ver el listado de nuestros clientes en BD, y bloquear
aquellos que deseemos.

Nos "vemos",
Saludos.

Uso de codeunit / paginas con un cliente de C# en VS2008 (IV)

2011-01-09T05:50:00.000-08:00

Hola,

Voy a proseguir con el desarrollo de la mini-aplicación en C# con VS2008. En el post anterior indiqué una manera muy rápida de conseguir un listado con un servicio web del tipo página y un datagrid. Ahora, vamos a adentrarnos en utilizar la pagina para obtener un estado concreto de un cliente (bloqueado), en el momento en el que lo seleccionamos en el listado. Esto lo voy a hacer así, para que podais ver un ejemplo de como se utiliza una clase proxy de la pagina, y para poder tener el estado 100% online con respecto a NAV. Quiero tener este resultado:

Lo primero de todo, para utilizar el servicio web de página y el de módulo, utilizamos como identificador el No. de cliente, este lo voy a obtener directamente del datagrid cuando se selecciona una celda, y lo almaceno en una cadena de texto, por ejemplo. Quedaría mas o menos así:

private void dataGridView1_CellClick(object sender, DataGridViewCellEventArgs e){

String NoCliente = dataGridView1[0, e.RowIndex].Value.ToString();

En el post anterior, no comenté nada acerca del control de excepciones del servicio de NAV. Pues bien,voy a contar algo ahora, antes de que se me vuelva a traspapelar. En mi opinion, lo mejor es introducir todas las llamadas a servicios de NAV, dentro de un try catch para recoger el error, suelen ser bastante descriptivos, y puede haber de muchos tipos, como por ejemplo:Error servicio no encontrado (el servicio ha caido), usuario no autorizado 404 (el usuario de windows que estamos utilizando no tiene permisos en NAV suficientes, o no existe)...y los tipicos errores que nos puede dar NAV, que se lanzan como excepcion automaticamente 'el cliente ##### no existe'. ..entre otros.La
correcta gestion de errores nos puede facilitar mucho la vida como programadores, y como usuarios de nuestras aplicaciones.

Una vez recogido el NoCliente, hago varias operaciones:

- Por un lado, indico el nombre del cliente seleccionado en cada momento con el caption superior de la ventana (Como en el tipico listado NAV).

- Guardo en la propiedad tag del formulario el NoCliente, para tener acceso en todas las partes del formulario. Como es un único dato el que quiero almacenar comun a todo el formulario, puedo aprovechar el tag, es una solución rápida.

- Formateo el estado del cliente. Hasta la fecha actual, he encontrado algunos "peros" al uso de páginas, y uno de ellos es que en ocasiones hace un formateo de los datos un poco inesperado. Este caso que nos ocupa es uno de ellos, el estado de cliente bloqueado vacio, lo devuelve como un texto _blank_. Entonces tenemos que tener en cuenta esto por codigo. Para el cliente C#, solamente existen dos estados, bloqueado y no bloqueado.

En conclusión, el código queda más o menos así (dentro del mismo evento anterior datagrid1View1_CellClick, claro, y con su try-catch correspondiente):

Analizemos un poco más en detalle como esta efectuado el código. Lo primero que hay que hacer es crear un objeto del tipo servicio web de pagina, e inyectarle las credenciales, tal y como hemos hecho en el post anterior, es el que nos permite efectuar metodos que lean/actualizen los datos de origen del servicio.

A continuación, se define un objeto de la clase proxy de la pagina (ComunicaClientes). Este objeto lo cargamos con el cliente que necesitamos, mediante el método read del objeto de servicio web de pagina.

En conclusión, obtenemos un objeto del tipo cliente, con los datos de un cliente en particular. Si no encuentra cliente,devolverá una excepción.

El método read sirve para leer un registro unicamente, y se le pasan de parametros los valores de los identificadores del registro a buscar. En NAV su metodo más similar es GET.

Con esto tenemos por completo el uso del servicio web de la página, ahora hay que comenzar a utilizar el servicio web del tipo Módulo, pero esto entrará dentro de otro post, más adelante.

Nos "leemos".

Un saludo

Uso de codeunit / paginas con un cliente de C# en VS2008 (III)

2011-01-04T10:03:00.000-08:00

Hola,

Primer post de 2011!! Lo prometido es deuda, y voy a postear una pequeña explicacion de como utilizar un servicio web dentro de una aplicacion en C# del tipo pagina.Dicha aplicacion es una aplicacion de escritorio en C# sobre VS2008.

Para poder agregar la referencia inicial al servicio web (En VS2008, ojo), hay que ir a las referencias del proyecto, indicar agregar referencia de servicio, y en esta ventana el boton avanzadas, y dentro de la ventana siguiente al boton agregar referencia web. (creo que es un bug del entorno, deberia ser más fácil, desde luego).

Si introducimos la URL http://srvnavision:7047/DynamicsNAV/WS/CRONUS%20España%20S.A./Page/ComunicaClientes (Siendo: srvnavision el nombre de nuestro servidor, 7047 el puerto, DynamicsNAV el nombre del servicio y nuestra querida CRONUS la empresa de marras) en el navegador de la ventana que aparece, veremos algo como lo que sigue.

En esta ventana indicamos el nombre de la referencia al servicio web de pagina inicialmente. Yo lo he llamado refwsPaginaClientes, que me resulta descriptivo, pero allá cada cual.Hacemos click en agregar referencia, y listo. Nos tiene que quedar algo como esto en nuestro arbol de proyectos.

La primera parte de la ventana, es muy clara, voy a hacer un datagridview, y usando el asistente,
voy a crear un BindingSource para que enlace con el origen de datos de la pagina web del servicio.
Editando un poco la apariencia del datagrid, consigo un listado dinamico bastante aparente con muy
poco codigo.

Para rellenar el binding con datos, en el mismo load de la ventana principal, indico que cargue
el binding mediante el metodo readmultiple de la referencia a mi pagina de clientes, asi.

Ojo, que para gustos los colores, se puede acceder de mas formas al contenido del servicio (usar un datatable, por ejemplo) pero es la que se me ha ocurrido en esta ocasion. Una vez leidos los datos,se puede trabajar con ellos como se considere necesario.

Los parametros utilizados para el readmultiple son 3, posibles filtros, que indico a null, boomarkey (este siempre lo pongo con comillas vacias, y tamaño de los registros a devolver, que indico a 0.

Lo mas interesante de este punto, es crear las credenciales para poder acceder al servicio web de NAV, bien podemos usar la propiedad use default credentials, y usara las credenciales del usuario de Windows que tengamos en ese momento ejecutando la aplicacion, o bien, podemos crear unas
credenciales con un objeto del tipo System.Net.NetworkCredential, y asignandoselo a la propiedad credentials del servicio de NAV antes de ejecutarlo. Esto es valido tanto con servicios de paginas como servicios de codeunits.

Con esto, tenemos la parte del uso del servicio web de la pagina, posteare la parte del servicio web del modulo en unos dias.

Nos leemos.
Saludos.

Feliz Navidad.

2010-12-24T03:48:00.000-08:00

Hola,

Al final están siendo unos días pre-navideños convulsos entre trabajo y enfermedad (llevo unos días de gripazo horripilante), y no he podido volver a postear nada todavía. No obstante, no quería pasar sin felicitar la entrada de la Navidad a todos, y que paséis una buena noche y entrada navideña. Ya volveré a escribir en unos días, en cuanto se estabilice todo.

Un saludo.

Uso de codeunit / paginas con un cliente de C# en VS2008 (II)

2010-12-09T07:08:00.000-08:00

Hola,

Vamos a proseguir con la programación de este caso, en este post voy a hablar de como programar en Nav los servicios web. Cuando se habla de crear un servicio web dentro de Nav, hay que tener muy claro que no se trata de programación especial para que sea publicada, sino programación completamente normal dentro del ERP, tan sólo en la última fase del desarrollo hay que publicar los objetos que queremos que funcionen como servicio web. Para establecer los objetos a publicar, dentro del menú de Administración - Administración de IT - Configuración General - Servicios web. Aquí, indicamos el id de los objetos a publicar, y el nombre del servicio web, marcando publicado en el momento que deseemos publicar. Ojo con espacios y demas. El nombre del servicio, no tiene porqué estar relacionado con el nombre del objeto en Nav. Quedaría algo como esto en el ejemplo actual:

Hay tener en cuenta algunas limitaciones de los objetos publicados, que son las siguientes:

- Sólo pueden publicarse páginas, y codeunits, ningún otro tipo de objeto puede publicarse directamente.

- Que se publiquen páginas no significa que todas las páginas que se incluyen en el cliente estándar sirvan para publicarse como servicio. De hecho, en mi opinion, es mejor utilizar páginas propias, para disminuir el tamaño del XML del servicio a lo mínimo posible. En el caso que nos ocupa, que necesitamos tener una página para mostar la información de la tabla clientes, podriamos usar perfectamente la página 21, Customer Card, no obstante, para predicar mi mismo ejemplo, voy a crear una nueva página para este caso que nos ocupa.

El diseño de esta página es muy sencillo, sólo muestra 3 campos, y aprovechamos el uso de la página para que automaticamente nos genere toda la interfaz necesaria de manejo de clientes en .net, con clase proxy y demás. En Nav, el diseño de la página sería como el que sigue:

- Respecto a las codeunit (módulos, por alguna extraña razón, al publicar sí que se encuentra traducido xD),
hay que tener en cuenta al programarlas varias cosas. No se pueden utilizar sentencias que paren la ejecución (Error, Strmenu...), y los errores de ejecución se lanzan como una excepción con el mensaje de error de Nav hacia arriba (.NET, en este caso), por tanto, a la hora de desarrollar, debemos decidir si queremos controlar parte de los errores, o dejar que surjan todos los que Nav puede generar, y que sea .NET el que controle el mensaje y lo muestre al usuario con sentencias try...catch. Personalmente, a mi me gusta mucho mas la última opción, dependiendo del proceso, los errores en Nav se pueden disparar y nunca se puede tener en cuenta todos en los procesos complejos, asi que mejor tener transparencia con los errores al máximo. En la codeunit de este caso, he implementado 3 métodos, en los que no hago nada por controlar los errores, que sea .Net el que los muestre como mensajes. El diseño del Módulo publicado quedaría así:

Una última anotación al respecto de los servicios en Nav. Por el momento, no existen logs automaticos de variables ni de errores, si queremos gestionar con logs las llamadas, deberemos desarrollar una solución propia escribiendo con ficheros de texto o similares.

Con esto tenemos todo el desarrollo de Nav implementado. A continuación, hay que configurar el servicio web en el equipo, y con esto tendremos toda la parte de Nav publicada, pero esto se verá en otro post, mas adelante.

Nos "vemos".

Saludos.

Uso de codeunit / paginas con un cliente de C# en VS2008 (I)

2010-11-27T02:39:00.000-08:00

Hola,

Voy a comenzar a publicar una pequeña serie de post acerca de un pequeño ejemplo en el que voy a tratar de publicar un servicio de cada tipo en NAV 2009 sp1, esto es, páginas y codeunits, y utilizarlos desde un cliente desarrollado en C# con VS2008.

Lo primero de todo es analizar realmente, la cantidad de servicios que necesitamos, y de qué tipo son.
Planteo el ejemplo:

-    Es necesario tener listados en nuestro cliente de C# de todos los clientes de NAV, con su nombre, su número, y el estado de su campo bloqueado.
-    Mediante un botón en el cliente C# , se comprobará el no. de pedidos que tenemos con este cliente, el no. de facturas registradas.
-    Si lo estimamos conveniente, se puede bloquear directamente desde C# esa ficha del cliente, dejando un comentario en la ficha del cliente por escrito.

Siempre hay muchas formas de orientar la utilización de unos u otros tipos de servicios en NAV, pero en principio, y esta es mi sugerencia, se debe de seguir el siguiente criterio:

-    Siempre que se necesiten leer datos de las tablas, es muy útil utilizar los servicios de tipo página, porque permiten ver varios valores de resultado de una única vez, y tiene implementados los métodos de acceso a datos y la clase de proxy necesaria para manejarlos de forma automática.
-    Siempre que se necesiten modificar los datos, es mucho más práctico utilizar una Codeunit, para poder lanzar modificaciones sobre los datos de la base de datos.

Luego entra el gusto de cada uno. En este caso por ejemplo, yo voy a utilizar un servicio de página para ver los datos de los clientes, y uno de codeunit con tres métodos, dos para consultar el número de documentos, y otro para bloquear el cliente mediante el servicio.

Una vez planteado el problema, hay que ponerse a programar el lado de NAV, pero esto será en el siguiente blog.

Nos leemos.
Saludos.

Uso de recordref y fieldref en NAV

2010-11-27T01:16:00.000-08:00

Hola,

Tras bastante tiempo sin poder escribir nada nuevo (pasan los meses con mucho jaleo y es difícil sacar tiempo) voy a escribir un poco acerca del manejo dinámico de registros mediante las variables del tipo recordref y fieldref. Dynamics Nav utiliza diferentes tipos de variables record para manejar cada tabla (Por ejemplo, la variable clásica es un record de la tabla 18, clientes).

Estas variables tienen la ventaja de con cada una de ellas se puede acceder a la definición de la tabla y el código que tengan dentro de ella con llamadas muy simples de código, pero la desventaja de que si se intenta acceder a muchos tipos de tablas en un mismo proceso, es necesario declarar una variable de cada tipo que necesitemos de tabla en nuestro proceso para poder manejar cada tabla individualmente, lo cual provoca muchisimas variables. Si quereis ver un ejemplo de como se complica cuando se trabaja así NAV, el ejemplo perfecto del estándar es la ventana de Navegar, disponible en cualquier documento o movimiento de histórico.

No acaba aquí, mejor que lo veais en vuestros NAV.

Para poder agilizar este tipo de tareas, Dynamics Nav utiliza un tipo diferente de variables, denominadas recordref y fieldref. Este tipo de variables consiguen apuntar a un registro de una tabla / valor de un campo de este registro, mediante el uso de identificadores numéricos, y por tanto variables en tiempo de ejecución.

Si queremos abrir la tabla 18, Clientes mediante una variable recordref deberiamos hacer lo siguiente:

Simplemente comentar, que para recorrer una variable del tipo recordref, es bastante similar a una variable record normal. Ahora veamos como funcionaría en el caso de querer filtrar dentro de esta variable record ref un valor de un campo determinado. Queremos obtener el nombre del primer cliente que se encuentre bloqueado,en este caso, tenemos que empezar a trabajar con una variable fieldref, referencia de campo. Primero la utilizamos para filtrar aquellos clientes que se encuentren bloqueados:

Después, esta misma variable de tipo field ref, nos sirve para referenciar el valor de un campo de un registro que tenemos localizado con una variable recordref:

Con, esto ya podemos recorrer un registro, filtrando y utilizando los campos de ese registro de forma dinamica. Ahora, vamos a darle una pequeña vuelta al asunto. La mayor complicacion que tienen este tipo de variables, es para compararlas con las variables originales, es decir, como puedo buscar el dentro de una variable record normal, un registro que he encontrado en una variable recordref, y viceversa.

Para esto, disponemos de diferentes propiedades comunes en ambos tipos de variables, que nos pueden servir para poder comparar entre ellas. Por ejemplo, con las propiedades getview/setview y getposition/setposition, podemos localizar el registro encontrado de forma dinamica y mostrarlo con su listado correspondiente en forma de registro normal. Hay que tener en cuenta que no se puede utilizar formularios con variables del tipo recordref, asi que hay que traducirlo a un tipo de variable que sí le valga al formulario:

Con esto, ya tendriamos controlado el uso de este tipo de variables de forma correcta. Hasta aqui ha sido todo en este post. Nos leemos.

Saludos.