L'utilitaire jtl-bridge

jtl-bridge est un petit programme d'allverto pour la migration. Il tourne sur l'ordinateur où tourne ta JTL-Wawi (le plus souvent un serveur Windows), y lit les données de ta Wawi et les transfère chiffrées vers allverto. Ta base de données Wawi et le serveur REST de la Wawi n'ont pas besoin d'être accessibles depuis Internet. Tu n'as besoin d'aucune commande – un double-clic et un code collé suffisent.

#Avant de commencer

Tu n'as rien à saisir au préalable. Dans allverto, ouvre Paramètres → Reprise de données → Migration depuis JTL-Wawi, étape Connecter la source, et choisis la source : API JTL-Wawi (voir Configurer l'API REST) ou Base de données JTL (voir Accès via la base de données JTL).

Déplie ensuite l'encadré Serveur non accessible depuis Internet ? Transférer les données avec jtl-bridge. Il montre les mêmes étapes qu'ici. Le programme demande plus tard sur ton serveur l'adresse, le serveur SQL, l'utilisateur et le mot de passe. Ce qu'allverto détecte déjà est coché dans l'encadré.

#Pas à pas

1. Télécharger jtl-bridge. Dans l'encadré, clique sur Télécharger pour Windows. Le fichier s'appelle p. ex. allverto-jtl-bridge-1.0.0-windows-x64.exe et ne nécessite pas d'installation. Si le navigateur met en garde contre le fichier, choisis Conserver ou Télécharger quand même.
2. Copier le fichier sur le serveur où tourne ta JTL-Wawi – p. ex. par Bureau à distance sur le bureau. Copie le fichier sur ton PC (Ctrl + C) et colle-le dans la fenêtre du Bureau à distance, sur le bureau du serveur (Ctrl + V). Tu peux aussi ouvrir allverto directement dans le navigateur du serveur et y télécharger le fichier.
3. Sur le serveur, lancer le fichier par double-clic. Une fenêtre à fond noir s'ouvre. Si Windows affiche d'abord « Windows a protégé votre ordinateur », clique sur Informations complémentaires, puis sur Exécuter quand même – le programme n'est pas encore signé numériquement.
4. Cliquer ici sur « Créer le code de configuration », copier le code, le coller dans la fenêtre par clic droit et appuyer sur Entrée. allverto crée alors la connexion avec la source choisie. Copie le code avec Copier le code de configuration. Il commence par AVJTL1. et contient tout ce dont le programme a besoin.
5. Répondre aux questions dans la fenêtre – Entrée suffit généralement. La proposition entre crochets convient le plus souvent ; appuie alors simplement sur Entrée. Le programme vérifie la connexion tout de suite. Si elle échoue, il explique la raison et redemande. Il transmet les informations vérifiées chiffrées à allverto – au prochain démarrage, il ne redemande plus.
   • API JTL-Wawi : le programme cherche lui-même le serveur REST sur cet ordinateur (ports 5883 à 5890) et propose l'adresse trouvée, p. ex. « Trouvé : http://localhost:5885/api/eazybusiness – appuie sur Entrée pour l’utiliser ». S'il ne trouve rien, il demande l'adresse du serveur REST. Le port est celui que tu as réglé dans la Wawi pour le serveur REST (p. ex. 5883).
   • Base de données JTL : le programme demande le serveur SQL [localhost], l'instance [JTLWAWI] (saisis un tiret - s'il n'y en a pas), la base de données [eazybusiness], l'utilisateur [sa] et le mot de passe. Le mot de passe ne s'affiche pas pendant la saisie. Il s'agit du mot de passe de SQL Server, pas de ton mot de passe JTL-Wawi.
6. Uniquement avec la source « API JTL-Wawi » : enregistrer l'application dans la JTL-Wawi. La fenêtre t'indique quand c'est le moment : Le programme transmet ensuite lui-même la clé API chiffrée à allverto – tu n'as rien à recopier. Si une clé est déjà enregistrée, cette étape n'a pas lieu.
   1. Dans la JTL-Wawi, ouvre Anwendungsregistrierungen (enregistrements d'applications) → Anwendung registrieren (enregistrer une application) et avance jusqu'à Registrierung beginnen (commencer l'enregistrement). Il y est alors indiqué : « Es wird auf die Übermittlung einer Registrierungsanfrage durch die zu registrierende Anwendung gewartet … » (en attente d'une demande d'enregistrement).
   2. Appuie maintenant sur Entrée dans la fenêtre de jtl-bridge. Le programme envoie la demande allverto – Umzug von JTL-Wawi. Si la Wawi ne l'accepte pas encore, le programme réessaie toutes les 5 secondes pendant 10 minutes.
   3. Dans la Wawi, vérifie Anwendungsinformationen (informations sur l'application), choisis un utilisateur Wawi sous Benutzer (utilisateur), confirme les droits demandés (lecture seule) sous Zugriffsverwaltung (gestion des accès) et clique sur Einrichtung abschließen (terminer la configuration).
7. Attendre que « Terminé » s'affiche – allverto coche alors l'étape. Le programme vérifie d'abord la connexion, compte les données, puis les téléverse type de données par type de données. Selon le volume, cela prend de quelques minutes à quelques heures. Laisse la fenêtre ouverte pendant ce temps. Appuie ensuite sur Entrée – la fenêtre se ferme.

La suite se passe dans allverto avec Données trouvées et Correspondances – voir Migration depuis JTL-Wawi : comment ça se passe.

#D'où vient la clé API ?

La JTL-Wawi n'affiche aucune clé API que tu pourrais recopier et n'en crée pas d'un clic. Elle ne délivre une clé qu'à une application qui en fait la demande à cet instant – pendant que son assistant attend à l'étape Registrierung beginnen. Si ton serveur REST est accessible depuis Internet, allverto envoie la demande lui-même (Envoyer l’enregistrement depuis allverto). Sinon, c'est jtl-bridge qui s'en charge : il envoie la demande, reçoit la clé après « Einrichtung abschließen » et la transmet chiffrée à allverto.

#Les informations dans l'assistant

Sous Informations de connexion, tu vois ce que jtl-bridge a transmis : adresse du serveur REST ou serveur SQL, instance, base de données et utilisateur. Le mot de passe n'est jamais affiché. Tu ne dois modifier quelque chose ici que dans des cas exceptionnels. Tu y trouves aussi l'interrupteur Compléter les données manquantes depuis la base de données (facultatif) – voir Configurer l'API REST.

#Tester la connexion

Dans l'assistant s'affiche le dernier résultat de la vérification, p. ex. « Dernière vérification par jtl-bridge : connecté ✓ (il y a 2 minutes) », ou l'erreur avec une piste de solution. jtl-bridge indique à chaque démarrage si la connexion a fonctionné.

Avec Tester la connexion, tu vérifies la connexion depuis l'assistant :

• Si l'adresse n'est accessible que sur ton serveur ou dans ton réseau d'entreprise (p. ex. localhost, 127.0.0.1, 192.168.…, 10.… ou un nom d'ordinateur comme WAWI-SERVER), allverto ne peut pas l'atteindre. C'est alors jtl-bridge qui fait le test : lance le fichier par double-clic et colle le code de configuration – le résultat s'affiche dans l'assistant.
• Si l'adresse est accessible depuis Internet, allverto la vérifie lui-même : pour le serveur REST, s'il répond ; pour SQL Server, la connexion et la version de la Wawi. N'ouvre un tel port dans ton pare-feu que pour les adresses des serveurs allverto.

#Le code de configuration

• Le code contient l'adresse de ton allverto et ton jeton d'import personnel. Il vaut un mot de passe : ne l'envoie pas par e-mail et ne le copie pas dans des tickets.
• allverto n'affiche le code qu'immédiatement après sa création. Si tu en as de nouveau besoin plus tard, crées-en un nouveau avec Créer un nouveau code de configuration – l'ancien n'est alors plus valable.
• Un code est valable 30 jours, au plus jusqu'à la fin de la migration. Avec Prolonger de 30 jours, tu le prolonges à partir d'aujourd'hui.
• Il n'est valable que tant que la personne qui l'a créé ou prolongé en dernier est active et a le droit « Effectuer la migration depuis JTL-Wawi ».

#Ta Wawi tourne sur un serveur dans ton bureau ?

Dans ce cas, tu n'es pas obligé de lancer le programme sur le serveur lui-même : n'importe quel PC Windows du même réseau convient aussi. Dans la fenêtre, saisis pour l'adresse ou le serveur SQL le nom ou l'adresse IP du serveur au lieu de localhost (p. ex. http://WAWI-SERVER:5883/api/eazybusiness). Le serveur doit autoriser l'accès depuis ce PC (pare-feu Windows) ; en cas de doute, le lancement directement sur le serveur est plus simple. Si tu saisis l'adresse IP de l'ordinateur sur lequel tourne le programme, il te le signale : « localhost » suffit alors.

#Si quelque chose ne marche pas

En cas d'erreur, la fenêtre indique ce qui s'est passé et ce que tu peux faire. Les cas les plus fréquents :

Plus de cas : Dépannage de la migration JTL.

#Autres systèmes

La Wawi tourne sous Windows, c'est pourquoi allverto propose toujours d'abord le fichier Windows. Sous Autres systèmes, jtl-bridge existe aussi pour Linux (rendre le fichier exécutable et le lancer dans un terminal) et macOS (décompresser le ZIP, double-cliquer sur jtl-bridge.command ; si macOS signale un développeur non vérifié : clic en maintenant la touche ctrl → Ouvrir). La suite se déroule de la même façon.

#Sécurité

• jtl-bridge transfère uniquement via HTTPS. Les données sont en plus chiffrées avec une clé dérivée du jeton d'import.
• Le programme ne fait que lire – il ne modifie rien dans ta Wawi.
• Le mot de passe et la clé API ne sont jamais affichés dans la fenêtre. Ce que tu saisis dans la fenêtre, le programme le transmet chiffré à allverto. allverto enregistre le mot de passe et la clé API de manière chiffrée et ne les utilise que pour cette migration ; le journal indique seulement qu'ils ont été enregistrés.
• allverto ne stocke qu'une empreinte du jeton d'import, jamais le jeton lui-même.
• Après dix codes invalides depuis la même adresse, allverto bloque les tentatives suivantes pendant quelques minutes.
• Après Terminer la bascule, le code n'est plus valable et les données JTL mises en cache sont supprimées. Tu peux ensuite retirer l'application « allverto – Umzug von JTL-Wawi » dans la Wawi, sous Anwendungsregistrierungen.

#Pour les utilisateurs avancés

jtl-bridge peut aussi être piloté par des commandes dans une invite de commandes ou dans PowerShell, p. ex. pour des tests ou des tâches planifiées. Au lieu de --code, tu peux aussi utiliser --url <allverto-Adresse> --token <Import-Token>.

Dans le programme Windows, la commande porte le nom du fichier, p. ex. .\allverto-jtl-bridge-1.0.0-windows-x64.exe check --code ….

Tu peux aussi définir le mot de passe et la clé API uniquement sur l'ordinateur (variables d'environnement JTL_DB_PASSWORD, JTL_API_KEY) ; ils ne le quittent alors jamais. La liste des téléchargements sous /api/downloads/jtl-bridge fournit la somme de contrôle (SHA-256) de chaque fichier.