1"use strict";(globalThis.webpackChunkschulconnex=globalThis.webpackChunkschulconnex||[]).push([[1276],{5516(e,t,s){s.r(t),s.d(t,{assets:()=>o,contentTitle:()=>h,default:()=>c,frontMatter:()=>d,metadata:()=>n,toc:()=>a});const n=JSON.parse('{"id":"english-api-notes/data-models","title":"Data Models","description":"Format of dates","source":"@site/docs/english-api-notes/data-models.md","sourceDirName":"english-api-notes","slug":"/english-api-notes/data-models","permalink":"/docs/english-api-notes/data-models","draft":false,"unlisted":false,"tags":[],"version":"current","frontMatter":{},"sidebar":"specSidebar","previous":{"title":"English API Notes","permalink":"/docs/english-api-notes/"},"next":{"title":"Code Lists","permalink":"/docs/english-api-notes/code-lists"}}');var r=s(74848),i=s(28453);const d={},h="Data Models",o={},a=[{value:"Format of dates",id:"format-of-dates",level:2},{value:"Organisation",id:"organisation",level:2},{value:"Person",id:"person",level:2},{value:"Personenkontext",id:"personenkontext",level:2},{value:"Personendatensatz",id:"personendatensatz",level:2},{value:"Gruppe",id:"gruppe",level:2},{value:"Gruppenzugeh\xf6rigkeit",id:"gruppenzugeh\xf6rigkeit",level:2},{value:"Gruppendatensatz",id:"gruppendatensatz",level:2},{value:"Sichtfreigabe",id:"sichtfreigabe",level:2},{value:"Lernperiode",id:"lernperiode",level:2},{value:"Beziehung",id:"beziehung",level:2},{value:"Anschrift",id:"anschrift",level:2},{value:"Organisationsbeziehung",id:"organisationsbeziehung",level:2},{value:"VerwaltungspolitischeKodierung",id:"verwaltungspolitischekodierung",level:2}];function l(e){const t={code:"code",em:"em",h1:"h1",h2:"h2",header:"header",p:"p",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",...(0,i.R)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(t.header,{children:(0,r.jsx)(t.h1,{id:"data-models",children:"Data Models"})}),"\n",(0,r.jsx)(t.h2,{id:"format-of-dates",children:"Format of dates"}),"\n",(0,r.jsxs)(t.p,{children:["Dates are always formatted as ",(0,r.jsx)(t.code,{children:"YYYY-MM-DD"}),"."]}),"\n",(0,r.jsx)(t.h2,{id:"organisation",children:"Organisation"}),"\n",(0,r.jsx)(t.p,{children:"An organisation is in most cases a school or a similar relevant organisation in\nan educational context."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"id"}),(0,r.jsx)(t.td,{children:"ID of the organisation. Provided by the server and unique."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"kennung"}),(0,r.jsx)(t.td,{children:"Optional alternative ID of an organisation (in most cases, this will be a national or regional school ID). It needs to be unique within the organisation type."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name"}),(0,r.jsx)(t.td,{children:"Official name of the organisation."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"namensergaenzung"}),(0,r.jsx)(t.td,{children:"Addition to the organisation name (such as a previous name or a suffix that is not part of the name)."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"kuerzel"}),(0,r.jsx)(t.td,{children:"Short name of the organisation."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"anschrift"}),(0,r.jsx)(t.td,{children:"Address of an organisation."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"typ"}),(0,r.jsxs)(t.td,{children:["Organisation type. See code list ",(0,r.jsx)(t.em,{children:"Organisationstyp"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"traegerschaft"}),(0,r.jsxs)(t.td,{children:["Owner type of the organisation. See code list ",(0,r.jsx)(t.em,{children:"Tr\xe4gerschaft"}),"."]})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"person",children:"Person"}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"id"}),(0,r.jsx)(t.td,{children:"ID of the person. Provided by the server and unique."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"referrer"}),(0,r.jsx)(t.td,{children:"The ID that the local client system uses. It is used to map the ID provided by the registry server to the data stored in the local school management software."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"mandant"}),(0,r.jsxs)(t.td,{children:["ID of the organisation the person is attached to. This is mainly a legal relationship, in the sense that this is the controller responsible for maintaining the data for that person as described
1in DSGVO Art. 4 Nr. 7. Persons can be attached contextually to other organisations with the ",(0,r.jsx)(t.code,{children:"Personenkontext"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"stammorganisation"}),(0,r.jsxs)(t.td,{children:["A person can belong administratively to one organisation, but might be delegated to another organisation. The ",(0,r.jsx)(t.code,{children:"stammorganisation"})," (home organisation) is the ID of the organisation the person primarily belongs to."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name"}),(0,r.jsx)(t.td,{children:"Name entity."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name.familienname"}),(0,r.jsx)(t.td,{children:"Surname(s) of the person."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name.vorname"}),(0,r.jsx)(t.td,{children:"Given name(s) of the person."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name.initialenfamilienname"}),(0,r.jsx)(t.td,{children:"Initial or initials of the surname."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name.initialenvorname"}),(0,r.jsx)(t.td,{children:"Initial or initials of the given names."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name.rufname"}),(0,r.jsx)(t.td,{children:"Name the person is commonly called by."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name.titel"}),(0,r.jsx)(t.td,{children:"Title of the person."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name.anrede"}),(0,r.jsx)(t.td,{children:"List of forms of address (e.g. Mr.)."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name.namenssuffix"}),(0,r.jsx)(t.td,{children:"List of name suffixes."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"name.sortierindex"}),(0,r.jsxs)(t.td,{children:["Sort index, denoting the index of the letter of the last name by which a name is to be sorted. The index is zero-based, so a ",(0,r.jsx)(t.code,{children:"0"})," denotes sorting by the first letter of the last name."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"geburt"}),(0,r.jsx)(t.td,{children:"Birth information entity."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"geburt.datum"}),(0,r.jsx)(t.td,{children:"Date of birth."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"geburt.geburtsort"}),(0,r.jsx)(t.td,{children:"Place of birth, usually town and country. If no country is provided, Germany is assumed."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"geschlecht"}),(0,r.jsxs)(t.td,{children:["Sex of person. Refers to code list ",(0,r.jsx)(t.em,{children:"Geschlecht"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"lokalisierung"}),(0,r.jsxs)(t.td,{children:["Localisation based on RFC5646. If none is provided ",(0,r.jsx)(t.code,{children:"de"})," is assumed."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"vertrauensstufe"}),(0,r.jsxs)(t.td,{children:["Describes the level of trust in the data provided. Refers to code list ",(0,r.jsx)(t.em,{children:"Vertrauensstufe"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"auskunftssperre"}),(0,r.jsxs)(t.td,{children:["Blocked information. Is set to ",(0,r.jsx)(t.code,{children:"Ja"})," (yes) if access to information of this person is blocked. Refers to code list ",(0,r.jsx)(t.em,{children:"Boolean"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"revision"}),(0,r.jsx)(t.td,{children:"Revision number of the information. This is mainly used to check on updates and deletes of data sets, whether there have been any changes to the data since it was retrieved by the client system."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"personenkontext",children:"Personenkontext"}),"\n",(0,r.jsx)(t.p,{children:"The person context describes the role of a person within an organisation."}),"\n",(0,r.jsx)(t.p,{children:"A person can have multiple person contexts. These can be in the same organisation the person\nis attached to, but also in different organisations. However, it is not permitted to have\nthe same person context (same role in the same organisation) twice."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"id"}),(0,r.jsx)(t.td,{children:"ID of the person context. Provided by the server and unique."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"referrer"}),(0,r.jsx)(t.td,{children:"The ID that the local client system uses. It is used to map the ID provided by the registry server to the data stored in the local school management software."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"mandant"}),(0,r.jsx)(t.td,{children:"ID of the organisation the person context is attached to."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"organisation"}),(0,r.jsxs)(t.td,{children:["Organisation the person has a role in. See ",(0,r.jsx)(t.em,{children:"Organisation"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"rolle"}),(0,r.jsxs)(t.td,{children:["Role the person has in the organisation. Refers to code list ",(0,r.jsx)(t.em,{children:"Rolle"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"personenstatus"}),(0,r.jsxs)(t.td,{children:["Status the person has in relation to a role. See code list ",(0,r.jsx)(t.em,{children:"Personenstatus"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"jahrgangsstufe"}),(0,r.jsxs)(t.td,{children:["School grade or form a person is currently in or associated with. Refers to code list ",(0,r.jsx)(t.em,{children:"Jahrgangsstufe"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"sichtfreigabe"}),(0,r.jsx)(t.td,{children:"Boolean value that denotes whether the data is only visible due to another organisation providing read access."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"loeschung.zeitpunkt"}),(0,r.jsx)(t.td,{children:"Date and time when the person context is to be deleted."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"revision"}),(0,r.jsx)(t.td,{children:"Revision number of the information. This is mainly used to check on updates and deletes of data sets, whether there has been any changes to the data since it was retrieved by the client system."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"personendatensatz",children:"Personen
1datensatz"}),"\n",(0,r.jsx)(t.p,{children:"A \u201ePersonendatensatz\u201c is essentially a wrapper object containing data about a person and\nthe associated person contexts of that person."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"person"}),(0,r.jsx)(t.td,{children:"Person."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"personenkontexte"}),(0,r.jsx)(t.td,{children:"Array of person contexts."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"gruppe",children:"Gruppe"}),"\n",(0,r.jsx)(t.p,{children:"A group (Gruppe) allows it to handle a number of persons as a group. In most cases\nthis is a school class or similar organisational structure."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"id"}),(0,r.jsx)(t.td,{children:"ID of the group. Provided by the server and unique."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"mandant"}),(0,r.jsx)(t.td,{children:"ID of the organisation that owns the group dataset."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"orgid"}),(0,r.jsxs)(t.td,{children:["ID of the organisation that the group is attached to. Often the same as ",(0,r.jsx)(t.code,{children:"mandant"}),", but not always so."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"referrer"}),(0,r.jsx)(t.td,{children:"Referrer is the ID that the local client system uses. It is used to map the ID provided by the registry server to the data stored in the local school management software."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"bezeichnung"}),(0,r.jsx)(t.td,{children:"Describes the group."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"thema"}),(0,r.jsx)(t.td,{children:"Keywords describing the theme of the group, short text, ideally less than 35 characters."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"beschreibung"}),(0,r.jsx)(t.td,{children:"Additional optional description of the purpose of the group."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"typ"}),(0,r.jsxs)(t.td,{children:["Type of the group. Refers to code list ",(0,r.jsx)(t.em,{children:"Gruppentyp"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"Bereich"}),(0,r.jsxs)(t.td,{children:["Additional group qualifyer (mandatory, optional, basic, advanced...). Refers to code list ",(0,r.jsx)(t.em,{children:"Gruppenbereich"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"Optionen"}),(0,r.jsxs)(t.td,{children:["Additional group options. Usually referring to language used (bilingual, native language). Refers to code list ",(0,r.jsx)(t.em,{children:"Gruppenoption"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"differenzierung"}),(0,r.jsxs)(t.td,{children:["Specific differentiation in some educational branches. Refers to code list ",(0,r.jsx)(t.em,{children:"Gruppendifferenzierung"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"bildungsziele"}),(0,r.jsxs)(t.td,{children:["Educational branch. Refers to code list ",(0,r.jsx)(t.em,{children:"Bildungsziel"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"jahrgangsstufen"}),(0,r.jsxs)(t.td,{children:["Form or course level. Refers to code list ",(0,r.jsx)(t.em,{children:"Jahrgangsstufe"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"faecher"}),(0,r.jsx)(t.td,{children:"Array to list the topics covered in the group."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"faecher.kennung"}),(0,r.jsxs)(t.td,{children:["Topic covered. Refers to code list ",(0,r.jsx)(t.em,{children:"F\xe4cherkanon"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"faecher.bezeichnung"}),(0,r.jsxs)(t.td,{children:["Name of a topic if it is not in the code list ",(0,r.jsx)(t.em,{children:"F\xe4cherkanon"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"referenzgruppen"}),(0,r.jsx)(t.td,{children:"Array of reference groups for this group. Allows the association of members in one or more other groups to this group. The aim is to simplify the handling of courses and school classes by allowing, for example, to attach a whole class to a course, without the need to assign every student individually."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"referenzgruppen.grupid"}),(0,r.jsx)(t.td,{children:"ID of the reference group."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"referenzgruppe.rollen"}),(0,r.jsx)(t.td,{children:"Roles in the reference group (\u201eGruppenrollen\u201d) to be selected for the group. If no roles are specified, all persons are selected. (The main purpose for this filter is that a class might contain a teacher and students, but only the students from this reference group participate in another group.)"})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"laufzeit"}),(0,r.jsx)(t.td,{children:"Defines the start and end date of a group. Both dates can be either defined by directly specifying a date or, alternatively, by associating a teaching period (like a year or a semester) with the group."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"laufzeit.von"}),(0,r.jsx)(t.td,{children:"Start date of the group as a date."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"laufzeit.vonlernperiode"}),(0,r.jsxs)(t.td,{children:["Start date of the group as a reference to a teaching period. Refers to code list ",(0,r.jsx)(t.em,{children:"Lernperiode"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"laufzeit.bis"}),(0,r.jsx)(t.td,{children:"End date of the group as a date."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"laufzeit.bislernperiode"}),(0,r.jsxs)(t.td,{children:["End date of the group as a reference to a teaching period. Refers to code list ",(0,r.jsx)(t.em,{children:"Lernperiode"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"revision"}),(0,r.jsx)(t.td,{children:"Revision number of the information. This is mainly used to check on updates and deletes of data sets, whether there have been any changes to the data since it was retrieved by the client system."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"gruppenzugeh\xf6rigkeit",children:"Gruppenzugeh\xf6rigkeit"}),"\n",(0,r.jsx)(t.p,{children:"The group membership connects a person context to a group. In addition to the role a person\nhas in an organisation, an additional role in the group needs to be provided."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"id"}),(0,r.jsx)(t.td,{children:"ID of the group membership. Provided by the server and unique."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"mandant"}),(0,r.jsx)(t.td,{children:"ID of the organisation that owns the group dataset."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"referrer"}),(0,r.jsx)(t.td,{children:"Referrer is the ID that the local client system uses. It is used to map the ID provided by the registry server to the data stored in the local school management software."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"ktid"}),(0,r.jsx)(t.td,{children:"ID of the person context associated with the group."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"rollen"}),(0,r.jsxs)(t.td,{children:["Role of a person within the group. Refers to code list ",(0,r.jsx)(t.em,{children:"Gruppenrolle"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"von"}),(0,r.jsx)(t.td,{children:"Begin of the group membership."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"bis"}),(0,r.jsx)(t.td,{children:"End of the group membership."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"revision"}),(0,r.jsx)(t.td,{children:"Revision number of the information. This is mainly used to check on updates and deletes of data sets, whether there have been any changes to the data since it was retrieved by the client system."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"gruppendatensatz",children:"Gruppendatensatz"}),"\n",(0,r.jsx)(t.p,{children:"The \u201egroup data set\u201d is a wrapper object to link a group to a number of group memberships."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"gruppe"}),(0,r.jsx)(t.td,{children:"Group."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"gruppenzugehoerigkeiten"}),(0,r.jsx)(t.td,{children:"Array of group memberships."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"sichtfreigabe",children:"Sichtfreigabe"}),"\n",(0,r.jsx)(t.p,{children:"This data model allows organisations to make information about a person context\navailable to another organisation. Information provided as read-only. (The word\n\u201eSichtfreigabe\u201c means \u201epermission for viewing.\u201c)"}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"id"}),(0,r.jsx)(t.td,{children:"ID of the viewing permission."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"orgid"}),(0,r.jsx)(t.td,{children:"ID of the organisation that is allowed to view this."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"von"}),(0,r.jsx)(t.td,{children:"Date when access starts."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"bis"}),(0,r.jsx)(t.td,{children:"Date when access ends."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"revision"}),(0,r.jsx)(t.td,{children:"Revision number of the information. This is used to check on updates and deletes, whether there have been any changes to the data since it was retrieved by the client system."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"lernperiode",children:"Lernperiode"}),"\n",(0,r.jsx)(t.p,{children:"A teaching period (\u201eLernperiode\u201d) is a time period in which organisations can offer groups.\nIn most cases these periods are school years or semesters."}),"\n",(0,r.jsx)(t.p,{children:"Teaching periods are not modifiable via APIs, they are provided in the same manner as code lists.\nHowever, as they are not simple lists, but structured objects, their structure is described here."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"code"}),(0,r.jsx)(t.td,{children:"Code of the teaching period."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"bezeichnung"}),(0,r.jsxs)(t.td,{children:["Description of teaching period, for example ",(0,r.jsx)(t.code,{children:'"Schuljahr 2023/2024"'}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"typ"}),(0,r.jsxs)(t.td,{children:["Type of the teaching period. Refers to codelist ",(0,r.jsx)(t.em,{children:"Lernperiodentyp"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"beginn"}),(0,r.jsx)(t.td,{children:"Beginning date of teaching period."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"ende"}),(0,r.jsx)(t.td,{children:"Ending date of teaching period."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"beziehung",children:"Beziehung"}),"\n",(0,r.jsx)(t.p,{children:"This describes a relationship between two persons (like one person being the legal guardian,\ncarer or tutor of another). The relation connects to person contexts."}),"\n",(0,r.jsxs)(t.p,{children:["Relationsships are of the \u201ehas a\u201d kind. If a person context of person A has a relationship\nof ",(0,r.jsx)(t.code,{children:"SchB"})," with a person context (",(0,r.jsx)(t.code,{children:"ktid"}),") of person B, then A has B as a \u201eSchulbegleiter\u201d."]}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"id"}),(0,r.jsx)(t.td,{children:"ID of the relation."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"ktid"}),(0,r.jsxs)(t.td,{children:["ID of the person context to the person who has the relationship. For example, if the relation is \u201elegal guardian\u201d, then the person with the current person context is the person with the legal guardian, while the person with the person context with the ",(0,r.jsx)(t.code,{children:"ktid"})," is the legal guardian."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"beziehung"}),(0,r.jsxs)(t.td,{children:["Relations. Refers to code list ",(0,r.jsx)(t.em,{children:"Beziehungen"}),"."]})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"revision"}),(0,r.jsx)(t.td,{children:"Revision number of the information. This is mainly used to check on updates and deletes of data sets, whether there have been any changes to the data since it was retrieved by the client system."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"anschrift",children:"Anschrift"}),"\n",(0,r.jsx)(t.p,{children:"This is the address (physical location) of, for example, an organisation."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"postleitzahl"}
1),(0,r.jsx)(t.td,{children:"ZIP Code."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"ort"}),(0,r.jsx)(t.td,{children:"Town name."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"ortsteil"}),(0,r.jsx)(t.td,{children:"Urban district, if a more specific location than town name is required."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"verwaltungspolitischekodierung"}),(0,r.jsx)(t.td,{children:"Administrative area in which the address is located."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"organisationsbeziehung",children:"Organisationsbeziehung"}),"\n",(0,r.jsx)(t.p,{children:"Describes the relationship of two organisations."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsxs)(t.tbody,{children:[(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"orgid"}),(0,r.jsx)(t.td,{children:"ID of the organisation the current organisation has a \u201ehas as\u201c relation."})]}),(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"organisationsbeziehung"}),(0,r.jsx)(t.td,{children:"Type of relation between the organisations."})]})]})]}),"\n",(0,r.jsx)(t.h2,{id:"verwaltungspolitischekodierung",children:"VerwaltungspolitischeKodierung"}),"\n",(0,r.jsx)(t.p,{children:"This is the administrative area in which the address is located. Currently only attribute is the 'bundesland' (one of the sixteen German states)."}),"\n",(0,r.jsxs)(t.table,{children:[(0,r.jsx)(t.thead,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.th,{children:"Attribute"}),(0,r.jsx)(t.th,{children:"Description"})]})}),(0,r.jsx)(t.tbody,{children:(0,r.jsxs)(t.tr,{children:[(0,r.jsx)(t.td,{children:"bundesland"}),(0,r.jsx)(t.td,{children:"One of the sixteen German states."})]})})]})]})}function c(e={}){const{wrapper:t}={...(0,i.R)(),...e.components};return t?(0,r.jsx)(t,{...e,children:(0,r.jsx)(l,{...e})}):l(e)}},28453(e,t,s){s.d(t,{R:()=>d,x:()=>h});var n=s(96540);const r={},i=n.createContext(r);function d(e){const t=n.useContext(i);return n.useMemo(function(){return"function"==typeof e?e(t):{...t,...e}},[t,e])}function h(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:d(e.components),n.createElement(i.Provider,{value:t},e.children)}}}]);
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.