> 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/connect-v2.1/instalacion/migracion/perfiles.md). # Migración de los perfiles Se distribuyen con la instalación de Connect dos aplicaciones de línea de comndos para crear automáticamente contactos y canales a partir de los perfiles de las presentaciones y sesiones existentes en la instalación de Editran. La entrada con la información, que se incorporará a la base de datos de Connect, será los ficheros de texto con los perfiles volcados con los comandos **igaperfi.exe** y **ediperfi.exe**. Estos ficheros podrán obtenerse de forma automática de la instalación de Editran 5.2.2 por los comandos anteriores o se podrá obtener de forma manual, por ejemplo, en caso de que se quiera hacer una selección de las sesiones a incorporar. ## Requisitos Se debe haber realizado la configuración inicial de la aplicación de Editran Connect y tiene que estar ejecutándose los servicios de Connect (Editran Connect Base). Además, las sesiones deben tener el campo nombre del código local y remoto configurado junto a que dos códigos remotos diferentes no compartan el mismo nombre. Para migrar unos perfiles específicos, los ficheros deben tener los siguientes nombres: * salidaP para el fichero de sesiones que se obtiene al ejecutar ```bash ediperfi -r --a --osalidaP. ``` * salidaG para el fichero de presentaciones que se obtiene al ejecutar ```bash igaperfi -r --a --osalidaG. ``` Los nombres de los ficheros salidaP y salidaG no deben contener ninguna extensión que los acompañe como ".txt" y deben de estar ubicados en: `\ /bin.` ## Uso 1. Abrir una terminal de CMD. 2. Ir a la ruta `*\/utils*`, donde se encuentran ubicados los ficheros *migraContactos.bat* y *migraCanales.bat*. 3. En el terminal, ejecutar primero *migraContactos.bat*: 1. *migraContactos.bat -f* si se quiere usar un fichero de perfiles específico. *Usar el modificador --f/-f1/-f2 dependiendo del contenido del fichero:* * *--f para ficheros que contengan el perfil local y la/s sesiones,* * *-f1 para ficheros que únicamente contengan el perfil local y* * *--f2 para ficheros que contienen únicamente sesiones.* 2. *migraContactos.bat -e* si se quiere migrar todos los perfiles de Editran. 4. Después se ejecutará *migraCanales.bat* 1. *migraCanales.bat -f* si se quiere usar un fichero de perfiles específico. 2. *migraCanales.bat -e* si se quiere migrar todos los perfiles de Editran. 5. Revisar los ficheros *conflictosREMOTOS.txt* y *conflictosCANALES.txt* ubicados en la ruta *\ /log/migrar* 6. Una vez revisados los ficheros de conflictos se deberán solucionar los problemas encontrados modificando los perfiles indicados y volviendo a ejecutar de nuevo la migración. En el caso de haber realizado la migración de todos los perfiles de Editran, se puede: 1. Modificar los perfiles en los ficheros *salidaP* y *salidaG* y volver a ejecutar el programa con la opción de fichero de perfiles específicos (*-f*). 2. Modificar los perfiles en Editran y volver a ejecutar el programa con la opción de migrar todos los perfiles (*-e*). 7. Es necesario modificar los perfiles de editrang con los scripts de integración de Connect en los programas previos (.\utils\EC\_PREVTX.bat), posteriores (.\utils\EC\_POSTTX.bat) y excepción (.\utils\EC\_EXCTX.bat) de emisión/recepción. Esta configuración se puede realizar desde las aplicaciones de Editran *modiperfi* o Modi*Connect.exe\* (ejecutar y seguir las instrucciones en pantalla)*. Los canales migrados no serán funcionales hasta que no se modifiquen los perfiles de editrang. \*ModiConnect.exe es una nueva utilidad de Connect para facilitar la tarea de modificación de los perfiles de editrang para actualizarlos con los scripts de integración de Connect. ## Cuestiones importantes 1. El programa intenta traducir los perfiles al nuevo formato de Connect lo mejor posible, pero no siempre es posible y se generarán los ficheros de conflicto. Para el fichero de *conflictosREMOTOS.txt* da una explicación lo suficientemente detallada sobre los problemas al migrar. Para el fichero de *conflictosCANALES.txt* no se puede ofrecer una información específica por el distinto funcionamiento de Connect. 2. *migraContactos.bat* no realizará la migración si detecta errores graves al comprobar los perfiles de Editran. 3. *migraCanales.bat* intentará migrar todos los canales posibles. Aquellos que no han sido posible son indicados en el log del fichero de conflictos. 4. Si las verificaciones de *migraContactos.bat* no se cumpliesen para algún perfil, se empezará a crear contactos en Connect ignorando aquellos que den error. En el fichero de *conflictosREMOTOS.txt* se podrán consultar los que han dado error. 5. Los scripts de usuarios de los perfiles de presentación se importan a los canales de Connect y se ejecutarán después de los propios scripts de Connect de integración. El programa de migración intenta encontrar las rutas absolutas de los scripts cuando estas son relativas en los perfiles de Editran, de lo contrario se pondrá la misma de Editran y se deberá editar desde Connect. 6. Si se modifica un canal desde Connect se deberá mantener exclusivamente desde Connect en adelante y evitar su modificación desde las aplicaciones de Editran. Esto es porque la configuración de los perfiles desde las aplicaciones de Editran no está sincronizada con Connect y los cambios realizados desde estas otras aplicaciones no tienen un reflejo automático en la configuración de Connect. 7. Si se ha ejecutado cualquier comando con --e, **no** volver a usar este argumento a menos que se borren los ficheros salidaP y salidaG. 8. El nombre que tendrán los códigos locales será el primero que encuentre junto al primer perfil que tenga el código local, es decir, si el código local "111222333" aparece en dos perfiles y cada uno tiene de parámetro nombre local un valor distinto, utilizará en Connect el valor del que aparezca primero en el fichero de perfiles. ## Errores posibles 1. No se ha especificado *-e* o *-f*. La aplicación informará al usuario como debe de realizar la ejecución. 2. Los servicios de Connect no están ejecutándose y se ha intentado usar el migrador de perfiles. En este caso el programa avisará que no ha sido posible conectarse con el servidor remoto (Connect). 3. Errores numerados. Se trata de errores internos del programa (bug) y no se puede indicar la causa exacta. Reportar el problema al proveedor de Connect para que pueda ser analizado por el equipo de desarrollo. ## Ejemplo de importación de perfiles desde Editran Primero se ejecutará *migraContactos.bat -e.* ![Ejecución de migraContactos.bat -e.](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-c5d323d0e9569857767a7a73050c742229690c8a%2Fimage179.png?alt=media) Y después se ejecutará *migraCanales.bat -e.* ![Ejecución de migraCanales.bat -e.](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-3e1d6229718f98b077cec425b6c5cca36c64bc1c%2Fimage180.png?alt=media) A continuación, se deberán revisar los logs correspondientes para comprobar si ha habido contactos o canales que no se han podido añadir. ![Comprobación de la migración de contactos.](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-107a0e23b087f46617dd8bc2dcc0a749076eca47%2Fimage181.png?alt=media) ![Comprobación de la migración de canales.](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-94009bf81f30bb4c9f2d088febdb08e203fd2e0b%2Fimage182.png?alt=media) --- # 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/connect-v2.1/instalacion/migracion/perfiles.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.