L'utilitaire jtl-bridge
jtl-bridge lit JTL-Wawi (base de données ou API REST) dans le réseau de l'entreprise et téléverse les données chiffrées vers allverto. Commandes, options et sécurité.
jtl-bridge est un petit programme en ligne de commande pour la migration. Il s'exécute sur un ordinateur de votre réseau d'entreprise – là où JTL-Wawi et son SQL Server sont accessibles –, lit les données et les téléverse vers allverto via une connexion chiffrée. Ainsi, vous n'avez à exposer sur Internet ni votre base de données ni le serveur REST de la Wawi.
Comment jtl-bridge obtient ses identifiants
Vous renseignez le serveur, l'utilisateur et le mot de passe, ou l'adresse et la clé API, dans l'assistant de migration. jtl-bridge se connecte à allverto avec le jeton d'import et récupère ces informations de manière chiffrée. Vous pouvez aussi définir le mot de passe et la clé API uniquement en local (JTL_DB_PASSWORD, JTL_API_KEY).
Vous générez le jeton d'import dans l'assistant avec Générer un jeton d'import. Il n'est affiché qu'une seule fois et reste valable 30 jours, au plus jusqu'à la fin de la migration. Prolonger de 30 jours le prolonge à partir d'aujourd'hui ; avec Nouveau jeton d'import, l'ancien devient invalide. Le jeton n'est en outre valable que tant que la personne qui l'a généré ou prolongé en dernier est active et a le droit « Effectuer la migration depuis JTL-Wawi ».
Commandes
| Commande | Utilité |
|---|---|
jtl-bridge check --url <allverto-Adresse> --token <Import-Token> | Vérifier la connexion et la structure de la base de données, compter les quantités – ne téléverse rien. |
jtl-bridge upload --url <allverto-Adresse> --token <Import-Token> | Lire et téléverser les données. |
jtl-bridge register --api-url http://wawi-server:<port>/api/eazybusiness | Enregistrer allverto comme application dans la Wawi et récupérer la clé API (voir Configurer l'API REST). |
L'assistant affiche la commande upload adaptée, avec votre adresse, dans l'encadré Utilitaire jtl-bridge – avec un bouton pour la copier.
Options importantes
| Option | Signification |
|---|---|
--source db, --source api | Forcer la voie (sinon, la source définie dans allverto s'applique) |
--fill-from-db | Avec la voie API : compléter depuis la base de données ce que l'API ne fournit pas |
--until JJJJ-MM-TT | uniquement les documents jusqu'à cette date (date de bascule ; format AAAA-MM-JJ) |
--entities a,b,c | uniquement certains types de données |
--no-pdfs | ne pas récupérer les PDF des factures |
--db-host, --db-instance, --db-port, --db-name, --db-user, --db-encrypt | Remplacer localement les informations de base de données |
--api-url | Remplacer localement l'adresse du serveur REST |
Sécurité
- jtl-bridge téléverse uniquement via HTTPS et s'interrompt sinon (« Nur HTTPS ist erlaubt (Daten verlassen das Firmennetz). » – seul HTTPS est autorisé, les données quittent le réseau de l'entreprise).
- En plus de la connexion HTTPS, les données sont chiffrées avec une clé dérivée du jeton d'import.
- allverto ne stocke qu'une empreinte du jeton d'import, jamais le jeton lui-même.
- Après dix jetons invalides depuis la même adresse, allverto bloque les tentatives suivantes pendant quelques minutes.
- Après Terminer la bascule, le jeton est invalide et les données JTL mises en cache sont supprimées.
Déroulement type
jtl-bridge check …– tout est-il en ordre ?jtl-bridge upload …– téléverser les données.- Dans allverto : Correspondances → Simulation → Reprise.
- Avant la date de bascule, relancer
uploadet, dans allverto, Lancer l'exécution delta.