Referencedatamodel-projektet DANVA - DDV Illustrativt eksempel 1: Indhentning af kunders forbrug 22. oktober 2012 Version 1.0
Forbehold Eksemplerne skal illustrere DDV integrationsmetoden og hjælpe læseren med at forstå hvad de enkelte arkitekturbeskrivelser kan rumme Eksemplerne er realistiske men slet ikke komplette og fyldestgørende for en DDV standardisering De anvendte betegnelser i beskrivelserne er kun til illustration og er IKKE en del af DDV arkitekturen før det egentlige standardiseringsarbejde efter metoden udføres Eksemplerne kan ikke stå alene, og er et supplement til DDV integrationsmetoden. Betegnelser på diagrammer mv. svarer til version 1.0 2
Eksempel 1 Eksemplet viser et ønske om at standardisere data når forbrug indhentes fra en kunde ved at kunden selv aflæser, ved aflæsning af selskabets medarbejder eller 3. part samt ved fjernaflæsning. Som forberedelse til at dokumentere standarden blev der på tavlen skitseret et typisk konkret systemlandskab, og de relevante snitflader blev identificeret (se foto næste side). Derefter blev der arbejdet bottom-up efter DDV-integrationsmetoden De fysiske snitflader på fotoet blev løftet til logisk niveau og beskrevet som datasnitflader mellem domæner. På samme tid blev den forretningsmæssige (processer) og datamæssige sammenhæng (informationsmodel), som disse integrationer indgår i, dokumenteret. Eksemplet illustrerer også hvordan DDV overblikkene fungerer som indholdsfortegnelser. Se reolen på slide 5 med angivelse af hvilke beskrivelser der hører til hvor. I eksemplet er der klikbare links og noter om navigation fx ved udstilling i DDV-portalen. 3
Foto fra arbejdet med eksemplet 4
Eksempel 1 i reolen Slide 14 Slide 23 Styrer alle tilføjelser/ændringer til DDV arkitekturen dvs. den Slide rammesættende 6 forretnings- og it-arkitektur. Aktøroverblik Slide 9 Procesoverblik Slide 11 Den enkelte proces udefra - Overblikkene vedligeholdes i DDV regi Fra integrationsmetoden: Informationsoverblik Domæneoverblik Slide 16 Den enkelte proces indefra Informationsmodeller Domæne-flows Datasnitflader Slide 18 Slide 26 Slide 29 Slide 28 Slide 30 Eksemplet kan læses oppefra og mod højre hvor slide 6 viser hvor der er standardiseret Eller nedefra og mod venstre ved første at læse de to standardiserede snitflader slide 28 & 30. 5
Aktøroverblik A S Struktureret oversigt over de aktører som et selskab udveksler DDV standardiseret information med Kunde Metodenoter Ikke alle informationsstrømme vil kunne ses her. Gruppering er en skjuleteknik Udformes i DDV regi snart i en første tynd udgave Udbygges typisk når der kommer nye standarder på hylden Se metoden: afsnit 3.1 Aflæsning Selskabet Grundkortleverandør Forsyningssekretariatet (FS) Navigation: Ved at klikke på links vises beskrivelserne på de næste to slides (eller som mouse over tekst i DDV-portalen) 6
Beskrivelse af aktør i Aktøroverblikket Rollenavn Beskrivelse Evt. eksempler Kunde Person eller virksomhed, som selskabet har leveret eller leverer ydelser til. Kunden benytter services af forskellig art, og selskabet har installation(er) på ejendommen. Ikke relevant. Evt. ekstern definition Ikke relevant Metadata Kun eksempel Version 0.2 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 19.09.2012 Dokumenterer den fælles forståelse af aktøren Se metoden: afsnit 3.1.3 7
Beskrivelse af informationsstrømsgruppe i Aktøroverblikket Betegnelse Beskrivelse Aflæsning Information om målerstand på givne tidspunkter på en kundes forbrugssted. Består af Selvaflæsning hvor kunden selv aflæser og indmelder resultat Selskabsaflæsning hvor medarbejder fra selskaber eller 3. part aflæser og registrer aflæsningen Metadata Fjernaflæsning hvor udstyr koblet til måleren logger målerstand og automatisk videre sender. Visse af logninger bruges som fjernaflæsning. Kun eksempel Version 0.3 Udarbejdet af Referencemodelprojektet Oprettet 13.09.2012 Opdateret 30.09.2012 På dette niveau et det navngivningen der er vigtig. Dataindhold i form af felter kommer først til på logisk niveau Hver strøm har en tekst svarende til et ordbogsopslag Se metoden: afsnit 3.1.4 8
Procesoverblik Indholdsfortegnelsen over processer hvor der er DDV standarder xx XXX Indberetninger Indberetninger til FS xxxx Prisloftsindberetning til FS (eksempel 2) Udformes i DDV regi snart i en første tynd udgave Viser procesgrupper (pilene), undergrupper og de enkelte processer Med grå kan man vise mulige elementer der endnu ikke har standarder, men som der arbejdes på Se metoden: afsnit 3.2 XXX Kundeafregning XXXX xxx xxx Forbrugsmåling xxx Indhentning af kundes forbrug Forbrugsafregning xxx Serviceafregning xxx xxxx Xxxx Xxxx xxxx xxx xxx xxx xxx xxx xxx xxx xxx Navigation: Ved at klikke på gruppen Kundeafregning vises næste slide (eller ved mouse over ) Ved at klikke på processen vises næste niveau af detaljer = udefra-perspektivet = slide 11 9
Beskrivelse af procesgruppe i Procesoverblikket Navn Kundeafregning Beskrivelse Processer i selskabet der håndterer afregning over for kunder for forbrug og services. Består af Metadata Forbrugsmåling xxx Indhentning af kundes forbrug Forbrugsafregning xxx Xxx Serviceafregning Kun eksempel Version 0.2 Udarbejdet af Referencemodelprojektet Oprettet 13.09.2012 Opdateret 19.09.2012 Beskrivelsen skal hjælpe med at komme nye processer i den gruppe og til at forstå tankerne bag strukturen i procesoverblikket Se metoden: afsnit 3.2.3 10
Den enkelte proces udefra A S Selskabet Kunde Tid for aflæsning Forskellige hændelser Fx fraflytning Indhentning af kundes forbrug Aflæsning Indhent aflæsning Aflæsning registreret Viser essensen af processen set udefra dvs. som en forretningsfunktion eller -service. Fokus på omgivelserne af processen og essensen af processen fra start til slut Længden af processen er dikteret af procesoverblikket; dvs. hvilke andre processer der findes. Evt. grå farve til elementer tegnet til forståelse frem for selve standardiseringen. De kan standardiseres senere hvis det giver anledning til nye snitflader Se metoden: afsnit 3.3.2 Navigation: Muligt at navigere til beskrivelsen (slide 12+13) til samme proces set indefra dvs. slide 16 11
Beskrivelse af processen set udefra side 1 Navn Indhentning af kundes forbrug Hændelse(r) Udføres periodisk eller forårsaget af andre hændelser fx flytning Beskrivelse Evt. delprocesser Aflæsning af kundens måler indhentes på en af de gængse måder: Selvaflæsning, Selskabsaflæsning, Fjernaflæsning. Indhent aflæsning Startbetingelse(r) Slutresultat(er) Informationsstrømme Målerne er registreret som hørende til kundens forbrugssted. Selskabsaflæsningerne er planlagt. Fjernaflæsningerne er konfigureret. Aflæsning registreret. For eksempel benytter Afregningsprocesserne og Kundeserviceprocesserne disse aflæsninger. Aflæsning I denne simple proces er der kun én delproces Se metoden: afsnit 3.3.3 12
Beskrivelse af processen set udefra side 2 Rammer Evt. andre interessenter Betalingsvedtægten (spildevand) evt. med særlige kommunale tilføjelser. Vandforsyningsregulativet. Evt. det enkelte selskabs leveringsbetingelser. Leverandører af aflæsningsudstyr Måleraflæsningsfirmaer Evt. Målepunkter Fordeling af typerne af aflæsning (kundeaflæsning, selskabsaflæsning, fjernaflæsning) Fejlrate Vigtighed 5 (meget vigtig på en skala fra 1-5). Afregningsprocessen kræver at forbrug indhentes inden for selskabets afregningsvindue. Tilgængelighed (oppetid) ift. selvaflæsning er også vigtig. Metadata Kun eksempel Version 0.5 Udarbejdet af Referencemodelprojektet Oprettet 13.09.2012 Opdateret 30.09.2012 Opdateret 17.10.2012 for at passe til metoden Se metoden: afsnit 3.3.3 13
Informationsoverblik Indholdsfortegnelsen over vigtige begreber med information, hvor der er DDV standardiseret inkl.betegnelserne Udformes i DDV regi snart i en første tynd udgave Viser begreber med betydning (kasserne) og vigtige sammenhænge hvor * står for mange. Med grå kan man vise mulige elementer der endnu ikke har standarder, men som der arbejdes på Se metoden: afsnit 4.1 Kunde Kunde Forbrugssted Anlægsregistrering 1 * 1 * Forbrugssted Måler Grunddata Adresse Ledning (se eksempel 2) Navigation: Ved at klikke på begreberne fås definitionerne Selskab Selskab 14
Begrebsbeskrivelse i Informationsoverblik Navn Tilhører Definition Formål Måler Informationsområde Anlægsregistrering Udstyr til at måle forbrug. Stamdata for målerudstyr. Eksempler Evt. ekstern definition Informationsmodel(ler) Evt. alias(ser) Metadata Måler 5786979 der sidder i kælderen på forbrugssted hos kunde yyy. Ikke relevant Måler (slide 18) Ikke relevant Kun eksempel Version 0.2 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 19.09.2012 Dokumenterer betydningen af de vigtigste begreber i standardiseringsarbejdet Link til de detaljerede informationsmodeller med begrebet i (en eller flere). Se metoden: afsnit 4.1.3 15
Den enkelte proces Indefra + + Indhentning af kundeforbrug (viser 3 slags aflæsning) Viser hvilke aktiviteter der logisk skal til for at gennemføre processen Selskabet Kunde Tid for aflæsning Forskellige hændelser Fx fraflytning Aflæs måler Bed kunde om selvaflæsning Selvaflæsning Meddel selvaflæsning Årsforbrug Registrer selvaflæsning Aflæs måler Selskabsaflæsning Registrer aflæsning Fjernaflæsning Registrer fjernaflæsning Mulig lækage Aktiviteterne er beskrevet som vist i eksempel på næste slide (klikbart) Mulige svømmebaner kunne være Selvbetjening, Medarbejder og Fuldautomatisk hvis det ønskes Dataobjekter (fra informationsoverblikket) kan vises ikke på dette niveau når det giver værdi Se metoden: afsnit 3.4 Aflæsning registreret 16
Aktivitetsbeskrivelse i proces set indefra Navn Evt. Aktør Registrer selvaflæsning Kunde eller anden der på vegne af kunden betjener sig selv Formål At registrere en aflæsning af en måler foretaget af kunden selv på installationen. Evt. start-betingelse Måleren er registeret hørende til kundens installation. Forløb Identificering af kunden Visning af målerinformation Registrering af selvaflæsning Kvittering af selvaflæsning med visning af årsforbrug Slutresultat Involverede begreber Selvaflæsning registeret Installation Metadata Kun eksempel Version 0.2 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 19.09.2012 Se metoden: afsnit 3.4.3 17
Måler er det centrale begreb i den informationsmodel vi ser på her. Nøglen installationsnr er vist, mens andre attributter som fx datoer og status vises kun når man slår op i selve Forbrugssted-modellen. Installationsnummeret placeres IKKE som fremmednøgle i Måler Attributternes datatyper som fx String skal vælges fra en fælles DDV liste (gerne med udgangspunkt i de eksisterende modeller) String er foreslået så selskaberne kan bruge reference i Aflæsning forskelligt fx til initialer eller en tekst henvisning eller et tal eller tom. Se metoden: afsnit 4.2 Viser standardiserede nøgler og attributter ( datafelter ) Forbrugssted:: Forbrugssted installationsnr: string måler forbrug på Måler Aflæsning 1 0..* målernr:string placering: enumeration Informationsmodel Måler 1 er aflæst 0..* dato:date reference:string aflæsningsmetode: enumeration målerstand: decimal opsamles automatisk 1 * Implementeringsnote: Ved implementering kan der pga. stort antal attributter vælges kun at vise begrebets egne nøgler i selve UML diagrammet, men attributter vises i på tabelform med samme indhold per række som vist på slide 19 Informationsmodeller Understationslogning tidspunkt: timestamp værdi:decimal Navigation: Ved at klikke på elementerne vise de underliggende definitioner (slides 19-22) 18
Begrebsbeskrivelse i Informationsmodel Navn Definition Aflæsning Aflæsning af en måler foretaget af Kunden eller selskabet eller 3. part. Formål Stamdata for aflæsning. Benyttes især til kontrol af forbrug og afregning. Nøgle Måler.målernr dato:date Nøgle= hvad gør informationen entydig Se metoden: afsnit 4.2.3 Attributter Metadata reference: string aflæsningsmetode: enumeration (kunde, selskab,3.part,fjern) målerstand: decimal Kun eksempel Version 0.2 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 19.09.2012 19
Attributbeskrivelse i Informationsmodel Navn Definition Formål Kilde Værdisæt Måler:placering Angiver ved standardiserede værdier hvor måleren er placeret på forbrugsstedet. At kunne finde frem til måleren ved aflæsning og service. Registres ved opsætning, flytning og nedtagning af måleren. Enumeration Obligatorisk med værdier nedenfor Evt. standardiserede værdier Evt. aliasser Metadata Ikke kendt Garage Baggang Værelse Soveværelse Carport Badeværelse Lager Udvendig skab Krybekælder Vaskerum Forgang Værksted Målerbrønd Ikke relevant Kun eksempel Version 0.2 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 19.09.2012 Eksempel på attribut med standardiserede værdier Skal kun modelleres hvis den ønskes udvekslet med andre domæner Se metoden: afsnit 4.2.5 20
Attributbeskrivelse i Informationsmodel Navn Definition Formål Aflæsning.målerstand Angiver den aflæste målerstand på Aflæsning.dato Afregning Eksempel på obligatorisk og frivilligt attribut ( dvs. behøves ikke være udfyldt) Kilde Værdisæt Registres ved selvaflæsning, selskabsaflæsning, fjernaflæsning fra en målerlogning (angives i Aflæsning.metode) Decimal Obligatorisk Se metoden: afsnit 4.2.5 Evt. standardise rede værdier Evt. aliasser Metadata Ikke relevant Ikke relevant Kun eksempel Version 0.2 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 19.09.2012 Navn Definition Formål Kilde Værdisæt Evt. standardise rede værdier Evt. aliasser Aflæsning.reference Angiver evt. reference. fx til initialer eller aflæsende 3. part Opklaring af fejl Registreres oftest ved selskabsaflæsning String Frivillig Ikke relevant Ikke relevant Metadata Kun eksempel Version 0.2 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 20.09.2012 21
Relationsbeskrivelse i Informationsmodel Navn Måler måler forbrug på Installation Definition Formål Angiver hvilke målere der er installeres til måling af forbrug på hvilke installationer. Stamdata for placering af målere. At koble aflæsninger til kunden via installationen. Metadata Kun eksempel Version 0.2 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 19.09.2012 Relationerne er en vigtig del af informationsmodellen Se metoden: afsnit 4.2.4 22
Domæneoverblik Indholdsfortegnelsen over domæner, som er den logiske systeminddeling som DDV standardiserer snitflader imellem uafhængigt af konkrete systemer og leverandørløsninger Fx DIVA Portal Administration & økonomi Personale Ekstern kommunik ation Apps Voice Response (IVR) Kommunikationsdomæner Kernedomæner Drift, produktion & Distribution HST- SRO Kunde center UST- Måler Besked services Udvikling & anlægsarbejder Tømningsordning Projektstyring UST- SRO Net beregning Udformes i DDV regi snart i en første tynd udgave Med grå kan man vise mulige elementer der endnu ikke er arbejdet på Udgør grundstrukturen i hvordan DDV standardiserer Se metoden: afsnit 5.1 Visse domæner er fremhævet med større skrift og ikon blot for læsevenligheden i dette eksempel Økonomi Forbrugsafregning HST- Måler D&V Ledelsesinfo Ledelse Slam Kontrol/ Kvalitet CRM TV Inspektion Lednings reg. EAM??? Anlægskartotek Støttedomæner Eksterne støttedata Eksterne grunddata GIS ESDH Datasammen stilling (ETL) DataWarehouse 23
Domænebeskrivelse i Domæneoverblik Navn Beskrivelse Masterdata Forbrugsafregning Håndterer afregning af kunders forbrug. Måler::Måler Måler::Aflæsning Skal definere hvad DDV forstår ved det på gældende domæne, som er udgangspunktet for at definere masterdataansvar og datasnitflader Der er kun vist de masterdata vi har med i eksemplets informationsmodeller Understationslogninger fra samme informationsmodel antages at have master i HST-måler derfor involveres det dette domæne i domæneflowet på slide 29 Stikord / Søgeord Forbrug, Måler, Aflæsning, Afregning Metadata Kun eksempel Version 0.1 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 20.09.2012 Se metoden: afsnit 5.1.3 24
Integrations mønstrene Integrationsmønstrene viser de tilladte måder at integrere på for en DDV datasnitflade Se metoden: afsnit 5.2
D 1 D 2 D 3 Domæneflows Indhentning af kundeforbrug ved personaflæsning Viser hvordan processen it-understøttes og især hvordan data udveksles Måler Selvaflæsning Selskabsaflæsning Selvaflæsning Kvittering med årsforbrug IVR Meddel selvaflæsning Portal Registrer aflæsning Meddel selvaflæsning Vis årsforbrug Årsforbrug Aflæsning Forbrugsafregning Registrer aflæsning Selvaflæsning/ Selskabsaflæsning registreret Her er it-understøttelse for så vidt angår domæner og de ønskede DDV integrationer Få store diagrammer eller flere små diagrammer er en smagssag Processen slide 16 it-understøttes af to domæneflows (dette samt slide 29) Her er eksempler på anvendelse af forskellige integrationsmønstre Kø til Aflæsning og Asynkron service til Årsforbrug Se metoden: afsnit 5.3 Hent årsforbrug 26
Domæneflowbeskrivelse Navn Beskrivelse Evt. forudsætninger Indhentning af kundeforbrug ved personaflæsning It-understøttelse af indhentning af kundeforbrug aflæse af kunde, medarbejder i selskaber eller 3. part. Ingen Understøttede processer Indhentning af kundeforbrug Snitflader Aflæsning Årsforbrug Metadata Kun eksempel Version 0.2 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 20.09.2012 Beskriver hvad diagrammet rummer. Især vigtigt når der Tegnes flere domæneflow per Forretningsproces.. Se metoden: afsnit 5.3.3 27
xxxx Input Output Output Datasnitflade:Aflæsning Navn Beskrivelse Input Output Integrationsmønster Udvekslingsformat Aflæsning Registrering af en foretaget aflæsning Selskab::Selskab.CVRnr (frivillig) Forbrugssted::Forbrugssted.installationsnr Måler::Måler.målernr Måler::Aflæsning.dato Måler::Aflæsning.reference (frivillig) Måler::Aflæsning.aflæsningsmetode Måler::Aflæsning.målerstand Fejlkode 00 01 04 Kø XML Data i Input/Output gives med reference til informationsmodeller på formatet: modelnavn dobbeltkolon begrebsnavn punktum attributnavn (se slide 18) Se metoden: afsnit 5.4 Evt. links til fysisk dokumentation Metadata Når snitfladen er dokumenteret fysisk kan snitfladebeskrivelsen benyttes til at gemme reference/henvisninger hertil fx reference til XML skemaer for en service eller en kommasepareret fil for en dokumentudveksling. Kun eksempel Version 0.3 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 30.09.2012 28
D 1 D 2 D 3 Domæneflows UST- Måler Målerlog Log per tidsinterval Indhentning af kundeforbrug ved fjernaflæsning Beskedservice Integrationsmønster: Synkron service fx M-BUS binær Send sms om afvigelse D&V Registrer afvigelse Metodenote Her er domæneflow 2 der understøtter andre dele af samme proces Fem domæner er i spil Mulige valg af integrationsmønstre er vist grafisk her, men vil i praksis stå i selve snitfladebeskrivelsen. Forbrugsafregning HST- Måler Opsaml rå målerdata Afvigende forbrug Integrationsmønster: Hændelser/Event XML Integrationsmønster: Asynkron service kommasepareret Tid for afregning af fjernaflæste kunder Hent målerdata Hent fjernaflæsninger Målerlogningsliste Registrer aflæsning Fjernaflæsning registreret 29
xxxx Input Output Output Datasnitflade: Målerlogningsliste Navn Beskrivelse Input Output Målerlogningsliste At hente en liste af målerlogninger for angivne målere til brug for afregning på en skæringsdato Liste af målernumre= Måler:Måler.målernr Skæringsdato:date Liste af målerlogninger: Forbrugssted::Forbrugssted.installationsnr Måler::Måler.målernr Måler::Målerlogning.tidspunkt [tættest på og senest på Skæringsdato] Måler::Målerlogning.værdi Fejlliste af målere uden logninger: Måler:Måler.målernr Data i Input/Output gives med reference til informationsmodellerne på formatet: modelnavn dobbeltkolon begrebsnavn punktum attributnavn (se slide 18) Se metoden: afsnit 5.4 Integrationsmønster Udvekslingsformat Evt. links til fysisk dokumentation Metadata Asynkron service Kommasepareret Når snitfladen er dokumenteret fysisk kan snitfladebeskrivelsen benyttes til at gemme reference/henvisninger hertil fx reference til XML skemaer for en service eller en kommasepareret fil for en dokumentudvekling. Kun eksempel Version 0.3 Udarbejdet af referenceprojektet Oprettet 13.09.2012 Rettet 30.09.2012 30