girgen / skolschema

Skolschema – standard för informationsöverföring mellan olika system som krävs för att skapa skolans schema
4 stars 6 forks source link

Exempel har relation mellan User och StudentGroup, men inte standarden. #13

Closed stnor closed 5 years ago

stnor commented 5 years ago

https://github.com/girgen/skolschema/blob/master/exempel/user-student-get.json#L63 En relation mellan User och StudentGroup som inte finns i standarden vad jag kan se. Verkar vettig, men är standarden då felaktig?

Vad gäller?

girgen commented 5 years ago

Hej! Hur menar du med inte finns i standarden? Att den inte är beskriven i löptexten?

https://github.com/girgen/skolschema/blob/8d8664c359a7a4e3acfe5cadc840a27ba9e44e22/schema/User.json#L67

Det är för att den är read-only, man kan inte skriva medlemsskap när man POST:ar en användare, men de presenteras vid GET för att förenkla för verktyg som använder data i från SCIM-servern direkt. Dessa är tillhör inte direkt domänmodellen och har inte dokumenteras i löptext utan bara i schemat och exemplen. Dessa är dock en del av standarden. :)

9 dec. 2018 kl. 16:06 skrev Stefan Norberg notifications@github.com:

https://github.com/girgen/skolschema/blob/master/exempel/user-student-get.json#L63 https://github.com/girgen/skolschema/blob/master/exempel/user-student-get.json#L63 En relation mellan User och StudentGroup som inte finns i standarden vad jag kan se. Verkar vettig, men är standarden då felaktig?

Vad gäller?

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/girgen/skolschema/issues/13, or mute the thread https://github.com/notifications/unsubscribe-auth/AAxqbgNkA8ZesSsHuXNzXInWNgYsJ7ydks5u3ScGgaJpZM4ZKKom.

stnor commented 5 years ago

Hej och tack för svar! Det finns inget namn på relationen i UML-diagrammet i den riktningen och det du skriver ovan framgår inte av Worddokumentet vad jag kan se, utan de framgår bara av schemafilerna.

Det vore fint med ett sekvensdiagram som beskriver i vilken ordning respektive entiteter bör/skall skapas. Det kanske är självklart för dig som arbetat länge med detta, men jag tror det är långt ifrån självklart för alla.

Som ett exempel: Hur skapas en Enrolement? Skickar man den med User på enrolements? Hur uppdaterar man en Enrolement på en User? Hur tar man bort en enrolement? Jag har en idé om hur detta skulle funka men det är inte självklart eller tydligt dokumenterat som jag ser det.

Du säger att man inte skickar inte studentGroups i user. Är det för att det INTE står i en kommentar i schemat man ska förstå att StudentGroup skapas på annat sätt. Eller är det för att det finns en endpoint i schoolResource.json?

girgen commented 5 years ago

Hej Stefan!

Vi tar detta vid nästa möte med gruppen vilken är om tio dagar.

Palle

9 dec. 2018 kl. 19:34 skrev Stefan Norberg notifications@github.com:

Hej och tack för svar! Det finns inget namn på relationen i UML-diagrammet i den riktningen och det du skriver ovan framgår inte av Worddokumentet vad jag kan se, utan de framgår bara av schemafilerna.

Det vore fint med ett sekvensdiagram som beskriver i vilken ordning respektive entiteter bör/skall skapas. Det kanske är självklart för dig som arbetat länge med detta, men jag tror det är långt ifrån självklart för alla.

Som ett exempel: Hur skapas en Enrolement? Skickar man den med User på enrolements? Hur uppdaterar man en Enrolement på en User? Hur tar man bort en enrolement? Jag har en idé om hur detta skulle funka men det är inte självklart eller tydligt dokumenterat som jag ser det.

Du säger att man inte skickar inte studentGroups i user. Är det för att det INTE står i en kommentar i schemat man ska förstå att StudentGroup skapas på annat sätt. Eller är det för att det finns en endpoint i schoolResource.json?

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/girgen/skolschema/issues/13#issuecomment-445560436, or mute the thread https://github.com/notifications/unsubscribe-auth/AAxqbtBUi5v5DaIiNAS1nQ9vcTNECCAOks5u3VfTgaJpZM4ZKKom.

stnor commented 5 years ago

Är det här ett möte som man kan komma till? Var/när i så fall?

girgen commented 5 years ago

Det finns brister i dokumentet för version 1 avseende just de READ-ONLY-attribut som kan läggas till vid. De framgår av schemat men finns inte i löptexten. Vi kommer adressera dem i version 2 av SS12000.

Vad avser ordning av objekt är det inte lika självklart, det beror ofta på informationägaren. Just exemplet Enrolment är ett eget objekt som kan peka ut en User, men den kan också vara vakant vilket ofta är fallet initalt.

Jag stänger detta ärende och vi tar med oss att detta måste bli tydligare i version 2 as SS12000.