Mukautetut liitännät on Provetin toiminto, joka mahdollistaa pyyntöjen lähettämisen ulkopuolisille resursseille suoraan Provetista. Tämän toiminnon käyttöönottoa varten, ota yhteyttä Provetin tukeen.
Hallinta
Mukautettuja liitäntöjä hallitaan Asetukset > Liitännät > Mukautetut liitännät.
Lisätäksesi liitännän, valitse Lisää -painike.
Muokataksesi liitäntää, valitse kynä -painike liitännän riviltä.
Asetukset
Kenttä | Kuvaus |
Nimi | Määrittelee käyttöliittymässä näkyvän painikkeen nimen. |
Määrittelee, millä Provetin sivulla painike on näkyvissä. Kukin mukautettu liitäntä voi olla näkyvissä vain yhdellä sivulla, mutta sama määritys voidaan toistaa, jos liitäntä halutaan näkyviin useammalle sivulle. | |
Toiminto | Määrittää, mikä toiminto suoritetaan, kun painike valitaan. |
HTTP-tapa | Määrittelee, lähetetäänkö pyyntö GET-pyyntönä (payload, joka on toimitettu kyselymerkkijonon parametreina) vai POST-pyyntönä (payload toimitetaan lomakedatan muodossa). |
URL | Kohde-URL kokonaisuudessaan, mukaan lukien skeema (esim. https://). |
Parametrin nimi | Nykyisen objektin ID:n toimittamiseen käytettävä parametrin nimi. |
Enabled | Mahdollistaa mukautetun liitännän aktivoinnin ja deaktivoimisen. Mukautetut liitännät voidaan myös poistaa, jos niitä ei enää tarvita. |
Todennuksen suola | Jaettu salaisuus, jota käytetään todennushashin laskemiseen. Tarvitaan, kun todennushash on käytössä. |
Konfiguraatioasetukset
Lisää todennuksen suola: Ottaa käyttöön todennuksenhashin payloadissa, tätä voidaan käyttää vahvistamaan, että pyyntö tulee mukautetusta liitännästä.
Sisällytä payload verifiointihashiin: Tämä vaihtoehto laskee todennushashin uudelleen käyttäen koko payloadia, mukaan lukien käyttäjän ja asiakkaan tunnukset.
Lisää organisaation ja toimipisteen tiedot: Tämä vaihtoehto sisällyttää tarvittavat organisaatio- ja toimipistetiedot automaattisesti. Provet liittää nämä parametrit pyyntöön: Provet-nimi (organisaation ydin), Provet ID (organisaation ID) ja toimipiste ID.
Etuliiteparametrin arvo
On mahdollista lisätä mukautettu etuliite parametrin arvoon määrittämällä parametrin nimi eri tavalla.
Esimerkiksi, jos määrität parametrin nimen muotoon 'id=client_', se lähettää pyynnön 'https://example.com/?id=client_1'.
Otsikot
Taustapyyntöihin ('Lähetä HTTP-pyyntö') voidaan antaa mielivaltaisia, staattisia arvoja, jotka lisätään pyyntöihin.
Tätä voidaan käyttää valtuutusotsikoiden lisäämiseksi pyyntöihin.
Tätä ominaisuutta ei ole toteutettu etualan pyynnöille ('Avaa uudessa ikkunassa', 'Avaa sivupaneelissa'). Lähetettyjä otsikoita ei myöskään kirjata.
Payloadin tiedot
Asetusnäkymä näyttää luettelon payloadin avaimista ja arvoista, jotka lähetetään pyynnön mukana. Tämä luettelo päivittyy asetuksia muokattaessa.
Toimintotyypit
1. Lähetä HTTP-pyyntö
Pyyntö aikataulutetaan taustalla ja lähetetään Provetin palvelimien kautta. Käyttäjät eivät näe verkkosivua, mutta saattavat nähdä ilmoituksen, kun lähetys etenee.
Pyyntö tulee Provetin lähtevistä IP-osoitteista.
Lähetys tapahtuu asynkronisesti, ja viivettä voi esiintyä riippuen palvelimen työmäärästä.
Näet ilmoituksen sivun yläosassa, kun pyyntöä aikataulutetaan.
Ilmoitus näytetään, jos pyyntö lähetetään onnistuneesti ja liitäntä vastaa onnistuneella HTTP-statuskoodilla (200 ja 299 mukaan lukien).
Jos pyyntö epäonnistuu, näytetään virheilmoitus, jossa lukee 'Integraatiopyyntö epäonnistui', ja tarkempi virheilmoitus on sulkeissa.
Virheilmoitus | Kuvaus |
Taustavirhe | Provetin taustapalvelimilla tapahtui tuntematon virhe. Ota yhteyttä Provet-tukeen lisätietojen saamiseksi. |
Yhteysvirhe | Pyyntö lähetyksen aikatauluttamisesta ei onnistunut. |
Datavirhe | Pyyntö lähetyksen aikatauluttamisesta sisälsi virheellisiä tietoja. |
Liitäntävirhe | Pyyntö lähetettiin onnistuneesti, mutta liitäntä vastasi epäonnistuneella HTTP-statuskoodilla (alle 200 tai yli 299). |
2. Avaa uudessa välilehdessä
Kohde-URL avataan uudessa ikkunassa tai selainvälilehdessä.
Jos GET-pyyntö on käytössä, 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ä sivun iframe-elementtinä.
Kohde-URL:n on tuettava upottamista (X-Frame-Options-otsikon on oltava asetettu oikein).
Käyttö
Mukautetut liitännät näkyvät painikkeina kohdesivuilla.
Jos sivulle on määritetty vain yksi liitäntä, se näytetään tavallisena painikkeena.
Jos sivulla on useita liitäntöjä, ne näkyvät pudotusvalikkona.
Mukautetut liitännät lähettävät vain asiaankuuluvan objektin ID:n (asiakkaan ID, potilaan ID, laskun ID jne.), josta voidaan tehdä kyselyjä Provet REST API:sta.
Sivu | Painikkeen sijainti | ID lähetetään parametrina |
Asiakas | Oikealla, Muistiinpanot-osion yläpuolella (ei potilaskortin välilehdillä). | Asiakasnumero |
Eläin | Oikealla, Muistiinpanot-osion yläpuolella (ei asiakkaan kortin välilehdillä). | Potilasnumero |
Lasku | Laskusivun (mukaan lukien käsikauppamyynti) alareunan työkalupalkissa. | Lasku ID (ei laskunumero) |
Käynti | Käynnin tiedot -osion yläpuolella, sekä käynnissä olevissa että viimestellyissä 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ähetesivun ylhäällä ja alhaalla olevassa työkalupalkissa. | Diagnostisen kuvantamisen lähetteen ID |
Kutsut | Kutsusivulla valintapalkissa, kun yksi tai useampi kutsu on valittuna. | Kutsun ID jokaiselle valitulle kutsulle |
Loki
Taustalla lähetetyt pyynnöt ('Lähetä HTTP-pyyntö') kirjataan sisäiseen lokiin varmennusta ja tarkastusta varten.
Siirry Asetukset > Liitännät > Mukautetut liitännät > Loki.
Lokinäkymässä on luettelo kaikista tehdyistä pyynnöistä, alkaen viimeisimmästä pyynnöstä.
Lisätietoja näet valitsemalla oikeassa reunassa olevan silmäpainikkeen.
Huomaa
Lokimerkintöjä ei suoriteta etualan pyynnöille ('Avaa uudessa ikkunassa', 'Avaa sivupaneelissa').
Todennuksen Suola & Hashit
"Todennuksen suola" -vaihtoehto näkyy vain, jos "Lisää todennuksen suola" on valittuna. Lisäksi, "Sisällytä payload verifiointihashiin" on myös näkyvissä, kun "Lisää todennuksen suola" on valittuna.
Oikeuksien yhdistelmään perustuen todennushash lasketaan seuraavasti:
1. Verification salt enabled, "include payload in verficiation option" disabled -> hash calculated as:Hexadecimal verification MD5 hash digest, e.g. "4e531ee13aa16886db72bc1621206d2f". The hash is generated by appending the verification salt after the included timestamp ("2018-07-15T09:12:54+00:00My verification salt"). [string]2. Verification salt enabled, "include payload in verification option" enabled, "Add organization and department information" DISABLED -> hash calculated as:Hexadecimal verification MD5 hash digest, e.g. "23ae5385b3862a571f1b5d6f6b469b1c". The hash is calculated with: "<timestamp><salt><parameter_name><object_id>user_id<user_id>" ("2018-07-15T09:12:54+00:00My verification saltpatient_id1234user_id56"). [string]3. Verification salt enabled, "include payload in verification option" enabled, "Add organization and department information" ENABLED -> hash calculated as:Hexadecimal verification MD5 hash digest, e.g. "163049a017bb405d4bfec754810c9838". The hash is calculated with: "<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"). [string]Todennushash -arvoja voidaan käyttää lisätodennuksena varmistamaan, mitkä pyynnöt tulevat Provetin mukautetusta liitännästä.
Kun se on käytössä, lisäparametri nimeltä "todennus" lisätään pyyntöihin.
Tämä parametri on aikaleiman ja vahvistussuolan MD5-tiiviste.
Taustalähetyksessä aikaleima muodostetaan sillä hetkellä, kun pyyntö todella lähetetään.
Etulähetyksessä aikaleima muodostetaan, kun sivu, jolla mukautetun liitännän painike on, ladataan.
Esimerkiksi varmistaakseen, että todennus hash on voimassa Pythonissa, voisi kirjoittaa funktion tällaiseksi:
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 sallii rajoitetun määrän kaksisuuntaista viestintää, kun mukautetut liitännät avataan etualalla käyttäen Window.postMessage() API:a.
Ainoa kelvollinen komento on "reload".
function refreshProvetCloud() { window.opener.postMessage("reload","*");}Tämä komento suorittaa koko sivun uudelleenlatauksen 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 kautta.