Egeasy - Contribuciones del usuario [es]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-07-13T13:21:53Z

Nmelian: /* Creación de tablas en la base de datos */

__TOC__
=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat

=Pasos a seguir=
Para la instalación de la aplicación web del Sistema de Tramitación Electrónica, vamos a disponer de una instalación de la aplicación XAMPP, que nos proporciona de una forma rápida sencilla las aplicaciones requeridas para una puesta en marcha. Para que las explicaciones de los ficheros de configuración sean lo menos confuso posible, en este articulo vamos a instalar la aplicación XAMPP en ''C:\'', por lo tanto todas las rutas se explicaran de dicha ruta. Ademas de instalar la aplicación XAMPP, tenemos que instalar el servicio web, el cual lo vamos a instalar para mayor comodidad en ''C:\ste''. Así que todas las explicaciones parten de dicha ruta de instalación.

==Configurar el servidor web, Apache==
Para configurar el servidor Apache, debemos modificar el archivo de configuración, que esta en la ruta ''C:\xampp\apache\conf'' con el nombre de ''httpd.conf''. Al final de dicho fichero debemos poner lo siguiente:

ScriptAlias "/URLALIAS" "''PATHWEBSERVICE''"
<Directory "''PATHWEBSERVICE''">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

'''URLALIAS''': Es la URL que vamos a definir donde va a estar nuestro servicio web. Para este ejemplo usaremos ''tramitacion''.
 '''PATHWEBSERVICE''': Es la ruta física donde está desplegado el servicio web. Para este ejemplo, esa ruta es la siguiente: ''C:/STE/tramitacion/''.

Un ejemplo podría ser el siguiente:

ScriptAlias "/tramitacion" "C:/STE/tramitacion"
<Directory "C:/STE/tramitacion/">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

==Configurar el servicio web STE==
Para configurar el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ''webservice.ini'' que esta en la ruta ''C:\STE\tramitacion'', que para este ejemplo será donde esta instalado.

Al abrir el fichero ''webservice.ini'' encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SERVER_ADDRESS''': IP donde se publicará el servicio web.
*'''SERVER_PORT''': Puerto donde se publicará el servicio web.
*'''WS_IDENTIFIER''': Identificador del servicio web.
*'''WS_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''WS_DB_TYPE''': Gestor de base de datos. Posibles valores: SQL Server, Oracle, PostgresSQL, Firebird.
*'''WS_DIRECTORY_DOCUMENTS''': Ruta donde se almacenan los documentos generados por la aplicación.
*'''WS_DIRECTORY_LOGS''': Ruta donde se localizan los logs del servicio web.
*'''WS_FILE_INVALID_WORDS''': Ruta del fichero donde están las palabras que no se van a indexar en la base de datos.
*'''TYPE_REGISTRATION''': Si esta etiqueta está presente, entonces en la aplicacón web los usuarios podrán registrarse libremente. Los valore que admite esta etiqueta es ''Free''.
*'''REGISTRATION_FORM''':Ruta y nombre del archivo xml que se usará para generar el formulario de registro en la aplicación web. Para este ejemplo usaremos el siguiente fichero ''C:\STE\registration.xml''.
*'''EGE_USER_RRC''': Identificador del usuario en la plataforma egeasy, con el que va a acceder la aplicación web a la plataforma. Para un correcto funcionamiento, debemos generar un usuario en la plataforma solo para esta aplicación web.
*'''EGE_CENTER_NAME''':Nombre del centro al que se le va a poner la aplicación web.
*'''EGE_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''EGE_DB_TYPE''': Nombre del tipo de base de datos que se usa para la plataforma egeasy.

*'''EGE_MODEL_DIRECTORY''': Ruta donde se localiza el modelo del centro de la plataforma egeasy.
*'''EGE_DOCUMENT_DIRECTORY''': Ruta donde se localizan la base documental de la plataforma egeasy.
*'''EGE_REGISTRY_DIRECTORY''': Ruta donde se localizan los registro de la plataforma egeasy.

Un ejemplo de un fichero de configuración, podría ser el siguiente:
SERVER_ADDRESS=10.22.144.178
SERVER_PORT=10000
WS_IDENTIFIER=WS_STE
WS_DB_CONNECTION_STRING=usuario@servidorBD@contraseña
WS_DB_TYPE=Oracle
WS_DIRECTORY_DOCUMENTS=C:\STE\Docs
WS_DIRECTORY_LOGS=C:\STE\Logs
WS_FILE_INVALID_WORDS=C:\STE\palabras.dat
TYPE_REGISTRATION=Free
REGISTRATION_FORM=C:\STE\registration.xml
EGE_USER_RRC=3825
EGE_CENTER_NAME=Acecau STE Oracle
EGE_DB_CONNECTION_STRING=usuario@servidorBD@contraseña
EGE_DB_TYPE=Oracle
EGE_MODEL_DIRECTORY=S:\Entornos 2002\Banzai\Modelos\ACECAU STEMod
EGE_DOCUMENT_DIRECTORY=S:\Entornos 2002\Banzai\Documentos\AcecauSTEDoc
EGE_REGISTRY_DIRECTORY=S:\Entornos 2002\Banzai\Registro\acecausteReg

==Configurar la aplicación web STE==

Para configurar la aplicación web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\xampp\tomcat\webapps\ste\WebContent\WEB-INF\classes\org\siani\ste\configuration, que para este ejemplo será donde esta instalado.

Al abrir el fichero ste.conf encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SITE_DIR''': Ruta donde se encuentra instalada la aplicación web.
*'''SITE_URL''': URL donde se encuentra la aplicación web.
*'''LOG_DIR''': Ruta donde se encuentran los logs de la aplicación web.
*'''DATA_DIR''': Ruta donde se encuentra los datos variables de la aplicación web.
*'''TEMPLATES_DIR''': Ruta donde se encuentra las plantillas html de visualización.
*'''TEMP_DIR''': Ruta donde se encuentra los archivos subidos por los usuarios temporalmente.
*'''SITE_DATA_DEFINITIONS_DIR''': Ruta donde se encuentran las definiciones datos personalizados.
*'''SITE_FORMS_DIR''': Ruta donde se encuentra las vistas personalizadas de los trámites.
*'''SITE_PORT''': Puerto que usa la aplicación web.
*'''API_URL''': URL del servlet, llamado API que usa la aplicación web.
*'''SITE_IMAGES_DIR''': Ruta donde se encuentran las imagenes de la aplicación web.
*'''SITE_IMAGES_URL''': URL donde se encuentran las imagenes de la aplicación web.
*'''SITE_JAVASCRIPT_DIR''': Ruta donde se encuentran el javascript de la aplicación web.
*'''SITE_JAVASCRIPT_URL''': URL donde se encuentran el javascript de la aplicación web.
*'''SITE_STYLES_DIR''': Ruta donde se encuentran los estilos CSS de la aplicación web.
*'''SITE_STYLES_URL''': URL donde se encuentran los estilos CSS de la aplicación web.
*'''WS_SOAP_URL''': URL donde se encuentra el servicio web del STE.
*'''LANG_DIR''': Ruta donde se encuentra los archivos de idioma.
*'''EN = en''': Se define el lenguaje Ingles.
*'''ES = es''': Se define el lenguaje Español.
*'''DEFAULT_LANGUAGE''': Indica que lenguaje se va a usar por defecto en la aplicación.

Un ejemplo del fichero de configuración es:

// DIRECTORIES
SITE_DIR = c:/xampp/tomcat/webapps/ste/WebContent
SITE_URL = http://ste
LOG_DIR = C:/xampp/tomcat/webapps/ste/logs
DATA_DIR = C:/xampp/tomcat/webapps/ste/data
TEMPLATES_DIR = C:/xampp/tomcat/webapps/ste/templates
TEMP_DIR = C:/xampp/tomcat/webapps/ste/temp
SITE_PORT = 80
SITE_DATA_DEFINITIONS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions
SITE_FORMS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions/forms
API_URL = http://ste/api
SITE_IMAGES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/images
SITE_IMAGES_URL = http://ste/images
SITE_JAVASCRIPT_DIR = c:/xampp/tomcat/webapps/ste/WebContent/javascript
SITE_JAVASCRIPT_URL = http://ste/javascript
SITE_STYLES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/styles
SITE_STYLES_URL = http://ste/styles
WS_SOAP_URL = http://ste/tramitacion/tramitacion_ws_cgi.exe/soap/IEgeWebService
LANG_DIR = C:/xampp/tomcat/webapps/ste/languages
// LANGUAGES
EN = en
ES = es
DEFAULT_LANGUAGE = es

==Configurar el DNS==
Debemos preparar nuestra maquina, para indicar mediante un nombre de dominio donde esta situado el Sistema de Tramitación Electrónica, para nuestro caso, el sistema esta instalado en local. Por lo tanto solo debemos ir a la ruta de nuestro equipo donde está el fichero ''hosts'', que esta en ''C:\WINDOWS\system32\drivers\etc\'' e introducir lo siguiente:

127.0.0.1 ste

==Creación de tablas en la base de datos==
Para la implantación del Sistema de Tramitación Electrónica, se deben crear unas cuantas tablas y indices en la base de datos. Par este ejemplo vamos a utilizar la misma base de datos y esquema donde tenemos implantada ya la plataforma egeasy. A continuación se listaran los script con las sentencias SQL que hay que ejecutar en la base de datos, para generar todo lo necesario para el Sistema de Tramitación Electrónica. Disponemos de los script tanto para SQL-Server como para Oracle.

*Script para base de datos en SQL-Server
CREATE TABLE WS$USERS
(ID NUMERIC(10) PRIMARY KEY,
NIF VARCHAR(10),
NAME VARCHAR(50),
FULLNAME VARCHAR(50),
EMAIL VARCHAR(50),
FORM IMAGE);
CREATE TABLE WS$PROCESSES
(ID NUMERIC(10) PRIMARY KEY,
LABEL VARCHAR(100),
TRAMITATION_STATUS VARCHAR(100),
ID_PROCEDURE NUMERIC(10),
ID_USER NUMERIC(10),
STATUS NUMERIC(1),
CREATE_DATE DATETIME,
START_DATE DATETIME,
END_DATE DATETIME,
LAST_READ_DATE DATETIME);
CREATE TABLE WS$TASKS
(ID NUMERIC(10) PRIMARY KEY,
ID_PROCESS NUMERIC(10),
ID_EGE NUMERIC(10),
ID_DEFINITION NUMERIC(10),
CREATE_RECEIVE_DATE DATETIME,
SEND_RESPONSE_DATE DATETIME,
STATUS NUMERIC(1),
RESPONSE_TO NUMERIC(10),
CONTENT IMAGE);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMERIC(10) PRIMARY KEY,
SIGNATURE IMAGE);
CREATE TABLE WS$TASK_SNAPSHOTS
(ID NUMERIC(10) PRIMARY KEY,
SNAPSHOT IMAGE);
CREATE TABLE WS$FILES
(ID NUMERIC(10),
ID_TASK NUMERIC(10),
ID_EGE NUMERIC(10),
ATTACH_DATE DATETIME,
SOURCE NUMERIC(1),
FILE_NAME VARCHAR(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR(50),
SUBSEQUENCE VARCHAR(50),
CURRENT_VALUE NUMERIC(10));
CREATE TABLE WSI$WORDS
(ID NUMERIC(10),
CAPTION VARCHAR(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMERIC(10),
ID_PROCESS NUMERIC(10),
ID_TASK NUMERIC(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

*Script para base de datos en Oracle
CREATE TABLE WS$USERS
(ID NUMBER(10) PRIMARY KEY,
NIF VARCHAR2(10),
NAME VARCHAR2(50),
FULLNAME VARCHAR2(50),
EMAIL VARCHAR2(50),
FORM LONG RAW);
CREATE TABLE WS$PROCESSES
(ID NUMBER(10) PRIMARY KEY,
LABEL VARCHAR2(100),
TRAMITATION_STATUS VARCHAR2(100),
ID_PROCEDURE NUMBER(10),
ID_USER NUMBER(10),
STATUS NUMBER(1),
CREATE_DATE DATE,
START_DATE DATE,
END_DATE DATE,
LAST_READ_DATE DATE);
CREATE TABLE WS$TASKS
(ID NUMBER(10) PRIMARY KEY,
ID_PROCESS NUMBER(10),
ID_EGE NUMBER(10),
ID_DEFINITION NUMBER(10),
CREATE_RECEIVE_DATE DATE,
SEND_RESPONSE_DATE DATE,
STATUS NUMBER(1),
RESPONSE_TO NUMBER(10),
CONTENT LONG RAW);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMBER(10) PRIMARY KEY,
SIGNATURE LONG RAW);
CREATE TABLE WS$TASK_SNAPSHOTS
(ID NUMBER(10) PRIMARY KEY,
SNAPSHOT LONG RAW);
CREATE TABLE WS$FILES
(ID NUMBER(10),
ID_TASK NUMBER(10),
ID_EGE NUMBER(10),
ATTACH_DATE DATE,
SOURCE NUMBER(1),
FILE_NAME VARCHAR2(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR2(50),
SUBSEQUENCE VARCHAR2(50),
CURRENT_VALUE NUMBER(10));
CREATE TABLE WSI$WORDS
(ID NUMBER(10),
CAPTION VARCHAR2(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMBER(10),
ID_PROCESS NUMBER(10),
ID_TASK NUMBER(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

==Arrancar el Sistema de Tramitación Electrónica==
Para iniciar el Sistema de Tramitación Electrónica debemos iniciar una series de aplicaciones en un cierto orden. Las aplicaciones que debemos iniciar y como, se listan a continuación.
*'''XAMPP'''
Para iniciar el XAMPP, debemos ir a la ruta donde lo tenemos instalado, en este caso ''c:\xampp'' y ejecutar el archivo con nombre ''xampp-control.exe''.
*'''Servidor de Apache'''
Una vez abierto el panel de control del XAMPP, debemos hacer clic en el botón ''start'' para el Apache.
*'''Tomcat'''
Para iniciar el Tomcat, debemos ir a la ruta ''c:\xampp'' y ejecutar el archivo de procesos por lotes (.bat) con nombre ''tomcat_start.bat''.
*'''Servicio web del Sistema de Tramitación Electrónica'''
Para iniciar el servicio web, debemos ir a la ruta donde se instaló, para este ejemplo debemos ir a la carpeta tramitacion con ruta ''C:\STE\tramitacion'' y ejecutar el archivo de procesos por lotes con nombre ''lanzar.bat''.
El archivo ''lanzar.bat'' contiene el comando de consola que hay que ejecutar para iniciar el servicio web, este comando se compone por la ruta y el nombre del archivo ''Tramitacion_server.exe'' y el argumento que se le pasa al ejecutable, el cual es la ruta donde esta el archivo de configuración del servicio web. Para este ejemplo el archivo ''lanzar.bat'' contiene lo siguiente.
"c:\STE\tramitacion\Tramitacion_server.exe" "c:\STE\tramitacion\webservice.ini"
Una vez arrancada todas las aplicaciones, solo nos queda ir al navegador y introducir la URL que definimos en los ficheros de condiguración, para acceder al servicio de tramitación electrónica. En este ejemplo debemos introducir ''http://ste''

=¿Y ahora que?=
Una vez completados todos estos pasos, ya disponemos en nuestra maquina del Sistema de Tramitación Electrónica. A continuación ya podemos pasar a desarrollar en la plataforma egeasy, para hacer que el centro del que disponga haga uso del Sistema de Tramitación Electrónica. Le invito a seguir leyendo el siguiente artículo: [[Desarrollar con el STE]]

[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-07-13T13:13:53Z

Nmelian: /* Creación de tablas en la base de datos */

Personalización avanzada del STE

2009-06-22T11:26:09Z

Nmelian:

__TOC__
=Personalizar el registro de usuarios=
La aplicación web del Sistema de Tramitación Electrónica, dispone de dos tipo de registro de usuarios, libre y cerrado, el cual lo podemos configurar desde el fichero ''webservice.ini'' (Vease [[Cómo integrar el Sistema de Tramitación Electrónica en egeasy]]).

==Tipos de registro de usuarios==

*'''Registro cerrado'''
Para configurar la aplicación web, para un tipo de registro cerrado, donde ningún usuario pueda darse de alta en el servicio, sin que un administrador de su autorización, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Close''.

*'''Registro libre'''
Para configurar la aplicación web, para un tipo de registro libre, donde cualquier usuario pueda darse de alta en el servicio, sin ninguna intervención de un administrador, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Free''.

==El archivo registration.xml==
En la aplicación web del Sistema de Tramitación Electrónica, se puede personalizar el formulario de registro de usuario, para introducir los campos necesarios. Podemos definir distintos tipos de campos en el formulario de registro, los tipos son: ''texto'', ''entero'', ''moneda'' y ''fecha''.

Los campo se construyen en el fichero ''registration.xml'' con la siguiente sintaxis:
*Campo simple
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
</field_value>
*Campo deplegable
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
<allowed_values>
<item>'''VALOR_1'''</item>
.
.
.
<item>'''VALOR_N'''</item>
</allowed_values>
</field_value>

Los valores que están en negrita en la sintaxis simbolizan lo siguiente:
 '''IDENTIFICADOR''': Numero único en el fichero que identifica cada campo.
 '''NOMBRE_CAMPO''': Nombre que queremos darle al campo en el formulario de registro.
 '''TIPO_CAMPO''': Tipo de campo que queremos definir en el formulario. Los posibles valores son ''ftString'', ''ftInteger'', ''ftCurrency'' y ''ftDatetime''.
 '''VALOR''': Valor que queremos que se liste en el campo desplegable.

A continuacion podemos ver un ejemplo de cada tipo de campo que se pueden definir en el fichero ''registration.xml''.

*Ejemplo de campo texto
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>

*Ejemplo de campo entero
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>

*Ejemplo de un campo texto desplegable
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>

*Ejemplo de campo moneda
<field_value Field_Identifier="9" Field_Name="Ingresos" Field_Type="ftCurrency">
</field_value>
*Ejemplo de campo fecha
<field_value Field_Identifier="10" Field_Name="Fecha de nacimiento" Field_Type="ftDatetime">
</field_value>

A continuación vemos un ejemplo de un posible fichero de registro de usuario.
<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>
<field_value Field_Identifier="2" Field_Name="Teléfono 1" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>
<field_value Field_Identifier="4" Field_Name="Dirección" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="5" Field_Name="Código postal" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="6" Field_Name="Localidad" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="7" Field_Name="Provincia" Field_Type="ftString">
</field_value>
</registration_form>

=Personalizar el CSS=
Para personalizar la apariencia de la aplicación web, podemos modificar los archivos CSS que estan en la ruta C:\xampp\tomcat\webapps\ste\WebContent\styles, donde el código CSS esta organizado en distintos archivos para una mejor localización.

=Personalizar el HTML=
Para personalizar el html de la aplicación web, podemos modificar los archivos html que estan en la ruta C:\xampp\tomcat\webapps\ste\templates, donde el código html esta organizado en distintos archivos para una mejor localización.

=Personalizar el texto en la aplicación web=
Para personalizar el texto que aparece en la aplicación web, que es estático y no depende de la programación en ODL de la plataforma egeasy, disponemos en la ruta C:\xampp\tomcat\webapps\ste\languages de cuatro ficheros por idioma. El nombre de los ficheros se construye mediante NOMBREIDIOMA.NOMBREFICHERO.lang. Los archivos que disponemos para el idioma español, son los siguientes
*'''es.errors.lang''': Fichero que contiene el texto referente a los mensajes de error
*'''es.labels.lang''': Fichero que contiene el texto referente al nombre de los botones, link, etc.
*'''es.images.lang''': Fichero que contiene las imagenes que se tienen definidas en la aplicación web.
*'''es.messages.lang''': Fichero que contiene el texto referente a los mensajes de la aplicación web, que son estaticos. No confundir con los mensajes que podemos programar mediante ODL en la plataforma egeasy.



[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-22T11:13:43Z

Nmelian: /* Arrancar el Sistema de Tramitación Electrónica */

__TOC__
=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat

=Pasos a seguir=
Para la instalación de la aplicación web del Sistema de Tramitación Electrónica, vamos a disponer de una instalación de la aplicación XAMPP, que nos proporciona de una forma rápida sencilla las aplicaciones requeridas para una puesta en marcha. Para que las explicaciones de los ficheros de configuración sean lo menos confuso posible, en este articulo vamos a instalar la aplicación XAMPP en ''C:\'', por lo tanto todas las rutas se explicaran de dicha ruta. Ademas de instalar la aplicación XAMPP, tenemos que instalar el servicio web, el cual lo vamos a instalar para mayor comodidad en ''C:\ste''. Así que todas las explicaciones parten de dicha ruta de instalación.

==Configurar el servidor web, Apache==
Para configurar el servidor Apache, debemos modificar el archivo de configuración, que esta en la ruta ''C:\xampp\apache\conf'' con el nombre de ''httpd.conf''. Al final de dicho fichero debemos poner lo siguiente:

ScriptAlias "/URLALIAS" "''PATHWEBSERVICE''"
<Directory "''PATHWEBSERVICE''">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

'''URLALIAS''': Es la URL que vamos a definir donde va a estar nuestro servicio web. Para este ejemplo usaremos ''tramitacion''.
 '''PATHWEBSERVICE''': Es la ruta física donde está desplegado el servicio web. Para este ejemplo, esa ruta es la siguiente: ''C:/STE/tramitacion/''.

Un ejemplo podría ser el siguiente:

ScriptAlias "/tramitacion" "C:/STE/tramitacion"
<Directory "C:/STE/tramitacion/">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

==Configurar el servicio web STE==
Para configurar el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ''webservice.ini'' que esta en la ruta ''C:\STE\tramitacion'', que para este ejemplo será donde esta instalado.

Al abrir el fichero ''webservice.ini'' encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SERVER_ADDRESS''': IP donde se publicará el servicio web.
*'''SERVER_PORT''': Puerto donde se publicará el servicio web.
*'''WS_IDENTIFIER''': Identificador del servicio web.
*'''WS_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''WS_DB_TYPE''': Gestor de base de datos. Posibles valores: SQL Server, Oracle, PostgresSQL, Firebird.
*'''WS_DIRECTORY_DOCUMENTS''': Ruta donde se almacenan los documentos generados por la aplicación.
*'''WS_DIRECTORY_LOGS''': Ruta donde se localizan los logs del servicio web.
*'''WS_FILE_INVALID_WORDS''': Ruta del fichero donde están las palabras que no se van a indexar en la base de datos.
*'''TYPE_REGISTRATION''': Si esta etiqueta está presente, entonces en la aplicacón web los usuarios podrán registrarse libremente. Los valore que admite esta etiqueta es ''Free''.
*'''REGISTRATION_FORM''':Ruta y nombre del archivo xml que se usará para generar el formulario de registro en la aplicación web. Para este ejemplo usaremos el siguiente fichero ''C:\STE\registration.xml''.
*'''EGE_USER_RRC''': Identificador del usuario en la plataforma egeasy, con el que va a acceder la aplicación web a la plataforma. Para un correcto funcionamiento, debemos generar un usuario en la plataforma solo para esta aplicación web.
*'''EGE_CENTER_NAME''':Nombre del centro al que se le va a poner la aplicación web.
*'''EGE_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''EGE_DB_TYPE''': Nombre del tipo de base de datos que se usa para la plataforma egeasy.

*'''EGE_MODEL_DIRECTORY''': Ruta donde se localiza el modelo del centro de la plataforma egeasy.
*'''EGE_DOCUMENT_DIRECTORY''': Ruta donde se localizan la base documental de la plataforma egeasy.
*'''EGE_REGISTRY_DIRECTORY''': Ruta donde se localizan los registro de la plataforma egeasy.

Un ejemplo de un fichero de configuración, podría ser el siguiente:
SERVER_ADDRESS=10.22.144.178
SERVER_PORT=10000
WS_IDENTIFIER=WS_STE
WS_DB_CONNECTION_STRING=usuario@servidorBD@contraseña
WS_DB_TYPE=Oracle
WS_DIRECTORY_DOCUMENTS=C:\STE\Docs
WS_DIRECTORY_LOGS=C:\STE\Logs
WS_FILE_INVALID_WORDS=C:\STE\palabras.dat
TYPE_REGISTRATION=Free
REGISTRATION_FORM=C:\STE\registration.xml
EGE_USER_RRC=3825
EGE_CENTER_NAME=Acecau STE Oracle
EGE_DB_CONNECTION_STRING=usuario@servidorBD@contraseña
EGE_DB_TYPE=Oracle
EGE_MODEL_DIRECTORY=S:\Entornos 2002\Banzai\Modelos\ACECAU STEMod
EGE_DOCUMENT_DIRECTORY=S:\Entornos 2002\Banzai\Documentos\AcecauSTEDoc
EGE_REGISTRY_DIRECTORY=S:\Entornos 2002\Banzai\Registro\acecausteReg

==Configurar la aplicación web STE==

Para configurar la aplicación web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\xampp\tomcat\webapps\ste\WebContent\WEB-INF\classes\org\siani\ste\configuration, que para este ejemplo será donde esta instalado.

Al abrir el fichero ste.conf encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SITE_DIR''': Ruta donde se encuentra instalada la aplicación web.
*'''SITE_URL''': URL donde se encuentra la aplicación web.
*'''LOG_DIR''': Ruta donde se encuentran los logs de la aplicación web.
*'''DATA_DIR''': Ruta donde se encuentra los datos variables de la aplicación web.
*'''TEMPLATES_DIR''': Ruta donde se encuentra las plantillas html de visualización.
*'''TEMP_DIR''': Ruta donde se encuentra los archivos subidos por los usuarios temporalmente.
*'''SITE_DATA_DEFINITIONS_DIR''': Ruta donde se encuentran las definiciones datos personalizados.
*'''SITE_FORMS_DIR''': Ruta donde se encuentra las vistas personalizadas de los trámites.
*'''SITE_PORT''': Puerto que usa la aplicación web.
*'''API_URL''': URL del servlet, llamado API que usa la aplicación web.
*'''SITE_IMAGES_DIR''': Ruta donde se encuentran las imagenes de la aplicación web.
*'''SITE_IMAGES_URL''': URL donde se encuentran las imagenes de la aplicación web.
*'''SITE_JAVASCRIPT_DIR''': Ruta donde se encuentran el javascript de la aplicación web.
*'''SITE_JAVASCRIPT_URL''': URL donde se encuentran el javascript de la aplicación web.
*'''SITE_STYLES_DIR''': Ruta donde se encuentran los estilos CSS de la aplicación web.
*'''SITE_STYLES_URL''': URL donde se encuentran los estilos CSS de la aplicación web.
*'''WS_SOAP_URL''': URL donde se encuentra el servicio web del STE.
*'''LANG_DIR''': Ruta donde se encuentra los archivos de idioma.
*'''EN = en''': Se define el lenguaje Ingles.
*'''ES = es''': Se define el lenguaje Español.
*'''DEFAULT_LANGUAGE''': Indica que lenguaje se va a usar por defecto en la aplicación.

Un ejemplo del fichero de configuración es:

// DIRECTORIES
SITE_DIR = c:/xampp/tomcat/webapps/ste/WebContent
SITE_URL = http://ste
LOG_DIR = C:/xampp/tomcat/webapps/ste/logs
DATA_DIR = C:/xampp/tomcat/webapps/ste/data
TEMPLATES_DIR = C:/xampp/tomcat/webapps/ste/templates
TEMP_DIR = C:/xampp/tomcat/webapps/ste/temp
SITE_PORT = 80
SITE_DATA_DEFINITIONS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions
SITE_FORMS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions/forms
API_URL = http://ste/api
SITE_IMAGES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/images
SITE_IMAGES_URL = http://ste/images
SITE_JAVASCRIPT_DIR = c:/xampp/tomcat/webapps/ste/WebContent/javascript
SITE_JAVASCRIPT_URL = http://ste/javascript
SITE_STYLES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/styles
SITE_STYLES_URL = http://ste/styles
WS_SOAP_URL = http://ste/tramitacion/tramitacion_ws_cgi.exe/soap/IEgeWebService
LANG_DIR = C:/xampp/tomcat/webapps/ste/languages
// LANGUAGES
EN = en
ES = es
DEFAULT_LANGUAGE = es

==Configurar el DNS==
Debemos preparar nuestra maquina, para indicar mediante un nombre de dominio donde esta situado el Sistema de Tramitación Electrónica, para nuestro caso, el sistema esta instalado en local. Por lo tanto solo debemos ir a la ruta de nuestro equipo donde está el fichero ''hosts'', que esta en ''C:\WINDOWS\system32\drivers\etc\'' e introducir lo siguiente:

127.0.0.1 ste

==Creación de tablas en la base de datos==
Para la implantación del Sistema de Tramitación Electrónica, se deben crear unas cuantas tablas y indices en la base de datos. Par este ejemplo vamos a utilizar la misma base de datos y esquema donde tenemos implantada ya la plataforma egeasy. A continuación se listaran los script con las sentencias SQL que hay que ejecutar en la base de datos, para generar todo lo necesario para el Sistema de Tramitación Electrónica. Disponemos de los script tanto para SQL-Server como para Oracle.

*Script para base de datos en SQL-Server
CREATE TABLE WS$USERS
(ID NUMERIC(10) PRIMARY KEY,
NIF VARCHAR(10),
NAME VARCHAR(50),
FULLNAME VARCHAR(50),
EMAIL VARCHAR(50),
FORM IMAGE);
CREATE TABLE WS$PROCESSES
(ID NUMERIC(10) PRIMARY KEY,
LABEL VARCHAR(100),
TRAMITATION_STATUS VARCHAR(100),
ID_PROCEDURE NUMERIC(10),
ID_USER NUMERIC(10),
STATUS NUMERIC(1),
CREATE_DATE DATETIME,
START_DATE DATETIME,
END_DATE DATETIME);
CREATE TABLE WS$TASKS
(ID NUMERIC(10) PRIMARY KEY,
ID_PROCESS NUMERIC(10),
ID_EGE NUMERIC(10),
ID_DEFINITION NUMERIC(10),
CREATE_RECEIVE_DATE DATETIME,
SEND_RESPONSE_DATE DATETIME,
STATUS NUMERIC(1),
CONTENT IMAGE);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMERIC(10) PRIMARY KEY,
SIGNATURE IMAGE);
CREATE TABLE WS$FILES
(ID NUMERIC(10),
ID_TASK NUMERIC(10),
ID_EGE NUMERIC(10),
ATTACH_DATE DATETIME,
SOURCE NUMERIC(1),
FILE_NAME VARCHAR(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR(50),
SUBSEQUENCE VARCHAR(50),
CURRENT_VALUE NUMERIC(10));
CREATE TABLE WSI$WORDS
(ID NUMERIC(10),
CAPTION VARCHAR(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMERIC(10),
ID_PROCESS NUMERIC(10),
ID_TASK NUMERIC(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

*Script para base de datos en Oracle
CREATE TABLE WS$USERS
(ID NUMBER(10) PRIMARY KEY,
NIF VARCHAR2(10),
NAME VARCHAR2(50),
FULLNAME VARCHAR2(50),
EMAIL VARCHAR2(50),
FORM LONG RAW);
CREATE TABLE WS$PROCESSES
(ID NUMBER(10) PRIMARY KEY,
LABEL VARCHAR2(100),
TRAMITATION_STATUS VARCHAR2(100),
ID_PROCEDURE NUMBER(10),
ID_USER NUMBER(10),
STATUS NUMBER(1),
CREATE_DATE DATE,
START_DATE DATE,
END_DATE DATE);
CREATE TABLE WS$TASKS
(ID NUMBER(10) PRIMARY KEY,
ID_PROCESS NUMBER(10),
ID_EGE NUMBER(10),
ID_DEFINITION NUMBER(10),
CREATE_RECEIVE_DATE DATE,
SEND_RESPONSE_DATE DATE,
STATUS NUMBER(1),
CONTENT LONG RAW);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMBER(10) PRIMARY KEY,
SIGNATURE LONG RAW);
CREATE TABLE WS$FILES
(ID NUMBER(10),
ID_TASK NUMBER(10),
ID_EGE NUMBER(10),
ATTACH_DATE DATE,
SOURCE NUMBER(1),
FILE_NAME VARCHAR2(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR2(50),
SUBSEQUENCE VARCHAR2(50),
CURRENT_VALUE NUMBER(10));
CREATE TABLE WSI$WORDS
(ID NUMBER(10),
CAPTION VARCHAR2(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMBER(10),
ID_PROCESS NUMBER(10),
ID_TASK NUMBER(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

==Arrancar el Sistema de Tramitación Electrónica==
Para iniciar el Sistema de Tramitación Electrónica debemos iniciar una series de aplicaciones en un cierto orden. Las aplicaciones que debemos iniciar y como, se listan a continuación.
*'''XAMPP'''
Para iniciar el XAMPP, debemos ir a la ruta donde lo tenemos instalado, en este caso ''c:\xampp'' y ejecutar el archivo con nombre ''xampp-control.exe''.
*'''Servidor de Apache'''
Una vez abierto el panel de control del XAMPP, debemos hacer clic en el botón ''start'' para el Apache.
*'''Tomcat'''
Para iniciar el Tomcat, debemos ir a la ruta ''c:\xampp'' y ejecutar el archivo de procesos por lotes (.bat) con nombre ''tomcat_start.bat''.
*'''Servicio web del Sistema de Tramitación Electrónica'''
Para iniciar el servicio web, debemos ir a la ruta donde se instaló, para este ejemplo debemos ir a la carpeta tramitacion con ruta ''C:\STE\tramitacion'' y ejecutar el archivo de procesos por lotes con nombre ''lanzar.bat''.
El archivo ''lanzar.bat'' contiene el comando de consola que hay que ejecutar para iniciar el servicio web, este comando se compone por la ruta y el nombre del archivo ''Tramitacion_server.exe'' y el argumento que se le pasa al ejecutable, el cual es la ruta donde esta el archivo de configuración del servicio web. Para este ejemplo el archivo ''lanzar.bat'' contiene lo siguiente.
"c:\STE\tramitacion\Tramitacion_server.exe" "c:\STE\tramitacion\webservice.ini"
Una vez arrancada todas las aplicaciones, solo nos queda ir al navegador y introducir la URL que definimos en los ficheros de condiguración, para acceder al servicio de tramitación electrónica. En este ejemplo debemos introducir ''http://ste''

=¿Y ahora que?=
Una vez completados todos estos pasos, ya disponemos en nuestra maquina del Sistema de Tramitación Electrónica. A continuación ya podemos pasar a desarrollar en la plataforma egeasy, para hacer que el centro del que disponga haga uso del Sistema de Tramitación Electrónica. Le invito a seguir leyendo el siguiente artículo: [[Desarrollar con el STE]]

[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-22T11:10:42Z

Nmelian:

__TOC__
=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat

=Pasos a seguir=
Para la instalación de la aplicación web del Sistema de Tramitación Electrónica, vamos a disponer de una instalación de la aplicación XAMPP, que nos proporciona de una forma rápida sencilla las aplicaciones requeridas para una puesta en marcha. Para que las explicaciones de los ficheros de configuración sean lo menos confuso posible, en este articulo vamos a instalar la aplicación XAMPP en ''C:\'', por lo tanto todas las rutas se explicaran de dicha ruta. Ademas de instalar la aplicación XAMPP, tenemos que instalar el servicio web, el cual lo vamos a instalar para mayor comodidad en ''C:\ste''. Así que todas las explicaciones parten de dicha ruta de instalación.

==Configurar el servidor web, Apache==
Para configurar el servidor Apache, debemos modificar el archivo de configuración, que esta en la ruta ''C:\xampp\apache\conf'' con el nombre de ''httpd.conf''. Al final de dicho fichero debemos poner lo siguiente:

ScriptAlias "/URLALIAS" "''PATHWEBSERVICE''"
<Directory "''PATHWEBSERVICE''">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

'''URLALIAS''': Es la URL que vamos a definir donde va a estar nuestro servicio web. Para este ejemplo usaremos ''tramitacion''.
 '''PATHWEBSERVICE''': Es la ruta física donde está desplegado el servicio web. Para este ejemplo, esa ruta es la siguiente: ''C:/STE/tramitacion/''.

Un ejemplo podría ser el siguiente:

ScriptAlias "/tramitacion" "C:/STE/tramitacion"
<Directory "C:/STE/tramitacion/">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

==Configurar el servicio web STE==
Para configurar el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ''webservice.ini'' que esta en la ruta ''C:\STE\tramitacion'', que para este ejemplo será donde esta instalado.

Al abrir el fichero ''webservice.ini'' encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SERVER_ADDRESS''': IP donde se publicará el servicio web.
*'''SERVER_PORT''': Puerto donde se publicará el servicio web.
*'''WS_IDENTIFIER''': Identificador del servicio web.
*'''WS_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''WS_DB_TYPE''': Gestor de base de datos. Posibles valores: SQL Server, Oracle, PostgresSQL, Firebird.
*'''WS_DIRECTORY_DOCUMENTS''': Ruta donde se almacenan los documentos generados por la aplicación.
*'''WS_DIRECTORY_LOGS''': Ruta donde se localizan los logs del servicio web.
*'''WS_FILE_INVALID_WORDS''': Ruta del fichero donde están las palabras que no se van a indexar en la base de datos.
*'''TYPE_REGISTRATION''': Si esta etiqueta está presente, entonces en la aplicacón web los usuarios podrán registrarse libremente. Los valore que admite esta etiqueta es ''Free''.
*'''REGISTRATION_FORM''':Ruta y nombre del archivo xml que se usará para generar el formulario de registro en la aplicación web. Para este ejemplo usaremos el siguiente fichero ''C:\STE\registration.xml''.
*'''EGE_USER_RRC''': Identificador del usuario en la plataforma egeasy, con el que va a acceder la aplicación web a la plataforma. Para un correcto funcionamiento, debemos generar un usuario en la plataforma solo para esta aplicación web.
*'''EGE_CENTER_NAME''':Nombre del centro al que se le va a poner la aplicación web.
*'''EGE_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''EGE_DB_TYPE''': Nombre del tipo de base de datos que se usa para la plataforma egeasy.

*'''EGE_MODEL_DIRECTORY''': Ruta donde se localiza el modelo del centro de la plataforma egeasy.
*'''EGE_DOCUMENT_DIRECTORY''': Ruta donde se localizan la base documental de la plataforma egeasy.
*'''EGE_REGISTRY_DIRECTORY''': Ruta donde se localizan los registro de la plataforma egeasy.

Un ejemplo de un fichero de configuración, podría ser el siguiente:
SERVER_ADDRESS=10.22.144.178
SERVER_PORT=10000
WS_IDENTIFIER=WS_STE
WS_DB_CONNECTION_STRING=usuario@servidorBD@contraseña
WS_DB_TYPE=Oracle
WS_DIRECTORY_DOCUMENTS=C:\STE\Docs
WS_DIRECTORY_LOGS=C:\STE\Logs
WS_FILE_INVALID_WORDS=C:\STE\palabras.dat
TYPE_REGISTRATION=Free
REGISTRATION_FORM=C:\STE\registration.xml
EGE_USER_RRC=3825
EGE_CENTER_NAME=Acecau STE Oracle
EGE_DB_CONNECTION_STRING=usuario@servidorBD@contraseña
EGE_DB_TYPE=Oracle
EGE_MODEL_DIRECTORY=S:\Entornos 2002\Banzai\Modelos\ACECAU STEMod
EGE_DOCUMENT_DIRECTORY=S:\Entornos 2002\Banzai\Documentos\AcecauSTEDoc
EGE_REGISTRY_DIRECTORY=S:\Entornos 2002\Banzai\Registro\acecausteReg

==Configurar la aplicación web STE==

Para configurar la aplicación web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\xampp\tomcat\webapps\ste\WebContent\WEB-INF\classes\org\siani\ste\configuration, que para este ejemplo será donde esta instalado.

Al abrir el fichero ste.conf encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SITE_DIR''': Ruta donde se encuentra instalada la aplicación web.
*'''SITE_URL''': URL donde se encuentra la aplicación web.
*'''LOG_DIR''': Ruta donde se encuentran los logs de la aplicación web.
*'''DATA_DIR''': Ruta donde se encuentra los datos variables de la aplicación web.
*'''TEMPLATES_DIR''': Ruta donde se encuentra las plantillas html de visualización.
*'''TEMP_DIR''': Ruta donde se encuentra los archivos subidos por los usuarios temporalmente.
*'''SITE_DATA_DEFINITIONS_DIR''': Ruta donde se encuentran las definiciones datos personalizados.
*'''SITE_FORMS_DIR''': Ruta donde se encuentra las vistas personalizadas de los trámites.
*'''SITE_PORT''': Puerto que usa la aplicación web.
*'''API_URL''': URL del servlet, llamado API que usa la aplicación web.
*'''SITE_IMAGES_DIR''': Ruta donde se encuentran las imagenes de la aplicación web.
*'''SITE_IMAGES_URL''': URL donde se encuentran las imagenes de la aplicación web.
*'''SITE_JAVASCRIPT_DIR''': Ruta donde se encuentran el javascript de la aplicación web.
*'''SITE_JAVASCRIPT_URL''': URL donde se encuentran el javascript de la aplicación web.
*'''SITE_STYLES_DIR''': Ruta donde se encuentran los estilos CSS de la aplicación web.
*'''SITE_STYLES_URL''': URL donde se encuentran los estilos CSS de la aplicación web.
*'''WS_SOAP_URL''': URL donde se encuentra el servicio web del STE.
*'''LANG_DIR''': Ruta donde se encuentra los archivos de idioma.
*'''EN = en''': Se define el lenguaje Ingles.
*'''ES = es''': Se define el lenguaje Español.
*'''DEFAULT_LANGUAGE''': Indica que lenguaje se va a usar por defecto en la aplicación.

Un ejemplo del fichero de configuración es:

// DIRECTORIES
SITE_DIR = c:/xampp/tomcat/webapps/ste/WebContent
SITE_URL = http://ste
LOG_DIR = C:/xampp/tomcat/webapps/ste/logs
DATA_DIR = C:/xampp/tomcat/webapps/ste/data
TEMPLATES_DIR = C:/xampp/tomcat/webapps/ste/templates
TEMP_DIR = C:/xampp/tomcat/webapps/ste/temp
SITE_PORT = 80
SITE_DATA_DEFINITIONS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions
SITE_FORMS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions/forms
API_URL = http://ste/api
SITE_IMAGES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/images
SITE_IMAGES_URL = http://ste/images
SITE_JAVASCRIPT_DIR = c:/xampp/tomcat/webapps/ste/WebContent/javascript
SITE_JAVASCRIPT_URL = http://ste/javascript
SITE_STYLES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/styles
SITE_STYLES_URL = http://ste/styles
WS_SOAP_URL = http://ste/tramitacion/tramitacion_ws_cgi.exe/soap/IEgeWebService
LANG_DIR = C:/xampp/tomcat/webapps/ste/languages
// LANGUAGES
EN = en
ES = es
DEFAULT_LANGUAGE = es

==Configurar el DNS==
Debemos preparar nuestra maquina, para indicar mediante un nombre de dominio donde esta situado el Sistema de Tramitación Electrónica, para nuestro caso, el sistema esta instalado en local. Por lo tanto solo debemos ir a la ruta de nuestro equipo donde está el fichero ''hosts'', que esta en ''C:\WINDOWS\system32\drivers\etc\'' e introducir lo siguiente:

127.0.0.1 ste

==Creación de tablas en la base de datos==
Para la implantación del Sistema de Tramitación Electrónica, se deben crear unas cuantas tablas y indices en la base de datos. Par este ejemplo vamos a utilizar la misma base de datos y esquema donde tenemos implantada ya la plataforma egeasy. A continuación se listaran los script con las sentencias SQL que hay que ejecutar en la base de datos, para generar todo lo necesario para el Sistema de Tramitación Electrónica. Disponemos de los script tanto para SQL-Server como para Oracle.

*Script para base de datos en SQL-Server
CREATE TABLE WS$USERS
(ID NUMERIC(10) PRIMARY KEY,
NIF VARCHAR(10),
NAME VARCHAR(50),
FULLNAME VARCHAR(50),
EMAIL VARCHAR(50),
FORM IMAGE);
CREATE TABLE WS$PROCESSES
(ID NUMERIC(10) PRIMARY KEY,
LABEL VARCHAR(100),
TRAMITATION_STATUS VARCHAR(100),
ID_PROCEDURE NUMERIC(10),
ID_USER NUMERIC(10),
STATUS NUMERIC(1),
CREATE_DATE DATETIME,
START_DATE DATETIME,
END_DATE DATETIME);
CREATE TABLE WS$TASKS
(ID NUMERIC(10) PRIMARY KEY,
ID_PROCESS NUMERIC(10),
ID_EGE NUMERIC(10),
ID_DEFINITION NUMERIC(10),
CREATE_RECEIVE_DATE DATETIME,
SEND_RESPONSE_DATE DATETIME,
STATUS NUMERIC(1),
CONTENT IMAGE);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMERIC(10) PRIMARY KEY,
SIGNATURE IMAGE);
CREATE TABLE WS$FILES
(ID NUMERIC(10),
ID_TASK NUMERIC(10),
ID_EGE NUMERIC(10),
ATTACH_DATE DATETIME,
SOURCE NUMERIC(1),
FILE_NAME VARCHAR(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR(50),
SUBSEQUENCE VARCHAR(50),
CURRENT_VALUE NUMERIC(10));
CREATE TABLE WSI$WORDS
(ID NUMERIC(10),
CAPTION VARCHAR(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMERIC(10),
ID_PROCESS NUMERIC(10),
ID_TASK NUMERIC(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

*Script para base de datos en Oracle
CREATE TABLE WS$USERS
(ID NUMBER(10) PRIMARY KEY,
NIF VARCHAR2(10),
NAME VARCHAR2(50),
FULLNAME VARCHAR2(50),
EMAIL VARCHAR2(50),
FORM LONG RAW);
CREATE TABLE WS$PROCESSES
(ID NUMBER(10) PRIMARY KEY,
LABEL VARCHAR2(100),
TRAMITATION_STATUS VARCHAR2(100),
ID_PROCEDURE NUMBER(10),
ID_USER NUMBER(10),
STATUS NUMBER(1),
CREATE_DATE DATE,
START_DATE DATE,
END_DATE DATE);
CREATE TABLE WS$TASKS
(ID NUMBER(10) PRIMARY KEY,
ID_PROCESS NUMBER(10),
ID_EGE NUMBER(10),
ID_DEFINITION NUMBER(10),
CREATE_RECEIVE_DATE DATE,
SEND_RESPONSE_DATE DATE,
STATUS NUMBER(1),
CONTENT LONG RAW);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMBER(10) PRIMARY KEY,
SIGNATURE LONG RAW);
CREATE TABLE WS$FILES
(ID NUMBER(10),
ID_TASK NUMBER(10),
ID_EGE NUMBER(10),
ATTACH_DATE DATE,
SOURCE NUMBER(1),
FILE_NAME VARCHAR2(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR2(50),
SUBSEQUENCE VARCHAR2(50),
CURRENT_VALUE NUMBER(10));
CREATE TABLE WSI$WORDS
(ID NUMBER(10),
CAPTION VARCHAR2(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMBER(10),
ID_PROCESS NUMBER(10),
ID_TASK NUMBER(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

==Arrancar el Sistema de Tramitación Electrónica==
Para iniciar el Sistema de Tramitación Electrónica debemos iniciar una series de aplicaciones en un cierto orden. Las aplicaciones que debemos iniciar y como, se listan a continuación.
*'''XAMPP'''
Para iniciar el XAMPP, debemos ir a la ruta donde lo tenemos instalado, en este caso ''c:\xampp'' y ejecutar el archivo con nombre ''xampp-control.exe''.
*'''Servidor de Apache'''
Una vez abierto el panel de control del XAMPP, debemos hacer clic en el botón ''start'' para el Apache.
*'''Tomcat'''
Para iniciar el Tomcat, debemos ir a la ruta ''c:\xampp'' y ejecutar el archivo de procesos por lotes (.bat) con nombre ''tomcat_start.bat''.
*'''Servicio web del Sistema de Tramitación Electrónica'''
Para iniciar el servicio web, debemos ir a la ruta donde se instaló, para este ejemplo debemos ir a la carpeta tramitacion con ruta ''C:\STE\tramitacion'' y ejecutar el archivo de procesos por lotes con nombre ''lanzar.bat''.
El archivo ''lanzar.bat'' contiene el comando de consola que hay que ejecutar para iniciar el servicio web, este comando se compone por la ruta y el nombre del archivo ''Tramitacion_server.exe'' y el argumento que se le pasa al ejecutable, el cual es la ruta donde esta el archivo de configuración del servicio web. Para este ejemplo el archivo ''lanzar.bat'' contiene lo siguiente.
"c:\STE\tramitacion\Tramitacion_server.exe" "c:\STE\tramitacion\webservice.ini"

=¿Y ahora que?=
Una vez completados todos estos pasos, ya disponemos en nuestra maquina del Sistema de Tramitación Electrónica. A continuación ya podemos pasar a desarrollar en la plataforma egeasy, para hacer que el centro del que disponga haga uso del Sistema de Tramitación Electrónica. Le invito a seguir leyendo el siguiente artículo: [[Desarrollar con el STE]]

[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-22T11:09:35Z

Nmelian: /* Configurar el servicio web STE */

__TOC__
=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat

=Pasos a seguir=
Para la instalación de la aplicación web del Sistema de Tramitación Electrónica, vamos a disponer de una instalación de la aplicación XAMPP, que nos proporciona de una forma rápida sencilla las aplicaciones requeridas para una puesta en marcha. Para que las explicaciones de los ficheros de configuración sean lo menos confuso posible, en este articulo vamos a instalar la aplicación XAMPP en ''C:\'', por lo tanto todas las rutas se explicaran de dicha ruta. Ademas de instalar la aplicación XAMPP, tenemos que instalar el servicio web, el cual lo vamos a instalar para mayor comodidad en ''C:\ste''. Así que todas las explicaciones parten de dicha ruta de instalación.

==Configurar el servidor web, Apache==
Para configurar el servidor Apache, debemos modificar el archivo de configuración, que esta en la ruta ''C:\xampp\apache\conf'' con el nombre de ''httpd.conf''. Al final de dicho fichero debemos poner lo siguiente:

ScriptAlias "/URLALIAS" "''PATHWEBSERVICE''"
<Directory "''PATHWEBSERVICE''">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

'''URLALIAS''': Es la URL que vamos a definir donde va a estar nuestro servicio web. Para este ejemplo usaremos ''tramitacion''.
 '''PATHWEBSERVICE''': Es la ruta física donde está desplegado el servicio web. Para este ejemplo, esa ruta es la siguiente: ''C:/STE/tramitacion/''.

Un ejemplo podría ser el siguiente:

ScriptAlias "/tramitacion" "C:/STE/tramitacion"
<Directory "C:/STE/tramitacion/">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

==Configurar el servicio web STE==
Para configurar el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ''webservice.ini'' que esta en la ruta ''C:\STE\tramitacion'', que para este ejemplo será donde esta instalado.

Al abrir el fichero ''webservice.ini'' encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SERVER_ADDRESS''': IP donde se publicará el servicio web.
*'''SERVER_PORT''': Puerto donde se publicará el servicio web.
*'''WS_IDENTIFIER''': Identificador del servicio web.
*'''WS_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''WS_DB_TYPE''': Gestor de base de datos. Posibles valores: SQL Server, Oracle, PostgresSQL, Firebird.
*'''WS_DIRECTORY_DOCUMENTS''': Ruta donde se almacenan los documentos generados por la aplicación.
*'''WS_DIRECTORY_LOGS''': Ruta donde se localizan los logs del servicio web.
*'''WS_FILE_INVALID_WORDS''': Ruta del fichero donde están las palabras que no se van a indexar en la base de datos.
*'''TYPE_REGISTRATION''': Si esta etiqueta está presente, entonces en la aplicacón web los usuarios podrán registrarse libremente. Los valore que admite esta etiqueta es ''Free''.
*'''REGISTRATION_FORM''':Ruta y nombre del archivo xml que se usará para generar el formulario de registro en la aplicación web. Para este ejemplo usaremos el siguiente fichero ''C:\STE\registration.xml''.
*'''EGE_USER_RRC''': Identificador del usuario en la plataforma egeasy, con el que va a acceder la aplicación web a la plataforma. Para un correcto funcionamiento, debemos generar un usuario en la plataforma solo para esta aplicación web.
*'''EGE_CENTER_NAME''':Nombre del centro al que se le va a poner la aplicación web.
*'''EGE_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''EGE_DB_TYPE''': Nombre del tipo de base de datos que se usa para la plataforma egeasy.

*'''EGE_MODEL_DIRECTORY''': Ruta donde se localiza el modelo del centro de la plataforma egeasy.
*'''EGE_DOCUMENT_DIRECTORY''': Ruta donde se localizan la base documental de la plataforma egeasy.
*'''EGE_REGISTRY_DIRECTORY''': Ruta donde se localizan los registro de la plataforma egeasy.

Un ejemplo de un fichero de configuración, podría ser el siguiente:
SERVER_ADDRESS=10.22.144.178
SERVER_PORT=10000
WS_IDENTIFIER=WS_STE
WS_DB_CONNECTION_STRING=usuario@servidorBD@contraseña
WS_DB_TYPE=Oracle
WS_DIRECTORY_DOCUMENTS=C:\STE\Docs
WS_DIRECTORY_LOGS=C:\STE\Logs
WS_FILE_INVALID_WORDS=C:\STE\palabras.dat
TYPE_REGISTRATION=Free
REGISTRATION_FORM=C:\STE\registration.xml
EGE_USER_RRC=3825
EGE_CENTER_NAME=Acecau STE Oracle
EGE_DB_CONNECTION_STRING=acecau@europa@acecau
EGE_DB_TYPE=Oracle
EGE_MODEL_DIRECTORY=S:\Entornos 2002\Banzai\Modelos\ACECAU STEMod
EGE_DOCUMENT_DIRECTORY=S:\Entornos 2002\Banzai\Documentos\AcecauSTEDoc
EGE_REGISTRY_DIRECTORY=S:\Entornos 2002\Banzai\Registro\acecausteReg

==Configurar la aplicación web STE==

Para configurar la aplicación web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\xampp\tomcat\webapps\ste\WebContent\WEB-INF\classes\org\siani\ste\configuration, que para este ejemplo será donde esta instalado.

Al abrir el fichero ste.conf encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SITE_DIR''': Ruta donde se encuentra instalada la aplicación web.
*'''SITE_URL''': URL donde se encuentra la aplicación web.
*'''LOG_DIR''': Ruta donde se encuentran los logs de la aplicación web.
*'''DATA_DIR''': Ruta donde se encuentra los datos variables de la aplicación web.
*'''TEMPLATES_DIR''': Ruta donde se encuentra las plantillas html de visualización.
*'''TEMP_DIR''': Ruta donde se encuentra los archivos subidos por los usuarios temporalmente.
*'''SITE_DATA_DEFINITIONS_DIR''': Ruta donde se encuentran las definiciones datos personalizados.
*'''SITE_FORMS_DIR''': Ruta donde se encuentra las vistas personalizadas de los trámites.
*'''SITE_PORT''': Puerto que usa la aplicación web.
*'''API_URL''': URL del servlet, llamado API que usa la aplicación web.
*'''SITE_IMAGES_DIR''': Ruta donde se encuentran las imagenes de la aplicación web.
*'''SITE_IMAGES_URL''': URL donde se encuentran las imagenes de la aplicación web.
*'''SITE_JAVASCRIPT_DIR''': Ruta donde se encuentran el javascript de la aplicación web.
*'''SITE_JAVASCRIPT_URL''': URL donde se encuentran el javascript de la aplicación web.
*'''SITE_STYLES_DIR''': Ruta donde se encuentran los estilos CSS de la aplicación web.
*'''SITE_STYLES_URL''': URL donde se encuentran los estilos CSS de la aplicación web.
*'''WS_SOAP_URL''': URL donde se encuentra el servicio web del STE.
*'''LANG_DIR''': Ruta donde se encuentra los archivos de idioma.
*'''EN = en''': Se define el lenguaje Ingles.
*'''ES = es''': Se define el lenguaje Español.
*'''DEFAULT_LANGUAGE''': Indica que lenguaje se va a usar por defecto en la aplicación.

Un ejemplo del fichero de configuración es:

// DIRECTORIES
SITE_DIR = c:/xampp/tomcat/webapps/ste/WebContent
SITE_URL = http://ste
LOG_DIR = C:/xampp/tomcat/webapps/ste/logs
DATA_DIR = C:/xampp/tomcat/webapps/ste/data
TEMPLATES_DIR = C:/xampp/tomcat/webapps/ste/templates
TEMP_DIR = C:/xampp/tomcat/webapps/ste/temp
SITE_PORT = 80
SITE_DATA_DEFINITIONS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions
SITE_FORMS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions/forms
API_URL = http://ste/api
SITE_IMAGES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/images
SITE_IMAGES_URL = http://ste/images
SITE_JAVASCRIPT_DIR = c:/xampp/tomcat/webapps/ste/WebContent/javascript
SITE_JAVASCRIPT_URL = http://ste/javascript
SITE_STYLES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/styles
SITE_STYLES_URL = http://ste/styles
WS_SOAP_URL = http://ste/tramitacion/tramitacion_ws_cgi.exe/soap/IEgeWebService
LANG_DIR = C:/xampp/tomcat/webapps/ste/languages
// LANGUAGES
EN = en
ES = es
DEFAULT_LANGUAGE = es

==Configurar el DNS==
Debemos preparar nuestra maquina, para indicar mediante un nombre de dominio donde esta situado el Sistema de Tramitación Electrónica, para nuestro caso, el sistema esta instalado en local. Por lo tanto solo debemos ir a la ruta de nuestro equipo donde está el fichero ''hosts'', que esta en ''C:\WINDOWS\system32\drivers\etc\'' e introducir lo siguiente:

127.0.0.1 ste

==Creación de tablas en la base de datos==
Para la implantación del Sistema de Tramitación Electrónica, se deben crear unas cuantas tablas y indices en la base de datos. Par este ejemplo vamos a utilizar la misma base de datos y esquema donde tenemos implantada ya la plataforma egeasy. A continuación se listaran los script con las sentencias SQL que hay que ejecutar en la base de datos, para generar todo lo necesario para el Sistema de Tramitación Electrónica. Disponemos de los script tanto para SQL-Server como para Oracle.

*Script para base de datos en SQL-Server
CREATE TABLE WS$USERS
(ID NUMERIC(10) PRIMARY KEY,
NIF VARCHAR(10),
NAME VARCHAR(50),
FULLNAME VARCHAR(50),
EMAIL VARCHAR(50),
FORM IMAGE);
CREATE TABLE WS$PROCESSES
(ID NUMERIC(10) PRIMARY KEY,
LABEL VARCHAR(100),
TRAMITATION_STATUS VARCHAR(100),
ID_PROCEDURE NUMERIC(10),
ID_USER NUMERIC(10),
STATUS NUMERIC(1),
CREATE_DATE DATETIME,
START_DATE DATETIME,
END_DATE DATETIME);
CREATE TABLE WS$TASKS
(ID NUMERIC(10) PRIMARY KEY,
ID_PROCESS NUMERIC(10),
ID_EGE NUMERIC(10),
ID_DEFINITION NUMERIC(10),
CREATE_RECEIVE_DATE DATETIME,
SEND_RESPONSE_DATE DATETIME,
STATUS NUMERIC(1),
CONTENT IMAGE);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMERIC(10) PRIMARY KEY,
SIGNATURE IMAGE);
CREATE TABLE WS$FILES
(ID NUMERIC(10),
ID_TASK NUMERIC(10),
ID_EGE NUMERIC(10),
ATTACH_DATE DATETIME,
SOURCE NUMERIC(1),
FILE_NAME VARCHAR(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR(50),
SUBSEQUENCE VARCHAR(50),
CURRENT_VALUE NUMERIC(10));
CREATE TABLE WSI$WORDS
(ID NUMERIC(10),
CAPTION VARCHAR(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMERIC(10),
ID_PROCESS NUMERIC(10),
ID_TASK NUMERIC(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

*Script para base de datos en Oracle
CREATE TABLE WS$USERS
(ID NUMBER(10) PRIMARY KEY,
NIF VARCHAR2(10),
NAME VARCHAR2(50),
FULLNAME VARCHAR2(50),
EMAIL VARCHAR2(50),
FORM LONG RAW);
CREATE TABLE WS$PROCESSES
(ID NUMBER(10) PRIMARY KEY,
LABEL VARCHAR2(100),
TRAMITATION_STATUS VARCHAR2(100),
ID_PROCEDURE NUMBER(10),
ID_USER NUMBER(10),
STATUS NUMBER(1),
CREATE_DATE DATE,
START_DATE DATE,
END_DATE DATE);
CREATE TABLE WS$TASKS
(ID NUMBER(10) PRIMARY KEY,
ID_PROCESS NUMBER(10),
ID_EGE NUMBER(10),
ID_DEFINITION NUMBER(10),
CREATE_RECEIVE_DATE DATE,
SEND_RESPONSE_DATE DATE,
STATUS NUMBER(1),
CONTENT LONG RAW);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMBER(10) PRIMARY KEY,
SIGNATURE LONG RAW);
CREATE TABLE WS$FILES
(ID NUMBER(10),
ID_TASK NUMBER(10),
ID_EGE NUMBER(10),
ATTACH_DATE DATE,
SOURCE NUMBER(1),
FILE_NAME VARCHAR2(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR2(50),
SUBSEQUENCE VARCHAR2(50),
CURRENT_VALUE NUMBER(10));
CREATE TABLE WSI$WORDS
(ID NUMBER(10),
CAPTION VARCHAR2(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMBER(10),
ID_PROCESS NUMBER(10),
ID_TASK NUMBER(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

==Arrancar el Sistema de Tramitación Electrónica==
Para iniciar el Sistema de Tramitación Electrónica debemos iniciar una series de aplicaciones en un cierto orden. Las aplicaciones que debemos iniciar y como, se listan a continuación.
*'''XAMPP'''
Para iniciar el XAMPP, debemos ir a la ruta donde lo tenemos instalado, en este caso ''c:\xampp'' y ejecutar el archivo con nombre ''xampp-control.exe''.
*'''Servidor de Apache'''
Una vez abierto el panel de control del XAMPP, debemos hacer clic en el botón ''start'' para el Apache.
*'''Tomcat'''
Para iniciar el Tomcat, debemos ir a la ruta ''c:\xampp'' y ejecutar el archivo de procesos por lotes (.bat) con nombre ''tomcat_start.bat''.
*'''Servicio web del Sistema de Tramitación Electrónica'''
Para iniciar el servicio web, debemos ir a la ruta donde se instaló, para este ejemplo debemos ir a la carpeta tramitacion con ruta ''C:\STE\tramitacion'' y ejecutar el archivo de procesos por lotes con nombre ''lanzar.bat''.
El archivo ''lanzar.bat'' contiene el comando de consola que hay que ejecutar para iniciar el servicio web, este comando se compone por la ruta y el nombre del archivo ''Tramitacion_server.exe'' y el argumento que se le pasa al ejecutable, el cual es la ruta donde esta el archivo de configuración del servicio web. Para este ejemplo el archivo ''lanzar.bat'' contiene lo siguiente.
"c:\STE\tramitacion\Tramitacion_server.exe" "c:\STE\tramitacion\webservice.ini"

=¿Y ahora que?=
Una vez completados todos estos pasos, ya disponemos en nuestra maquina del Sistema de Tramitación Electrónica. A continuación ya podemos pasar a desarrollar en la plataforma egeasy, para hacer que el centro del que disponga haga uso del Sistema de Tramitación Electrónica. Le invito a seguir leyendo el siguiente artículo: [[Desarrollar con el STE]]

[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-22T11:08:33Z

Nmelian: /* Configurar el servicio web STE */

__TOC__
=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat

=Pasos a seguir=
Para la instalación de la aplicación web del Sistema de Tramitación Electrónica, vamos a disponer de una instalación de la aplicación XAMPP, que nos proporciona de una forma rápida sencilla las aplicaciones requeridas para una puesta en marcha. Para que las explicaciones de los ficheros de configuración sean lo menos confuso posible, en este articulo vamos a instalar la aplicación XAMPP en ''C:\'', por lo tanto todas las rutas se explicaran de dicha ruta. Ademas de instalar la aplicación XAMPP, tenemos que instalar el servicio web, el cual lo vamos a instalar para mayor comodidad en ''C:\ste''. Así que todas las explicaciones parten de dicha ruta de instalación.

==Configurar el servidor web, Apache==
Para configurar el servidor Apache, debemos modificar el archivo de configuración, que esta en la ruta ''C:\xampp\apache\conf'' con el nombre de ''httpd.conf''. Al final de dicho fichero debemos poner lo siguiente:

ScriptAlias "/URLALIAS" "''PATHWEBSERVICE''"
<Directory "''PATHWEBSERVICE''">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

'''URLALIAS''': Es la URL que vamos a definir donde va a estar nuestro servicio web. Para este ejemplo usaremos ''tramitacion''.
 '''PATHWEBSERVICE''': Es la ruta física donde está desplegado el servicio web. Para este ejemplo, esa ruta es la siguiente: ''C:/STE/tramitacion/''.

Un ejemplo podría ser el siguiente:

ScriptAlias "/tramitacion" "C:/STE/tramitacion"
<Directory "C:/STE/tramitacion/">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

==Configurar el servicio web STE==
Para configurar el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ''webservice.ini'' que esta en la ruta ''C:\STE\tramitacion'', que para este ejemplo será donde esta instalado.

Al abrir el fichero ''webservice.ini'' encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SERVER_ADDRESS''': IP donde se publicará el servicio web.
*'''SERVER_PORT''': Puerto donde se publicará el servicio web.
*'''WS_IDENTIFIER''': Identificador del servicio web.
*'''WS_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''WS_DB_TYPE''': Gestor de base de datos. Posibles valores: SQL Server, Oracle, PostgresSQL, Firebird.
*'''WS_DIRECTORY_DOCUMENTS''': Ruta donde se almacenan los documentos generados por la aplicación.
*'''WS_DIRECTORY_LOGS''': Ruta donde se localizan los logs del servicio web.
*'''WS_FILE_INVALID_WORDS''': Ruta del fichero donde están las palabras que no se van a indexar en la base de datos.
*'''TYPE_REGISTRATION''': Si esta etiqueta está presente, entonces en la aplicacón web los usuarios podrán registrarse libremente. Los valore que admite esta etiqueta es ''Free''.
*'''REGISTRATION_FORM''':Ruta y nombre del archivo xml que se usará para generar el formulario de registro en la aplicación web. Para este ejemplo usaremos el siguiente fichero ''C:\STE\registration.xml''.
*'''EGE_USER_RRC''': Identificador del usuario en la plataforma egeasy, con el que va a acceder la aplicación web a la plataforma. Para un correcto funcionamiento, debemos generar un usuario en la plataforma solo para esta aplicación web.
*'''EGE_CENTER_NAME''':Nombre del centro al que se le va a poner la aplicación web.
*'''EGE_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''EGE_DB_TYPE''': Nombre del tipo de base de datos que se usa para la plataforma egeasy.

*'''EGE_MODEL_DIRECTORY''': Ruta donde se localiza el modelo del centro de la plataforma egeasy.
*'''EGE_DOCUMENT_DIRECTORY''': Ruta donde se localizan la base documental de la plataforma egeasy.
*'''EGE_REGISTRY_DIRECTORY''': Ruta donde se localizan los registro de la plataforma egeasy.

Un ejemplo de un fichero de configuración, podría ser el siguiente:
SERVER_ADDRESS=10.22.144.178
SERVER_PORT=10000
WS_IDENTIFIER=WS_STE
WS_DB_CONNECTION_STRING=acecau@europa@acecau
WS_DB_TYPE=Oracle
WS_DIRECTORY_DOCUMENTS=C:\STE\Docs
WS_DIRECTORY_LOGS=C:\STE\Logs
WS_FILE_INVALID_WORDS=C:\STE\palabras.dat
TYPE_REGISTRATION=Free
REGISTRATION_FORM=C:\STE\registration.xml
EGE_USER_RRC=3825
EGE_CENTER_NAME=Acecau STE Oracle
EGE_DB_CONNECTION_STRING=acecau@europa@acecau
EGE_DB_TYPE=Oracle
EGE_MODEL_DIRECTORY=S:\Entornos 2002\Banzai\Modelos\ACECAU STEMod
EGE_DOCUMENT_DIRECTORY=S:\Entornos 2002\Banzai\Documentos\AcecauSTEDoc
EGE_REGISTRY_DIRECTORY=S:\Entornos 2002\Banzai\Registro\acecausteReg

==Configurar la aplicación web STE==

Para configurar la aplicación web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\xampp\tomcat\webapps\ste\WebContent\WEB-INF\classes\org\siani\ste\configuration, que para este ejemplo será donde esta instalado.

Al abrir el fichero ste.conf encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SITE_DIR''': Ruta donde se encuentra instalada la aplicación web.
*'''SITE_URL''': URL donde se encuentra la aplicación web.
*'''LOG_DIR''': Ruta donde se encuentran los logs de la aplicación web.
*'''DATA_DIR''': Ruta donde se encuentra los datos variables de la aplicación web.
*'''TEMPLATES_DIR''': Ruta donde se encuentra las plantillas html de visualización.
*'''TEMP_DIR''': Ruta donde se encuentra los archivos subidos por los usuarios temporalmente.
*'''SITE_DATA_DEFINITIONS_DIR''': Ruta donde se encuentran las definiciones datos personalizados.
*'''SITE_FORMS_DIR''': Ruta donde se encuentra las vistas personalizadas de los trámites.
*'''SITE_PORT''': Puerto que usa la aplicación web.
*'''API_URL''': URL del servlet, llamado API que usa la aplicación web.
*'''SITE_IMAGES_DIR''': Ruta donde se encuentran las imagenes de la aplicación web.
*'''SITE_IMAGES_URL''': URL donde se encuentran las imagenes de la aplicación web.
*'''SITE_JAVASCRIPT_DIR''': Ruta donde se encuentran el javascript de la aplicación web.
*'''SITE_JAVASCRIPT_URL''': URL donde se encuentran el javascript de la aplicación web.
*'''SITE_STYLES_DIR''': Ruta donde se encuentran los estilos CSS de la aplicación web.
*'''SITE_STYLES_URL''': URL donde se encuentran los estilos CSS de la aplicación web.
*'''WS_SOAP_URL''': URL donde se encuentra el servicio web del STE.
*'''LANG_DIR''': Ruta donde se encuentra los archivos de idioma.
*'''EN = en''': Se define el lenguaje Ingles.
*'''ES = es''': Se define el lenguaje Español.
*'''DEFAULT_LANGUAGE''': Indica que lenguaje se va a usar por defecto en la aplicación.

Un ejemplo del fichero de configuración es:

// DIRECTORIES
SITE_DIR = c:/xampp/tomcat/webapps/ste/WebContent
SITE_URL = http://ste
LOG_DIR = C:/xampp/tomcat/webapps/ste/logs
DATA_DIR = C:/xampp/tomcat/webapps/ste/data
TEMPLATES_DIR = C:/xampp/tomcat/webapps/ste/templates
TEMP_DIR = C:/xampp/tomcat/webapps/ste/temp
SITE_PORT = 80
SITE_DATA_DEFINITIONS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions
SITE_FORMS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions/forms
API_URL = http://ste/api
SITE_IMAGES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/images
SITE_IMAGES_URL = http://ste/images
SITE_JAVASCRIPT_DIR = c:/xampp/tomcat/webapps/ste/WebContent/javascript
SITE_JAVASCRIPT_URL = http://ste/javascript
SITE_STYLES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/styles
SITE_STYLES_URL = http://ste/styles
WS_SOAP_URL = http://ste/tramitacion/tramitacion_ws_cgi.exe/soap/IEgeWebService
LANG_DIR = C:/xampp/tomcat/webapps/ste/languages
// LANGUAGES
EN = en
ES = es
DEFAULT_LANGUAGE = es

==Configurar el DNS==
Debemos preparar nuestra maquina, para indicar mediante un nombre de dominio donde esta situado el Sistema de Tramitación Electrónica, para nuestro caso, el sistema esta instalado en local. Por lo tanto solo debemos ir a la ruta de nuestro equipo donde está el fichero ''hosts'', que esta en ''C:\WINDOWS\system32\drivers\etc\'' e introducir lo siguiente:

127.0.0.1 ste

==Creación de tablas en la base de datos==
Para la implantación del Sistema de Tramitación Electrónica, se deben crear unas cuantas tablas y indices en la base de datos. Par este ejemplo vamos a utilizar la misma base de datos y esquema donde tenemos implantada ya la plataforma egeasy. A continuación se listaran los script con las sentencias SQL que hay que ejecutar en la base de datos, para generar todo lo necesario para el Sistema de Tramitación Electrónica. Disponemos de los script tanto para SQL-Server como para Oracle.

*Script para base de datos en SQL-Server
CREATE TABLE WS$USERS
(ID NUMERIC(10) PRIMARY KEY,
NIF VARCHAR(10),
NAME VARCHAR(50),
FULLNAME VARCHAR(50),
EMAIL VARCHAR(50),
FORM IMAGE);
CREATE TABLE WS$PROCESSES
(ID NUMERIC(10) PRIMARY KEY,
LABEL VARCHAR(100),
TRAMITATION_STATUS VARCHAR(100),
ID_PROCEDURE NUMERIC(10),
ID_USER NUMERIC(10),
STATUS NUMERIC(1),
CREATE_DATE DATETIME,
START_DATE DATETIME,
END_DATE DATETIME);
CREATE TABLE WS$TASKS
(ID NUMERIC(10) PRIMARY KEY,
ID_PROCESS NUMERIC(10),
ID_EGE NUMERIC(10),
ID_DEFINITION NUMERIC(10),
CREATE_RECEIVE_DATE DATETIME,
SEND_RESPONSE_DATE DATETIME,
STATUS NUMERIC(1),
CONTENT IMAGE);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMERIC(10) PRIMARY KEY,
SIGNATURE IMAGE);
CREATE TABLE WS$FILES
(ID NUMERIC(10),
ID_TASK NUMERIC(10),
ID_EGE NUMERIC(10),
ATTACH_DATE DATETIME,
SOURCE NUMERIC(1),
FILE_NAME VARCHAR(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR(50),
SUBSEQUENCE VARCHAR(50),
CURRENT_VALUE NUMERIC(10));
CREATE TABLE WSI$WORDS
(ID NUMERIC(10),
CAPTION VARCHAR(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMERIC(10),
ID_PROCESS NUMERIC(10),
ID_TASK NUMERIC(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

*Script para base de datos en Oracle
CREATE TABLE WS$USERS
(ID NUMBER(10) PRIMARY KEY,
NIF VARCHAR2(10),
NAME VARCHAR2(50),
FULLNAME VARCHAR2(50),
EMAIL VARCHAR2(50),
FORM LONG RAW);
CREATE TABLE WS$PROCESSES
(ID NUMBER(10) PRIMARY KEY,
LABEL VARCHAR2(100),
TRAMITATION_STATUS VARCHAR2(100),
ID_PROCEDURE NUMBER(10),
ID_USER NUMBER(10),
STATUS NUMBER(1),
CREATE_DATE DATE,
START_DATE DATE,
END_DATE DATE);
CREATE TABLE WS$TASKS
(ID NUMBER(10) PRIMARY KEY,
ID_PROCESS NUMBER(10),
ID_EGE NUMBER(10),
ID_DEFINITION NUMBER(10),
CREATE_RECEIVE_DATE DATE,
SEND_RESPONSE_DATE DATE,
STATUS NUMBER(1),
CONTENT LONG RAW);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMBER(10) PRIMARY KEY,
SIGNATURE LONG RAW);
CREATE TABLE WS$FILES
(ID NUMBER(10),
ID_TASK NUMBER(10),
ID_EGE NUMBER(10),
ATTACH_DATE DATE,
SOURCE NUMBER(1),
FILE_NAME VARCHAR2(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR2(50),
SUBSEQUENCE VARCHAR2(50),
CURRENT_VALUE NUMBER(10));
CREATE TABLE WSI$WORDS
(ID NUMBER(10),
CAPTION VARCHAR2(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMBER(10),
ID_PROCESS NUMBER(10),
ID_TASK NUMBER(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

==Arrancar el Sistema de Tramitación Electrónica==
Para iniciar el Sistema de Tramitación Electrónica debemos iniciar una series de aplicaciones en un cierto orden. Las aplicaciones que debemos iniciar y como, se listan a continuación.
*'''XAMPP'''
Para iniciar el XAMPP, debemos ir a la ruta donde lo tenemos instalado, en este caso ''c:\xampp'' y ejecutar el archivo con nombre ''xampp-control.exe''.
*'''Servidor de Apache'''
Una vez abierto el panel de control del XAMPP, debemos hacer clic en el botón ''start'' para el Apache.
*'''Tomcat'''
Para iniciar el Tomcat, debemos ir a la ruta ''c:\xampp'' y ejecutar el archivo de procesos por lotes (.bat) con nombre ''tomcat_start.bat''.
*'''Servicio web del Sistema de Tramitación Electrónica'''
Para iniciar el servicio web, debemos ir a la ruta donde se instaló, para este ejemplo debemos ir a la carpeta tramitacion con ruta ''C:\STE\tramitacion'' y ejecutar el archivo de procesos por lotes con nombre ''lanzar.bat''.
El archivo ''lanzar.bat'' contiene el comando de consola que hay que ejecutar para iniciar el servicio web, este comando se compone por la ruta y el nombre del archivo ''Tramitacion_server.exe'' y el argumento que se le pasa al ejecutable, el cual es la ruta donde esta el archivo de configuración del servicio web. Para este ejemplo el archivo ''lanzar.bat'' contiene lo siguiente.
"c:\STE\tramitacion\Tramitacion_server.exe" "c:\STE\tramitacion\webservice.ini"

=¿Y ahora que?=
Una vez completados todos estos pasos, ya disponemos en nuestra maquina del Sistema de Tramitación Electrónica. A continuación ya podemos pasar a desarrollar en la plataforma egeasy, para hacer que el centro del que disponga haga uso del Sistema de Tramitación Electrónica. Le invito a seguir leyendo el siguiente artículo: [[Desarrollar con el STE]]

[[Category:Tramitación electrónica]]

Personalización avanzada del STE

2009-06-18T13:49:31Z

Nmelian: /* Personalizar las vistas */

__TOC__
=Personalizar el registro de usuarios=
La aplicación web del Sistema de Tramitación Electrónica, dispone de dos tipo de registro de usuarios, libre y cerrado, el cual lo podemos configurar desde el fichero ''webservice.ini'' (Vease [[Cómo integrar el Sistema de Tramitación Electrónica en egeasy]]).

==Tipos de registro de usuarios==

*'''Registro cerrado'''
Para configurar la aplicación web, para un tipo de registro cerrado, donde ningún usuario pueda darse de alta en el servicio, sin que un administrador de su autorización, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Close''.

*'''Registro libre'''
Para configurar la aplicación web, para un tipo de registro libre, donde cualquier usuario pueda darse de alta en el servicio, sin ninguna intervención de un administrador, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Free''.

==El archivo registration.xml==
En la aplicación web del Sistema de Tramitación Electrónica, se puede personalizar el formulario de registro de usuario, para introducir los campos necesarios. Podemos definir distintos tipos de campos en el formulario de registro, los tipos son: ''texto'', ''entero'', ''moneda'' y ''fecha''.

Los campo se construyen en el fichero ''registration.xml'' con la siguiente sintaxis:
*Campo simple
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
</field_value>
*Campo deplegable
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
<allowed_values>
<item>'''VALOR_1'''</item>
.
.
.
<item>'''VALOR_N'''</item>
</allowed_values>
</field_value>

Los valores que están en negrita en la sintaxis simbolizan lo siguiente:
 '''IDENTIFICADOR''': Numero único en el fichero que identifica cada campo.
 '''NOMBRE_CAMPO''': Nombre que queremos darle al campo en el formulario de registro.
 '''TIPO_CAMPO''': Tipo de campo que queremos definir en el formulario. Los posibles valores son ''ftString'', ''ftInteger'', ''ftCurrency'' y ''ftDatetime''.
 '''VALOR''': Valor que queremos que se liste en el campo desplegable.

A continuacion podemos ver un ejemplo de cada tipo de campo que se pueden definir en el fichero ''registration.xml''.

*Ejemplo de campo texto
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>

*Ejemplo de campo entero
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>

*Ejemplo de un campo texto desplegable
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>

*Ejemplo de campo moneda
<field_value Field_Identifier="9" Field_Name="Ingresos" Field_Type="ftCurrency">
</field_value>
*Ejemplo de campo fecha
<field_value Field_Identifier="10" Field_Name="Fecha de nacimiento" Field_Type="ftDatetime">
</field_value>

A continuación vemos un ejemplo de un posible fichero de registro de usuario.
<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>
<field_value Field_Identifier="2" Field_Name="Teléfono 1" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>
<field_value Field_Identifier="4" Field_Name="Dirección" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="5" Field_Name="Código postal" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="6" Field_Name="Localidad" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="7" Field_Name="Provincia" Field_Type="ftString">
</field_value>
</registration_form>

=Personalizar el CSS=
Para personalizar la apariencia de la aplicación web, podemos modificar los archivos CSS que estan en la ruta C:\xampp\tomcat\webapps\ste\WebContent\styles, donde el código CSS esta organizado en distintos archivos para una mejor localización.

=Personalizar el HTML=
Para personalizar el html de la aplicación web, podemos modificar los archivos html que estan en la ruta C:\xampp\tomcat\webapps\ste\templates, donde el código html esta organizado en distintos archivos para una mejor localización.

=Personalizar el texto en la aplicación web=
Para personalizar el texto que aparece en la aplicación web, que es estático y no depende de la programación en ODL de la plataforma egeasy, disponemos en la ruta C:\xampp\tomcat\webapps\ste\languages de cuatro ficheros por idioma. El nombre de los ficheros se construye mediante NOMBREIDIOMA.NOMBREFICHERO.lang. Los archivos que disponemos para el idioma español, son los siguientes
*'''es.errors.lang''': Fichero que contiene el texto referente a los mensajes de error
*'''es.labels.lang''': Fichero que contiene el texto referente al nombre de los botones, link, etc.
*'''es.images.lang''': Fichero que contiene las imagenes que se tienen definidas en la aplicación web.
*'''es.messages.lang''': Fichero que contiene el texto referente a los mensajes de la aplicación web, que son estaticos. No confundir con los mensajes que podemos programar mediante ODL en la plataforma egeasy.

=Personalizar las vistas=
En la aplicación web del Sistema de Tramitación Electrónica, podemos crear vistas personalizadas de las tareas que interactuan con la aplicación web. Esto permite modificar y dar el comportamiento a los campos que se desee. Para el desarrollo de este articulo vamos a plantear el ejemplo de aplicar formulas para calcular valores de campos a partir de lo introducido por el usuario en algún otro campo.

[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-18T11:47:27Z

Nmelian:

__TOC__
=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat

=Pasos a seguir=
Para la instalación de la aplicación web del Sistema de Tramitación Electrónica, vamos a disponer de una instalación de la aplicación XAMPP, que nos proporciona de una forma rápida sencilla las aplicaciones requeridas para una puesta en marcha. Para que las explicaciones de los ficheros de configuración sean lo menos confuso posible, en este articulo vamos a instalar la aplicación XAMPP en ''C:\'', por lo tanto todas las rutas se explicaran de dicha ruta. Ademas de instalar la aplicación XAMPP, tenemos que instalar el servicio web, el cual lo vamos a instalar para mayor comodidad en ''C:\ste''. Así que todas las explicaciones parten de dicha ruta de instalación.

==Configurar el servidor web, Apache==
Para configurar el servidor Apache, debemos modificar el archivo de configuración, que esta en la ruta ''C:\xampp\apache\conf'' con el nombre de ''httpd.conf''. Al final de dicho fichero debemos poner lo siguiente:

ScriptAlias "/URLALIAS" "''PATHWEBSERVICE''"
<Directory "''PATHWEBSERVICE''">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

'''URLALIAS''': Es la URL que vamos a definir donde va a estar nuestro servicio web. Para este ejemplo usaremos ''tramitacion''.
 '''PATHWEBSERVICE''': Es la ruta física donde está desplegado el servicio web. Para este ejemplo, esa ruta es la siguiente: ''C:/STE/tramitacion/''.

Un ejemplo podría ser el siguiente:

ScriptAlias "/tramitacion" "C:/STE/tramitacion"
<Directory "C:/STE/tramitacion/">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

==Configurar el servicio web STE==
Para configurar el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ''webservice.ini'' que esta en la ruta ''C:\STE\tramitacion'', que para este ejemplo será donde esta instalado.

Al abrir el fichero ''webservice.ini'' encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SERVER_ADDRESS''' IP donde se publicará el servicio web.
*'''SERVER_PORT''': Puerto donde se publicará el servicio web.
*'''WS_IDENTIFIER''': Identificador del servicio web.
*'''WS_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''WS_DB_TYPE''': Gestor de base de datos. Posibles valores: SQL Server, Oracle, PostgresSQL, Firebird.
*'''WS_DIRECTORY_DOCUMENTS''': Ruta donde se almacenan los documentos generados por la aplicación.
*'''WS_DIRECTORY_LOGS''': Ruta donde se localizan los logs del servicio web.
*'''WS_FILE_INVALID_WORDS''': Ruta del fichero donde están las palabras que no se van a indexar en la base de datos.
*'''TYPE_REGISTRATION''': Si esta etiqueta está presente, entonces en la aplicacón web los usuarios podrán registrarse libremente. Los valore que admite esta etiqueta es ''Free''.
*'''REGISTRATION_FORM''':Ruta y nombre del archivo xml que se usará para generar el formulario de registro en la aplicación web. Para este ejemplo usaremos el siguiente fichero ''C:\STE\registration.xml''.
*'''EGE_USER_RRC''': Identificador del usuario en la plataforma egeasy, con el que va a acceder la aplicación web a la plataforma. Para un correcto funcionamiento, debemos generar un usuario en la plataforma solo para esta aplicación web.
*'''EGE_CENTER_NAME''':Nombre del centro al que se le va a poner la aplicación web.
*'''EGE_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''EGE_DB_TYPE''': Nombre del tipo de base de datos que se usa para la plataforma egeasy.

*'''EGE_MODEL_DIRECTORY''': Ruta donde se localiza el modelo del centro de la plataforma egeasy.
*'''EGE_DOCUMENT_DIRECTORY''': Ruta donde se localizan la base documental de la plataforma egeasy.
*'''EGE_REGISTRY_DIRECTORY''': Ruta donde se localizan los registro de la plataforma egeasy.

Un ejemplo de un fichero de configuración, podría ser el siguiente:
SERVER_ADDRESS=10.22.144.178
SERVER_PORT=10000
WS_IDENTIFIER=WS_STE
WS_DB_CONNECTION_STRING=acecau@europa@acecau
WS_DB_TYPE=Oracle
WS_DIRECTORY_DOCUMENTS=C:\STE\Docs
WS_DIRECTORY_LOGS=C:\STE\Logs
WS_FILE_INVALID_WORDS=C:\STE\palabras.dat
TYPE_REGISTRATION=Free
REGISTRATION_FORM=C:\STE\registration.xml
EGE_USER_RRC=3825
EGE_CENTER_NAME=Acecau STE Oracle
EGE_DB_CONNECTION_STRING=acecau@europa@acecau
EGE_DB_TYPE=Oracle
EGE_MODEL_DIRECTORY=S:\Entornos 2002\Banzai\Modelos\ACECAU STEMod
EGE_DOCUMENT_DIRECTORY=S:\Entornos 2002\Banzai\Documentos\AcecauSTEDoc
EGE_REGISTRY_DIRECTORY=S:\Entornos 2002\Banzai\Registro\acecausteReg

==Configurar la aplicación web STE==

Para configurar la aplicación web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\xampp\tomcat\webapps\ste\WebContent\WEB-INF\classes\org\siani\ste\configuration, que para este ejemplo será donde esta instalado.

Al abrir el fichero ste.conf encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SITE_DIR''': Ruta donde se encuentra instalada la aplicación web.
*'''SITE_URL''': URL donde se encuentra la aplicación web.
*'''LOG_DIR''': Ruta donde se encuentran los logs de la aplicación web.
*'''DATA_DIR''': Ruta donde se encuentra los datos variables de la aplicación web.
*'''TEMPLATES_DIR''': Ruta donde se encuentra las plantillas html de visualización.
*'''TEMP_DIR''': Ruta donde se encuentra los archivos subidos por los usuarios temporalmente.
*'''SITE_DATA_DEFINITIONS_DIR''': Ruta donde se encuentran las definiciones datos personalizados.
*'''SITE_FORMS_DIR''': Ruta donde se encuentra las vistas personalizadas de los trámites.
*'''SITE_PORT''': Puerto que usa la aplicación web.
*'''API_URL''': URL del servlet, llamado API que usa la aplicación web.
*'''SITE_IMAGES_DIR''': Ruta donde se encuentran las imagenes de la aplicación web.
*'''SITE_IMAGES_URL''': URL donde se encuentran las imagenes de la aplicación web.
*'''SITE_JAVASCRIPT_DIR''': Ruta donde se encuentran el javascript de la aplicación web.
*'''SITE_JAVASCRIPT_URL''': URL donde se encuentran el javascript de la aplicación web.
*'''SITE_STYLES_DIR''': Ruta donde se encuentran los estilos CSS de la aplicación web.
*'''SITE_STYLES_URL''': URL donde se encuentran los estilos CSS de la aplicación web.
*'''WS_SOAP_URL''': URL donde se encuentra el servicio web del STE.
*'''LANG_DIR''': Ruta donde se encuentra los archivos de idioma.
*'''EN = en''': Se define el lenguaje Ingles.
*'''ES = es''': Se define el lenguaje Español.
*'''DEFAULT_LANGUAGE''': Indica que lenguaje se va a usar por defecto en la aplicación.

Un ejemplo del fichero de configuración es:

// DIRECTORIES
SITE_DIR = c:/xampp/tomcat/webapps/ste/WebContent
SITE_URL = http://ste
LOG_DIR = C:/xampp/tomcat/webapps/ste/logs
DATA_DIR = C:/xampp/tomcat/webapps/ste/data
TEMPLATES_DIR = C:/xampp/tomcat/webapps/ste/templates
TEMP_DIR = C:/xampp/tomcat/webapps/ste/temp
SITE_PORT = 80
SITE_DATA_DEFINITIONS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions
SITE_FORMS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions/forms
API_URL = http://ste/api
SITE_IMAGES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/images
SITE_IMAGES_URL = http://ste/images
SITE_JAVASCRIPT_DIR = c:/xampp/tomcat/webapps/ste/WebContent/javascript
SITE_JAVASCRIPT_URL = http://ste/javascript
SITE_STYLES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/styles
SITE_STYLES_URL = http://ste/styles
WS_SOAP_URL = http://ste/tramitacion/tramitacion_ws_cgi.exe/soap/IEgeWebService
LANG_DIR = C:/xampp/tomcat/webapps/ste/languages
// LANGUAGES
EN = en
ES = es
DEFAULT_LANGUAGE = es

==Configurar el DNS==
Debemos preparar nuestra maquina, para indicar mediante un nombre de dominio donde esta situado el Sistema de Tramitación Electrónica, para nuestro caso, el sistema esta instalado en local. Por lo tanto solo debemos ir a la ruta de nuestro equipo donde está el fichero ''hosts'', que esta en ''C:\WINDOWS\system32\drivers\etc\'' e introducir lo siguiente:

127.0.0.1 ste

==Creación de tablas en la base de datos==
Para la implantación del Sistema de Tramitación Electrónica, se deben crear unas cuantas tablas y indices en la base de datos. Par este ejemplo vamos a utilizar la misma base de datos y esquema donde tenemos implantada ya la plataforma egeasy. A continuación se listaran los script con las sentencias SQL que hay que ejecutar en la base de datos, para generar todo lo necesario para el Sistema de Tramitación Electrónica. Disponemos de los script tanto para SQL-Server como para Oracle.

*Script para base de datos en SQL-Server
CREATE TABLE WS$USERS
(ID NUMERIC(10) PRIMARY KEY,
NIF VARCHAR(10),
NAME VARCHAR(50),
FULLNAME VARCHAR(50),
EMAIL VARCHAR(50),
FORM IMAGE);
CREATE TABLE WS$PROCESSES
(ID NUMERIC(10) PRIMARY KEY,
LABEL VARCHAR(100),
TRAMITATION_STATUS VARCHAR(100),
ID_PROCEDURE NUMERIC(10),
ID_USER NUMERIC(10),
STATUS NUMERIC(1),
CREATE_DATE DATETIME,
START_DATE DATETIME,
END_DATE DATETIME);
CREATE TABLE WS$TASKS
(ID NUMERIC(10) PRIMARY KEY,
ID_PROCESS NUMERIC(10),
ID_EGE NUMERIC(10),
ID_DEFINITION NUMERIC(10),
CREATE_RECEIVE_DATE DATETIME,
SEND_RESPONSE_DATE DATETIME,
STATUS NUMERIC(1),
CONTENT IMAGE);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMERIC(10) PRIMARY KEY,
SIGNATURE IMAGE);
CREATE TABLE WS$FILES
(ID NUMERIC(10),
ID_TASK NUMERIC(10),
ID_EGE NUMERIC(10),
ATTACH_DATE DATETIME,
SOURCE NUMERIC(1),
FILE_NAME VARCHAR(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR(50),
SUBSEQUENCE VARCHAR(50),
CURRENT_VALUE NUMERIC(10));
CREATE TABLE WSI$WORDS
(ID NUMERIC(10),
CAPTION VARCHAR(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMERIC(10),
ID_PROCESS NUMERIC(10),
ID_TASK NUMERIC(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

*Script para base de datos en Oracle
CREATE TABLE WS$USERS
(ID NUMBER(10) PRIMARY KEY,
NIF VARCHAR2(10),
NAME VARCHAR2(50),
FULLNAME VARCHAR2(50),
EMAIL VARCHAR2(50),
FORM LONG RAW);
CREATE TABLE WS$PROCESSES
(ID NUMBER(10) PRIMARY KEY,
LABEL VARCHAR2(100),
TRAMITATION_STATUS VARCHAR2(100),
ID_PROCEDURE NUMBER(10),
ID_USER NUMBER(10),
STATUS NUMBER(1),
CREATE_DATE DATE,
START_DATE DATE,
END_DATE DATE);
CREATE TABLE WS$TASKS
(ID NUMBER(10) PRIMARY KEY,
ID_PROCESS NUMBER(10),
ID_EGE NUMBER(10),
ID_DEFINITION NUMBER(10),
CREATE_RECEIVE_DATE DATE,
SEND_RESPONSE_DATE DATE,
STATUS NUMBER(1),
CONTENT LONG RAW);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMBER(10) PRIMARY KEY,
SIGNATURE LONG RAW);
CREATE TABLE WS$FILES
(ID NUMBER(10),
ID_TASK NUMBER(10),
ID_EGE NUMBER(10),
ATTACH_DATE DATE,
SOURCE NUMBER(1),
FILE_NAME VARCHAR2(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR2(50),
SUBSEQUENCE VARCHAR2(50),
CURRENT_VALUE NUMBER(10));
CREATE TABLE WSI$WORDS
(ID NUMBER(10),
CAPTION VARCHAR2(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMBER(10),
ID_PROCESS NUMBER(10),
ID_TASK NUMBER(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

==Arrancar el Sistema de Tramitación Electrónica==
Para iniciar el Sistema de Tramitación Electrónica debemos iniciar una series de aplicaciones en un cierto orden. Las aplicaciones que debemos iniciar y como, se listan a continuación.
*'''XAMPP'''
Para iniciar el XAMPP, debemos ir a la ruta donde lo tenemos instalado, en este caso ''c:\xampp'' y ejecutar el archivo con nombre ''xampp-control.exe''.
*'''Servidor de Apache'''
Una vez abierto el panel de control del XAMPP, debemos hacer clic en el botón ''start'' para el Apache.
*'''Tomcat'''
Para iniciar el Tomcat, debemos ir a la ruta ''c:\xampp'' y ejecutar el archivo de procesos por lotes (.bat) con nombre ''tomcat_start.bat''.
*'''Servicio web del Sistema de Tramitación Electrónica'''
Para iniciar el servicio web, debemos ir a la ruta donde se instaló, para este ejemplo debemos ir a la carpeta tramitacion con ruta ''C:\STE\tramitacion'' y ejecutar el archivo de procesos por lotes con nombre ''lanzar.bat''.
El archivo ''lanzar.bat'' contiene el comando de consola que hay que ejecutar para iniciar el servicio web, este comando se compone por la ruta y el nombre del archivo ''Tramitacion_server.exe'' y el argumento que se le pasa al ejecutable, el cual es la ruta donde esta el archivo de configuración del servicio web. Para este ejemplo el archivo ''lanzar.bat'' contiene lo siguiente.
"c:\STE\tramitacion\Tramitacion_server.exe" "c:\STE\tramitacion\webservice.ini"

=¿Y ahora que?=
Una vez completados todos estos pasos, ya disponemos en nuestra maquina del Sistema de Tramitación Electrónica. A continuación ya podemos pasar a desarrollar en la plataforma egeasy, para hacer que el centro del que disponga haga uso del Sistema de Tramitación Electrónica. Le invito a seguir leyendo el siguiente artículo: [[Desarrollar con el STE]]

[[Category:Tramitación electrónica]]

Personalización avanzada del STE

2009-06-17T14:09:10Z

Nmelian: /* Personalizar el CSS */

__TOC__
=Personalizar el registro de usuarios=
La aplicación web del Sistema de Tramitación Electrónica, dispone de dos tipo de registro de usuarios, libre y cerrado, el cual lo podemos configurar desde el fichero ''webservice.ini'' (Vease [[Cómo integrar el Sistema de Tramitación Electrónica en egeasy]]).

==Tipos de registro de usuarios==

*'''Registro cerrado'''
Para configurar la aplicación web, para un tipo de registro cerrado, donde ningún usuario pueda darse de alta en el servicio, sin que un administrador de su autorización, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Close''.

*'''Registro libre'''
Para configurar la aplicación web, para un tipo de registro libre, donde cualquier usuario pueda darse de alta en el servicio, sin ninguna intervención de un administrador, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Free''.

==El archivo registration.xml==
En la aplicación web del Sistema de Tramitación Electrónica, se puede personalizar el formulario de registro de usuario, para introducir los campos necesarios. Podemos definir distintos tipos de campos en el formulario de registro, los tipos son: ''texto'', ''entero'', ''moneda'' y ''fecha''.

Los campo se construyen en el fichero ''registration.xml'' con la siguiente sintaxis:
*Campo simple
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
</field_value>
*Campo deplegable
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
<allowed_values>
<item>'''VALOR_1'''</item>
.
.
.
<item>'''VALOR_N'''</item>
</allowed_values>
</field_value>

Los valores que están en negrita en la sintaxis simbolizan lo siguiente:
 '''IDENTIFICADOR''': Numero único en el fichero que identifica cada campo.
 '''NOMBRE_CAMPO''': Nombre que queremos darle al campo en el formulario de registro.
 '''TIPO_CAMPO''': Tipo de campo que queremos definir en el formulario. Los posibles valores son ''ftString'', ''ftInteger'', ''ftCurrency'' y ''ftDatetime''.
 '''VALOR''': Valor que queremos que se liste en el campo desplegable.

A continuacion podemos ver un ejemplo de cada tipo de campo que se pueden definir en el fichero ''registration.xml''.

*Ejemplo de campo texto
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>

*Ejemplo de campo entero
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>

*Ejemplo de un campo texto desplegable
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>

*Ejemplo de campo moneda
<field_value Field_Identifier="9" Field_Name="Ingresos" Field_Type="ftCurrency">
</field_value>
*Ejemplo de campo fecha
<field_value Field_Identifier="10" Field_Name="Fecha de nacimiento" Field_Type="ftDatetime">
</field_value>

A continuación vemos un ejemplo de un posible fichero de registro de usuario.
<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>
<field_value Field_Identifier="2" Field_Name="Teléfono 1" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>
<field_value Field_Identifier="4" Field_Name="Dirección" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="5" Field_Name="Código postal" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="6" Field_Name="Localidad" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="7" Field_Name="Provincia" Field_Type="ftString">
</field_value>
</registration_form>

=Personalizar el CSS=
Para personalizar la apariencia de la aplicación web, podemos modificar los archivos CSS que estan en la ruta C:\xampp\tomcat\webapps\ste\WebContent\styles, donde el código CSS esta organizado en distintos archivos para una mejor localización.

=Personalizar el HTML=
Para personalizar el html de la aplicación web, podemos modificar los archivos html que estan en la ruta C:\xampp\tomcat\webapps\ste\templates, donde el código html esta organizado en distintos archivos para una mejor localización.

=Personalizar el texto en la aplicación web=
Para personalizar el texto que aparece en la aplicación web, que es estático y no depende de la programación en ODL de la plataforma egeasy, disponemos en la ruta C:\xampp\tomcat\webapps\ste\languages de cuatro ficheros por idioma. El nombre de los ficheros se construye mediante NOMBREIDIOMA.NOMBREFICHERO.lang. Los archivos que disponemos para el idioma español, son los siguientes
*'''es.errors.lang''': Fichero que contiene el texto referente a los mensajes de error
*'''es.labels.lang''': Fichero que contiene el texto referente al nombre de los botones, link, etc.
*'''es.images.lang''': Fichero que contiene las imagenes que se tienen definidas en la aplicación web.
*'''es.messages.lang''': Fichero que contiene el texto referente a los mensajes de la aplicación web, que son estaticos. No confundir con los mensajes que podemos programar mediante ODL en la plataforma egeasy.

=Personalizar las vistas=
-programacion JS y programacion xhtml general para cabiar las paginas comportamientos de campos

[[Category:Tramitación electrónica]]

Personalización avanzada del STE

2009-06-17T13:49:09Z

Nmelian: /* El archivo registration.xml */

__TOC__
=Personalizar el registro de usuarios=
La aplicación web del Sistema de Tramitación Electrónica, dispone de dos tipo de registro de usuarios, libre y cerrado, el cual lo podemos configurar desde el fichero ''webservice.ini'' (Vease [[Cómo integrar el Sistema de Tramitación Electrónica en egeasy]]).

==Tipos de registro de usuarios==

*'''Registro cerrado'''
Para configurar la aplicación web, para un tipo de registro cerrado, donde ningún usuario pueda darse de alta en el servicio, sin que un administrador de su autorización, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Close''.

*'''Registro libre'''
Para configurar la aplicación web, para un tipo de registro libre, donde cualquier usuario pueda darse de alta en el servicio, sin ninguna intervención de un administrador, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Free''.

==El archivo registration.xml==
En la aplicación web del Sistema de Tramitación Electrónica, se puede personalizar el formulario de registro de usuario, para introducir los campos necesarios. Podemos definir distintos tipos de campos en el formulario de registro, los tipos son: ''texto'', ''entero'', ''moneda'' y ''fecha''.

Los campo se construyen en el fichero ''registration.xml'' con la siguiente sintaxis:
*Campo simple
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
</field_value>
*Campo deplegable
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
<allowed_values>
<item>'''VALOR_1'''</item>
.
.
.
<item>'''VALOR_N'''</item>
</allowed_values>
</field_value>

Los valores que están en negrita en la sintaxis simbolizan lo siguiente:
 '''IDENTIFICADOR''': Numero único en el fichero que identifica cada campo.
 '''NOMBRE_CAMPO''': Nombre que queremos darle al campo en el formulario de registro.
 '''TIPO_CAMPO''': Tipo de campo que queremos definir en el formulario. Los posibles valores son ''ftString'', ''ftInteger'', ''ftCurrency'' y ''ftDatetime''.
 '''VALOR''': Valor que queremos que se liste en el campo desplegable.

A continuacion podemos ver un ejemplo de cada tipo de campo que se pueden definir en el fichero ''registration.xml''.

*Ejemplo de campo texto
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>

*Ejemplo de campo entero
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>

*Ejemplo de un campo texto desplegable
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>

*Ejemplo de campo moneda
<field_value Field_Identifier="9" Field_Name="Ingresos" Field_Type="ftCurrency">
</field_value>
*Ejemplo de campo fecha
<field_value Field_Identifier="10" Field_Name="Fecha de nacimiento" Field_Type="ftDatetime">
</field_value>

A continuación vemos un ejemplo de un posible fichero de registro de usuario.
<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>
<field_value Field_Identifier="2" Field_Name="Teléfono 1" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>
<field_value Field_Identifier="4" Field_Name="Dirección" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="5" Field_Name="Código postal" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="6" Field_Name="Localidad" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="7" Field_Name="Provincia" Field_Type="ftString">
</field_value>
</registration_form>

=Personalizar el CSS=
Para personalizar la apariencia de la aplicación web, podemos modificar los archivos CSS que estan en la ruta C:\xampp\tomcat\webapps\ste\WebContent\styles, donde el código CSS esta organizado en distintos archivos para una mejor localización.

-Hay que explicar que para cada centro se peuden tener archivos css personalizados que sobreesciben el css base de la aplicación. Donde no se exactamente en que lugar y como es el nombre de dichos ficheros.

=Personalizar el HTML=
Para personalizar el html de la aplicación web, podemos modificar los archivos html que estan en la ruta C:\xampp\tomcat\webapps\ste\templates, donde el código html esta organizado en distintos archivos para una mejor localización.

=Personalizar el texto en la aplicación web=
Para personalizar el texto que aparece en la aplicación web, que es estático y no depende de la programación en ODL de la plataforma egeasy, disponemos en la ruta C:\xampp\tomcat\webapps\ste\languages de cuatro ficheros por idioma. El nombre de los ficheros se construye mediante NOMBREIDIOMA.NOMBREFICHERO.lang. Los archivos que disponemos para el idioma español, son los siguientes
*'''es.errors.lang''': Fichero que contiene el texto referente a los mensajes de error
*'''es.labels.lang''': Fichero que contiene el texto referente al nombre de los botones, link, etc.
*'''es.images.lang''': Fichero que contiene las imagenes que se tienen definidas en la aplicación web.
*'''es.messages.lang''': Fichero que contiene el texto referente a los mensajes de la aplicación web, que son estaticos. No confundir con los mensajes que podemos programar mediante ODL en la plataforma egeasy.

=Personalizar las vistas=
-programacion JS y programacion xhtml general para cabiar las paginas comportamientos de campos

[[Category:Tramitación electrónica]]

Personalización avanzada del STE

2009-06-17T13:48:09Z

Nmelian:

__TOC__
=Personalizar el registro de usuarios=
La aplicación web del Sistema de Tramitación Electrónica, dispone de dos tipo de registro de usuarios, libre y cerrado, el cual lo podemos configurar desde el fichero ''webservice.ini'' (Vease [[Cómo integrar el Sistema de Tramitación Electrónica en egeasy]]).

==Tipos de registro de usuarios==

*'''Registro cerrado'''
Para configurar la aplicación web, para un tipo de registro cerrado, donde ningún usuario pueda darse de alta en el servicio, sin que un administrador de su autorización, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Close''.

*'''Registro libre'''
Para configurar la aplicación web, para un tipo de registro libre, donde cualquier usuario pueda darse de alta en el servicio, sin ninguna intervención de un administrador, debemos por en el fichero ''webservice.ini'' la etiqueta ''TYPE_REGISTRATION'' con el valor ''Free''.

==El archivo registration.xml==
En la aplicación web del Sistema de Tramitación Electrónica, se puede personalizar el formulario de registro de usuario, para introducir los campos necesarios. Podemos definir distintos tipos de campos en el formulario de registro, los tipos son: ''texto'', ''entero'', ''moneda'' y ''fecha''.

Los campo se construyen en el fichero ''registration.xml'' con la siguiente sintaxis:
*Campo simple
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
</field_value>
*Campo deplegable
<field_value Field_Identifier="'''IDENTIFICADOR'''" Field_Name="'''NOMBRE_CAMPO'''" Field_Type="'''TIPO_CAMPO'''">
<allowed_values>
<item>'''VALOR_1'''</item>
.
.
.
<item>'''VALOR_N'''</item>
</allowed_values>
</field_value>

Los valores que están en negrita en la sintaxis simbolizan lo siguiente:
 '''IDENTIFICADOR''': Numero único en el fichero que identifica cada campo.
 '''NOMBRE_CAMPO''': Nombre que queremos darle al campo en el formulario de registro.
 '''TIPO_CAMPO''': Tipo de campo que queremos definir en el formulario. Los posibles valores son ''ftString'', ''ftInteger'', ''ftCurrency'' y ''ftDatetime''.
 '''VALOR''': Valor que queremos que se liste en el campo desplegable.

A continuacion podemos ver un ejemplo de cada tipo de campo que se pueden definir en el fichero ''registration.xml''.

*Ejemplo de campo texto
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>

*Ejemplo de campo entero
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>

*Ejemplo de un campo texto desplegable
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>

*Ejemplo de campo moneda
<field_value Field_Identifier="9" Field_Name="Ingresos" Field_Type="ftCurrency">
</field_value>
*Ejemplo de campo fecha
<field_value Field_Identifier="10" Field_Name="Fecha de nacimiento" Field_Type="ftDatetime">
</field_value>

A continuación vemos un ejemplo de un posible fichero de registro de usuario.
<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
<field_value Field_Identifier="1" Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>
<field_value Field_Identifier="2" Field_Name="Teléfono 1" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="3" Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="8" Field_Name="Fax" Field_Type="ftInteger">
</field_value>
<field_value Field_Identifier="4" Field_Name="Dirección" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="5" Field_Name="Código postal" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="6" Field_Name="Localidad" Field_Type="ftString">
</field_value>
<field_value Field_Identifier="7" Field_Name="Provincia" Field_Type="ftString">
</field_value>
</registration_form>

=Personalizar el CSS=
Para personalizar la apariencia de la aplicación web, podemos modificar los archivos CSS que estan en la ruta C:\xampp\tomcat\webapps\ste\WebContent\styles, donde el código CSS esta organizado en distintos archivos para una mejor localización.

-Hay que explicar que para cada centro se peuden tener archivos css personalizados que sobreesciben el css base de la aplicación. Donde no se exactamente en que lugar y como es el nombre de dichos ficheros.

=Personalizar el HTML=
Para personalizar el html de la aplicación web, podemos modificar los archivos html que estan en la ruta C:\xampp\tomcat\webapps\ste\templates, donde el código html esta organizado en distintos archivos para una mejor localización.

=Personalizar el texto en la aplicación web=
Para personalizar el texto que aparece en la aplicación web, que es estático y no depende de la programación en ODL de la plataforma egeasy, disponemos en la ruta C:\xampp\tomcat\webapps\ste\languages de cuatro ficheros por idioma. El nombre de los ficheros se construye mediante NOMBREIDIOMA.NOMBREFICHERO.lang. Los archivos que disponemos para el idioma español, son los siguientes
*'''es.errors.lang''': Fichero que contiene el texto referente a los mensajes de error
*'''es.labels.lang''': Fichero que contiene el texto referente al nombre de los botones, link, etc.
*'''es.images.lang''': Fichero que contiene las imagenes que se tienen definidas en la aplicación web.
*'''es.messages.lang''': Fichero que contiene el texto referente a los mensajes de la aplicación web, que son estaticos. No confundir con los mensajes que podemos programar mediante ODL en la plataforma egeasy.

=Personalizar las vistas=
-programacion JS y programacion xhtml general para cabiar las paginas comportamientos de campos

[[Category:Tramitación electrónica]]

Personalización avanzada del STE

2009-06-17T13:16:14Z

Nmelian: /* Tipos de registro */

Personalización avanzada del STE

2009-06-17T13:15:25Z

Nmelian:

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T11:22:10Z

Nmelian: /* Arrancar el Sistema de Tramitación Electrónica */

__TOC__
=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat

=Pasos a seguir=
Para la instalación de la aplicación web del Sistema de Tramitación Electrónica, vamos a disponer de una instalación de la aplicación XAMPP, que nos proporciona de una forma rápida sencilla las aplicaciones requeridas para una puesta en marcha. Para que las explicaciones de los ficheros de configuración sean lo menos confuso posible, en este articulo vamos a instalar la aplicación XAMPP en ''C:\'', por lo tanto todas las rutas se explicaran de dicha ruta. Ademas de instalar la aplicación XAMPP, tenemos que instalar el servicio web, el cual lo vamos a instalar para mayor comodidad en ''C:\ste''. Así que todas las explicaciones parten de dicha ruta de instalación.

==Configurar el servidor web, Apache==
Para configurar el servidor Apache, debemos modificar el archivo de configuración, que esta en la ruta ''C:\xampp\apache\conf'' con el nombre de ''httpd.conf''. Al final de dicho fichero debemos poner lo siguiente:

ScriptAlias "/URLALIAS" "''PATHWEBSERVICE''"
<Directory "''PATHWEBSERVICE''">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

'''URLALIAS''': Es la URL que vamos a definir donde va a estar nuestro servicio web. Para este ejemplo usaremos ''tramitacion''.
 '''PATHWEBSERVICE''': Es la ruta física donde está desplegado el servicio web. Para este ejemplo, esa ruta es la siguiente: ''C:/STE/tramitacion/''.

Un ejemplo podría ser el siguiente:

ScriptAlias "/tramitacion" "C:/STE/tramitacion"
<Directory "C:/STE/tramitacion/">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

==Configurar el servicio web STE==
Para configurar el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ''webservice.ini'' que esta en la ruta ''C:\STE\tramitacion'', que para este ejemplo será donde esta instalado.

Al abrir el fichero ''webservice.ini'' encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SERVER_ADDRESS''' IP donde se publicará el servicio web.
*'''SERVER_PORT''': Puerto donde se publicará el servicio web.
*'''WS_IDENTIFIER''': Identificador del servicio web.
*'''WS_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''WS_DB_TYPE''': Nombre del tipo de base de datos que se usa para el servicio web.
*'''WS_DIRECTORY_DOCUMENTS''': Ruta donde se almacenan los documentos generados por la aplicación.
*'''WS_DIRECTORY_LOGS''': Ruta donde se localizan los logs del servicio web.
*'''WS_FILE_INVALID_WORDS''': Ruta del fichero donde están las palabras que no se van a indexar en la base de datos.
*'''TYPE_REGISTRATION''': Si esta etiqueta está presente, entonces en la aplicacón web los usuarios podrán registrarse libremente. Los valore que admite esta etiqueta es ''Free''.
*'''REGISTRATION_FORM''':Ruta y nombre del archivo xml que se usará para generar el formulario de registro en la aplicación web. Para este ejemplo usaremos el siguiente fichero ''C:\STE\registration.xml''.
*'''EGE_USER_RRC''': Identificador del usuario en la plataforma egeasy, con el que va a acceder la aplicación web a la plataforma. Para un correcto funcionamiento, debemos generar un usuario en la plataforma solo para esta aplicación web.
*'''EGE_CENTER_NAME''':Nombre del centro al que se le va a poner la aplicación web.
*'''EGE_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''EGE_DB_TYPE''': Nombre del tipo de base de datos que se usa para la plataforma egeasy.

*'''EGE_MODEL_DIRECTORY''': Ruta donde se localiza el modelo del centro de la plataforma egeasy.
*'''EGE_DOCUMENT_DIRECTORY''': Ruta donde se localizan la base documental de la plataforma egeasy.
*'''EGE_REGISTRY_DIRECTORY''': Ruta donde se localizan los registro de la plataforma egeasy.

Un ejemplo de un fichero de configuración, podría ser el siguiente:
SERVER_ADDRESS=10.22.144.178
SERVER_PORT=10000
WS_IDENTIFIER=WS_STE
WS_DB_CONNECTION_STRING=acecau@europa@acecau
WS_DB_TYPE=Oracle
WS_DIRECTORY_DOCUMENTS=C:\STE\Docs
WS_DIRECTORY_LOGS=C:\STE\Logs
WS_FILE_INVALID_WORDS=C:\STE\palabras.dat
TYPE_REGISTRATION=Free
REGISTRATION_FORM=C:\STE\registration.xml
EGE_USER_RRC=3825
EGE_CENTER_NAME=Acecau STE Oracle
EGE_DB_CONNECTION_STRING=acecau@europa@acecau
EGE_DB_TYPE=Oracle
EGE_MODEL_DIRECTORY=S:\Entornos 2002\Banzai\Modelos\ACECAU STEMod
EGE_DOCUMENT_DIRECTORY=S:\Entornos 2002\Banzai\Documentos\AcecauSTEDoc
EGE_REGISTRY_DIRECTORY=S:\Entornos 2002\Banzai\Registro\acecausteReg

==Configurar la aplicación web STE==

Para configurar la aplicación web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\xampp\tomcat\webapps\ste\WebContent\WEB-INF\classes\org\siani\ste\configuration, que para este ejemplo será donde esta instalado.

Al abrir el fichero ste.conf encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SITE_DIR''': Ruta donde se encuentra instalada la aplicación web.
*'''SITE_URL''': URL donde se encuentra la aplicación web.
*'''LOG_DIR''': Ruta donde se encuentran los logs de la aplicación web.
*'''DATA_DIR''': Ruta donde se encuentra los datos variables de la aplicación web.
*'''TEMPLATES_DIR''': Ruta donde se encuentra las plantillas html de visualización.
*'''TEMP_DIR''': Ruta donde se encuentra los archivos subidos por los usuarios temporalmente.
*'''SITE_DATA_DEFINITIONS_DIR''': Ruta donde se encuentran las definiciones datos personalizados.
*'''SITE_FORMS_DIR''': Ruta donde se encuentra las vistas personalizadas de los trámites.
*'''SITE_PORT''': Puerto que usa la aplicación web.
*'''API_URL''': URL del servlet, llamado API que usa la aplicación web.
*'''SITE_IMAGES_DIR''': Ruta donde se encuentran las imagenes de la aplicación web.
*'''SITE_IMAGES_URL''': URL donde se encuentran las imagenes de la aplicación web.
*'''SITE_JAVASCRIPT_DIR''': Ruta donde se encuentran el javascript de la aplicación web.
*'''SITE_JAVASCRIPT_URL''': URL donde se encuentran el javascript de la aplicación web.
*'''SITE_STYLES_DIR''': Ruta donde se encuentran los estilos CSS de la aplicación web.
*'''SITE_STYLES_URL''': URL donde se encuentran los estilos CSS de la aplicación web.
*'''WS_SOAP_URL''': URL donde se encuentra el servicio web del STE.
*'''LANG_DIR''': Ruta donde se encuentra los archivos de idioma.
*'''EN = en''': Se define el lenguaje Ingles.
*'''ES = es''': Se define el lenguaje Español.
*'''DEFAULT_LANGUAGE''': Indica que lenguaje se va a usar por defecto en la aplicación.

Un ejemplo del fichero de configuración es:

// DIRECTORIES
SITE_DIR = c:/xampp/tomcat/webapps/ste/WebContent
SITE_URL = http://ste
LOG_DIR = C:/xampp/tomcat/webapps/ste/logs
DATA_DIR = C:/xampp/tomcat/webapps/ste/data
TEMPLATES_DIR = C:/xampp/tomcat/webapps/ste/templates
TEMP_DIR = C:/xampp/tomcat/webapps/ste/temp
SITE_PORT = 80
SITE_DATA_DEFINITIONS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions
SITE_FORMS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions/forms
API_URL = http://ste/api
SITE_IMAGES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/images
SITE_IMAGES_URL = http://ste/images
SITE_JAVASCRIPT_DIR = c:/xampp/tomcat/webapps/ste/WebContent/javascript
SITE_JAVASCRIPT_URL = http://ste/javascript
SITE_STYLES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/styles
SITE_STYLES_URL = http://ste/styles
WS_SOAP_URL = http://ste/tramitacion/tramitacion_ws_cgi.exe/soap/IEgeWebService
LANG_DIR = C:/xampp/tomcat/webapps/ste/languages
// LANGUAGES
EN = en
ES = es
DEFAULT_LANGUAGE = es

==Configurar el DNS==
Debemos preparar nuestra maquina, para indicar mediante un nombre de dominio donde esta situado el Sistema de Tramitación Electrónica, para nuestro caso, el sistema esta instalado en local. Por lo tanto solo debemos ir a la ruta de nuestro equipo donde está el fichero ''hosts'', que esta en ''C:\WINDOWS\system32\drivers\etc\'' e introducir lo siguiente:

127.0.0.1 ste

==Creación de tablas en la base de datos==
Para la implantación del Sistema de Tramitación Electrónica, se deben crear unas cuantas tablas y indices en la base de datos. Par este ejemplo vamos a utilizar la misma base de datos y esquema donde tenemos implantada ya la plataforma egeasy. A continuación se listaran los script con las sentencias SQL que hay que ejecutar en la base de datos, para generar todo lo necesario para el Sistema de Tramitación Electrónica. Disponemos de los script tanto para SQL-Server como para Oracle.

*Script para base de datos en SQL-Server
CREATE TABLE WS$USERS
(ID NUMERIC(10) PRIMARY KEY,
NIF VARCHAR(10),
NAME VARCHAR(50),
FULLNAME VARCHAR(50),
EMAIL VARCHAR(50),
FORM IMAGE);
CREATE TABLE WS$PROCESSES
(ID NUMERIC(10) PRIMARY KEY,
LABEL VARCHAR(100),
TRAMITATION_STATUS VARCHAR(100),
ID_PROCEDURE NUMERIC(10),
ID_USER NUMERIC(10),
STATUS NUMERIC(1),
CREATE_DATE DATETIME,
START_DATE DATETIME,
END_DATE DATETIME);
CREATE TABLE WS$TASKS
(ID NUMERIC(10) PRIMARY KEY,
ID_PROCESS NUMERIC(10),
ID_EGE NUMERIC(10),
ID_DEFINITION NUMERIC(10),
CREATE_RECEIVE_DATE DATETIME,
SEND_RESPONSE_DATE DATETIME,
STATUS NUMERIC(1),
CONTENT IMAGE);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMERIC(10) PRIMARY KEY,
SIGNATURE IMAGE);
CREATE TABLE WS$FILES
(ID NUMERIC(10),
ID_TASK NUMERIC(10),
ID_EGE NUMERIC(10),
ATTACH_DATE DATETIME,
SOURCE NUMERIC(1),
FILE_NAME VARCHAR(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR(50),
SUBSEQUENCE VARCHAR(50),
CURRENT_VALUE NUMERIC(10));
CREATE TABLE WSI$WORDS
(ID NUMERIC(10),
CAPTION VARCHAR(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMERIC(10),
ID_PROCESS NUMERIC(10),
ID_TASK NUMERIC(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

*Script para base de datos en Oracle
CREATE TABLE WS$USERS
(ID NUMBER(10) PRIMARY KEY,
NIF VARCHAR2(10),
NAME VARCHAR2(50),
FULLNAME VARCHAR2(50),
EMAIL VARCHAR2(50),
FORM LONG RAW);
CREATE TABLE WS$PROCESSES
(ID NUMBER(10) PRIMARY KEY,
LABEL VARCHAR2(100),
TRAMITATION_STATUS VARCHAR2(100),
ID_PROCEDURE NUMBER(10),
ID_USER NUMBER(10),
STATUS NUMBER(1),
CREATE_DATE DATE,
START_DATE DATE,
END_DATE DATE);
CREATE TABLE WS$TASKS
(ID NUMBER(10) PRIMARY KEY,
ID_PROCESS NUMBER(10),
ID_EGE NUMBER(10),
ID_DEFINITION NUMBER(10),
CREATE_RECEIVE_DATE DATE,
SEND_RESPONSE_DATE DATE,
STATUS NUMBER(1),
CONTENT LONG RAW);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMBER(10) PRIMARY KEY,
SIGNATURE LONG RAW);
CREATE TABLE WS$FILES
(ID NUMBER(10),
ID_TASK NUMBER(10),
ID_EGE NUMBER(10),
ATTACH_DATE DATE,
SOURCE NUMBER(1),
FILE_NAME VARCHAR2(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR2(50),
SUBSEQUENCE VARCHAR2(50),
CURRENT_VALUE NUMBER(10));
CREATE TABLE WSI$WORDS
(ID NUMBER(10),
CAPTION VARCHAR2(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMBER(10),
ID_PROCESS NUMBER(10),
ID_TASK NUMBER(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

==Arrancar el Sistema de Tramitación Electrónica==
Para iniciar el Sistema de Tramitación Electrónica debemos iniciar una series de aplicaciones en un cierto orden. Las aplicaciones que debemos iniciar y como, se listan a continuación.
*'''XAMPP'''
Para iniciar el XAMPP, debemos ir a la ruta donde lo tenemos instalado, en este caso ''c:\xampp'' y ejecutar el archivo con nombre ''xampp-control.exe''.
*'''Servidor de Apache'''
Una vez abierto el panel de control del XAMPP, debemos hacer clic en el botón ''start'' para el Apache.
*'''Tomcat'''
Para iniciar el Tomcat, debemos ir a la ruta ''c:\xampp'' y ejecutar el archivo de procesos por lotes (.bat) con nombre ''tomcat_start.bat''.
*'''Servicio web del Sistema de Tramitación Electrónica'''
Para iniciar el servicio web, debemos ir a la ruta donde se instaló, para este ejemplo debemos ir a la carpeta tramitacion con ruta ''C:\STE\tramitacion'' y ejecutar el archivo de procesos por lotes con nombre ''lanzar.bat''.
El archivo ''lanzar.bat'' contiene el comando de consola que hay que ejecutar para iniciar el servicio web, este comando se compone por la ruta y el nombre del archivo ''Tramitacion_server.exe'' y el argumento que se le pasa al ejecutable, el cual es la ruta donde esta el archivo de configuración del servicio web. Para este ejemplo el archivo ''lanzar.bat'' contiene lo siguiente.
"c:\STE\tramitacion\Tramitacion_server.exe" "c:\STE\tramitacion\webservice.ini"

=¿Y ahora que?=
Una vez completados todos estos pasos, ya disponemos en nuestra maquina del Sistema de Tramitación Electrónica. A continuación ya podemos pasar a desarrollar en la plataforma egeasy, para hacer que el centro del que disponga haga uso del Sistema de Tramitación Electrónica. Le invito a seguir leyendo el siguiente artículo: [[Desarrollar con el STE]]

[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T10:43:12Z

Nmelian: /* Pasos a seguir */

__TOC__
=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat

=Pasos a seguir=
Para la instalación de la aplicación web del Sistema de Tramitación Electrónica, vamos a disponer de una instalación de la aplicación XAMPP, que nos proporciona de una forma rápida sencilla las aplicaciones requeridas para una puesta en marcha. Para que las explicaciones de los ficheros de configuración sean lo menos confuso posible, en este articulo vamos a instalar la aplicación XAMPP en ''C:\'', por lo tanto todas las rutas se explicaran de dicha ruta. Ademas de instalar la aplicación XAMPP, tenemos que instalar el servicio web, el cual lo vamos a instalar para mayor comodidad en ''C:\ste''. Así que todas las explicaciones parten de dicha ruta de instalación.

==Configurar el servidor web, Apache==
Para configurar el servidor Apache, debemos modificar el archivo de configuración, que esta en la ruta ''C:\xampp\apache\conf'' con el nombre de ''httpd.conf''. Al final de dicho fichero debemos poner lo siguiente:

ScriptAlias "/URLALIAS" "''PATHWEBSERVICE''"
<Directory "''PATHWEBSERVICE''">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

'''URLALIAS''': Es la URL que vamos a definir donde va a estar nuestro servicio web. Para este ejemplo usaremos ''tramitacion''.
 '''PATHWEBSERVICE''': Es la ruta física donde está desplegado el servicio web. Para este ejemplo, esa ruta es la siguiente: ''C:/STE/tramitacion/''.

Un ejemplo podría ser el siguiente:

ScriptAlias "/tramitacion" "C:/STE/tramitacion"
<Directory "C:/STE/tramitacion/">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

==Configurar el servicio web STE==
Para configurar el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ''webservice.ini'' que esta en la ruta ''C:\STE\tramitacion'', que para este ejemplo será donde esta instalado.

Al abrir el fichero ''webservice.ini'' encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SERVER_ADDRESS''' IP donde se publicará el servicio web.
*'''SERVER_PORT''': Puerto donde se publicará el servicio web.
*'''WS_IDENTIFIER''': Identificador del servicio web.
*'''WS_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''WS_DB_TYPE''': Nombre del tipo de base de datos que se usa para el servicio web.
*'''WS_DIRECTORY_DOCUMENTS''': Ruta donde se almacenan los documentos generados por la aplicación.
*'''WS_DIRECTORY_LOGS''': Ruta donde se localizan los logs del servicio web.
*'''WS_FILE_INVALID_WORDS''': Ruta del fichero donde están las palabras que no se van a indexar en la base de datos.
*'''TYPE_REGISTRATION''': Si esta etiqueta está presente, entonces en la aplicacón web los usuarios podrán registrarse libremente. Los valore que admite esta etiqueta es ''Free''.
*'''REGISTRATION_FORM''':Ruta y nombre del archivo xml que se usará para generar el formulario de registro en la aplicación web. Para este ejemplo usaremos el siguiente fichero ''C:\STE\registration.xml''.
*'''EGE_USER_RRC''': Identificador del usuario en la plataforma egeasy, con el que va a acceder la aplicación web a la plataforma. Para un correcto funcionamiento, debemos generar un usuario en la plataforma solo para esta aplicación web.
*'''EGE_CENTER_NAME''':Nombre del centro al que se le va a poner la aplicación web.
*'''EGE_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''EGE_DB_TYPE''': Nombre del tipo de base de datos que se usa para la plataforma egeasy.

*'''EGE_MODEL_DIRECTORY''': Ruta donde se localiza el modelo del centro de la plataforma egeasy.
*'''EGE_DOCUMENT_DIRECTORY''': Ruta donde se localizan la base documental de la plataforma egeasy.
*'''EGE_REGISTRY_DIRECTORY''': Ruta donde se localizan los registro de la plataforma egeasy.

Un ejemplo de un fichero de configuración, podría ser el siguiente:
SERVER_ADDRESS=10.22.144.178
SERVER_PORT=10000
WS_IDENTIFIER=WS_STE
WS_DB_CONNECTION_STRING=acecau@europa@acecau
WS_DB_TYPE=Oracle
WS_DIRECTORY_DOCUMENTS=C:\STE\Docs
WS_DIRECTORY_LOGS=C:\STE\Logs
WS_FILE_INVALID_WORDS=C:\STE\palabras.dat
TYPE_REGISTRATION=Free
REGISTRATION_FORM=C:\STE\registration.xml
EGE_USER_RRC=3825
EGE_CENTER_NAME=Acecau STE Oracle
EGE_DB_CONNECTION_STRING=acecau@europa@acecau
EGE_DB_TYPE=Oracle
EGE_MODEL_DIRECTORY=S:\Entornos 2002\Banzai\Modelos\ACECAU STEMod
EGE_DOCUMENT_DIRECTORY=S:\Entornos 2002\Banzai\Documentos\AcecauSTEDoc
EGE_REGISTRY_DIRECTORY=S:\Entornos 2002\Banzai\Registro\acecausteReg

==Configurar la aplicación web STE==

Para configurar la aplicación web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\xampp\tomcat\webapps\ste\WebContent\WEB-INF\classes\org\siani\ste\configuration, que para este ejemplo será donde esta instalado.

Al abrir el fichero ste.conf encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SITE_DIR''': Ruta donde se encuentra instalada la aplicación web.
*'''SITE_URL''': URL donde se encuentra la aplicación web.
*'''LOG_DIR''': Ruta donde se encuentran los logs de la aplicación web.
*'''DATA_DIR''': Ruta donde se encuentra los datos variables de la aplicación web.
*'''TEMPLATES_DIR''': Ruta donde se encuentra las plantillas html de visualización.
*'''TEMP_DIR''': Ruta donde se encuentra los archivos subidos por los usuarios temporalmente.
*'''SITE_DATA_DEFINITIONS_DIR''': Ruta donde se encuentran las definiciones datos personalizados.
*'''SITE_FORMS_DIR''': Ruta donde se encuentra las vistas personalizadas de los trámites.
*'''SITE_PORT''': Puerto que usa la aplicación web.
*'''API_URL''': URL del servlet, llamado API que usa la aplicación web.
*'''SITE_IMAGES_DIR''': Ruta donde se encuentran las imagenes de la aplicación web.
*'''SITE_IMAGES_URL''': URL donde se encuentran las imagenes de la aplicación web.
*'''SITE_JAVASCRIPT_DIR''': Ruta donde se encuentran el javascript de la aplicación web.
*'''SITE_JAVASCRIPT_URL''': URL donde se encuentran el javascript de la aplicación web.
*'''SITE_STYLES_DIR''': Ruta donde se encuentran los estilos CSS de la aplicación web.
*'''SITE_STYLES_URL''': URL donde se encuentran los estilos CSS de la aplicación web.
*'''WS_SOAP_URL''': URL donde se encuentra el servicio web del STE.
*'''LANG_DIR''': Ruta donde se encuentra los archivos de idioma.
*'''EN = en''': Se define el lenguaje Ingles.
*'''ES = es''': Se define el lenguaje Español.
*'''DEFAULT_LANGUAGE''': Indica que lenguaje se va a usar por defecto en la aplicación.

Un ejemplo del fichero de configuración es:

// DIRECTORIES
SITE_DIR = c:/xampp/tomcat/webapps/ste/WebContent
SITE_URL = http://ste
LOG_DIR = C:/xampp/tomcat/webapps/ste/logs
DATA_DIR = C:/xampp/tomcat/webapps/ste/data
TEMPLATES_DIR = C:/xampp/tomcat/webapps/ste/templates
TEMP_DIR = C:/xampp/tomcat/webapps/ste/temp
SITE_PORT = 80
SITE_DATA_DEFINITIONS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions
SITE_FORMS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions/forms
API_URL = http://ste/api
SITE_IMAGES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/images
SITE_IMAGES_URL = http://ste/images
SITE_JAVASCRIPT_DIR = c:/xampp/tomcat/webapps/ste/WebContent/javascript
SITE_JAVASCRIPT_URL = http://ste/javascript
SITE_STYLES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/styles
SITE_STYLES_URL = http://ste/styles
WS_SOAP_URL = http://ste/tramitacion/tramitacion_ws_cgi.exe/soap/IEgeWebService
LANG_DIR = C:/xampp/tomcat/webapps/ste/languages
// LANGUAGES
EN = en
ES = es
DEFAULT_LANGUAGE = es

==Configurar el DNS==
Debemos preparar nuestra maquina, para indicar mediante un nombre de dominio donde esta situado el Sistema de Tramitación Electrónica, para nuestro caso, el sistema esta instalado en local. Por lo tanto solo debemos ir a la ruta de nuestro equipo donde está el fichero ''hosts'', que esta en ''C:\WINDOWS\system32\drivers\etc\'' e introducir lo siguiente:

127.0.0.1 ste

==Creación de tablas en la base de datos==
Para la implantación del Sistema de Tramitación Electrónica, se deben crear unas cuantas tablas y indices en la base de datos. Par este ejemplo vamos a utilizar la misma base de datos y esquema donde tenemos implantada ya la plataforma egeasy. A continuación se listaran los script con las sentencias SQL que hay que ejecutar en la base de datos, para generar todo lo necesario para el Sistema de Tramitación Electrónica. Disponemos de los script tanto para SQL-Server como para Oracle.

*Script para base de datos en SQL-Server
CREATE TABLE WS$USERS
(ID NUMERIC(10) PRIMARY KEY,
NIF VARCHAR(10),
NAME VARCHAR(50),
FULLNAME VARCHAR(50),
EMAIL VARCHAR(50),
FORM IMAGE);
CREATE TABLE WS$PROCESSES
(ID NUMERIC(10) PRIMARY KEY,
LABEL VARCHAR(100),
TRAMITATION_STATUS VARCHAR(100),
ID_PROCEDURE NUMERIC(10),
ID_USER NUMERIC(10),
STATUS NUMERIC(1),
CREATE_DATE DATETIME,
START_DATE DATETIME,
END_DATE DATETIME);
CREATE TABLE WS$TASKS
(ID NUMERIC(10) PRIMARY KEY,
ID_PROCESS NUMERIC(10),
ID_EGE NUMERIC(10),
ID_DEFINITION NUMERIC(10),
CREATE_RECEIVE_DATE DATETIME,
SEND_RESPONSE_DATE DATETIME,
STATUS NUMERIC(1),
CONTENT IMAGE);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMERIC(10) PRIMARY KEY,
SIGNATURE IMAGE);
CREATE TABLE WS$FILES
(ID NUMERIC(10),
ID_TASK NUMERIC(10),
ID_EGE NUMERIC(10),
ATTACH_DATE DATETIME,
SOURCE NUMERIC(1),
FILE_NAME VARCHAR(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR(50),
SUBSEQUENCE VARCHAR(50),
CURRENT_VALUE NUMERIC(10));
CREATE TABLE WSI$WORDS
(ID NUMERIC(10),
CAPTION VARCHAR(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMERIC(10),
ID_PROCESS NUMERIC(10),
ID_TASK NUMERIC(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

*Script para base de datos en Oracle
CREATE TABLE WS$USERS
(ID NUMBER(10) PRIMARY KEY,
NIF VARCHAR2(10),
NAME VARCHAR2(50),
FULLNAME VARCHAR2(50),
EMAIL VARCHAR2(50),
FORM LONG RAW);
CREATE TABLE WS$PROCESSES
(ID NUMBER(10) PRIMARY KEY,
LABEL VARCHAR2(100),
TRAMITATION_STATUS VARCHAR2(100),
ID_PROCEDURE NUMBER(10),
ID_USER NUMBER(10),
STATUS NUMBER(1),
CREATE_DATE DATE,
START_DATE DATE,
END_DATE DATE);
CREATE TABLE WS$TASKS
(ID NUMBER(10) PRIMARY KEY,
ID_PROCESS NUMBER(10),
ID_EGE NUMBER(10),
ID_DEFINITION NUMBER(10),
CREATE_RECEIVE_DATE DATE,
SEND_RESPONSE_DATE DATE,
STATUS NUMBER(1),
CONTENT LONG RAW);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMBER(10) PRIMARY KEY,
SIGNATURE LONG RAW);
CREATE TABLE WS$FILES
(ID NUMBER(10),
ID_TASK NUMBER(10),
ID_EGE NUMBER(10),
ATTACH_DATE DATE,
SOURCE NUMBER(1),
FILE_NAME VARCHAR2(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR2(50),
SUBSEQUENCE VARCHAR2(50),
CURRENT_VALUE NUMBER(10));
CREATE TABLE WSI$WORDS
(ID NUMBER(10),
CAPTION VARCHAR2(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMBER(10),
ID_PROCESS NUMBER(10),
ID_TASK NUMBER(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

==Arrancar el Sistema de Tramitación Electrónica==

=¿Y ahora que?=
Una vez completados todos estos pasos, ya disponemos en nuestra maquina del Sistema de Tramitación Electrónica. A continuación ya podemos pasar a desarrollar en la plataforma egeasy, para hacer que el centro del que disponga haga uso del Sistema de Tramitación Electrónica. Le invito a seguir leyendo el siguiente artículo: [[Desarrollar con el STE]]

[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T10:41:39Z

Nmelian: /* Pasos a seguir */

__TOC__
=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat

=Pasos a seguir=
Para la instalación de la aplicación web del Sistema de Tramitación Electrónica, vamos a disponer de una instalación de la aplicación XAMPP, que nos proporciona de una forma rápida sencilla las aplicaciones requeridas para una puesta en marcha. Para que las explicaciones de los ficheros de configuración sean lo menos confuso posible, en este articulo vamos a instalar la aplicación XAMPP en ''C:\'', por lo tanto todas las rutas se explicaran de dicha ruta. Ademas de instalar la aplicación XAMPP, tenemos que instalar el servicio web, el cual lo vamos a instalar para mayor comodidad en ''C:\ste''. Así que todas las explicaciones parten de dicha ruta de instalación.

==Configurar el servidor web, Apache==
Para configurar el servidor Apache, debemos modificar el archivo de configuración, que esta en la ruta ''C:\xampp\apache\conf'' con el nombre de ''httpd.conf''. Al final de dicho fichero debemos poner lo siguiente:

ScriptAlias "/URLALIAS" "''PATHWEBSERVICE''"
<Directory "''PATHWEBSERVICE''">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

'''URLALIAS''': Es la URL que vamos a definir donde va a estar nuestro servicio web. Para este ejemplo usaremos ''tramitacion''.
 '''PATHWEBSERVICE''': Es la ruta física donde está desplegado el servicio web. Para este ejemplo, esa ruta es la siguiente: ''C:/STE/tramitacion/''.

Un ejemplo podría ser el siguiente:

ScriptAlias "/tramitacion" "C:/STE/tramitacion"
<Directory "C:/STE/tramitacion/">
AllowOverride None
Options ExecCGI
Order allow,deny
Allow from all
</Directory>

==Configurar el servicio web STE==
Para configurar el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ''webservice.ini'' que esta en la ruta ''C:\STE\tramitacion'', que para este ejemplo será donde esta instalado.

Al abrir el fichero ''webservice.ini'' encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SERVER_ADDRESS''' IP donde se publicará el servicio web.
*'''SERVER_PORT''': Puerto donde se publicará el servicio web.
*'''WS_IDENTIFIER''': Identificador del servicio web.
*'''WS_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''WS_DB_TYPE''': Nombre del tipo de base de datos que se usa para el servicio web.
*'''WS_DIRECTORY_DOCUMENTS''': Ruta donde se almacenan los documentos generados por la aplicación.
*'''WS_DIRECTORY_LOGS''': Ruta donde se localizan los logs del servicio web.
*'''WS_FILE_INVALID_WORDS''': Ruta del fichero donde están las palabras que no se van a indexar en la base de datos.
*'''TYPE_REGISTRATION''': Si esta etiqueta está presente, entonces en la aplicacón web los usuarios podrán registrarse libremente. Los valore que admite esta etiqueta es ''Free''.
*'''REGISTRATION_FORM''':Ruta y nombre del archivo xml que se usará para generar el formulario de registro en la aplicación web. Para este ejemplo usaremos el siguiente fichero ''C:\STE\registration.xml''.
*'''EGE_USER_RRC''': Identificador del usuario en la plataforma egeasy, con el que va a acceder la aplicación web a la plataforma. Para un correcto funcionamiento, debemos generar un usuario en la plataforma solo para esta aplicación web.
*'''EGE_CENTER_NAME''':Nombre del centro al que se le va a poner la aplicación web.
*'''EGE_DB_CONNECTION_STRING''': Cadena de conexión a la base de datos, donde se tenemos que poner el nombre de usuario de la base de datos, seguido de una @, a continuación indicamos la ruta de la base de datos, seguido de una @ y por ultimo la contraseña para acceder a la base de datos. En resumen: NOMBREUSUARIO@DIRECCIONBD@CONTRASEÑA
*'''EGE_DB_TYPE''': Nombre del tipo de base de datos que se usa para la plataforma egeasy.

*'''EGE_MODEL_DIRECTORY''': Ruta donde se localiza el modelo del centro de la plataforma egeasy.
*'''EGE_DOCUMENT_DIRECTORY''': Ruta donde se localizan la base documental de la plataforma egeasy.
*'''EGE_REGISTRY_DIRECTORY''': Ruta donde se localizan los registro de la plataforma egeasy.

Un ejemplo de un fichero de configuración, podría ser el siguiente:
SERVER_ADDRESS=10.22.144.178
SERVER_PORT=10000
WS_IDENTIFIER=WS_STE
WS_DB_CONNECTION_STRING=acecau@europa@acecau
WS_DB_TYPE=Oracle
WS_DIRECTORY_DOCUMENTS=C:\STE\Docs
WS_DIRECTORY_LOGS=C:\STE\Logs
WS_FILE_INVALID_WORDS=C:\STE\palabras.dat
TYPE_REGISTRATION=Free
REGISTRATION_FORM=C:\STE\registration.xml
EGE_USER_RRC=3825
EGE_CENTER_NAME=Acecau STE Oracle
EGE_DB_CONNECTION_STRING=acecau@europa@acecau
EGE_DB_TYPE=Oracle
EGE_MODEL_DIRECTORY=S:\Entornos 2002\Banzai\Modelos\ACECAU STEMod
EGE_DOCUMENT_DIRECTORY=S:\Entornos 2002\Banzai\Documentos\AcecauSTEDoc
EGE_REGISTRY_DIRECTORY=S:\Entornos 2002\Banzai\Registro\acecausteReg

==Configurar la aplicación web STE==

Para configurar la aplicación web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\xampp\tomcat\webapps\ste\WebContent\WEB-INF\classes\org\siani\ste\configuration, que para este ejemplo será donde esta instalado.

Al abrir el fichero ste.conf encontramos las siguiente etiquetas que debemos configurar. Ahora vamos a pasar a explicar detalladamente que son cada una de las etiquetas de este archivo de configuración del servicio web.

*'''SITE_DIR''': Ruta donde se encuentra instalada la aplicación web.
*'''SITE_URL''': URL donde se encuentra la aplicación web.
*'''LOG_DIR''': Ruta donde se encuentran los logs de la aplicación web.
*'''DATA_DIR''': Ruta donde se encuentra los datos variables de la aplicación web.
*'''TEMPLATES_DIR''': Ruta donde se encuentra las plantillas html de visualización.
*'''TEMP_DIR''': Ruta donde se encuentra los archivos subidos por los usuarios temporalmente.
*'''SITE_DATA_DEFINITIONS_DIR''': Ruta donde se encuentran las definiciones datos personalizados.
*'''SITE_FORMS_DIR''': Ruta donde se encuentra las vistas personalizadas de los trámites.
*'''SITE_PORT''': Puerto que usa la aplicación web.
*'''API_URL''': URL del servlet, llamado API que usa la aplicación web.
*'''SITE_IMAGES_DIR''': Ruta donde se encuentran las imagenes de la aplicación web.
*'''SITE_IMAGES_URL''': URL donde se encuentran las imagenes de la aplicación web.
*'''SITE_JAVASCRIPT_DIR''': Ruta donde se encuentran el javascript de la aplicación web.
*'''SITE_JAVASCRIPT_URL''': URL donde se encuentran el javascript de la aplicación web.
*'''SITE_STYLES_DIR''': Ruta donde se encuentran los estilos CSS de la aplicación web.
*'''SITE_STYLES_URL''': URL donde se encuentran los estilos CSS de la aplicación web.
*'''WS_SOAP_URL''': URL donde se encuentra el servicio web del STE.
*'''LANG_DIR''': Ruta donde se encuentra los archivos de idioma.
*'''EN = en''': Se define el lenguaje Ingles.
*'''ES = es''': Se define el lenguaje Español.
*'''DEFAULT_LANGUAGE''': Indica que lenguaje se va a usar por defecto en la aplicación.

Un ejemplo del fichero de configuración es:

// DIRECTORIES
SITE_DIR = c:/xampp/tomcat/webapps/ste/WebContent
SITE_URL = http://ste
LOG_DIR = C:/xampp/tomcat/webapps/ste/logs
DATA_DIR = C:/xampp/tomcat/webapps/ste/data
TEMPLATES_DIR = C:/xampp/tomcat/webapps/ste/templates
TEMP_DIR = C:/xampp/tomcat/webapps/ste/temp
SITE_PORT = 80
SITE_DATA_DEFINITIONS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions
SITE_FORMS_DIR = C:/xampp/tomcat/webapps/ste/data/definitions/forms
API_URL = http://ste/api
SITE_IMAGES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/images
SITE_IMAGES_URL = http://ste/images
SITE_JAVASCRIPT_DIR = c:/xampp/tomcat/webapps/ste/WebContent/javascript
SITE_JAVASCRIPT_URL = http://ste/javascript
SITE_STYLES_DIR = c:/xampp/tomcat/webapps/ste/WebContent/styles
SITE_STYLES_URL = http://ste/styles
WS_SOAP_URL = http://ste/tramitacion/tramitacion_ws_cgi.exe/soap/IEgeWebService
LANG_DIR = C:/xampp/tomcat/webapps/ste/languages
// LANGUAGES
EN = en
ES = es
DEFAULT_LANGUAGE = es

==Configurar el DNS==
Debemos preparar nuestra maquina, para indicar mediante un nombre de dominio donde esta situado el Sistema de Tramitación Electrónica, para nuestro caso, el sistema esta instalado en local. Por lo tanto solo debemos ir a la ruta de nuestro equipo donde está el fichero ''hosts'', que esta en ''C:\WINDOWS\system32\drivers\etc\'' e introducir lo siguiente:

127.0.0.1 ste

==Creación de tablas en la base de datos==
Para la implantación del Sistema de Tramitación Electrónica, se deben crear unas cuantas tablas y indices en la base de datos. Par este ejemplo vamos a utilizar la misma base de datos y esquema donde tenemos implantada ya la plataforma egeasy. A continuación se listaran los script con las sentencias SQL que hay que ejecutar en la base de datos, para generar todo lo necesario para el Sistema de Tramitación Electrónica. Disponemos de los script tanto para SQL-Server como para Oracle.

*Script para base de datos en SQL-Server
CREATE TABLE WS$USERS
(ID NUMERIC(10) PRIMARY KEY,
NIF VARCHAR(10),
NAME VARCHAR(50),
FULLNAME VARCHAR(50),
EMAIL VARCHAR(50),
FORM IMAGE);
CREATE TABLE WS$PROCESSES
(ID NUMERIC(10) PRIMARY KEY,
LABEL VARCHAR(100),
TRAMITATION_STATUS VARCHAR(100),
ID_PROCEDURE NUMERIC(10),
ID_USER NUMERIC(10),
STATUS NUMERIC(1),
CREATE_DATE DATETIME,
START_DATE DATETIME,
END_DATE DATETIME);
CREATE TABLE WS$TASKS
(ID NUMERIC(10) PRIMARY KEY,
ID_PROCESS NUMERIC(10),
ID_EGE NUMERIC(10),
ID_DEFINITION NUMERIC(10),
CREATE_RECEIVE_DATE DATETIME,
SEND_RESPONSE_DATE DATETIME,
STATUS NUMERIC(1),
CONTENT IMAGE);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMERIC(10) PRIMARY KEY,
SIGNATURE IMAGE);
CREATE TABLE WS$FILES
(ID NUMERIC(10),
ID_TASK NUMERIC(10),
ID_EGE NUMERIC(10),
ATTACH_DATE DATETIME,
SOURCE NUMERIC(1),
FILE_NAME VARCHAR(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR(50),
SUBSEQUENCE VARCHAR(50),
CURRENT_VALUE NUMERIC(10));
CREATE TABLE WSI$WORDS
(ID NUMERIC(10),
CAPTION VARCHAR(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMERIC(10),
ID_PROCESS NUMERIC(10),
ID_TASK NUMERIC(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

*Script para base de datos en Oracle
CREATE TABLE WS$USERS
(ID NUMBER(10) PRIMARY KEY,
NIF VARCHAR2(10),
NAME VARCHAR2(50),
FULLNAME VARCHAR2(50),
EMAIL VARCHAR2(50),
FORM LONG RAW);
CREATE TABLE WS$PROCESSES
(ID NUMBER(10) PRIMARY KEY,
LABEL VARCHAR2(100),
TRAMITATION_STATUS VARCHAR2(100),
ID_PROCEDURE NUMBER(10),
ID_USER NUMBER(10),
STATUS NUMBER(1),
CREATE_DATE DATE,
START_DATE DATE,
END_DATE DATE);
CREATE TABLE WS$TASKS
(ID NUMBER(10) PRIMARY KEY,
ID_PROCESS NUMBER(10),
ID_EGE NUMBER(10),
ID_DEFINITION NUMBER(10),
CREATE_RECEIVE_DATE DATE,
SEND_RESPONSE_DATE DATE,
STATUS NUMBER(1),
CONTENT LONG RAW);
CREATE TABLE WS$TASK_SIGNATURES
(ID NUMBER(10) PRIMARY KEY,
SIGNATURE LONG RAW);
CREATE TABLE WS$FILES
(ID NUMBER(10),
ID_TASK NUMBER(10),
ID_EGE NUMBER(10),
ATTACH_DATE DATE,
SOURCE NUMBER(1),
FILE_NAME VARCHAR2(50));
CREATE TABLE EG$SEQUENCES
(NAME VARCHAR2(50),
SUBSEQUENCE VARCHAR2(50),
CURRENT_VALUE NUMBER(10));
CREATE TABLE WSI$WORDS
(ID NUMBER(10),
CAPTION VARCHAR2(15));
CREATE INDEX IEGI$WORDS#CAP ON WSI$WORDS (CAPTION);
CREATE TABLE WSI$INDEX
(ID_WORD NUMBER(10),
ID_PROCESS NUMBER(10),
ID_TASK NUMBER(10));
CREATE INDEX IEGI$INDEX#WRD ON WSI$INDEX(ID_WORD);

=¿Y ahora que?=
Una vez completados todos estos pasos, ya disponemos en nuestra maquina del Sistema de Tramitación Electrónica. A continuación ya podemos pasar a desarrollar en la plataforma egeasy, para hacer que el centro del que disponga haga uso del Sistema de Tramitación Electrónica. Le invito a seguir leyendo el siguiente artículo: [[Desarrollar con el STE]]

[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T10:16:13Z

Nmelian: /* Pasos a seguir */

Personalización avanzada del STE

2009-06-17T10:03:18Z

Nmelian:

__TOC__

[[Category:Tramitación electrónica]]

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T09:51:19Z

Nmelian: /* Configurar el DNS */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T09:50:38Z

Nmelian: /* Configurar el servicio web STE */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T09:49:22Z

Nmelian: /* Pasos a seguir */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T09:39:26Z

Nmelian: /* Requisitos */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T09:38:54Z

Nmelian: /* Pasos a seguir */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T09:35:15Z

Nmelian: /* Configurar la aplicación web STE */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T09:33:36Z

Nmelian: /* Pasos a seguir */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-17T09:02:20Z

Nmelian: /* Configurar la aplicación web STE */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-16T14:10:37Z

Nmelian: /* Pasos a seguir */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-16T13:19:04Z

Nmelian: /* Pasos a seguir */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-16T12:47:23Z

Nmelian: /* Pasos a seguir */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-16T12:44:39Z

Nmelian: /* Pasos a seguir */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-16T12:43:46Z

Nmelian: /* Pasos a seguir */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-16T12:26:25Z

Nmelian: /* Pasos a seguir */

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-16T12:09:11Z

Nmelian:

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-16T12:08:48Z

Nmelian:

Cómo integrar el Sistema de Tramitación Electrónica en egeasy

2009-06-16T12:08:16Z

Nmelian:

=Introducción=
Este manual sirve para explicar todos los pasos que hay que hacer para integrar el Sistema de Tramitación Electrónica en la plataforma egeasy. Esta explicación no partirá de cero, sino que se supone que ya se tiene un instalada la plataforma egeasy, con un centro configurado y desarrollado para su usu cotidiano.

=Requisitos=
Para una correcta integración el Sistema de Tramitación Electrónica vamos a necesitar:
*Servidor web (Apache)
*Servidor de base de datos
*Servidor de Tomcat
=Pasos a seguir=
1º Debemos copiar

Desarrollar con el STE

2009-06-16T10:55:39Z

Nmelian: /* Atributos especiales para los campos de ODL */

__TOC__
=¿Que es un trámite?=
Un trámite es la definición del conjunto de tareas pertenecientes al ''workflow'', que van a interactuar con la aplicación web STE. Los trámites definidos están orientados a ser iniciados por el usuario desde la aplicación web, para que a continuación se inicie un proceso de ''workflow'' programado en ODL para la plataforma egeasy.
==Como se define un trámite==
Para definir un trámite tenemos que indicar el nombre del trámite y declararlo como tipo trámite. La sintaxis de un trámite sería el siguiente.

[Nombre del trámite] es tramite
-ATRIBUTOS
incluye TAREA
.
.
.
incluye TAREA
fin
==Atributos de un trámite==
Los atributos que podemos declarar para un trámite son los siguientes:
*'''descripcion''': Proporcionar un texto descriptivo sobre el trámite que se muestra en la interfaz web al crear el trámite.
*'''grupo''': Indica a que grupo de declaraciones pertenece el trámite.
*'''habitacion''': Indica en que habitación de nuestro sistema de información queremos que este disponible el trámite, para su realización.
*'''estado''': Indica que tabla y columna de una exportación va a almacenar el estado de un trámite.

==La clausula incluye==
Dentro de la definición del trámite, debemos especificar cuales son las tareas del ''wordflow'' que queremos que interactuen con el STE, para ello disponemos de la clausula '''incluye'''. Al utilizarla debemos especificar a continuación el nombre de la tarea e indicar una serie de atributos para especificar varios aspectos sobre el comportamiento de la tarea.

===Atributos de incluye===
Los atributos aplicables a las tareas que incluimos en un trámite pueden variar dependiendo del valor del atributo ''tipo'', por ejemplo los atributos de respuesta, solo son aplicables a las tareas con el valor en el atributo tipo igual a REQUERIMIENTO. Dicho esto, a continuación pasamos a listar los distintos atributos aplicables a la clausula incluye, que son los siguientes:

*'''Etiqueta''': Atributo que permite establecer el nombre que va a tener la tarea en la aplicación web del STE.

*'''Tipo''': Atributo que indica que tipo de comportamiento que va a tener la tarea. Los distintos valores que acepta este atributo son: INICIO, REQUERIMIENTO, NOTIFICACION y ENVIO_DOCUMENTACION.

*'''respuesta.etiqueta''': Atributo que indica que nombre va a tener la tarea respuesta correspondiente

*'''respuesta.descripcion''': Atributo para indicar una descripción sobre la tarea respuesta.

*'''respuesta.formulario''': Atributo para indicar el nombre del formulario, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, que se va a mostrar en la tarea de respuesta.

*'''respuesta.clasificador''': Atributo para indicar el nombre del clasificador, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, donde se van a guardar los documentos que se pueden adjuntar a una tarea respuesta, perteneciente a una tarea de tipo REQUERIMIENTO.

===Diferentes tipos de tareas===
En la aplicación web STE, una misma tarea de nuestro sistema de información se puede comportar de diferentes maneras, dependiendo de que valor tenga el atributo ''tipo'' al incluir una tarea al trámite.

'''Tareas de INICIO'''
Es aquella tarea que indica cual es la tarea que va a ser el inicio del trámite. En un trámite solo puede haber una tarea de tipo inicio. Esta tarea debe ser definida íntegramente como un proceso en ODL.

incluye [Tramitación de solicitud de becas]
-{{AT|Tipo}}=INICIO;
-{{AT|Etiqueta}}='Tramitación de solicitud de becas universitarias';

'''Tareas de REQUERIMIENTO'''
Son aquellas tareas donde ademas de mostrar información, queremos dar al usuario la posibilidad de responder a la tarea mostrada para rellenar un formulario o adjuntar alguna documentación requerida.

incluye [Esperar respuesta de requerimiento de documentación]
-{{AT|Tipo}}=REQUERIMIENTO;
-{{AT|Etiqueta}}='Respuesta al requerimiento de solicitud de becas universitarias';
-{{AT|respuesta.etiqueta}} = {{STR|"Responder al requerimiento"}};
-{{AT|respuesta.descripcion}} = {{STR|"Adjunte todo lo solicitado en el documento enviado"}};
-{{AT|respuesta.formulario}} = [Respuesta];
-{{AT|respuesta.clasificador}} = [Documentos adjuntos];

'''Tareas de NOTIFICACION'''
Son aquellas tareas donde solo se le va a permitir al usuario del STE observar la información que ha sido mandada desde la plataforma egeasy, donde no podrá ni enviar información, ni modificar la información mandada. Este tipo de tareas suele estar reservados para aquellos datos que son de notificación, como las resoluciones.

incluye [Notificar resolución de la solicitud de beca universitaria]
-{{AT|Tipo}}=NOTIFICACION;
-{{AT|Etiqueta}}='Darse por notificado de la resolución de la solicitud de beca universitaria';

'''Tareas de ENVIO_DOCUMENTACION'''
Son aquellas tareas fuera del ''workflow'' que permiten al usuario de la aplicación web STE enviar documentación. Este tipo de tareas se pueden iniciar en cualquier momento durante la vida del trámite.

incluye [Registrar aporte de documentación al trámite]
-{{AT|Tipo}}=ENVIO_DOCUMENTACION;
-{{AT|Etiqueta}}='Aportar documentación adicional al trámite';

=Colecciones=
Para el desarrollo correcto de los tramites en la aplicación web STE, debemos crear al menos una colección para almacenar los contenedores que se crean al iniciar un trámite. Como al definir un tramite, su ''main target'' tiene que ser el contenedor que se mostrará en la web para que el usuario introduzca los datos iniciales para comenzar el ''workflow'' asociado a un trámite y no un expediente como se suele hacer cuando programamos un sistema de información en egeasy, tendremos que crearnos una colección (Véase [[Colecciones]]) para almacenar inicialmente los contenedores creados por la aplicación STE al iniciar un trámite, para luego posteriormente mover ese contenedor a su lugar dentro de alguna colección dentro de un expediente.

=Estado de un trámite=
Los trámites en la aplicación web STE, tienen estado. El estado de un trámite acabado de iniciar pero no enviado, tiene el valor de ''borrador''. Una vez enviado su primera tarea del trámite, este pasa a tener el valor de ''En trámite''. Por último cuando el trámite ha finalizado en la plataforma egeasy, el trámite pasa a tener el estado de ''finalizado''. Estos valores comentados para el estado de un trámite, es el comportamiento por defecto de la aplicación web STE. Si queremos cambiar el estado de un trámite debemos hacerlo mediante el atributo '''estado''' y su mecanismo para controlarlo, el cual vamos a proceder a explicarlo a continuación.

Para poder modificar el estado de un tramite durante la vida del ''workflow'' asociado al trámite, debemos crearnos un campo en el contenedor que es ''maintarget'' del ''workflow''. Una vez creado ese campo, debemos hacer una exportación de ese campo en alguna colección de nuestra elección. Si hay alguna duda sobre como crear una exportación, véase [[Exportaciones]]. Con la exportación del campo creada, debemos poner en el atributo '''estado''' del trámite, una ristra con el nombre de la tabla en la base de datos seguida de un punto y a continuación el nombre de la columna que representa el campo en la exportación. Para que quede mas claro, vamos a ver un ejemplo:

Esto seria un ejemplo de la exportación creada, donde tenemos un campo llamado en ODL [Estado tramite], el cual se exporta a la tabla de nombre TR$SOLICITUD_TRAMITACION y en la columna ESTADO_TRAMITE.

[EP::Solicitudes de tramitación electrónica] {{PR|es}} exportacion
-{{AT|nombre_tabla}} = {{STR|"TR$SOLICITUD_TRAMITACION"}};
-{{AT|universo}} = [Solicitud de tramitación electrónica para acreditación del profesorado];
{{PR|columna}} [Denominación/Apellidos y nombre]
-{{AT|columna_bd.nombre}} = {{STR|"DENOMINACION"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} =[Datos generales].[Denominación/Apellidos y nombre];
{{PR|columna}} [C.I.F./N.I.F.]
-{{AT|columna_bd.nombre}} = {{STR|"CIF_NIF"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[C.I.F./N.I.F.];
{{PR|columna}} [Estado tramite]
-{{AT|columna_bd.nombre}} = {{STR|"ESTADO_TRAMITE"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[Estado tramite];
{{PR|fin}}

A continuación un ejemplo de como se declararía un trámite utilizando el atributo '''estado'''.

[Trámite de Acreditación del profesorado] {{PR|es}} tramite
-{{AT|descripcion}}='Procedimiento de tramitación para la aceditación del profesorado para la ACECAU';
-{{AT|grupo}}='Trámites Acecau';
-{{AT|Habitacion}}=[Oficina de evaluación del profesorado];
-{{AT|estado}}={{STR|"TR$SOLTRAMI_ACRE_PROF.ESTADO_TRAMITE"}};

Una vez declarado el atributo estado en el trámite, ya podemos proceder a modificar el estado de un trámite mediante código de método, del lenguaje ODL. Para ello solo debemos acceder al campo mediante código ODL, al campo que representa el estado en el contenedor que es ''maintarget'' del ''workflow'' asociado al trámite y asignarle el valor deseado que queremos que se muestre en la aplicación web del STE.

NOTA: PONER EJEMPLO DE UN METODO ASIGNADOLE UN VALOR AL CAMPO ESTADO

=Atributos especiales para los campos de ODL=
Junto con la aplicación web STE disponemos para el lenguaje ODL, de unos atributos especiales aplicables a la definición de componentes para poder definir ciertos aspectos del comportamiento de los componentes que interactuan con la aplicación web STE. A continuación listaremos y definiremos los atributos que ha añadido el STE al lenguage ODL.

'''tramitacion.visible'''

Atributo que permite ocultar un campo para que no se visualice en la aplicación web del STE pero si en la plataforma egeasy. Este atributo es aplicable a todos los campos de ODL. El valor por defecto para este atributo es verdadero.

'''tramitacion.requerida'''

Atributo que permite especificar que campos son de obligada cumplimentación por parte del usuario
para la aplicación web del STE. El valor por defecto para este atributo es falso. Este atributo se puede usar en combinación con las validaciones de ODL para indicar como se debe cumplimentar un campo.

'''tramitacion.valor'''

Atributo que permite establecer el valor del campo al que se le aplica el atributo.

'''tramitacion.editable'''

Atributo que permite indicar si el campo es editable o no. El valor por defecto para este atributo es verdadero.


=Formulario de registro de usuarios=
En la aplicación web STE, podemos crear a nuestra medida un formulario de registro de usuarios, donde podemos definir los campos que queremos que el usuario cumplimente al darse de alta para poder utilizar la aplicación web STE. El fichero donde se definen los campos del regostro es un fichero XML y se llama '''registration.xml'''.

A continuación mostramos un ejemplo de un fichero de registro.
<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
<field_value Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>
<field_value Field_Name="Teléfono 1" Field_Type="ftString">
</field_value>
<field_value Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
<field_value Field_Name="Dirección" Field_Type="ftString">
</field_value>
<field_value Field_Name="Código postal" Field_Type="ftString">
</field_value>
<field_value Field_Name="Localidad" Field_Type="ftString">
</field_value>
<field_value Field_Name="Provincia" Field_Type="ftString">
</field_value>
<field_value Field_Name="Fax" Field_Type="ftString">
</field_value>
</registration_form>

[[Category:Tramitación electrónica]]

Desarrollar con el STE

2009-06-16T09:41:40Z

Nmelian:

__TOC__
=¿Que es un trámite?=
Un trámite es la definición del conjunto de tareas pertenecientes al ''workflow'', que van a interactuar con la aplicación web STE. Los trámites definidos están orientados a ser iniciados por el usuario desde la aplicación web, para que a continuación se inicie un proceso de ''workflow'' programado en ODL para la plataforma egeasy.
==Como se define un trámite==
Para definir un trámite tenemos que indicar el nombre del trámite y declararlo como tipo trámite. La sintaxis de un trámite sería el siguiente.

[Nombre del trámite] es tramite
-ATRIBUTOS
incluye TAREA
.
.
.
incluye TAREA
fin
==Atributos de un trámite==
Los atributos que podemos declarar para un trámite son los siguientes:
*'''descripcion''': Proporcionar un texto descriptivo sobre el trámite que se muestra en la interfaz web al crear el trámite.
*'''grupo''': Indica a que grupo de declaraciones pertenece el trámite.
*'''habitacion''': Indica en que habitación de nuestro sistema de información queremos que este disponible el trámite, para su realización.
*'''estado''': Indica que tabla y columna de una exportación va a almacenar el estado de un trámite.

==La clausula incluye==
Dentro de la definición del trámite, debemos especificar cuales son las tareas del ''wordflow'' que queremos que interactuen con el STE, para ello disponemos de la clausula '''incluye'''. Al utilizarla debemos especificar a continuación el nombre de la tarea e indicar una serie de atributos para especificar varios aspectos sobre el comportamiento de la tarea.

===Atributos de incluye===
Los atributos aplicables a las tareas que incluimos en un trámite pueden variar dependiendo del valor del atributo ''tipo'', por ejemplo los atributos de respuesta, solo son aplicables a las tareas con el valor en el atributo tipo igual a REQUERIMIENTO. Dicho esto, a continuación pasamos a listar los distintos atributos aplicables a la clausula incluye, que son los siguientes:

*'''Etiqueta''': Atributo que permite establecer el nombre que va a tener la tarea en la aplicación web del STE.

*'''Tipo''': Atributo que indica que tipo de comportamiento que va a tener la tarea. Los distintos valores que acepta este atributo son: INICIO, REQUERIMIENTO, NOTIFICACION y ENVIO_DOCUMENTACION.

*'''respuesta.etiqueta''': Atributo que indica que nombre va a tener la tarea respuesta correspondiente

*'''respuesta.descripcion''': Atributo para indicar una descripción sobre la tarea respuesta.

*'''respuesta.formulario''': Atributo para indicar el nombre del formulario, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, que se va a mostrar en la tarea de respuesta.

*'''respuesta.clasificador''': Atributo para indicar el nombre del clasificador, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, donde se van a guardar los documentos que se pueden adjuntar a una tarea respuesta, perteneciente a una tarea de tipo REQUERIMIENTO.

===Diferentes tipos de tareas===
En la aplicación web STE, una misma tarea de nuestro sistema de información se puede comportar de diferentes maneras, dependiendo de que valor tenga el atributo ''tipo'' al incluir una tarea al trámite.

'''Tareas de INICIO'''
Es aquella tarea que indica cual es la tarea que va a ser el inicio del trámite. En un trámite solo puede haber una tarea de tipo inicio. Esta tarea debe ser definida íntegramente como un proceso en ODL.

incluye [Tramitación de solicitud de becas]
-{{AT|Tipo}}=INICIO;
-{{AT|Etiqueta}}='Tramitación de solicitud de becas universitarias';

'''Tareas de REQUERIMIENTO'''
Son aquellas tareas donde ademas de mostrar información, queremos dar al usuario la posibilidad de responder a la tarea mostrada para rellenar un formulario o adjuntar alguna documentación requerida.

incluye [Esperar respuesta de requerimiento de documentación]
-{{AT|Tipo}}=REQUERIMIENTO;
-{{AT|Etiqueta}}='Respuesta al requerimiento de solicitud de becas universitarias';
-{{AT|respuesta.etiqueta}} = {{STR|"Responder al requerimiento"}};
-{{AT|respuesta.descripcion}} = {{STR|"Adjunte todo lo solicitado en el documento enviado"}};
-{{AT|respuesta.formulario}} = [Respuesta];
-{{AT|respuesta.clasificador}} = [Documentos adjuntos];

'''Tareas de NOTIFICACION'''
Son aquellas tareas donde solo se le va a permitir al usuario del STE observar la información que ha sido mandada desde la plataforma egeasy, donde no podrá ni enviar información, ni modificar la información mandada. Este tipo de tareas suele estar reservados para aquellos datos que son de notificación, como las resoluciones.

incluye [Notificar resolución de la solicitud de beca universitaria]
-{{AT|Tipo}}=NOTIFICACION;
-{{AT|Etiqueta}}='Darse por notificado de la resolución de la solicitud de beca universitaria';

'''Tareas de ENVIO_DOCUMENTACION'''
Son aquellas tareas fuera del ''workflow'' que permiten al usuario de la aplicación web STE enviar documentación. Este tipo de tareas se pueden iniciar en cualquier momento durante la vida del trámite.

incluye [Registrar aporte de documentación al trámite]
-{{AT|Tipo}}=ENVIO_DOCUMENTACION;
-{{AT|Etiqueta}}='Aportar documentación adicional al trámite';

=Colecciones=
Para el desarrollo correcto de los tramites en la aplicación web STE, debemos crear al menos una colección para almacenar los contenedores que se crean al iniciar un trámite. Como al definir un tramite, su ''main target'' tiene que ser el contenedor que se mostrará en la web para que el usuario introduzca los datos iniciales para comenzar el ''workflow'' asociado a un trámite y no un expediente como se suele hacer cuando programamos un sistema de información en egeasy, tendremos que crearnos una colección (Véase [[Colecciones]]) para almacenar inicialmente los contenedores creados por la aplicación STE al iniciar un trámite, para luego posteriormente mover ese contenedor a su lugar dentro de alguna colección dentro de un expediente.

=Estado de un trámite=
Los trámites en la aplicación web STE, tienen estado. El estado de un trámite acabado de iniciar pero no enviado, tiene el valor de ''borrador''. Una vez enviado su primera tarea del trámite, este pasa a tener el valor de ''En trámite''. Por último cuando el trámite ha finalizado en la plataforma egeasy, el trámite pasa a tener el estado de ''finalizado''. Estos valores comentados para el estado de un trámite, es el comportamiento por defecto de la aplicación web STE. Si queremos cambiar el estado de un trámite debemos hacerlo mediante el atributo '''estado''' y su mecanismo para controlarlo, el cual vamos a proceder a explicarlo a continuación.

Para poder modificar el estado de un tramite durante la vida del ''workflow'' asociado al trámite, debemos crearnos un campo en el contenedor que es ''maintarget'' del ''workflow''. Una vez creado ese campo, debemos hacer una exportación de ese campo en alguna colección de nuestra elección. Si hay alguna duda sobre como crear una exportación, véase [[Exportaciones]]. Con la exportación del campo creada, debemos poner en el atributo '''estado''' del trámite, una ristra con el nombre de la tabla en la base de datos seguida de un punto y a continuación el nombre de la columna que representa el campo en la exportación. Para que quede mas claro, vamos a ver un ejemplo:

Esto seria un ejemplo de la exportación creada, donde tenemos un campo llamado en ODL [Estado tramite], el cual se exporta a la tabla de nombre TR$SOLICITUD_TRAMITACION y en la columna ESTADO_TRAMITE.

[EP::Solicitudes de tramitación electrónica] {{PR|es}} exportacion
-{{AT|nombre_tabla}} = {{STR|"TR$SOLICITUD_TRAMITACION"}};
-{{AT|universo}} = [Solicitud de tramitación electrónica para acreditación del profesorado];
{{PR|columna}} [Denominación/Apellidos y nombre]
-{{AT|columna_bd.nombre}} = {{STR|"DENOMINACION"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} =[Datos generales].[Denominación/Apellidos y nombre];
{{PR|columna}} [C.I.F./N.I.F.]
-{{AT|columna_bd.nombre}} = {{STR|"CIF_NIF"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[C.I.F./N.I.F.];
{{PR|columna}} [Estado tramite]
-{{AT|columna_bd.nombre}} = {{STR|"ESTADO_TRAMITE"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[Estado tramite];
{{PR|fin}}

A continuación un ejemplo de como se declararía un trámite utilizando el atributo '''estado'''.

[Trámite de Acreditación del profesorado] {{PR|es}} tramite
-{{AT|descripcion}}='Procedimiento de tramitación para la aceditación del profesorado para la ACECAU';
-{{AT|grupo}}='Trámites Acecau';
-{{AT|Habitacion}}=[Oficina de evaluación del profesorado];
-{{AT|estado}}={{STR|"TR$SOLTRAMI_ACRE_PROF.ESTADO_TRAMITE"}};

Una vez declarado el atributo estado en el trámite, ya podemos proceder a modificar el estado de un trámite mediante código de método, del lenguaje ODL. Para ello solo debemos acceder al campo mediante código ODL, al campo que representa el estado en el contenedor que es ''maintarget'' del ''workflow'' asociado al trámite y asignarle el valor deseado que queremos que se muestre en la aplicación web del STE.

NOTA: PONER EJEMPLO DE UN METODO ASIGNADOLE UN VALOR AL CAMPO ESTADO

=Atributos especiales para los campos de ODL=
Junto con la aplicación web STE disponemos para el lenguaje ODL, de unos atributos especiales aplicables a la definición de componentes para poder definir ciertos aspectos del comportamiento de los componentes que interactuan con la aplicación web STE. A continuación listaremos y definiremos los atributos que ha añadido el STE al lenguage ODL.

'''tramitacion.visible'''

Atributo que permite ocultar un campo para que no se visualice en la aplicación web del STE pero si en la plataforma egeasy. Este atributo es aplicable a todos los campos de ODL. El valor por defecto para este atributo es verdadero.

'''tramitacion.requerida'''

Atributo que permite especificar que campos son de obligada cumplimentación por parte del usuario
para la aplicación web del STE. El valor por defecto para este atributo es falso. Este atributo se puede usar en combinación con las validaciones de ODL para indicar como se debe cumplimentar un campo.

'''tramitacion.valor'''

Atributo que permite establecer el valor del campo al que se le aplica el atributo.


=Formulario de registro de usuarios=
En la aplicación web STE, podemos crear a nuestra medida un formulario de registro de usuarios, donde podemos definir los campos que queremos que el usuario cumplimente al darse de alta para poder utilizar la aplicación web STE. El fichero donde se definen los campos del regostro es un fichero XML y se llama '''registration.xml'''.

A continuación mostramos un ejemplo de un fichero de registro.
<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
<field_value Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>
<field_value Field_Name="Teléfono 1" Field_Type="ftString">
</field_value>
<field_value Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
<field_value Field_Name="Dirección" Field_Type="ftString">
</field_value>
<field_value Field_Name="Código postal" Field_Type="ftString">
</field_value>
<field_value Field_Name="Localidad" Field_Type="ftString">
</field_value>
<field_value Field_Name="Provincia" Field_Type="ftString">
</field_value>
<field_value Field_Name="Fax" Field_Type="ftString">
</field_value>
</registration_form>

[[Category:Tramitación electrónica]]

Categoría:Aplicaciones

2009-06-04T12:33:06Z

Nmelian:

Categoría:Aplicaciones

2009-06-04T12:32:36Z

Nmelian:

asd

Desarrollar con el STE

2009-06-02T10:52:47Z

Nmelian: /* Formulario de registro de usuarios */

__TOC__
=¿Que es un trámite?=
Un trámite es la definición del conjunto de tareas pertenecientes al ''workflow'', que van a interactuar con la aplicación web STE. Los trámites definidos están orientados a ser iniciados por el usuario desde la aplicación web, para que a continuación se inicie un proceso de ''workflow'' programado en ODL para la plataforma egeasy.
==Como se define un trámite==
Para definir un trámite tenemos que indicar el nombre del trámite y declararlo como tipo trámite. La sintaxis de un trámite sería el siguiente.

[Nombre del trámite] es tramite
-ATRIBUTOS
incluye TAREA
.
.
.
incluye TAREA
fin
==Atributos de un trámite==
Los atributos que podemos declarar para un trámite son los siguientes:
*'''descripcion''': Proporcionar un texto descriptivo sobre el trámite que se muestra en la interfaz web al crear el trámite.
*'''grupo''': Indica a que grupo de declaraciones pertenece el trámite.
*'''habitacion''': Indica en que habitación de nuestro sistema de información queremos que este disponible el trámite, para su realización.
*'''estado''': Indica que tabla y columna de una exportación va a almacenar el estado de un trámite.

==La clausula incluye==
Dentro de la definición del trámite, debemos especificar cuales son las tareas del ''wordflow'' que queremos que interactuen con el STE, para ello disponemos de la clausula '''incluye'''. Al utilizarla debemos especificar a continuación el nombre de la tarea e indicar una serie de atributos para especificar varios aspectos sobre el comportamiento de la tarea.

===Atributos de incluye===
Los atributos aplicables a las tareas que incluimos en un trámite pueden variar dependiendo del valor del atributo ''tipo'', por ejemplo los atributos de respuesta, solo son aplicables a las tareas con el valor en el atributo tipo igual a REQUERIMIENTO. Dicho esto, a continuación pasamos a listar los distintos atributos aplicables a la clausula incluye, que son los siguientes:

*'''Etiqueta''': Atributo que permite establecer el nombre que va a tener la tarea en la aplicación web del STE.

*'''Tipo''': Atributo que indica que tipo de comportamiento que va a tener la tarea. Los distintos valores que acepta este atributo son: INICIO, REQUERIMIENTO, NOTIFICACION y ENVIO_DOCUMENTACION.

*'''respuesta.etiqueta''': Atributo que indica que nombre va a tener la tarea respuesta correspondiente

*'''respuesta.descripcion''': Atributo para indicar una descripción sobre la tarea respuesta.

*'''respuesta.formulario''': Atributo para indicar el nombre del formulario, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, que se va a mostrar en la tarea de respuesta.

*'''respuesta.clasificador''': Atributo para indicar el nombre del clasificador, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, donde se van a guardar los documentos que se pueden adjuntar a una tarea respuesta, perteneciente a una tarea de tipo REQUERIMIENTO.

===Diferentes tipos de tareas===
En la aplicación web STE, una misma tarea de nuestro sistema de información se puede comportar de diferentes maneras, dependiendo de que valor tenga el atributo ''tipo'' al incluir una tarea al trámite.

'''Tareas de INICIO'''
Es aquella tarea que indica cual es la tarea que va a ser el inicio del trámite. En un trámite solo puede haber una tarea de tipo inicio. Esta tarea debe ser definida íntegramente como un proceso en ODL.

incluye [Tramitación de solicitud de becas]
-{{AT|Tipo}}=INICIO;
-{{AT|Etiqueta}}='Tramitación de solicitud de becas universitarias';

'''Tareas de REQUERIMIENTO'''
Son aquellas tareas donde ademas de mostrar información, queremos dar al usuario la posibilidad de responder a la tarea mostrada para rellenar un formulario o adjuntar alguna documentación requerida.

incluye [Esperar respuesta de requerimiento de documentación]
-{{AT|Tipo}}=REQUERIMIENTO;
-{{AT|Etiqueta}}='Respuesta al requerimiento de solicitud de becas universitarias';
-{{AT|respuesta.etiqueta}} = {{STR|"Responder al requerimiento"}};
-{{AT|respuesta.descripcion}} = {{STR|"Adjunte todo lo solicitado en el documento enviado"}};
-{{AT|respuesta.formulario}} = [Respuesta];
-{{AT|respuesta.clasificador}} = [Documentos adjuntos];

'''Tareas de NOTIFICACION'''
Son aquellas tareas donde solo se le va a permitir al usuario del STE observar la información que ha sido mandada desde la plataforma egeasy, donde no podrá ni enviar información, ni modificar la información mandada. Este tipo de tareas suele estar reservados para aquellos datos que son de notificación, como las resoluciones.

incluye [Notificar resolución de la solicitud de beca universitaria]
-{{AT|Tipo}}=NOTIFICACION;
-{{AT|Etiqueta}}='Darse por notificado de la resolución de la solicitud de beca universitaria';

'''Tareas de ENVIO_DOCUMENTACION'''
Son aquellas tareas fuera del ''workflow'' que permiten al usuario de la aplicación web STE enviar documentación. Este tipo de tareas se pueden iniciar en cualquier momento durante la vida del trámite.

incluye [Registrar aporte de documentación al trámite]
-{{AT|Tipo}}=ENVIO_DOCUMENTACION;
-{{AT|Etiqueta}}='Aportar documentación adicional al trámite';

=Colecciones=
Para el desarrollo correcto de los tramites en la aplicación web STE, debemos crear al menos una colección para almacenar los contenedores que se crean al iniciar un trámite. Como al definir un tramite, su ''main target'' tiene que ser el contenedor que se mostrará en la web para que el usuario introduzca los datos iniciales para comenzar el ''workflow'' asociado a un trámite y no un expediente como se suele hacer cuando programamos un sistema de información en egeasy, tendremos que crearnos una colección (Véase [[Colecciones]]) para almacenar inicialmente los contenedores creados por la aplicación STE al iniciar un trámite, para luego posteriormente mover ese contenedor a su lugar dentro de alguna colección dentro de un expediente.

=Estado de un trámite=
Los trámites en la aplicación web STE, tienen estado. El estado de un trámite acabado de iniciar pero no enviado, tiene el valor de ''borrador''. Una vez enviado su primera tarea del trámite, este pasa a tener el valor de ''En trámite''. Por último cuando el trámite ha finalizado en la plataforma egeasy, el trámite pasa a tener el estado de ''finalizado''. Estos valores comentados para el estado de un trámite, es el comportamiento por defecto de la aplicación web STE. Si queremos cambiar el estado de un trámite debemos hacerlo mediante el atributo '''estado''' y su mecanismo para controlarlo, el cual vamos a proceder a explicarlo a continuación.

Para poder modificar el estado de un tramite durante la vida del ''workflow'' asociado al trámite, debemos crearnos un campo en el contenedor que es ''maintarget'' del ''workflow''. Una vez creado ese campo, debemos hacer una exportación de ese campo en alguna colección de nuestra elección. Si hay alguna duda sobre como crear una exportación, véase [[Exportaciones]]. Con la exportación del campo creada, debemos poner en el atributo '''estado''' del trámite, una ristra con el nombre de la tabla en la base de datos seguida de un punto y a continuación el nombre de la columna que representa el campo en la exportación. Para que quede mas claro, vamos a ver un ejemplo:

Esto seria un ejemplo de la exportación creada, donde tenemos un campo llamado en ODL [Estado tramite], el cual se exporta a la tabla de nombre TR$SOLICITUD_TRAMITACION y en la columna ESTADO_TRAMITE.

[EP::Solicitudes de tramitación electrónica] {{PR|es}} exportacion
-{{AT|nombre_tabla}} = {{STR|"TR$SOLICITUD_TRAMITACION"}};
-{{AT|universo}} = [Solicitud de tramitación electrónica para acreditación del profesorado];
{{PR|columna}} [Denominación/Apellidos y nombre]
-{{AT|columna_bd.nombre}} = {{STR|"DENOMINACION"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} =[Datos generales].[Denominación/Apellidos y nombre];
{{PR|columna}} [C.I.F./N.I.F.]
-{{AT|columna_bd.nombre}} = {{STR|"CIF_NIF"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[C.I.F./N.I.F.];
{{PR|columna}} [Estado tramite]
-{{AT|columna_bd.nombre}} = {{STR|"ESTADO_TRAMITE"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[Estado tramite];
{{PR|fin}}

A continuación un ejemplo de como se declararía un trámite utilizando el atributo '''estado'''.

[Trámite de Acreditación del profesorado] {{PR|es}} tramite
-{{AT|descripcion}}='Procedimiento de tramitación para la aceditación del profesorado para la ACECAU';
-{{AT|grupo}}='Trámites Acecau';
-{{AT|Habitacion}}=[Oficina de evaluación del profesorado];
-{{AT|estado}}={{STR|"TR$SOLTRAMI_ACRE_PROF.ESTADO_TRAMITE"}};

Una vez declarado el atributo estado en el trámite, ya podemos proceder a modificar el estado de un trámite mediante código de método, del lenguaje ODL. Para ello solo debemos acceder al campo mediante código ODL, al campo que representa el estado en el contenedor que es ''maintarget'' del ''workflow'' asociado al trámite y asignarle el valor deseado que queremos que se muestre en la aplicación web del STE.

NOTA: PONER EJEMPLO DE UN METODO ASIGNADOLE UN VALOR AL CAMPO ESTADO

=Atributos especiales para los campos de ODL=
Junto con la aplicación web STE disponemos para el lenguaje ODL, de unos atributos especiales aplicables a la definición de componentes para poder definir ciertos aspectos del comportamiento de los componentes que interactuan con la aplicación web STE. A continuación listaremos y definiremos los atributos que ha añadido el STE al lenguage ODL.

'''tramitacion.visible'''

Atributo que permite ocultar un campo para que no se visualice en la aplicación web del STE pero si en la plataforma egeasy. Este atributo es aplicable a todos los campos de ODL. El valor por defecto para este atributo es verdadero.

'''tramitacion.requerida'''

Atributo que permite especificar que campos son de obligada cumplimentación por parte del usuario
para la aplicación web del STE. El valor por defecto para este atributo es falso. Este atributo se puede usar en combinación con las validaciones de ODL para indicar como se debe cumplimentar un campo.

'''tramitacion.valor'''

Atributo que permite establecer el valor del campo al que se le aplica el atributo.


=Formulario de registro de usuarios=
En la aplicación web STE, podemos crear a nuestra medida un formulario de registro de usuarios, donde podemos definir los campos que queremos que el usuario cumplimente al darse de alta para poder utilizar la aplicación web STE. El fichero donde se definen los campos del regostro es un fichero XML y se llama '''registration.xml'''.

A continuación mostramos un ejemplo de un fichero de registro.
<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
<field_value Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>
<field_value Field_Name="Teléfono 1" Field_Type="ftString">
</field_value>
<field_value Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
<field_value Field_Name="Dirección" Field_Type="ftString">
</field_value>
<field_value Field_Name="Código postal" Field_Type="ftString">
</field_value>
<field_value Field_Name="Localidad" Field_Type="ftString">
</field_value>
<field_value Field_Name="Provincia" Field_Type="ftString">
</field_value>
<field_value Field_Name="Fax" Field_Type="ftString">
</field_value>
</registration_form>

Desarrollar con el STE

2009-06-01T15:28:37Z

Nmelian: /* Formulario de registro de usuarios */

__TOC__
=¿Que es un trámite?=
Un trámite es la definición del conjunto de tareas pertenecientes al ''workflow'', que van a interactuar con la aplicación web STE. Los trámites definidos están orientados a ser iniciados por el usuario desde la aplicación web, para que a continuación se inicie un proceso de ''workflow'' programado en ODL para la plataforma egeasy.
==Como se define un trámite==
Para definir un trámite tenemos que indicar el nombre del trámite y declararlo como tipo trámite. La sintaxis de un trámite sería el siguiente.

[Nombre del trámite] es tramite
-ATRIBUTOS
incluye TAREA
.
.
.
incluye TAREA
fin
==Atributos de un trámite==
Los atributos que podemos declarar para un trámite son los siguientes:
*'''descripcion''': Proporcionar un texto descriptivo sobre el trámite que se muestra en la interfaz web al crear el trámite.
*'''grupo''': Indica a que grupo de declaraciones pertenece el trámite.
*'''habitacion''': Indica en que habitación de nuestro sistema de información queremos que este disponible el trámite, para su realización.
*'''estado''': Indica que tabla y columna de una exportación va a almacenar el estado de un trámite.

==La clausula incluye==
Dentro de la definición del trámite, debemos especificar cuales son las tareas del ''wordflow'' que queremos que interactuen con el STE, para ello disponemos de la clausula '''incluye'''. Al utilizarla debemos especificar a continuación el nombre de la tarea e indicar una serie de atributos para especificar varios aspectos sobre el comportamiento de la tarea.

===Atributos de incluye===
Los atributos aplicables a las tareas que incluimos en un trámite pueden variar dependiendo del valor del atributo ''tipo'', por ejemplo los atributos de respuesta, solo son aplicables a las tareas con el valor en el atributo tipo igual a REQUERIMIENTO. Dicho esto, a continuación pasamos a listar los distintos atributos aplicables a la clausula incluye, que son los siguientes:

*'''Etiqueta''': Atributo que permite establecer el nombre que va a tener la tarea en la aplicación web del STE.

*'''Tipo''': Atributo que indica que tipo de comportamiento que va a tener la tarea. Los distintos valores que acepta este atributo son: INICIO, REQUERIMIENTO, NOTIFICACION y ENVIO_DOCUMENTACION.

*'''respuesta.etiqueta''': Atributo que indica que nombre va a tener la tarea respuesta correspondiente

*'''respuesta.descripcion''': Atributo para indicar una descripción sobre la tarea respuesta.

*'''respuesta.formulario''': Atributo para indicar el nombre del formulario, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, que se va a mostrar en la tarea de respuesta.

*'''respuesta.clasificador''': Atributo para indicar el nombre del clasificador, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, donde se van a guardar los documentos que se pueden adjuntar a una tarea respuesta, perteneciente a una tarea de tipo REQUERIMIENTO.

===Diferentes tipos de tareas===
En la aplicación web STE, una misma tarea de nuestro sistema de información se puede comportar de diferentes maneras, dependiendo de que valor tenga el atributo ''tipo'' al incluir una tarea al trámite.

'''Tareas de INICIO'''
Es aquella tarea que indica cual es la tarea que va a ser el inicio del trámite. En un trámite solo puede haber una tarea de tipo inicio. Esta tarea debe ser definida íntegramente como un proceso en ODL.

incluye [Tramitación de solicitud de becas]
-{{AT|Tipo}}=INICIO;
-{{AT|Etiqueta}}='Tramitación de solicitud de becas universitarias';

'''Tareas de REQUERIMIENTO'''
Son aquellas tareas donde ademas de mostrar información, queremos dar al usuario la posibilidad de responder a la tarea mostrada para rellenar un formulario o adjuntar alguna documentación requerida.

incluye [Esperar respuesta de requerimiento de documentación]
-{{AT|Tipo}}=REQUERIMIENTO;
-{{AT|Etiqueta}}='Respuesta al requerimiento de solicitud de becas universitarias';
-{{AT|respuesta.etiqueta}} = {{STR|"Responder al requerimiento"}};
-{{AT|respuesta.descripcion}} = {{STR|"Adjunte todo lo solicitado en el documento enviado"}};
-{{AT|respuesta.formulario}} = [Respuesta];
-{{AT|respuesta.clasificador}} = [Documentos adjuntos];

'''Tareas de NOTIFICACION'''
Son aquellas tareas donde solo se le va a permitir al usuario del STE observar la información que ha sido mandada desde la plataforma egeasy, donde no podrá ni enviar información, ni modificar la información mandada. Este tipo de tareas suele estar reservados para aquellos datos que son de notificación, como las resoluciones.

incluye [Notificar resolución de la solicitud de beca universitaria]
-{{AT|Tipo}}=NOTIFICACION;
-{{AT|Etiqueta}}='Darse por notificado de la resolución de la solicitud de beca universitaria';

'''Tareas de ENVIO_DOCUMENTACION'''
Son aquellas tareas fuera del ''workflow'' que permiten al usuario de la aplicación web STE enviar documentación. Este tipo de tareas se pueden iniciar en cualquier momento durante la vida del trámite.

incluye [Registrar aporte de documentación al trámite]
-{{AT|Tipo}}=ENVIO_DOCUMENTACION;
-{{AT|Etiqueta}}='Aportar documentación adicional al trámite';

=Colecciones=
Para el desarrollo correcto de los tramites en la aplicación web STE, debemos crear al menos una colección para almacenar los contenedores que se crean al iniciar un trámite. Como al definir un tramite, su ''main target'' tiene que ser el contenedor que se mostrará en la web para que el usuario introduzca los datos iniciales para comenzar el ''workflow'' asociado a un trámite y no un expediente como se suele hacer cuando programamos un sistema de información en egeasy, tendremos que crearnos una colección (Véase [[Colecciones]]) para almacenar inicialmente los contenedores creados por la aplicación STE al iniciar un trámite, para luego posteriormente mover ese contenedor a su lugar dentro de alguna colección dentro de un expediente.

=Estado de un trámite=
Los trámites en la aplicación web STE, tienen estado. El estado de un trámite acabado de iniciar pero no enviado, tiene el valor de ''borrador''. Una vez enviado su primera tarea del trámite, este pasa a tener el valor de ''En trámite''. Por último cuando el trámite ha finalizado en la plataforma egeasy, el trámite pasa a tener el estado de ''finalizado''. Estos valores comentados para el estado de un trámite, es el comportamiento por defecto de la aplicación web STE. Si queremos cambiar el estado de un trámite debemos hacerlo mediante el atributo '''estado''' y su mecanismo para controlarlo, el cual vamos a proceder a explicarlo a continuación.

Para poder modificar el estado de un tramite durante la vida del ''workflow'' asociado al trámite, debemos crearnos un campo en el contenedor que es ''maintarget'' del ''workflow''. Una vez creado ese campo, debemos hacer una exportación de ese campo en alguna colección de nuestra elección. Si hay alguna duda sobre como crear una exportación, véase [[Exportaciones]]. Con la exportación del campo creada, debemos poner en el atributo '''estado''' del trámite, una ristra con el nombre de la tabla en la base de datos seguida de un punto y a continuación el nombre de la columna que representa el campo en la exportación. Para que quede mas claro, vamos a ver un ejemplo:

Esto seria un ejemplo de la exportación creada, donde tenemos un campo llamado en ODL [Estado tramite], el cual se exporta a la tabla de nombre TR$SOLICITUD_TRAMITACION y en la columna ESTADO_TRAMITE.

[EP::Solicitudes de tramitación electrónica] {{PR|es}} exportacion
-{{AT|nombre_tabla}} = {{STR|"TR$SOLICITUD_TRAMITACION"}};
-{{AT|universo}} = [Solicitud de tramitación electrónica para acreditación del profesorado];
{{PR|columna}} [Denominación/Apellidos y nombre]
-{{AT|columna_bd.nombre}} = {{STR|"DENOMINACION"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} =[Datos generales].[Denominación/Apellidos y nombre];
{{PR|columna}} [C.I.F./N.I.F.]
-{{AT|columna_bd.nombre}} = {{STR|"CIF_NIF"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[C.I.F./N.I.F.];
{{PR|columna}} [Estado tramite]
-{{AT|columna_bd.nombre}} = {{STR|"ESTADO_TRAMITE"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[Estado tramite];
{{PR|fin}}

A continuación un ejemplo de como se declararía un trámite utilizando el atributo '''estado'''.

[Trámite de Acreditación del profesorado] {{PR|es}} tramite
-{{AT|descripcion}}='Procedimiento de tramitación para la aceditación del profesorado para la ACECAU';
-{{AT|grupo}}='Trámites Acecau';
-{{AT|Habitacion}}=[Oficina de evaluación del profesorado];
-{{AT|estado}}={{STR|"TR$SOLTRAMI_ACRE_PROF.ESTADO_TRAMITE"}};

Una vez declarado el atributo estado en el trámite, ya podemos proceder a modificar el estado de un trámite mediante código de método, del lenguaje ODL. Para ello solo debemos acceder al campo mediante código ODL, al campo que representa el estado en el contenedor que es ''maintarget'' del ''workflow'' asociado al trámite y asignarle el valor deseado que queremos que se muestre en la aplicación web del STE.

NOTA: PONER EJEMPLO DE UN METODO ASIGNADOLE UN VALOR AL CAMPO ESTADO

=Atributos especiales para los campos de ODL=
Junto con la aplicación web STE disponemos para el lenguaje ODL, de unos atributos especiales aplicables a la definición de componentes para poder definir ciertos aspectos del comportamiento de los componentes que interactuan con la aplicación web STE. A continuación listaremos y definiremos los atributos que ha añadido el STE al lenguage ODL.

'''tramitacion.visible'''

Atributo que permite ocultar un campo para que no se visualice en la aplicación web del STE pero si en la plataforma egeasy. Este atributo es aplicable a todos los campos de ODL. El valor por defecto para este atributo es verdadero.

'''tramitacion.requerida'''

Atributo que permite especificar que campos son de obligada cumplimentación por parte del usuario
para la aplicación web del STE. El valor por defecto para este atributo es falso. Este atributo se puede usar en combinación con las validaciones de ODL para indicar como se debe cumplimentar un campo.

'''tramitacion.valor'''

Atributo que permite establecer el valor del campo al que se le aplica el atributo.


=Formulario de registro de usuarios=
En la aplicación web STE,

A continuación mostramos un ejemplo de un fichero de registro.
<?xml version="1.0" encoding="ISO-8859-1"?>
<registration_form>
<field_value Field_Name="Género" Field_Type="ftString">
<allowed_values>
<item>Masculino</item>
<item>Femenino</item>
</allowed_values>
</field_value>
<field_value Field_Name="Teléfono 1" Field_Type="ftString">
</field_value>
<field_value Field_Name="Teléfono 2" Field_Type="ftString">
</field_value>
<field_value Field_Name="Dirección" Field_Type="ftString">
</field_value>
<field_value Field_Name="Código postal" Field_Type="ftString">
</field_value>
<field_value Field_Name="Localidad" Field_Type="ftString">
</field_value>
<field_value Field_Name="Provincia" Field_Type="ftString">
</field_value>
<field_value Field_Name="Fax" Field_Type="ftString">
</field_value>
</registration_form>

Desarrollar con el STE

2009-06-01T15:20:18Z

Nmelian:

__TOC__
=¿Que es un trámite?=
Un trámite es la definición del conjunto de tareas pertenecientes al ''workflow'', que van a interactuar con la aplicación web STE. Los trámites definidos están orientados a ser iniciados por el usuario desde la aplicación web, para que a continuación se inicie un proceso de ''workflow'' programado en ODL para la plataforma egeasy.
==Como se define un trámite==
Para definir un trámite tenemos que indicar el nombre del trámite y declararlo como tipo trámite. La sintaxis de un trámite sería el siguiente.

[Nombre del trámite] es tramite
-ATRIBUTOS
incluye TAREA
.
.
.
incluye TAREA
fin
==Atributos de un trámite==
Los atributos que podemos declarar para un trámite son los siguientes:
*'''descripcion''': Proporcionar un texto descriptivo sobre el trámite que se muestra en la interfaz web al crear el trámite.
*'''grupo''': Indica a que grupo de declaraciones pertenece el trámite.
*'''habitacion''': Indica en que habitación de nuestro sistema de información queremos que este disponible el trámite, para su realización.
*'''estado''': Indica que tabla y columna de una exportación va a almacenar el estado de un trámite.

==La clausula incluye==
Dentro de la definición del trámite, debemos especificar cuales son las tareas del ''wordflow'' que queremos que interactuen con el STE, para ello disponemos de la clausula '''incluye'''. Al utilizarla debemos especificar a continuación el nombre de la tarea e indicar una serie de atributos para especificar varios aspectos sobre el comportamiento de la tarea.

===Atributos de incluye===
Los atributos aplicables a las tareas que incluimos en un trámite pueden variar dependiendo del valor del atributo ''tipo'', por ejemplo los atributos de respuesta, solo son aplicables a las tareas con el valor en el atributo tipo igual a REQUERIMIENTO. Dicho esto, a continuación pasamos a listar los distintos atributos aplicables a la clausula incluye, que son los siguientes:

*'''Etiqueta''': Atributo que permite establecer el nombre que va a tener la tarea en la aplicación web del STE.

*'''Tipo''': Atributo que indica que tipo de comportamiento que va a tener la tarea. Los distintos valores que acepta este atributo son: INICIO, REQUERIMIENTO, NOTIFICACION y ENVIO_DOCUMENTACION.

*'''respuesta.etiqueta''': Atributo que indica que nombre va a tener la tarea respuesta correspondiente

*'''respuesta.descripcion''': Atributo para indicar una descripción sobre la tarea respuesta.

*'''respuesta.formulario''': Atributo para indicar el nombre del formulario, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, que se va a mostrar en la tarea de respuesta.

*'''respuesta.clasificador''': Atributo para indicar el nombre del clasificador, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, donde se van a guardar los documentos que se pueden adjuntar a una tarea respuesta, perteneciente a una tarea de tipo REQUERIMIENTO.

===Diferentes tipos de tareas===
En la aplicación web STE, una misma tarea de nuestro sistema de información se puede comportar de diferentes maneras, dependiendo de que valor tenga el atributo ''tipo'' al incluir una tarea al trámite.

'''Tareas de INICIO'''
Es aquella tarea que indica cual es la tarea que va a ser el inicio del trámite. En un trámite solo puede haber una tarea de tipo inicio. Esta tarea debe ser definida íntegramente como un proceso en ODL.

incluye [Tramitación de solicitud de becas]
-{{AT|Tipo}}=INICIO;
-{{AT|Etiqueta}}='Tramitación de solicitud de becas universitarias';

'''Tareas de REQUERIMIENTO'''
Son aquellas tareas donde ademas de mostrar información, queremos dar al usuario la posibilidad de responder a la tarea mostrada para rellenar un formulario o adjuntar alguna documentación requerida.

incluye [Esperar respuesta de requerimiento de documentación]
-{{AT|Tipo}}=REQUERIMIENTO;
-{{AT|Etiqueta}}='Respuesta al requerimiento de solicitud de becas universitarias';
-{{AT|respuesta.etiqueta}} = {{STR|"Responder al requerimiento"}};
-{{AT|respuesta.descripcion}} = {{STR|"Adjunte todo lo solicitado en el documento enviado"}};
-{{AT|respuesta.formulario}} = [Respuesta];
-{{AT|respuesta.clasificador}} = [Documentos adjuntos];

'''Tareas de NOTIFICACION'''
Son aquellas tareas donde solo se le va a permitir al usuario del STE observar la información que ha sido mandada desde la plataforma egeasy, donde no podrá ni enviar información, ni modificar la información mandada. Este tipo de tareas suele estar reservados para aquellos datos que son de notificación, como las resoluciones.

incluye [Notificar resolución de la solicitud de beca universitaria]
-{{AT|Tipo}}=NOTIFICACION;
-{{AT|Etiqueta}}='Darse por notificado de la resolución de la solicitud de beca universitaria';

'''Tareas de ENVIO_DOCUMENTACION'''
Son aquellas tareas fuera del ''workflow'' que permiten al usuario de la aplicación web STE enviar documentación. Este tipo de tareas se pueden iniciar en cualquier momento durante la vida del trámite.

incluye [Registrar aporte de documentación al trámite]
-{{AT|Tipo}}=ENVIO_DOCUMENTACION;
-{{AT|Etiqueta}}='Aportar documentación adicional al trámite';

=Colecciones=
Para el desarrollo correcto de los tramites en la aplicación web STE, debemos crear al menos una colección para almacenar los contenedores que se crean al iniciar un trámite. Como al definir un tramite, su ''main target'' tiene que ser el contenedor que se mostrará en la web para que el usuario introduzca los datos iniciales para comenzar el ''workflow'' asociado a un trámite y no un expediente como se suele hacer cuando programamos un sistema de información en egeasy, tendremos que crearnos una colección (Véase [[Colecciones]]) para almacenar inicialmente los contenedores creados por la aplicación STE al iniciar un trámite, para luego posteriormente mover ese contenedor a su lugar dentro de alguna colección dentro de un expediente.

=Estado de un trámite=
Los trámites en la aplicación web STE, tienen estado. El estado de un trámite acabado de iniciar pero no enviado, tiene el valor de ''borrador''. Una vez enviado su primera tarea del trámite, este pasa a tener el valor de ''En trámite''. Por último cuando el trámite ha finalizado en la plataforma egeasy, el trámite pasa a tener el estado de ''finalizado''. Estos valores comentados para el estado de un trámite, es el comportamiento por defecto de la aplicación web STE. Si queremos cambiar el estado de un trámite debemos hacerlo mediante el atributo '''estado''' y su mecanismo para controlarlo, el cual vamos a proceder a explicarlo a continuación.

Para poder modificar el estado de un tramite durante la vida del ''workflow'' asociado al trámite, debemos crearnos un campo en el contenedor que es ''maintarget'' del ''workflow''. Una vez creado ese campo, debemos hacer una exportación de ese campo en alguna colección de nuestra elección. Si hay alguna duda sobre como crear una exportación, véase [[Exportaciones]]. Con la exportación del campo creada, debemos poner en el atributo '''estado''' del trámite, una ristra con el nombre de la tabla en la base de datos seguida de un punto y a continuación el nombre de la columna que representa el campo en la exportación. Para que quede mas claro, vamos a ver un ejemplo:

Esto seria un ejemplo de la exportación creada, donde tenemos un campo llamado en ODL [Estado tramite], el cual se exporta a la tabla de nombre TR$SOLICITUD_TRAMITACION y en la columna ESTADO_TRAMITE.

[EP::Solicitudes de tramitación electrónica] {{PR|es}} exportacion
-{{AT|nombre_tabla}} = {{STR|"TR$SOLICITUD_TRAMITACION"}};
-{{AT|universo}} = [Solicitud de tramitación electrónica para acreditación del profesorado];
{{PR|columna}} [Denominación/Apellidos y nombre]
-{{AT|columna_bd.nombre}} = {{STR|"DENOMINACION"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} =[Datos generales].[Denominación/Apellidos y nombre];
{{PR|columna}} [C.I.F./N.I.F.]
-{{AT|columna_bd.nombre}} = {{STR|"CIF_NIF"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[C.I.F./N.I.F.];
{{PR|columna}} [Estado tramite]
-{{AT|columna_bd.nombre}} = {{STR|"ESTADO_TRAMITE"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[Estado tramite];
{{PR|fin}}

A continuación un ejemplo de como se declararía un trámite utilizando el atributo '''estado'''.

[Trámite de Acreditación del profesorado] {{PR|es}} tramite
-{{AT|descripcion}}='Procedimiento de tramitación para la aceditación del profesorado para la ACECAU';
-{{AT|grupo}}='Trámites Acecau';
-{{AT|Habitacion}}=[Oficina de evaluación del profesorado];
-{{AT|estado}}={{STR|"TR$SOLTRAMI_ACRE_PROF.ESTADO_TRAMITE"}};

Una vez declarado el atributo estado en el trámite, ya podemos proceder a modificar el estado de un trámite mediante código de método, del lenguaje ODL. Para ello solo debemos acceder al campo mediante código ODL, al campo que representa el estado en el contenedor que es ''maintarget'' del ''workflow'' asociado al trámite y asignarle el valor deseado que queremos que se muestre en la aplicación web del STE.

NOTA: PONER EJEMPLO DE UN METODO ASIGNADOLE UN VALOR AL CAMPO ESTADO

=Atributos especiales para los campos de ODL=
Junto con la aplicación web STE disponemos para el lenguaje ODL, de unos atributos especiales aplicables a la definición de componentes para poder definir ciertos aspectos del comportamiento de los componentes que interactuan con la aplicación web STE. A continuación listaremos y definiremos los atributos que ha añadido el STE al lenguage ODL.

'''tramitacion.visible'''

Atributo que permite ocultar un campo para que no se visualice en la aplicación web del STE pero si en la plataforma egeasy. Este atributo es aplicable a todos los campos de ODL. El valor por defecto para este atributo es verdadero.

'''tramitacion.requerida'''

Atributo que permite especificar que campos son de obligada cumplimentación por parte del usuario
para la aplicación web del STE. El valor por defecto para este atributo es falso. Este atributo se puede usar en combinación con las validaciones de ODL para indicar como se debe cumplimentar un campo.

'''tramitacion.valor'''

Atributo que permite establecer el valor del campo al que se le aplica el atributo.


=Formulario de registro de usuarios=
En la aplicación web STE,

Desarrollar con el STE

2009-06-01T14:43:10Z

Nmelian: /* Diferentes tipos de tareas */

Desarrollar con el STE

2009-06-01T14:38:00Z

Nmelian: /* Colecciones */

__TOC__
=¿Que es un trámite?=
Un trámite es la definición del conjunto de tareas pertenecientes al ''workflow'', que van a interactuar con la aplicación web STE. Los trámites definidos están orientados a ser iniciados por el usuario desde la aplicación web, para que a continuación se inicie un proceso de ''workflow'' programado en ODL para la plataforma egeasy.
==Como se define un trámite==
Para definir un trámite tenemos que indicar el nombre del trámite y declararlo como tipo trámite. La sintaxis de un trámite sería el siguiente.

[Nombre del trámite] es tramite
-ATRIBUTOS
incluye TAREA
.
.
.
incluye TAREA
fin
==Atributos de un trámite==
Los atributos que podemos declarar para un trámite son los siguientes:
*'''descripcion''': Proporcionar un texto descriptivo sobre el trámite que se muestra en la interfaz web al crear el trámite.
*'''grupo''': Indica a que grupo de declaraciones pertenece el trámite.
*'''habitacion''': Indica en que habitación de nuestro sistema de información queremos que este disponible el trámite, para su realización.
*'''estado''': Indica que tabla y columna de una exportación va a almacenar el estado de un trámite.

==La clausula incluye==
Dentro de la definición del trámite, debemos especificar cuales son las tareas del ''wordflow'' que queremos que interactuen con el STE, para ello disponemos de la clausula '''incluye'''. Al utilizarla debemos especificar a continuación el nombre de la tarea e indicar una serie de atributos para especificar varios aspectos sobre el comportamiento de la tarea.

===Atributos de incluye===
Los atributos aplicables a las tareas que incluimos en un trámite pueden variar dependiendo del valor del atributo ''tipo'', por ejemplo los atributos de respuesta, solo son aplicables a las tareas con el valor en el atributo tipo igual a REQUERIMIENTO. Dicho esto, a continuación pasamos a listar los distintos atributos aplicables a la clausula incluye, que son los siguientes:

*'''Etiqueta''': Atributo que permite establecer el nombre que va a tener la tarea en la aplicación web del STE.

*'''Tipo''': Atributo que indica que tipo de comportamiento que va a tener la tarea. Los distintos valores que acepta este atributo son: INICIO, REQUERIMIENTO, NOTIFICACION y ENVIO_DOCUMENTACION.

*'''respuesta.etiqueta''': Atributo que indica que nombre va a tener la tarea respuesta correspondiente

*'''respuesta.descripcion''': Atributo para indicar una descripción sobre la tarea respuesta.

*'''respuesta.formulario''': Atributo para indicar el nombre del formulario, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, que se va a mostrar en la tarea de respuesta.

*'''respuesta.clasificador''': Atributo para indicar el nombre del clasificador, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, donde se van a guardar los documentos que se pueden adjuntar a una tarea respuesta, perteneciente a una tarea de tipo REQUERIMIENTO.

===Diferentes tipos de tareas===
En la aplicación web STE, una misma tarea de nuestro sistema de información se puede comportar de diferentes maneras, dependiendo de que valor tenga el atributo ''tipo'' al incluir una tarea al trámite.

'''Tareas de INICIO'''
Es aquella tarea que indica cual es la tarea que va a ser el inicio del trámite. En un trámite solo puede haber una tarea de tipo inicio. Esta tarea debe ser definida íntegramente como un proceso en ODL.

incluye [Tramitación de solicitud de becas]
-Tipo=INICIO;
-Etiqueta='Tramitación de solicitud de becas universitarias';

'''Tareas de REQUERIMIENTO'''
Son aquellas tareas donde ademas de mostrar información, queremos dar al usuario la posibilidad de responder a la tarea mostrada para rellenar un formulario o adjuntar alguna documentación requerida.

incluye [Esperar respuesta de requerimiento de documentación]
-Tipo=REQUERIMIENTO;
-Etiqueta='Respuesta al requerimiento de solicitud de becas universitarias';
-respuesta.etiqueta = "Responder al requerimiento";
-respuesta.descripcion = "Adjunte todo lo solicitado en el documento enviado";
-respuesta.formulario = [Respuesta];
-respuesta.clasificador = [Documentos adjuntos];

'''Tareas de NOTIFICACION'''
Son aquellas tareas donde solo se le va a permitir al usuario del STE observar la información que ha sido mandada desde la plataforma egeasy, donde no podrá ni enviar información, ni modificar la información mandada. Este tipo de tareas suele estar reservados para aquellos datos que son de notificación, como las resoluciones.

incluye [Notificar resolución de la solicitud de beca universitaria]
-Tipo=NOTIFICACION;
-Etiqueta='Darse por notificado de la resolución de la solicitud de beca universitaria';

'''Tareas de ENVIO_DOCUMENTACION'''
Son aquellas tareas fuera del ''workflow'' que permiten al usuario de la aplicación web STE enviar documentación. Este tipo de tareas se pueden iniciar en cualquier momento durante la vida del trámite.

incluye [Registrar aporte de documentación al trámite]
-Tipo=ENVIO_DOCUMENTACION;
-Etiqueta='Aportar documentación adicional al trámite';

=Colecciones=
Para el desarrollo correcto de los tramites en la aplicación web STE, debemos crear al menos una colección para almacenar los contenedores que se crean al iniciar un trámite. Como al definir un tramite, su ''main target'' tiene que ser el contenedor que se mostrará en la web para que el usuario introduzca los datos iniciales para comenzar el ''workflow'' asociado a un trámite y no un expediente como se suele hacer cuando programamos un sistema de información en egeasy, tendremos que crearnos una colección (Véase [[Colecciones]]) para almacenar inicialmente los contenedores creados por la aplicación STE al iniciar un trámite, para luego posteriormente mover ese contenedor a su lugar dentro de alguna colección dentro de un expediente.

=Estado de un trámite=
Los trámites en la aplicación web STE, tienen estado. El estado de un trámite acabado de iniciar pero no enviado, tiene el valor de ''borrador''. Una vez enviado su primera tarea del trámite, este pasa a tener el valor de ''En trámite''. Por último cuando el trámite ha finalizado en la plataforma egeasy, el trámite pasa a tener el estado de ''finalizado''. Estos valores comentados para el estado de un trámite, es el comportamiento por defecto de la aplicación web STE. Si queremos cambiar el estado de un trámite debemos hacerlo mediante el atributo '''estado''' y su mecanismo para controlarlo, el cual vamos a proceder a explicarlo a continuación.

Para poder modificar el estado de un tramite durante la vida del ''workflow'' asociado al trámite, debemos crearnos un campo en el contenedor que es ''maintarget'' del ''workflow''. Una vez creado ese campo, debemos hacer una exportación de ese campo en alguna colección de nuestra elección. Si hay alguna duda sobre como crear una exportación, véase [[Exportaciones]]. Con la exportación del campo creada, debemos poner en el atributo '''estado''' del trámite, una ristra con el nombre de la tabla en la base de datos seguida de un punto y a continuación el nombre de la columna que representa el campo en la exportación. Para que quede mas claro, vamos a ver un ejemplo:

Esto seria un ejemplo de la exportación creada, donde tenemos un campo llamado en ODL [Estado tramite], el cual se exporta a la tabla de nombre TR$SOLICITUD_TRAMITACION y en la columna ESTADO_TRAMITE.

[EP::Solicitudes de tramitación electrónica] {{PR|es}} exportacion
-{{AT|nombre_tabla}} = {{STR|"TR$SOLICITUD_TRAMITACION"}};
-{{AT|universo}} = [Solicitud de tramitación electrónica para acreditación del profesorado];
{{PR|columna}} [Denominación/Apellidos y nombre]
-{{AT|columna_bd.nombre}} = {{STR|"DENOMINACION"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} =[Datos generales].[Denominación/Apellidos y nombre];
{{PR|columna}} [C.I.F./N.I.F.]
-{{AT|columna_bd.nombre}} = {{STR|"CIF_NIF"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[C.I.F./N.I.F.];
{{PR|columna}} [Estado tramite]
-{{AT|columna_bd.nombre}} = {{STR|"ESTADO_TRAMITE"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[Estado tramite];
{{PR|fin}}

A continuación un ejemplo de como se declararía un trámite utilizando el atributo '''estado'''.

[Trámite de Acreditación del profesorado] {{PR|es}} tramite
-{{AT|descripcion}}='Procedimiento de tramitación para la aceditación del profesorado para la ACECAU';
-{{AT|grupo}}='Trámites Acecau';
-{{AT|Habitacion}}=[Oficina de evaluación del profesorado];
-{{AT|estado}}={{STR|"TR$SOLTRAMI_ACRE_PROF.ESTADO_TRAMITE"}};

Una vez declarado el atributo estado en el trámite, ya podemos proceder a modificar el estado de un trámite mediante código de método, del lenguaje ODL. Para ello solo debemos acceder al campo mediante código ODL, al campo que representa el estado en el contenedor que es ''maintarget'' del ''workflow'' asociado al trámite y asignarle el valor deseado que queremos que se muestre en la aplicación web del STE.

NOTA: PONER EJEMPLO DE UN METODO ASIGNADOLE UN VALOR AL CAMPO ESTADO

=Atributos especiales para los campos de ODL=
Junto con la aplicación web STE disponemos para el lenguaje ODL, de unos atributos especiales aplicables a la definición de componentes para poder definir ciertos aspectos del comportamiento de los componentes que interactuan con la aplicación web STE. A continuación listaremos y definiremos los atributos que ha añadido el STE al lenguage ODL.

'''tramitacion.visible'''

Atributo que permite ocultar l

Desarrollar con el STE

2009-06-01T14:02:09Z

Nmelian: /* Estado de un trámite */

__TOC__
=¿Que es un trámite?=
Un trámite es la definición del conjunto de tareas pertenecientes al ''workflow'', que van a interactuar con la aplicación web STE. Los trámites definidos están orientados a ser iniciados por el usuario desde la aplicación web, para que a continuación se inicie un proceso de ''workflow'' programado en ODL para la plataforma egeasy.
==Como se define un trámite==
Para definir un trámite tenemos que indicar el nombre del trámite y declararlo como tipo trámite. La sintaxis de un trámite sería el siguiente.

[Nombre del trámite] es tramite
-ATRIBUTOS
incluye TAREA
.
.
.
incluye TAREA
fin
==Atributos de un trámite==
Los atributos que podemos declarar para un trámite son los siguientes:
*'''descripcion''': Proporcionar un texto descriptivo sobre el trámite que se muestra en la interfaz web al crear el trámite.
*'''grupo''': Indica a que grupo de declaraciones pertenece el trámite.
*'''habitacion''': Indica en que habitación de nuestro sistema de información queremos que este disponible el trámite, para su realización.
*'''estado''': Indica que tabla y columna de una exportación va a almacenar el estado de un trámite.

==La clausula incluye==
Dentro de la definición del trámite, debemos especificar cuales son las tareas del ''wordflow'' que queremos que interactuen con el STE, para ello disponemos de la clausula '''incluye'''. Al utilizarla debemos especificar a continuación el nombre de la tarea e indicar una serie de atributos para especificar varios aspectos sobre el comportamiento de la tarea.

===Atributos de incluye===
Los atributos aplicables a las tareas que incluimos en un trámite pueden variar dependiendo del valor del atributo ''tipo'', por ejemplo los atributos de respuesta, solo son aplicables a las tareas con el valor en el atributo tipo igual a REQUERIMIENTO. Dicho esto, a continuación pasamos a listar los distintos atributos aplicables a la clausula incluye, que son los siguientes:

*'''Etiqueta''': Atributo que permite establecer el nombre que va a tener la tarea en la aplicación web del STE.

*'''Tipo''': Atributo que indica que tipo de comportamiento que va a tener la tarea. Los distintos valores que acepta este atributo son: INICIO, REQUERIMIENTO, NOTIFICACION y ENVIO_DOCUMENTACION.

*'''respuesta.etiqueta''': Atributo que indica que nombre va a tener la tarea respuesta correspondiente

*'''respuesta.descripcion''': Atributo para indicar una descripción sobre la tarea respuesta.

*'''respuesta.formulario''': Atributo para indicar el nombre del formulario, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, que se va a mostrar en la tarea de respuesta.

*'''respuesta.clasificador''': Atributo para indicar el nombre del clasificador, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, donde se van a guardar los documentos que se pueden adjuntar a una tarea respuesta, perteneciente a una tarea de tipo REQUERIMIENTO.

===Diferentes tipos de tareas===
En la aplicación web STE, una misma tarea de nuestro sistema de información se puede comportar de diferentes maneras, dependiendo de que valor tenga el atributo ''tipo'' al incluir una tarea al trámite.

'''Tareas de INICIO'''
Es aquella tarea que indica cual es la tarea que va a ser el inicio del trámite. En un trámite solo puede haber una tarea de tipo inicio. Esta tarea debe ser definida íntegramente como un proceso en ODL.

incluye [Tramitación de solicitud de becas]
-Tipo=INICIO;
-Etiqueta='Tramitación de solicitud de becas universitarias';

'''Tareas de REQUERIMIENTO'''
Son aquellas tareas donde ademas de mostrar información, queremos dar al usuario la posibilidad de responder a la tarea mostrada para rellenar un formulario o adjuntar alguna documentación requerida.

incluye [Esperar respuesta de requerimiento de documentación]
-Tipo=REQUERIMIENTO;
-Etiqueta='Respuesta al requerimiento de solicitud de becas universitarias';
-respuesta.etiqueta = "Responder al requerimiento";
-respuesta.descripcion = "Adjunte todo lo solicitado en el documento enviado";
-respuesta.formulario = [Respuesta];
-respuesta.clasificador = [Documentos adjuntos];

'''Tareas de NOTIFICACION'''
Son aquellas tareas donde solo se le va a permitir al usuario del STE observar la información que ha sido mandada desde la plataforma egeasy, donde no podrá ni enviar información, ni modificar la información mandada. Este tipo de tareas suele estar reservados para aquellos datos que son de notificación, como las resoluciones.

incluye [Notificar resolución de la solicitud de beca universitaria]
-Tipo=NOTIFICACION;
-Etiqueta='Darse por notificado de la resolución de la solicitud de beca universitaria';

'''Tareas de ENVIO_DOCUMENTACION'''
Son aquellas tareas fuera del ''workflow'' que permiten al usuario de la aplicación web STE enviar documentación. Este tipo de tareas se pueden iniciar en cualquier momento durante la vida del trámite.

incluye [Registrar aporte de documentación al trámite]
-Tipo=ENVIO_DOCUMENTACION;
-Etiqueta='Aportar documentación adicional al trámite';

=Colecciones=
Como al definir un tramite su main target tiene que ser el contenedor que se mostrará en la web para que el usuario introduzca los datos iniciales para comenzar el tramite y no un expediente como se suele hacer cuando programamos un sistema de informaciaón en egeasy, tendremos que crearnos una colección ([[Colecciones]]) para almacenar inicialmente los contenedores creados por la aplicación STE al iniciar un trámite, para luego a posteriori mover ese contenedor a su lugar dentro de alguna coleccion dentro de un expediente.

=Estado de un trámite=
Los trámites en la aplicación web STE, tienen estado. El estado de un trámite acabado de iniciar pero no enviado, tiene el valor de ''borrador''. Una vez enviado su primera tarea del trámite, este pasa a tener el valor de ''En trámite''. Por último cuando el trámite ha finalizado en la plataforma egeasy, el trámite pasa a tener el estado de ''finalizado''. Estos valores comentados para el estado de un trámite, es el comportamiento por defecto de la aplicación web STE. Si queremos cambiar el estado de un trámite debemos hacerlo mediante el atributo '''estado''' y su mecanismo para controlarlo, el cual vamos a proceder a explicarlo a continuación.

Para poder modificar el estado de un tramite durante la vida del ''workflow'' asociado al trámite, debemos crearnos un campo en el contenedor que es ''maintarget'' del ''workflow''. Una vez creado ese campo, debemos hacer una exportación de ese campo en alguna colección de nuestra elección. Si hay alguna duda sobre como crear una exportación, véase [[Exportaciones]]. Con la exportación del campo creada, debemos poner en el atributo '''estado''' del trámite, una ristra con el nombre de la tabla en la base de datos seguida de un punto y a continuación el nombre de la columna que representa el campo en la exportación. Para que quede mas claro, vamos a ver un ejemplo:

Esto seria un ejemplo de la exportación creada, donde tenemos un campo llamado en ODL [Estado tramite], el cual se exporta a la tabla de nombre TR$SOLICITUD_TRAMITACION y en la columna ESTADO_TRAMITE.

[EP::Solicitudes de tramitación electrónica] {{PR|es}} exportacion
-{{AT|nombre_tabla}} = {{STR|"TR$SOLICITUD_TRAMITACION"}};
-{{AT|universo}} = [Solicitud de tramitación electrónica para acreditación del profesorado];
{{PR|columna}} [Denominación/Apellidos y nombre]
-{{AT|columna_bd.nombre}} = {{STR|"DENOMINACION"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} =[Datos generales].[Denominación/Apellidos y nombre];
{{PR|columna}} [C.I.F./N.I.F.]
-{{AT|columna_bd.nombre}} = {{STR|"CIF_NIF"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[C.I.F./N.I.F.];
{{PR|columna}} [Estado tramite]
-{{AT|columna_bd.nombre}} = {{STR|"ESTADO_TRAMITE"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[Estado tramite];
{{PR|fin}}

A continuación un ejemplo de como se declararía un trámite utilizando el atributo '''estado'''.

[Trámite de Acreditación del profesorado] {{PR|es}} tramite
-{{AT|descripcion}}='Procedimiento de tramitación para la aceditación del profesorado para la ACECAU';
-{{AT|grupo}}='Trámites Acecau';
-{{AT|Habitacion}}=[Oficina de evaluación del profesorado];
-{{AT|estado}}={{STR|"TR$SOLTRAMI_ACRE_PROF.ESTADO_TRAMITE"}};

Una vez declarado el atributo estado en el trámite, ya podemos proceder a modificar el estado de un trámite mediante código de método, del lenguaje ODL. Para ello solo debemos acceder al campo mediante código ODL, al campo que representa el estado en el contenedor que es ''maintarget'' del ''workflow'' asociado al trámite y asignarle el valor deseado que queremos que se muestre en la aplicación web del STE.

NOTA: PONER EJEMPLO DE UN METODO ASIGNADOLE UN VALOR AL CAMPO ESTADO

=Atributos especiales para los campos de ODL=
Junto con la aplicación web STE disponemos para el lenguaje ODL, de unos atributos especiales aplicables a la definición de componentes para poder definir ciertos aspectos del comportamiento de los componentes que interactuan con la aplicación web STE. A continuación listaremos y definiremos los atributos que ha añadido el STE al lenguage ODL.

'''tramitacion.visible'''

Atributo que permite ocultar l

Desarrollar con el STE

2009-06-01T14:01:23Z

Nmelian: /* Estado de un trámite */

__TOC__
=¿Que es un trámite?=
Un trámite es la definición del conjunto de tareas pertenecientes al ''workflow'', que van a interactuar con la aplicación web STE. Los trámites definidos están orientados a ser iniciados por el usuario desde la aplicación web, para que a continuación se inicie un proceso de ''workflow'' programado en ODL para la plataforma egeasy.
==Como se define un trámite==
Para definir un trámite tenemos que indicar el nombre del trámite y declararlo como tipo trámite. La sintaxis de un trámite sería el siguiente.

[Nombre del trámite] es tramite
-ATRIBUTOS
incluye TAREA
.
.
.
incluye TAREA
fin
==Atributos de un trámite==
Los atributos que podemos declarar para un trámite son los siguientes:
*'''descripcion''': Proporcionar un texto descriptivo sobre el trámite que se muestra en la interfaz web al crear el trámite.
*'''grupo''': Indica a que grupo de declaraciones pertenece el trámite.
*'''habitacion''': Indica en que habitación de nuestro sistema de información queremos que este disponible el trámite, para su realización.
*'''estado''': Indica que tabla y columna de una exportación va a almacenar el estado de un trámite.

==La clausula incluye==
Dentro de la definición del trámite, debemos especificar cuales son las tareas del ''wordflow'' que queremos que interactuen con el STE, para ello disponemos de la clausula '''incluye'''. Al utilizarla debemos especificar a continuación el nombre de la tarea e indicar una serie de atributos para especificar varios aspectos sobre el comportamiento de la tarea.

===Atributos de incluye===
Los atributos aplicables a las tareas que incluimos en un trámite pueden variar dependiendo del valor del atributo ''tipo'', por ejemplo los atributos de respuesta, solo son aplicables a las tareas con el valor en el atributo tipo igual a REQUERIMIENTO. Dicho esto, a continuación pasamos a listar los distintos atributos aplicables a la clausula incluye, que son los siguientes:

*'''Etiqueta''': Atributo que permite establecer el nombre que va a tener la tarea en la aplicación web del STE.

*'''Tipo''': Atributo que indica que tipo de comportamiento que va a tener la tarea. Los distintos valores que acepta este atributo son: INICIO, REQUERIMIENTO, NOTIFICACION y ENVIO_DOCUMENTACION.

*'''respuesta.etiqueta''': Atributo que indica que nombre va a tener la tarea respuesta correspondiente

*'''respuesta.descripcion''': Atributo para indicar una descripción sobre la tarea respuesta.

*'''respuesta.formulario''': Atributo para indicar el nombre del formulario, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, que se va a mostrar en la tarea de respuesta.

*'''respuesta.clasificador''': Atributo para indicar el nombre del clasificador, perteneciente al ''target'' de la tarea de tipo REQUERIMIENTO, donde se van a guardar los documentos que se pueden adjuntar a una tarea respuesta, perteneciente a una tarea de tipo REQUERIMIENTO.

===Diferentes tipos de tareas===
En la aplicación web STE, una misma tarea de nuestro sistema de información se puede comportar de diferentes maneras, dependiendo de que valor tenga el atributo ''tipo'' al incluir una tarea al trámite.

'''Tareas de INICIO'''
Es aquella tarea que indica cual es la tarea que va a ser el inicio del trámite. En un trámite solo puede haber una tarea de tipo inicio. Esta tarea debe ser definida íntegramente como un proceso en ODL.

incluye [Tramitación de solicitud de becas]
-Tipo=INICIO;
-Etiqueta='Tramitación de solicitud de becas universitarias';

'''Tareas de REQUERIMIENTO'''
Son aquellas tareas donde ademas de mostrar información, queremos dar al usuario la posibilidad de responder a la tarea mostrada para rellenar un formulario o adjuntar alguna documentación requerida.

incluye [Esperar respuesta de requerimiento de documentación]
-Tipo=REQUERIMIENTO;
-Etiqueta='Respuesta al requerimiento de solicitud de becas universitarias';
-respuesta.etiqueta = "Responder al requerimiento";
-respuesta.descripcion = "Adjunte todo lo solicitado en el documento enviado";
-respuesta.formulario = [Respuesta];
-respuesta.clasificador = [Documentos adjuntos];

'''Tareas de NOTIFICACION'''
Son aquellas tareas donde solo se le va a permitir al usuario del STE observar la información que ha sido mandada desde la plataforma egeasy, donde no podrá ni enviar información, ni modificar la información mandada. Este tipo de tareas suele estar reservados para aquellos datos que son de notificación, como las resoluciones.

incluye [Notificar resolución de la solicitud de beca universitaria]
-Tipo=NOTIFICACION;
-Etiqueta='Darse por notificado de la resolución de la solicitud de beca universitaria';

'''Tareas de ENVIO_DOCUMENTACION'''
Son aquellas tareas fuera del ''workflow'' que permiten al usuario de la aplicación web STE enviar documentación. Este tipo de tareas se pueden iniciar en cualquier momento durante la vida del trámite.

incluye [Registrar aporte de documentación al trámite]
-Tipo=ENVIO_DOCUMENTACION;
-Etiqueta='Aportar documentación adicional al trámite';

=Colecciones=
Como al definir un tramite su main target tiene que ser el contenedor que se mostrará en la web para que el usuario introduzca los datos iniciales para comenzar el tramite y no un expediente como se suele hacer cuando programamos un sistema de informaciaón en egeasy, tendremos que crearnos una colección ([[Colecciones]]) para almacenar inicialmente los contenedores creados por la aplicación STE al iniciar un trámite, para luego a posteriori mover ese contenedor a su lugar dentro de alguna coleccion dentro de un expediente.

=Estado de un trámite=
Los trámites en la aplicación web STE, tienen estado. El estado de un trámite acabado de iniciar pero no enviado, tiene el valor de ''borrador''. Una vez enviado su primera tarea del trámite, este pasa a tener el valor de ''En trámite''. Por último cuando el trámite ha finalizado en la plataforma egeasy, el trámite pasa a tener el estado de ''finalizado''. Estos valores comentados para el estado de un trámite, es el comportamiento por defecto de la aplicación web STE. Si queremos cambiar el estado de un trámite debemos hacerlo mediante el atributo '''estado''' y su mecanismo para controlarlo, el cual vamos a proceder a explicarlo a continuación.

Para poder modificar el estado de un tramite durante la vida del ''workflow'' asociado al trámite, debemos crearnos un campo en el contenedor que es ''maintarget'' del ''workflow''. Una vez creado ese campo, debemos hacer una exportación de ese campo en alguna colección de nuestra elección. Si hay alguna duda sobre como crear una exportación, véase [[Exportaciones]]. Con la exportación del campo creada, debemos poner en el atributo '''estado''' del trámite, una ristra con el nombre de la tabla en la base de datos seguida de un punto y a continuación el nombre de la columna que representa el campo en la exportación. Para que quede mas claro, vamos a ver un ejemplo:

Esto seria un ejemplo de la exportación creada, donde tenemos un campo llamado en ODL [Estado tramite], el cual se exporta a la tabla de nombre TR$SOLICITUD_TRAMITACION y en la columna ESTADO_TRAMITE.

[EP::Solicitudes de tramitación electrónica] {{PR|es}} exportacion
-{{AT|nombre_tabla}} = {{STR|"TR$SOLICITUD_TRAMITACION"}};
-{{AT|universo}} = [Solicitud de tramitación electrónica para acreditación del profesorado];
{{PR|columna}} [Denominación/Apellidos y nombre]
-{{AT|columna_bd.nombre}} = {{STR|"DENOMINACION"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} =[Datos generales].[Denominación/Apellidos y nombre];
{{PR|columna}} [C.I.F./N.I.F.]
-{{AT|columna_bd.nombre}} = {{STR|"CIF_NIF"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[C.I.F./N.I.F.];
{{PR|columna}} [Estado tramite]
-{{AT|columna_bd.nombre}} = {{STR|"ESTADO_TRAMITE"}};
-{{AT|columna_bd}}.{{PR|tipo}} = texto;
-{{AT|origen}} = [Datos generales].[Estado tramite];
{{PR|fin}}

A continuación un ejemplo de como se declararía un trámite utilizando el atributo '''estado'''.

[Trámite de Acreditación del profesorado] {{PR|es}} tramite
-{{AT|descripcion}}='Procedimiento de tramitación para la aceditación del profesorado para la ACECAU';
-{{AT|grupo}}='Trámites Acecau';
-{{AT|Habitacion}}=[Oficina de evaluación del profesorado];
-{{AT|estado}}={{STR|"TR$SOLTRAMI_ACRE_PROF.ESTADO_TRAMITE"}};

Una vez declarado el atributo estado en el trámite, ya podemos proceder a modificar el estado de un trámite mediante código de método, del lenguaje ODL. Para ello solo debemos acceder al campo mediante código ODL, al campo que representa el estado en el contenedor que es ''maintarget'' del ''workflow'' asociado al trámite y asignarle el valor deseado que queremos que se muestre en la aplicación web del STE.

=Atributos especiales para los campos de ODL=
Junto con la aplicación web STE disponemos para el lenguaje ODL, de unos atributos especiales aplicables a la definición de componentes para poder definir ciertos aspectos del comportamiento de los componentes que interactuan con la aplicación web STE. A continuación listaremos y definiremos los atributos que ha añadido el STE al lenguage ODL.

'''tramitacion.visible'''

Atributo que permite ocultar l

Desarrollar con el STE

2009-06-01T13:13:10Z

Nmelian: /* Estado de un trámite */

Desarrollar con el STE

2009-06-01T11:10:14Z

Nmelian:

Desarrollar con el STE

2009-05-29T15:10:40Z

Nmelian: Como se desarrolla trasladada a Desarrollar con el STE: Nombre indicado por Dani

__TOC__
=¿Que es un trámite?=
Un trámite es la definición del conjunto de tareas pertenecientes al workflow, que van a interactuar con la aplicación web STE. Los trámites definidos están orientados a ser iniciados por el usuario desde la aplicación web, para que a continuación se inicie un proceso de workflow programado en ODL para la plataforma egeasy.
==Como se define un trámite==
Para definir un trámitetenemos que indicar el nombre del trámite y declararlo como tipo trámite. La sintaxis de un trámite sería el siguiente.

[Nombre del trámite] es tramite
-ATRIBUTOS
incluye TAREA
.
.
.
incluye TAREA
fin
==Atributos de un trámite==
Los atributos que podemos declarar para un trámite son los siguientes:
*'''descripcion''': Proporcionar un texto descriptivo sobre el trámite que se muestra en la interfaz web al crear el trámite.
*'''grupo''': Indica a que grupo de declaraciones pertenece el trámite.
*'''Habitacion''': Indica en que habitación de nuestro sistema de información queremos que este disponible el trámite, para su realización.
*'''estado''': Indica que tabla y columna de una exportación va a almacenar el estado de un trámite.

==La clausula incluye==
Dentro de la definición del trámite, debemos especificar cuales son las tareas del wordflow que queremos que interactuen con el STE, para ello disponemos de la clausula '''incluye'''. Al utilizarla debemos especificar a continuación el nombre de la tarea e indicar una serie de atributos para especificar varios aspectos sobre el comportamiento de la tarea.

===Atributos de incluye===
Los atributos aplicables a las tareas que incluimos en un trámite pueden variar dependiendo del valor del atributo ''tipo'', por ejemplo los atributos de respuesta, solo son aplicables a las tareas con el valor en el atributo tipo igual a REQUERIMIENTO. Dicho esto, a continuación pasamos a listar los distintos atributos aplicables a la clausula incluye, que son los siguientes:

*'''Etiqueta''': Atributo que permite establecer el nombre que va a tener la tarea en la aplicación web del STE.

*'''Tipo''': Atributo que indica que tipo de comportamiento que va a tener la tarea. Los distintos valores que acepta este atributo son: INICIO, REQUERIMIENTO, NOTIFICACION y ENVIO_DOCUMENTACION.

*'''respuesta.etiqueta''': Atributo que indica que nombre va a tener la tarea respuesta correspondiente

*'''respuesta.descripcion''': Atributo para indicar una descripción sobre la tarea respuesta.

*'''respuesta.formulario''': Atributo para indicar el nombre del formulario, perteneciente al target de la tarea de tipo REQUERIMIENTO, que se va a mostrar en la tarea de respuesta.

*'''respuesta.clasificador''': Atributo para indicar el nombre del clasificador, perteneciente al target de la tarea de tipo REQUERIMIENTO, donde se van a guardar los documentos que se pueden adjuntar a una tarea respuesta, perteneciente a una tarea de tipo REQUERIMIENTO.

===Diferentes tipos de tareas===
En la aplicación web STE, una misma tarea de nuestro sistema de información se puede comportar de diferentes maneras, dependiendo de que valor tenga el atributo ''tipo'' al incluir una tarea al trámite.

'''Tareas de INICIO'''
Es aquella tarea que indica cual es la tarea que va a ser el inicio del trámite. En un trámite solo puede haber una tarea de tipo inicio. Esta tarea debe ser definida íntegramente como un proceso en ODL.

incluye [Tramitación de solicitud de becas]
-Tipo=INICIO;
-Etiqueta='Tramitación de solicitud de becas universitarias';

'''Tareas de REQUERIMIENTO'''
Son aquellas tareas donde ademas de mostrar información, queremos dar al usuario la posibilidad de responder a la tarea mostrada para rellenar un formulario o adjuntar alguna documentación requerida.

incluye [Esperar respuesta de requerimiento de documentación]
-Tipo=REQUERIMIENTO;
-Etiqueta='Respuesta al requerimiento de solicitud de becas universitarias';
-respuesta.etiqueta = "Responder al requerimiento";
-respuesta.descripcion = "Adjunte todo lo solicitado en el documento enviado";
-respuesta.formulario = [Respuesta];
-respuesta.clasificador = [Documentos adjuntos];

'''Tareas de NOTIFICACION'''
Son aquellas tareas donde solo se le va a permitir al usuario del STE observar la información que ha sido mandada desde la plataforma egeasy, donde no podrá ni enviar información, ni modificar la información mandada. Este tipo de tareas suele estar reservados para aquellos datos que son de notificación, como las resoluciones.

incluye [Notificar resolución de la solicitud de beca universitaria]
-Tipo=NOTIFICACION;
-Etiqueta='Darse por notificado de la resolución de la solicitud de beca universitaria';

'''Tareas de ENVIO_DOCUMENTACION'''
Son aquellas tareas fuera del workflow que permiten al usuario de la aplicación web STE enviar documentación. Este tipo de tareas se pueden iniciar en cualquier momento durante la vida del trámite.

incluye [Registrar aporte de documentación al trámite]
-Tipo=ENVIO_DOCUMENTACION;
-Etiqueta='Aportar documentación adicional al trámite';

=Colecciones=

=Estado de un trámite=

=Atributos especiales para los campos de ODL=
Junto con la aplicación web STE disponemos para el lenguaje ODL, de unos atributos especiales aplicables a la definición de componentes para poder definir ciertos aspectos del comportamiento de los componentes que interactuan con la aplicación web STE. A continuación listaremos y definiremos los atributos que ha añadido el STE al lenguage ODL.

'''tramitacion.visible'''

Este atributo per
-sirve para ocular un campo para que no se muestre en la aplicacion web del STE
-aplicable a todos los campos como en EGE

'''tramitacion.requerida'''

-sirve para indicar que se debe cumplimentar el campo al que se le aplica el atributo. El valor por defecto es falso. Esto se puede usar en combinacion con las validaciones de ODL para indicar como se debe cumplimentar un campo.

'''tramitacion.valor'''

-sirve para establecer el valor del campo al que se le aplica el atributo. Esto es similar al edicion.modo=copia de ODL. Lo utilizamos para poder acceder a los datos del usuario registrado de la aplicación STE.


[[Category:Tramitación electrónica]]