Il programma di supporto jtl-bridge

jtl-bridge è un piccolo programma di allverto per la migrazione. Gira sul computer su cui gira la tua JTL-Wawi (di solito un server Windows), legge lì i dati della tua Wawi e li trasferisce in forma crittografata ad allverto. Il database della tua Wawi e il server REST della Wawi non devono essere raggiungibili da internet. Non ti servono comandi – bastano un doppio clic e un codice incollato.

#Prima di iniziare

Prima non devi inserire nulla. In allverto apri Impostazioni → Migrazione dati → Migrazione da JTL-Wawi, passo Collega origine, e scegli l'origine: API JTL-Wawi (vedi Configurare l'API REST) o Database JTL (vedi Accesso tramite il database JTL).

Apri poi il riquadro Server non raggiungibile da internet? Trasferisci i dati con jtl-bridge. Mostra gli stessi passi di questa pagina. Indirizzo, server SQL, utente e password li chiede il programma più tardi sul tuo server. Ciò che allverto riconosce già viene spuntato nel riquadro.

#Passo dopo passo

1. Scaricare jtl-bridge. Nel riquadro fai clic su Scarica per Windows. Il file si chiama ad es. allverto-jtl-bridge-1.0.0-windows-x64.exe e non va installato. Se il browser avvisa del file, scegli Mantieni o Scarica comunque.
2. Copiare il file sul server su cui gira la tua JTL-Wawi, ad es. tramite Desktop remoto sul desktop. Copia il file sul tuo PC (Ctrl + C) e incollalo nella finestra di Desktop remoto sul desktop del server (Ctrl + V). Puoi anche aprire allverto direttamente nel browser del server e scaricare lì il file.
3. Sul server avviare il file con un doppio clic. Si apre una finestra con lo sfondo nero. Se prima Windows mostra «PC protetto da Windows», fai clic su Ulteriori informazioni e poi su Esegui comunque – il programma non è ancora firmato digitalmente.
4. Fai clic qui su «Genera codice di configurazione», copia il codice, incollalo nella finestra con il clic destro e premi Invio. Così allverto crea il collegamento con l'origine scelta. Copia il codice con Copia codice di configurazione. Inizia con AVJTL1. e contiene tutto ciò che serve al programma.
5. Rispondere alle domande nella finestra – di solito basta Invio. La proposta tra parentesi quadre di solito va bene: allora premi semplicemente Invio. Il programma verifica subito la connessione. Se non funziona, spiega il motivo e chiede di nuovo. I dati verificati li consegna cifrati ad allverto – al prossimo avvio non chiede più nulla.
   • API JTL-Wawi: il programma cerca da solo il server REST su questo computer (porte da 5883 a 5890) e propone l'indirizzo trovato, ad es. «Trovato: http://localhost:5885/api/eazybusiness – premi Invio per usarlo». Se non trova nulla, chiede l'indirizzo del server REST. La porta è quella che hai impostato in Wawi per il server REST (ad es. 5883).
   • Database JTL: il programma chiede Server SQL [localhost], Istanza [JTLWAWI] (digita un trattino - se non ce n'è una), Database [eazybusiness], Utente [sa] e Password. La password non si vede mentre la digiti. Si intende la password di SQL Server, non la tua password di JTL-Wawi.
6. Solo con l'origine «API JTL-Wawi»: registrare l'applicazione in JTL-Wawi. La finestra ti dice quando è il momento: Poi il programma consegna da solo la chiave API cifrata ad allverto – non devi copiare nulla. Se una chiave è già salvata, questo passo non serve.
   1. In JTL-Wawi apri Anwendungsregistrierungen (registrazioni delle applicazioni) → Anwendung registrieren (registra applicazione) e prosegui fino a Registrierung beginnen (avvia registrazione). Lì compare «Es wird auf die Übermittlung einer Registrierungsanfrage durch die zu registrierende Anwendung gewartet …».
   2. Ora premi Invio nella finestra di jtl-bridge. Il programma invia la richiesta allverto – Umzug von JTL-Wawi. Se la Wawi non la accetta ancora, il programma riprova ogni 5 secondi per 10 minuti.
   3. In Wawi controlla Anwendungsinformationen, scegli un utente Wawi in Benutzer, conferma in Zugriffsverwaltung i diritti richiesti (sola lettura) e fai clic su Einrichtung abschließen (completa la configurazione).
7. Attendere che compaia «Fatto»: allverto spunterà poi il passaggio. Il programma verifica prima la connessione, conta i dati e poi li carica un tipo di dati alla volta. A seconda della quantità di dati servono da alcuni minuti ad alcune ore. Lascia aperta la finestra per tutto il tempo. Poi premi Invio – la finestra si chiude.

In allverto si prosegue con Dati trovati e Assegnazioni – vedi Migrazione da JTL-Wawi: come funziona.

#Da dove viene la chiave API?

JTL-Wawi non mostra alcuna chiave API da copiare e non ne crea una con un clic. Rilascia una chiave solo a un'applicazione che sta facendo richiesta in quel momento – mentre la sua procedura guidata è in attesa su Registrierung beginnen. Se il tuo server REST è raggiungibile da internet, allverto invia la richiesta da solo (Invia registrazione da allverto). Altrimenti se ne occupa jtl-bridge: invia la richiesta, riceve la chiave dopo «Einrichtung abschließen» e la passa cifrata ad allverto.

#I dati nella procedura guidata

In Dati di connessione vedi cosa ha trasferito jtl-bridge: indirizzo del server REST o server SQL, istanza, database e utente. La password non viene mai mostrata. Qui devi cambiare qualcosa solo in casi eccezionali. Lì trovi anche l'interruttore Integrare i dati mancanti dal database (facoltativo) – vedi Configurare l'API REST.

#Verifica connessione

Nella procedura guidata compare l'ultimo risultato della verifica, ad es. «Ultima verifica di jtl-bridge: connesso ✓ (2 minuti fa)», oppure l'errore con un suggerimento per risolverlo. A ogni avvio jtl-bridge segnala se la connessione ha funzionato.

Con Verifica connessione controlli il collegamento dalla procedura guidata:

• Se l'indirizzo è raggiungibile solo sul tuo server o nella tua rete aziendale (ad es. localhost, 127.0.0.1, 192.168.…, 10.… o un nome di computer come WAWI-SERVER), allverto non può raggiungerlo. Allora il test lo fa jtl-bridge: avvia il file con un doppio clic e incolla il codice di configurazione – il risultato compare nella procedura guidata.
• Se l'indirizzo è raggiungibile da internet, lo verifica allverto stesso: per il server REST se risponde, per il SQL Server l'accesso e la versione della Wawi. Una porta di questo tipo aprila nel firewall solo per gli indirizzi dei server allverto.

#Il codice di configurazione

• Il codice contiene l'indirizzo del tuo allverto e il tuo token di importazione personale. È come una password: non inviarlo per e-mail e non copiarlo nei ticket.
• allverto mostra il codice solo subito dopo averlo generato. Se ti serve di nuovo più tardi, generane uno nuovo con Genera nuovo codice di configurazione – quello vecchio non vale più.
• Un codice vale 30 giorni, al massimo fino alla conclusione della migrazione. Con Prolunga di 30 giorni lo estendi a partire da oggi.
• Vale solo finché la persona che lo ha generato o prolungato per ultima è attiva e può «Eseguire la migrazione da JTL-Wawi».

#La tua Wawi gira su un server nel tuo ufficio?

Allora non devi avviare il programma sul server stesso: va bene anche qualsiasi PC Windows della stessa rete. Nella finestra, all'indirizzo o al server SQL, inserisci al posto di localhost il nome o l'indirizzo IP del server (ad es. http://WAWI-SERVER:5883/api/eazybusiness). Il server deve consentire l'accesso da questo PC (firewall di Windows); nel dubbio è più semplice avviarlo direttamente sul server. Se inserisci l'indirizzo IP del computer su cui gira il programma, ti avvisa: basta localhost.

#Se qualcosa non funziona

In caso di errore la finestra ti dice cosa è successo e cosa puoi fare. I casi più frequenti:

Altri casi: Risoluzione dei problemi nella migrazione da JTL.

#Altri sistemi

La Wawi gira su Windows, per questo allverto offre sempre per primo il file per Windows. In Altri sistemi jtl-bridge è disponibile anche per Linux (rendi il file eseguibile e avvialo in un terminale) e macOS (estrai lo ZIP, doppio clic su jtl-bridge.command; se macOS segnala uno sviluppatore non verificato: fai clic tenendo premuto il tasto ctrl → Apri). Il procedimento successivo è lo stesso.

#Sicurezza

• jtl-bridge trasferisce solo tramite HTTPS. I dati sono inoltre crittografati con una chiave derivata dal token di importazione.
• Il programma legge soltanto – non modifica nulla nella tua Wawi.
• Password e chiave API non vengono mai mostrate nella finestra. Ciò che inserisci nella finestra, il programma lo consegna cifrato ad allverto. allverto salva password e chiave API in forma crittografata e le usa solo per questa migrazione; nel protocollo compare solo che sono state salvate.
• Del token di importazione allverto salva solo un'impronta, mai il token stesso.
• Dopo dieci codici non validi dallo stesso indirizzo, allverto blocca ulteriori tentativi per alcuni minuti.
• Dopo Completa il passaggio il codice non è più valido e i dati JTL memorizzati temporaneamente vengono eliminati. Poi puoi rimuovere di nuovo l'applicazione «allverto – Umzug von JTL-Wawi» nella Wawi, in Anwendungsregistrierungen.

#Per utenti esperti

jtl-bridge si può anche comandare con comandi in un prompt dei comandi o in PowerShell, ad es. per test o attività pianificate. Al posto di --code funziona anche --url <allverto-Adresse> --token <Import-Token> (<allverto-Adresse> = indirizzo di allverto, <Import-Token> = token di importazione).

Nel programma per Windows il comando si chiama come il file, ad es. .\allverto-jtl-bridge-1.0.0-windows-x64.exe check --code ….

Password e chiave API puoi anche impostarle solo sul computer (variabili d'ambiente JTL_DB_PASSWORD, JTL_API_KEY): così non lo lasciano mai. La somma di controllo (SHA-256) di ogni file la trovi nell'elenco dei download in /api/downloads/jtl-bridge.