MediRund Technische aspecten data opvragen

Transcriptie

1 MediRund Technische aspecten data opvragen Arnold Harbers 5 maart 2012

2 Programma achtergrond dia 3-11 toelichting webservice dia foutafhandeling dia 29 technische vragen dia 30 testtraject dia Technische aspecten data opvragen Arnold Harbers 5 maart

3 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

4 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

5 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

6 Kengetallen Technische aspecten data opvragen Arnold Harbers 5 maart

7 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

8 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

9 Toelichting

10 Leveranties

11 Machtigingen

12 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

13 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

14 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

15 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

16 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

17 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

18 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

19 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

20 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

21 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

22 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

23 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

24 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

25 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

26 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

27 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 (Rimadyl smakelijke tabletten) heeft volgens de BCT van de FIDIN een verpakkingsvorm van 20 tabletten Een bericht met <EANCode> <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

28 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

29 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

30 Technische vragen MediRund Supportdesk functioneel applicatiebeheerders van CRV telefoon: of Technische aspecten data opvragen Arnold Harbers 5 maart

31 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

32 Tijdspad nu: webservice contract + deze presentatie ook via 1 april: XSD, WSDL ophalen via 1 april: operaties beschikbaar in acceptatie Technische aspecten data opvragen Arnold Harbers 5 maart