Mukautetut liitännät ovat Provetin ominaisuus, jonka avulla voit lähettää pyyntöjä ulkoisiin resursseihin Provetin sisäpuolelta. Saadaksesi pääsyn tähän ominaisuuteen, ota yhteyttä Provetin tukeen.
Hallinta
Hallitse mukautettuja liitännäisiä kohdassa Asetukset > Liitännät > Mukautetut liitännät.
Lisää liitäntä valitsemalla Tallenna-painikkeen.
Muokkaa liitäntää valitsemalla taulukkorivin pen-painikkeen.
Asetukset
Kenttä | Kuvaus |
Nimi | Määrittää painikkeessa näkyvän otsikon käyttäjän käyttöliittymässä. |
Määrittää, millä sivulla painike näkyy. Kukin mukautettu liitäntä voi olla näkyvissä vain yhdellä sivulla, mutta sama konfiguraatio voidaan kopioida. | |
Toiminto | Määrittää, mitä toimintoa suoritetaan, kun painike valitaan. |
HTTP-tapa | Määrittää, lähetetäänkö pyyntö GET-pyyntönä (payload annetaan parametrina kyselymerkkijonossa) vai POST-pyyntönä (payload annetaan lomakedatana). |
URL | Kohde-URL, koko schema mukaan lukien. |
Parametrin nimi | Sen parametrin nimi, jota käytetään nykyisen objektin ID:n välittämiseen. |
Käytössä | Mahdollistaa mukautetun liitännän käyttöönoton ja käytöstä poistamisen. Mukautettuja liitännäisiä voi myös poistaa, jos niitä ei enää tarvita. |
Todennuksen suola | Jaettu salainen avain, jota käytetään todennuksen hassin laskemiseen. Pakollinen, kun todennuksen hash on käytössä. |
Konfiguraatiovaihtoehdot
Lisää todennuksen suola: Ottaa käyttöön payloadiin lisättävän todennuksen hashin, jota voidaan käyttää varmistamaan, että pyyntö tulee mukautetusta liitännästä.
Sisällytä payload verifiointihashiin: Tämä vaihtoehto laskee todennuksen hashin uudelleen koko payloadilla, mukaan lukien käyttäjä- ja asiakasnumerot.
Lisää organisaation ja toimipisteen tiedot: Tämä vaihtoehto sisältää automaattisesti tarvittavat organisaation ja toimipisteen tiedot. Provet lisää pyyntöön nämä parametrit: Provetin nimi (organisaation ydin), Provetin ID (tuotteen organisaation ID) ja Toimipisteen ID.
Parametrin arvon etuliitteet
Parametrin arvoon on mahdollista lisätä mukautettu etuliite määrittämällä parametrin nimi eri tavalla.
Esimerkiksi, jos määrität parametrin nimeksi 'id=client_', se lähettää pyynnön muodossa https://example.com/?id=client_1.
Otsikot
Taustapyynnöille ('Lähetä HTTP-pyyntö') voi antaa mielivaltaisia staattisia arvoja, jotka lisätään pyyntöihin.
Näitä voidaan käyttää Authorisation-otsikoiden lisäämiseen pyyntöihin.
Tätä ominaisuutta ei ole toteutettu taustalla näkyville pyynnöille ('Avaa uudessa ikkunassa', 'Avaa sivupaneelissa'). Lähetettyjä otsikoita ei myöskään kirjata.
Payloadin tiedot
Asetusnäkymässä näkyy lista payloadin avaimista ja arvoista, jotka lähetetään pyynnön mukana. Lista päivittyy, kun asetuksia muokataan.
Toimintotyypit
1. Lähetä HTTP-pyyntö
Pyyntö ajoitetaan taustalle ja lähetetään Provetin palvelimilla. Käyttäjät eivät näe verkkosivua, mutta he voivat nähdä tiedotteen, kun lähetys etenee.
Pyyntö tulee Provetin lähtevien IP-osoitteista.
Lähetys tapahtuu asynkronisesti, ja viive voi olla riippuen siitä, kuinka paljon palvelimilla on parhaillaan tekemistä.
Näet tiedotteen sivun yläosassa, kun pyyntöä ollaan ajamassa.
Onnistumisilmoitus näytetään, jos pyyntö lähetetään onnistuneesti ja liitäntä vastaa onnistuneella HTTP-tilakoodilla (200–299 mukaan lukien).
Jos pyyntö epäonnistuu, näytetään virheilmoitus 'Integration request failed', ja suluissa on tarkempi virhesanoma.
Virheilmoitus | Kuvaus |
Backend error | Tapahtui tuntematon virhe Provetin worker-palvelimilla. Ota yhteyttä Provetin tukeen lisätietojen saamiseksi. |
Yhteysvirhe | Pyyntö lähetyksen ajoittamiseksi ei mennyt perille. |
Virheelliset tiedot | Pyyntö lähetyksen ajoittamiseksi sisälsi virheellisiä tietoja. |
Liitäntävirhe | Pyyntö lähetettiin onnistuneesti, mutta liitäntä vastasi ei-onnistuneella HTTP-tilakoodilla (alle 200 tai yli 299). |
2. Avaa uudessa ikkunassa
Kohde-URL avataan uuteen ikkunaan tai selaimen välilehteen.
Jos käytetään GET-pyyntöä, käyttäjät voivat nähdä payloadin tiedot selaimen osoiterivillä.
3. Avaa sivupaneelissa
Kohde-URL upotetaan Provetiin avaamalla sivupaneeli sivun sisällön päälle ja näyttämällä sivu iframe-elementtinä.
Kohde-URL:n täytyy tukea upottamista (X-Frame-Options-otsikko täytyy asettaa oikein).
Käyttö
Mukautetut liitännät renderöidään painikkeina kohdesivuilla.
Jos sivulle on määritetty vain yksi liitäntä, se renderöidään tavallisena painikkeena.
Jos sivulla on useita liitännäisiä, ne renderöidään avattavana valikkona.
Mukautetut liitännät lähettävät vain olennaisen objektin ID:n (asiakasnumero, potilasnumero, laskun ID jne.), joita voidaan kysellä Provetin REST API:n avulla.
Sivu | Painikkeen sijainti | ID lähetetään parametrina |
Asiakas | Oikealla puolella, Muistiinpanot-osion yläpuolella (ei potilaan välilehdillä). | Asiakasnumero |
Eläin | Oikealla puolella, Muistiinpanot-osion yläpuolella (ei asiakasvälilehdillä). | Potilasnumero |
Lasku | Laskun alaosan työkalupalkissa (mukaan lukien käsikauppamyynti-sivut). | Laskun ID (ei laskunumero) |
Käynti | Yleiset tiedot -osion yläpuolella sekä meneillään olevissa että merkitty valmiiksi olevissa käynneissä. | Käynnin ID |
Ajanvarauskalenteri | Ajanvarauskalenterin yläpuolella. | Aktiivisen toimipisteen ID |
Työvuorokalenteri | Työvuorokalenterin yläpuolella. | Aktiivisen toimipisteen ID |
Diagnostinen kuvantaminen | Diagnostisen kuvantamisen lähetteet -sivulla ylä- ja alatyökaluriveillä. | Diagnostisen kuvantamisen läheteen tunnus |
Kutsut | Muistutukset-sivun valintatyökalupalkissa, kun yksi tai useampi muistutus on valittu. | Muistutuksen ID jokaiselle valitulle muistutukselle |
Loki
Taustalla lähetetyt pyynnöt ('Lähetä HTTP-pyyntö') kirjataan sisäiseen lokiin todennusta ja auditointia varten.
Siirry kohtaan Asetukset > Liitännät > Mukautetut liitännät > Loki.
Lokinäkymässä listataan kaikki tehdyt pyynnöt, uusin pyyntö ensin.
Näytä lisätiedot yksityiskohtanäkymässä valitsemalla kunkin rivin oikealta puolelta silmä-painike.
Muistiinpano
Kirjausta ei tehdä taustalla näkyville pyynnöille ('Avaa uudessa ikkunassa', 'Avaa sivupaneelissa').
Todennuksen suola ja hashit
'Todennuksen suola' -vaihtoehto on näkyvissä vain, jos 'Lisää todennuksen suola' on valittu. Lisäksi 'Sisällytä payload verifiointihashiin' näytetään myös silloin, kun 'Lisää todennuksen suola' on valittu.
Todennuksen hash lasketaan seuraavasti käyttöoikeuksien yhdistelmän perusteella:
1. Todennuksen suola on käytössä, "include payload in verficiation option" ei ole käytössä -> hash lasketaan muodossa: Heksadesimaalinen todennuksen MD5-tiiviste, esim. "4e531ee13aa16886db72bc1621206d2f". Tiiviste luodaan lisäämällä todennuksen suola aikaleiman jälkeen ("2018-07-15T09:12:54+00:00My verification salt"). [merkkijono]2. Todennuksen suola on käytössä, "include payload in verification option" on käytössä, "Add organization and department information" on POISTETTU KÄYTÖSTÄ -> hash lasketaan muodossa: Heksadesimaalinen todennuksen MD5-tiiviste, esim. "23ae5385b3862a571f1b5d6f6b469b1c". Tiiviste lasketaan käyttämällä: "<timestamp><salt><parameter_name><object_id>user_id<user_id>" ("2018-07-15T09:12:54+00:00My verification saltpatient_id1234user_id56"). [merkkijono]3. Todennuksen suola on käytössä, "include payload in verification option" on käytössä, "Add organization and department information" on KÄYTÖSSÄ -> hash lasketaan muodossa: Heksadesimaalinen todennuksen MD5-tiiviste, esim. "163049a017bb405d4bfec754810c9838". Tiiviste lasketaan käyttämällä: "<timestamp><salt><parameter_name><object_id>user_id<user_id>provet_env<provet_env>provet_id<provet_id>department_id<department_id>" ("2018-07-15T09:12:54+00:00My verification saltpatient_id1234user_id56provet_envenvprovet_id12345department_id12"). [merkkijono]Todennuksen hasheja voidaan käyttää lisävarmistuksena sen tarkistamiseen, mitkä pyynnöt tulevat Provetin mukautetusta liitännästä.
Kun se on käytössä, pyyntöihin lisätään lisäparametri nimeltä "verification".
Tämä parametri on MD5 hash digest aikaleimasta ja todennuksen suolasta.
Taustalla tapahtuvassa lähetyksessä aikaleima luodaan silloin, kun pyyntö todellisuudessa lähetetään.
Edessä näkyvässä lähetyksessä aikaleima luodaan silloin, kun sivu, joka sisältää mukautetun liitännän painikkeen, ladataan.
Esimerkiksi sen varmistamiseksi, että todennuksen hash on validi Pythonissa, voidaan kirjoittaa funktio kuten tämä:
from hashlib import md5VERIFICATION_SALT = "My custom verification salt"def is_verification_hash_valid(parameters): hasher = md5() hasher.update(parameters.timestamp.encode("utf8")) hasher.update(VERIFICATION_SALT.encode("utf8")) return hasher.hexdigest() == parameters.verificationKaksisuuntainen viestintä Provetin kanssa
Provet mahdollistaa rajatun määrän kaksisuuntaista viestintää mukautettujen liitäntöjen kanssa, jotka avataan etualalla Window.postMessage() API:n avulla.
Ainoa sallittu komento on "reload".
function refreshProvetCloud() { window.opener.postMessage("reload","*");}Tämä komento suorittaa täyden sivulatauksen ikkunassa tai välilehdessä, joka avasi mukautetun liitännän.
Tämä voi olla hyödyllistä, jos mukautettu liitäntä päivittää Provetin tietoja REST API:n avulla.