Vai al contenuto
Accedi
IT

Le integrazioni nel dettaglio Diagnostica delle connessioni

Il peggior messaggio d’errore è quello che non arriva mai

Un programma che va in crash è fastidioso. Un programma che mostra un messaggio d’errore è sgradevole. Un programma che tace e non trova nulla è pericoloso – perché nessuno si accorge che qualcosa è rotto.

In un riconoscimento del chiamante si presenta così: il telefono squilla, il riquadro interroga il CRM, il CRM risponde con un elenco vuoto, il riquadro mostra «Sconosciuto». Tutto funziona. Tutto è verde. Eppure non va nulla.

200 OK
Il codice di stato con cui un’interfaccia può rispondere anche quando la richiesta in realtà è fallita. In almeno un sistema del catalogo l’errore vero sta nel corpo della risposta.

Tre strade per cui un collegamento diventa silenziosamente sbagliato

Primo: cercato nel posto sbagliato

Un software per studi legali offre una ricerca a testo pieno sui contatti. Nella sua guida si legge che è particolarmente utile quando chiama un cliente e si ha solo il numero di telefono. Nella descrizione dell’interfaccia si legge invece soltanto che il termine cercato viene «applicato a diversi campi del contatto».

Quali siano, non è scritto da nessuna parte. Se i numeri di telefono non ci fossero, non arriverebbe alcun messaggio d’errore. Arriverebbe un elenco vuoto – a ogni telefonata, per settimane, senza che nessuno sospetti della ricerca.

Per questo lì chiediamo invece di provare. Un tentativo non potrebbe distinguere «cercato male» da «non presente».

Secondo: il campo di ricerca è stato ignorato

Il caso più sgradevole, ed è quello che da noi ha fatto nascere un meccanismo di protezione.

Un CRM scandinavo riceve le sue ricerche tramite una chiamata generica in cui il nome del campo di ricerca ha un ruolo. Se quel nome fosse sbagliato, sarebbero pensabili due risposte: un messaggio d’errore – oppure una semplice omissione del campo sconosciuto.

Nel secondo caso tornerebbe l’intero archivio, con stato 200. Il riquadro avrebbe allora mostrato come chiamante il primo record disponibile.

Da allora c’è il guardiano: dopo la risposta si verifica se il numero del risultato corrisponde davvero a quello cercato. Ciò che non corrisponde cade, e nel registro sta scritto che è caduto. L’errore si annuncia così da sé, invece di salutare in silenzio la persona sbagliata.

Terzo: l’errore sta nel corpo

Un software tedesco per mediatori risponde a un accesso errato con un regolare errore HTTP. Un errore nell’elaborazione – per esempio un permesso mancante sul modulo indirizzi – lo segnala invece nel corpo della risposta, con stato 200.

Senza precauzione, un permesso mancante apparirebbe perciò esattamente come «il numero non c’è»: elenco vuoto, nessuna segnalazione.

Il portale verifica ormai questo codice espressamente. In fase di configurazione la differenza tra «nessuna autorizzazione» e «non trovato» è metà della ricerca del guasto – e senza di essa il sospetto cade sul CRM del cliente, dove non c’entra nulla.

Perché preferiamo chiedere invece di indovinare

In ogni richiesta a una casa di software c’è perciò un paragrafo che spiega perché scriviamo invece di cominciare e basta:

Non è sfiducia verso il produttore. È la constatazione che un collegamento che in silenzio non trova nulla è peggio di nessun collegamento – l’assenza, almeno, la conosce chiunque.

Da che cosa lo si riconosce nella propria azienda

Chi usa un riconoscimento del chiamante e sospetta che riconosca troppo poco, verifichi meglio in quest’ordine:

  • Vengono percorsi tutti i campi telefono o solo il primo?
  • Si confronta carattere per carattere oppure sulle cifre?
  • A una richiesta volutamente sbagliata arriva un errore o un elenco vuoto?
  • Nel registro c’è qualcosa quando non è stato trovato nulla – o proprio nulla?

L’ultima domanda è la più importante. Un sistema che non annota il proprio fallimento non si può verificare.

Domande frequenti

Perché non provate semplicemente un’interfaccia?

Perché qui un tentativo fallito non si nota come errore. Una ricerca che non legge i numeri di telefono non risponde con un errore: risponde con un elenco vuoto. Sembra «il chiamante non c’è».

Che cos’è un guardiano?

Una verifica dopo la risposta: un risultato viene mostrato solo se il suo numero corrisponde davvero a quello cercato. Se un sistema esterno ignora il nostro campo di ricerca e restituisce l’intero archivio, cade tutto ciò che non corrisponde – e nel registro sta scritto che è successo.

HTTP 200 non significa che va tutto bene?

No. Alcune interfacce rispondono sempre con 200 e mettono l’esito nel corpo. Un permesso mancante appare allora esattamente come «non trovato» – finché non si guarda espressamente nel corpo.

Che cosa significa per la configurazione?

Che la differenza tra «nessuna autorizzazione» e «non trovato» è metà della ricerca del guasto. Senza questa distinzione qualcuno cerca mezza giornata – e il sospetto cade sul CRM del cliente.

Come funziona il riquadro Tutti i connettori

Parli con noi

Non riceverà una soluzione standard, ma una valutazione chiara: se lo sforzo vale la pena per la sua azienda, che cosa deve saper fare il suo sistema – e quanto costa. Se non è adatto, glielo diciamo.