JobnetCitizenMessageService (2016-4)

Metoder

CreateMessage

Metoden bruges til at oprette og sende en besked via en kommunikationskanal. For kommunikationskanaler som SMS, mail og notifikationer på Jobnet, vil dette være at betragte som envejskommunikation til borger, uden mulighed for at borger kan returnere med svar. 

Det er muligt at sende beskeden til et antal borgere. 

Beskedteksten har en max. længde som er afhængig af den valgte kanal. SMS 350 karakterer Mail 2000 karakterer Notifikation 500 karakterer Myndighed-til-myndighed 2000 karakterer

Hvis kanal (CitizenMessageChannelTypeIdentifier) er Myndighed til myndighed (ID 4) og modtager organisationstype (OrganisationTypeIdentifier) er enten Jobcenter (Id 8) eller a-kasse (Id 2) kan OrganisationCode være udfyldt med ’99999’ - og i sådanne tilfælde vil DFDG sende beskeden til borgerens jobcenter eller den a-kasse som borgeren aktuelt er medlem af. Hvis DFDG ikke kan finde en jobcentertilknytning eller en a-kasse borgeren er medlem af, så kastes fejlkode 8311.

CreateMessageReply

Metoden bruges som svar på en eksisterende meddelelse – dermed kan skabes beskedtråd. 

Denne servicemetode kan dog kun anvendes hvis CitizenMessageResponseType på den oprindelige besked er sat til værdien "Kan besvares af borger" eller "Kan besvares af borger og sagsbehandler".
Forretningsregler:

• Beskedtekst
  • Max 2000 karakter hvis direkte eller kontekst afhængig besked DFDG validere for dette
• Kontekst der kan svares i er :
  • Generel besked
  • Udkast til plan
• Et svar vil altid ske in den samme kontekst som tråden er blevet oprettet

GetMessage

Metoden bruges til at hente en specifik besked relateret til en borger. Svaret indeholder beskeden samt eventuelle svar. 

Forretningsregler:

• Alle dialoger og beskeder medtages uanset status for fejloprettet.

Adgang til beskedindhold
I forbindelse med at sagsbehandlers adgang til Jobnet, vil beskeder sendt fra virksomhed og anden myndighed direkte til borger indholdsmæssig få indholdet skjult og erstattet af en statisk tekst, eventuelle vedhæftede dokumenter vil blive fjernet. Dette sker for at sikre at sagsbehandler ikke utilsigtet kommer til at se en beskeder der er omfattet af brevhemmelighed.

• Borger (Jobnet) har adgang til alle beskeder og alt indhold (bemærk ShowInMessagebox er alene en boolean om beskeder også skal vises i beskedbakken)
• Jobcenter har adgang til alle beskeder, men for beskeder, hvor den specifikke jobcenter ikke er afsender eller modtager, dvs. beskeder fra andre organisationer (STAR, a-kasser og virksomheder) eller andet jobcenter må indholdet ikke vises. 
• A-kasser kan ikke kalde metoden 
• STAR har adgang til alle beskeder, men for beskeder, hvor STAR eller et jobcenter ikke er afsender eller modtager, dvs beskeder fra andre organisationer (a-kasser og virksomheder) må indholdet ikke vises. Alle jobcentre betragtes som en organisation
• Når en organisation ikke har adgang til en besked medtages beskeden ikke 
• Når en organisation ikke må se indhold erstattes
  • Titel (Title - Titlen på dialogen) med
    • "Besked fra virksomhed" når afsender er en virksomhed
    • "Besked fra jobcenter" når afsender er et jobcenter
    • "Besked fra a-kasse" når afsender er en a-kasse
    • "Besked fra Styrelsen for arbejdsmarked og rekrutteringSturesen"
  • Indhold  (Text - Tekst dialogen skal indeholde)erstattes med "Du må ikke få adgang til indholdet i denne besked. Det skyldes reglerne om brevhemmelig i Straffeloven."
  • Indhold i svar (MessageReplyCollection.Text - Tekst retursvar indeholder) med "Du må ikke få adgang til indholdet i denne besked. Det skyldes reglerne om brevhemmelig i Straffeloven."
  • Vedhæftninger (MessageDocumentCollection - dokumenter) medtages ikke 

SetMessageReplyStatus

Denne metode anvendes til at markere at et svar er blevet fejlagtigt oprettet.

Forretningsregler

• Status kan kun ændres til "Fejloprettet".
• Borger må kun sætte status for egen svar. (Valideres ikke af DFDG)
• Der skal i DFDG være historik for statusændringer, inklusiv hvornår den er skiftet til fejloprettet.

CreateHistoricMessage

Metode der bruges i forbindelse med at kunne lægge historiske beskeder ind. f.eks. ved konverteringer.

Forretningsregler

• Uanset hvilken kanal der vælges sker der ikke en afsendelse af WSRM, SMS eller mail.
• MessageVisibleFromDate skal ligge på eller før dagsdato
• Hvis beskeden er læst af borger, sættes MarkMessageIdentifier = Læst af borger (Id 1) og CitizenPresentedMarkDate til dato til læst CitizenPresentedMarkCollection.
• CitizenMessageStatusTypeIdentifierType kan kun sættes aktiv eller lukket.
  • DFDG validere ikke for dette

CreateHistoricMessageReply

Metode der bruges i forbindelse med at kunne lægge historiske svar ind. f.eks. ved konverteringer.

Forretningsregler

• Uanset hvilken kanal der vælges sker der ikke en afsendelse af WSRM, SMS eller mail.
• Eventdag skal ligge på eller før dags dato.