Denna källkod är en referensimplementation av SPAR Personsök program-program version 2019.1.
Referensimplementationen är skriven för .NET Core 3.0 och använder nuget för pakethantering.
Med hjälp av verktyget svcutil har det skapats en tjänst från wsdl-filen som används för att anropa personsöktjänsten. Det går också bra att skapa upp tjänsten via Visual Studio och menyalternativet 'Add Service Reference...'. Utöver det används NLog för att hantera loggningen och NUnit för att hantera enhetstestningen av koden.
För mer detaljer om verksamhetsbegrepp inom SPAR, och även andra tjänster inom SPAR se gränssnittsmanualen som är tillgänglig på SPARs hemsida.
När projektet byggs hämtar nuget externa beroenden så att koden kan kompilera.
Personsok innehåller en demonstration som gör fem olika sökningar mot kundtestmiljön och loggar utförligt ut resultatet. PersonsokTest har sex tester som kör mot kundtestmiljön. Dessa verifierar att inget går fel.
För att köra projektet i Visual Studio, högerklicka på projektet PersonsokImplementation och kör, alternativt debug. Om du alternativt använder Visual Studio Code så exekverar du följande kommando för att köra projektet:
dotnet run -p PersonsokImplementationeller följande kommando för att specifikt köra testerna
dotnet testVi rekommenderar att det klientcertifikat som är tänkt att användas i produktion även används vid tester mot kundtestmiljön, detta för att i ett tidigt skede verifiera att certifikatet är korrekt.
För att använda eget klientcertifikat, byt ut sökväg och lösenord till certifikat i anropet 'client.ClientCredentials.ClientCertificate.Certificate = ...' i funktionen CreatePersonsokServiceClient.
För att verifiera att det är rätt utställare av certifikat hos SPAR så används X509Certificate2 signerandeCertifikat i funktionen CreatePersonsokServiceClient. Den använder även en CustomCertificateValidator, SPARCertificateValidator som gör extra verifiering av SPARs certifikat.
Vi rekommenderar att verifiering av rootcertifikatet görs även om en annan lösning används.
Om koden används för att integrera mot produktionsmiljön krävs ett giltigt klientcertifikat, det inkluderade testcertifikatet fungerar endast i kundtestmiljön. Även indentifieringsinformation behöver vara giltig, se KundNrLeveransMottagare, KundNrSlutkund och UppdragsId. För mer information kontakta SPAR:s kundtjänst.