INTRODUCCIÓN

Esta categoría refiere al software desarrollado usando Delphi. Como se mencionó previamente la aplicación actúa mayormente como un navegador mostrando pantallas, consultas y opciones que están definidas en la base de datos.

No sabe nada acerca de qué está mostrando, pero sí sabe cómo mostrarlo y qué hacer cuando debe accionar sobre objetos del catálogo. Por ejemplo: los auxiliares.

No obstante, incluye alguna funcionalidad específicamente relacionada con algunos objetos del sistema ya que en el momento del desarrollo era más rápido programarlo en Delphi que definirlo en el catálogo. Habitualmente trabajamos contra reloj. Esa funcionalidad se asocia al grupo “IMPLEMENTED” de los descriptos más abajo.

Es muy poco frecuente que se toque el código de Delphi, y cuando se hace es habitualmente para ajustes muy sencillos.

ASPECTOS BÁSICOS DE DELPHI

Instalación específica a Pragma

• Instalación de Delphi describe algunos aspectos básicos de la instalación específica de Delphi para Pragma.

Configuraciones importantes

• Configuraciones importantes de Delphi describe algunas configuraciones referidas a la instalación de Delphi para Pragma.

Ayuda en línea sobre Delphi

Para acceder a ayuda en línea sobre Delphi se puede consultar Documentación online de Delphi.

Aclaro que la ayuda de Delphi XE ya no está disponible en ese sitio, pero sí de versiones posteriores.

Introducción al desarrollo en Delphi

• En Introducción al desarrollo en Delphi hay una breve documentación sobre el desarrollo en Delphi usando Object Pascal.

DOCUMENTACIÓN DE PRAGMA

DATAMODULE

El TDataModule (Delphi) de una aplicación de Delphi permite centralizar el uso de componentes no visuales. Típicamente contiene componentes de datos derivados de Datasets pero en realidad puede contener casi cualquier cosa. Su uso simplifica la estructura de la aplicación conteniendo funcionalidad usada continuamente.

Durante el diseño, el data module provee un contenedor visual al que podemos agregar componentes no visuales, definir sus propiedades y escribir eventos. No obstante, la mayoría de los componentes del data module de Pragma se instancian programáticamente.

• La categoría Data module describe el contenido específico del data module de Pragma.

DATASETS

Los datasets en Delphi son los componentes que se conectan a una base de datos, y a los objetos que éstas contienen tales como tablas, procedimientos y demás. Pragma deriva de estos componentes agregando funcionalidad específica.

Delphi incluye una variedad de componentes de conexión a datos, los elegidos para Pragma son aquellos que se conectan a través de ADO que es un conjunto de clases que proporcionan servicios de acceso a datos. Por ejemplo, desde Pragma a un servidor SQL SERVER.

Desarrolla grupos de funcionalidad:

• DATASETS: clases relacionadas con el acceso a datos de la base de datos.
• COMPROBANTES: clases relacionadas con el manejo genérico de comprobantes.
• IMPLEMENTED: clases relacionadas con funcionalidad específica de objetos del catálogo.

Eventos y mensajería de datasets

Los datasets (al igual que cualquier componente de Delphi) usan activamente el envío de mensajes y eventos entre componentes.

• La unidad Definiciones de eventos y mensajería de datasets (prxDataTypes) define mensajes y eventos específicamente creados para Pragma.

Conexión a la base de datos

Esta sección incluye componentes que, si bien no son datasets, tienen que ver con la conexión a la base de datos.

• Conexión a la base de datos describe estos componentes.

Queries

Los queries (que literalmente se traducen como consultas) son componentes que pueden usarse para ejecutar sentencias de SQL, normalmente de lectura, pero también de ejecución. Derivan de un componente de Delphi denominado TADOQuery y agregan funcionalidad propia. Se usan habitualmente para consultar datos o aplicar sentencias SQL a la base de datos, pero no se usan con controles de edición de datos de tablas.

• La categoría Queries describe a los queries.

Datasets

Los Datasets normalmente representan datos (de una base de datos, u otro origen como Excel) en forma de filas (llamadas registros) y columnas (llamadas campos). Introducen la funcionalidad básica para trabajar con esta información facilitando la edición de esos datos. No se usan para hacer consultas.

Los TADODatasets derivan de los Datasets y conectan con los orígenes de datos exclusivamente a través de una conexión ADO.

• La categoría Datasets describe a los datasets.

Datasets implementados

Los datasets implementados derivan de alguno de los datasets ya mencionados e implementan funcionalidad específica a alguna de las tablas del sistema.

Por ejemplo, el dataset implementado denominado Ordenes de pago (TOPCAB_implemented) implementa funcionalidad específica a la tabla ORDENES PAGO. Cuando la aplicación recibe la instrucción de abrir una ventana primero debe crear el dataset que conectará a la base de datos, y antes de abrir uno de los datasets mencionados verifica si existe uno que tenga el mismo nombre de la tabla (más el prefijo T) y el sufijo _implemented. Si existe lo usa, sino usa el dataset genérico.

Estos datasets implementados han resultado prácticos para incorporar funcionalidad específica que excede las posibilidades de las herramientas específicas.

• La categoría Datasets implementados describe a los datasets implementados.

AUXILIARES

Los auxiliares permiten agregar funcionalidad a las clases (tablas) y a los campos. En MANUAL/DESARROLLADOR están explicados en la categoría Auxiliares, en este manual se explican los módulos programados en Delphi para hacer que las definiciones explicadas previamente funcionen correctamente.

• La categoría Auxiliares describe la funcionalidad de Delphi relacionada con estos auxiliares.

CONTROLES

Los controles en Delphi son componentes que tienen una representación visual y permiten la interacción del usuario con la aplicación.

TWinControl es el componente que define la funcionalidad de casi todos los controles visuales.

Los controles pueden recibir el foco, es decir que podemos posicionar el cursor sobre ellos (por ejemplo: picar una pantalla para traerla al frente), y el control con el foco recibe eventos del teclado y del mouse.

Algunos controles cambian de aspecto cuando reciben el foco, por ejemplo: los botones dibujan una caja en el contorno cuando reciben el foco.

Un control puede ser contenedor para otros controles, los que se refiere como 'hijos'. Esta relación se define usando la propiedad Parent del control que indica sobre qué control se ubica el analizado.

Ayuda de Delphi sobre TWinControl.

Desarrolla grupos de funcionalidad:

• EDICION/FORMS: forms (pantallas) de edición.
• FORMS: clases relacionadas con forms (pantallas) en general.
• EDICION/FRAMES: frames (una especie de pantalla, o porción, que se aloja en una pantalla) de edición.
• EDICION/CAMPOS: manejo de los campos durante la edición.
• EDICION/CONTROLES: controles de edición.
• GRILLAS: clases relacionadas con las grillas de datos.

Controles de edición

Los controles de edición son aquellos que pueden recibirla interacción directa de un usuario, por ejemplo: ingresando un texto en una caja de edición.

• La categoría Controles describe los controles más usados.

Forms

Los forms permiten definir conjuntos visuales de controles (cajas de edición, botones, etc.) que se muestran al usuario como una pantalla.

• La categoría Forms describe los forms más usados.

Ayuda de Delphi sobre forms.

Frames

Los frames permiten definir los mismos conjuntos visuales de controles (cajas de edición, botones, etc.) que los forms, pero se muestran al usuario dentro de una pantalla. Bajo determinadas circunstancias es más conveniente definir frames que definir forms. Esto se argumenta más adelante.

• La categoría Frames describe los frames más usados.

Ayuda de Delphi sobre frames.

FILTROS

• La categoría Filtros describe las opciones de filtrado de la aplicación.

Desarrolla grupos de funcionalidad:

• FILTROS: clases relacionadas con las opciones de filtrado de las pantallas.

IMPRESIÓN

• La categoría Impresión describe las opciones de impresión.

Desarrolla grupos de funcionalidad:

• IMPRESION: clases relacionadas con la impresión.

EXPLORADOR

• La categoría Explorador describe la pantalla principal de la aplicación.

Desarrolla grupos de funcionalidad:

• EXPLORADOR: clases relacionadas con el form explorador de Pragma.
• MENU OPCIONES: clases relacionadas con el menú de opciones de las pantallas.
• MENU: clases relacionadas con los menús de usuario
• INTERFAZ DE USUARIO: otras clases relacionadas con la interfaz de usuario.

REPLICACION

Los componentes programados se han agregado a la categoría DEV REPLICACION/Componentes asociados existente en el MANUAL/DESARROLLADOR y deben consultarse allí.

Desarrolla grupos de funcionalidad:

• REPLICACION: clases relacionadas con la replicación de datos.

PROYECCIÓN FINANCIERA

Los componentes programados se han agregado a la categoría PLANIFICACION FINANCIERA/Componentes asociados en el MANUAL/DESARROLLADOR y deben consultarse allí.

Desarrolla grupos de funcionalidad:

• PROYECCION FINANCIERA: clases relacionadas con la planificación financiera.

OBJETOS

OBJETOS/REFRESCO

• Selección de campos calculados de un atributo tipo clase (TTprxCamposCalculadosForm).
• Exportar catálogo (TTfvsCatalogoExportarForm)
• Importar catálogo (TTfvsCatalogoImportarForm)
• Refrescar el catálogo (TTfvsCatalogoRefrescarForm)

Desarrolla grupos de funcionalidad

• OBJETOS/VISTAS: clases relacionadas con las vistas del catálogo.
• OBJETOS/FUNCIONES: clases relacionadas con las funciones del catálogo.
• OBJETOS/PROCEDIMIENTOS: clases relacionadas con los procedimientos del catálogo.
• OBJETOS/FRAMES: clases relacionadas con los frames del catálogo.
• OBJETOS/SCRIPTS: clases relacionadas con los scripts del catálogo.
• OBJETOS/AUXILIARES: clases relacionadas con los auxiliares del catálogo.
• OBJETOS/REFRESCO: clases relacionadas con el refresco de catálogos (cada vez que hacemos un cambio en el catálogo se ejecuta un refresco).

VIDEOS - CASOS DE USO (pendientes)

La documentación incluirá “casos de uso” que recorre el uso de clases de Delphi para completar la tarea, Algunos casos son:

• Inicio de la aplicación hasta llegar al menú de usuario, analizar opciones del menú.
• Apertura de una consulta, ingreso de criterios y visualización del resultado, opciones de menú.
• Apertura de una pantalla de datos, aplicar criterios de filtrado, opciones de menú.
• Edición de una pantalla de datos, proceso de validación de los campos, grabado final.
• Eliminación de un registro.