Digdir-logo
Dette dokumentet kan også lastes ned som PDF.
Innmelding av feil og mangler:
Dersom du finner feil eller mangler i dokumentet, ber vi om at dette meldes inn på GitHub Issues ⧉. Dersom du ikke allerede har bruker på GitHub kan du opprette bruker gratis.

Lisens: CC BY 4.0 ⧉
Status: under utarbeidelse
Versjon: v0.2
Publisert: under utarbeidelse
Oppdatert: 2026-03-12
Gjeldende versjon: <ingen>
Forrige versjon: <ingen>
Redaktørens utkast: https://informasjonsforvaltning.github.io/cccev-ap-no/
Veileder: <ingen>

Abstract in English

English speaking readers, you may click here to read what this specification is about and how you may read it.

This specification, CCCEV-AP-NO, is the Norwegian application profile of EUs Core Criterion and Core Evidence Vocabulary (CCCEV) ⧉. It specifies how to describe criteria and requirements in structured form, and how to make the descriptions available in machine-readable RDF-based formats.

This specification is primarily not meant to be used alone. It supplements the Norwegian specification for description of services and events, CPSV-AP-NO ⧉, which is the Norwegian application profile of EUs Core Public Service Vocabulary Application Profile (CPSV-AP) ⧉.

The specification is mainly in Norwegian. However, in Chap. 3 which requires a certain level of knowledge in RDF, the specification of the classes and properties is in both Norwegian and English. Norwegian extensions (compared to CCCEV) are also documented as "Note" to the class/property in concern.

1. Om spesifikasjonen

1.1. Formål

Formålet med spesifikasjonen er å legge til rette for en felles måte å beskrive krav og dokumentasjon på kravoppfyllelse som en del av f.eks. en tjenestebeskrivelse, og en felles måte å utveksle beskrivelsene.

Spesifikasjonen er i utgangspunktet ikke tenkt å brukes alene. Den er ment å brukes f.eks. sammen med Spesifikasjon for tjeneste- og hendelsesbeskrivelser (CPSV-AP-NO) ⧉, når det er behov for å beskrive, i strukturert og maskinlesbar form, krav og dokumentasjon på kravoppfyllelse til en tjeneste.

1.2. Omfang og avgrensing

Spesifikasjonen er basert på EUs Core Criterion and Core Evidence Vocabulary (CCCEV) ⧉. Ettersom EUs Core Public Service Vocabulary Application Profile (CPSV-AP) ⧉ bruker deler av CCCEV, baserer denne spesifikasjonen seg også på CPSV-AP sin måte å bruke CCCEV på.

Spesifikasjonen inneholder også engelske navn (English name) og beskrivelser (Usage note). Det gjøres oppmerksom på at ikke alle engelske navn eller beskrivelser er ordrette sitater fra EUs originale engelske tekster. Vi kan ha valgt en annen tekst til å formidle det samme budskapet på, med mindre vi eksplisitt sier at det er et avvik (dvs. også i meningsinnholdet).

Ettersom spesifikasjonen er basert på Resource Description Framework (RDF). ⧉, vil beskrivelsene i henhold til spesifikasjonen også være RDF-baserte og dermed maskinprosesserbare. Som støtte til teknisk implementering er det i spesifikasjonen også tatt med en del eksempler i RDF Turtle. Eksemplene i RDF Turtle er kun veiledende, de er ikke komplette og kan også mangle verdier til obligatoriske egenskaper.

1.3. Målgrupper

Spesifikasjonen har ikke sluttbrukere av tjenester som sin målgruppe, men

  • deg som skal beskrive kriterier og krav til din virksomhets tjenester

  • deg som søker etter og ønsker å gjenbruke / sette sammen tjenester fra andre virksomheter

  • deg som skal utvikle/tilpasse verktøystøtte for ovennevnte beskrivelser og/eller for tilgjengeliggjøring/utveksling av beskrivelsene

De påfølgende kapitlene er rettet mot ulike målgrupper:

1.4. Forvaltningsregime

Spesifikasjonen forvaltes av Digitaliseringsdirektoratet (Digdir) ⧉.

Digdir initierer arbeidet med nye versjoner av spesifikasjonen, og håndterer selv løpende mindre endringer. Ved behov for større endringer vil Digdir vurdere å sette sammen arbeidsgruppe med representanter fra relevante virksomheter, for utarbeidelse av forslag til den reviderte versjonen som sendes ut til bred kommentering før fastsetting.

1.5. Om kravnivåene i spesifikasjonen

Spesifikasjonen bruker ordene «obligatorisk» ("mandatory"), «anbefalt» ("recommended") og «valgfri» ("optional"). Disse er forklart i DCAT-AP-NO ⧉, og forklaringene gjentas ikke her.

2. Forenklet fremstilling av noen av kravene i CCCEV-AP-NO

Denne delen av spesifikasjonen er primært ment for den ikke-tekniske målgruppen.

Figur 1 viser en forenklet fremstilling av noen av kravene i CCCEV-AP-NO.

Forenklet diagram med noen av klassene i CCCEV-AP-NO, deres egenskaper og relasjoner til hverandre. Innholdet i diagrammet er forklart i teksten.
Figur 1. Forenklet fremstilling av noen av kravene i CCCEV-AP-NO

CCCEV-AP-NO kan brukes til å beskrive både krav og dokumentasjon på kravoppfyllelse:

  • Beskrivelse av krav i form av Kriterium, Informasjonskrav eller Begrensning:

    • Kriterium brukes til å oppgi betingelse(r) som må være oppfylt, f.eks. «Vilkår for å inngå ekteskap».

    • Informasjonskrav brukes til å oppgi data som forespøres og som skal dokumentere en eller flere fakta, eller som fører til kilden til slik dokumentasjon. Eksempel på et informasjonskrav kan være «Søkerens alder».

      • For å kunne i maskinlesbar form beskrive dataene som forespørres, brukes Informasjonskrav sammen med Informasjonsbegrep, f.eks. «Alder».

    • Begrensning brukes til å oppgi begrensning som gjelder for et informasjonsbegrep. For informasjonsbegrepet «Alder» kan en begrensning være «Søkeren må være minst 18 år gammel».

    • Se ellers kap. 4.1, “Når brukes Kriterium, Informasjonskrav, Informasjonsbegrep og Begrensning?” for mer forklaring på når Kriterium, Informasjonskrav eller Begrensning bør brukes.

  • Beskrivelse av dokumentasjon på kravoppfyllelse:

    • Dokumentasjon brukes til, i «runtime», å oppgi den faktiske dokumentasjonen som er fremlagt og brukt til å evaluere om et krav er oppfylt eller ikke. Dokumentasjon brukes med andre ord i et konkret saksbehandlingsøyemed, i f.eks. et saksbehandlings- eller arkiveringssystem. Eksempel på en faktisk dokumentasjon kan være «Uttrekk fra Folkeregisteret for Ola Nordmann».

    • Dokumentasjonstype og Dokumentasjonstypeliste brukes til, i «design-time», å oppgi typer dokumentasjon som skal fremlegges og som kan brukes til å evaluere om et krav er oppfylt eller ikke. Dokumentasjonstype og dokumentasjonstypeliste brukes med andre ord i forbindelse med beskrivelsen av f.eks. en tjeneste i en tjenestekatalog. Eksempel på en dokumentasjonstype kan være «Fødselsattest».

    • Se kap. 4.2, “Når brukes Dokumentasjon og Dokumentasjonstype/Dokumentasjonstypeliste?” for mer forklaring på når Dokumentasjon, Dokumentasjonstype og Dokumentasjonstypeliste bør brukes.

Se også kap. 4.3, “Å beskrive betingelser som skal oppfylles” og [Å-kytte-krav-til-regelverk] for illustrative eksempler på bruk av CCCEV-AP-NO.

Hvilke typer opplysninger som SKAL (obligatoriske), BØR (anbefalte) og KAN (valgfrie) tas med i en beskrivelse av et krav eller en dokumentasjon på kravoppfyllelse er nærmere spesifisert i det følgende i dette kapittelet. Hvordan opplysningene skal representeres teknisk i RDF (Resource Description Framework ⧉) er spesifisert i kap. 3, Krav til RDF-representasjon av klassene i CCCEV-AP-NO, som også innehlder flere klasser som kan brukes i tillegg til de som er vist i Figur 1, “Forenklet fremstilling av noen av kravene i CCCEV-AP-NO” og beskrevet i dette kapittelet.

2.1. Krav til beskrivelse av Kriterium, Informasjonskrav eller Begrensning?

For å sikre at Kriterium, Informasjonskrav og Begrensning blir beskrevet på en ensartet måte, inneholder tabellene typer opplysninger som SKAL (obligatoriske), BØR (anbefalte) eller KAN (valgfrie) tas med i beskrivelsene. I dette avsnittet brukes ordet «krav» som samlebetegnelse for alle tre typer krav: Kriterium, Informasjonskrav og Begrensning.

Tabell 1. Obligatoriske opplysningstyper som en beskrivelse av Kriterium, Informasjonskrav eller Begrensning SKAL inneholde
Obligatorisk Forklaring Ref. til kap. 3

identifikator

En unik identifikator, som regel opprettet automatisk av et system

3.1.1.2, 3.6.1.1, 3.8.1.1

navn

Navnet til kravet

3.1.1.3, 3.6.1.2, 3.8.1.2
Tabell 2. Anbefalte opplysningstyper som en beskrivelse av Kriterium, Informasjonskrav eller Begrensning BØR inneholde
Anbefalt Forklaring Ref. til kap. 3

beskrivelse

En tekstlig beskrivelse av kravet

3.1.2.1, 3.6.2.1, 3.8.2.1
Tabell 3. Valgfrie opplysningstyper som en beskrivelse av Kriterium, Informasjonskrav eller Begrensning KAN inneholde
Valgfri Forklaring Ref. til kap. 3

er subkrav av

Refererer til et eller flere andre krav som dette kravet er del av

3.1.3.1, 3.6.3.1, 3.8.3.2

er utledet fra

Refererer til et eller flere referanserammeverk som kravet er basert på, f.eks. lov, forskrift eller annen regulering

3.1.3.2, 3.6.3.2, 3.8.3.3

er utstedt av

Refererer til aktøren som har utstedt kravet

3.1.3.3, 3.6.3.3, 3.8.3.4

har dokumentasjonstypeliste

Refererer til en eller flere dokumentasjonstypelister som spesifiserer type(r) dokumentasjon som trengs for å tilfredsstille kravet

3.1.3.4, 3.6.3.4, 3.8.3.5

har kvalifisert relasjon til andre krav

En eller flere beskrevne/kategoriserte relasjoner til et eller flere andre krav

3.1.3.5, 3.6.3.6, 3.8.3.7

har mer spesifikt krav

Refererer til et eller flere mer spesifikke krav som er del av dette kravet

3.1.3.6, 3.6.3.7, 3.8.3.8

har understøttende dokumentasjon

Refererer til en eller flere konkrete dokumentasjoner som supplerer med informasjon, bevis eller understøtter kravet

3.1.3.7, 3.6.3.8, 3.8.3.9

innfrir regel

Refererer til en eller flere regler som kravet innfrir

3.1.3.8, 3.6.3.9, 3.8.3.10

type

Refererer til en eller flere kategorier kravet tilhører

3.1.3.9, 3.6.3.10, 3.8.3.11

har informasjonsbegrep

(Gjelder Kriterium eller Informasjonskrav) Refererer til et eller flere informasjonsbegreper som Informasjonskravet eller Kriteriet forventer en verdi av

3.6.3.5, 3.8.3.6

bias

(Gjelder kun for Kriterium) Oppgir parameteren som brukes til å justere evalueringen av Kriteriet

3.8.3.1

vekting

(Gjelder kun for Kriterium) Oppgir den relative viktigheten (vektingen) av Kriteriet

3.8.3.12

vektingstype

(Gjelder kun for Kriterium) Oppgir hvordan vektingen bør tolkes i et komplekst evalueringsuttrykk, f.eks. som en prosent i et evalueringsuttrykk

3.8.3.13

vektingsvurderingsbeskrivelse

(Gjelder kun for Kriterium) Oppgir en tekstlig forklaring på hvordan vektingen av Kriteriet brukes Kriteriet

3.8.3.14

2.2. Krav til beskrivelse av Informasjonsbegrep

For å sikre at Informasjonsbegrep blir beskrevet på en ensartet måte, inneholder tabellene typer opplysninger som SKAL (obligatoriske), BØR (anbefalte) eller KAN (valgfrie) tas med i beskrivelsene.

Tabell 4. Obligatoriske opplysningstyper som en beskrivelse av Informasjonsbegrep SKAL inneholde
Obligatorisk Forklaring Ref. til kap. 3

forventet datatype

Angir den forventede datatypen for verdien til informasjonsbegrepet (f.eks. heltall, dato eller kode)

3.5.1.1
Tabell 5. Anbefalte opplysningstyper som en beskrivelse av Informasjonsbegrep BØR inneholde
Anbefalt Forklaring Ref. til kap. 3

beskrivelse

En tekstlig beskrivelse av informasjonsbegrepet

3.5.2.1
Tabell 6. Valgfrie opplysningstyper som en beskrivelse av Informasjonsbegrep KAN inneholde
Valgfri Forklaring Ref. til kap. 3

identifikator

En unik identifikator, som regel opprettet automatisk av et system

3.5.3.1

navn

Navnet til informasjonsbegrepet

3.5.3.2

type

Kategorien informasjonsbegrepet tilhører

3.5.3.3

2.3. Krav til beskrivelse av Dokumentasjon

For å sikre at Dokumentasjon blir beskrevet på en ensartet måte, inneholder tabellene typer opplysninger som SKAL (obligatoriske), BØR (anbefalte) eller KAN (valgfrie) tas med i beskrivelsene.

Tabell 7. Obligatoriske opplysningstyper som en beskrivelse av Dokumentasjon SKAL inneholde
Obligatorisk Forklaring Ref. til kap. 3

identifikator

En unik identifikator, som regel opprettet automatisk av et system

3.2.1.1

navn

Det offisielle navnet til dokumentasjonen

3.2.1.2
Tabell 8. Anbefalte opplysningstyper som en beskrivelse av Dokumentasjon BØR inneholde
Anbefalt Forklaring Ref. til kap. 3

beskrivelse

En tekstlig beskrivelse av dokumentasjonen

3.2.2.1

språk

Språket/Språkene dokumentasjonen er skrevet på

3.2.2.2
Tabell 9. Valgfrie opplysningstyper som en beskrivelse av Dokumentasjon KAN inneholde
Valgfri Forklaring Ref. til kap. 3

er del av

Refererer til et eller flere datasett som den aktuelle dokumentasjonen fysisk eller logisk er inkludert i

3.2.3.1

distributør

Oppgir aktøren som sender dokumentasjonen

3.2.3.2

gir understøttende opplysning

Refererer til en eller flere understøttende opplysninger i dokumentasjonen

3.2.3.3

gjelder

Oppgir aktøren som dokumentasjonen gjelder for

3.2.3.4

gyldighetsperiode

Angir tidsperioden hvor dokumentasjonen er gyldig

3.2.3.5

i samsvar med

Oppgir dokumentasjonstypen(e) som dokumentasjonen er i samsvar med

3.2.3.6

konfidensialitetsnivå

Oppgir dokumentasjonens sikkerhetsklassifisering, f.eks. klassifisert, sensitiv, offentlig

3.2.3.7

produsent

Oppgir aktøren som er produsent av dokumentasjonen

3.2.3.8

relatert informasjon

Refererer til mer informasjon om dokumentasjonen, f.eks. en bestemt mal til et administrativt dokument eller en applikasjon, eller en veiledning for hvordan man skal formatere dokumentasjonen

3.2.3.9

type

Refererer til begrepet som representerer typen dokumentasjonen tilhører

3.2.3.10

understøtter informasjonsbegrep

Refererer til et eller flere informasjonsbegrep som gir fakta funnet eller utledet fra dokumentasjonen

3.2.3.11

understøtter krav

Refererer til et eller flere krav som dokumentasjonen understøtter

3.2.3.12

utsteder

Oppgir aktøren som er juridisk ansvarlig for dokumentasjonen

3.2.3.13

2.4. Krav til beskrivelse av Dokumentasjonstype

For å sikre at Dokumentasjonstype blir beskrevet på en ensartet måte, inneholder tabellene typer opplysninger som SKAL (obligatoriske), BØR (anbefalte) eller KAN (valgfrie) tas med i beskrivelsene.

Tabell 10. Obligatoriske opplysningstyper som en beskrivelse av Dokumentasjonstype SKAL inneholde
Obligatorisk Forklaring Ref. til kap. 3

beskrivelse

En tekstlig beskrivelse av dokumentasjonstype

3.3.1.1

identifikator

En unik identifikator, som regel opprettet automatisk av et system

3.3.1.2

navn

Det offisielle navnet til dokumentasjonstype

3.3.1.3
Tabell 11. Anbefalte opplysningstyper som en beskrivelse av Dokumentasjonstype BØR inneholde
Anbefalt Forklaring Ref. til kap. 3

tillatt gyldighetsperiode

Tidsperioden som dokumentasjoner av denne dokumentasjonstypen skal være gyldig innenfor

3.3.2.1

tillatt språk

Språket/språkene som dokumentasjoner av denne dokumentasjonstypen kan være på

3.3.2.2
Tabell 12. Valgfrie opplysningstyper som en beskrivelse av Dokumentasjonstype KAN inneholde
Valgfri Forklaring Ref. til kap. 3

dokumentasjonstypekategori

Kategorien(e) som dokumentasjontypen tilhører

3.3.3.1

er beskrevet ved

Datasettet/datasettene som denne aktuelle type dokumentasjon kan være beskrevet ved.

3.3.3.2

er spesifisert i

Dokumentasjonstypelisten(e) som inneholder dokumentasjonstypen

3.3.3.3

relatert informasjon

Mer informasjon om den aktuelle type dokumentasjon

3.3.3.4

tillatt utstedelsessted

Utstedelsestedet/utstedelsestedene som er tillatt for den aktuelle type dokumentasjon

3.3.3.5

2.5. Krav til beskrivelse av Dokumentasjonstypeliste

For å sikre at Dokumentasjonstypeliste blir beskrevet på en ensartet måte, inneholder tabellene typer opplysninger som SKAL (obligatoriske), BØR (anbefalte) eller KAN (valgfrie) tas med i beskrivelsene.

Tabell 13. Obligatoriske opplysningstyper som en beskrivelse av Dokumentasjonstypeliste SKAL inneholde
Obligatorisk Forklaring Ref. til kap. 3

spesifiserer dokumentasjonstype

Oppgir dokumentasjonstypen(e) som er spesifisert av dokumentasjonstypelisten

3.4.1.1
Tabell 14. Anbefalte opplysningstyper som en beskrivelse av Dokumentasjonstypeliste BØR inneholde
Anbefalt Forklaring Ref. til kap. 3

beskrivelse

En tekstlig beskrivelse av dokumentasjonstypeliste

3.4.2.1

identifikator

En unik identifikator, som regel opprettet automatisk av et system

3.4.2.2

navn

Det offisielle navnet til dokumentasjonstypeliste

3.4.2.3

3. Krav til RDF-representasjon av klassene i CCCEV-AP-NO

Denne delen av spesifikasjonen er primært ment for den tekniske målgruppen og forutsetter kjennskap til RDF.

Figur 2 viser en visuell oversikt over klassene i CCCEV-AP-NO og relasjoner mellom dem. I figuren er klassene som er spesifisert i Spesifikasjon for tjeneste- og hendelsesbeskrivelser (CPSV-AP-NO) ⧉ og som blir referert til fra denne spesifikasjonen markert med grå bakgrunn.

UML-diagram med klassene som er i CCCEV-AP-NO og noen av relasjoner mellom dem. Innholdet i diagrammet er forklart i teksten.
Figur 2. Klassene i CCCEV-AP-NO

Figuren er ikke ment som en formell representasjon av spesifikasjonen. Før eventuell uoverensstemmelse mellom figuren og den tekstlige beskrivelsen blir rettet opp, har den tekstlige beskrivelsen forrang. Samme forrang gjelder også når det gjelder eventuelle uoverensstemmelser mellom tekstlige beskrivelser og figurer i resten av spesifikasjonen.

Klassene markert med grå bakgrunn i figuren er spesifisert andre steder: Datasett (dcat:Dataset) i DCAT-AP-NO ⧉; Regel (cpsv:Rule) og Aktør (foaf:Agent) i CPSV-AP-NO ⧉. Klassene med hvit bakgrunn er spesifisert videre i dette kapitlet. Klassene er sortert alfabetisk etter norske klassenavn, og egenskapene i hver klasse gruppert først inn i obligatoriske, anbefalte og valgfrie egenskaper, og der under alfabetisk etter norske egenskapsnavn.

Kravene i denne delen av spesifikasjonen spesifiserer hvordan beskrivelsene skal representeres i RDF. Hvert krav er spesifisert i en tabell som inneholder syntaks og forklaring. Radene i tabellene er beskrevet nedenfor. Noen tabeller har færre rader. Engelske navn og tekster som er tatt med i tabellene, er ikke alle nødvendigvis ordrette sitater fra engelske kilder. Vi kan ha valgt en annen engelsk tekst til å formidle det samme budskapet, med mindre vi eksplisitt sier at det er et avvik.

«Norsk utvidelse» i merknad er endringer som er gjort i denne spesifikasjonen sammenlignet med EUs CCCEV og måten CCCEV er brukt i EUs CPSV-AP. Der det ikke står noe om «norsk utvidelse» i merknad til en egenskap/klasse, er egenskapen/klassen brukt slik den er spesifisert i CCCEV og/eller brukt i CPSV-AP. Der det står «norsk utvidelse» i merknad til en egenskap, er kravet til egenskapen endret (f.eks. med forklaringen noe à la «Kravnivået er endret fra valgfri til anbefalt»), eller at egenskapen ikke er å finne i CCCEV/CPSV-AP (f.eks. med forklaring «Ikke eksplisitt spesifisert i CCCEV/CPSV-AP»).

Ledetekst i tabellen

Hensikt med raden i tabellen

English name

Brukes til å angi klasse- eller egenskapsnavn på engelsk, primært ment for engelsktalende utviklere av verktøystøtte.

URI

Brukes til å angi en unik identifikator til klassen eller egenskapen.

Det er dette som skal benyttes i RDF-basert utveksling/tilgjengeliggjøring av beskrivelser som er utformet i henhold til denne standarden.

Eksempel: skos:Concept er identifikatoren til klassen Begrep (Concept), slik klassen er spesifisert i skos (Vedlegg A – Navnerom som er brukt i spesifikasjonen viser hva skos står for).

Subklasse av / Subclass of

Denne brukes bare i spesifikasjon av en klasse, til å referere til klassen som den aktuelle klassen ev. er subklasse av.

Subegenskap av / Subproperty of

Denne brukes bare i spesifikasjon av en egenskap, til å referere til egenskapen som den aktuelle egenskapen ev. er subegenskap av.

Verdiområde / Range

Denne brukes bare i spesifikasjon av en egenskap, til å spesifisere lovlige verdier. Disse angis ved henvisning til en klasse eller datatype.

Eksempel: Verdiområde skos:Concept betyr at verdien til egenskapen skal være en instans av klassen skos:Concept.

Anvendelse / Usage note

Brukes til å forklare hva klassen eller egenskapen er ment å brukes til, i kontekst av denne standarden. Forklaringen er også skrevet på engelsk (Usage note, kursivert), primært ment for engelsktalende utviklere av verktøystøtte.

Multiplisitet / Multiplicity

Denne brukes bare i spesifikasjon av en egenskap, til å spesifisere minimum og maksimum antall verdier egenskapen SKAL/BØR/KAN ha.

Kravnivå / Requirement level

Denne brukes bare i spesifikasjon av en egenskap, til å spesifisere om egenskapen er obligatorisk, anbefalt eller valgfri. Se også kap. 1.5, “Om kravnivåene i spesifikasjonen”.

Merknad / Note

Brukes til merknader knyttet til bruk av klassen eller egenskapen, f.eks. restriksjoner hvis noen. Merknadene er også skrevet på engelsk (Note, kursivert), primært ment for engelsktalende utviklere av verktøystøtte.

Eksempel

Brukes til å gi eksempel på bruken av klassen/egenskapen, i prosatekst.

Eksempel i RDF Turtle, er tatt med under den aktuelle tabellen.

3.1. Klassen Begrensning (cv:Constraint)

UML-diagram med klassen Begrensning, dens egenskaper og dens relasjoner til sju andre klasser. Innholdet i diagrammet er forklart i teksten.
Figur 3. Klassen Begrensning (cv:Constraint) og klassene den refererer til

English name

Constraint

Anvendelse / Usage note

Klassen brukes til å representere begrensning som gjelder for et informasjonsbegrep.

Begrensninger er krav i seg selv siden de stiller forutsetninger som påvirker definisjonen, bruken og/eller oppfyllelsen av kravet. De representerer harde betingelser som minimums- eller maksimumsuttrykk som kan brukes til å evaluere opplysninger som for eksempel nødvendig alder, inntekt, involvering i aktiviteter osv.

This class represents the limitation applied to an Information Concept.

Constraints are requirements in themselves, since they impose prerequisites which influence the definition, use and/or fulfilment of the requirement. They represent hard conditions such as minimum or maximum expressions which can be used to evaluate pieces of information, the required age, income, involvement in activities, etc. An example from the eProcurement domain is a threshold as the minimum turnover required by the buying organisation to select the candidates. Note that CCCEV does not provide any specific guidance on when which kind of Requirement should be used. Users of this vocabulary should make decisions on this topic in their specific context.

URI

cv:Constraint

Subklasse av / Subclass of

cv:Requirement

Eksempel

Se under kap. 4.3, “Å beskrive betingelser som skal oppfylles”.

Eksempel i RDF Turtle: Se under 4.3, “Å beskrive betingelser som skal oppfylles”.

3.1.1. Obligatoriske egenskaper for klassen Begrensning

3.1.1.1. Begrensning – begrenser (cv:constrains)

English name

constrains

URI

cv:constrains

Verdiområde / Range

cv:InformationConcept

Anvendelse / Usage note

Egenskapen brukes til å referere til informasjonsbegrep som begrensningen gjelder for.

Informasjonsbegrep er et verktøy for å gjøre Krav mer maskinanvendbare; de lar deg gi flere detaljer om et Krav. På denne måten kan Begrensninger gjøres veldig presise. For eksempel vil Informasjonsbegrepet være alderen til en person og Begrensningen vil være den nødvendige alderen i sammenheng med en spesifikk evaluering.

This property refers to the Information Concept about which a Constraint expresses a limitation.

Information Concepts are tools to make Requirements more machine processable: they allow to provide more detail about a Requirement. This way, Constraints can be made very precise, namely the limit that must be achieved, is a limit on the value for the associated Information Concept. For example, the Information Concept would be the age of a person and the Constraint would be the required age in the context of a specific evaluation.

Multiplisitet / Multiplicity

1..1

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

Norsk utvidelse: Kravnivået endret fra valgfri til obligatorisk, og multiplisiteten fra 0..n til 1..1.

Norwegian extension: The requirement level changed from optional to mandatory, and the multiplicity from 0..n to 1..1.
3.1.1.2. Begrensning – identifikator (dct:identifier)

English name

identifier

URI

dct:identifier

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å oppgi identifikatoren til begrensningen.

This property represents an identifier for the Constraint.

Multiplisitet / Multiplicity

1..1

Kravnivå / Requirement level

Obligatorisk / Mandatory
3.1.1.3. Begrensning – navn (dct:title)

English name

name

URI

dct:title

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi navn til begrensningen. Egenskapen BØR gjentas når navnet er på flere språk.

This property represents the official Name of the Constraint. This property SHOULD be repeated when the name is in several languages.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

3.1.2. Anbefalte egenskaper for klassen Begrensning

3.1.2.1. Begrensning – beskrivelse (dct:description)

English name

description

URI

dct:description

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi beskrivelse av begrensningen. Egenskapen BØR gjentas når beskrivelsen er på flere språk.

This property represents a description of the Constraint. This property SHOULD be repeated when the description is in several languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

3.1.3. Valgfrie egenskaper for klassen Begrensning

3.1.3.1. Begrensning – er subkrav av (cv:isRequirementOf)

English name

is requirement of

URI

cv:isRequirementOf

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å referere til et annet krav som begrensningen er del av, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property is used to refer to an instansce of one of the subclasses of cv:Requirement, which the Constraint is a part of.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.1.3.2. Begrensning – er utledet fra (cv:isDerivedFrom)

English name

is derived from

URI

cv:isDerivedFrom

Verdiområde / Range

cv:ReferenceFramework

Anvendelse / Usage note

Egenskapen brukes til å referere til referanserammeverk som begrensningen er basert på, f.eks. lov, forskrift eller annen regulering.

This property refers to the Reference Framework on which the Constraint is based, such as a law or regulation.

Note that a Constraint can have several Reference Frameworks from which it is derived.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.1.3.3. Begrensning – er utstedt av (dct:publisher)

English name

is issued by

URI

dct:publisher

Verdiområde / Range

foaf:Agent ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til aktøren som har utstedt begrensningen.

This property refers to the Agent that has published the Constraint.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional
3.1.3.4. Begrensning – har dokumentasjonstypeliste (cv:hasEvidenceTypeList)

English name

has evidence type list

URI

cv:hasEvidenceTypeList

Verdiområde / Range

cv:EvidenceTypeList

Anvendelse / Usage note

Egenskapen brukes til å referere til dokumentasjonstypeliste som spesifiserer type dokumentasjon som trengs for å tilfredsstille begrensningen.

This property is used to refer to the Evidence Type List that specifies the type of evidence that are needed to meet the Constraint.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.1.3.5. Begrensning – har kvalifisert relasjon til andre krav (cv:hasQualifiedRelation)

English name

has qualified relation

URI

cv:hasQualifiedRelation

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å representere en beskrevet/kategorisert relasjon til et annet krav, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property represents a described and/or categorised relation to an instance of one of the subclasses of cv:Requirement.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.1.3.6. Begrensning – har mer spesifikt krav (cv:hasRequirement)

English name

has requirement

URI

cv:hasRequirement

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å referere til et mer spesifikt krav som er en del av begrensningen, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property is used to refer to a more specific Requirement that is part of the Constraint.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.1.3.7. Begrensning – har understøttende dokumentasjon (cv:hasSupportingEvidence)

English name

has supporting evidence

URI

cv:hasSupportingEvidence

Verdiområde / Range

cv:Evidence

Anvendelse / Usage note

Egenskapen brukes til å referere til en konkret dokumentasjon som supplerer med informasjon, bevis eller understøtter begrensningen.

This property refers to a concrete piece of evidence that supplies information, proof or support for the constraint.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.1.3.8. Begrensning – innfrir regel (cv:fulfils)

English name

fulfils

URI

cv:fulfils

Verdiområde / Range

cpsv:Rule ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til regel som begrensningen innfrir.

This property refers to the rules that the Constraint fulfils.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.1.3.9. Begrensning – type (dct:type)

English name

type

URI

dct:type

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å referere til kategorien begrensningen tilhører.

This property refers to the category to which the Constraint belongs.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

3.2. Klassen Dokumentasjon (cv:Evidence)

UML-diagram med klassen Dokumentasjon, dens egenskaper og dens relasjoner til seks andre klasser. Innholdet i diagrammet er forklart i teksten.
Figur 4. Klassen Dokumentasjon (cv:Evidence) og klassene den refererer til

English name

Evidence

Anvendelse / Usage note

Klassen brukes til å representere et konkret stykke dokumentasjon som brukes til å evaluere om et krav er oppfylt eller ikke. Dette er vanligvis administrative dokumenter eller utfylte analoge eller digitale skjemaer.

This class is used to represent the means to support responses to Criteria or to a concrete Information Requirement or to an Information Concept inside an Information Requirement. The proof described by an Evidence can [1] verify a claim (i.e. is it true that John is 25, yes/no), [2] prove a condition (i.e. is John 18+, yes/no), or [3] simply provide data (i.e. the age of a person, namely 25). The proof can be given through documents or extracts of base registries, independently from its structure, format or medium used to exchange it: a pdf document, a video, a recording, etc.

URI

cv:Evidence

Eksempel

Vandelsattest fra Politiet, for Ola Nordmann.

Eksempel i RDF Turtle:

<vandelsattestOlaNordmann> a cv:Evidence ; .

3.2.1. Obligatoriske egenskaper for klassen Dokumentasjon

3.2.1.1. Dokumentasjon – identifikator (dct:identifier)

English name

identifier

URI

dct:identifier

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å oppgi identifikatoren til dokumentasjonen.

This property represents an Identifier for the piece of Evidence.

Multiplisitet / Multiplicity

1..1

Kravnivå / Requirement level

Obligatorisk / Mandatory
3.2.1.2. Dokumentasjon – navn (dct:title)

English name

name

URI

dct:title

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi det offisielle navnet til dokumentasjonen. Egenskapen BØR gjentas når navnet finnes på flere språk.

This property represents the official Name of the piece of Evidence. This property SHOULD be repeated when the name is in parallel languages.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Eksempel

«Vandelsattest»

Eksempel i RDF Turtle:

<vandelsattestOlaNordmann> a cv:Evidence ;
   dct:title "Vandelsattest for Ola Nordmann"@nb ; .

3.2.2. Anbefalte egenskaper for klassen Dokumentasjon

3.2.2.1. Dokumentasjon – beskrivelse (dct:description)

English name

description

URI

dct:description

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi en tekstlig beskrivelse av dokumentasjonen. Egenskapen BØR gjentas når beskrivelsen finnes på flere språk.

This property represents a free text Description of the piece of Evidence. This property SHOULD be repeated when the description is in parallel languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Norsk utvidelse: Kravnivå endret fra valgfri til anbefalt.

Norwegian extension: Requirement level changed from optional to recommended.

Eksempel

«Vandelsattest utstedt av Politiet for Ola Nordmann»

Eksempel i RDF Turtle:

<vandelsattestOlaNordmann> a cv:Evidence ;
   dct:title "Vandelsattest for Ola Nordmann"@nb ;
   dct:description "Vandelsattest utstedt av Politiet for Ola Nordmann"@nb ; .
3.2.2.2. Dokumentasjon – språk (dct:language)

English name

language

URI

dct:language

Verdiområde / Range

dct:LinguisticSystem

Anvendelse / Usage note

Egenskapen brukes til å oppgi språk til dokumentasjonen.

This property indicates the language(s) of the piece of Evidence.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad 1 / Note 1

Norsk utvidelse: Verdien SKAL velges fra EUs kontrollerte vokabular Språk ⧉.

Norwegian extension: The value MUST be chosen from EU’s controlled vocabulary Language ⧉.

Merknad 2 / Note 2

Norsk utvidelse: Kravnivå endret fra valgfri til anbefalt.

Norwegian extension: Requirement level changed from optional to recommended.

Eksempel

Den aktuelle dokumentasjonen er på bokmål.

Eksempel i RDF Turtle:

<vandelsattestOlaNordmann> a cv:Evidence ;
   dct:language
      <https://publications.europa.eu/resource/authority/language/NOB>; # bokmål
   .

3.2.3. Valgfrie egenskaper for klassen Dokumentasjon

3.2.3.1. Dokumentasjon – er del av (dct:isPartOf)

English name

is part of

URI

dct:isPartOf

Verdiområde / Range

dcat:Dataset ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til et datasett som den aktuelle dokumentasjonen fysisk eller logisk er inkludert i.

This property is used to refer to a dataset in which the described evidence is physically or logically included.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.2.3.2. Dokumentasjon – distributør (cv:isProvidedBy)

English name

is provided by

URI

cv:isProvidedBy

Verdiområde / Range

foaf:Agent ⧉

Anvendelse / Usage note

Egenskapen brukes til å oppgi aktør som sender dokumentasjonen.

Aktøren som sender dokumentasjonen er vanligvis den som har utstedt dokumentasjonen, eller en tjenesteleverandør på vegne av utstederen.

This property represents the Agent that transmits the Evidence.

Agents transmitting the Evidence are usually the Agents that are issuing the Evidence or service providers acting on behalf of the Evidence issuing Agents such as software developer companies.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Multiplisiteten endret fra 0..n til 0..1.

Norwegian extension: The multiplicity is changed from 0..n to 0..1.
3.2.3.3. Dokumentasjon – gir understøttende opplysning (cv:supportsValue)

English name

supports value

URI

cv:supportsValue

Verdiområde / Range

cv:SupportedValue

Anvendelse / Usage note

Egenskapen brukes til å referere til understøttende opplysninger i dokumentasjonen.

This property represents Supported Value that the Evidence contains.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.2.3.4. Dokumentasjon – gjelder (dct:subject)

English name

is about

URI

dct:subject

Verdiområde / Range

foaf:Agent ⧉

Anvendelse / Usage note

Egenskapen brukes til å oppgi aktøren som dokumentasjonen gjelder for.

This property represents the Agent that is the subject in the provided Evidence.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Multiplisiteten endret fra 0..n til 0..1.

Norwegian extension: The multiplicity is changed from 0..n to 0..1.
3.2.3.5. Dokumentasjon – gyldighetsperiode (cv:validityPeriod)

English name

validity period

URI

cv:validityPeriod

Verdiområde / Range

time:ProperInterval ⧉

Anvendelse / Usage note

Egenskapen brukes til å angi en tidsperiode hvor dokumentasjonen er gyldig.

This property represents Period of Time during which the Evidence holds true or has force.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Multiplisiteten endret fra 0..n til 0..1.

Norwegian extension: The multiplicity is changed from 0..n to 0..1.
3.2.3.6. Dokumentasjon – i samsvar med (dct:conformsTo)

English name

is conformant to

URI

dct:conformsTo

Verdiområde / Range

cv:EvidenceType

Anvendelse / Usage note

Egenskapen brukes til å oppgi dokumentasjonstypen som dokumentasjonen er i samsvar med.

This property represents the Evidence Type that specifies characteristics of the Evidence.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.2.3.7. Dokumentasjon – konfidensialitetsnivå (cv:confidentialityLevelType)

English name

confidentiality level type

URI

cv:confidentialityLevelType

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å oppgi dokumentasjonens sikkerhetsklassifisering, f.eks. klassifisert, sensitiv, offentlig.

This property represents security classification assigned to an Evidence e.g. classified, sensitive, public.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Multiplisiteten endret fra 0..n til 0..1.

Norwegian extension: The multiplicity is changed from 0..n to 0..1.
3.2.3.8. Dokumentasjon – produsent (dct:creator)

English name

is created by

URI

dct:creator

Verdiområde / Range

foaf:Agent ⧉

Anvendelse / Usage note

Egenskapen brukes til å oppgi aktøren som er produsent av dokumentasjonen.

This property represents the Agent that produces the Evidence.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Multiplisiteten endret fra 0..n til 0..1.

Norwegian extension: The multiplicity is changed from 0..n to 0..1.
3.2.3.9. Dokumentasjon – relatert informasjon (foaf:page)

English name

related documentation

URI

foaf:page

Verdiområde / Range

foaf:Document

Anvendelse / Usage note

Egenskapen brukes til å referere til mer informasjon om dokumentasjonen, f.eks. en bestemt mal til et administrativt dokument eller en applikasjon, eller en veiledning for hvordan man skal formatere dokumentasjonen.

This property represents documentation that contains information related to the Evidence, for instance a particular template for an administrative document, an application or a guide on formatting the Input.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

Eksempel / Example

Et illustrativt eksempel: La oss si at dokumentasjonskravet er «Oppgi energimerket (A, B, …​, F, G)» til en bolig. I tillegg til å oppgi selve energimerket til boligen (f.eks. «B») som dokumentasjon, kan denne egenskapen brukes til å referere til energiattesten som gir forklaring til det oppgitte energimerket «B».

A concrete example is an energy audit report which provides more context to the evidence of a home energy efficiency score. The audit report is the related documentation while the energy score is the evidence.
3.2.3.10. Dokumentasjon – type (dct:type)

English name

type

URI

dct:type

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å referere til begrepet som representerer typen dokumentasjonen tilhører.

This property represents the type of Evidence as described in a controlled vocabulary.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Verdien SKAL velges fra kontrollerte vokabular Dokumentasjonstype ⧉, når verdien finnes på listen.

Norwegian extension: The value MUST be chosen from the controlled vocabulary Evidence type ⧉, when the value is in the vocabulary.

Eksempel

Dokumentasjonen til «vandelsattest» er av type «attest»

Eksempel i RDF Turtle:

<vandelsattestOlaNordmann> a cv:Evidence ;
   dct:title "Vandelsattest for Ola Nordmann"@nb ;
   dct:type <https://data.norge.no/vocabulary/evidence-type#attestation> ; # attest
   .
3.2.3.11. Dokumentasjon – understøtter informasjonsbegrep (cv:supportsConcept)

English name

supports concept

URI

cv:supportsConcept

Verdiområde / Range

cv:InformationConcept

Anvendelse / Usage note

Egenskapen brukes til å referere til informasjonsbegrep som gir fakta funnet eller utledet fra dokumentasjonen.

This property represents Information Concept providing facts found/inferred from the Evidence.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.2.3.12. Dokumentasjon – understøtter krav (cv:supportsRequirement)

English name

supports requirement

URI

cv:supportsRequirement

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å referere til krav som dokumentasjonen understøtter, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property is used to refer to the requirement that the evidence supports.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.2.3.13. Dokumentasjon – utsteder (dct:publisher)

English name

is issued by

URI

dct:publisher

Verdiområde / Range

foaf:Agent ⧉

Anvendelse / Usage note

Egenskapen brukes til å oppgi aktøren som er juridisk ansvarlig for dokumentasjonen.

This property represents the Agent legally responsible for the Evidence, e.g. a legal authority.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Multiplisiteten endret fra 0..n til 0..1.

Norwegian extension: The multiplicity is changed from 0..n to 0..1.

3.3. Klassen Dokumentasjonstype (cv:EvidenceType)

UML-diagram med klassen Dokumentasjonstype, dens egenskaper og dens relasjon til en annen klasse. Innholdet i diagrammet er forklart i teksten.
Figur 5. Klassen Dokumentasjonstype (cv:EvidenceType) og klassen den refererer til

English name

Evidence Type

Anvendelse / Usage note

Klassen brukes til å representere informasjon om ønskede eller påkrevde egenskaper til dokumentasjonen. F.eks. at det kreves en firmaattest som dokumentasjon for å oppfylle et krav, og at denne attesten må være gyldig (ikke eldre enn 6 måneder).

This class represents information about the characteristics of an Evidence. The Evidence Type and the characteristics it describes are not concrete individual responses to a Requirement (i.e. Evidence), but descriptions about the desired form, content, source and/or other characteristics that an actual response should have and provide.

URI

cv:EvidenceType

3.3.1. Obligatoriske egenskaper for klassen Dokumentasjonstype

3.3.1.1. Dokumentasjonstype – beskrivelse (dct:description)

English name

description

URI

dct:description

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi en tekstlig beskrivelse av den dokumentasjonstypen. Egenskapen BØR gjentas når beskrivelsen finnes på flere språk.

This property represents a free text Description of the Evidence type. This property SHOULD be repeated when the description is in parallel languages.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

Norsk utvidelse: Ikke eksplisitt spesifisert i CCCEV/CPSV-AP.

Norwegian extension: Not explicitly specified in CCCEV/CPSV-AP.

Eksempel

«Firmaattest utstedt av Brønnøysundregistrene»

Eksempel i RDF Turtle:

<firmaattest> a cv:EvidenceType ;
   dct:description "Firmaattest utstedt av Brønnøysundregistrene"@nb ; .
3.3.1.2. Dokumentasjonstype – identifikator (dct:identifier)

English name

identifier

URI

dct:identifier

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å oppgi identifikatoren til dokumentasjonstypen.

This property represents an unambiguous reference to the Evidence Type.

Multiplisitet / Multiplicity

1..1

Kravnivå / Requirement level

Obligatorisk / Mandatory

Eksempel i RDF Turtle:

<firmaattest> a cv:EvidenceType ;
   dct:identifier "https://example.org/evidence-types/company-registration-certificate"^^xsd:anyURI ; .
3.3.1.3. Dokumentasjonstype – navn (dct:title)

English name

name

URI

dct:title

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi navnet til dokumentasjonstypen. Egenskapen BØR gjentas når navnet finnes på flere språk.

This property represents the name of the Evidence Type. This property SHOULD be repeated when the name is in parallel languages.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

Norsk utvidelse: Ikke eksplisitt spesifisert i CCCEV/CPSV-AP.

Norwegian extension: Not explicitly specified in CCCEV/CPSV-AP.

Eksempel

«Firmaattest»

Eksempel i RDF Turtle:

<firmaattest> a cv:EvidenceType ;
   dct:title "Firmaattest"@nb ; .

3.3.2. Anbefalte egenskaper for klassen Dokumentasjonstype

3.3.2.1. Dokumentasjonstype – tillatt gyldighetsperiode (cccevno:acceptableValidityDuration)

English name

acceptable validity duration

URI

cccevno:acceptableValidityDuration

Verdiområde / Range

xsd:duration

Anvendelse / Usage note

Egenskapen brukes til å angi en tidsperiode som dokumentasjoner tilhørende denne dokumentasjonstypen skal være gyldig innenfor.

This property represents time duration within which the Evidences belonging to this Evidence Type must be valid.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Norsk utvidelse: Ikke eksplisitt spesifisert i CCCEV/CPSV-AP.

Norwegian extension: Not explicitly specified in CCCEV/CPSV-AP.

Eksempel

Ikke eldre enn 6 måneder.

Eksempel i RDF Turtle:

<påkrevdFirmaattest> a cccevno:RequiredEvidence ;
   cccevno:acceptableValidityDuration "P6M"^^xsd:duration ; . # 6 måneder
3.3.2.2. Dokumentasjonstype – tillatt språk (cccevno:acceptableLanguage)

English name

acceptable language

URI

cccevno:acceptableLanguage

Verdiområde / Range

dct:LinguisticSystem

Anvendelse / Usage note

Egenskapen brukes til å oppgi språk som dokumentasjoner tilhørende denne dokumentasjonstypen kan være på.

This property is used to specify the language(s) that the evidence must be written in.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad 1 / Note 1

Verdien SKAL velges fra EUs kontrollerte vokabular Språk ⧉.

The value MUST be chosen from EU’s controlled vocabulary Language ⧉.

Merknad 2 / Note 2

Norsk utvidelse: Ikke eksplisitt spesifisert i CCCEV/CPSV-AP.

Norwegian extension: Not explicitly specified in CCCEV/CPSV-AP.

Eksempel

Den påkrevd dokumentasjonen må være på norsk eller engelsk.

3.3.3. Valgfrie egenskaper for klassen Dokumentasjonstype

3.3.3.1. Dokumentasjonstype – dokumentasjonstypekategori (cv:evidenceTypeClassification)

English name

evidence type classification

URI

cv:evidenceTypeClassification

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å referere til kategorien som dokumentasjonstypen tilhører.

This property represents the category to which the Evidence Type belongs.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.3.3.2. Dokumentasjonstype – er beskrevet ved (cv:isDescribedAt)

English name

is described at

URI

cv:isDescribedAt

Verdiområde / Range

dcat:Dataset ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til datasett som dokumentasjoner tilhørende denne dokumentasjonstypen kan være beskrevet ved.

This property it used to refer to dataset where the given type of evidences may be described.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Ikke eksplisitt spesifisert i CCCEV/CPSV-AP.

Norwegian extension: Not explicitly specified in CCCEV/CPSV-AP.
3.3.3.3. Dokumentasjonstype – er spesifisert i (cv:isSpecifiedIn)

English name

is specified in

URI

cv:isSpecifiedIn

Verdiområde / Range

cv:EvidenceTypeList

Anvendelse / Usage note

Egenskapen brukes til å referere til en dokumentasjonstypeliste som inneholder dokumentasjonstypen.

This property represents the Evidence Type List in which the Evidence Type is included.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.3.3.4. Dokumentasjonstype – relatert informasjon (foaf:page)

English name

related documentation

URI

foaf:page

Verdiområde / Range

foaf:Document

Anvendelse / Usage note

Egenskapen brukes til å referere til mer informasjon om den aktuelle type dokumentasjon, f.eks. en bestemt mal til et administrativt dokument eller en applikasjon, eller en veiledning for hvordan man skal formatere dokumentasjonen.

This property is used to refer to more information related to the given type of evidences, for instance a particular template for an administrative document, an application or a guide on formatting the documentation.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Ikke eksplisitt spesifisert i CCCEV/CPSV-AP.

Norwegian extension: Not explicitly specified in CCCEV/CPSV-AP.
3.3.3.5. Dokumentasjonstype – tillatt utstedelsessted (cccevno:acceptableIssuingPlace)

English name

acceptable issuing place

URI

cccevno:acceptableIssuingPlace

Verdiområde / Range

dct:Location

Anvendelse / Usage note

Egenskapen brukes til å oppgi tillatt utstedelsessted for dokumentasjoner tilhørende denne dokumentasjonstypen, f.eks. Norge.

This property represents acceptable issuing places for an Evidence of this Evidence Type, e.g. Norway.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

Merknad 1 / Note 1

Norsk utvidelse: Verdien SKAL velges fra EUs kontrollerte vokabularer Continent ⧉, Countries and territories ⧉ eller Place ⧉, HVIS den finnes på listene; GeoNames ⧉ SKAL i andre tilfeller brukes.

Norwegian extension: The value MUST be chosen from EU’s controlled vocabularies Continent ⧉, Countries and territories ⧉ or Place ⧉, IF it is in one of the lists; if a particular location is not in one of the mentioned Named Authority Lists, GeoNames ⧉ URIs MUST be used.

Merknad 2 / Note 2

Norsk utvidelse: Ikke eksplisitt spesifisert i CCCEV/CPSV-AP.

Norwegian extension: Not explicitly specified in CCCEV/CPSV-AP.

3.4. Klassen Dokumentasjonstypeliste (cv:EvidenceTypeList)

UML-diagram med klassen Dokumentasjonstypeliste, dens egenskaper og dens relasjon til en annen klasse. Innholdet i diagrammet er forklart i teksten.
Figur 6. Klassen Dokumentasjonstypeliste (cv:EvidenceTypeList) og klassen den refererer til

English name

Evidence Type List

Anvendelse / Usage note

Klassen brukes til å representere en gruppe av dokumentasjonstyper som kreves for å oppfylle et krav.

Kravet om å være i samsvar med en dokumentasjonstypeliste er oppfylt hvis og bare hvis den aktuelle dokumentasjonen samsvarer med alle typer som listen inneholder. Det er med andre ord en AND betingelse mellom typene på en gitt dokumentasjonstypeliste, og en OR betingelse mellom ulike dokumentasjonstypelister.

This class represents a group of Evidence Types for conforming to a Requirement.

An Evidence Type List is satisfied, if and only if, for all included Evidence Types in this List, corresponding conformant Evidence(s) are supporting the Requirement having this List. The Evidence Type List describes thus an AND condition on the different Evidence Types within the list and an OR condition between two or more Evidence Type Lists. Combinations of alternative Lists can be provided for a respondent of a Requirement to choose amongst them.

URI

cv:EvidenceTypeList

3.4.1. Obligatoriske egenskaper for klassen Dokumentasjonstypeliste

3.4.1.1. Dokumentasjonstypeliste – spesifiserer dokumentasjonstype (cv:specifiesEvidenceType)

English name

specifies evidence type

URI

cv:specifiesEvidenceType

Verdiområde / Range

cv:EvidenceType ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til dokumentasjonstypene som inngår i dokumentasjonstypelisten.

This property represents Evidence Type included in this Evidence Type List.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

Norsk utvidelse: Kravnivået endret fra valgfri til obligatorisk, og multiplisiteten fra 0..n til 1..n.

Norwegian extension: The requirement level changed from optional to mandatory, and the multiplicity from 0..n to 1..n.

3.4.2. Anbefalte egenskaper for klassen Dokumentasjonstypeliste

3.4.2.1. Dokumentasjonstypeliste – beskrivelse (dct:description)

English name

description

URI

dct:description

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi en tekstlig beskrivelse av dokumentasjonstypelisten. F.eks. informasjon knyttet til bruk av listen eller annen tilleggsinformasjon. Egenskapen BØR gjentas når beskrivelsen finnes på flere språk.

This property represents a short explanation supporting the understanding of the Evidence Type List. The explanation can include information about the nature, attributes, uses or any other additional information about the Evidence Type List. The property SHOULD be repeated when the description is in parallel languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Norsk utvidelse: Kravnivået endret fra valgfri til anbefalt, og verdiområdet fra 'xsd:string' til 'rdf:langString'.

Norwegian extension: The requirement level changed from optional to recommended, and the range from 'xsd:string' to 'rdf:langString'.
3.4.2.2. Dokumentasjonstypeliste – identifikator (dct:identifier)

English name

identifier

URI

dct:identifier

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å oppgi identifikatoren til dokumentasjonstypelisten.

This property represents an unambiguous reference to the Evidence Type List.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Norsk utvidelse: Kravnivået endret fra valgfri til anbefalt.

Norwegian extension: The requirement level changed from optional to recommended.
3.4.2.3. Dokumentasjonstypeliste – navn (skos:prefLabel)

English name

name

URI

skos:prefLabel

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi navnet til dokumentasjonstypelisten. Egenskapen BØR gjentas når navnet finnes på flere språk.

This property represents the Name of the Evidence Type List. This property SHOULD be repeated when the name is in parallel languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Norsk utvidelse: Kravnivået endret fra valgfri til anbefalt, og verdiområdet fra 'xsd:string' til 'rdf:langString'.

Norwegian extension: The requirement level changed from optional to recommended, and the range from 'xsd:string' to 'rdf:langString'.

3.5. Klassen Informasjonsbegrep (cv:InformationConcept)

UML-diagram med klassen Informasjonsbegrep og dens egenskaper. Innholdet i diagrammet er forklart i teksten.
Figur 7. Klassen Informasjonsbegrep (cv:InformationConcept)

English name

Information Concept

Anvendelse / Usage note

Klassen brukes til å representere en del av informasjonen som dokumentasjonen gir eller som kravet trenger. Klassen tilbyr muligheten til å beskrive kravene konseptuelt og oppgitte fakta i dokumentasjon. Dette er et (første) skritt mot å tilrettelegge for vurderingen av kravene på en automatisert måte basert på dokumentasjonen som er gitt.

This class represents a piece of information that the Evidence provides or the Requirement needs. The Information Concept class offers the ability to describe conceptually the Requirements and provided facts in Evidences. This is a (first) step towards facilitating the assessment of the requirements in an automated way based on the Evidence provided.

URI

cv:InformationConcept

Eksempel

Se under kap. 4.3, “Å beskrive betingelser som skal oppfylles”.

Eksempel i RDF Turtle: Se under kap. 4.3, “Å beskrive betingelser som skal oppfylles”.

3.5.1. Obligatoriske egenskaper for klassen Informasjonsbegrep

3.5.1.1. Informasjonsbegrep – uttrykk av forventet datatype (cv:expressionOfExpectedValue)

English name

expression of expected value

URI

cv:expressionOfExpectedValue

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å oppgi forventet datatype for informasjonsbegrepet formulert i et formelt språk, som understøttende opplysninger må samsvare, f.eks. xsd:decimal (for «desimaltall»), xsd:date (for «dato») eller skos:Concept (for «kode»).

This property represents a formulation in a formal language of the expected datatype for the Information Concept which is aligned with the concepts from the Requirements defined and must be respected by the supplied Supported Values.

Multiplisitet / Multiplicity

1..1

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad 1 / Note 1

Norsk utvidelse: Kravnivået endret fra valgfri til obligatorisk, og multiplisiteten fra 0..n til 1..1.

Norwegian extension: The requirement level changed from optional to mandatory, and the multiplicity from 0..n to 1..1.

Merknad 2 / Note 2

Norsk utvidelse: Selv om CCCEV (foreløpig) forklarer at denne egenskapen også kan brukes til å oppgi nedre og øvre grenser for verdier (f.eks. «maksimum verdi er 1 million euro»), anbefales det i denne norske spesifikasjonen at denne egenskapen bare brukes til å oppgi forventet datatype (f.eks. «desimaltall (xsd:decimal)»). For å angi grenser for verdier anbefales det å bruke 3.1, “Klassen Begrensning (cv:Constraint)”.

Norwegian extension: Although CCCEV (currently) explains that this property can also be used to specify lower and upper bounderaries for values (e.g., "the maximum value is 1 Million Euro"), it is recommended in this Norwegian specification that this property is only used to specify the expected data type (e.g., "decimal numbers (xsd:decimal)"). To specify value bounderaries, it is recommended to use Constraint.

3.5.2. Anbefalte egenskaper for klassen Informasjonsbegrep

3.5.2.1. Informasjonsbegrep – beskrivelse (dct:description)

English name

description

URI

dct:description

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi en tekstlig beskrivelse av informasjonsbegrepet. F.eks. informasjon om begrepets art, egenskaper, bruk eller annen tilleggsinformasjon om begrepet. Egenskapen BØR gjentas når beskrivelsen finnes på flere språk.

This property represents a short explanation supporting the understanding of the Information Concept. The explanation can include information about the nature, attributes, uses or any other additional information about the Information Concept. This property SHOULD be repeated when the description is in parallel languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Norsk utvidelse: Kravnivået endret fra valgfri til anbefalt, og verdiområdet fra 'xsd:string' til 'rdf:langString'.

Norwegian extension: The requirement level changed from optional to recommended, and the range from 'xsd:string' to 'rdf:langString'.

3.5.3. Valgfrie egenskaper for klassen Informasjonsbegrep

3.5.3.1. Informasjonsbegrep – identifikator (dct:identifier)

English name

identifier

URI

dct:identifier

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å oppgi identifikatoren til informasjonsbegrepet.

This property represents an unambiguous reference to the Information Concept.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional
3.5.3.2. Informasjonsbegrep – navn (skos:prefLabel)

English name

name

URI

skos:prefLabel

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi navnet til informasjonsbegrepet. Egenskapen BØR gjentas når navnet finnes på flere språk.

This property represents the Name of the Information Concept. The property SHOULD be repeated when the name is in several languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Verdiområdet endret fra 'xsd:string' til 'rdf:langString'.

Norwegian extension: The range changed from 'xsd:string' to 'rdf:langString'.
3.5.3.3. Informasjonsbegrep – type (dct:type)

English name

type

URI

dct:type

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å spesifisere hvilken kategori informasjonsbegrepet tilhører.

This property represents the category to which the Information Concept belongs.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Selv om CCCEV (foreløpig) forklarer at denne egenskapen også kan brukes til å oppgi primitive typer som f.eks. dato eller tekststreng, anbefales det i denne norske spesifikasjonen at denne egenskapen brukes bare for forretningsmessige domeneterminologier som «alder» eller «antall ansatte», og at egenskapen 3.5.1.1, “Informasjonsbegrep – uttrykk av forventet datatype (cv:expressionOfExpectedValue)” brukes til primitive datatyperg.

Norwegian extension: Although CCCEV (currently) explains that this property can also be used to specify primitive types such as date or string, it is recommended in this Norwegian specification that this property is only used for business domain terminology such as "age" or "number of employees" and the property expression of the expected value (cv:expressionOfExpectedValue) for primitive types.

3.6. Klassen Informasjonskrav (cv:InformationRequirement)

UML-diagram med klassen Informasjonskrav, dens egenskaper og dens relasjoner til sju andre klasser. Innholdet i diagrammet er forklart i teksten.
Figur 8. Klassen Informasjonskrav (cv:InformationRequirement) og klassene den refererer til

English name

Information Requirement

Anvendelse / Usage note

Klassen brukes til å representere forespørsler om data som skal dokumentere en eller flere fakta (fra den virkelige verden) på en formell måte, eller som fører til kilden til slik dokumentasjon.

This class represents requested data that is to be proven by Evidence.

Information Requirements are the most neutral kind of Requirements. They aim to request information in any form, e.g. a person’s date of birth or a company’s turnover. They represent requests for data that prove one or more facts of the real world in a formal manner, or that leads to the source of such a proof. They can be understood as 'requests for Evidences'. The response to an Information Requirement is an Evidence when the issuer of the response is an authoritative source (e.g. a Civil Registry providing data about a natural person for the provision of public service through the Single Digital Gateway). In other cases, the responses might not be issued by an authoritative source, but the issuer supports the responses with Evidences (or commits to support them timely, e.g. a self-declaration or a declaration of oath). The Information Requirement can require structured data or documents of any form. For structured data, the Requirement can use 'Concepts' to specify the structure and type of the data expected in the response. For both structured and unstructured data, the Information Requirement can indicate the expected Type of Evidence, its format, source, and other properties related to the Evidence.

URI

cv:InformationRequirement

Subklasse av / Subclass of

cv:Requirement

Eksempel

Se under kap. 4.3, “Å beskrive betingelser som skal oppfylles”.

Eksempel i RDF Turtle: Se under kap. 4.3, “Å beskrive betingelser som skal oppfylles”.

3.6.1. Obligatoriske egenskaper for klassen Informasjonskrav

3.6.1.1. Informasjonskrav – identifikator (dct:identifier)

English name

identifier

URI

dct:identifier

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å oppgi identifikatoren til informasjonskravet.

This property represents an identifier for the Information Requirement.

Multiplisitet / Multiplicity

1..1

Kravnivå / Requirement level

Obligatorisk / Mandatory
3.6.1.2. Informasjonskrav – navn (dct:title)

English name

name

URI

dct:title

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi navn til informasjonskravet. Egenskapen BØR gjentas når navnet er på flere språk.

This property represents the official Name of the Information Requirement. This property SHOULD be repeated when the name is in several languages.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

3.6.2. Anbefalte egenskaper for klassen Informasjonskrav

3.6.2.1. Informasjonskrav – beskrivelse (dct:description)

English name

description

URI

dct:description

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi beskrivelse av informasjonskravet. Egenskapen BØR gjentas når beskrivelsen er på flere språk.

This property represents a description of the Information Requirement. This property SHOULD be repeated when the description is in several languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt/Recommended

3.6.3. Valgfrie egenskaper for klassen Informasjonskrav

3.6.3.1. Informasjonskrav – er subkrav av (cv:isRequirementOf)

English name

is requirement of

URI

cv:isRequirementOf

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å referere til et annet krav som informasjonskravet er en del av, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property is used to refer to an instance of one of the subclasses of cv:Requirement, which the Information Requirement is a part of.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.6.3.2. Informasjonskrav – er utledet fra (cv:isDerivedFrom)

English name

is derived from

URI

cv:isDerivedFrom

Verdiområde / Range

cv:ReferenceFramework

Anvendelse / Usage note

Egenskapen brukes til å referere til referanserammeverk som informasjonskravet er basert på, f.eks. lov, forskrift eller annen regulering.

This property refers to the Reference Framework on which the Information Requirement is based, such as a law or regulation.

Note that an Information Requirement can have several Reference Frameworks from which it is derived.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.6.3.3. Informasjonskrav – er utstedt av (dct:publisher)

English name

is issued by

URI

dct:publisher

Verdiområde / Range

foaf:Agent ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til aktøren som har utstedt informasjonskravet.

This property refers to the Agent that has published the Information Requirement.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional
3.6.3.4. Informasjonskrav – har dokumentasjonstypeliste (cv:hasEvidenceTypeList)

English name

has evidence type list

URI

cv:hasEvidenceTypeList

Verdiområde / Range

cv:EvidenceTypeList

Anvendelse / Usage note

Egenskapen brukes til å referere til dokumentasjonstypeliste som spesifiserer type dokumentasjon som trengs for å tilfredsstille informasjonskravet.

This property is used to refer to the Evidence Type List that specifies the type of evidence that are needed to meet the Information Requirement.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.6.3.5. Informasjonskrav – har informasjonsbegrep (cv:hasConcept)

English name

has concept

URI

cv:hasConcept

Verdiområde / Range

cv:InformationConcept

Anvendelse / Usage note

Egenskapen brukes til å referere til informasjonsbegrep som informasjonskravet forventer en verdi av.

This property refers to the Information Concept for which a value is expected by the Information Requirement.

Information Concepts defined for specific Information Requirements also represent the basis for specifying the Supported Value an Evidence should provide.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.6.3.6. Informasjonskrav – har kvalifisert relasjon til andre krav (cv:hasQualifiedRelation)

English name

has qualified relation

URI

cv:hasQualifiedRelation

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å representere en beskrevet/kategorisert relasjon til et annet krav, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property represents a described and/or categorised relation to an instance of one of the subclasses of cv:Requirement.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.6.3.7. Informasjonskrav – har mer spesifikt krav (cv:hasRequirement)

English name

has requirement

URI

cv:hasRequirement

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å referere til et mer spesifikt krav som er en del av informasjonskravet, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property refers to a more specific Requirement that is part of the Information Requirement.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.6.3.8. Informasjonskrav – har understøttende dokumentasjon (cv:hasSupportingEvidence)

English name

has supporting evidence

URI

cv:hasSupportingEvidence

Verdiområde / Range

cv:Evidence

Anvendelse / Usage note

Egenskapen brukes til å referere til en konkret dokumentasjon som supplerer med informasjon, bevis eller understøtter informasjonskravet.

This property refers to a concrete piece of evidence that supplies information, proof or support for the information requirement.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.6.3.9. Informasjonskrav – innfrir regel (cv:fulfils)

English name

fulfils

URI

cv:fulfils

Verdiområde / Range

cpsv:Rule ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til regel som informasjonskravet innfrir.

This property refers to the rules that the Information Requirement fulfils.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.6.3.10. Informasjonskrav – type (dct:type)

English name

type

URI

dct:type

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å referere til kategorien informasjonskravet tilhører.

This property refers to the category to which the Information Requirement belongs.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

3.7. Klassen Krav (cv:Requirement)

UML-diagram med klassen Krav, med tre subklasser av den. Innholdet i diagrammet er forklart i teksten.
Figur 9. Klassen Krav (cv:Requirement) og dens subklasser

English name

Requirement

Anvendelse / Usage note

Klassen brukes til å representere nødvendige betingelser eller forutsetninger for bruk av en tjeneste.

The class represents condition or prerequisite.

Not all public services are needed or are used by everyone. For example, the visa service operated by European countries is not needed by European citizens but is needed by some citizens from elsewhere, or public services offering unemployment benefits and grants are targeting specific societal groups.

URI

cv:Requirement

Merknad / Note

Denne klassen er en generisk klasse som frarådes å brukes direkte. Dens subklasse 3.1, “Klassen Begrensning (cv:Constraint)”, 3.8, “Klassen Kriterium (cv:Criterion)” eller 3.6, “Klassen Informasjonskrav (cv:InformationRequirement)” BØR brukes istedenfor.

Requirement is a generic class representing any type of prerequisite that may be desired, needed or imposed as an obligation. CCCEV recommends to not use the Requirement class directly, but rather a more semantically-enriched subclass such as Criterion, Information Requirement or Constraint. Also note that the Requirement class is specified at a more abstract level and is not to be used as the instantiation of a Requirement for a specific Agent. To illustrate the notion: the European Directive on services in the internal market defines requirement as any obligation, prohibition, condition or limit provided for in the laws, regulations or administrative provisions of the Member States or in consequence of case-law, administrative practice, the rules of professional bodies, or the collective rules of professional associations or other professional organisations, adopted in the exercise of their legal autonomy.
Som nevnt ovenfor er denne klassen en generisk klasse (også kalt abstrakt klasse) som ikke bør brukes direkte. En av subklassene – 3.1, “Klassen Begrensning (cv:Constraint)”, 3.8, “Klassen Kriterium (cv:Criterion)” eller 3.6, “Klassen Informasjonskrav (cv:InformationRequirement)” – bør brukes istedenfor, avhengig av konteksten.

3.8. Klassen Kriterium (cv:Criterion)

UML-diagram med klassen Kriterium, dens egenskaper og dens relasjoner til sju andre klasser. Innholdet i diagrammet er forklart i teksten.
Figur 10. Klassen Kriterium (cv:Criterion) og klassene den refererer til

English name

Criterion

Anvendelse / Usage note

Klassen brukes til å representere en betingelse for evaluering eller vurdering.

This class represents a Condition for evaluation or assessment.

In general, Criteria are used for comparison, filtering or selection purposes. Criteria usually set minimum conditions (e.g. limits, intervals, thresholds, etc.) that need to be met in order to pass the requirements or to fulfil them to a certain degree or quality. The concept of Criteria is broader than the concept of Constraint since it covers more usages. The evaluation of the fulfilment is usually supported by the provision of Evidence. For example in the eProcurement domain, the eProcurement Ontology defines different subclasses of Criterion such as exclusion grounds, selection criteria or award criteria. A concrete example of a Criterion is 'participation in a criminal organisation' which could also be considered as an exclusion ground criterion in the procurement domain or for requiring a public service.

URI

cv:Criterion

Subklasse av / Subclass of

cv:Requirement

Eksempel

Se under kap. 4.3, “Å beskrive betingelser som skal oppfylles”.

Eksempel i RDF Turtle: Se under kap. 4.3, “Å beskrive betingelser som skal oppfylles”.

3.8.1. Obligatoriske egenskaper for klassen Kriterium

3.8.1.1. Kriterium – identifikator (dct:identifier)

English name

identifier

URI

dct:identifier

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å oppgi identifikatoren til kriteriet.

This property represents an identifier for the Criterion.

Multiplisitet / Multiplicity

1..1

Kravnivå / Requirement level

Obligatorisk / Mandatory
3.8.1.2. Kriterium – navn (dct:title)

English name

name

URI

dct:title

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi navn til kriteriet. Egenskapen BØR gjentas når navnet er på flere språk.

This property represents the official Name of the Criterion. This property SHOULD be repeated when the name is in several languages.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

3.8.2. Anbefalte egenskaper for klassen Kriterium

3.8.2.1. Kriterium – beskrivelse (dct:description)

English name

description

URI

dct:description

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi beskrivelse av kriteriet. Egenskapen BØR gjentas når beskrivelsen er på flere språk.

This property represents a description of the Criterion. This property SHOULD be repeated when the description is in several languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

3.8.3. Valgfrie egenskaper for klassen Kriterium

3.8.3.1. Kriterium – bias (cv:bias)

English name

bias

URI

cv:bias

Verdiområde / Range

xsd:decimal

Anvendelse / Usage note

Brukes til å oppgi parameteren som brukes til å justere evalueringen av kriteriet.

This property represents the parameter used to adjust the evaluation of the Criterion.

The bias parameter tries to correct a systematic error. For example in procurement, a home bias corresponds to the "presence of local preferences distorting international specialisation and resource allocation". When quantified, this systematic error can be removed.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.2. Kriterium – er subkrav av (cv:isRequirementOf)

English name

is requirement of

URI

cv:isRequirementOf

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å referere til et annet krav som kriteriet er del av, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property is used to refer to an instance of one of the subclasses of cv:Requirement, which the Criterion is a part of.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.3. Kriterium – er utledet fra (cv:isDerivedFrom)

English name

is derived from

URI

cv:isDerivedFrom

Verdiområde / Range

cv:ReferenceFramework

Anvendelse / Usage note

Egenskapen brukes til å referere til referanserammeverk som kriteriet er basert på, f.eks. lov, forskrift eller annen regulering.

This property refers to the Reference Framework on which the Criterion is based, such as a law or regulation.

Note that a Criterion can have several Reference Frameworks from which it is derived.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.4. Kriterium – er utstedt av (dct:publisher)

English name

is issued by

URI

dct:publisher

Verdiområde / Range

foaf:Agent ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til aktøren som har utstedt kriteriet.

This property refers to the Agent that has published the Criterion.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.5. Kriterium – har dokumentasjonstypeliste (cv:hasEvidenceTypeList)

English name

has evidence type list

URI

cv:hasEvidenceTypeList

Verdiområde / Range

cv:EvidenceTypeList

Anvendelse / Usage note

Egenskapen brukes til å referere til dokumentasjonstypeliste som spesifiserer type dokumentasjon som trengs for å tilfredsstille kriteriet.

This property is used to refer to the Evidence Type List that specifies the type of evidence that are needed to meet the Criterion.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.6. Kriterium – har informasjonsbegrep (cv:hasConcept)

English name

has concept

URI

cv:hasConcept

Verdiområde / Range

cv:InformationConcept

Anvendelse / Usage note

Egenskapen brukes til å referere til informasjonsbegrep som kriteriet forventer en verdi av.

This property refers to the Information Concept for which a value is expected by the Criterion.

Information Concepts defined for specific Criteria also represent the basis for specifying the Supported Value an Evidence should provide.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.7. Kriterium – har kvalifisert relasjon til andre krav (cv:hasQualifiedRelation)

English name

has qualified relation

URI

cv:hasQualifiedRelation

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å representere en beskrevet/kategorisert relasjon til et annet krav, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property represents a described and/or categorised relation to an instance of one of the subclasses of cv:Requirement.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.8. Kriterium – har mer spesifikt krav (cv:hasRequirement)

English name

has requirement

URI

cv:hasRequirement

Verdiområde / Range

cv:Requirement

Anvendelse / Usage note

Egenskapen brukes til å referere til et mer spesifikt krav som er en del av kriteriet, representert ved en instans av en av subklassene til klassen Krav (cv:Requirement).

This property refers to a more specific Requirement that is part of the Criterion.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.9. Kriterium – har understøttende dokumentasjon (cv:hasSupportingEvidence)

English name

has supporting evidence

URI

cv:hasSupportingEvidence

Verdiområde / Range

cv:Evidence

Anvendelse / Usage note

Egenskapen brukes til å referere til en konkret dokumentasjon som supplerer med informasjon, bevis eller understøtter kriteriet.

This property refers to a concrete piece of evidence that supplies information, proof or support for the criterion.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.10. Kriterium – innfrir regel (cv:fulfils)

English name

fulfils

URI

cv:fulfils

Verdiområde / Range

cpsv:Rule ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til regel som kriteriet innfrir.

This property refers to the rules that the Criterion fulfils.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.11. Kriterium – type (dct:type)

English name

type

URI

dct:type

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å referere til kategorien kriteriet tilhører.

This property refers to the category to which the Criterion belongs.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.12. Kriterium – vekting (cv:weight)

English name

weight

URI

cv:weight

Verdiområde / Range

xsd:decimal

Anvendelse / Usage note

Brukes til å oppgi relativ viktighet (vekting) av kriteriet.

This property represents the relative importance of the Criterion.

The weight must be between 0 and 1. Usually, all Criteria can be integrated within a weighted sum equal to 1.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional
3.8.3.13. Kriterium – vektingstype (cv:weightingType)

English name

weighting type

URI

cv:weightingType

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Brukes til å oppgi hvordan vektingen bør tolkes i et komplekst evalueringsuttrykk, f.eks. som en prosent i et evalueringsuttrykk.

This property represents an indication of how the weight should be interpreted in a complex evaluation expression, e.g. as a percentage in an evaluation expression.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

EUs kontrollerte vokabular Number weight ⧉ KAN brukes som mulige verdier for denne egenskapen.

EU’s controlled vocabulary Number weight ⧉ MAY be used as possible values for this property.
3.8.3.14. Kriterium – vektingsvurderingsbeskrivelse (cv:weightingConsiderationDescription)

English name

weighting consideration description

URI

cv:weightingConsiderationDescription

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Brukes til å oppgi en tekstlig forklaring på hvordan vektingen av et kriterium brukes. Egenskapen BØR gjentas når forklaringen finnes på flere språk.

This property contains the explanation of how the weighting of a Criterion is to be used. This property SHOULD be repeated when the explanation is in parallel languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Verdiområdet endret fra 'xsd:string' til 'rdf:langString'.

Norwegian extension: The range changed from 'xsd:string' to 'rdf:langString'.

3.9. Klassen Referanserammeverk (cv:ReferenceFramework)

UML-diagram med klassen Referanserammeverk og dens egenskaper. Innholdet i diagrammet er forklart i teksten.
Figur 11. Klassen Referanserammeverk (cv:ReferenceFramework)

English name

Reference Framework

Anvendelse / Usage note

Klassen brukes til å representere lovgivning eller offisiell politikk som krav er utledet fra.

This class represents legislation or official policy from which Requirements are derived.

URI

cv:ReferenceFramework

Merknad / Note

Vanlige referanserammeverk er regulative og ikke-regulative spesifikasjoner. Eksempler kan være prosedyrer, anskaffelsesreglement osv.

Usual Reference Frameworks are legal and non-legal specifications. Examples include procedures, tendering legislation etc.

Eksempel

Se under kap. [Å-kytte-krav-til-regelverk].

Eksempel i RDF Turtle: Se under kap. [Å-kytte-krav-til-regelverk].

3.9.1. Obligatoriske egenskaper for klassen Referanserammeverk

3.9.1.1. Referanserammeverk – identifikator (dct:identifier)

English name

identifier

URI

dct:identifier

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å oppgi en unik referanse til referanserammeverket.

This property represents an unambiguous reference to a reference framework.

Multiplisitet / Multiplicity

1..1

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad 1 / Note 1

Norsk utvidelse: Kravnivået endret fra valgfri til obligatorisk, og multiplisiteten fra 0..n til 1..1.

Norwegian extension: The requirement level changed from optional to mandatory, and the multiplicity from 0..n to 1..1.

Merknad 2 / Note 2

Norsk utvidelse: For referanser til lovdata BØR ELI-URI-er brukes. Se Lovdata sin implementering av ELI ⧉ for mer informasjon.

Norwegian extension: For references to Lovdata, ELI URIs SHOULD be used. See ELI implementation at Lovdata ⧉ for more information.

3.9.2. Anbefalte egenskaper for klassen Referanserammeverk

3.9.2.1. Referanserammeverk – beskrivelse (dct:description)

English name

description

URI

dct:description

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi en tekstlig beskrivelse av referanserammeverket. Egenskapen BØR gjentas når den finnes på flere språk.

This property contains descriptive textual information about the Reference Framework. This property SHOULD be repeated in case there are various versions of the text in different languages.

Multiplisitet / Multiplicity

0..n

Merknad / Note

Norsk utvidelse: Ikke eksplisitt tatt med i CCCEV/CPSV-AP.

Norwegian extension: Not explicitly specified in CCCEV/CPSV-AP.
3.9.2.2. Referanserammeverk – tittel (dct:title)

English name

title

URI

dct:title

Verdiområde / Range

rdf:langString

Anvendelse / Usage note

Egenskapen brukes til å oppgi tittel til referanserammeverket. Egenskapen BØR gjentas når tittelen finnes på flere språk.

This property is used to specify the title of the Reference Framework. This property SHOULD be repeated when the title is in several parallel languages.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Norsk utvidelse: Ikke eksplisitt tatt med i CCCEV/CPSV-AP.

Norwegian extension: Not explicitly specified in CCCEV/CPSV-AP.

3.10. Klassen Understøttende opplysning (cv:SupportedValue)

UML-diagram med klassen Understøttende opplysning, dens egenskaper og dens relasjon til en annen klasse. Innholdet i diagrammet er forklart i teksten.
Figur 12. Klassen Understøttende opplysning (cv:SupportedValue) og klassen den refererer til

English name

Supported Value

Anvendelse / Usage note

Klassen brukes til å representere verdien til et informasjonsbegrep som en dokumentasjon oppgir.

This class represents the Value for an Information Concept that is provided by an Evidence.

URI

cv:SupportedValue

3.10.1. Obligatoriske egenskaper for klassen Understøttende opplysning

3.10.1.1. Understøttende opplysning – gir verdi for (cv:providesValueFor)

English name

provides value for

URI

cv:providesValueFor

Verdiområde / Range

cv:InformationConcept

Anvendelse / Usage note

Egenskapen brukes til å referere til informasjonsbegrepet som det gis verdi for.

This property represents Information Concept for which the Supported Value provides a value.

Multiplisitet / Multiplicity

1..1

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

Norsk utvidelse: Kravsnivået endret fra valgfri til obligatorisk og multiplisiteten fra 0..n til 1..1.

Norwegian extension: The requirement level is changed from optional to mandatory and the multiplicity from 0..n to 1..1.

3.10.2. Valgfrie egenskaper for klassen Understøttende opplysning

3.10.2.1. Understøttende opplysning – spørring (cv:query)

English name

query

URI

cv:query

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å representere en spørring som gjør at verdien for informasjonsbegrepet kan hentes fra dokumentasjonsdataene.

This property represents search statement that allows the value for the Information Concept to be retrieved from the Evidence data.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Multiplisiteten endret fra 0..n til 0..1.

Norwegian extension: The multiplicity is changed from 0..n to 0..1.
3.10.2.2. Understøttende opplysning – verdi (cv:value)

English name

value

URI

cv:value

Verdiområde / Range

rdfs:Literal

Anvendelse / Usage note

Egenskapen brukes til å representere verdien til et informasjonsbegrep som støttes av dokumentasjonen.

This property represents the Value for the Information Concept that the Evidence supports.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Norsk utvidelse: Multiplisiteten endret fra 0..n til 0..1.

Norwegian extension: The multiplicity is changed from 0..n to 0..1.

4. Noen spesielle temaer

Denne delen er ment for både den ikke-tekniske og den tekniske målgruppen, fortrinnsvis sammen.

Denne delen av spesifikasjonen er ikke-normativ.

4.1. Når brukes Kriterium, Informasjonskrav, Informasjonsbegrep og Begrensning?

Ut fra CCCEV sin beskrivelse av klassene Kriterium (Criterion), Informasjonskrav (Information Requirement), Informasjonsbegrep (Information Concept) og Begrensning (Constraint), samt eksemplene i CCCEV, kan følgende anses som en god praksis for når de ulike klassene bør brukes:

  • Kriterium (cv:Criterion, kap. 3.8) brukes for å beskrive en eller flere betingelser som må være oppfylt.

    • Bortsett fra type, bias og relativ vekting, gir ikke klassen Kriterium alene mulighet til i maskinlesbar form å beskrive data som trengs for å evaluere om en betingelse er oppfylt eller ikke. Derfor brukes Kriterium sammen med Informasjonskrav for å beskrive de nødvendige dataene.

    • Når det ikke er behov for i maskinlesbar form å beskrive data som trengs for å evaluere om en betingelse er oppfylt eller ikke, kan Kriterium brukes alene, ved å bruke fritekstegenskapene navn og beskrivelse. F.eks. navn = «Vilkår for å inngå ekteskap»; beskrivelse = «Den som er under 18 år, kan ikke inngå ekteskap; Ingen kan inngå ekteskap så lenge et tidligere ekteskap eller registrert partnerskap består; …​».

  • Informasjonskrav (cv:InformationRequirement, kap. 3.6) kan brukes for å beskrive data som forespørres (f.eks. «Søkerens alder») og som skal brukes til å evaluere om en betingelse er oppfylt eller ikke, eller for å beskrive data som trengs uten at det brukes til noen evalueringer (f.eks. «Søkerens kontaktopplysninger»).

    • Bortsett fra type, gir ikke klassen Informasjonskrav alene mulighet til i maskinlesbar form å beskrive data som forespørres. Derfor brukes Informasjonskrav sammen med Informasjonsbegrep for å beskrive de nødvendige dataene.

      • Informasjonsbegrep (cv:InformationConcept, kap. 3.5) har en egenskap «uttrykk av forventet verdi» ( 3.5.1.1) som ifølge CCCEV også kan brukes til å oppgi nedre og øvre grense for den forventede verdien i tillegg til forventet datatype. For å øke maskinlesbar presisjon, anbefales det at den kun brukes til å oppgi forventet datatype, f.eks. datatype «heltall» for Informasjonsbegrepet «Alder». Dersom det er behov for å angi begrensninger i form av f.eks. nedre og øvre grense på en forventet verdi av et Informasjonsbegrep, bør klassen Begrensning brukes.

    • Informasjonskrav kan brukes alene når kravet bare skal beskrives i fritekstform, ved å bruke fritekstegenskapene navn og beskrivelse, f.eks. navn = «Søkerens alder» og beskrivelse = «Søkeren må være minst 18 år gammel».

  • Begrensning (cv:Constraint, kap. 3.1) brukes for å beskrive en begrensning på et Informasjonsbegrep og skal derfor brukes sammen med et Informasjonsbegrep. F.eks. Informasjonsbegrepet «Alder» kan ha Begrensning «Søkeren må være minst 18 år gammel».

Flytskjemaet i Figur 13 nedenfor illustrerer forklaringen ovenfor.

Flytskjema som viser når Kriterium, Informasjonskrav, Informasjonsbegrep og Begrensning bør brukes. Innholdet i flytskjemaet er forklart i teksten.
Figur 13. Flytskjema for når Kriterium, Informasjonskrav, Informasjonsbegrep og Begrensning bør brukes

4.2. Når brukes Dokumentasjon og Dokumentasjonstype/Dokumentasjonstypeliste?

Dokumentasjon (cv:Evidence, kap. 3.2) brukes til å beskrive et konkret stykke dokumentasjon som inneholder konkrete data eller som gir kilden til slike data, og som er brukt til å evaluere og/eller dokumentere oppfyllelse av et krav i «runtime». Et eksempel på en dokumentasjon kan være uttrekk på et gitt tidspunkt fra Folkeregisteret med opplysninger om søkeren Ola Nordmann, som i et konkret saksbehandlingsøyemed er brukt til å evaluere om han er minst 18 år gammel.

Dokumentasjonstype (cv:EvidenceType, kap. 3.3) brukes, i «design-time», til å beskrive type dokumentasjon som kan brukes til å evaluere oppfyllelse av et krav. En dokumentasjonstype inneholder altså ingen konkrete data, men spesifiserer felles egenskaper til data som trengs eller kilden til hvor slike data kan finnes. Et eksempel på dokumentasjonstype kan være «Folkeregisteropplysning», dvs. opplysninger registrert i Folkeregisteret som kan brukes til å evaluere om en søker er minst 18 år gammel. Et annet eksempel kan være «Pass», som også kan brukes til å evaluere om en søker er minst 18 år gammel.

For å knytte en dokumentasjonstype til et krav, brukes Dokumentasjonstypeliste (cv:EvidenceTypeList, kap. 3.4). En dokumentasjonstypeliste spesifiserer en eller flere typer dokumentasjon som kreves for å oppfylle et krav. Vær spesielt oppmerksom på at kravet om å være i samsvar med en dokumentasjonstypeliste er oppfylt hvis og bare hvis den aktuelle, faktiske dokumentasjonen samsvarer med alle typer som listen inneholder. Det er med andre ord en OG (AND) betingelse mellom typene på en gitt dokumentasjonstypeliste, og en ELLER (OR) betingelse mellom ulike dokumentasjonslister. På denne måten kan man også uttrykke alternative dokumentasjonskrav. For eksmepel, for å beskrive kravet til å dokumentere at en søker er 1) minst 18 år gammel og 2) ikke i et ekteskap eller registrert partnerskap, kan man bruke en dokumentasjonstypeliste som inneholder dokumentasjonstypen «Folkeregisteropplysning» (fordi både fødselsdato og sivilstand kan hentes fra Folkeregisteret, for søkere som er registrert i Folkeregisteret), og en annen dokumentasjonstypeliste som inneholder dokumentasjonstypene «Pass» og «Dokumentasjon på at man ikke er i et ekteskap eller registrert partnerskap» (fordi passet bare inneholder fødselsdato og ikke sivilstand).

CCCEV-AP-NO gjør det også mulig å knytte en gitt konkret dokumentasjon til en dokumentasjonstype, ved hjelp av egenskapen «i samsvar med» (dct:conformsTo). For vår søker Ola Nordmann, som er registrert i Folkeregisteret, vil dokumentasjonen «Uttrekk fra Folkeregisteret for Ola Nordmann» tilfredsstille dokumentasjonskravet fordi dokumentasjonen er i samsvar med dokumentasjonstypen «Folkeregisteropplysning».

Forholdet mellom Krav, Dokumentasjonstypeliste, Dokumentasjonstype og Dokumentasjon er beskrvet i Figur 14 nedenfor.

UML-diagram med fire klasser og relasjoner i mellom dem. Innholdet i diagrammet er forklart i teksten.
Figur 14. Forholdet mellom Krav, Dokumentasjonstypeliste, Dokumentasjonstype og Dokumentasjon

Se også kap. 4.3 for et illustrativt eksempel på bruk av Krav, Dokumentasjonstypeliste, Dokumentasjonstype og Dokumentasjon.

4.3. Å beskrive betingelser som skal oppfylles

CCCEV-AP-NO gjør det mulig, i struktuert og maskinlesbar form, å beskrive betingelser som skal oppfylles og dokumentasjon på oppfyllelse.

Følgende er et illustrativt eksempel på bruk av CCCEV-AP-NO for å beskrive deler av «Vilkår for å inngå ekteskap», med beskrivelse av data som trengs samt begrensninger på disse dataene. I eksemplet er det også tatt med dokumentasjonstype og faktisk dokumentasjon som gir kilden til dataene som trengs.

  • Kriterium: Vilkår for å inngå ekteskap

    • Informasjonskrav 1: Søkerens alder

      • Informasjonsbegrep 1: Alder

        • Begrensning: Søkeren må være minst 18 år gammel

      • Dokumentasjonstype 1: Folkeregisteropplysning

      • Dokumentasjon: Uttrekk fra Folkeregisteret for Ola Nordmann

    • Informasjonskrav 2: Søkerens sivilstand

      • Informasjonsbegrep 2: Sivilstand

        • Begrensning: Søkerens sivilstand kan ikke være <gift>, <separert>, <registrert partner> eller <separert partner>

      • Dokumentasjonstype 1: Folkeregisteropplysning

      • Dokumentasjon: Uttrekk fra Folkeregisteret for Ola Nordmann

    • Informasjonskrav x: …​

      • Informasjonsbegrep y: …​

        • Begrensning: …​

      • Dokumentasjonstype z:

      • Dokumentasjon: …​

Eksemplet er illustrert i Figur 15 nedenfor.

RDF-graf med syv RDF-noder og relasjoner imellom nodene. Innholdet i grafen er forklart i teksten.
Figur 15. Eksempel - beskrivelse av «Vilkår for å inngå ekteskap»

Eksemplet i RDF Turtle:

<vilkårForÅInngåEkteskap> a cv:Criterion ; # kriterium
   dct:title "Vilkår for å inngå ekteskap"@nb ; # navn
   cv:hasEvidenceTypeList <dokumentasjonstypeListe1> ; # har dokumentasjonstypeliste
   cv:hasRequirement <søkerensAlder>, <begrensningAlder>,
      <søkerensSivilstand>, <begrensningSivilstand> ; # har mer spesifikt krav
   .

<dokumentasjonstypeListe1> a cv:EvidenceTypeList ; # dokumentasjonstypeliste
   dct:title "Dokumentasjonstypelist 1"@nb ; # navn
   cv:specifiesEvidenceType <dokTypeFregOpplysning> ; # spesifiserer dokumentasjonstype
   .

<dokTypeFregOpplysning> a cv:EvidenceType ; # dokumentasjonstype
   dct:title "Folkeregisteropplysninger"@nb ; # navn
   dct:description "Opplysninger registrert i Folkeregisteret om en søker."@nb ; # beskrivelse
   .

<søkerensAlder> a cv:InformationRequirement ;  # informasjonskrav
   dct:title "Søkerens alder"@nb ; # navn
   cv:hasConcept <alder> ; # har informasjonsbegrep
   cv:hasRequirement <begrensningAlder> ; # har mer spesifikt krav
   .

<alder> a cv:InformationConcept ; # informasjonsbegrep
   dct:title "Alder"@nb ; # navn
   .

<begrensningAlder> a cv:Constraint ; # begrensning
   dct:title "Begrensning på søkerens alder"@nb ; # navn
   dct:description "Søkeren må være minst 18 år gammel."@nb ;
   cv:constrains <alder> ; # begrenser
   .

<søkerensSivilstand> a cv:InformationRequirement ;  # informasjonskrav
   dct:title "Søkerens sivilstand"@nb ; # navn
   cv:hasConcept <sivilstand> ; # har informasjonsbegrep
   cv:hasRequirement <begrensningSivilstand> ; # har mer spesifikt krav
   .

<sivilstand> a cv:InformationConcept ; # informasjonsbegrep
   dct:title "Sivilstand"@nb ; # navn
   .

<begrensningSivilstand> a cv:Constraint ; # begrensning
   dct:title "Begrensning på søkerens sivilstand"@nb ; # navn
   dct:description "Søkerens sivilstand kan ikke være <gift>, <separert>, <registrert partner> eller <separert partner>."@nb ;
   cv:constrains <sivilstand> ; # begrenser
   .

<fregUttrekkForOlaNordmann> a cv:Evidence ; # en konkret dokumentasjon, for Ola Nordmann
   dct:title "Uttrekk fra Folkeregisteret for Ola Nordmann"@nb ; # navn
   dct:conformsTo <dokTypeFregOpplysning> ; # i samsvarer med dokumentasjonstype
   cv:supportsRequirement <søkerensAlder>, <begrensningAlder>,
      <søkerensSivilstand>, <begrensningSivilstand> ; # understøtter krav
   .

4.4. Å knytte krav til regelverk

CCCEV-AP-NO gir mulighet til å knytte krav til aktuelle regelverk.

Følgende eksempel illustrerer at Kriterium «Vilkår for å inngå ekteskap» er utledet fra kapittel 1 i ekteskapsloven, Informasjonskrav «Søkerens alder» med tilhørende begrensning er utleddet fra §1a i ekteskapsloven, og Informasjonskrav «Søkerens sivilstand» med tilhørende begrensning er utleddet fra §4 i ekteskapsloven.

  • Kriterium: Vilkår for å inngå ekteskap

    • er utledet fra: kapittel 1 i ekteskapsloven

    • Informasjonskrav 1: Søkerens alder

      • er utledet fra: §1a i ekteskapsloven

      • Informasjonsbegrep: Alder

        • Begrensning: Søkeren må være minst 18 år gammel

          • er utledet fra: §1a i ekteskapsloven

    • Informasjonskrav 2: Søkerens sivilstand

      • er utledet fra: §4 i ekteskapsloven

      • Informasjonsbegrep: Sivilstand

        • Begrensning: Søkerens sivilstand kan ikke være <gift>, <separert>, <registrert partner> eller <separert partner>

          • er utledet fra: §4 i ekteskapsloven

    • Informasjonskrav 3: …​

      • Informasjonsbegrep: …​

        • Begrensning: …​

      • Påkrevd dokumentasjon:

      • Dokumentasjon: …​

Eksemplet er illustrert i Figur 16 nedenfor.

RDF-graf med ni noder og relasjoner imellom nodene. Innholdet i grafen er forklart i teksten.
Figur 16. Eksempel på å knytte kravbeskrivelse til lovgivning

Eksemplet i RDF Turtle:

<vilkårForÅInngåEkteskap> a cv:Criterion ; # kriterium
   dct:title "Vilkår for å inngå ekteskap"@nb ; # navn
   cv:isDerivedFrom <ekteskapsloven1> ; # er utledet fra
   cv:hasRequirement <søkerensAlder>, <begrensningAlder>,
      <søkerensSivilstand>, <begrensningSivilstand> ; # har mer spesifikt krav
   .

<søkerensAlder> a cv:InformationRequirement ;  # informasjonskrav
   dct:title "Søkerens alder"@nb ; # navn
   cv:isDerivedFrom <ekteskapsloven1a> ; # er utledet fra
   cv:hasConcept <alder> ; # har informasjonsbegrep
   cv:hasRequirement <begrensningAlder> ; # har mer spesifikt krav
   .

<alder> a cv:InformationConcept ; # informasjonsbegrep
   dct:title "Alder"@nb ; # navn
   .

<begrensningAlder> a cv:Constraint ; # begrensning
   dct:title "Begrensning på søkerens alder"@nb ; # navn
   dct:description "Søkeren må være minst 18 år gammel."@nb ;
   cv:isDerivedFrom <ekteskapsloven1a> ; # er utledet fra
   cv:constrains <alder> ; # begrenser
   .

<søkerensSivilstand> a cv:InformationRequirement ;  # informasjonskrav
   dct:title "Søkerens sivilstand"@nb ; # navn
   cv:isDerivedFrom <ekteskapsloven4> ; # er utledet fra
   cv:hasConcept <sivilstand> ; # har informasjonsbegrep
   cv:hasRequirement <begrensningSivilstand> ; # har mer spesifikt krav
   .

<sivilstand> a cv:InformationConcept ; # informasjonsbegrep
   dct:title "Sivilstand"@nb ; # navn
   .

<begrensningSivilstand> a cv:Constraint ; # begrensning
   dct:title "Begrensning på søkerens sivilstand"@nb ; # navn
   dct:description "Søkerens sivilstand kan ikke være <gift>, <separert>, <registrert partner> eller <separert partner>."@nb ;
   cv:isDerivedFrom <ekteskapsloven4> ; # er utledet fra
   cv:constrains <sivilstand> ; # begrenser
   .

<ekteskapsloven1> a cv:ReferenceFramework ; # referanserammeverk
   dct:identifier "https://lovdata.no/eli/lov/1991/7/4/47/chapter/1"^^xsd:anyURI ; # identifikator
   dct:title "Kapittel 1. Vilkår for å inngå ekteskap."@nb,
      "Chapter 1. Conditions for contracting a marriage."@en ;
   dct:description "Kapittel 1 i ekteskapsloven."@nb,
      "Chapter 1 in The Marriage Act."@en;
    .

<ekteskapsloven1a> a cv:ReferenceFramework ; # referanserammeverk
   dct:identifier "https://lovdata.no/eli/lov/1991/7/4/47/section/1a"^^xsd:anyURI ; # identifikator
   dct:title "§ 1 a. Ekteskapsalder."@nb,
      "Section 1 a. Age for marriage."@en ;
   dct:description "§1a i ekteskapsloven."@nb,
      "Section 1a in The Marriage Act."@en;
   .

<ekteskapsloven4> a cv:ReferenceFramework ; # referanserammeverk
   dct:identifier "https://lovdata.no/eli/lov/1991/7/4/47/section/4"^^xsd:anyURI ; # identifikator
   dct:title "§ 4. Forbud mot ekteskap når tidligere ekteskap består."@nb,
      "Section 4. Prohibition against marriage when a previous marriage subsists."@en ;
   dct:description "§4 i ekteskapsloven."@nb,
      "Section 4 in The Marriage Act."@en;
   .

Navnerom for dette vokabularet er: https://data.norge.no/vocabulary/cccevno#

Prefiks

Navnerom

Forklaring/navn

cccevno

https://data.norge.no/vocabulary/cccevno#

denne spesifikasjonen

cpsv

http://purl.org/vocab/cpsv#

Core Public Service Vocabulary Application Profile (CPSV-AP) ⧉

cv

http://data.europa.eu/m8g/

e-Government Core Vocabularies ⧉

dcat

http://www.w3.org/ns/dcat#

Data Catalog Vocabulary ⧉

dct

http://purl.org/dc/terms/

DCMI Metadata Terms ⧉

eli

http://data.europa.eu/eli/ontology#

European Legislation Identifier ⧉

foaf

http://xmlns.com/foaf/0.1/

FOAF Vocabulary ⧉

rdf

http://www.w3.org/1999/02/22-rdf-syntax-ns#

RDF 1.1 XML Syntax ⧉

rdfs

http://www.w3.org/2000/01/rdf-schema#

RDF Schema 1.1 ⧉

skos

http://www.w3.org/2004/02/skos/core#

SKOS Simple Knowledge Organization System ⧉

time

http://www.w3.org/2006/time#

Time Ontology in OWL ⧉

xsd

http://www.w3.org/2001/XMLSchema#

XML Schema Part 2: Datatypes Second Edition ⧉

Eksempel på prefiksene ovenfor uttrykt i RDF Turtle:

@prefix cccevno: <https://data.norge.no/vocabulary/cccevno#> .
@prefix cpsv: <http://purl.org/vocab/cpsv#> .
@prefix cv: <http://data.europa.eu/m8g/> .
@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix eli: <http://data.europa.eu/eli/ontology#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
@prefix time: <http://www.w3.org/2006/time#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

Vedlegg B – Endringslogg

p.t. ingen