Mocktjänst för GetCertificate 2.0

Om mocktjänsten

Detta dokument beskriver mocktjänsten för GetCertificate 2.0. 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/GetCertificateMock/GetCertificateMock-soapui-project.xml) (välj ‘Import Project’ från menyn 'File')
• Mock-tjänsten kommer som standard att kopplas till URL http://localhost:8088/mockGetCertificateResponderBinding. 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:

1. Schema-validering. Anropet kontrolleras mot tjänstekontraktets schema.
2. Schematron-validering. Anropet kontrolleras mot Schematron-krav (i filen constraints.xml).
3. Loggning till fil. Anrop med tidpunkt och valideringsresult loggas. Det går även att aktivera utökad loggning av meddelande-innehåll.
4. Svar. Vid valideringsfel returneras felmeddelande enligt tjänstekontraktets regler. Vid korrekt anrop returneras svar med ett exempel-intyg.