Vejledning til test og oprettelse af data via XML og FMKs admin GUI

[Tom Kückelhahn Nilson]

Vejledning til test og oprettelse af data via XML og FMKs admin GUI


Formål
Denne vejledning indeholder information omkring hvorledes der kan testes, oprettes data mv. på FMKs testsystemer via FMKs admin GUI. Forudsætningen herfor er et nogenlunde kendskab til XML generelt og FMKs XML skemaer.

Adgang til FMKs admin GUI

Adgang til FMKs admin GUI findes f.eks. på URL'erne

   http://triforkprodtest.lms.trifork.com/fmk12/
   http://triforkfaellestest.lms.trifork.com/fmk12/
   Eller på tilsvarende URL for de lokale testmaskiner

Klik på "Administrationskonsol. Der logges ind med det tildelte brugernavn og password.

Send XML

Når der er logget ind herefter klikkes på "Test" og "Send XML".

I øverste tekstfelt, under "Indsæt XML", indsættes XML dokumentet for den service der ønskes udført. Dvs. at der skal tages udgangspunkt i et af Request-skemaerne. Bemærk at der ikke må være mellemrum, linjeskift eller lignende først i XML dokumentet, dvs. før <?xml ...

Herunder vælges den ønskede servicen, passende til det indsendte dokument, og der klikkes på "Send XML".

Svaret fra FMK vises i nederste felt.

Eksempel, "Opret lægemiddelordination"

Nedenstående XML dokument indsættes i øverste tekstfelt.

<?xml version="1.0" encoding="UTF-8"?>
<mc2011:CreateDrugMedicationRequestStructure xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2011/01/01 DKMA_CreateDrugMedicationRequestStructure.xsd" xmlns:cpr="http://rep.oio.dk/cpr.dk/xml/schemas/core/2005/03/18/" xmlns:itst="http://rep.oio.dk/itst.dk/xml/schemas/2005/01/10/" xmlns:mc2008="http://www.dkma.dk/medicinecard/xml.schema/2008/06/01" xmlns:mc2009="http://www.dkma.dk/medicinecard/xml.schema/2009/01/01" xmlns:mc2011="http://www.dkma.dk/medicinecard/xml.schema/2011/01/01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <cpr:PersonCivilRegistrationIdentifier>1111111118</cpr:PersonCivilRegistrationIdentifier>
   <mc2008:MedicineCardVersionIdentifier>1</mc2008:MedicineCardVersionIdentifier>
   <mc2009:OrganisationStructure>
      <mc2009:OrganisationName>Test praksis</mc2009:OrganisationName>
      <mc2009:AddressLine>Testvej 1</mc2009:AddressLine>
      <mc2009:AddressLine>1000 Testby</mc2009:AddressLine>
      <itst:TelephoneNumberIdentifier>12345678</itst:TelephoneNumberIdentifier>
      <mc2008:DoctorOrganisationIdentifier>1234</mc2008:DoctorOrganisationIdentifier>
   </mc2009:OrganisationStructure>
   <mc2008:DoctorStructure>
      <mc2008:AuthorisationIdentifier>12345</mc2008:AuthorisationIdentifier>
      <mc2008:DoctorName>Anita Andersen</mc2008:DoctorName>
   </mc2008:DoctorStructure>
   <mc2011:CreateDrugMedicationStructure>
      <mc2008:PauseDrugMedicationIndicator>false</mc2008:PauseDrugMedicationIndicator>
      <mc2009:PriceListVersionDate>2009-02-16</mc2009:PriceListVersionDate>
      <mc2009:DrugMedicationBeginEndDateStructure>
         <mc2009:DrugMedicationTreatmentStartDate>2009-01-01Z</mc2009:DrugMedicationTreatmentStartDate>
      </mc2009:DrugMedicationBeginEndDateStructure>
      <mc2009:IndicationStructure>
         <mc2008:IndicationCode>2</mc2008:IndicationCode>
      </mc2009:IndicationStructure>
      <mc2008:RouteOfAdministrationStructure>
         <mc2008:RouteOfAdministrationCode>OR</mc2008:RouteOfAdministrationCode>
      </mc2008:RouteOfAdministrationStructure>
      <mc2009:DrugStructure>
         <mc2008:DrugIdentifier>28103222101</mc2008:DrugIdentifier>
         <mc2008:DrugName>testdata</mc2008:DrugName>
      </mc2009:DrugStructure>
      <mc2009:DosageStructure>
         <mc2009:DosageTimesStructure>
      <mc2008:DosageTimesIterationIntervalQuantity>1</mc2008:DosageTimesIterationIntervalQuantity>
            <mc2008:DosageTimesStartDate>2009-02-16Z</mc2008:DosageTimesStartDate>
            <mc2009:DosageQuantityUnitText>stk</mc2009:DosageQuantityUnitText>
            <mc2009:DosageDayElementStructure>
               <mc2008:DosageDayIdentifier>1</mc2008:DosageDayIdentifier>
               <mc2009:AccordingToNeedDosageTimeElementStructure>
                  <mc2008:DosageQuantityValue>1</mc2008:DosageQuantityValue>
               </mc2009:AccordingToNeedDosageTimeElementStructure>
            </mc2009:DosageDayElementStructure>
         </mc2009:DosageTimesStructure>
      </mc2009:DosageStructure>
   </mc2011:CreateDrugMedicationStructure>
</mc2011:CreateDrugMedicationRequestStructure>

Der vælges "CreateDrugMedication", og der klikkes på "Send XML". Herefter vil FMKs svar vises, f.eks:

<mc2009:CreateDrugMedicationResponseStructure xmlns:mc2009="http://www.dkma.dk/medicinecard/xml.schema/2009/01/01" xmlns:mc2008="http://www.dkma.dk/medicinecard/xml.schema/2008/06/01" xmlns:cpr="http://rep.oio.dk/cpr.dk/xml/schemas/core/2005/03/18/"> <cpr:PersonCivilRegistrationIdentifier>1111111118</cpr:PersonCivilRegistrationIdentifier> <mc2008:MedicineCardVersionIdentifier>10</mc2008:MedicineCardVersionIdentifier> <mc2008:VersionMismatchWarningIndicator> </mc2008:VersionMismatchWarningIndicator> <mc2009:CreatedDrugMedicationStructure> <mc2008:DrugMedicationIdentifier>109413</mc2008:DrugMedicationIdentifier> <mc2008:DrugMedicationVersionIdentifier>1</mc2008:DrugMedicationVersionIdentifier> </mc2009:CreatedDrugMedicationStructure> </mc2009:CreateDrugMedicationResponseStructure>

Eksempel, "Hent lægemiddelordination"

Ud fra ovenstående svar kan lægemiddelordinationen hentes. Der sendes et dokument med CPR-nummer og lægemiddelordinations-ID svarende til ovenstående response. Værdien for  lægemiddelordinations-ID findes i feltet DrugMedicationIdentifier, i dette tilfælde altså 109413.
Dvs. nedenstående XML indsættes i øverste tekstfelt.

<?xml version="1.0" encoding="UTF-8"?>
<mc2009:DrugMedicationRequestStructure xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2008/06/01 DKMA_DrugMedicationRequestStructure.xsd" xmlns:cpr="http://rep.oio.dk/cpr.dk/xml/schemas/core/2005/03/18/" xmlns:mc2008="http://www.dkma.dk/medicinecard/xml.schema/2008/06/01" xmlns:mc2009="http://www.dkma.dk/medicinecard/xml.schema/2009/01/01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <cpr:PersonCivilRegistrationIdentifier>1111111118</cpr:PersonCivilRegistrationIdentifier>
        <mc2008:DrugMedicationIdentifier>109413</mc2008:DrugMedicationIdentifier>
</mc2009:DrugMedicationRequestStructure>

Der vælges "GetDrugMedication", og der klikkes på "Send XML". Herefter vil FMKs svar vises i nederste felt.