Mocktjänst för CreateDraftCertificate 3.1
Om mocktjänsten
Detta dokument beskriver mocktjänsten för CreateDraftCertificate 3.1. Mock-tjänsten ger stöd i form av automatiska och manuella kontroller för att verifiera implementationen innan integrationen med den nationella tjänsteplattformen.
Mocktjänsten använder SoapUI för att verifiera implementationen. Dokumentation om SoapUI hittas här: www.soapui.org.
Klicka på den här länken för att ladda hem en gratisversion av SoapUI. Installera enligt anvisning.
Förberedelser
- Gå till mappen test-suite i release-paketet
- Kopiera filen ‘soapui-support-N.N.NN.jar’ ('N.N.NN' är versionsnummer) till mappen /bin/ext där Soap-UI är installerat (leta efter mappen /Program Files/Smartbear på PC eller /contents/java/app på MAC OS)
- Öppna SoapUI och importera SoapUI-projektet (test-suite/CreateDraftCertificateMock/CreateDraftCertificateMock-soapui-project.xml) (välj ‘Import Project’ från menyn 'File')
- Mock-tjänsten kommer som standard att kopplas till URL http://localhost:8088/mockCreateDraftCertificateResponderBinding. Detta kan ändras i SoapUI-projektet vid behov.
- Gör eventuella förändringar av inställningar i data.xml (se nedan)
- Starta mocktjänsten i SoapUI.
- Konfigurera det testade systemet så att anrop skickas till mocktjänsten.
- Du bör nu kunna börja använda mocktjänsten.
Inställningar i data.xml
Vissa inställningar för mocktjänsten görs i filen data.xml.
Filen är i XML-format och i början finns en sektion som heter "globaldata" där generella inställningar kan göras.
Följande parametrar finns:
-
mockLogFile - Loggfil där anrop och valideringar loggas. En gemensam loggfil, sökväg relativt mock-projektet.
-
logTestData - Utökad loggning av request/response-meddelanden. Sätts till true för att aktivera. Observera att patientdata kan lagras vid påslagen loggning.
-
logTestDataPath - Sökvägen till den katalog där loggfilerna för request/response sparas.
-
logTestDataFilesAllowed - Max antal request/response som sparas. Det blir en fil för varje anrop (äldst fil tas bort automatiskt).
Glöm inte att spara data.xml efter att du har ändrat i den!
Mock-funktionalitet
När ett anrop når mocktjänsten sker följande:
- Schema-validering. Anropet kontrolleras mot tjänstekontraktets schema.
- Schematron-validering. Anropet kontrolleras mot Schematron-krav (i filen constraints.xml)
- Loggning till fil. Anrop med tidpunkt och valideringsresult loggas. Det går även att aktivera utökad loggning av meddelande-innehåll.
- Svar. Vid valideringsfel returneras felmeddelande enligt tjänstekontraktets regler. Vid korrekt anrop returneras svar enligt nedan.
Vid korrekt anrop returneras svar enligt tjänstekontraktets regler, med ett slumpat intygs-id.