MediRund Technische aspecten data opvragen Arnold Harbers 5 maart 2012
Programma achtergrond dia 3-11 toelichting webservice dia 12-28 foutafhandeling dia 29 technische vragen dia 30 testtraject dia 31-32 Technische aspecten data opvragen Arnold Harbers 5 maart 2012 2
Achtergrond: data aanleveren Vier soorten gegevens Voorgeschreven medicijnen Aanwezige dieren Kenmerken van medicijnen Deelname kwaliteitssysteem Voorgeschreven medicijnen Machtiging veehouder - dierenarts in MediRund Aanlevering door dierenarts automatisch van PMS naar MediRund evt. via website MediRund Technische aspecten data opvragen Arnold Harbers 5 maart 2012 3
Achtergrond: data aanleveren Aanwezige dieren I&R Kenmerken van medicijnen EAN codes FIDIN Werkzame stoffen Apotheek van Faculteit Diergeneeskunde Deelname kwaliteitssysteem Eigenaren kwaliteitssysteem (zuivel / vlees) Technische aspecten data opvragen Arnold Harbers 5 maart 2012 4
Achtergrond: rapportage Kengetallen Dagdosering per dierjaar (DD/DJ) melkvee / niet-melkvee landelijk gemiddelde / verdeling De standaardmaat bij antibioticumgebruik die bedrijven onafhankelijk van bedrijfsgrootte of soort antibioticumgebruik onderling vergelijkbaar maakt. 1 DD geeft weer hoeveel milligram van een bepaalde werkzame stof nodig is om 1 kilogram dier 1 dag met dat diergeneesmiddel te behandelen. DD s worden omgerekend naar kg behandeld dier en gedeeld door het gemiddeld aantal aanwezige kg dier om te komen tot DagDosering per DierJaar. SDa benchmarkindicatoren streef-, signalerings-, actiewaarde Gewicht veestapel Toelichting Leveranties Machtiging Technische aspecten data opvragen Arnold Harbers 5 maart 2012 5
Kengetallen Technische aspecten data opvragen Arnold Harbers 5 maart 2012 6
Kengetallen Bedrijfsgemiddelde Landelijk gemiddelde Streefwaarde Landelijke verdeling Gewicht veestapel gemiddeld aanwezige dieren per leeftijdscategorie standaardgewicht per leeftijdscategorie Technische aspecten data opvragen Arnold Harbers 5 maart 2012 7
Achtergrond: rapportage Toelichting rekenmethode Leveranties behandelbaar gewicht Machtiging ter info Vier keer per jaar ieder kalenderkwartaal rollend 4 kwartalen terug beschikbaar: halverwege maand na afloop kwartaal max 14 dagen tussen leverdatum en registratiedatum Technische aspecten data opvragen Arnold Harbers 5 maart 2012 8
Toelichting
Leveranties
Machtigingen
Webservice Uitgangspunt: gegevens rapport via webservice opvragen kengetallen (DD/DJ) leveranties gewicht veestapel autorisatie veehouder zelf gemachtigd door veehouder in MediRund Technische aspecten data opvragen Arnold Harbers 5 maart 2012 12
Webservice operaties Webservice rshealth operatie getantibioticsusageresult doel: opvragen van DD/DJ van een bedrijf, landelijke verdeling, SDa benchmarkindicatoren over een periode operatie listmedicinetransaction doel: opvragen van leveranties van een bedrijf over een periode Webservice rsanimal operatie getaverageherdweight doel: opvragen van gewicht van de gemiddeld aanwezige dieren van een bedrijf over een periode Technische aspecten data opvragen Arnold Harbers 5 maart 2012 13
Operatie - Algemeen Input contextmessage (algemeen, autorisatie) requestmessage (specifiek, functionaliteit) Output responsemessage (specifiek, functionaliteit) servicemessage (algemeen, resultaat verwerking) Endpoint productie: apps.medirund.nl acceptatie: accapps.medirund.nl Technische aspecten data opvragen Arnold Harbers 5 maart 2012 14
contextmessage <heal:contextmessage> <com:sessionid>?</com:sessionid> <com:processid>?</com:processid> <com:instanceid>?</com:instanceid> <com:username>?</com:username> <com:usertype>?</com:usertype> <com:password>?</com:password> <com1:organisation> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> <par:countrycode>?</par:countrycode> </com1:organisation> <com1:provider> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> <par:countrycode>?</par:countrycode> </com1:provider> <com1:customer> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> <par:countrycode>?</par:countrycode> </com1:customer> <com1:keeper> <par:participantcode>?</par:participantcode> <par:participantcodetype>?</par:participantcodetype> <par:countrycode>?</par:countrycode> </com1:keeper> <com1:animal> <anim:animalnumber>?</anim:animalnumber> <anim:animalnumbertype>?</anim:animalnumbertype> </com1:animal> <com:processcode>?</com:processcode> <com:messagesource>?</com:messagesource> <com:languagecode>?</com:languagecode> <com:timezone>?</com:timezone> <com1:contextmessagedetail> <com:contextcode>?</com:contextcode> <com:contextvalue>?</com:contextvalue> </com1:contextmessagedetail> <heal:contextmessage> Totale contextmessage noodzakelijke velden voor huidige 3 operaties Technische aspecten data opvragen Arnold Harbers 5 maart 2012 15
Vulling contextmessage <com:username> gebruikersnaam in MediRund verplicht (gebruikersnaam CRV voor veehouders) <com:usertype> vaste vulling, waarde C <com:password> verplicht verplicht wachtwoord in MediRund welke ook geldt voor de webapplicatie. Let op: als dierenarts in de webapplicatie zijn wachtwoord wijzigt zal dit dus ook doorwerken in de webservice <com1:customer> <par:participantcode> verplicht relatienummer in MediRund van de gebruiker <par:participantcodetype> vaste vulling, waarde PAR Technische aspecten data opvragen Arnold Harbers 5 maart 2012 16
Vulling contextmessage <com1:keeper> verplicht <par:participantcode> relatienummer veehouder, UBN nummer <par:participantcodetype> vaste vulling, waarde UBN <com:languagecode> niet verplicht taalcode, nld voor nederlandstalige meldingen. <com:contextcode> verplicht vaste vulling, waarde organisation <com:contextvalue> verplicht vaste vulling, waarde crv.nl Technische aspecten data opvragen Arnold Harbers 5 maart 2012 17
servicemessage Algemeen bericht, geeft resultaat van de verwerking <heal:servicemessage> <com:servicestatus>?</com:servicestatus> <com:messagecode>?</com:messagecode> <com:messagetext>?</com:messagetext> <com:messagetype>?</com:messagetype> <com:sourcetype>?</com:sourcetype> <com:sourcecode>?</com:sourcecode> <com1:servicemessagedetail> <com:servicestatus>?</com:servicestatus> <com1:codedetail> <com:keyid>?</com:keyid> <com:keyvalue>?</com:keyvalue> </com1:codedetail> <com:messagecode>?</com:messagecode> <com:messagetext>?</com:messagetext> <com:messagetype>?</com:messagetype> </com1:servicemessagedetail> </heal:servicemessage> Belangrijkste veld Ook van belang Technische aspecten data opvragen Arnold Harbers 5 maart 2012 18
servicemessage <com:servicestatus> 0 succesvol <0 technische fout >0 functionele fout/waarschuwing <com:messagetext> Melding behorend bij de servicestatus <com:messagetype> Soort melding (volgens MediRund!) E = error W = warning Technische aspecten data opvragen Arnold Harbers 5 maart 2012 19
getantibioticsusageresult requestmessage: antibioticsusagerequest <resulttype> welk resultaat wil je? KEEPER: resultaat van een specifiek bedrijf NATDIS[B/D]: landelijke gemiddelde en verdeling voor [vlees/melk]veebedrijven IND[B/D]: Sda benchmarkindicatoren voor [vlees/melk]veebedrijven <keeper> UBN veehouder: idem aan <keeper> uit contextmessage verplicht als resulttype KEEPER <year> filter op jaar optioneel, niet gevuld dan meest recente periode <quarter> filter op kwartaal optioneel, niet gevuld dan meest recente periode Technische aspecten data opvragen Arnold Harbers 5 maart 2012 20
getantibioticsusageresult responsemessage: antibioticsusageresult <resulttype> + <keeper> idem invoer <referencegroup> bedrijfssoort waar het bedrijf toe behoort B: vleesvee (niet-melkvee) bedrijf D: melkvee bedrijf <referenceperiod> <begindate>: begindatum periode <enddate>: einddatum periode <calculationdatetime> datum-tijd waarop gegevens berekend zijn. Technische aspecten data opvragen Arnold Harbers 5 maart 2012 21
getantibioticsusageresult responsemessage: antibioticsusageresult <categorycd> een categorie per grafiek bedrijf per keuze middel per leeftijdscategorie per toedieningsroute per therapeutische groep <typecd> groepen per categorie bijv 1, 2, 3 voor keuze middel <animaldailydosage> DD/DJ Technische aspecten data opvragen Arnold Harbers 5 maart 2012 22
getaverageherdweight requestmessage: averageherdweightrequest <keeper> UBN veehouder: idem <keeper> uit contextmessage <year> filter op jaar optioneel, niet gevuld dan meest recente periode <quarter> filter op kwartaal optioneel, niet gevuld dan meest recente periode Technische aspecten data opvragen Arnold Harbers 5 maart 2012 23
getaverageherdweight responsemessage: averageherdweightresult <keeper> idem invoer <referenceperiod> <begindate>: begindatum periode <enddate>: einddatum periode <categorycd> leeftijdscategorie <avgnoanimals> gemiddeld aanwezige dieren per leeftijdscategorie <avgweightanimals> standaardgewicht per leeftijdscategorie Technische aspecten data opvragen Arnold Harbers 5 maart 2012 24
listmedicinetransaction requestmessage: listmedicinetransactionrequest <keeper> UBN veehouder: idem <keeper> uit contextmessage <year> filter op jaar optioneel, niet gevuld dan meest recente periode <quarter> filter op kwartaal optioneel, niet gevuld dan meest recente periode <modifiedsincedate> wijzigingsdatum, alleen transacties met een wijziging op of na deze datum worden teruggeleverd optioneel, niet gevuld dan alle transacties uit de periode Technische aspecten data opvragen Arnold Harbers 5 maart 2012 25
listmedicinetransaction <referenceperiod> <begindate>: begindatum periode <enddate>: einddatum periode <medicinetransaction> <keeper> UBN veehouder <animalspeciescd> diersoort D (melkvee) of B (vleesvee) <veterinarian> UDN dierenarts <medicinetransactiontype> soort transactie ADD (bij), COR (correctie, af) <transactiondate> datum format eejjmmdd Technische aspecten data opvragen Arnold Harbers 5 maart 2012 26
listmedicinetransaction <EANCode> Code uit de BCT van de FIDIN <nrofmedicine> BELANGRIJK aantal eenheden van deze EAN altijd positief getal, inclusief decimalen voorbeeld ter verduidelijking van de werking: EAN 8715885001135 (Rimadyl smakelijke tabletten) heeft volgens de BCT van de FIDIN een verpakkingsvorm van 20 tabletten Een bericht met <EANCode> 8715885001135 <medicinetransactiontype> ADD en <nrofmedicine> 5 betekent dat er 5 maal een verpakking van 20 tabletten geleverd is 5*20 = 100 tabletten. Leverantie van 1 tablet <nrofmedicine>0.05 Technische aspecten data opvragen Arnold Harbers 5 maart 2012 27
listmedicinetransaction <batch> batchcode medicijn <cascade> cascade regeling toegepast F(alse) of T(rue) <animalagegroup> leeftijdsgroep 8WK, 1YR, 2YR, OLD <remarks> opmerkingen <registrationdatetime> datum-tijd van registratie <provider> relatienummer van de gebruiker die de transactie aangeleverd heeft UDN dierenarts, relatienummer VetCIS Technische aspecten data opvragen Arnold Harbers 5 maart 2012 28
Foutafhandeling Aan de voordeur controle tegen de XSD response middels SOAP fault element <faultcode>env:esbmessageprocessingfailed</faultcode> <faultstring>esb Couldn't process message due to unhandled exception</faultstring> mag in productie niet voorkomen fouttekst is niet voor de gebruiker Backoffice controle tegen business rules response middels servicemessage kan in productie voorkomen fouttekst kan aan de gebruiker getoond worden Technische aspecten data opvragen Arnold Harbers 5 maart 2012 29
Technische vragen MediRund Supportdesk functioneel applicatiebeheerders van CRV e-mail: ip-ondersteuning@crv4all.com telefoon: 026-3898717 of 026-3898798 Technische aspecten data opvragen Arnold Harbers 5 maart 2012 30
Testtraject Acceptatieomgeving MediRund acceptatie.medirund.nl Testdata test UBN s voor kengetallen, leveranties, gewichten aanvragen via MediRund supportdesk landelijke gemiddelden en verdeling TAG rapportage 2010 SDa benchmarkindicatoren melkvee 2011 Technische aspecten data opvragen Arnold Harbers 5 maart 2012 31
Tijdspad nu: webservice contract + deze presentatie ook via www.medirund.nl/softwareleveranciers 1 april: XSD, WSDL ophalen via www.medirund.nl/softwareleveranciers 1 april: operaties beschikbaar in acceptatie Technische aspecten data opvragen Arnold Harbers 5 maart 2012 32