> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/editran-sepa-v3/requisitos-e-instalacion.md). # Requisitos e instalación ## 3.1 Requisitos de la instalación Las versiones de Editran compatibles con el módulo Editran/SEPA son la 5.0 ó superior. Alguna de ellas deberá estar instalada para hacer uso conjunto de ambos productos. Además, debido a que la nueva funcionalidad se ha desarrollado en Java, en la máquina deberá estar instalado también Java 6 o superior. Si no lo tuviera puede descargarlo desde la página oficial de Oracle. ## 3.2 Instrucciones para la instalación El procedimiento a seguir para instalar el módulo Editran/SEPA, en cualquiera de los sistemas operativos, será descargar de la página de Editran el correspondiente fichero y seguidamente descomprimirlo, obteniendo la siguiente estructura de carpetas: ``` |SEPA |--conf |--doc |--lib |--logs |--scripts |---utils ``` Además se debe preparar el entorno de usuario para poder ejecutar aplicaciones JAVA. A continuación se detalla cómo proceder en concreto según el sistema operativo. ### UNIX El cliente recibirá o se descargará de la página de Editran un fichero `.tar` con el paquete para su SO y guardará el fichero en el directorio donde se vaya a instalar. Puede crear un directorio nuevo o bien dejarlo en el directorio donde tenga instalado Editran. En cualquier caso el producto creará el subdirectorio SEPA con el nuevo software. Suponiendo que el SO es Solaris y que por defecto lo vamos a instalar en el mismo directorio que Editran (por ejemplo en `/opt/editran`), se seguirán los siguientes pasos: 1. Dejar el fichero en `/opt/editran` 2. Situarse en `/opt/editran` y descomprimir y extraer el software, ejecutando: ``` tar -xvf sepa-unix.V#.##-YYYY-MM-DD.tar ``` 3. Si no lo tuviera ya definido, incluir en `.profile` o `.chsrc` (dependiendo de la shell) las variables de entorno: * `JAVA_HOME` = \[Ruta de instalación de java] * Añadir a la variable `PATH` la variable `$(JAVA_HOME)/bin` 4. Editar el fichero `SEPA/scripts/EntornoSepa` para definir: * La ruta contenida en variable `DIR_SEPA` con la ubicación del directorio de instalación de SEPA (sin utilizar rutas relativas). ``` # ----------------------------------------------------------- # ------------ DEFINICIONES DE INSTALACION ------------------ # ----------------------------------------------------------- DIR_SEPA=/opt/editran/SEPA ``` * La variable `PATH` con el directorio de instalación del producto Editran y el directorio de instalación de java (sin utilizar rutas relativas). ``` # Directorio bin de editran y directorio de instalación java PATH="/opt/editran/bin:/path/to/java:$PATH" # ----------------------------------------------------------- ``` * Editar los scripts: * `checkLic.sh` * `PRVEMISEPA.sh` * `PSTEMISEPA.sh` * `PSTRECSEPA.sh` * `SEPA.sh` Para ajustar la ruta del fichero EntornoSepa con su ubicación en la instalación (sin utilizar rutas relativas). ``` # ------------ DEFINICIONES DE INSTALACION ------------------ ENT_SEPA=/opt/editran/SEPA/scripts/EntornoSepa # ----------------------------------------------------------- ``` ### Windows El cliente recibirá o se descargará de la página de Editran el fichero comprimido `.zip` con la distribución para Windows. Al descomprimir en el directorio de destino deseado se creará un subdirectorio llamado SEPA con el nuevo software. Una vez finalizada la descompresión se deben realizar las siguientes acciones: 1. Editar el fichero `SEPA/scripts/EntornoSepa.bat` para definir: * La ruta contenida en variable `DIR_SEPA` con la ubicación del directorio de instalación de SEPA (sin utilizar rutas relativas). ``` rem ------------------------------------------------------------- rem DEFINICIONES DE INSTALACION rem ------------------------------------------------------------- set DIR_SEPA=C:\SEPA ``` * La variable `PATH` con el directorio bin de la instalación del producto Editran y el directorio de instalación de java (sin utilizar rutas relativas). ``` # Directorio bin de editran y directorio de instalación java set PATH="C:\editran\bin;\path\to\java;"%PATH% # ----------------------------------------------------------- ``` * Editar los scripts: * `checkLic.bat` * `PRVEMISEPA.bat` * `PSTEMISEPA.bat` * `PSTRECSEPA.bat` * `SEPA.bat` Para ajustar la ruta del fichero EntornoSepa con su ubicación en la instalación (sin utilizar rutas relativas). ``` rem ------------------------------------------------------------- rem DEFINICIONES DE INSTALACION rem ------------------------------------------------------------- set FENTORNO=C:\SEPA\scripts\EntornoSepa.bat rem ------------------------------------------------------------- ``` 2. Acceder a: **Panel de Control → Sistema y seguridad → Sistema → Configuración avanzada del sistema → Opciones avanzadas → Variables de entorno.** En la ventana que se muestra se definirán y modificarán las siguientes variables de entorno: * `JAVA_HOME`: Deberá definir `JAVA_HOME` como variable de entorno con la ruta donde está instalado el Java que quiere utilizar y modificar la variable `PATH` para que incluya la ruta donde Java esté instalado. ![Foto](https://605131618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYRsCBWELAyzw5mj5JFUW%2Fuploads%2Fgit-blob-256085d285dfd4feefac00a421d830958c401872%2Fimage.avif?alt=media) ``` Por ejemplo, la instalación de Java se encuentra en `C:\Program Files\Java\jre1.8.0_25`. Se tendría que configurar la variable `JAVA_HOME` de la siguiente manera. ![Foto](Instrucciones%20para%20la%20instalacion/images/image.avif1.avif) ``` * `PATH`: Modificar la variable `PATH` añadiendo al principio `%JAVA_HOME%\bin`, separándola con un punto y coma (`;`). ![Foto](https://605131618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYRsCBWELAyzw5mj5JFUW%2Fuploads%2Fgit-blob-b4b2f2e70e798fb2c8d96a133a7cb570ea18f3e1%2Fimage%20\(2\).avif?alt=media) ## 3.3 Módulos instalados Los módulos que integran el producto Editran/SEPA se ordenan según el siguiente árbol: 1. **SEPA**: Contiene el árbol de directorios, el manual de usuario y el fichero `public.key` necesario para el correcto funcionamiento de la licencia de Editran/SEPA. 2. **SEPA/conf**: Contiene la configuración de los parámetros adicionales de Editran/SEPA, del log y la configuración de las entidades a convertir. 3. **SEPA/doc**: Contiene la documentación en Javadoc necesaria para, si se desea, utilizar el módulo Editran/SEPA como una librería. 4. **SEPA/lib**: Contiene las librerías java que implementan la funcionalidad para la conversión así como los esquemas que tienen que cumplir los formatos XML. Dentro de esta carpeta hay subcarpetas diferenciando cada Sistema Operativo donde se incluyen las librerías correspondientes para cada uno. 5. **SEPA/logs**: En este directorio se guardará el fichero de log que genera el programa. 6. **SEPA/scripts**: Contiene scripts de ejemplo como los que deberán ser incorporados en los procesos de usuario previo de emisión o posterior a recepción cuando el cliente quiera utilizar Editran/SEPA desde Editran/G y también un script para usar Editran/SEPA de forma autónoma. Incluye scripts para cada uno de los Sistemas Operativos en los que puede ser usado Editran/SEPA. También incluye scripts para la funcionalidad de Separar XML (requiere licencia específica, véase capítulo [9 Separador ficheros planos y XML](#9-separador-ficheros-planos-y-xml)). A su vez, la subcarpeta `/utils` incluye dos procedimientos: uno para rellenar con espacios los registros hasta alcanzar una longitud fija (pensados para ficheros con saltos de línea en los que se haya la longitud de cada línea sea variable) y otro para intercalar saltos de línea cada longitud fija (pensado para ficheros que no tengan ningún salto de línea). ## 3.4 Fichero de licencia El programa Editran/SEPA requiere un fichero de licencia, llamado `licencia.dat`, que debe estar situado en la carpeta raíz SEPA. Dicho fichero se solicitará al Soporte de Editran indicando el hostid y el sistema operativo de la máquina. Existen dos maneras de obtener dicha información: * Ejecutando el fichero `checkLic.bat`/`checkLic.sh` que hay en la carpeta `SEPA/scripts` de su Sistema Operativo. Al ejecutar este fichero, desde el la misma carpeta donde está alojado, se devolverá por pantalla el resultado de la comprobación de la licencia. Si se intenta ejecutar el programa Editran/SEPA sin licencia el programa fallará por licencia incorrecta quedando en el log el hostid y el sistema operativo de la máquina. *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.editran.onesait.com/documentacion-editran/editran-sepa-v3/requisitos-e-instalacion.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.