Sådan dokumenterer du integrationskrav i en kravspecifikation

Afgræns integrationskrav i kravspecifikationen

Skriv grænsen eksplicit: hvilke systemer, dataflow og forretningsprocesser kravspecifikationen omfatter, og hvad der bevidst ligger uden for. Grænsen skal være så konkret, at en læser uden for projektet kan afgøre, om en ny grænseflade er omfattet.

Brug en tabel, hvor hvert integrationskrav har et ID og felterne kildesystem, målsystem, retning (ind/ud), dataobjekt, hyppighed (batch eller hændelsesstyret), understøttet forretningsproces, procesejer og kritikalitet. Markér grænseflader til eksterne parter, for eksempel leverandører og myndigheder, så ansvarsgrænsen fremgår af samme tabel.

Felterne i tabellen skal mindst være: krav-ID, kildesystem, målsystem, retning, dataobjekt, hyppighed, forretningsproces, procesejer, kritikalitet, ansvarsgrænse, acceptkriterium, kontrolmetode, dokumentationssted og standardreference med version. Udfyld alle felter, også når svaret er »ikke relevant«.

Konkrete felter: Krav-ID, kildesystem, målsystem, retning, dataobjekt, hyppighed, forretningsproces, procesejer, kritikalitet, ansvarsgrænse, acceptkriterium, kontrolmetode, dokumentationssted og standardreference med version. Felterne udgør tilsammen skabelonen for hvert integrationskrav.

Hvert integrationskrav skal markeres som skal-krav eller bør-krav. Skal-krav skal have et acceptkriterium, der kan testes uden fortolkning; bør-krav skal have en ejer og en begrundelse.

Koblingen til organisationens øvrige kvalitetsledelse bør stå i indledningen. Dansk Standard beskriver ISO 9001 som et kvalitetsledelsessystem, der giver »klare definitioner af processer, værdier, løbende overvågning og evaluering«. Standarden »stiller krav til hele processen og specificerer både kravene til etablering, implementering, vedligeholdelse og løbende forbedring af organisationens kvalitetsledelse (QMS)«.

Integrationskrav skal derfor ligge under en navngivet proces med en ejer, et målekriterium og en dokumentationsform. Ellers falder de uden for den løbende overvågning, ledelsessystemet dækker.

Dokumentationsniveauet bør differentieres efter kritikalitet i stedet for at være ens for alle integrationer. Byggeriet giver et sammenligneligt eksempel på, at dokumentation og kontrol kan opdeles i almen og særlig kontrol; eksemplet er uddybet i afsnittet om kontrol og verifikation.

Overfør princippet: beskriv i kravspecifikationen, hvilke integrationer der alene kræver den almene dokumentation, og hvilke der på grund af kritikalitet kræver særlig dokumentation/kontrol. Skriv valget ind, så det ikke skal genforhandles under implementeringen.

Dokumentationsniveau efter kritikalitet – byggeri som eksempel

Referer til standarder og fælles betegnelser

Skriv standardbetegnelser fuldt ud med version i kravspecifikationens referencefelt – ikke bare »ISO 9001«. DANAK forklarer afkodningen: DS står for dansk godkendte standarder, EN for europæisk godkendte standarder og ISO eller IEC for internationale standarder. DS/EN ISO/IEC 17025 er for eksempel en international og europæisk standard, der er dansk godkendt.

Referencefeltet er et kontrolpunkt. Kontrollér, at hver standard står med fuld betegnelse og version, og at versionen stadig er gældende. DS/EN ISO 9001:2026 er et eksempel på en dansk godkendt standard med versionsangivelse.

Standarder revideres, så versionen skal med. Dansk Standards webshop sælger DS/EN ISO 9001:2026. Bureau Veritas oplyser, at ISO 9001 er opdateret fra ISO 9001:2015 til ISO 9001:2026 med offentliggørelse den 16. september 2026 og en overgangsperiode for allerede certificerede virksomheder. En reference uden version forældes hurtigt.

Standardhenvisninger: Brug fuld betegnelse og version i referencefeltet. Eksempler er DS/EN ISO 9001:2026, DS/EN ISO/IEC 17025, ISO/IEC 17021-1, ISO/IEC 17020 og ISO/IEC 17029.

Brug standardernes egen terminologi, ikke egenopfundne begreber. DANAK gengiver Dansk Standards officielle definition af en standard: »Dokument til fælles og gentagen anvendelse, der giver regler, retningslinjer eller karakteristiske træk ved aktiviteter eller ved resultaterne af disse. Dokumentet er fastlagt ved konsensus og vedtaget af et anerkendt organ.«

Låner kravspecifikationen standardens ord for proces, overvågning, afvigelse og forbedring, bliver kravene lettere at genbruge på tværs af projekter og lettere at revidere. Dansk Standard er Danmarks nationale standardiseringsorganisation og udvikler, udgiver og sælger standarder, rådgiver, holder kurser og faciliterer standardiseringsudvalg. Ifølge Dansk Standard giver deltagelse i et udvalg tidlig indsigt i de standarder, der påvirker krav til produkter, produktion og processer.

Skal en integration kontrolleres af en ekstern part, skal kravspecifikationen angive både organets type og den relevante akkrediteringsstandard. DANAKs oversigt over akkrediteringsstandarder omfatter ISO/IEC 17021-1 for certificeringsorganer, der certificerer ledelsessystemer, ISO/IEC 17020 for inspektionsorganer, ISO/IEC 17029 for validerings- og verifikationsorganer og ISO/IEC 17025 for laboratorier, der udfører kalibrering og/eller prøvning.

Kontrollér også, at det valgte organ er akkrediteret til opgaven. DANAKs oversigt omfatter ISO/IEC 17021-1, ISO/IEC 17020, ISO/IEC 17029 og ISO/IEC 17025. Skriv standardnummeret ind i kravet.

Står det konkrete standardnummer i kravet, kan man efterfølgende kontrollere, om det valgte organ faktisk er akkrediteret til opgaven.

Opdatering af ISO 9001:2026 – tidslinje

Beskriv hvert integrationskrav som en dokumenteret proces

Formulér hvert integrationskrav som en proces med input, aktivitet, output, ansvarlig og målekriterium. Hvert krav bør som minimum indeholde formål (hvilken forretningsproces understøttes), parter (afsender, modtager, systemejer på begge sider), ansvar (hvem ejer kravet, hvem godkender ændringer, hvem håndterer fejl), forventet resultat og kriterier for at genkende resultatet. Brug roller og funktionsbetegnelser i ansvarsfeltet frem for personnavne, så kravet holder ved personaleudskiftning.

Konkret kravformulering: Brug skal-krav med acceptkriterium, kontrolmetode og dokumentationssted. Hvert krav skal have krav-ID, ejer og godkender, og ansvarsfeltet skal bruge roller.

Hvert krav skal have et entydigt krav-ID, en ejer og en godkender. Ansvarsfeltet bruger roller, ikke personnavne. Ændringer skal kunne føres tilbage til kravet.

Formulér kravet som et skal-krav med acceptkriterium, kontrolmetode og dokumentationssted. Fejl- og undtagelseshåndtering skal stå i samme krav, ikke i en separat teknisk note.

For hver af de fire faser – etablering, implementering, vedligeholdelse og løbende forbedring – skal kravspecifikationen angive aktivitet, ansvarlig, output og dokumentation.

Lad kravstrukturen følge de fire livsfaser, som ISO 9001 ifølge Dansk Standard specificerer krav til: etablering, implementering, vedligeholdelse og løbende forbedring.

For en integration betyder det, at kravspecifikationen beskriver, hvordan integrationen etableres (aftale mellem parterne, herunder hvilke data der udveksles og i hvilket format), hvordan den implementeres (udvikling og test), hvordan den vedligeholdes (hvad der sker, når kildesystemet ændres eller opgraderes), og hvordan den forbedres (hvilke målinger der følges, og hvordan afvigelser fører til ændringer i kravet).

Fejl- og undtagelseshåndtering hører til selve kravet, ikke til en teknisk detalje uden for. Beskriv derfor for hvert krav, hvad der sker ved manglende svar, gentagne forsøg, dublerede poster, afviste poster og nedetid hos modtageren, hvem der kontaktes ved afvigelse, og hvor afvigelsen registreres. Formulér kravene testbart med entydige »skal«-formuleringer og et konkret acceptkriterium frem for vurderingsprægede »bør«-sætninger, så kravet kan verificeres uden fortolkning.

Dokumentér kontrol og verifikation

Skriv kontrolplanen ind i kravspecifikationen for hvert enkelt integrationskrav: metode (test, gennemgang af log, stikprøve, inspektion), acceptkriterium, ansvarlig, tidspunkt i forløbet og opbevaringssted for dokumentationen.

Kontrolpunkter: Før implementering (aftale og testdata), under implementering (test og log), ved ibrugtagning (accept og versionsangivelse) og i drift (gennemførelsestid, fejlrate, afviste poster). Hvert punkt har ansvarlig, acceptkriterium og opbevaringssted.

Kontrolpunkterne skal mindst dække: før implementering (aftale og testdata), under implementering (test og log), ved ibrugtagning (accept og versionsangivelse) og i drift (gennemførelsestid, fejlrate, afviste poster). Hvert punkt har ansvarlig, acceptkriterium og opbevaringssted.

Dokumentér hvilken version af systemerne der blev testet, hvilke testdata der blev brugt, og hvem der godkendte resultatet. Uden det kan verifikationen ikke gentages.

Byggeriet viser, hvorfor planen skal være skriftlig og foreligge før udførelsen. Med BR18 skal dokumentation for et byggeris bærende konstruktioner omfatte dokumentation for kontrol af udførelse. De udførende skal selv planlægge og dokumentere den almene kontrol efter DS 1140. Reglerne gælder både nybyggeri, ombygning, renovering og ændret anvendelse af eksisterende byggeri.

I samme artikel fremhæver Dansk Standards seniorkonsulent Erling R. Trudsø, at det er helt nyt i Danmark, at udførelse af bygningskonstruktioner underlægges lovkrav om dokumenteret kvalitetssikring. Pointen er generel: kontrollen skal planlægges, udføres og dokumenteres af den, der udfører arbejdet.

Skeln mellem verifikation ved ibrugtagning og løbende overvågning, og skriv begge dele ind. ISO 9001's beskrivelse omfatter løbende overvågning og evaluering. I sin gennemgang af ISO 9001-certificering beskriver Bureau Veritas, at standarden sætter mål og skaber fremdrift gennem data, audit og kontinuerlig forbedring.

For integrationer kan det oversættes til overvågning af gennemførelsestid, fejlrate og antal afviste eller manglende poster kombineret med en aftalt reaktionsterskel og en navngivet modtager af afvigelser.

Dokumentér også rammerne omkring kontrollen: hvilken version af de involverede systemer der blev testet, hvilke testdata der blev anvendt, og hvem der godkendte resultatet. Uden versionsangivelse og godkendelsesnavn kan verifikationen hverken gentages eller bruges som bevis senere i integrationskravets levetid.

Indarbejd uafhængig kontrol

Beslut og skriv eksplicit, hvilke integrationskrav der kræver uafhængig kontrol, og definér uafhængigheden: den kontrollerende part må ikke være samme part, som har udviklet eller leveret integrationen.

Uafhængig kontrol er et kontrolpunkt. Beslut og skriv, hvilke integrationer der kræver uafhængig kontrol, og henvis til organets akkrediteringsstandard.

Definér uafhængigheden skriftligt: kontrollerende part må ikke være samme part, som har udviklet eller leveret integrationen. Angiv organets type og akkrediteringsstandard.

For kritiske integrationer skal omfanget stå i kravspecifikationen: hvilke integrationer, hvilke acceptkriterier og hvilken dokumentation tredjeparten skal have adgang til. Afsæt tid og omkostning i planen.

I Dansk Standards artikel om de nye krav siger Torben Hessing-Olsen, konsulent i Dansk Byggeri, at netop kravene om uafhængig kontrol forventes at give udfordringer for de udførende. Udfordringen består typisk i at definere, hvem der må kontrollere, hvornår kontrollen ligger i forløbet, og hvad den skal dække.

Angiv i kravet, hvilken type organ der kan udføre den uafhængige kontrol, og henvis til den relevante akkrediteringsstandard. Den fulde liste over DANAKs akkrediteringsstandarder står i afsnittet om standarder. Så bliver kravet efterprøveligt: man kan undersøge, om det pågældende organ er akkrediteret til den konkrete opgave.

Uafhængig verifikation kan også supplere eksisterende certificering. Bureau Veritas beskriver, at virksomheder, der allerede er certificeret efter ISO 9001, har et grundlag for at få uafhængigt verificeret deres bæredygtighedsrapport (CSRD) som et naturligt supplement til certificeringen.

Samme model kan bruges for kritiske integrationer: en tredjepart gennemgår testresultater, logs og afvigelsesbehandling mod acceptkriterierne i kravspecifikationen. Skriv omfanget ind – hvilke integrationer, hvilke kriterier, hvilken dokumentation tredjeparten skal have adgang til – og afsæt tid og omkostning til kontrollen i planen, så den ikke skæres væk under implementeringen.

Sikr sporbarhed og løbende forbedring

Hold en sporbarhedsmatrix, hvor hvert integrationskrav kan følges fra forretningsbehov gennem krav-ID, standardreference med fuld betegnelse og version, involverede parter, tilhørende testtilfælde, ansvarlig og status. Suppler med en beslutningslog, der viser, hvem der godkendte kravet, hvornår, med hvilken begrundelse og hvilken version af kravet der er gældende. Den log gør det muligt at svare på, hvorfor en integration ser ud, som den gør, når de oprindelige deltagere er skiftet ud.

Sporbarhedsmatrix: Forretningsbehov, krav-ID, standardreference med version, parter, testtilfælde, ansvarlig, status og beslutningslog. Hver række følger kravet fra behov til test og tilbage.

Sporbarhedsmatricen skal mindst have kolonnerne: forretningsbehov, krav-ID, standardreference med version, parter, testtilfælde, ansvarlig, status og beslutningslog. Hver række skal kunne følges fra behov til test og tilbage.

Beslutningsloggen skal vise, hvem der godkendte kravet, hvornår, med hvilken begrundelse og hvilken version der er gældende. Den forklarer integrationen, når deltagerne er skiftet ud.

Kravspecifikationen skal have en ejer og en fast kadence for gennemgang. Når en standard eller grænseflade ændres, opdateres referencer og krav, og ændringen føres tilbage til sporbarhedsmatricen.

Versionsstyr standardreferencerne, fordi standarder revideres – det gælder også ISO 9001, hvor den nye udgave og overgangsperioden er beskrevet i afsnittet om standarder. Kravspecifikationen skal derfor have en ejer og en fast kadence for gennemgang, så referencer og krav opdateres, når en standard eller en grænseflade ændrer sig, og ændringer føres tilbage til sporbarhedsmatricen.

Overvågningstal fra driften skal regelmæssigt sammenholdes med acceptkriterierne. Afvigelser registreres og bruges som input til næste version af kravspecifikationen.

Luk kredsen ved at registrere afvigelser fra implementeringen og bruge dem som input til næste version af kravspecifikationen. Dansk Standard har spurgt 450 ISO 9001-certificerede virksomheder om værdien af standarden, og resultaterne viser, at 70 % mener, at brugen af ISO 9001 i nogen eller i høj grad har bidraget positivt til virksomhedens resultater.

Den type effekt forudsætter, at mål, målinger og afvigelser faktisk følges op. For integrationer betyder det, at overvågningstal fra driften regelmæssigt sammenholdes med acceptkriterierne i kravspecifikationen, og at kravet justeres, når tallene viser det.