Bilagor vid extern integration med Synpunkter & Klagomål

Owned by Per Carlén
feb. 21, 2024
3 min read

Allmänt kring 1177/Fileservice

Applikationen Fileservice är en applikation framtagen för att förse invånare och personal som använder 1177s invånarsidor och personalverktyg med möjligheten att bifoga filer i ärenden. I och med applikationen Synpunkter & klagomål har vi även öppnat upp applikationen för att det ska bli möjligt för externa handläggningssystem att hämta filer uppladdade av invånare samt även bifoga filer till invånarens inkorg från det externa handläggningssystemet. Fileservice är inte en filyta som externa handläggningssystem kan spara och använda filer från utan ska ses som en temporär lagringsyta i överförandet av meddelanden från/till 1177 och de integrerande handläggningssystemen.

Följande specifikationer gäller för filuppladdning till Fileservice:

Filformat som stöds:

  • application/pdf

  • image/gif

  • image/jpeg

  • image/png

Max filstorlek: 20MB

Max antal filer: 10

Skicka in ett klagomål med bifogad fil

Use case-beskrivning

  1. En användare loggar in på 1177.se och fyller i formuläret för Synpunkter och Klagomål samt bifogar en fil, "Kvitto.jpg" och klickar på 'Skicka'.

  2. Formuläret skickas till Synpunkter&Klagomål-applikationen (SoK-app) och bilagan skickas till Fileservice. I SoK-app skapas och sparas id för klagomålet samt kommunikation med Fileservice ser till att filen sparas och knyts till klagomålet så invånaren ska kunna se bilagan i sin inkorg.

  3. Ett SOAP-meddelande skickas från SoK-app via NTjP till det mottagande externa handläggningssystemet. I meddelandet finns information om bilagan så att det externa handläggningssystemet ska kunna hämta hem bilagan från Fileservice.

  4. När klagomålet når det externa handläggningssystemet och sparas där måste även ett separat request mot Fileservice ske så att det externa handläggningssystemet laddar hem bilagan till egen filyta/disk så bilagan blir tillgängligt för handläggare/system. Det externa systemet har 24 timmar på sig att hämta hem bilagan från det att klagomålet når systemet. Detta begränsade fönster för hämtning gäller endast för externa systemintegrationer, invånaren har obegränad tillgång till bilagan via sin inkorg. För att systemet ska kunna autentisera sig krävs att giltigt funktionscertifikat används vid hämning av fil.

Teknisk beskrivning

För att som externt handläggarsystem hämta en fil från 1177/Fileservice använd följande REST-tjänst:

ACCEPTANSTEST/STAGE:

HTTP/GET - https://fileservice-arende.at.1177.se//api/1.0/fileservice/external/complaint/{complaintId}/files/{fileId}

PROD:

HTTP/GET - https://fileservice.arende.1177.se/api/1.0/fileservice/external/complaint/{complaintId}/files/{fileId}

URL-parametrar:

{complaintId} = ID på klagomålet, UID (36 tecken)

{fileId} = ID på filen som ska hämtas, UID (36 tecken)

  • Tjänsten måste anropas med ett giltigt funktionscertifikat

  • Observera att det integrerade systemet har 24 timmar på sig att hämta hem bifogade filer innan access till filen är låst.

Headers-exempel för att spara fil:

  • "content-disposition": "attachment;filename=\"kvitto.png\"",

  • "content-type": "image/png",

Under 2024 kommer content-disposition headern percent-encodas för att öka kompatibiliteten med rådande infrastruktur hos regionerna samt för att följa standard. Här är ett exempel på hur headers vid överföringen av filen “påskägg.jpg” kommer se ut fr.o.m Februari-releasen 2024:

  • "content-disposition": attachment;filename="p%C3%A5sk%C3%A4gg.jpg";filename*=utf-8''p%C3%A5sk%C3%A4gg.jpg

Skicka delsvar/motfråga/svar från externt handläggningssystem till invånarens inkorg på 1177.se alt. registrera klagomål i extern handläggningssystem

Use case-beskrivning

  1. En handläggare skickar en motfråga/delsvar/svar från det externa handläggningssystemet. I samband med meddelandet bifogas även en fil, blankett.pdf.

  2. Bilagan laddas upp till fileservice för att göra den tillgänglig för invånaren via inkorgen i 1177.se. Fileservice returnerar ett ID som efterföljande SOAP-meddelande behöver bifoga för att knyta delsvaret/motfrågan/svaret till bilagan. Observera att filen som laddats upp på Fileservice hos 1177 endast är tillgänglig för invånaren och inte ska användas som källa till filen för det externa handläggningssystemet. Det externa handläggningssystemet måste tillhandahålla sin egen kopia av filen. 

  3. Ett SOAP-meddelande skickas från det externa handläggningssystemet via NTjP till Synpunkter & Klagomål-applikationen där det sparas och bilagan knyts till meddelandet samt görs tillgängligt för invånaren via inkorgen på 1177.se

Teknisk beskrivning

För att som externt handläggarsystem ladda upp en fil till 1177/Fileservice använd följande REST-tjänst:

ACCEPTANSTEST/STAGE:

HTTP/POST - https://fileservice-arende.at.1177.se//api/1.0/fileservice/external/files

PROD:

HTTP/POST - https://fileservice.arende.1177.se/api/1.0/fileservice/external/files

Tjänsten returnerar ett UID (36 tecken) som ska bifogas i efterföljande meddelande mot 1177/Synpunkter & Klagomålsapplikationen. Genom att först ladda upp filen och sedan skicka ett meddelande med referens knyter vi filen till meddelandet och meddelandet till invånaren/klagomålet. Filen kommer då att göras permanent på filytan så invånaren har tillgång till den via sina inkorgsmeddelanden på 1177. Om en filuppladdning sker och inget efterföljande meddelande skickas kommer filen raderas av en batch i Fileservice som går varje timme.

Bilagor ska laddas up med header Content-Type: multipart/form-data;