Koppeltaal 2.0 Implementation Guide (Full Documentation)
0.16.5 - ci-build
Koppeltaal 2.0 Implementation Guide (Full Documentation)
0.16.5 - ci-build
Koppeltaal 2.0 Implementation Guide (Full Documentation) - Local Development build (v0.16.5) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Deze pagina bevat een overzicht van de wijzigingen per versie van de Koppeltaal 2.0 Implementation Guide.
Alles hieronder is ná de release van 0.16.4 (28 juli 2026) op main gekomen. Het stond eerder abusievelijk onder 0.16.4, terwijl die versie toen al was uitgebracht.
introspect, authorize, idp call en idp login (subtype DCM#110122, onderscheiden via de outcomeDesc-prefix) en Application User Authentication (subtype DCM#110126) — plus een Device-voorbeeld voor de externe IdP.Task.status op de KT2DeletePendingTask required bindt aan de vijf statussen die in de opschoon-flow voorkomen (requested, on-hold, accepted, cancelled, completed) in plaats van alle twaalf R4 task-statussen.task-delete-pending-on-hold toegevoegd — de noodrem met een coded reden, zodat die tak van de flow ook een voorbeeld heeft.code is nu 1..1 en required gebonden aan koppeltaal-task-code; de overgeërfde FHIR-core voorbeeldbinding bevatte de vaste code delete-pending niet, waardoor de profielpagina naar de verkeerde codelijst wees. status is required gebonden aan de nieuwe KoppeltaalDeletePendingTaskStatus ValueSet. authoredOn is 1..1 als aankondigingsmoment waarop de grace period start. statusReason.coding is 1..1 en de verplichte coding.display is losgelaten naar 0..1. Drie invarianten dwingen nu af wat het profiel al beschreef: kt2-dpt-status-reason (reden verplicht bij status = on-hold, verboden bij elke andere status), kt2-dpt-delete-flow-marker (de server-owned kt2-delete-flow-marker in meta.security) en kt2-dpt-grace-deadline (deadline ná authoredOn). Het profiel zet dezelfde elementen dicht als KT2_Task, plus description. Title verwijderd zodat de kop gelijk is aan de overige profielen.^version toegevoegd. De ValueSet declareert het shareablevalueset-profiel, dat version verplicht stelt (1..1), maar leverde die niet.code (delete-pending), intent = order, for (KT2_Patient), owner en requester (KT2_Device), verplichte server-beheerde restriction.period.end (grace-deadline) en een coded statusReason voor de noodrem-reden. Reageren gebeurt via de native Task-lifecycle (on-hold als noodrem, accepted als groen licht); de server valideert de overgangen. Vervangt PR #67.delete-pending toegevoegd voor de aankondigings-Task.meta.security-marker kt2-delete-flow waarmee de Koppeltaalvoorziening de opschoon-resources labelt (lezen domein-breed, schrijven owner-scoped op de Task).Task.statusReason op de KT2DeletePendingTask), met required binding, verplichte coding.display en text 0..0 — afdwingbaar PII-vrij omdat de Task domein-breed leesbaar is.task-delete-pending (aankondigings-Task), device-koppeltaalvoorziening (Device van de Koppeltaalvoorziening) en de zes geaggregeerde opschoning-lifecycle AuditEvents auditevent-opschoning-archive / -hold / -unhold / -grace-reset / -reactivate / -destroy (ISO 21089 lifecycle-codes op type, entity.what altijd de Patient, de Koppeltaalvoorziening als agent); alle voorbeelden dragen de kt2-delete-flow-marker.entity.what expliciet vastgelegd als Reference(Resource|*) zodat de IG Publisher het doelprofiel niet versie-pint naar Resource|4.0.1. Die versie-pin brak de "elke resource"-afhandeling van de FHIR-validator, waardoor AuditEvents met een Patient-referentie in entity.what werden geweigerd (Reference_REF_WrongTarget).target = Device toegevoegd. De reference-SearchParameter had geen target-element, waardoor servers die SearchParameter.target gebruiken voor het valideren van getypeerde zoekwaarden (bijv. resource-origin=Device/<id> bij search narrowing) deze zoekopdrachten afwezen. De resource-origin-extensie verwijst uitsluitend naar (KT2_)Device.target = ActivityDefinition verwijderd; target is alleen van toepassing op reference-SearchParameters en dit is een token-parameter.endpoint-connection-type en audit-event-type hernoemd naar KT2-endpoint-connection-type en KT2-audit-event-type om conflict met standaard FHIR R4 ValueSets in HAPI FHIR te voorkomen. Canonical URLs blijven ongewijzigd.relatedperson-nictiz-example die botste met Nictiz dependency (nl-core-ContactPerson-01-nictiz), waardoor Simplifier geen package kon aanmaken.Versie bump na merge PR #52 (profiel changes in 0.15.x).
participant[patient] op 0..0 gezet — de patiënt wordt altijd via CareTeam.subject gerepresenteerd, niet als participant768821004 (Care team coordinator) valt nu onder Zorgondersteuner autorisatieniveau405623001) en Zorgondersteuner (224608005 + 768821004)224609002 → 224608005, Case Manager 224608005 → 768821004224610006 → 407542009, Wettelijk vertegenwoordiger 419358007 → 310391000146105, Naaste 133932002 → 125677006, Buddy 125680007 → 62071000kt2-role-display-validation invariant description hersteldGeen wijzigingen ten opzichte van 0.15.0-beta.9.
kt2-role-display-validation valideert nu alleen COD472 codes 23 (Contactpersoon) en 24 (Wettelijke vertegenwoordiger)kt2-role-display-validation toegevoegd0..0 cardinaliteit op choice type elementen (KT2_Patient, KT2_ActivityDefinition)feature naar koppeltaal-expansionfeature naar koppeltaal-expansionKoppeltaalFeatures CodeSystem → KoppeltaalExpansionKoppeltaalFeatures_VS ValueSet → KoppeltaalExpansion_VSkoppeltaal-features naar koppeltaal-expansionTask.code = viewKoppeltaalExpansion_VS (http://vzvz.nl/fhir/ValueSet/koppeltaal-expansion)extensible naar requiredKT2_ResourceOrigin extension gecorrigeerd van 0..* naar 0..1