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

De Egeasy
Revisión del 09:39 17 jun 2009 de Nmelian (Discusión | contribuciones) (Requisitos)

Saltar a: navegación, buscar

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, debemos disponer


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 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

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