Sokigo Nova Kungörelser

Soleil har tillsammans med Sokigo tagit fram en applikation som automatiskt publicerar kungörelser, prövningar och grannhöranden direkt i Sitevision. Sokigo Nova kommer kunna ansluta till Soleils applikation och skicka data för sina kunder i ett strukturerat format för automatisk publicering.

Kommuner hanterar sina ärenden via ett separat bygglovshanteringssystem. Leverantörerna av dessa system strävar efter att skapa möjligheter för att exportera nödvändig data för vidare hantering mot sina kunders digitala anslagstavlor. Modulen är en REST-app som tar emot kungörelser från Sokigo Nova och skapar upp dessa som artiklar med metadata i ett arkiv som ni väljer ut i Sitevision.

Tillsammans med REST-appen får ni kostnadsfritt tillgång till en modul i Sitevision som listar kungörelserna från Sokigo Nova.

Exempel på hur listning av bygglovansökningar ser ut från Sokigo Nova

Installation och konfiguration

Genomför installation och konfiguration enligt denna guide för att få en fungerande uppsättning. Detta är en grunduppsättning med den vanligaste uppsättningen. Längre ned förklaras alla möjliga inställningar.

Installera REST-appen från Sitevision Marketplace under Marketplace genom att söka fram appen Bygglov Sokigo Nova och klicka på Installera.
Skapa en ny lokal användare i Sitevision som kommer delges/konfigureras till/i bygglovsystemet (eller Soleil för den temporära lösningen).
1. Gå till Webbplatsinställningar → Användare
2. Klicka på plusikonen (+)
3. Ange ett passande användarnamn samt förnamn/efternamn. Förslag är användarnamn "bygglov", med namnet "Bygglov Access".
4. Kryssa i Tillåt användaren att logga in med lösenord och ange ett genererat starkt lösenord.
5. Om önskat ange en beskrivande text under Beskrivning för att ge information varför användaren finns och dess syfte.
6. Klicka på OK för att skapa användaren.
Ge användaren access till att anropa REST-appen genom att gå till Tillägg och hitta build-permit-sokigo-nova.
1. Under kugghjulsikonen välj Egenskaper → Restriktioner
2. Under Behörighet klicka på + Lägg till ... och lägg till den nyss tillagda användaren "Bygglov Access" eller vad ni valde namnge den.
3. Kryssa i HTTP-metoderna GET och POST för den användaren
4. Samt under Cross-Origin välj Tillåt för alla domäner
Skapa den sidmall som ska användas för skapade objekt, se här för beskrivning om hur sidmallen sätts upp
Ge användaren läsrättighet till mallen (för att kunna skapa sidor baserad på mallen).
1. Högerklicka på mallen och gå till Egenskaper → Behörigheter
2. Under Behörighet klicka på + Lägg till ... och lägg till den nyss tillagda användaren "Bygglov Access" eller vad ni valde namnge den.
3. Kryssa i att användaren får en roll som har läsrättighet
Skapa upp det arkiv som objekten ska läggas i på valfri plats i ert sidträd i Sitevision, namngivning är valfri.
Ge användaren skrivrättighet till/i arkivet
1. Högerklicka på arkivet och gå till Egenskaper → Behörigheter
2. Under Behörighet klicka på + Lägg till ... och lägg till den nyss tillagda användaren "Bygglov Access" eller vad ni valde namnge den.
3. Kryssa i att användaren får en roll som har skrivrättighet
Konfigurera REST-appen
1. Gå till Tillägg och hitta build-permit-sokigo-nova och den aktiva versionen. Klicka på knappen Inställningar.
2. Under Lagringsplats → Plats att lagra informationsobjekt peka ut det skapade arkivet.
3. Under Sid-/artikelmall → Sid-/artikelmall peka ut den skapade sidmallen.
4. Under Metadatamappning standardfält peka ut alla de metadata som finns skapade för sidmallen.

Konfiguration Rest-app

Konfiguration

REST-appen konfigureras under inställningar för tillägg.

Lagringsplats

Använd avancerad plats. Om ni vill publicera olika typer av kungörelser i olika arkiv/lagringsplatser använd denna inställning.

Plats att lagra informationsobjekt. Välj det arkiv/lagringsplats där kungörelserna skall lagras.

Sid-/artikelmall

Använd avancerad inställning för sid-/artikelmall. Om ni vill använda olika sidmallar för olika typer av kungörelser använd denna inställning.

Sid-/artikelmall. Välj den mall som skall användas för att skapa sidor alternativt artiklar i utvalt arkiv eller lagringsplats.

Publicering

Automatisk publicering. Om markerad kommer uppskapade kungörelser/artiklar automatiskt publiceras när de skapas eller uppdateras.

Metadatamappning standardfält

Dessa fält är de som levereras som standard från Sokigo Nova till Sitevision. Via denna inställning mappar ni fälten mot uppskapade metadatafält i Sitevision för mallen som skall användas.

Avancerat - anpassade fält

Om ytterligare fält finns tillgängliga från Sokigo Nova kan dessa läggas in under avancerat.

Klicka på "Lägg till.." och fyll i fält-id samt vilken fälttyp det är.

Anslutningsdata

När ni sedan ska ansluta lösningen mot er Sokigo Nova så behöver de följande uppgifter från er.

Användarnamn och lösenord för användaren Bygglov Access
Adressen till Rest-API:et. Den adressen kommer att vara "https://<domän>/rest-api/build-permit-nova/v1/publish" (där domän ersätts av er webbplats domänadress).
Det går även att hitta adressen under Tillägg -> build-permit-nova -> <aktiv version> och under Routes hitta routen för publish.

Det är samma information som behövs om temporärlösning ska användas.

OBS! Temporär lösning för att hämta data

De flesta leverantörer har inte hunnit ta fram en lösning för att automatiskt exportera data och publicera till Soleils applikation innan lagändringen trädde i kraft den 1/12 2025.

Soleil erbjuder en temporär hantering av detta genom en funktionsbrevlåda som tar emot en excel-export från ert bygglovshanteringssystem. Genom funktionsbrevlådan skickas data till applikationen i Sitevision för automatisk publicering.

Så fort den permanenta hanteringen är löst avslutas driften av funktionsbrevlådan och appen tar emot data från ert bygglovssystem.

Kontakta Soleil för uppsättning av den temporära lösningen.

Sidmall för kungörelser bygglov

Den sidmall som skall användas för att skapa artiklar för kungörelser från Sokiga Nova behöver ha en uppsättning metadata. Om ni behöver hjälp att sätta upp sidmallen i er miljö kontakta oss gärna.

Här nedan följer en lista på alla metadata som krävs med förslag på passande namn och identifierare. Namn och identifierare är dock möjligt att välja egna. Se till att metadata är inställt med "Indexera fältet i sökmotorn" under Avancerat och rekommenderat är även att sätta "Arv ej möjligt".

Nova typ - nova-type - Metadatatyp: Text
Nova objekt-ID - nova-id - Metadatatyp: Text
Nova rubrik - nova-title - Metadatatyp: Text
Nova innehåll - nova-content - Metadatatyp: Text
Nova fastighet - nova-estate - Metadatatyp: Text
Nova beslut - nova-decision - Metadatatyp: Text
Nova beslutsnummer - nova-decisionNumber - Metadatatyp: Text
Nova beslutsdatum - nova-decisionDate - Metadatatyp: Datum
Nova svarsdatum - nova-responseDate - Metadatatyp: Datum
Nova publiceringsdatum - nova-publishDate - Metadatatyp: Datum
Nova avpubliceringsdatum - nova-publishEndDate - Metadatatyp: Datum
Nova Extern URL - nova-externalUrl - Metadatatyp: Länk

Not! För metadata som är av typ Text är det möjligt att också koppla dessa mot metadatan av typen Enval eller Flerval. Viktigt är då att dessa är satta att "Tillåta egna val" alternativt att man vet exakt vilka värden som kan komma för fältet då man kan ange de alternativ som kan förekomma.
Att göra dem som Text-metadata är ändå rekommenderat.

Ändringshistorik

1.0.0
- Första versionen av modulen
1.1.0 - (EJ rekommenderad att använda - använd version 1.1.1)
- Lägger till 3 nya frivilliga fält; Beslutsnummer, Beslutsdatum och Extern URL.
- Stöd för tidsstyrd avpublicering baserat på avpubliceringsdatum.
- Stöd för att textfält även kan mappas mot metadatafält av typen Enval och Flerval
- Buggfix så att konfigurationen av extra-fält läses in.
1.1.1
- Buggfix för version 1.1.0 som introducerade kraschproblematik om inga extra-fält var tillagda.

Beskrivningar för tidigare versioner av modulen

Sokigo Nova Kungörelse (1.0.0)