Voorbeeld applicatie

Er is een voorbeeld applicatie ontwikkeld waarmee het berichtenverkeer getest kan worden tussen schuldhulpverleners en schuldeisers. De voorbeeld applicatie heeft de volgende onderdelen:

• Opvragen organisaties

• Versturen van schuldhulpverlening berichten

• Versturen van schuldeiser berichten

• Opvragen messagebox

• Opvragen logbook

• Opvragen van conversaties

• Testen van scenario’s (alleen versie flow)

• Inzien XML-berichten

Minimale eisen om de applicatie te gebruiken

• Windows omgeving (getest op Windows 10/11)

• Rechten om gebruikerscertificaten te installeren

Volg de onderstaande stappen om aan de slag te kunnen met de testtool.

Stap 1: Aanvragen van test certificaten 

Testcertificaten voor zowel de pre-productie als acceptatie omgevingen zijn bij ons aan te vragen.
Meld je hiervoor aan als software ontwikkelaar.

Stap 2: Downloaden van certificaten

De certificaten kunnen gedownload worden op een afgeschermde omgeving.

Omdat de voorbeeld applicatie zowel een SHV als SE berichten kan versturen krijgt elke partner een private certificaat voor SE en SHV. Tevens is er een public root certificaat van Innovadis benodigd.

Stap 3: Installatie van Innovadis root certificaat

Indien de infrastructuur deze vereist moet het Public Root certificaat worden geïnstalleerd in de certificate store op de "Local Computer" folder "Trusted Root Certification Authorities\Certificates", zie onderstaande afbeelding:

Open

Vraag het root certificaat aan via onze helpdesk-omgeving.

Stap 4: Installatie van SE en SHV certificaat

De twee pfx bestanden moeten geïnstalleerd worden in de certificate store op de "Current User" folder "Personal/Certificates", zie onderstaande afbeelding:

Open

Stap 5: Downloaden van voorbeeld applicatie

De voorbeeld applicatie kan hier gedownload worden:

De zip bevat een folder SoapEndpoint.Tester en Executable. In de folder SoapEndpoint.Tester staan de  sources van de voorbeeld applicatie, let op het is een voorbeeld applicatie de code is bedoeld ter illustratie. De voorbeeld Executable bevat de voorbeeld applicatie excecutable.

Stap 6: Starten voorbeeld applicatie

Om de voorbeeld applicatie uit te voeren klik op SoapEndpoint.Tester.exe. Het kan zijn dat Windows een melding geeft dat het een unrecognized app betreft. Klik dan op de link  more info en kies dan voor Run anyway.

Dit zijn de tabbladen van de applicatie bestaat uit de volgende onderdelen:

1. Tabbladenoverzicht

   1. SHV
      Versturen van SHV berichten.

   2. SE
      Versturen van SE berichten.

   3. Messagebox
      Voor het ophalen en bevestigen van messagebox berichten voor zowel SE als SHV.

   4. Addressbook
      Voor het ophalen van organisaties.

   5. Organization
      Laden en bewerken gegevens eigen organisatie.

   6. Logbook:
      Voor het opvragen van berichten

   7. Scenarios:
      Doorlopen van afgekaderde testscenario’s

   8. Conversation:
      Controleren staat van conversaties.

   9. Settings:

      1. Environment
         dit is de locatie waar de berichten naar toe worden gestuurd, acceptatie of logging service.

      2. Version
         geeft aan welke versie van een service aangeroepen wordt

      3. Client side XML validation
         als dit aan wordt gezet wordt er gedetailleerde informatie teruggegeven

      4. Log Key
         deze dient ingevuld te worden als berichten verstuurd worden naar de logging service, de key is op te vragen in de logging service.
         
         

   10. Conversation: weergave van de de berichtenflow op basis van het conversatie id.

   11. Auto Reply: dit is een test functie die controleert of er berichten zijn. Indien er een bericht verstuurd wordt naar het geselecteerde certificaat/organisatie wordt de berichtenflow automatisch uitgevoerd.
       
       

2. Deze velden zijn voor het vullen van header informatie en het selecteren van de juiste certificaten en adres:

   1. Base address: naar welk adres het bericht verstuurd moet worden, dit adres is voor ingevuld naar de correcte testomgeving.

   2. From Certificate: SHV certificaat, dit certificaat wordt uit de certificate store gelezen.

   3. Receiver Reference: referentie van de ontvanger, deze is op te vragen in het Addressbook (dit veld is altijd verplicht).

   4. Conversatie Reference: hierin de conversatie reverentie worden opgegeven voor het het versturen van een bericht. Door te klikken op de knop New wordt er een nieuwe referentie gegenereerd.

   5. Cross Reference: hierin kan de cross referentie worden opgegeven voor het het versturen van een bericht. Door te klikken op de knop New wordt er een nieuwe referentie gegenereerd.

   6. Reference: hierin kan de referentie worden opgegeven voor het het versturen van een bericht. Door te klikken op de knop New wordt er een nieuwe referentie gegenereerd.

   7. Upload file: Hier kan een bijlage worden geselecteerd indien deze verplicht is voor afzender.
      
      

3. Dit blok kan worden gebruikt om berichten te versturen:

   1. Combobox (saldoverzoek): dit is een dropdown van alle SHV berichten, voorbeeld bestand wordt weergegeven in 4.

   2. Send: dit voert een enkel verzoek uit wat geselecteerd is in de combobox, resultaat wordt weergegeven in 5.
      
      

4. Dit is het content onderdeel waarin het XML bericht wordt weergegeven, hier kan ook het bericht aangepast worden.
   
   

5. Hierin worden de resultaten weergegeven van het versturen van een bericht, bevestigingen van berichten etc.

Vragen? Neem dan contact op met onze supportdesk.