Supporto
Strumenti di supporto e diagnostica per il personale Xplanis: nuovo invio dei webhook di spedizione tramite caricamento di un file CSV.
La pagina Supporto mette a disposizione strumenti speciali di diagnostica e manutenzione, riservati esclusivamente al personale Xplanis con autorizzazione Superadmin. Serve a eseguire misure di supporto mirate durante l'esercizio corrente, ad esempio quando le notifiche di spedizione destinate a un sistema di terzi collegato devono essere nuovamente attivate.
Nota: Questa pagina è visibile e accessibile solo agli utenti con diritti di Superadmin. Gli utenti regolari non vedono queste funzioni.
1. Navigazione
La pagina Supporto è raggiungibile tramite le impostazioni globali. Viene visualizzata solo se l'utente connesso dispone dell'autorizzazione Superadmin richiesta.
2. Inviare nuovamente i webhook di spedizione
Questa funzione consente di attivare nuovamente le notifiche webhook per le spedizioni selezionate. Ciò è utile, ad esempio, quando un sistema di terzi collegato non ha ricevuto o elaborato una notifica e le informazioni di spedizione devono essere trasmesse nuovamente.
In caso di nuovo invio, la notifica viene rigenerata sulla base dei dati di spedizione attuali. Non viene quindi ripetuto il messaggio inviato originariamente, bensì viene generato un nuovo messaggio con lo stato attuale della spedizione.
Procedura
- Preparare un file CSV con le spedizioni e i trigger desiderati (vedere la sezione 2.1).
- Nell'area Supporto, selezionare il file
.csvpreparato tramite il campo di selezione del file. - Fare clic sul pulsante «Invia nuovamente».
- Attendere il completamento dell'elaborazione. Durante l'invio, l'area è bloccata in modo da non poter attivare operazioni duplicate.
Al termine viene comunicato il numero di notifiche inviate nuovamente.
2.1 Formato del file CSV
Il file da caricare deve essere un file CSV con esattamente due colonne. La prima riga deve contenere la seguente intestazione:
ShipmentId,Trigger| Colonna | Significato |
|---|---|
| ShipmentId | ID univoco della spedizione per la quale la notifica deve essere inviata nuovamente |
| Trigger | Trigger o evento per il quale viene generata la notifica |
Ogni riga successiva descrive una notifica da inviare nuovamente.
Nota: Le voci inserite in duplice copia vengono riconosciute automaticamente ed elaborate una sola volta.
2.2 Comportamento e limitazioni
- Le notifiche vengono elaborate in lotti per garantire un'elaborazione affidabile anche di quantità più elevate.
- Se per un gruppo è attivo il modulo di controllo delle spedizioni, le spedizioni non ancora controllate vengono ignorate durante il nuovo invio.
- Vengono prese in considerazione solo le spedizioni presenti nel sistema.
3. Scaricare un file CSV di esempio
Per poter preparare il file nel formato corretto, è disponibile per il download un file CSV di esempio. Il relativo link apre un file modello in una nuova scheda del browser.
Il file di esempio mostra:
- la struttura richiesta a due colonne con l'intestazione
ShipmentId,Trigger, - il modo in cui vengono inserite le singole voci.
Suggerimento: Utilizzare il file di esempio come punto di partenza per evitare errori nella costruzione dell'intestazione e delle colonne.
4. Riepilogo: funzioni disponibili
| Funzione | Descrizione | Requisito |
|---|---|---|
| Inviare nuovamente i webhook di spedizione | Attivare nuovamente le notifiche per le spedizioni inserite nel CSV con i dati attuali | Autorizzazione Superadmin, file CSV correttamente formattato |
| Scaricare un file CSV di esempio | Scaricare un file modello nel formato richiesto | Autorizzazione Superadmin |