Intertween.*

Kunskapsobjekt: ett underlag att följa

Ett kunskapsobjekt ger ett avgränsat underlag en identitet och beskriver dess källa, sammanhang, ansvar och användningsvillkor. Underlaget kan vara ett dokument, en observation eller en metod som andra kan förstå och bygga vidare på.

Följ propositionen och dess belägg →

Filen berättar inte hela historien

Ett dokument innehåller information. För att förstå vad den betyder behöver vi också veta varifrån den kommer, vilka beslut den påverkat, vem som granskat den och hur den har använts. Kunskapsobjektet gör plats för dessa samband.

En riktlinje kan vara lätt att öppna men svår att använda. Vilket underlag bygger den på? Är det rätt version? Gäller den i samma situation? Vem ansvarar för att den är aktuell? Kunskapsobjektet knyter sådana uppgifter till det som riktlinjen beskriver.

I Intertweens modell får kunskapen en egen identitet. En PDF, en post i ett verksamhetssystem och en begränsad vy kan vara olika representationer av samma objekt. Källmaterialet kan ligga kvar där det förvaltas. Objektets beskrivning och hänvisningar hjälper oss att förstå vad vi har hittat.

Vad behöver följa med kunskapen?

Källa och belägg
Varifrån kommer uppgiften, och vilket underlag går att granska?
Sammanhang och relationer
Vilken fråga, plats eller situation gäller den? Vad bygger den på och vad hänger den ihop med?
Villkor och ansvar
Vem förvaltar underlaget? Vad får visas och användas, av vem och för vilket ändamål?
Version, granskning och osäkerhet
Vad har ändrats? Är uppgiften granskad, ifrågasatt eller ersatt? Vad vet vi ännu inte?

Kunskapsobjektet beskriver ett avgränsat underlag. Det relationella metadataregistret beskriver hur objekten hänger ihop. En koppling kan visa vilket underlag en bedömning bygger på eller vilken metod som har utvecklats ur den. Läs om relationerna och registret ↗

Samma rapport, olika behov

Ett kunskapsobjekt kan beskrivas på olika sätt för olika mottagare. Här visas ett separat, påhittat exempel. Det påverkar inte dokumentkedjan från riksdagen.

PÅHITTAT UNDERVISNINGSEXEMPEL

Samma kunskapsobjekt, olika vyer

Välj en exempelroll och ett ändamål. En annan fråga kan begränsa urvalet, men ger inga nya rättigheter. Knapparna byter bara en förberedd vy; de kontrollerar ingen verklig behörighet.

Rapport KO-024 och de kopplingar som visas i vald exempelvyOffentliga riktlinjer. Bilden visar inte om andra kopplingar finns.KO-024Offentliga riktlinjer

Allmänheten

KO-024 · Kommunens rapport · samma identitet i alla vyer

Offentlig sammanfattning

Kommunen undersöker hur skolskjutsbeslut kan bli mer likvärdiga.

Bara kopplingar som ingår i den valda exempelvyn visas. Vyn anger inte om andra, skyddade kopplingar finns.

I verkligheten måste ansvarig verksamhet pröva åtkomst och användning. Även metadata kan behöva skyddas. En roll eller ett valt ändamål räcker inte för att få tillgång.

KÄLLEXEMPEL · SPARAT UNDERLAG

Sju dokument som hänger ihop

En utredning leder till en proposition och vidare till en lag. Här går det att följa dokumenten som kunskapsobjekt och se hur de hänvisar till varandra. Källorna är öppna data från Sveriges riksdag.

Välj ett dokument för att se dess sparade metadata och kopplingar. Det fullständiga flödet i nästa del är byggt för proposition 2021/22:225.

Välj ett steg i kedjan

Proposition · 2021/22:225

Du granskar nu det sparade metadataexemplet för 2021/22:225.

Se dokumentets källa, metadata och relationer

proposition

Den offentliga sektorns tillgängliggörande av data

identity
urn:se:itwn-id:ko:EPPDNDXGFB2TFRXCVN6S89GEYE
Status
beslutad
Utfärdare
Infrastrukturdepartementet
Skapad
2022-04-07
Lokal referens
H903225

Relationer

härstammar från
använd i beslut

Anmärkning Hänvisar i klartext till SOU 2020:55 och diarienummer I2020/02346. Kedjan hittas genom att följa textens egna referenser.

Källan ligger kvar. Sammanhanget går att följa.
Jämför metadata med källans XML

Samma dokument, två representationer. XML hämtad 2026-09-26. Objektet är det tidigare sparade exemplet, inte en ny körning av wrappern. Originalfilen ändras inte. Exempelkoden läser motsvarande JSON-flöde; XML visar samma källpost.

Originalets metadata · H903225

Urval ur /dokumentstatus/dokument. Välj ett fält nedan för att följa mappningen.

<dokument>
  <dok_id>H903225</dok_id>
  <titel>Den offentliga sektorns tillgängliggörande av data </titel>
  <organ>Infrastrukturdepartementet</organ>
  <datum>2022-04-07 00:00:00</datum>
  <doktyp>prop</doktyp>
  <status>Klar</status>
</dokument>
Visa hela XML-filen

Vad gör wrappern?

XML · dok_idH903225
Objekt · localRefH903225

Källans identifierare bevaras.

Tillagt av exemplet: objektets identitet, relationsetiketter och kontext. Hänvisningar kan komma från strukturerade källfält eller sökning i dokumenttext; relationstypen är vår mappning.

Fråga det valda objektet

OBJEKTETS RÖST · SKRIPTAT EXEMPEL

Fråga objektet

Svar hämtade ur det valda objektets sparade metadata och relationer. Ingen AI eller livekontroll används.

Den offentliga sektorns tillgängliggörande av data

Registrerade källuppgifter

Utfärdare: Infrastrukturdepartementet. Registrerat dokumentdatum: 2022-04-07. Lokal referens: H903225.

Se källan bakom svaret

Exemplet visar hur ett gränssnitt kan förklara underlaget. Det skickar inga förfrågningar och registrerar inga nya händelser.

DOKUMENTETS FLÖDE

Från källa till mottagare

Ditt val i kedjan: 2021/22:225. Samma proposition följer med genom alla sex steg. Din valda mottagarvy behålls när du går framåt och bakåt.

Öppna genomgången: från källans XML till en mottagarvy

H903225 · HELA DOKUMENTET

Följ hela källposten genom flödet

Se exakt vad som bevaras, struktureras och lämnas vidare. Byt steg och mottagarvy utan att tappa källdokumentet.

Verklig källpost med valbara visningsregler. Reglerna är exempel och motsvarar inte riksdagens användningsvillkor. Alla uppgifter på den här sidan är offentliga. Maskeringen visar hur en begränsad vy kan se ut, men skyddar inte uppgifterna.

Läser hela källposten och verifierar originalfilen …

Samma underlag, en förändrad förståelse

En hänvisning kan finnas kvar även om vi ändrar vår bedömning av sambandet. Ett nytt belägg kan stärka ett samband. En invändning kan visa att sammanhang saknas. En rättelse kan göra att en metod behöver prövas igen.

Vi behöver skilja på vad källan innehåller, vad någon hävdar om den och vad som registrerades vid olika tidpunkter. Objektets identitet, en viss version och dess representationer är olika saker; att två representationer har samma identifierare bevisar inte att de är likvärdiga.

UNDERVISNINGSEXEMPEL · SIMULERADE HÄNDELSER

Alla objekt, datum och händelser är påhittade och inlagda i förväg. Ingen AI körs, inga noder utbyter information och inga åtkomstregler tillämpas.

Observation registreras

Objektet EX-OBS-01 beskriver en mätning från den 10 januari. Uppgifterna registreras den 12 januari.

Bedömning vid vald tidpunkt: Inget samband med metoden är ännu beskrivet.

Ursprungligt underlag

EX-OBS-01 · version 1

Observation: 10 januari. Registrering: 12 januari.

Originalet skrivs inte om av de senare stegen.

Uppgifter vid den valda tidpunkten

EX-OBS-01 · version 1

Ingen senare version är registrerad.

Att metoden behöver granskas betyder inte att den är felaktig.

Visa alla händelser i exemplet
  1. — Observation registreras

    Objektet EX-OBS-01 beskriver en mätning från den 10 januari. Uppgifterna registreras den 12 januari.

  2. — Koppling föreslås

    En granskare föreslår att observationen ger stöd åt metoden EX-METOD-01. I scenariot registreras både hänvisningen och vem som föreslog sambandet.

  3. — Sammanhang tillkommer

    En annan granskare påpekar att mätningen gäller en annan plats. Invändningen blir ett eget bidrag.

  4. — Källan rättas

    Förvaltaren beskriver en rättad mätning i version 2, giltig från den 19 januari. Ändringen registreras den 20 januari. Version 1 finns kvar som tidigare underlag i exemplet.

  5. — Metoden behöver omprövas

    Metodens hänvisning till version 1 visar vilket underlag den bygger på. Den ansvariga behöver bedöma om metoden ska ändras. Granskarens uppdrag har också upphört. Därför behöver man separat pröva granskarens behörighet och vilka personuppgifter som får visas.

Exemplet förklarar modellen. Fullständig hantering av historik och ändrade villkor över flera noder återstår att utveckla.

Utforska ett eget underlag ↗

Nästa person ska kunna bygga vidare

Tänk på en handläggare som har undersökt en fråga och dokumenterat sin bedömning. En kollega i en annan kommun hittar den. Med ett kunskapsobjekt är tanken att kollegan också ska kunna följa källorna, förstå de lokala förutsättningarna och se vad som behöver prövas på nytt.

Kollegans rättelse eller nya erfarenhet kan bli ett eget bidrag med en hänvisning till underlaget. På så sätt kan gemensamt lärande växa utan att alla bedömningar blir likadana. Bidraget, personens identitet och mandatet att fatta beslut är olika frågor. Vad som får visas kan ändras över tid.

Detta är ett tänkt användningsfall. Exemplen visar källor och kopplingar; fullständigt utbyte mellan noder och styrning av rättigheter över tid återstår att bygga och pröva.

FÖRDJUPNING

Undersök beläggen eller välj ett nytt exempel

Här finns fler sätt att undersöka belägg, förändringar och villkor. Undervisningsexemplen är separata och ändrar inte det valda dokumentet eller dess flöde.

Kunskapen kan leva vidare när villkoren ändras

Ett bidrag är det någon tillför: ett belägg, en rättelse eller en metod. Vem personen är, vilket uppdrag personen hade och vilka rättighetsanspråk som gäller är separata frågor. Att följa kunskapens ursprung behöver därför inte innebära att alla får se människorna bakom den.

Tänk på en granskare som tillför en rättelse och senare lämnar sitt uppdrag. Rättelsen kan fortfarande vara relevant. Behörigheten att göra nya ändringar upphör med uppdraget, och vilka personuppgifter som får visas behöver prövas separat. Att dölja namnet innebär varken garanterad anonymitet eller att ett giltigt rättighetsanspråk upphör.

Detta är ett tänkt fall för den föreslagna arkitekturen. Dokumentflödet ovan demonstrerar inte automatiserad livscykelstyrning eller kontroll av mandat och rättighetsanspråk. Läs de tekniska kraven ↗

Belägg i texten och ett separat exempel på behörighetsstyrda vyer

En separat genomgång: två belagda utdrag ur propositionen eller ett påhittat vattenlarm. Det är inte nästa steg i XML-flödet.

FÖLJ OBJEKTET

Från dokument till kunskapsobjekt

Se var innehållet finns, hur ett textställe kan belägga en relation och vad en annan nod får se. Objektets identitet är densamma även om mottagarna får olika vyer.

Källbelagt utdrag · fullständigt dokument hos Riksdagen · ingen nod körs här

H903225

Den offentliga sektorns tillgängliggörande av data

urn:se:itwn-id:ko:EPPDNDXGFB2TFRXCVN6S89GEYE

Se hela XML-posten och alla mottagarvyer i flödet ovan ↑

Den ursprungliga propositionen är en fullständig representation hos Riksdagen. Den äldre objektfilen på sajten innehåller metadata men ingen dokumenttext. Här visas endast ett märkt utdrag ur avsnitt 3.

Representationer

Fullständigt dokument
data.riksdagen.se/dokument/H903225 ↗sourceRef · text/html · contentHash: null
Lokalt utdrag
Två passager ur avsnitt 3. Ett redaktionellt urval, inte hela texten.

3 Ärendet och dess beredning · s. 14

Vald passage: Innovation genom information (SOU 2020:55)
Relation i det äldre manifestet: härstammar från → SOU 2020:55
Hur den hittades: document-text-pattern

Passagen belägger att utredningen eller remissvaren nämns. Relationsnamnet är en mappning i den tidigare demonstratorn och får inte förväxlas med ett ordagrant påstående från källan. Textankaret är knutet till den angivna källversionen; ingen bytehash har beräknats.

Den verkliga källan och den tidigare metadataposten är separata från den illustrerade representationen. Den syntetiska posten innehåller hela sitt eget påhittade dokument. Dess råa JSON är offentligt nedladdningsbar för insyn: maskeringen är en visuell protokollillustration, inte skydd för verkliga uppgifter. Ingen knapp gör en nätverksbegäran till en Intertween-nod.

Se hur en människa och två agenter får olika vyer ↗

Separat scenario: vad händer när en delad metod rättas?

FÖLJ FÖRÄNDRINGEN

När en delad metod ändras

Ett påhittat objekt delas som maskerad metod. Sedan rättas ett avsnitt. Följ vad mottagaren, en beroende Knowledger och händelsehistoriken behöver visa.

Förutbestämt protokollscenario. Inga noder eller behörighetskontroller körs och inga kvittenser signeras.

NOD A · LOKAL KÄLLA

Källobjekt @ 1

Den andra mätningen låg inom förväntat intervall. Orsaken till den första avläsningen är fortfarande osäker.

Representation
repr-complete-text-v1
Påstående
Uppföljningsmätningen låg inom intervallet
Status
Belagt från källversion 1

NOD B · MOTTAGARE

Tillåten vy

Ingen mottagen vy

KNOWLEDGER

Sammansatt kunskap

Jämför två möjliga manifest vars innehåll är låst. Välj vilken version som en referens till ett ingående objekt ska peka på. Källobjektet ändras inte.

Manifest
intw:knowledger:fictional-town:review-methods:pinned
Medlem
sourceObject@1
Version som referensen pekar på
sourceObject@1

Båda varianterna pekar ännu på version 1.

Vad registreras i historiken?

  1. observedsourceObject@1: source version 1 registered locally

Händelserna är förutbestämda. För att Relational Trace ska fungera och kända mottagare ska kunna följa förändringarna behövs noder, regler, informationsutbyte och verifierbara belägg.

Äldre underlag: propositionens manifest, kedjans relationer och kontroller

Manifestet, ordagrant

Så här ser propositionen ut som maskinläsbart JSON-objekt, direkt ur testverktygets utdata. Detta är det äldre metadataexemplet, inte det kompletta XML-paketet i dokumentets flöde.

{
  "itwnId": "urn:se:itwn-id:ko:EPPDNDXGFB2TFRXCVN6S89GEYE",
  "objectType": "proposition",
  "title": "Den offentliga sektorns tillgängliggörande av data",
  "issuer": "Infrastrukturdepartementet",
  "responsibleAuthority": "Infrastrukturdepartementet",
  "created": "2022-04-07",
  "registered": "2022-04-07",
  "status": "beslutad",
  "version": "1",
  "localReferences": [
    { "organisation": "Sveriges riksdag", "identifier": "H903225",
      "role": "dok_id" },
    { "organisation": "Regeringskansliet", "identifier": "2021/22:225",
      "role": "propositionsnummer" }
  ],
  "contentHash": null,
  "accessPolicy": "offentlig",
  "retentionStatus": "bevaras",
  "relations": [
    { "type": "tillhör",
      "target": "urn:se:itwn-id:sp:FTN9X03NM64TJRCXX4K562WZHH" },
    { "type": "tillhör",
      "target": "urn:se:itwn-id:ar:DR8299AH44YWFQXBTGXYY3EAB1" },
    { "type": "härstammar från",
      "target": "urn:se:itwn-id:ko:NA0NT01S0HFVRQZRD3JWRBNBRD" },
    { "type": "använd i beslut",
      "target": "urn:se:itwn-id:ar:9RN3VB8VMH66CNMY2P3794CH2Z" }
  ],
  "validationStatus": "asserted-by-source",
  "source": "https://data.riksdagen.se/dokumentstatus/H903225",
  "note": "Hänvisar i klartext till SOU 2020:55 och diarienummer I2020/02346."
}

Validera det äldre metadataexemplet →

Relationerna och vad de bygger på

För varje relation anges hur den har identifierats: i ett strukturerat fält, genom ett mönster i dokumenttexten eller genom ett redaktionellt beslut som vi har gjort.

Källans påståendeRelationVad relationen bygger på
bet. dokreferens [behandlar, prop]bygger påstructured-reference
bet. dokreferens [rskr]använd i beslutstructured-reference
prop. text: ”SOU 2020:55”härstammar fråndocument-text-pattern
prop. text: ”I2020/02346”använd i beslutdocument-text-pattern
SFS övergångsbest.: upphäver 2010:566ersätterdocument-text-pattern
gruppering under en samhällsprocesstillhörstructural
vårt beslut, inte källans påstående

Riksdagen använder inte begreppet samhällsprocess för den här gruppen av objekt. Grupperingen är vårt redaktionella beslut och märks som sådan.

Kontroller av den äldre kedjan

MåttResultat
Återskapade relationerPrecision 1,0, recall 1,0 och F1 1,0. Alla fem angivna relationer har återskapats. Inga relationer har hittats på.
Schemakonformitet105 objekt, 0 saknade obligatoriska fält, 0 trasiga referenser, alla identifierare unika
FacitFacit har tagits fram direkt ur API:ets rådata, oberoende av Mapper. Verktyget kontrolleras alltså mot ett separat underlag.
Relationsvokabulär8 av 10 använda; de två oanvända redovisas med skälet till att de saknas
Lokala identifierare100 % där källan publicerar en, 0 % där den inte gör det

Lokala identifierare som de offentliga källorna publicerar bevaras när objekten skapas. Om identifieraren saknas i källunderlaget kan verktyget inte återskapa den i efterhand.

Gå vidare

Läs vidare om ramverkets begrepp, den tekniska dokumentationen eller hur insikter kan utvecklas till metoder.