1"use strict";(globalThis.webpackChunkschulconnex=globalThis.webpackChunkschulconnex||[]).push([[8310],{28453(e,n,r){r.d(n,{R:()=>d,x:()=>o});var t=r(96540);const s={},i=t.createContext(s);function d(e){const n=t.useContext(i);return t.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function o(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:d(e.components),t.createElement(i.Provider,{value:n},e.children)}},35152(e,n,r){r.r(n),r.d(n,{assets:()=>l,contentTitle:()=>o,default:()=>a,frontMatter:()=>d,metadata:()=>t,toc:()=>c});const t=JSON.parse('{"id":"datenmodell-qs/personenkontext","title":"Personenkontext","description":"Der Personenkontext gibt an, in welcher Rolle der Dienst von nutzenden Personen in Anspruch genommen wird.","source":"@site/docs/datenmodell-qs/personenkontext.md","sourceDirName":"datenmodell-qs","slug":"/datenmodell-qs/personenkontext","permalink":"/docs/datenmodell-qs/personenkontext","draft":false,"unlisted":false,"tags":[{"inline":true,"label":"Verbindlich","permalink":"/docs/tags/verbindlich"}],"version":"current","frontMatter":{"tags":["Verbindlich"]},"sidebar":"spezQuellsystemeSidebar","previous":{"title":"Personendatensatz","permalink":"/docs/datenmodell-qs/personendatensatz"},"next":{"title":"Referenzgruppe","permalink":"/docs/datenmodell-qs/referenzgruppe"}}');var s=r(74848),i=r(28453);const d={tags:["Verbindlich"]},o="Personenkontext",l={},c=[];function h(e){const n={a:"a",code:"code",em:"em",h1:"h1",header:"header",p:"p",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",...(0,i.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(n.header,{children:(0,s.jsx)(n.h1,{id:"personenkontext",children:"Personenkontext"})}),"\n",(0,s.jsx)(n.p,{children:"Der Personenkontext gibt an, in welcher Rolle der Dienst von nutzenden Personen in Anspruch genommen wird.\nDer Personenkontext umfasst neben der Rolle auch Informationen \xfcber die Organisation, an der\ndiese Rolle ausgef\xfchrt wird."}),"\n",(0,s.jsx)(n.p,{children:"Eine Person kann einen oder mehrere Personenkontexte besitzen, indem sie beispielsweise an derselben\nSchule sowohl die Rollen \u201eSchulleiter\u201c als auch \u201eErziehungsberechtigter\u201c hat, oder an einer Schule\ndie Rolle \u201eLehrender\u201c und an einer weiteren Organisation \u201eLernender\u201c ist."}),"\n",(0,s.jsx)(n.p,{children:"In einem Personenkontext kann einer Person jeweils nur eine Organisation und eine Rolle in dieser Organisation zugewiesen werden. Diese Rollen sind soweit wie m\xf6glich disjunkt, um zu vermeiden, dass es zu Unsch\xe4rfen in der Nutzung von Personenkontexten kommt. Hat eine Person mehrere Rollen (beispielsweise Organisationsadministratorin und Lehrende), so sind entsprechend mehrere Personenkontexte zu erstellen und daf\xfcr Sorge zu tragen, dass diesen Personenkontexten zugeordnete Informationen (wie Gruppen, Beziehungen, Sichtfreigaben) der Rolle des jeweiligen Personenkontexts entsprechen."}),"\n",(0,s.jsx)(n.p,{children:"Es d\xfcrfen jedoch keine inhaltlich identischen Personenkontexte angelegt werden. Insbesondere ist es\nunzul\xe4ssig, dieselbe Kombination aus Organisation und Rolle einer Person in unterschiedlichen\nPersonenkontexten zuzuweisen."}),"\n",(0,s.jsx)(n.p,{children:"Bei der Abfrage einer Person \xfcber die API k\xf6nnen mehrere zur Person geh\xf6renden Personenkontexte als\nListe mit zur\xfcckgegeben werden."}),"\n",(0,s.jsxs)(n.p,{children:["Nicht alle Kombinationen von Attributwerten sind sinnvoll. So ist beispielsweise die Kombination\neiner Jahrgangsstufe mit einer anderen Rolle als ",(0,s.jsx)(n.code,{children:"Lern"})," in der Regel nicht sinnvoll."]}),"\n",(0,s.jsxs)(n.table,{children:[(0,s.jsx)(n.thead,{children:(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.th,{children:"Attribut"}),(0,s.jsx)(n.th,{children:"Typ"}),(0,s.jsx)(n.th,{children:"Anzahl"}),(0,s.jsx)(n.th,{children:"Bemerkung"}),(0,s.jsx)(n.th,{children:"Qualifizierter Name"})]})}),(0,s.jsxs)(n.tbody,{children:[(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"id"}),(0,s.jsx)(n.td,{children:"String (UTF-8)"}),(0,s.jsx)(n.td,{children:"1"}),(0,s.jsx)(n.td,{children:"ID des Personenkontexts. Wird vom Schulconnex-Server vergeben und ist eindeutig. Dieses Attribut ist unver\xe4nderbar (immutable)."}),(0,s.jsx)(n.td,{})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"referrer"}),(0,s.jsx)(n.td,{children:"String (UTF-8)"}),(0,s.jsx)(n.td,{children:"0..1"}),(0,s.jsx)(n.td,{children:"ID des Personenkontexts im Quellsystem. Wird vom Quellsystem vergeben und muss im Quellsystem eindeutig sein."}),(0,s.jsx)(n.td,{})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"mandant"}),(0,s.jsx)(n.td,{children:"String (UTF-8)"}),(0,s.jsx)(n.td,{children:"1"}),(0,s.jsx)(n.td,{children:"ID des Mandanten, dem der Personenkontext zugeordnet ist. Wird vom Schulconnex-Server vergeben und ist eindeutig."}),(0,s.jsx)(n.td,{})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"organisation"}),(0,s.jsx)(n.td,{children:(0,s.jsx)(n.a,{href:"organisation",children:"Organisation"})}),(0,s.jsx)(n.td,{children:"1"}),(0,s.jsx)(n.td,{children:"Organisation."}),(0,s.jsx)(n.td,{})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"rolle"}),(0,s.jsx)(n.td,{children:"String (Code)"}),(0,s.jsx)(n.td,{children:"1"}),(0,s.jsxs)(n.td,{children:["Rolle der Person innerhalb der Organisation. Referenz auf einen Code der Codeliste ",(0,s.jsx)(n.em,{children:"Rolle"}),"."]}),(0,s.jsx)(n.td,{children:(0,s.jsx)(n.code,{children:"urn:schulconnex:de:kern:personenkontext:rolle"})})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"erreichbarkeiten"}),(0,s.jsx)(n.td,{children:(0,s.jsxs)(n.em,{children:["Array[",(0,s.jsx)(n.a,{href:"erreichbarkeit",children:"Erreichbarkeit"}),"]"]})}),(0,s.jsx)(n.td,{children:"0..n"}),(0,s.jsx)(n.td,{children:"Liste (Array) Erreichbarkeiten."}),(0,s.jsx)(n.td,{children:(0,s.jsx)(n.code,{children:"urn:schulconnex:de:kern:personenkontext:erreichbarkeiten"})})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"personenstatus"}),(0,s.jsx)(n.td,{children:"String (Code)"}),(0,s.jsx)(n.td,{children:"0..1"}),(0,s.jsxs)(n.td,{children:["Status, den eine Person in einer Organisation in Bezug auf eine bestimmte Rolle hat, Referenz auf einen Code der Codeliste ",(0,s.jsx)(n.em,{children:"Personenstatus"}),"."]}),(0,s.jsx)(n.td,{children:(0,s.jsx)(n.code,{children:"urn:schulconnex:de:kern:personenkontext:personenstatus"})})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"jahrgangsstufe"}),(0,s.jsx)(n.td,{children:"String (Code)"}),(0,s.jsx)(n.td,{children:"0..1"}),(0,s.jsxs)(n.td,{children:["Jahrgangsstufe, die eine Person in der Organisation in einer bestimmten Rolle besucht, Referenz auf Code der Codeliste ",(0,s.jsx)(n.em,{children:"Jahrgangsstufe"}),"."]}),(0,s.jsx)(n.td,{children:(0,s.jsx)(n.code,{children:"urn:schulconnex:de:kern:personenkontext:jahrgangsstufe"})})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"sichtfreigabe"}),(0,s.jsx)(n.td,{children:"String (Code)"}),(0,s.jsx)(n.td,{children:"0..1"}),(0,s.jsxs)(n.td,{children:["Attribut gibt an, ob dieser Personenkontext aufgrund der Freigabe durch eine andere Organisation sichtbar ist. Ist ",(0,s.jsx)(n.code,{children:"sichtfreigabe"})," nicht gesetzt, so entspricht das dem Wert ",(0,s.jsx)(n.code,{children:"nein"}),". Der Wert von Sichtfreigabe ist Boolean nach Codetabelle ",(0,s.jsx)(n.em,{children:"Boolean"}),"."]}),(0,s.jsx)(n.td,{})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"loeschung"}),(0,s.jsx)(n.td,{children:(0,s.jsx)(n.em,{children:"Struktur"})}),(0,s.jsx)(n.td,{children:"0..1"}),(0,s.jsx)(n.td,{children:"Aktuell gibt es zu L\xf6schungen nur ein Attribut (Zeitpunkt), eventuell werden in sp\xe4teren Versionen weitere Attribute hinzugef\xfcgt."}),(0,s.jsx)(n.td,{})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"loeschung.zeitpunkt"}),(0,s.jsx)(n.td,{children:"String (datetime)"}),(0,s.jsx)(n.td,{children:"1"}),(0,s.jsxs)(n.td,{children:["Datum und Uhrzeit der L\xf6schung des Personenkontexts. Das Format des L\xf6schzeitpunkts ist ",(0,s.jsx)(n.code,{children:"YYYY-MM-DDThh:mmZ"})," als UTC-Zeitpunkt nach ISO 8601 (ohne Sekunden, Stunden von 00 bis 23, z. B. 2026-09-30T22:00Z). Solange ein Personenkontext nicht gel\xf6scht wurde, kann das Attribut ",(0,s.jsx)(n.code,{children:"loeschung.zeitpunkt"})," ge\xe4ndert oder gel\xf6scht werden. Ist das Attribut ",(0,s.jsx)(n.code,{children:"loeschung"})," vorhanden, so muss der Zeitpunkt gesetzt sein."]}),(0,s.jsx)(n.td,{})]}),(0,s.jsxs)(n.tr,{children:[(0,s.jsx)(n.td,{children:"revision"}),(0,s.jsx)(n.td,{children:"String (UTF-8)"}),(0,s.jsx)(n.td,{children:"1"}),(0,s.jsx)(n.td,{children:"Revision des Personenkontext. Wird vom Schulconnex-Server mit der Erstellung des Datensatzes sowie Aktualisierung generiert. Dieser Wert kann nicht von Quellsystemen oder Diensten gesetzt werden."}),(0,s.jsx)(n.td,{})]})]})]})]})}function a(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(h,{...e})}):h(e)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.