11.4.0
- Morten Rembøl Jacobsen
- 1 Referencer
- 2 API ændringer
- 2.1 “Eksterne referencer” udvides med feltet Uuid
- 2.2 Ressourcen it-system-usages udvides med API klientens rettigheder i kontekst af en specifik registrering
- 2.2.1 JIRA
- 2.2.2 Beskrivelse
- 2.2.3 API ændringer
- 2.3 Ressourcer for udfaldsrum udvides med “description”
- 2.3.1 JIRA
- 2.3.2 Beskrivelse
- 2.3.3 Eksempel
- 2.3.4 GET /api/v2/it-contract-contract-template-types
- 2.4 Ressourcer IT-System udvides med “Scope”
- 2.4.1 JIRA
- 2.4.2 Beskrivelse
- 2.4.3 Eksempel
Referencer
JIRA
https://os2web.atlassian.net/projects/KITOSUDV/versions/11187/tab/release-report-all-issues
GitHub
https://github.com/os2kitos/kitos/releases/tag/11.4.0
API ændringer
“Eksterne referencer” udvides med feltet Uuid
JIRA
https://os2web.atlassian.net/browse/KITOSUDV-3812
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-usagesit-contractsdata-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
Uuidskal eksistere.
KITOS behandler fremover opdateringer til feltet således:
Alle eksisterende referencer der er identificeret med
Uuidi opdateringen, opdateres med data fra opdateringen.Alle eksisterende eksterne referencer, der ikke er identificeret med
Uuidi 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
https://os2web.atlassian.net/browse/KITOSUDV-4062
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
https://os2web.atlassian.net/browse/KITOSUDV-4061
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
Ressourcer IT-System udvides med “Scope”
JIRA
https://os2web.atlassian.net/browse/KITOSUDV-4070
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