El programa auxiliar jtl-bridge

jtl-bridge es un pequeño programa de allverto para la migración. Funciona en el ordenador en el que funciona tu JTL-Wawi (normalmente un servidor Windows), lee allí los datos de tu Wawi y los transfiere cifrados a allverto. Para ello, ni la base de datos de tu Wawi ni el servidor REST de Wawi tienen que ser accesibles desde internet. No necesitas comandos: basta con un doble clic y pegar un código.

#Antes de empezar

No tienes que introducir nada antes. En allverto abre Configuración → Migración de datos → Migración desde JTL-Wawi, paso Conectar origen, y elige el origen: API de JTL-Wawi (consulta Configurar la API REST) o Base de datos de JTL (consulta Acceso a través de la base de datos de JTL).

Despliega después el cuadro ¿El servidor no es accesible desde internet? Transferir datos con jtl-bridge. Muestra los mismos pasos que aquí. La dirección, el servidor SQL, el usuario y la contraseña los pregunta el programa más tarde en tu servidor. Lo que allverto ya detecta se marca en el cuadro.

#Paso a paso

1. Descargar jtl-bridge. En el recuadro, haz clic en Descargar para Windows. El archivo se llama, p. ej., allverto-jtl-bridge-1.0.0-windows-x64.exe y no hay que instalarlo. Si el navegador advierte sobre el archivo, elige Conservar o Descargar de todas formas.
2. Copiar el archivo al servidor en el que funciona tu JTL-Wawi, p. ej. por Escritorio remoto al escritorio. Copia el archivo en tu PC (Ctrl + C) y pégalo en la ventana del Escritorio remoto, en el escritorio del servidor (Ctrl + V). También puedes abrir allverto directamente en el navegador del servidor y descargar allí el archivo.
3. En el servidor, iniciar el archivo con doble clic. Se abre una ventana con fondo negro. Si antes Windows muestra «Windows protegió su PC», haz clic en Más información y después en Ejecutar de todas formas: el programa aún no está firmado digitalmente.
4. Hacer clic aquí en «Generar código de configuración», copiar el código, pegarlo en la ventana con clic derecho y pulsar Enter. Al hacerlo, allverto crea la conexión con el origen elegido. Copia el código con Copiar código de configuración. Empieza por AVJTL1. y contiene todo lo que necesita el programa.
5. Responder a las preguntas de la ventana: normalmente basta con pulsar Enter. La propuesta entre corchetes suele ser correcta; entonces simplemente pulsa Enter. El programa comprueba la conexión al instante. Si no funciona, te explica el motivo y vuelve a preguntar. Los datos comprobados los entrega cifrados a allverto: la próxima vez ya no preguntará.
   • API de JTL-Wawi: el programa busca por sí mismo el servidor REST en este ordenador (puertos 5883 a 5890) y propone la dirección encontrada, p. ej. «Encontrado: http://localhost:5885/api/eazybusiness – pulsa Enter para usarlo.». Si no encuentra nada, te pregunta por la dirección del servidor REST. El puerto es el que configuraste en Wawi para el servidor REST (p. ej. 5883).
   • Base de datos de JTL: el programa pregunta por Servidor SQL [localhost], Instancia [JTLWAWI] (escribe un guion - si no hay), Base de datos [eazybusiness], Usuario [sa] y Contraseña. La contraseña no se ve al escribirla. Se trata de la contraseña de SQL Server, no de tu contraseña de JTL-Wawi.
6. Solo con el origen «API de JTL-Wawi»: registrar la aplicación en JTL-Wawi. La ventana te indica cuándo ha llegado el momento: Después, el programa entrega por sí mismo la clave API cifrada a allverto: no tienes que copiar nada. Si ya hay una clave guardada, este paso no hace falta.
   1. En JTL-Wawi, abre Anwendungsregistrierungen (registros de aplicaciones) → Anwendung registrieren (registrar aplicación) y avanza hasta Registrierung beginnen (iniciar registro). Allí aparece «Es wird auf die Übermittlung einer Registrierungsanfrage durch die zu registrierende Anwendung gewartet …» (esperando una solicitud de registro de la aplicación).
   2. Ahora pulsa Enter en la ventana de jtl-bridge. El programa envía la solicitud allverto – Umzug von JTL-Wawi. Si Wawi todavía no la acepta, el programa lo vuelve a intentar cada 5 segundos durante 10 minutos.
   3. En Wawi, revisa Anwendungsinformationen (información de la aplicación), elige un usuario de Wawi en Benutzer (usuario), confirma en Zugriffsverwaltung (gestión de accesos) los permisos solicitados (solo lectura) y haz clic en Einrichtung abschließen (completar la configuración).
7. Esperar hasta que aparezca «Listo»; allverto marcará entonces el paso. El programa comprueba primero la conexión, cuenta los datos y después los sube tipo de datos por tipo de datos. Según la cantidad de datos, tarda de unos minutos a varias horas. Deja la ventana abierta todo ese tiempo. Después pulsa Enter y la ventana se cierra.

En allverto se continúa con Datos encontrados y Asignaciones; consulta Migración desde JTL-Wawi: cómo funciona.

#¿De dónde sale la clave API?

JTL-Wawi no muestra ninguna clave API que puedas copiar ni la genera con solo pulsar un botón. Solo la entrega a una aplicación que la solicita en ese momento, mientras su asistente espera en Registrierung beginnen. Si tu servidor REST es accesible desde internet, allverto envía la solicitud por sí mismo (Enviar registro desde allverto). Si no, lo hace jtl-bridge: envía la solicitud, recibe la clave tras «Einrichtung abschließen» y la entrega cifrada a allverto.

#Los datos en el asistente

En Datos de conexión ves lo que ha transferido jtl-bridge: dirección del servidor REST o servidor SQL, instancia, base de datos y usuario. La contraseña nunca se muestra. Aquí solo tienes que cambiar algo en casos excepcionales. Ahí también está el interruptor Completar los datos que faltan desde la base de datos (opcional); consulta Configurar la API REST.

#Probar la conexión

En el asistente aparece el último resultado de la comprobación, p. ej. «Última comprobación de jtl-bridge: conectado ✓ (hace 2 minutos)», o bien el error con una sugerencia de solución. jtl-bridge informa en cada inicio de si la conexión ha funcionado.

Con Probar conexión compruebas la conexión desde el asistente:

• Si la dirección solo es accesible en tu servidor o en la red de la empresa (p. ej. localhost, 127.0.0.1, 192.168.…, 10.… o un nombre de equipo como WAWI-SERVER), allverto no puede llegar a ella. Entonces la prueba la hace jtl-bridge: inicia el archivo con doble clic y pega el código de configuración; el resultado aparece en el asistente.
• Si la dirección es accesible desde internet, allverto la comprueba por sí mismo: en el servidor REST, si responde; en el SQL Server, el inicio de sesión y la versión de Wawi. Abre un puerto así en tu firewall únicamente para las direcciones de los servidores de allverto.

#El código de configuración

• El código contiene la dirección de tu allverto y tu token de importación personal. Es como una contraseña: no lo envíes por correo electrónico ni lo copies en tickets.
• allverto muestra el código solo justo después de generarlo. Si más tarde lo necesitas de nuevo, genera uno nuevo con Generar nuevo código de configuración; el anterior deja de ser válido.
• Un código es válido 30 días, como máximo hasta que se completa la migración. Con Ampliar 30 días lo prolongas desde hoy.
• Solo es válido mientras la persona que lo generó o amplió por última vez siga activa y pueda «Realizar la migración desde JTL-Wawi».

#¿Tu Wawi funciona en un servidor de tu oficina?

Entonces no tienes que iniciar el programa en el propio servidor: también sirve cualquier PC con Windows de la misma red. En la ventana, en la dirección o en el servidor SQL, introduce el nombre o la dirección IP del servidor en lugar de localhost (p. ej., http://WAWI-SERVER:5883/api/eazybusiness). El servidor debe permitir el acceso desde ese PC (firewall de Windows); en caso de duda, es más sencillo iniciarlo directamente en el servidor. Si introduces la dirección IP del propio equipo en el que funciona el programa, te avisa: en ese caso basta con localhost.

#Si algo no funciona

Cuando hay un error, la ventana indica qué ha pasado y qué puedes hacer. Los casos más frecuentes:

Más casos: Solución de problemas en la migración desde JTL.

#Otros sistemas

Wawi funciona en Windows, por eso allverto siempre ofrece primero el archivo para Windows. En Otros sistemas también encontrarás jtl-bridge para Linux (haz el archivo ejecutable e inícialo en un terminal) y macOS (descomprime el ZIP y haz doble clic en jtl-bridge.command; si macOS avisa de un desarrollador no verificado: haz clic con la tecla ctrl pulsada → Abrir). El proceso posterior es el mismo.

#Seguridad

• jtl-bridge transfiere solo por HTTPS. Además, los datos van cifrados con una clave derivada del token de importación.
• El programa solo lee: no cambia nada en tu Wawi.
• La contraseña y la clave API nunca se muestran en la ventana. Lo que introduces en la ventana, el programa lo entrega cifrado a allverto. allverto guarda cifradas la contraseña y la clave API y solo las usa para esta migración; en el registro solo consta que se han guardado.
• allverto solo guarda una huella del token de importación, nunca el propio token.
• Tras diez códigos no válidos desde la misma dirección, allverto bloquea nuevos intentos durante unos minutos.
• Tras Completar el cambio, el código deja de ser válido y se borran los datos de JTL almacenados temporalmente. Después puedes eliminar de nuevo en Wawi la aplicación «allverto – Umzug von JTL-Wawi» en Anwendungsregistrierungen.

#Para usuarios avanzados

jtl-bridge también se puede controlar con comandos en un símbolo del sistema o en PowerShell, p. ej., para pruebas o tareas programadas. En lugar de --code también sirven --url <allverto-Adresse> --token <Import-Token>.

En el programa para Windows, la llamada se hace con el nombre del archivo, p. ej., .\allverto-jtl-bridge-1.0.0-windows-x64.exe check --code ….

También puedes definir la contraseña y la clave API solo en el ordenador (variables de entorno JTL_DB_PASSWORD, JTL_API_KEY); así nunca salen de él. La suma de comprobación (SHA-256) de cada archivo la ofrece la lista de descargas en /api/downloads/jtl-bridge.