Webservicebesked (WSB) administration i LSS for eksterne

Denne side henvender sig til eksterne som ønsker at kunne bruge Webservicebeskeder.
Siden gennemgår de fundamentelle ting i forhold til tilmelding, således at man selv kan oprette og administrere sine WSB abonnementer via LSS.

Adgang til WSB via LSS

• For at få adgang skal du oprette en sag til Systemforvaltningen - se https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4019389176/Tjekliste+for+eksterne+ifht.+webservicebeskeder+WSB#LSS-brugergr%C3%A6nseflade .

• Du tilgår LSS via https://landssupporttx.startest.dk/, hvor du erstatter x’et med det relevante testmiljø, fx https://landssupportt3.startest.dk/ for at nå T3.

• Når du har fået adgang og logger på LSS for at administrere WSB skal du være logget på som organsation: Klientsystem xxx, og du vil blive ledt direkte til WSB siden. Dette gøres øverst til højre på LSS:
  
  

  Open

  

  Først logger man ud, ved at klikke på “Log ud“

  
  
  

  Open

  

  Klik “Skift organisation“ og vælg dit KlientSystem.

Abonnementer

WSB siden ser således ud:

Siden indeholder tre moduler:

Webservice messages

Det første modul giver et overblik over, hvilke WSB’er der er blevet afsendt til et AbonnementSystem.

Her kan man filtrere på parametre som myndighed, dato og undersøge sine beskeder mere nøje - f.eks. responsekoder og deres metadata.

Oprettelse af Abonnementer

Denne viser jeres systemer og de abonnementer der er oprettet på det pågældende system.
Her kan man også se hvilke beskedtyper der er tilladt for det pågældende system.
Siden gør det også muligt at importere sine abonnementer, og vise sine abonnementer i det korrekte JSON format, så det nemt kan overføres til andre T-miljøer eller Produktion.

For at oprette et abonnement, vælger man det korrekte system (hvis man har flere).

Følgende felter skal være udfyldt for at oprette en abonnement (“Tilføj” kan vælges, når de påkrævede felter er udfyldt).

• Beskedtype
  Hvilke beskedtyper man ønsker at abonnere på.

• StartDato
  Hvornår man ønsker at modtage WSB’er fra.

• SlutDato (Ikke påkrævet)
  Hvornår man IKKE længere ønsker at modtage WSB’er fra abonnementet.

• Webhook
  Hvilket endpoint WSB’en skal sendes til. Webhook sættes bagerst på Base-urlen.
  Hvis man ikke ønsker at tilføje noget til base-urlen kan man blot skrive / i webhook feltet.

• Organisationstype
  Den organisationstype man modtager beskeden på vegne af.

• Organisationkode
  Den organisationskode man modtager beskeden på vegne af.
  
  

Når man har tilføjet sine ønskede abonnementer skal man huske at trykke på “Opdater opsætning”

Opsætning af abonnementer via JSON

“Vis opsætning som JSON” viser dine abonnementer i et JSON format som man kan bruge hvis man ønsker en lignende opsætning på et andet T-miljø.

Importér opsætning med JSON

“Importér opsætning med JSON” kan anvendes til at importere abonnementer mellem miljøer.
Man skal huske at ændre Subscribersystem Identifier, så den passer til subscribersystem identifieren på det pågældende miljø.

https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4247355570

Blokerede Webservicebeskeder

Her kan man se, om der er beskeder, som ikke kan afsendes til jeres endpoints.
Hvis en besked er blokeret, betyder det, at WSB som omhandler samme Identifikation (fx Cpr) ikke kan afsendes, da rækkefølgen af beskedafsendelser skal opretholdes.

På billedet nederst kan man se to blokerende beskeder.
Den første viser 2 beskeder som er blokerede på det pågældende identifikation.
Den første besked i rækkefølgen(den med status 404) skal håndteres inden besked nr 2 kan afsendes.
Her kan man se at det er beskedtypen CV, seneste afsendelsestidspunkt, eventuelt statuskode og information omkring modtageren.

For håndtering af blokerede beskeder, refereres til følgende dokumentation i forhold til returkoder og genafsendelse af fejlende beskeder.
https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3950510658/Den+gode+WSB+webservicebesked#Returkoder-og-fejlh%C3%A5ndtering-(link-til-permanent-forretningsside)