toba

SIU-TOBA - Ambiente de Desarrollo Web

TOBA
Ambiente de Desarrollo Web

Marcia Tejeda
Martin Arin

1/14

SIU-TOBA - Ambiente de Desarrollo Web

Índice
¿Qué es SIU-TOBA?
Flujo de trabajo
Esquema de Directorios
Esquema de Ejecución
Administración Básica
Pasos de la instalación
Creando ABMs.
El código
Ejemplo de código:
Consola de comandos
Instalación
Instancia
Proyecto
Referencias:

¿Qué esSIU-TOBA?
SIU-Toba es un Ambiente de Desarrollo Web que utiliza a PHP como lenguaje de programación.
Lo llamamos Ambiente porque es una suite de distintas utilidades:
● Un conjunto de librerías que son consumidas en ejecución.
● Un editor web destinado a la definición/configuración del proyecto, creación de operaciones
y definición de sus comportamiento.
● Un conjunto de comandos de consola destinados aadministrar los proyectos creados con la
herramienta.
Las definiciones realizadas en el editor web se las denomina metadatos, y junto a las definiciones
en código conforman el comportamiento del proyecto creado. Durante el desarrollo estos metadatos
son almacenados en una base de datos relacional denominada instancia.
Con Toba se han desarrollado aplicaciones de gran importancia para todas lasuniversidades
argentinas. Entre ellas, el SIU-Guaraní.

Flujo de trabajo
El flujo de desarrollo con la herramienta podría definirse así:
1.
Se utiliza el editor web de toba para definir una operación, sus pantallas, sus componentes
gráficos, tablas que se consumen, etc. Todo esto se almacena en metadatos en una base de
datos.
2.
Se utiliza un editor PHP para crear el código necesario para cubrirlógica particular de la
operación.
3.
Durante este proceso se va probando la operación desde el mismo editor web haciendo
ajustes contextuales.
4.
Una vez terminada se utilizan los comandos administrativos para exportar el proyecto desde
el puesto de desarrollo e importarlo en el sistema en producción.
5.
En el sistema en producción sólo necesita las librerías o runtime para ejecutar el proyecto(código + metadatos).

Esquema de Directorios
2/14

SIU-TOBA - Ambiente de Desarrollo Web
La siguiente es una lista de los directorios más importantes de Toba y sus funcionalidades a alto
nivel:
● bin: Contiene la puerta de entrada a los comandos de consola. Para poder ejecutarlos desde
cualquier terminal/consola, a este directorio es necesario incluirlo en el PATH del sistema
operativo.
● doc:Contiene documentación interna del proyecto. Para el desarrollador, la mejor
documentación se encuentra en el wiki y en este tutorial.
● instalación: Contiene toda la configuración local (base que se utiliza, proyectos que se
editan, alias de apache, etc.) y los metadatos locales (logs, usuarios, etc.). Generalmente es
un directorio que no se versiona ya que solo contiene información local de estainstalación.
● php
○ 3ros: Librerías externas utilizadas en el proyecto.
○ consola: Código fuente de los comandos administrativos de consola.
○ contrib: Código contribuido por los proyectos, que aún no pertenecen al núcleo pero
que esta bueno compartir.
○ lib: Clases sueltas propias comunes a todo el ambiente
○ modelo: Contiene una serie de clases que utilizan el editor y los comandos para
editarmetadatos y código. Forman una base útil para armar otras herramientas
consumiendo una API de alto nivel. Por ejemplo si el proyecto determina que es
necesario desarrollar un instalador con prestaciones extras, es un buen comienzo
consumir estas clases.
○ núcleo: Runtime o conjunto de clases que se utilizan en la ejecución de un proyecto.
La documentación de estas clases se encuentra publicada.
●proyectos: Este directorio contiene los proyectos propios del ambiente y es el lugar sugerido
para nuevos proyectos. Aunque pueden situarlos en cualquier directorio, si están aquí es más
fácil configurarlos.
○ mi_proyecto:
■ metadatos: Contiene la última exportación de metadatos del proyecto.
■ php: Directorio que será parte del include_path de PHP, se asume que el
proyecto almacenará aquí sus...