MediRund Technische aspecten data opvragen

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)


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


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


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


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


contextMessage ? ? ? ? ? ? <par:participantCode>? <par:participantCodeType>? <par:countryCode>? <par:participantCode>? <par:participantCodeType>? <par:countryCode>? <par:participantCode>? <par:participantCodeType>? <par:countryCode>? <par:participantCode>? <par:participantCodeType>? <par:countryCode>? ? ? ? ? ? ? ? ?

Totale contextMessage

noodzakelijke velden voor huidige 3 operaties


Vulling contextMessage •

verplicht

– gebruikersnaam in MediRund – (gebruikersnaam CRV voor veehouders) • – vaste vulling, waarde C

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 •

verplicht

– <par:participantCode> – relatienummer in MediRund van de gebruiker – <par:participantCodeType> – vaste vulling, waarde PAR Technische aspecten data opvragen | Arnold Harbers | 5 maart 2012 | 16

Vulling contextMessage •

verplicht

– <par:participantCode> – relatienummer veehouder, UBN nummer – <par:participantCodeType> – vaste vulling, waarde UBN •

niet verplicht

– taalcode, nld voor nederlandstalige meldingen. •

verplicht

– vaste vulling, waarde organisation •

verplicht

– vaste vulling, waarde crv.nl


serviceMessage • Algemeen bericht, geeft resultaat van de verwerking Belangrijkste veld ? ? ? ? ? ? ? ? ? ? ? ?

Ook van belang


serviceMessage • 0

succesvol

<0

technische fout

>0

functionele fout/waarschuwing

• – Melding behorend bij de serviceStatus • – Soort melding (volgens MediRund!) – E = error – W = warning


getAntibioticsUsageResult • requestMessage: antibioticsUsageRequest – – 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

– – UBN veehouder: idem aan uit contextMessage – verplicht als resultType KEEPER – – filter op jaar – optioneel, niet gevuld dan meest recente periode – – filter op kwartaal – optioneel, niet gevuld dan meest recente periode


getAntibioticsUsageResult • responseMessage: antibioticsUsageResult – + – idem invoer – – bedrijfssoort waar het bedrijf toe behoort – B: vleesvee (niet-melkvee) bedrijf – D: melkvee bedrijf

– – : begindatum periode – <endDate>: einddatum periode – – datum-tijd waarop gegevens berekend zijn.


getAntibioticsUsageResult • responseMessage: antibioticsUsageResult – – een categorie per grafiek – – – – –

bedrijf per keuze middel per leeftijdscategorie per toedieningsroute per therapeutische groep

– – groepen per categorie – bijv 1, 2, 3 voor keuze middel

– – DD/DJ


getAverageHerdWeight • requestMessage: averageHerdWeightRequest – – UBN veehouder: idem uit contextMessage – – filter op jaar – optioneel, niet gevuld dan meest recente periode – – filter op kwartaal – optioneel, niet gevuld dan meest recente periode


getAverageHerdWeight • responseMessage: averageHerdWeightResult – – idem invoer – – : begindatum periode – <endDate>: einddatum periode – – leeftijdscategorie – – gemiddeld aanwezige dieren per leeftijdscategorie – – standaardgewicht per leeftijdscategorie Technische aspecten data opvragen | Arnold Harbers | 5 maart 2012 | 24

listMedicineTransaction • requestMessage: listMedicineTransactionRequest – – UBN veehouder: idem uit contextMessage – – filter op jaar – optioneel, niet gevuld dan meest recente periode – – 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 • – : begindatum periode – <endDate>: einddatum periode • <medicineTransaction> – UBN veehouder – diersoort – D (melkvee) of B (vleesvee) – UDN dierenarts – <medicineTransactionType> soort transactie – ADD (bij), COR (correctie, af) – datum – format eejjmmdd Technische aspecten data opvragen | Arnold Harbers | 5 maart 2012 | 26

listMedicineTransaction – <EANCode> – Code uit de BCT van de FIDIN – 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 5 betekent dat er 5 maal een verpakking van 20 tabletten geleverd is  5*20 = 100 tabletten. – Leverantie van 1 tablet  0.05


listMedicineTransaction – batchcode medicijn – cascade regeling toegepast – F(alse) of T(rue) – leeftijdsgroep – 8WK, 1YR, 2YR, OLD – opmerkingen – datum-tijd van registratie – <provider> relatienummer van de gebruiker die de transactie aangeleverd heeft – UDN dierenarts, relatienummer VetCIS


Foutafhandeling • Aan de voordeur – controle tegen de XSD – response middels SOAP fault element – env:ESBMessageProcessingFailed – ESB Couldn't process message due to unhandled exception

– 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: [email protected] – telefoon: 026 - 3898717 of 026 - 3898798


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


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


MediRund Technische aspecten data opvragen

Recommend Documents