Beskrivning

Lagrar och hanterar livscykeln för ärenden. Möjlighet för klienter att skapa, ändra, ersätta och ta bort ärenden och tillhörande relationer till intressenter, bilagor m.m.

Håller även koll på ärendehistoriken, hur ett ärende har förändrats genom tiden.

Integrationer

EmailReader

CaseData har ett schemalagt jobb som körs var 10:e minut. Det görs ett anrop till EmailReader som hämtar nya epost-meddelanden.

Varje epost-meddelande mappas/omvandlas till en "MessageEntity", det är följande parametrar som sparas/skapas:
MessageID - Ett UUID som genereras.
Direction - Sätts till INBOUND. (Motsvarar om det är ett inkommande eller utgående meddelande)
Subject - Lagrar mejlets rubrik.
TextMessage - Lagrar mejlets brödtext.
Sent - Formatterar om mejlets "RecievedAt" till 'yyyy-MM-dd HH:mm;ss' format.
MessageType - Sätts till EMAIL. (Indikerar vad det är för typ av meddelande)
Email - Lagrar sändarens epost-address.
List<Attachment>- Mappar/omvandlar eventuella bifogade dokument till "AttachmentEntity".
List<EmailHeader> - Mappar/omvandlar mejlets headers till "EmailHeaderEntity".

Attachment - Håller metadata och innehållet för ett bifogat dokument. Behövs för att kunna läsas när ett meddelande hämtas.
EmailHeader - Ett EmailHeader objekt håller en Header(IN_REPLY_TO, REFERENCES. MESSAGE_ID) och håller en lista med strängar som representerar headerns värde. Syftet är att kunna hålla ihop mejltrådar på både vår sida, men även när det svaras på en medborgares mejl så kan deras mejlklient läsa in det som en mejltråd.

Livscykelstatus

Produktion

Lösningsbeskrivning

Hantering av personuppgifter

Personuppgifter till ärendeintressenter hanteras. Såsom namn, kontaktuppgifter och adress. PersonId används istället för personnummer.

API-specifikation

Extraparametrar

Vi använder objektet “extraParameters” för att hantera fält som inte är generiska för alla typer av ärende. Ett exempel på detta är “artefact.permit.number” vilket är ett parkeringstillstånds-ID. Parameternamnet byggs upp av olika delar åtskilda av punkt (punktnotation helt enkelt), så att det går att gruppera parametrarna på ett logiskt sätt.

Formatet på “extraParameters” är enligt följande exempel:

Errand

Parkeringstillstånd

Key	Value	Beskrivning

Key	Value	Beskrivning
application.priority	LOW\|MEDIUM\|HIGH	Standardvärde är MEDIUM.
application.reason	Lorem ipsum dolor sit amet.	Fritextfält, beskrivning av skäl för ansökan.
application.role	SELF\|GUARDIAN\|CUSTODIAN	Indikerar om ansökan skickats in för egen räkning, av vårdnadshavare eller av god man/förvaltare
application.applicant.capacity	DRIVER\|PASSENGER	Anger i för vilket ändamål den sökande söker p-tillstånd, som förare eller passagerare.
application.applicant.testimonial	true\|false	Anger om checkbox för intyga på heder och samvete är ikryssad.
application.applicant.signingAbility	true\|false	Anger om den sökande kan signera med sin namnteckning
disability.aid	Rullator,Elrullstol,Krycka/kryckor/käpp,Rullstol (manuell),Inget	Kan innehålla ett eller flera värden av dessa värden (kommaseparerade).
disability.walkingAbility	true\|false	Anger om sökande alls kan gå.
disability.walkingDistance.beforeRest	50	Maximalt gångavstånd utan vila.
disability.walkingDistance.max	100	Maximalt gångavstånd.
disability.duration	P1Y, P6M etc	Funktionsnedsättningens varaktighet. Se mappningstabell nedan. Format: ISO 8601 (P1Y1M1W1DT1H1M1S)
disability.canBeAloneWhileParking	true\|false	Anger om sökanden kan lämnas ensam under tiden bilen parkeras.
disability.canBeAloneWhileParking.note	Lorem ipsum dolor sit amet.	Om ovanstående har värdet false, kan en beskrivning/förklaring läggas till i det här fältet.
consent.contact.doctor	true\|false	Anger medgivande för handläggare att kontakta läkaren som utfärdat läkarintyget.
consent.view.transportationServiceDetails	true\|false	Anger medgivande för handläggaren att ta del av information om färdtjänst.
application.renewal.changedCircumstances	true\|false	Anger om förutsättningarna ändrats sedan föregående p-tillstånd. Används endast vid förnyelse.
application.renewal.expirationDate	2022-01-01	Anger sista giltighetsdatum för nuvarande p-tillstånd. Används endast vid förnyelse. Datumformat: yyyy-MM-dd
application.renewal.medicalConfirmationRequired	yes\|no\|unknown	Anger om läkarintyg krävs för förnyelsen. Används endast vid förnyelse.
application.lostPermit.policeReportNumber	I-10-1234567-12	Diarienummer från polisanmälan. Används endast vid borttappat p-tillstånd.
artefact.permit.status	Aktivt\|Spärrat\|Utgånget	Status på p-tillstånd.
artefact.permit.number	1234567	Kortnummer för utfärdat p-tillstånd.
application.supplement.dueDate	2022-01-01	Anger datum för när ansökan senast ska kompletteras. Används endast då handläggare markerat ärendet för komplettering.. Datumformat: yyyy-MM-dd
process.phaseStatus	ONGOING	Visar vilken status en fas befinner sig i processen för ParkingPermit.
process.phaseAction	COMPLETE \| CANCEL	Parameter som styr händelser i processen för ParkingPermit.

Mappningstabeller

För vissa av parametrarna krävs mappning för att få in rätt värden i CaseData-DB.

disability.duration

Mappning till värden enligt ISO 8601, innebörden är “upp till” angiven varaktighet. Undantaget är P5Y som anger “mer än” fyra år och P0Y som anger “alltid”, dvs bestående.

Display Value (Frontend)	Field value
Mindre än 6 månader	P6M
6 månader till 1 år	P1Y
1-2 år	P2Y
2-3 år	P3Y
3-4 år	P4Y
Mer än 4 år	P5Y
Bestående	P0Y

Stakeholders

Key	Value	Beskrivning

Key

Value

Beskrivning

primaryContact

true|false

Anger och som ska vara primär kontakt för information i ärendet.

Används endast för stakeholder med roles = CONTACT_PERSON alt FELLOW_APPLICANT.

messageAllowed

true|false

Anger om kommunikation via mail/sms är tillåten.

Används endast för stakeholder med roles = CONTACT_PERSON alt FELLOW_APPLICANT.

Attachments

Key	Value	Beskrivning

Key	Value	Beskrivning

Facilities

Key	Value	Beskrivning

Key	Value	Beskrivning

Decisions

Key	Value	Beskrivning

Key	Value	Beskrivning

Notes

Key	Value	Beskrivning

Key	Value	Beskrivning
signed	true \| false	Anger om anteckningen är signerad eller inte.

Säkerhetsklassning

Säkerhetsklass 1

Autentiseringsmetod: Oauth2

(Ref: Säkerhetsklassning av APIer)

Teknisk ägare

https://sundsvall.atlassian.net/wiki/spaces/API

Ansvarigt team: Team Unmasked

För tekniska frågor: teamunmasked@sundsvall.se

Källkod

Github

FAQ

<FAQ>