Specifikation. Attentionformat. 19. september 2012 DAVAR J.nr

Transkript

1 Specifikation 19. september 2012 DAVAR J.nr Attentionformat Versionshistorik Version Dato Initialer Noter DAVAR Udkast efter høring Formål Formålet med dette dokument er at beskrive et format for udveksling af attentionsoplysninger til meddelelser. Formatet hedder attentionformat. Anvendelse Se generelle egenskaber for meddelelsesformaterne for definition af meddelelse og meddelelsers metadata. De generelle egenskaber beskriver også, hvordan attentionformatet håndteres i digital post-løsningen. Attentionformat kan bruges til at overføre oplysninger, der hjælper den modtagende organisation med at fordele meddelelser inden for organisationen. Attentionsoplysninger er således noget den afsendende organisation angiver i meddelelsen som den modtagende organisation kan bruge. plysningerne i attentionformatet er en mulighed, den afsendende organisation har for, at pege på et område i den modtagende organisation. Attentionsoplysninger er det digitale modsvar til att. angivelsen i den fysiske verden. Det er frivilligt for både den afsendende og den modtagende organisation at bruge attentionformatet og specialiseret brug af formatet vil ske efter bilateral aftale. Attentionformatet indeholder strukturerede metadata, attentionfelter, med mulighed for at angive en adresse, et personnavn, en organisatorisk enhed, et p-nummer, en FRM-kode og en sekundær klassifikationskode. Attentionformatet indeholder også mulighed for at angive værdier i en objektnøgle/-værdi-tabel. Tabellen giver mulighed for struktureret udvidelse af formatet, hvorved angivelse af specifikke metadata i konkret sammenhæng understøttes. Det kan fx være, at attentionformatet kan understøtte et bestemt måde at samarbejde på for en gruppe af organisationer, eller det kan fx være en myndighed, der ønske at angive, hvad en meddelelse specifikt vedrører i kommunikationen til virksomheder. Attentionformatet er en XML-fil, attention.xml, der kan vedlægges meddelelser.

2 Teknisk beskrivelse Versionering XML skemadefinitionerne versioneres i filnavnet og i namespacet. Herunder er angivet versionshistorikken for de XML skemaer, der hører til specifikationen: Attentionformat Version Dato Filnavn og namespace Aktuel AttentionFormat0.9.0.xsd xmlns:dpmf="urn:digst:meddelelsesformater:0.9.0" Ja bjektnøgle/-attribut/-værdi par Se sagdokumnetformatet for yderligere overvejelser om, hvordan objektnøgle/- værdi tabellen skal forstås. I attentionformatet bruges objektsamlingen til at udvide formatet. Det strukturerede oplysninger repræsenteret i attentionfelter har meget generel karakter. I mange sammenhænge vil det være relevant at inkludere yderligere informationer, der specificerer den afsendende organisation forventer at meddelelsen skal behandles i den modtagende organisation. For overordnede enheder kan dette også bruges som en mulighed for at angive, hvad meddelelsesn drejer sig om. Se bilag 1 for et eksempel på, hvordan objektsamlingen kan bruges. Brug af attentionformatet til inputhåndtering Attentionformatet er designet til at kunne persisteres i en database tabel. Alle data i formatet bør derfor kunne oprettes i en tabel med de tre kolonner, svarende til objektnøgle, objektattribut og objektværdi. Af samme grund er alle elementer i attentionformatet begrænsede. Det største felt er AddressIdentifier på op til 256 tegn. En hel generel måde at bruge attentionformatet til inputhåndtering er derfor at opstille en række regler på formen: Hvis [nøgle] og [attribut] er lig [værdi] så placer meddelelsen i denne [kategori] På den måde kan specificeres en række regler, der tilsammen udgør organisationens inputhåndtering på baggrund af attentionformatet. I tillæg hertil kan der opstilles regler for inputhåndtering på baggrund af kanaldata (afsender, modtager, meddelelsestitel, se generelle egenskaber) og sagdokumentformatet (beskrivelse af dokumentet, sagsreferencer og sagsgenstand, se specifikationen for sagdokumentformatet).

3 Beskrivelse af formatet Strukturen i attentionformatet ser således ud: I tabellen herunder angiver M at et element er obligatorisk(mandatory) og at et element er firvilligt (optional). Tabel 1: Beskrivelse af Attentionformat mråde/felt Type M/ Beskrivelse AttentionFormat Attentionfelter (0) AddressIdentifier AddressIdentifierType p til 256 tegn adresse PersonName PersonNameType p til 130 tegn En persons fulde navn som en enkelt tekststreng. rganisatoriskenhednavn rganisatoriskenhed- NavnType p til 50 tegn Navn på en organisatorisk enhed ProductionUnitIdentifier ProductionUnitIdentifierType 10 tegn P-nummer unik id for produktionsenheder inden for virksomheden. PrimaerKlasseIdentifikator KlasseBrugervendt- NoegleType p til 100 tegn Til angivelse af en FRM-kode som en brugervendt nøgle (dvs. på formen xx.xx.xx.xx) SekundærKlasseIdentifikator KlasseBrugervendt- NoegleType p til 100 tegn AttentionbjektSamling () Til angivelse af en anden klassifikationskode, fx et KLE-nummer. Angives som den brugervendte nøgle. bjekt bjekttype (0-50) Til angivelser af yderligere identer, der kan bruges til den modtagende myndigheds inputhåndtering, og placering af meddelelsen.

4 Tabel 2: Beskrivelse af bjekt (bjektsamling) mråde/felt Type M/ Beskrivelse bjekt bjektnoeglekode p til 50 tegn M Nøgle, der referer til objektets definition og format. Denne definition kan etableres i en bilateral aftale eller i en autoritativ liste. bjektattributkode p til 50 tegn Attribut, der kan bruges til forretningsmæssig opmærkning af objektet. bjektvaerditekst p til 100 tegn M bjektets referenceværdi.

5 Bilag 1: Definition af objektnøgler og attributter til MeddelelseAttention For at understøtte brugen af attentionsoplysninger for meddelelser vil Digitaliseringsstyrelsen vedligeholde en list af de mest brugte nøgle- og attributdefinitioner. Myndigheder og virksomheder kan angive deres formater på den følgende form. Der vil blive etableret et forum på digitaliser.dk til udveksling og opsamling af disse nøgledefinitioner. Definition af nøglekoder og værdiformater I denne tabel defineres nøglekoder og formatet for de korresponderende værdier. NøgleKode Domæne Beskrivelse Format, længde, evt. mønster Definition af attributkoder I denne tabel defineres attributkoder, der knytter sig til specifikke nøglekoder. NøgleKode Domæne Beskrivelse Attributkoder