Indeværende dokument er et bilag til rapporten MOX et forretningsmønster for fagsystemers udveksling af hændelser Version 0.76

Transkript

1 MOX bilag Indeværende dokument er et bilag til rapporten MOX et forretningsmønster for fagsystemers udveksling af hændelser Version 0.76 Rapporten og bilaget udgør et foreløbigt udkast til rapportering fra en arbejdsgruppe nedsat af Kommunernes It-Arkitekturråd. Versionsoplysninger Version 0.76 (indeværende version) Dokumentet har indarbejdet reviewkommentarer fra 1. og 2. review i KL/KOMBIT arkitekturstab. Dokumentet er ikke koordineret i detaljer med udkastet til scope for en kommunal beskedfordeler, som KL og KOMBIT for nylig har lagt til eksternt review. De to dokumenter vil være fuldt koordineret i næste udgave på baggrund af kommuners og it-leverandørers kommentarer til begge dokumenter, forventeligt i september Version 0.7 Arbejdsgruppens oprindelige udkast KL, 6. juli 2012 Rasmus Vandkjær Rasmussen, Frederikshavn Kommune Marc David Martin, Horsens Kommune David Møller, Svendborg Kommune Michael Breuning, Odense Kommune Martin Scheil-Corneliussen, Hjørring Kommune Erik Helweg-Larsen, KL Nikolaj Skovmann Malkov, KL 1

2 Indholdsfortegnelse Metode... 3 Begreber... 3 Symbolforklaring... 5 MOX standardprocesser... 7 Klassifikation... 8 Organisation... 9 Dokument Sag Beskedfordeler MOX byggeblokke

3 Metode De enkelte dele af konceptet er fremkommet ved analyse (nedbrydning i forskellige spor) af forretningsprocessen, indtil de enkelte delprocesser er overskuelige. Analysen er ikke gengivet i dokumentet kun resultatet. Vi har: Analyseret (opbygget) arkitekturbyggeblokke (ABB) som kan gennemføre en administrativ delproces 1. En ABB udfører en eller flere delprocesser, der kan implementeres i forbindelse med et it-system. Disse delprocesser kalder vi MOX processer, fordi de er standardiseret. Analyseret (opbygget) informationsudveksling mellem arkitekturbyggeblokke (ABB). Beskrevet hver arkitekturbyggeblok, så de vil kunne implementeres i et nyt eller eksisterende system. Pointen: Nedbrydning skal gennemføres, indtil man kan udføre Processen med en ABB. En ABB kan implementeres af leverandørerne, og den udfører dermed en afgrænset opgave. En ABB kan implementeres mange gange i sammenhæng med forskellige systemer. De anbefalede ABB er som udgangspunkt automatiske. Begreber Her gennemgår vi de vigtigste begreber, som gør det muligt at læse specifikationen. Begreberne er nærmere defineret og beskrevet i standarderne. Forretningsobjekt er den genstand, der begrunder en forretningsservice. Sag og dokumentstandarderne har nedenstående forretningsobjekter. Alle objekter har attributter, tilstande og relationer til andre forretningsobjekter. Forretningstjenesten Organisation administrerer oplysninger om nedenstående objekter: Aktør er en fællesbetegnelse for Organisations forretningsobjekter. En aktør kan have ansvar for en arbejdsopgave. Organisation som ikke skal forveksles med organisering. Objektet indeholder oplysninger om den formelle organisation. Organisatorisk Enhed som er det objekt, som en organisation er opbygget af det svarer til en afdeling, et kontor. Forkortes OrgEnhed og indeholder typisk en relation til klassifikation af, hvilke arbejdsopgaver enheden har ansvar for, og hvilke medarbejdere der er tilknyttet. Organisatorisk funktion som er det objekt, der kan bruges til at beskrive den funktion, der udføres i organisationen. Forkortes OrgFunktion. Interessefællesskab kan bruges til at beskrive uformelle organisationer f.eks. vejlaug. It-system kan bruges til at holde styr på de it-systemer, som organisationen bruger. 1 Jf. OIO-EA 3

4 Bruger af et it-system svarer til en brugerkonto (username). En bruger kan have relation til en person. Når et system udfører en proces automatisk, er det altid en bruger (system-bruger), der udfører det. Forretningsservicen Klassifikation administrerer oplysninger om nedenstående objekter: Klassifikation er det objekt, der samler et antal facetter med klasser. KLE og FORM er klassifikationssystemer. Facet er det objekt, der samler klasser i et klassifikationssystem, der belyser en del af en helhed. Emne og handling er to facetter af en emnesystematik. Klasse er selve indholdet i et klassifikationssystem. Klasser kan være ordnet hierarkisk. Forretningsservicen Sag administrerer oplysninger om en sag. Sag er det eneste forretningsobjekt i sag. Der er to hjælpeobjekter - journalpost og journalnotat. Journalpost er blot en relation til et eller flere dokumenter. Journalnotat er et kort notat, der kan knyttes til sagen. Det er ikke et selvstændigt objekt. Forretningsservicen Dokument administrerer oplysninger om et dokument. Dokument er det eneste forretningsobjekt i dokument. Det kan være oplysninger om et fysisk dokument, et digitalt dokument eller en samling af dokumentdele. Dokument kan rumme forskellige varianter af samme dokument f.eks. en pdf, en rtf og en xml variant. Forretningsservicen Beskedfordeler administrerer oplysninger om et abonnement. Abonnement er det eneste forretningsobjekt i Beskedfordeler. Objektet er afledt af de øvrige objekter, fordi det er et søgeudtryk (filter) på disse objekter. En besked om et objekt skal indeholde objektet, for at abonnementet kan afprøves. Det har reference til den aktør, der er abonnent. En Forretningsproces er en eller flere aktiviteter, der bearbejder et forretningsobjekt. Det er altid en aktør, der udfører en forretningsproces. F.eks. at sende et dokument til Digital Post er en forretningsproces. Forretningsprocesser kan være manuelle, brugerstyret eller systemstyret. En forretningslokation er et sted, hvor forretningsprocesser udføres. Nogle processer vil udføres over flere lokationer f.eks. at sende et dokument til Digital Post vil indebære, at man sender fra en lokation til en anden lokation. En lokation kan have nogle sikkerhedsmæssige egenskaber. Forretningshændelse (event) er en begivenhed, som har betydning for forretningen. F.eks. en person er født kan udløse børnefamilieydelse. Forretningsbesked er en besked om en forretningshændelse. Beskeden stilles til rådighed for aktører på grundlag af et abonnement. Det betyder, at den aktør der udsteder en besked ikke kender beskedens modtager. 4

5 Symbolforklaring Vi bruger forskellige symboler i forskellige situationer. De beskrives nedenfor. En manuel proces er en aktivitet (et stykke arbejde), der udføres af en person. Vi skelner ikke mellem en aktivitet og en proces. I venstre hjørne er angivet en person med nogle tandhjul, der udtrykker at den er manuel. Personen er ikke kendt af it-systemet. Et + i en proces betyder, at den kan nedbrydes i delprocesser, som kan illustreres i deres eget diagram. En bruger proces er et arbejde, hvor brugeren anvender et it-system. Brugeren er kendt af it-systemet. Hvis der er behov, kan man angive et nærmere specificeret brugerinterface. I brugerinterfacet udføres en separat proces (arbejde). En bruger proces hvor udførelsen resulterer i en besked. Beskeden kan f.eks. være en logning af, at brugeren har udført processen. Brugeren skal have rettighed til at udføre det arbejde, der udføres gennem brugerinterfacet. 5

6 En brugerproces i et it-system (serviceanvender) bruger et andet itsystem (Serviceudbyder), der tilbyder et service-interface. Et it-system udfører en system-proces, symboliseret ved et tandhjul. Processen er en bruger-proces, hvor brugeren er en system-bruger. Processen kan køre på vegne af en person-bruger. Processen startes af en besked og afsluttes med en besked. En system-proces kan også anvende et service-interface. System-brugeren skal typisk have rettigheder til at kalde serviceinterfacet. En systemproces kan starte med en besked og sammen med et serviceinterface gennemføre en transaktion (two-phase commit), der også udsteder en slutbesked. De to processer kan køre med samme system-bruger eller forskellige. 6

7 MOX proces er en proces, der udfører en standardiseret proces på basis af en standardiseret startbesked og udsteder en standardiseret slutbesked. Den vil typisk optræde som serviceanvender. MOX standardprocesserne nedenfor er alle af denne type. MOX standardprocesser Nedenfor listes de standardprocesser, som indgår i MOX. Der kan komme flere processer til, efterhånden som der opstår behov. 7

8 Klassifikation MOX proces Replikerer klasseobjekt Læser klasseobjekt Vedligeholder klasseobjekt Søger klasseobjekt Lister klasseobjekt Tilføjer klasseobjekt Processen replikerer (kopierer) objekter på basis af en registreringsbesked, som den skal abonnere på. Bruges til distribution af klassifikationsobjekter til systemer og lokationer, der har brug for at have lokale kopier af disse objekter. Klasseobjekterne er en samlebetegnelse for objekttyperne klassifikation, facet og klasse herunder hjælpeobjektet søgeord. Processen læser detaljer om objektet på basis af objektid og leverer disse i en besked. Den kan bruges, når man skal vise oplysninger om de objekter, som et givet objekt relaterer til (blå objekter). Processen er manuel og ender med en registrering i en service. Vedligeholder omfatter operationerne opret, ret, slet, importer, passiver tilsammen de operationer der danner en registrering. Processen viser, at klassifikationsobjekt (klassifikation, facet, klasse) bliver registreret af en bruger, men en registrering kan også udføres af en it-system-bruger. Processen bruges til at vedligeholde klassifikationssystemer og deres sammenhæng. Processen kan fremfinde objekter på grundlag af søgekriterier herunder brugervendt nøgle, tilstand, attributter og relationer. Slutbeskeden indeholder en liste med 1 eller flere ID, der opfylder søgekriteriet. Kan bruges til at opbygge en liste eller finde et bestemt objekt. Processen kan danne en liste på basis af en besked med 1 eller flere ID, som skal bruges. Slutbeskeden indeholder et tilsvarende antal læs beskeder. Bruges til at vise detaljer i et søgeresultat. Processen kan berige en dokument besked med relation til klassifikation med et klassifikationsobjekt på grundlag af et søgekriterium, der opbygges af beskedens øvrige oplysninger. 8

9 Organisation MOX proces Replikerer aktør Læser aktør Vedligeholder aktør Søger aktør Lister aktør Tilføjer aktør Processen replikerer (kopierer) objekter på basis af en registreringsbesked, som den skal abonnere på. Bruges til distribution af aktører mellem forskellige systemer, der har brug for organisationsoplysninger. Aktør er en samlebetegnelse for Organisation, OrgEnhed, OrgFunktion, Interessefællesskab, Bruger, it-system. Processen læser detaljer om objektet på basis af objektid og leverer disse i en besked. Den kan bruges, når man skal vise oplysninger om de objekter, som et givet objekt relaterer til (blå objekter). Processen er manuel og ender med en registrering i en service. Vedligeholder omfatter operationerne opret, ret, slet, importer, passiver tilsammen de operationer der danner en registrering. Aktør er en samlebetegnelse for objekter i en organisationsservice. Processen bruges til at opdaterer organisationen og det kan foregå på flere lokationer uafhængig af hinanden. Processen søger efter en organisationsaktør typisk på grundlag af klassifikationsobjekt. Slutbeskeden indeholder en liste med 1 eller flere ID, der opfylder søgekriteriet. Kan bruges til at opbygge en liste eller finde et bestemt objekt. Processen kan danne en liste på basis af en besked med 1 eller flere ID, som skal bruges. Slutbeskeden indeholder et tilsvarende antal læs beskeder. Bruges til at vise detaljer i et søgeresultat. Processen kan berige en dokument besked eller en sag besked med relation til organisationsaktør med ID og objekttype for en aktør på grundlag af et søgekriterium, der opbygges af beskedens øvrige oplysninger. 9

10 Dokument 2 MOX proces Replikerer dokument Læser dokument Vedligeholder dokument Søger dokument Lister dokument Præjournaliserer dokument Sender dokument Processen replikerer (kopierer) objekter på basis af en registreringsbesked, som den skal abonnere på. Det er alene dokumentmetadata, der replikeres fra en dokumentservice til en anden. Selve dokumentet kan sendes og modtages med andre processer. Processen læser detaljer om objektet på basis af objektid og leverer disse i en besked. Den kan bruges, når man skal vise oplysninger om de objekter, som et givet objekt relaterer til. Processen er manuel og ender med en registrering i en service. Vedligeholder omfatter operationerne opret, ret, slet, importer, passiver tilsammen de operationer der danner en registrering. Det vil typisk være en manuel proces, der starter et automatisk forløb. Processen kan fremfinde objekter på grundlag af søgekriterier herunder brugervendt nøgle, tilstand, attributter og relationer. Slutbeskeden indeholder en liste med 1 eller flere ID, der opfylder søgekriteriet. Kan bruges til at opbygge en liste eller finde et bestemt objekt. Processen kan danne en liste på basis af en besked med 1 eller flere ID, som skal bruges. Slutbeskeden indeholder et tilsvarende antal læs beskeder. Kan f.eks. give detaljer om de dokumenter, der er journaliseret på en sag. Processen undersøger, om dokumentmetadata er tilstrækkelige til at journalisere et dokument til en sag. Den vil anvende en eller flere regler. Den gør ikke noget selv, men udsteder en besked, som en agent kan abonnere på, hvis den kan tilføje den manglende oplysning. Processen sender dokument til en part eller aktør, som er registreret som modtager i dokumentets metadata. Det er typisk via digital post men kan også implementeres på andre kanaler som mail 2 Standardprocesserne for Dokument indeholder alle operationerne fra standarden Dokument, og er altså ikke identisk med KOMBIT s scope dokumentet for Dokumentindeks, der kun anvender LIST funktionen. 10

11 MOX proces Modtager dokument Indsender dokument eller portaler. Processen modtager et dokument og registrerer det. Den anvendes i naturlig følge efter sender dokument eller indsender dokument. Processen er den brugerstyrede pendant til sender dokument. 11

12 Sag 3 MOX proces Læser sag Processen læser detaljer om objektet på basis af objektid og leverer disse i en besked. Den kan bruges, når man skal vise oplysninger om de objekter, som et givet objekt relaterer til (blå objekter). 3 Standardprocesserne for Sag indeholder alle operationerne fra standarden Sag, og er altså ikke identisk med KOMBIT s scope dokumentet for Sagsindeks, der kun anvender LIST funktionen. 12

13 MOX proces Vedligeholder sag Søger sag Lister sag Opretter sag Tilføjer sag Sender sag Modtager sag Danner journalnotat Registrerer journalnotat Journaliserer dokument Tilknytter sagspart Processen er manuel og ender med en registrering i en service. Vedligeholder sag omfatter operationerne opret, ret, slet, importer, passiver tilsammen de operationer, der danner en registrering. Bruges til manuel vedligeholdelse af en sag. Processen søger efter en organisationsaktør typisk på grundlag af klassifikationsobjekt. Slutbeskeden indeholder en liste med 1 eller flere ID, der opfylder søgekriteriet. Kan bruges til at opbygge en liste eller finde et bestemt objekt. Den kan både være brugerstyret og derefter automatisk. Dermed kan søgning foregå i et system og gennemføres i et andet. Processen kan danne en liste på basis af en besked med 1 eller flere ID som skal bruges. Slutbeskeden indeholder et tilsvarende antal læs beskeder. Bruges til at vise detaljer i et søgeresultat. Processen opretter en sag automatisk. Den skal have mange metadata og evt. regel for sagsdannelse for at gennemføres. Disse metadata vil typisk fremgå af metadata for det dokument, der skal journaliseres på sagen. (se Journaliserer dokument). Processen kan tilknytte en sag som relation til et dokument. Processen sender en sag til en part eller aktør, som er registreret som modtager i dokumentets metadata. Det er typisk via Digital Post men kan også implementeres på andre kanaler som mail eller portaler. Processen modtager og registrerer en sag, som er sendt (se sender sag). Processen er blot medtaget for at vise, at et journalnotat kan dannes i en applikation og danne den besked, der vil gå til det system, der holder journalnotat for sagen. Applikationen kan være automatisk således at journalnotatet dannes automatisk. Det vil f.eks. være et fagsystem, der skriver i en bestemt sags journal. Processen registrerer journalnotater på sagen. Kan bruges efter den manuelle proces Danner journalnotat, men også af et fagsystem, der kan danne beskeden Journalnotat dannet. Processen knytter et dokument til en sag. Hvis dokumentet ikke kan journaliseres, vil der udstedes en besked herom. Den vil typisk abonnere på dokumenter, der er præjournaliseret. Processen kan tilknytte en person som relation til sag altså en sagspart. 13

14 Beskedfordeler MOX proces Replikerer abonnement Læser abonnement Processen replikerer (kopierer) objekter på basis af en registreringsbesked, som den skal abonnere på. Et abonnement bruges af en beskedfordeler, og med replikering kan de samarbejde om håndtering af beskeder. Processen læser detaljer om objektet på basis af objektid og leverer disse i en besked. Den kan bruges, når man skal vise oplysninger om de objekter, som et givet objekt relaterer til (blå objekter). 14

15 MOX proces Vedligeholder abonnement Søger abonnement Lister abonnement Tegner abonnement Opsiger abonnement Replikerer besked Læser besked Søger besked Lister besked Sender besked Processen er manuel og ender med en registrering i en service. Vedligeholder omfatter operationerne opret, ret, slet, importer, passiver tilsammen de operationer der danner en registrering. Det vil typisk være en manuel proces, der starter et automatisk forløb. Vedligeholdelse af abonnement kan bruges til, at en bruger lægger sine ønsker til advisering ind i beskedfordeleren. Processen kan fremfinde objekter på grundlag af søgekriterier herunder brugervendt nøgle, tilstand, attributter og relationer. Slutbeskeden indeholder en liste med 1 eller flere ID, der opfylder søgekriteriet. Kan bruges til at opbygge en liste eller finde et bestemt objekt. Processen kan danne en liste på basis af en besked med 1 eller flere ID, som skal bruges. Slutbeskeden indeholder et tilsvarende antal læs beskeder. En delproces skal udstede en Abonnement-besked til den beskedfordeler, som den ønsker at modtage beskeder fra. Abonnementbeskeden indeholder et søgeudtryk (filter) vedrørende objekttype, som den skal bruge. (Se sender besked). En delproces som opsiger et abonnement på basis af en besked fra en anden delproces. (Se Tegner abonnement). Processen replikerer (kopierer) objekter på basis af en registreringsbesked, som den skal abonnere på. Beskeden kan tilgå de beskedfordelere, som har tegnet abonnement herpå. Processen læser detaljer om objektet på basis af objektid og leverer disse i en besked. Den kan bruges, når man skal vise oplysninger om de objekter, som et givet objekt relaterer til (blå objekter). Processen kan fremfinde objekter på grundlag af søgekriterier herunder brugervendt nøgle, tilstand, attributter og relationer. Slutbeskeden indeholder en liste med 1 eller flere ID, der opfylder søgekriteriet. Kan bruges til at opbygge en liste eller finde et bestemt objekt. Processen kan fremfinde objekter på grundlag af søgekriterier herunder brugervendt nøgle, tilstand, attributter og relationer. Slutbeskeden indeholder en liste med 1 eller flere ID, der opfylder søgekriteriet. Kan bruges til at opbygge en liste eller finde et bestemt objekt. Processen sender en besked, når den er dannet. Når den påbegynder sin opgave, sender den første gang en besked Abonnement tegnet til en beskedfordeler. Det gør den på vegne af modtager besked (Se denne). Erindrer besked Annullerer erindring Modtager besked Behandler besked Processen sætter en besked i erindring til et senere tidspunkt. Bruges til at sætte et objekt i erindring så beskeden vender tilbage til den aktør, som har udsat beskeden. Processen annullerer en erindring. Processen modtager en besked fra en beskedfordeler eller anden service. Den vil typisk sikre sekvens og give garanti for, at beskeden leveres. Beskeder kan kun modtages på basis af abonnement (Se Tegner abonnement). Processen behandler besked afprøver abonnementer på den aktuelle besked. 15

16 MOX byggeblokke En byggeblok indeholder en eller flere standardiserede MOX processer, der arbejder sammen med et it-system. Processen igangsættes af en standardiseret MOX besked og afsluttes med en MOX besked. De it-systemer, som den monteres på kan være forskellige. Byggeblokke skal opbygges med kode, der kan sende og modtage beskeder. Vi forestiller os, at byggeblokkene vil indeholde en mq-klient, så en it-system leverandør umiddelbart vil kunne indlejre noget kode, der kan bruges til at kalde deres interface. Denne del af projektet vil blive behandlet i efterårets arbejde. 16

17 Hver byggeklods vil blive beskrevet med følgende skabelon (ABB arkitekturbyggeblokke): Navn Begrundelse (A) Replikerer Klasseobjekt Et objekt fra standarden Klassifikation distribueres med en besked og opdateres i en lokal kopi (replika). Man modtager de objekter, som ens abonnement (filter) udtrykker. Mange løsninger indeholder klassifikationsoplysninger, og det kan koste tid at holde disse ajour. Business drivers Forretningsproces Forretningsobjekter Procesbeskrivelse Forretningsregler KPI Arkitekturbyggeblok (ABB) Startbesked Slutbesked Undtagelse Muligheder (D2) Teknologi Forandring Implementering Leverandører Klasseobjekt er betegnelse for de forretningsobjekter, som indgår i standarden klassifikation: Klassifikation, facet og klasse. Det er et enkelt objekt der distribueres og det kan registreres uafhængig af andre objekter. Objektet kan være nyt i den pågældende installation, eller der kan være ændringer til et eksisterende. Processen skal gennemføre en registrering med de operationer, der findes i standarden: Import, ret, slet, passiver. Start og slutbetingelser, undtagelser Key performance indikatorer skal angives her. (Se illustration) Informationsindhold OIOXML: Informationsindhold OIOXML: Informationsindhold OIOXML: Her kan beskrives, hvilke muligheder en implementering giver. Faktisk implementering eller ønsker til den. 17