Diferencia entre revisiones de «Cómo compilar paso a paso»

Revisión del 16:51 10 feb 2009

Cuando un centro es modificado, bien sea mediante cambios en el diccionario o en el modelo, es necesario realizar una serie de operaciones para que las variaciones realizadas se vean reflejadas en la aplicación egExplorer. Operaciones como compilar, actualizar el centro, etc. En este artículo abordaremos aquellos aspectos que influyan en dichas modificaciones, así como los pasos a seguir en función de qué elementos o ficheros del modelo se modifiquen. Para ello, es necesario entender los ficheros que intervienen en el funcionamiento de un centro, y cómo afectan a éste.

Configuración del compilador en EditPlus

A la hora de programar en ODL, es necesario configurar el compilador (egCompiler) en algún editor de programación. En este caso, el editor utilizado es EditPlus. Sin más preámbulos, veamos cómo configurar dicho compilador para utilizarlo en el editor:

• Primer paso: ir a Tools -> Preferences

Tools -> Preferences

• Segundo paso: dentro de Preferences, ir a la etiqueta User tools

Entrar en User Tools

• Tercer paso: una vez en User tools, hay varias opciones y campos que debemos configurar. En primer lugar, vemos que existen varios grupos. Seleccionamos uno de ellos, y para cambiar el nombre haremos click en Group Name.... Estos grupos sirven para etiquetar conjuntos de herramientas que definamos en EditPlus, como por ejemplo, en nuestro caso, la configuración del compilador.

Editar el nombre de un grupo

• Cuarto paso: ahora, tenemos que crear una herramienta. Para ellos seleccionamos hacemos click en Add Tool >> y en el desplegable que aparece, seleccionaremos Program para indicar que vamos a configurar una aplicación.

Añadimos una herramienta, en este caso, nuestro compilador

• Quinto paso: vemos que hay ciertos campos como Menu text, Command, Argument o Initial directory además de ciertas opciones activables.

Introducir datos necesarios para la ejecución del compilador

En Command introduciremos la ruta en donde está almacenado el ejecutable del egCompiler.

Y en el campo Initial directory añadiremos el directorio del proyecto que tenemos en desarrollo.

Ahora veremos que la opción Compilar estará disponible en el menú Tools o Herramientas.

El compilador ya se puede utilizar desde EditPlus

Conceptos Básicos

Para que el desarrollador se familiarice con un proyecto en egeasy comenzaremos explicando los diferentes tipos de archivos que se puede encontrar. A continuación mostraremos una referencia de los tipos de archivos que usaremos en EGE:

• Dictionary.Ndc: contiene las relaciones entre entidades, tareas y procesos de nuestro sistema de información, es único.
• proyecto.Nmc: contiene la implementación del sistema de información, es único.
• Escritos.Ndf: archivos de código fuente que se usaran para generar el diccionario.
• Gestión de modificación.Nmt: archivos de código interpretado en los que se definen los métodos.
• MP-Inf 001.rtf: archivos plantilla para los documentos generados.

A continuación pasaremos a explicar la estructura de un proyecto en EGE:

Source: están todos los archivos *.ndf de código fuente que son necesarios para generar el diccionario.

• Habitaciones: tantas carpetas como habitaciones que tendrán el código fuente que definan relacionados con dicha habitación.
• Tareas: tantas carpetas como habitaciones
  • Habitaciones: que tendrán el código fuente que definan las tareas relacionadas a las habitaciones.

Data: están todos los archivos .csv que guardan los datos estáticos de nuestro sistema de información.

• Métodos: están todos los archivos .mnt y tiene tantas carpetas como habitaciones
  • Habitaciones: con los archivos .mnt en los que se definen los métodos de las habitaciones.

Instalation: archivos correspondientes a la instalación del centro (no para la creación).
Template documents: contiene los archivos .rtf que definen los documentos que se realizan en nuestro sistema de información.

• Habitaciones: para organizar los .rtf

Template prints: archivos que configurarán la vista con la que se mostrarán los formularios. Si no se tocan se mostrarán por defecto.
Template views: configurarán la vista de los elementos del Egexplorer. Si no se tocan se mostrarán por defecto.

Tarea A: Configurando Editplus

El programa que usamos para la edición de código fuente es el Editplus, es un editor de texto con un par de funciones más. La interfaz que nos ofrece el programa consta de varias partes:

• Columna vertical izquierda: navegador del sistema de fichero con el contenido de la carpeta por la que estemos navegando.
• Pequeña consola : situada en la parte inferior sirve para mostrar los resultados de compilación o de las búsquedas de texto.
• Barra de herramientas : que contiene todos las herramientas, la búsqueda en ficheros bastante útil.
• Ventana central : visor de archivos.

A continuación nos centraremos en configurar el Editplus para poder compilar:

• Accedemos a Tools --> Configure User Tools

• Menú text: nombre de la herramienta.
  Ejemplo: Generar Diccionario
• Command: ruta donde esta el compilador.
  Ejemplo: S:\Entornos 2002\Banzai\Aplicaciones\egCompiler\egCompiler.exe
• Argument: argumentos necesarios para el compilador, el nombre del proyecto y la ruta donde poner el diccionario.
  Ejemplo: Maxorata.npc /O:"I:\Desarrollo\xIvan\Maxorata\Dictionary.ndc"
• Initial directory: ruta del proyecto.
  Ejemplo:I:\Desarrollo\xIvan\Maxorata\

Tarea B: Compilar

A continuación vamos a explicar todos los pasos que se han de seguir para compilar un proyecto de egeasy, para ello usaremos el centro Maxorata y el modelo MaxorataMod:

• Conseguir el diccionario que vamos a compilar y lo copiamos en nuestra carpeta donde pondremos el proyecto I:\Desarrollo\xIvan\Maxorata

• I:\Desarrollo\Diccionarios en Explotación\Maxorata :sirve de carpetas para hacer copias de seguridad de los diccionarios en elaboración (ya que no se pueden subir al servidor de control de versiones), todas las personas que están desarrollando para este modelo lo pueden coger. A esta carpeta solo se suben los diccionarios que están correctos y siempre se tiene que guardar el archivo que ya está, renombrandolo a .old

• Para generar el diccionario Tools --> User Tool Groups --> Generar Diccionario

EGcompiler genera 2 archivos: el diccionario (Dictionary.Ndc) y el modelo de nuestro centro (Maxorata.Nmc). En el caso que hayas creado nuevas unidades en el sistema de información saldrá una ventana como la siguiente en donde deberemos seleccionar que unidades generar, cuales liberar (borrar) o hacer coincidir alguna antigua con una nueva.

Está parte es bastante compleja ya que tienes que tener muy claro lo que has hecho o han hecho tus compañeros.

• Debemos copiar, de la carpeta raíz donde está el proyecto, el diccionario y copiarlo a mano en el servidor donde está alojado realmente tu centro.

La ruta será: S:\Entornos 2002\Banzai\Modelos\MaxorataMod

OJO: si copiamos el diccionario en otra carpeta nos machacariamos el diccionario de un compañero

• Una vez copiado el diccionario, abrimos egAdmin:

a.Paramos el centro b.Actualizamos nuestro modelo Herramientas --> Actualizar --> Ruta I:\Desarrollo\xIvan\Maxorata y seleccionamos el archivo maxorata.Nmc. c.Comprobamos nuestro modelo Herramientas --> Comprobar d.Arrancamos el centro

• Trucos:

Para evitar estar actualizando el modelo continuamente nos bastará con copiar el diccionario generado al compilar en la carpeta del servidor y reiniciar el centro. Esto es válido para los siguientes casos:

• Modificar métodos
• Modificar plantillas de documentos (*.rtf)
• Modificar propiedades de unidades (campos o atributos)
• Modificar sentencias SQL

Tarea C: Actualizar

Tarea D: Instalar

Tarea E: Crear usuarios