Messaggi webhook

I messaggi webhook mostrano un registro di tutte le notifiche webhook in uscita che X4fleet invia ai sistemi di destinazione collegati in occasione di determinati eventi. La pagina è destinata ai dispatcheur e agli amministratori e serve alla sorveglianza della comunicazione di interfaccia: è possibile visualizzare lo stato di invio, esaminare i singoli messaggi in dettaglio, adattarli e inviarli di nuovo se necessario, esportarli o eliminarli.

1. Navigazione

I messaggi webhook sono raggiungibili tramite il menu principale nella sezione Sorveglianza › Messaggi webhook.

Nota: L'accesso è disponibile per gli utenti con il ruolo Dispatcheur e Amministratore.

2. Tabella riepilogativa

La panoramica mostra tutti i messaggi webhook inviati in una tabella ordinabile caricata pagina per pagina. Ogni riga rappresenta un messaggio webhook.

Colonne predefinite

Ordinamento

Facendo clic sull'intestazione di una colonna si ordina l'elenco in ordine crescente o decrescente in base a tale colonna.

Selezione multipla

Tramite le caselle di selezione all'inizio di ogni riga è possibile contrassegnare più messaggi contemporaneamente. Le azioni della barra degli strumenti «Invia di nuovo» e «Elimina» operano su tutti i messaggi contrassegnati.

3. Intervallo di date

Tramite il filtro intervallo di date è possibile limitare l'elenco a un periodo (da/a). Vengono visualizzati solo i messaggi il cui timestamp rientra nel periodo selezionato.

L'ultimo intervallo di date selezionato viene salvato e riapplicato automaticamente alla successiva apertura della pagina.

Nota: Su questa pagina è possibile solo un singolo periodo delimitato (da/a); le varianti estese («prima»/«dopo») non sono disponibili qui.

4. Area gruppo

I messaggi visualizzati sono limitati al gruppo attualmente attivo e ai suoi sottogruppi. Tramite l'opzione «Solo gruppo attuale» è possibile limitare la visualizzazione ai messaggi del gruppo attivo; se è disattivata, vengono inclusi anche i messaggi dei sottogruppi.

Se il gruppo attivo viene cambiato tramite il commutatore di gruppo globale, la tabella si ricarica automaticamente.

Nota: Per i gruppi di subappaltatori l'opzione «Solo gruppo attuale» non è applicabile.

5. Filtri di colonna e ricerca rapida

Sotto le intestazioni delle colonne è disponibile una riga di filtro. Per ogni colonna è possibile inserire un valore di ricerca; l'elenco si limita di conseguenza.

• Per le colonne Stato, Trigger giro e Trigger spedizione il filtro viene offerto come elenco di selezione con i rispettivi valori disponibili.
• La colonna Timestamp non può essere filtrata tramite la riga di filtro; per la limitazione temporale utilizzare l'intervallo di date (vedere Sezione 3).

Inoltre, la ricerca rapida esamina l'elenco visualizzato su più colonne. Tramite il pulsante «Reimposta filtri» vengono nuovamente rimossi tutti i filtri attivi.

6. Inviare di nuovo i messaggi (selezione)

Se l'invio di un messaggio webhook non riesce o un messaggio deve essere riconsegnato, i messaggi contrassegnati possono essere inviati di nuovo direttamente dalla barra degli strumenti.

1. Contrassegnare uno o più messaggi nell'elenco.
2. Fare clic sul pulsante «Invia di nuovo» nella barra degli strumenti.
3. I messaggi selezionati vengono inviati di nuovo al rispettivo URL di destinazione.

Dopo un invio riuscito appare un messaggio di conferma.

Nota: Il pulsante è attivo solo finché è contrassegnato almeno un messaggio.

7. Vista dettagliata: visualizzare, modificare, inviare di nuovo

Tramite la vista dettagliata è possibile visualizzare integralmente, adattare e inviare di nuovo un singolo messaggio webhook. Si apre in un'ampia finestra.

La vista dettagliata contiene:

• Registro / errori: Un'area espandibile con le voci di registro relative alla consegna del messaggio. Qui sono visibili eventuali messaggi di errore.
• Messaggio grezzo: Il contenuto completo del messaggio come editor JSON strutturato.
• Dati utili (payload): I dati utili trasmessi come secondo editor JSON strutturato.

Entrambi gli editor JSON vengono visualizzati in una vista modulo espansa e possono essere modificati.

Modificare e inviare di nuovo

1. Aprire la vista dettagliata del messaggio desiderato.
2. Se necessario, adattare il contenuto del messaggio grezzo o dei dati utili negli editor JSON.
3. Fare clic sul pulsante «Invia» – il messaggio viene inviato di nuovo all'URL di destinazione con il contenuto attualmente visualizzato (eventualmente modificato).

Nota: I contenuti dei messaggi più grandi vengono caricati su richiesta dalla memoria durante la visualizzazione. Con dati utili molto voluminosi, l'apertura della vista dettagliata può quindi richiedere un momento.

8. Eliminare i messaggi

I messaggi webhook non più necessari possono essere eliminati direttamente dalla panoramica.

1. Contrassegnare uno o più messaggi.
2. Fare clic sul pulsante «Elimina» nella barra degli strumenti.
3. Confermare la richiesta di conferma.

I messaggi contrassegnati vengono rimossi definitivamente dal registro.

Attenzione: L'eliminazione è irreversibile. I messaggi eliminati non possono essere ripristinati.

9. Esportazione

I messaggi webhook possono essere esportati.

• Tramite il pulsante di esportazione nella barra degli strumenti viene esportato il contenuto della tabella attualmente visualizzata.
• Inoltre sono disponibili esportazioni separate per i messaggi webhook relativi alle spedizioni e relativi ai giri.

Durante l'esportazione i dati utili associati vengono uniti. Le spedizioni parziali non rilevanti possono essere escluse a seconda delle impostazioni webhook.

Nota: L'accesso alle esportazioni è protetto per gruppo; vengono esportati solo i messaggi dei gruppi per i quali si è autorizzati.

10. Disposizione della tabella e modelli

Le impostazioni di colonne e disposizione dei messaggi webhook vengono salvate automaticamente per utente e rimangono dopo la disconnessione.

• Selezione colonne / disposizione: Le funzioni di disposizione della barra degli strumenti permettono di mostrare e nascondere colonne nonché di adattare la disposizione della tabella.
• Modelli: I modelli salvati possono essere applicati alla vista attuale tramite i relativi pulsanti nella barra degli strumenti, per passare rapidamente da una configurazione di colonne e filtri a un'altra.

11. Riepilogo: azioni disponibili