11.4.0

Referencer

JIRA

OS2KITOS-UDV | Releases | 11.4.0Released

GitHub

Release 11.4.0 · os2kitos/kitos

API ændringer

“Eksterne referencer” udvides med feltet Uuid

JIRA

KITOSUDV-3812: API V2 - Tilføj UUID på "Eksterne referencer"Leveret

Beskrivelse

For at understøtte unik identifikation af en udlæst ekstern reference, eksponeres en Uuid nu for alle eksterne referencer, hvilket udstilles af ressourcerne

  • it-system-usages

  • it-contracts

  • data-processing-registrations

LÆS

Læsemodellens eksterne referencer udvides med et garanteret Uuid felt.

Uuid udlæst kan bruges til senere opdatering af samme reference.

Eksempel

{ ... .. "externalReferences": [ { "uuid": "00000000-0000-0000-0000-000000000000", "title": "string", "documentId": "string", "url": "string", "masterReference": true } ] }

SKRIV

Skrivemodellen udvides ifm. PUT og PATCH med et valgfrit felt Uuid. Det er derfor ikke påkrævet at man leverer en værdi i feltet, men hvis man gør, gælder følgende regler:

  • En eksisterende ekstern reference med samme Uuid skal eksistere.

KITOS behandler fremover opdateringer til feltet således:

  • Alle eksisterende referencer der er identificeret med Uuid i opdateringen, opdateres med data fra opdateringen.

  • Alle eksisterende eksterne referencer, der ikke er identificeret med Uuid i opdateringen, slettes.

  • Alle eksterne referencer fra opdateringen, som ikke er identificeret med Uuid, tilføjes.

Eksempel

{ "externalReferences": [ { "uuid": "779a7967-73eb-444d-8278-6622123759f8", "title": "ref1", "documentId": "string", "url": "string", "masterReference": true }, { "title": "ref2", "documentId": "string", "url": "string", "masterReference": false } ] }

Ovenstående eksempel indeholder to referencer, hvoraf én af dem skal være der i forvejen, da den er identificeret med Uuid: 779a7967-73eb-444d-8278-6622123759f8.

Efter opdateringen vil registreringen, uanset eksisterende data, kun indeholde to referencer, da hele “mængden” erstattes.

Ressourcen it-system-usages udvides med API klientens rettigheder i kontekst af en specifik registrering

JIRA

KITOSUDV-4062: API V2: Extend it-system-usages API with a "permissions" routeLeveret

Beskrivelse

Funktionaliteten understøtter, at API klienten kan udlæse specifikke rettigheder i kontekst af en given registrering.

API ændringer

Følgende endpoint tilføjes:

GET /api/v2/it-system-usages/{systemUsageUuid}/permissions

{ "read": true, "modify": true, "delete": false }

Ressourcer for udfaldsrum udvides med “description”

JIRA

KITOSUDV-4061: API V2 - Extend response DTO with "description" for all choice typesLeveret

Beskrivelse

Alle DTO’er for “udfaldsrum” udvides med feltet description, der indeholder den udvidede beskrivelse for et valg. Det er altid den beskrivelse der er aktiv i organisationen, som returneres.

Eksempel

GET /api/v2/it-contract-contract-template-types

[ { "description": "string", "uuid": "00000000-0000-0000-0000-000000000000", "name": "string" } ]

Ressourcer IT-System udvides med “Scope”

JIRA

KITOSUDV-4070: API V2: Expose "AccessModifier" field in IT-System for READLeveret

Beskrivelse

It-System eksponerer nu feltet scope som kan antage værdierne Local eller Public. Feltet modsvarer det felt der kendes som Synlighed i KITOS brugerfladen og indikerer som IT-Systemet kun er relevant/tilgængeligt for medlemmer af organisationen det er oprettet i, eller om det er tiltænkt tværgående anvendelse.

For de fleste It-Systemers tilfælde vil værdien være Public.

Eksempel

{ . .. "scope": "Local", ... . }