Integrazioni personalizzate

È possibile aggiungere un prefisso personalizzato al valore del parametro, specificando il nome del parametro in modo diverso. Normalmente, specificando il nome del parametro come "id" si otterrebbe una richiesta del tipo https://example.com/?id=1. Tuttavia, se è richiesto un prefisso personalizzato davanti al valore ID effettivo, il nome del parametro può essere definito, ad esempio, come "id=client_", che invierà una richiesta https://example.com/?id=client_1.

Alle richieste in background ("Invia richiesta HTTP") si possono anche assegnare valori statici arbitrari, che verranno aggiunti alle richieste ogni volta che vengono inviate. Questo può essere usato, ad esempio, per includere intestazioni di Autorizzazione nelle richieste.

Questa funzione non è implementata per le richieste in primo piano ("Apri in una nuova finestra", "Apri nel pannello laterale"). Anche le intestazioni inviate non vengono registrate.

La vista delle impostazioni visualizza un elenco di chiavi e valori del payload che saranno inviati con la richiesta, sia come parametri della stringa di query (GET) che come dati del modulo (POST). L'elenco si aggiorna man mano che le impostazioni vengono modificate.

Se un'integrazione personalizzata è definita come azione "Invia richiesta HTTP", facendo clic sul pulsante dell'integrazione personalizzata si pianifica l'invio di una richiesta in background utilizzando i server worker di Provet Cloud. L'invio avverrà in modo asincrono e, sebbene di solito la richiesta venga effettuata quasi immediatamente, potrebbe esserci un ritardo a seconda della quantità di lavoro in corso sui server. La richiesta proviene dagli indirizzi IP in uscita di Provet Cloud.

Quando la richiesta è in fase di pianificazione, l'utente vedrà una notifica informativa nella parte superiore della pagina.

Se la richiesta viene gestita e completata senza che l'utente si allontani dalla pagina, gli può essere mostrata un'ulteriore notifica al completamento dell'attività.

Una notifica di successo viene mostrata se la richiesta viene inviata con successo e l'integrazione risponde con un codice di stato HTTP di successo (tra 200 e 299 incluso).

Tuttavia, se la richiesta non va a buon fine per qualsiasi motivo, verrà visualizzata una notifica di errore rossa con la dicitura "Richiesta di integrazione non riuscita" e un messaggio di errore più specifico tra le parentesi.

I possibili messaggi di errore al momento sono:

Se un'integrazione personalizzata è definita come azione "Apri in una nuova finestra", facendo clic sul pulsante dell'integrazione personalizzata si aprirà l'URL di destinazione in una nuova finestra o, più comunemente con i browser moderni, in una nuova scheda. La pagina originale di Provet Cloud rimarrà aperta nella finestra/tab originale.

Se si utilizza un metodo di richiesta GET, gli utenti possono vedere le informazioni del payload visualizzate nella barra degli indirizzi del browser. Se gli utenti non devono vedere facilmente le informazioni sul payload trasmesse, si consiglia di utilizzare una richiesta POST.

Se un'integrazione personalizzata è definita come azione "Apri nel pannello laterale", facendo clic sul pulsante dell'integrazione personalizzata si recupera l'URL di destinazione all'interno del browser e lo si visualizza in un elemento iframe all'interno di un pannello laterale che si apre in cima alla pagina corrente.

L'URL di destinazione deve supportare l'incorporazione tramite l'intestazione X-Frame-Options.

Le integrazioni personalizzate del cliente saranno visualizzate nella pagina del cliente sul lato destro, sopra la sezione Note quando si naviga in una qualsiasi delle schede del cliente ("Dettagli cliente", "Fatturazione", "Trattamenti", ecc.). Non viene visualizzato nelle schede dei pazienti. L'ID del cliente verrà inviato come parametro.

Allo stesso modo, le integrazioni personalizzate dei pazienti saranno visualizzate nella pagina del paziente sul lato destro, sopra la sezione Note quando si sfogliano le schede del paziente ("Dettagli paziente", "Storia", "Misure", ecc.). Non viene visualizzato nelle schede del cliente. L'ID del paziente verrà inviato come parametro.

Le integrazioni personalizzate per le fatture saranno visualizzate nelle pagine delle fatture (compresa la vendita al banco) nella barra degli strumenti inferiore. L'ID della fattura (da non confondere con il numero della fattura) verrà inviato come parametro.

Le integrazioni personalizzate per le consultazioni saranno visualizzate nella pagina della consultazione, sopra la sezione delle informazioni generali, sia per le consultazioni in corso che per quelle concluse. L'ID della consultazione sarà inviato come parametro.

Le integrazioni personalizzate del calendario degli appuntamenti saranno visualizzate sopra il calendario degli appuntamenti. L'ID della sede attiva della clinica sarà inviato come parametro.

Allo stesso modo, le integrazioni personalizzate del calendario dei turni saranno visualizzate sopra il calendario dei turni, sotto la selezione del tipo di turno e del modello di turno. L'ID della sede attiva della clinica verrà inviato come parametro.

Le integrazioni personalizzate per la diagnostica per immagini saranno visualizzate nella pagina di riferimento della diagnostica per immagini nelle barre degli strumenti superiori e inferiori. L'ID del referral di diagnostica per immagini verrà inviato come parametro.

Le integrazioni personalizzate dei promemoria saranno visualizzate nella barra degli strumenti di selezione della pagina dei promemoria quando uno o più promemoria sono selezionati nella tabella. È possibile scegliere e inviare più promemoria contemporaneamente. L'ID del promemoria per ogni promemoria selezionato verrà inviato come parametro.