Cómo integrar el Sistema de Tramitación Electrónica en egeasy
Contenido
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
Copiar a c:\ste
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\acecau\Docs WS_DIRECTORY_LOGS=C:\STE\acecau\Logs WS_FILE_INVALID_WORDS=C:\STE\acecau\palabras.dat TYPE_REGISTRATION=Free REGISTRATION_FORM=C:\STE\acecau\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 el servicio web del Sistema de Tramitación Electrónica, debemos modificar el fichero de configuración llamado ste.conf que esta en la ruta C:\STE\tramitacion, 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
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