Versioner sammenlignet

Nøgle

  • Linjen blev tilføjet.
  • Denne linje blev fjernet.
  • Formatering blev ændret.
Tip
Anvendelsen af klienteksemplet forudsætter, at kaldet kommer fra en IP-adresse som er godkendt hos STIL. Har I spørgsmål er der hjælp at finde på denne side.

Klienteksemplet er et Visual Studio projekt, der har til formål at vise, hvordan man integrerer til STILs integrationsplatform, IPL. Eksemplet inkluderer også konfiguration af IPL sikkerhedsmodel i Visual Studio.


UI Steps
UI Step

Download klienten

Du kan downloade klienteksemplet nedenfor.

View file
namehelloworldclient.zip
height250


UI Step

Importere Integrationsplatformens servercertifikat

Tip
Certifikatet kan hentes på denne side
  1. Flyt certifikatet ind i helloworldclient-mappen, så certifikat-filen ligger sammen med README.md-filen.
  2. Visual Studio åbnes HelloWorldClientTests.cs filen og på linje 26 ændres string value for variablen serviceCertificateFileName til det fulde filnavn for Integrationsplatformens certifikat inkl. filtype, så hvis certifikatet blev navngivet "Servercertifikat_03-02-2021.cer" skal serviceCertificateFileName have denne værdi.
UI Step

Import af WSDL i Visual Studio

  1. I Visual Studio højreklikkes på "Connected Services" og der vælges "Add Service Reference…".
  2. I vinduet, der åbner, indtastes i "Address" feltet url for WSDL og der klikkes herefter på "Go" knappen. Visual Studio søger på url'en og finder servicen, hvorefter den fremkommer i feltet "Services" og webservicens operationer kan ses i feltet "Operations", når man har klikket på servicen i feltet "Services".
  3. Klik herefter på "OK" knappen, hvorved Visual Studio importerer WSDL'en og genererer den nødvendige kode til at kunne kalde webservicen gennem en klient.


UI Expand
titleEksempel

image2021-3-4_16-52-39.png

UI Step

Afvikling af test i klienteksemplet

Klienteksemplet indeholder et testprojekt. Testprojektet benytter XUnit testframeworket. Projektets tests kan afvikles ved at bygge projektet, hvorefter projektets tests bliver synlige og kan afvikles. Skulle de ikke blive synlige, kan de findes ved at vælge vinduet Test Explorer.

Herfra kan testene afvikles ved at klikke på "Run All" eller ved at højreklikke på hver enkelt test, hvorefter der kan vælges "Run" eller "Debug".


UI Expand
titleEksempel
image2020-12-1_14-43-35.png
UI Step

Klar til at kalde HelloWorld på Integrationsplatformen.

Alle andre operationer end ping kræver signering af requestet. Dette er vist i KlientEksempel projektet med testmetoden GetAliveWithParameterHelloWorldReturnsData. Testmetoden PingHelloWorldReturnsUp benytter også IPLs sikkerhedsmodel og signerer requestet. Dette er for at vise, at det på ping-operationen ikke gør nogen forskel, om der benyttes signering af request eller ej.

Tip
titleProblemer med http statuskode 400?

Klienten kan ikke parse fejlmeddelelser med http statuskode 400. Det kan løses ved at implementere løsningen som er angivet her: 
https://rep.erst.dk/git/openebusiness/library/dotnet/blob/master/src/dk.gov.oiosi/communication/Request.cs (linje 476 - 517)