Diferencia entre revisiones de «Cómo compilar paso a paso»
(→Configuración del compilador en EditPlus) |
(→Configuración del compilador en EditPlus) |
||
| Línea 49: | Línea 49: | ||
:*'''/D:''' --> Indicaremos el directorio destino donde queramos que se generen el diccionario(.ndc) y el modelo(.nmc). | :*'''/D:''' --> Indicaremos el directorio destino donde queramos que se generen el diccionario(.ndc) y el modelo(.nmc). | ||
:*'''/S:''' --> Su inclusión indica que sólamente se genere el diccionario y no el modelo. | :*'''/S:''' --> Su inclusión indica que sólamente se genere el diccionario y no el modelo. | ||
| − | En nuestro caso, añadiremos el parámetro '''/O:''' para que al compilar compare el diccionario previo con el nuevo creado, de manera que pueda detectar los cambios.<p> | + | En nuestro caso, añadiremos el parámetro '''/O:''' para que al compilar compare el diccionario previo con el nuevo creado, de manera que pueda detectar los cambios.<p>A continuación, añadiremos en el campo '''''Initial directory''''' el directorio donde se encuentra el fichero .npc (si no indicamos el directorio destino con el parámetro /D: el compilador almacenará el diccionario y el modelo en este directorio).</p>Finalmente, activaremos las casillas '''''Capture output''''' para ver los mensajes de compilación en el propio EditPlus (en vez de en una ventana) y '''''Save open files''''' para que al compilar se guarden los ficheros abiertos del proyecto en cuestión. Los ficheros abiertos que no pertenezcan al proyecto no se guardarán.<p>Ahora veremos que la opción '''''Compilar''''' estará disponible en el menú '''''Tools''''' o '''''Herramientas'''''.</p> |
<center> | <center> | ||
Revisión del 19:07 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.
Contenido
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
- Segundo paso: dentro de Preferences, ir a la etiqueta 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.
- 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.
- Quinto paso: vemos que hay ciertos campos como Menu text, Command, Argument o Initial directory además de ciertas opciones activables.
En Command introduciremos la ruta en donde está almacenado el ejecutable del egCompiler.
En el campo Argument podremos especificar los argumentos que acepta el egCompiler. Como parámetro de entrada tenemos que incluir el fichero de definiciones .npc. Además, existen unos parámetros adicionales que permiten configurar el comportamiento del compilador. Por ejemplo:- /O: --> Indicaremos el diccionario previo a la compilación para compararlo con el nuevo diccionario.
- /N: --> Indicaremos el directorio de definiciones.
- /D: --> Indicaremos el directorio destino donde queramos que se generen el diccionario(.ndc) y el modelo(.nmc).
- /S: --> Su inclusión indica que sólamente se genere el diccionario y no el modelo.
A continuación, añadiremos en el campo Initial directory el directorio donde se encuentra el fichero .npc (si no indicamos el directorio destino con el parámetro /D: el compilador almacenará el diccionario y el modelo en este directorio).
Finalmente, activaremos las casillas Capture output para ver los mensajes de compilación en el propio EditPlus (en vez de en una ventana) y Save open files para que al compilar se guarden los ficheros abiertos del proyecto en cuestión. Los ficheros abiertos que no pertenezcan al proyecto no se guardarán.Ahora veremos que la opción Compilar estará disponible en el menú Tools o Herramientas.
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:
Archivo:Figura 18.JPG Proyecto egeasy |
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.
Archivo:Figura 19.JPG Editplus |
A continuación nos centraremos en configurar el Editplus para poder compilar:
- Accedemos a Tools --> Configure User Tools
Archivo:Figura 20.JPG Configuración de Editplus |
- 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.
Archivo:Figura 21.JPG Proyecto egeasy |
- 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
