Systemdokumentation. Ikaros Daedalos. IT-stöd för räddningstjänst

Transkript

1 Ikaros Daedalos IT-stöd för räddningstjänst, Ideon Science Park, Lund

2 2 (18) Ikaros, Daedalos och Oculus avser beteckningar på IT-stödsystem för kommunal verksamhet, särskilt räddningstjänst, och är varumärken som tillhör Lunds ProgramArkitekter AB. Detta dokument får fritt kopieras av kunder som har giltigt nyttjanderättsavtal, men får inte spridas utanför den egna organisationen. Dokumentet, eller delar därav, får inte användas för att producera eget materiel utan leverantörens medgivande. IT-systemen som detta dokument refererar till är uppbyggda av en basmodul med flera tillvalsmoduler. Dokumentet kan beskriva funktionalitet som inte återfinnes i varje installation, eftersom den aktuella funktionaliteten ingår i en tillvalsmodul. Systemets dialogrutor kan variera i utseende (färg och form) beroende på vilken plattform som användes, och innehållet i desamma kan variera beroende på vilka tilläggsmoduler som är installerade. Vårt IT-stöd för räddningstjänst är känt under två separata produktnamn, Ikaros och Daedalos. Detta har orsakat viss förvirring bland kunderna. Orsakerna till de dubbla namnen är historiska. Produktnamnen användes nu på följande sätt: Ikaros version 4 och Daedalos är synonymer. Den nya versionen av Ikaros har under lång tid varit känd under arbetsnamnet Daedalos, så denna användning förefaller rimlig. Oculus är ett påbyggnadspaket till Ikaros version 4 (och därmed Daedalos), som innehåller funktioner för ledning och uppföljning av räddningsinsaster, med betoning på operativa stödfunktioner. I denna handledning användes genomgående beteckningen Daedalos.

3 3 (18) Innehållsförteckning Systemkrav Beståndsdelar Tjänster Aktivering Uppgradering av programvara Databas Exekveringsläge Katalogutnyttjande Applikationsloggning Interaktion med Microsoft Word Interaktion med Adobe Acrobat Single Sign-on Systemberoenden Fastighetsdata Kartdata Övriga kommunala data Konvertering av data från annat verksamhetsplaneringssystem Databasadministration Välj databas Uppdatera databas Särskild rutin Import av fastighetsdata i ÖFF-format... 17

4 4 (18) 1 Denna dokument innehåller Daedalos systemdokumentation. en innehåller upplysningar som behövs för att driftsätta och driva datorsystemet. Upplysningar som behövs för att använda systemet, inklusive det som brukar benämnas systeminställningar återfinnes i dokumentet Daedalos Handledning. 1.1 Systemkrav Daedalos kan är grundligt testat för användning på teknisk plattform enligt nedan. Detta betyder inte att användning på annan teknisk plattform är omöjlig, men prov kan behöva göras vid större installationer. Operativsystem Office (särskilt Word och Excel) TCP/IP Databashanterare Bildskärm Windows XP SP2. Om annat opperativsystem användes skall säkerställas att det är utrustat med Windows Internet Explorer 6 eller 7, samt modulen GDIPLUS. Vissa funktioner i Daedalos kan utnyttja Word och Excel. Installationen av dessa system skall vara av modernt slag. Det innebär att de flesta nya installationer fungerar. Daedalos nyttjar nätverksfunktioner. TCP/IP skall finnas installerat på datorn, och det skall vara möjligt att obegränsat nyttja portarna 80 och Särskilt skall det gå att starta sessions mot angiven SQL-server på port 1433, och det skall gå att starta så kallade soap-sessions över http på port 80. Daedalos fungerar tillsammans med Microsoft SQL Server 2000 och SQL Server Kommunikationen med SQL Server skall ske via TCP/IP. Daedalos kräver en bildskärm som kan visa minst 1024x768 bildpunkter, och färgdjupet skall vara minst 16 bitar. Vidare visar driftserfarenhet att Daedalos kan köras i terminalserversystem ( Windows Terminal Server, Citrix etc) om dessa i sin tur uppfyller systemkraven som redovisats ovan. 1.2 Beståndsdelar Daedalos består av följande delar: Användarmodul Användarmodulen är det dataprogram som användaren nyttjar för att komma åt Daedalos funktioner. Användarmodulen är installerad på användarens dator, och startas av

5 5 (18) Förladdare Databasadministratör Databas Användarhandledning Daedalos tjänsteserver förladdaren. Förladdaren är ett dataprogram installerat på användarens dator som startas när användaren klickar på Daedalos-ikonen. Förladdaren ansvarar för att kontrollera att rätt databas finns tillgänglig och att rätt version av användarmodulen är installerad. Förladdaren kan också komplettera användarmodulen med nya serviceutgåvor, genom att hämta dem över Internet-förbindelse. Databasadministratören är en programvara som nyttjas av systemansvarig för att utföra operationer mot Daedalos databas, som är av karaktären att det utförs sällan. Ett exempel är uppgradering av databasen när nya funktioner skall driftsättas. Daedalos nyttjar en databas, tillhandahållen av databashanteraren MS SQL Server, för lagring av alla data. Detta dokument. Användarhandledningen tillhandahålles i separat dokument. Dokumentationen tillhandahålles on-line via Daedalos webtjänst i Adobe PDF-format, och kan också skrivas ut. Daedalos nyttjar funktioner i Daedalos tjänsteserver, som finns på adressen Tjänster Daedalos nyttjar tekniska tjänster som tillhandahålles via Daedalos tjänsteserver. Tjänsteservern tillhandahålles på Internet, via adressen Den viktigaste tjänsten som tillhandahålles via tjänsteservern är felrapportering. I händelse av tekniskt fel, eller annan omständighet av synnerlig vikt, sänds meddelande automatiskt till Daedalos tjänsteserver. I samband med detta sänds teknisk information som kan användas för att identifiera felet, aktuell dator och inloggad användare. Informationen sparas i vår servicedatabas, och ligger till grund för fortsatt underhålls- och utvecklingsarbete. En annan viktig tjänst som tillhandahålles är uppgraderingsutgåvor av programvaran. I samband med programstart kontrolleras vilka uppgraderingar som finns tillgängliga, varefter dessa installeras innan systemet startas för användning. Tjänsteservern är en så kallad single-point-of-failure, dvs en potentiell felkälla som kan leda till att systemet blir oanvändbart. Daedalos är därför konstruerat på ett sådant sätt att om kontakt inte kan etableras vid programstart, kommer Daedalos att ignorera tjänsteserverns utbud och användaren kan fortsätta att använda systemet på normalt sätt.

6 6 (18) Det finns emellertid en felsituation som inte auomatiskt kan åtgärdas, och det är följande: Systemadministratören har uppgraderat databasen och installerat en ny funktion samtidigt som användarens dator ännu inte blivit uppgraderad med den nya versione samtidigt som användarens dator inte kan etablera kontakt med tjänsteservern. I denna situation kommer inte användarens Daedalos att fungera som avsett. 1.4 Aktivering Daedalos upplåtes med nyttjanderätt och måste aktiveras innan systemet kan användas. Aktiveringen genomförs av leverantören vid installation och driftsättning. Daedalos kan också vara installerat utan krav på aktivering. I detta fall behöver aktivering inte ske. 1.5 Uppgradering av programvara Med jämna mellanrum publicerar leverantören uppgraderingsutgåvor, som kan innehåller felkorrigeringar, förändrad eller förbättrad funktionalitet, eller övriga anpassningar. Samtliga uppgraderingsutgåvor publiceras på för manuell nedladdning. Programvaran publiceras i två paket: 1. DaedalosAdm, som är uppgraderingspaketet avsett för databasen och Daedalos Administratör. 2. Daedalos, som är uppgraderingspaketet avsett för användarnas maskiner. Systemadministratören måste installera och exekvera uppgraderingspaketet för databasen. Se annat avsnitt i detta dokument för en diskussion om hanteringen av databasen. För uppgraderingen av användarnas datorer kan systemadministratören välja en av två olika strategier, eller en blandning av båda. Uppgradering via installationssystem I flera större installationer finns färdiga system och rutiner för att installera programvara på användarnas arbetsplatser. I dessa fall nyttjas det nedladdade uppgraderingspaketet på samma sätt som alla övriga program som installeras. Ytterligare åtgärder är därefter ej nödvändiga. Uppgradering via Daedalos Systemadministratören kan också välja att inte vidta någon åtgärd för att uppgradera användarnas maskiner. I detta fall kommer Daedalos, vid nästa programstart, att uppgraderas automatiskt. Anm: kontrollen av att användaren har rätt programvara genomförs alltid vid programstart, även om systemadministratören väljer att installera ny version på användarens maskin. Men i detta fall kommer kontrollen naturligtvis alltid att visa att rätt version är installeras, varför ingen åtgärd vidtages.

7 7 (18) 1.6 Databas Daedalos nyttjar en databas som tillhandahålles av databashanteraren Microsoft SQL Server. Databasen består av ett stort antal tabeller, vissa med ett stort antal termer ( fält ). Samtliga termer och fält redovisas i termlistan, som ingår i detta dokument. Tabellstrukturen i databasen kan förändras. När nya funktioner tillförs Daedalos, eller när felrättningar och justeringar äger rum, kan tabeller och termer utökas, tas bort eller på annat sätt förändras. Databasen nyttjar i stor utsträckning automatiska lagrade procedurer ( triggers ) för att säkerställa dataintegritet i databasen. Relationer mellan olika tabeller är inte formaliserade i databasen, utan nyttjas dynamiskt av systemet. 1.7 Exekveringsläge Daedalos användarprogram är avsett att köras i User Mode under Windows XP, dvs utan de extra rättigheter som följer med Admin Mode. Exekveringsläget User Mode innebär bland annat att en applikation inte har rättiigheter att skriva i viktiga systemkataloger, till exempel Program Files, och inte heller kan nyttja registernyckeln Local Machine för skrivning av data. Daedalos nyttjar därför registernyckeln Current User, samt katalogstrukturen under Documents and Settings\<current user> för all lagring av data. System som nyttjar flyttbara användarprofiler ( roaming profiles ) måste beakta detta faktum. Daedalos Administration skall köras i Admin Mode. 1.8 Katalogutnyttjande Den lokala installationen av Daedalos nyttjar nedanstående kataloger. <Documents and Settings>\<User>\Application Data\lpa.net I denna katalog lagras lokala exekverbara filer jämte konfigureringsfiler (INI-filer). <Documents and Settings>\<User>\Local Settings\Temp\LPA LogFiles I denna katalog lagras loggfiler som exekverbara moduler skapar. <Program Files>\LPA\Daedalos I denna katalog lagras exekverbara moduler som installeras vid förstagångsinstallationen av systemet. 1.9 Applikationsloggning Varje i systemet ingående exekverbar modul skapar loggfiler i textformat på den lokal dator (eller i den lokala katalogstuktur) där systemet är installerat. Loggfilerna innehåller information om inträffade fel och andra händelser av stor vikt. En loggfil har ett namn som är uppbyggt enligt: <Användare> <exekverbar modul> <dagens datum>.log.

8 8 (18) Loggfilerna är i textformat, och kan öppnas till exempel med verktyget Anteckningar ( Notepad ) Interaktion med Microsoft Word Daedalos kan i vissa driftlägen interagera med Microsoft Word, för att producera handlingar. Interaktionen bygger på att användaren skapar eller på annat sätt får tillgång till Word-mallar, vilket är dokumentfiler med ändelsen.dot, som Word nyttjar för att skapa dokument med visst föutbestämt innehåll. Det är inte ovanligt att en användare låter organisationens logotyp, adressuppgifter etc ingå i mallen. Därutöver har användaren möjlighet att inkludera så kallade dokumentvariabler (eng. document variables) i mallen. En dokumentvariabel är en platsmarkör som kan fyllas med innehåll av Daedalos. Daedalos nyttjar dokumentvariabler när handlingar skall produceras i ärendemodulen, till exempel tillsyneprotokoll, remissyttranden etc. Daedalos nyttjar följande dokumentvariabler: Variabel Dokumentvariabler som börjar med Ver_ äger giltighet då aktuellt ärendes primära koppling gäller en verksamhet. Ver_Nummer Ver_Benämning Ver_SRV-kod Ver_Adress Ver_Alternativadress Ver_Postadress Ver_Fastighet Ver_Fnr Ver_Kommunkod Ver_Kommun Ver_Nord Ver_Ost Ver_Stationsområde Ver_Nyko Dokumentvariabler som börjar med Fst_ äger giltighet då aktuellt ärendes primära koppling gäller en fastighet. Fst_Fastighetsbeteckning Textinnehåll Verksamhetsnummer Verksamhetens benämning Verksamhetens primära SRV-kod Verksamhetens adress Verksamhetens alternativadress Verksamhetens postadress Verksamhetens primära fastighetsbeteckning Verksamhetens primära fastighetsnyckel Verksamhetens kommunkod Verksamhetens kommun Verksamhetens nord-koordinat Verksamhetens ost-koordinat Verksamhetens stationsområde Verksamhetens nyckelkodsområde Fastighetens fastighetsbeteckning

9 Fst_Adress Fst_Fastighetsnyckel Fst_Länskod Fst_Kommunkod Fst_Kommun Fst_Nyko Fst_Postnr Fst_Postort Fst_Nord Fst_Ost Fastighetens primära adress Fastighetens fastighetsnyckel Fastighetens länskod Fastighetens kommunkod Fastighetens kommun Fastighetens nyckelkodsområde Fastighetens postnummer Fastighetens postort Fastighetens nord-koordinat Fastighetens ost-koordinat 9 (18) Adr_Sändlista (flerradig) Denna variabel innehåller ärendets sändlista. Varje mottagare står på en egen rad, med efterföljande radbrytning. Texten i variabeln kan alltså innehålla flera rader. Adr_FakturaAdress Adr_TillAdress (flerradig) Denna variabel innehåller adress till fakturamottagaren. Texten i variabeln innehåller flera rader. (flerradig) Denna variabel innehåller adress till ärendemottagaren. Texten i variabeln innehåller flera rader. Dok_DagensDatum Dok_PåbörjatDatum Dok_ÅtgärdDatum Dok_GenomfDatum Dok_UppfDatum Dok_Registernr Dagens datum, dvs datum då handlingen skapas. Datum då ärendet påbörjades Datum för enskild åtgärd Datum för genomförd åtgärd Datum för uppföljning Diarienummer ( Registernummer ) Dok_Ombud Närvarande ombud 1 Dok_OmbudTel Närvarande ombuds telefonnummer 1 Dok_Ombud2 Närvarande ombud 2 Dok_Ombud2Tel Närvarande ombuds telefonnummer 2 Dok_Anm Dok_ÄrendeKlass Dok_ÄrendeKodKod Dok_ÄrendeKodKlartext Ärendeanmärkning Ärendeklassbeteckning Ärendekodens kodbeteckning Ärendekodens klarttextbeteckning

10 Dok_ÅtgärdKodKod Dok_ÅtgärdKodKlartext Dok_ÅtgärdBKod Dok_ÅtgärdUppfkod Dok_Kopia Dok_HandlSign Dok_HandlNamn Dok_HandlTel Dok_HandlMobil Dok_HandlEpost Åtgärdskodens kodbeteckning Åtgärdskodens klartextbeteckning Beslutskod Uppföljningskod 10 (18) Innehåller texten KOPIA om den aktuella handlingen är en kopia. Om det är ett original innehåller variabeln tomma strängen (dvs inget text alls). Handläggarens signatur Handläggarens namn Handläggarens telefonnummer Handläggarens mobiltelefonnummer Handläggarens e-postadress 1.11 Interaktion med Adobe Acrobat Daedalos kan producera vissa dokument som Adobe PDF-filer, vilka kan läsas i tilläggsprogrammet Adobe Acrobat. Vid produktion av Acrobat-dokument hämtas en mall som lagras i Daedalos databas, och denna fylls med information via Adobes definierade gränssnitt Single Sign-on Daedalos är försett med en funktion för så kallad single sign on, vilket innebär att systemet inte efterfrågar lösenord när det startas. Istället läser systemet aktuell användare från Windows, och antar att det är samma användare som nyttjar Daedalos. Funktionen är avsedd att fungera med många olika system för användarautenticering. Tekniskt fungerar det så att i Windows inloggad användare matchas mot de användare som är definierade i Daedalos databas. Om användarnamnen exakt stämmer överens startar systemet på rätt behörighetsnivå. Om namnen inte stämmer överens startar systemet inte. För att funktionen skall fungera måste användarna i Daedalos databas ha samma namn som användarna i den databas som användes för Windows-inloggningen.

11 11 (18) 2 Systemberoenden Detta dokument diskuterar systemberoenden som kan påverka driftsättningsarbetet vid implementation av Daedalos hos kommunal räddningstjänst. 2.1 Fastighetsdata Daedalos kan utnyttja fastighetsdata från fastighetsregister. Med fatsighetsdata förstås uppgifter om fastigheter, byggnader och adresser. Ett kommunalt fastighetsregister innehåller ofta mycket stora mängder data, varav endast en delmängd användes av Daedalos. Det finns flera olika leverantörer av kommunala fastighetsregister. Daedalos kan anpassas att läsa data från flertalet av dessa. Lantmäteriverket har definierat ett standardiserat format för överföring av fastighetsinformation, ÖFF. Många kommuner prenumererar på uppdateringar från Metria (eller annan leverantör) i detta format. Sådana aviseringsfiler kan läsas direkt av Daedalos. Räddningstjänsten bör vinnlägga sig om att i samarbete med annan lämplig kommunal förvaltning etablera en enkel rutin för löpande uppdatering av fastighetsinformation. Rutinen kan se ut på olika sätt beroende på lokala krav. Ett exempel på en lämplig rutin är att aviseringsfilerna användes för att uppdatera också Daedalos, tillsammans med övriga tekniska system. Detta är en rutin som kräver minimalt med arbete, och som inte medför några nämnvärda kostnader. Ett annat exempel på lämplig rutin är att räddningstjänsten har on-line-åtkomst till kommunens fastighetsregister. Då krävs inga periodiska manuella uppdateringar, men det finns andra omständigheter att beakta. Ett annat exempel på lämplig rutin är att räddningstjänsten periodiskt erhåller en kopia på fastighetsdatabasen och kopierar den till Daedalos databas. Data från fastighets-, byggnads- och adressregister som Daedalos kan utnyttja återfinnes i följande ÖFF-tabeller: F01A, F08A, F09A, F09D, F09E, F09F, F21A, F23A, F30A, F30B, F50A, F52A, F55A, F57A, F57B, F58A, F90A, F93A, F93B och F97A. 2.2 Kartdata Daedalos är utrustat med en funktion för presentation av karta. Liksom fastighetsdata måste kartdata importeras till systemet. Varje kommun har olika tekniska och administrativa förutsättningar för att försörja räddningstjänsten med kartdata. Ett flertal format för lagring av kartdata är allmänt förekommande. Kartans utseende (manér) kan variera, även för samma uppsättning kartdata. Räddningstjänsten bör tillsammans med lämplig kommunal förvaltning etablera en rutin för att försörja Daedalos-systemet med kartdata.

12 12 (18) 2.3 Övriga kommunala data Daedalos kan utnyttja även information från andra kommunala register, till exempel befolkningsregister, register över särskilda boenden, vårdinstitutioner, företag, etc. 2.4 Konvertering av data från annat verksamhetsplaneringssystem Daedalos kan utnyttja data från andra IT-stöd-system för räddningstjänst. Före driftsättning skall sådana data konverteras på lämpligt sätt. Konverteringen sker i två steg. Först görs en provkonvertering av befintliga data (objekt, insatsrapporter, protokoll, personaluppgifter etc) som utvärderas av räddningstjänsten. Det är inte ovanligt att ett så grundläggande arbete som en datakonvertering kan avslöja hittills oupptäckta kvalitetsbrister i befintlig databas. Efter beslut om slutkonverteringens omfattning genomförs denna. Under tiden slutkonvertering sker måste driftstopp av IT-stödsystemen (det gamla och det nya Daedalos) råda under cirka en arbetsdag.

13 13 (18) 3 Databasadministration Administrering av databaser görs med programmet Daedalos Administration. Härifrån kan man uppdatera, blockera och prova förbindelse till databas. Särskilda rutiner finns även för att uppdatera specifika delar av databasen. 3.1 Välj databas För att ange önskad databas tryck på knappen Ändra anslutningsparametrar. Fyll i databasinformationen tryck därefter på Diagnostik - knappen för att kontrollera vald databas.

14 14 (18) Testerna kan köras separat med respektive Test - knapp eller samtidigt med Samtliga tester - knappen. Vid lyckade tester, stäng ner diagnostikformuläret och tryck OK på databasformuläret. Vid fel kontrollera angivet databasinformation och gör om diagnostiken. 3.2 Uppdatera databas Efter att ha valt önskad databas som ska uppdateras tryck på Kontrollera och uppdatera. Databasen kommer att blockeras för alla användare medans den blir uppdaterad. I informationsformuläret kan man ange egna skäl till varför den är blockerad. Den information som man angivit kommer användarna att få när de försöker arbeta med databasen. Tryck på OK.

15 15 (18) Tryck på JA om databasen ska avblockeras automatiskt efter att den blivit uppdaterad. Användarna kan först börja använda databasen efter att den blivit avblockerad. Databasen kan även manuellt avblockeras från huvudformuläret. Tryck på JA. Arbete med databasen kan pågå medan uppdatering påbörjas. Användarna kommer att visas i en lista. För att fortsätta med uppdateringen måste dessa användare kopplas bort från databasen. Antingen kan varje enskild användare stänga ner själv eller så kan man trycka på Framtvinga blockering för att automatiskt koppla bort alla.

16 16 (18) Användarna som inte hunnit spara kommer att förlora alla sina ändringar. Kontrollera att varje användare stänger ner och sparar alla sina ändringar för säker informationshantering. Uppdateringen kommer nu att pågå under ett antal minuter. Information om uppdateringen kommer att visas under hela genomförningen. När uppdateringen är färdig visas huvudformuläret åter. 3.3 Särskild rutin Från Särskild rutin - knappen nås en meny med olika funktioner som man kan välja. Dessa funktioner hjälper till att optimera systemet för snabbare information åtkomst och för att underlätta för användaren. Vissa funktioner kan behövas köras fler gånger medans med andra räcker det att man gör det en gång.

17 Hämta utskriftsmallar för insatsrapport Import av fastighetsdata i ÖFFformat Incheckning av insatsrapporter Skapa databasroller i sql-servern Uppdatera snabbsökningstabeller för insats 17 (18) Uppdaterar mallarna som används vid utskrift av insatsrapporter. Görs även automatiskt vid uppdatering av databas. Uppdaterar fastighetsinformationen med fastighetsdata enligt Lantmäteriets ÖFFspecifikation. När en användare arbetar med en insatsrapport blir den utcheckad av användaren. Det betyder att ingen kan arbeta med samma rapport medans den fortfarande är utchekad. Ibland händer det av olika anledningar att rapporten inte checkas in efter utförda ändringar. Denna funktion checkar in samtliga rapporter som finns. OBS! Risk för att en rapport är under arbete och därmed kan flera användare jobba med samma rapport om denna funktion används. Manuell incheckning kan även göras från insatssökningsformuläret. Vid flytt av databas till en annan server behövs det skapas nya databasroller på den nya servern för korrekt åtkomst av databasen. Optimerar sökningen av insatsrapporter. 3.4 Import av fastighetsdata i ÖFF-format Vid uppdateringen går det att antingen ange en specifik fil med fastighetsdata eller en katalog med flera filer. Ange sökväg till filen eller till katalogen med filerna. Tryck på

18 18 (18) Starta -knappen för vald uppdateringsmetod. Det går att stoppa uppdateringen och köra samma filer igen utan att det orsakar informationsfel. För att uppdateringen ska göras korrekt måste filerna köras i rätt nummerordning. Den senaste filen som användes vid uppdateringen står angivet på formuläret. Skulle problem uppstå går det att rensa all fastighetsinformation ( Töm adressdatabas ) och sedan uppdatera med ett komplett engångsuttag. Efter varje uppdatering uppdateras även sidotabellerna. Dessa kan även uppdateras manuellt med Uppdatera sidotabeller. Knappen Kopiera F till FDS-tabellerna ska man använda om man kör objektsmodellen i Daedalos, efter att fastighetsuppdateringen är klar.