Skip to content

Welche Queries werden verwendet?

Jump to bottom
Lena Höding edited this page Feb 24, 2023 · 2 revisions

Informationen

Allgemein

Der Prototyp der ModCat-Anwendung ist in den Features Browsing und Editieren bereits mit der Datenbank (Fuseki-Server, siehe Server & Datenbank unter Ressourcen bei Trello) verknüpft. Die Kommunikation findet über Axios (Abfragesprache SPARQL) und zwischen den Components statt.

Zukunft

Problem

Durch organisches Wachstum und wechselnde Mitarbeiter ist sind die Abfragen/queries im Code verstreut. Manche befinden sich direkt in den ausführenden Components. Es existiert eine Datei (queries.js) in der einige queries als Rümpfe vorliegen. Nach Aufruf durch eine Component wird der Rumpf mit den gegebenen Parametern zu einer konkreten Abfrage (beispielsweise für ein bestimmtes Modul oder einen Studiengang) zusammengesetzt und zurückgegeben. Dies erweckt den falschen Eindruck, man könne sich dort einen Überblick von allen bisher entwickelten/umgesetzten queries machen. Oft werden ähnliche Daten benötigt, so dass mit mehreren, verstreuten, unabhängigen queries Redundanz und Mehraufwand bei der Einpflegung neuer Strukturen entsteht. Der dezentrale Ansatz macht es auch neuen Entwicklern schwerer sich zwischen und in den Components zu organisieren

Plan

Es wurde beschlossen, dass alle queries auf ihre Verknüpfung mit der nutzenden Component zu prüfen. Simple queries mit wenig Verflechtung sollen in queries.js umgesetzt werden, um sie zentral zu sammeln. Dies soll eine spätere Wiederverwendung ermöglichen. Es soll jeweils das Aufwand-Nutzen-Verhältnis abgewägt werden.

Progress

  • Liste aller queries (siehe Trello-Karte)
  • testweise Umsetzung von queryMethod (Ordner Browsing, Component ModuleMethod) und Erstellen eine kleinen Anleitung (Trello-Karte)
  • Umsetzung weiterer queries auf dem Ordner Browsing

Analyse von queries.js

2021 wurde versucht sich einen Überblick über bestehende Anfragen zu verschaffen. Teile davon wurden in diesem Abschnitt festgehalten. Seither (Stand 2023 Februar) gab es Veränderungen, so dass dieser Abschnitt veraltete Informationen enthalten kann.

modcat-prototyp: src>views>query.js

Parameter/Variablen:

Param

  • Eingabe-Parameter, das bestimmt welche Query gebaut werden soll

moduleUri

studyProgramm

  • Studiengang?

code

  • Code/Modulkürzel des Moduls, dessen Daten angefordert werden
  • Beispiel: AlgoDat
  • Ist ein Substring der moduleUri, wird aus dieser erstellt

Queries

Rahmendaten – SVGqueryBase

Genutzt:

  • Param
  • moduleUri
  • studProgram
  • code

Basierend auf URI/Modulkürzel werden detaillierte Informationen abgerufen, die dessen Veranstaltungsbedingungen beschreiben

  • ECTs
  • Dauer in Semestern
  • Lehrperson URI und Namen
  • Instanz = aktuelle Ausgabe dieses Semester
  • Modultyp (Pflicht, Wahl, Wahlpflicht)
  • Notengewichtung
  • Lernformen
  • Sprache/Verwendbarkeit auf Deutsch
  • Zyklus, Sommer- oder Wintersemester
  • Vorausgesetzte Module

Wiederverwendbarkeit

  • Viele Unterpunkte (OPTIONAL, FILTER) sind wiederverwertbar

Didaktik – SVGqueryOutcome

Genutzt:

  • param
  • moduleUri
  • code

Basierend auf URI/Modulkürzel werden Informationen zu Bloomscher Taxonomie , Inhalten und Prüfungsleistungen abgefragt Wiederverwendbarkeit

  • Nicht für die Filterseite nützlich
  • Bei der Detailseite Modulbeschreibung und deren Subpage Didaktik wichtig
  • Unterpunkte (OPTIONAL), die nützen können Lernergebnisse, Kompetenzen, Bloomsche Taxonomie Prüfungsleistungen Inhaltselemente

Methodik – SVGqueryMethod

Genutzt:

  • Param
  • moduleUri
  • code Basierend auf URI/Modulkürzel werden Informationen zu Lehrform(en), Zahl der Arbeitsstunden und workLoadDetails? Wiederverwendbarkeit
  • Nicht für die Filterseite nützlich
  • Bei der Detailseite Modulbeschreibung und deren Subpage Methodik wichtig
  • Unterpunkte (OPTIONAL), die nützlich sein können Lehr- und Lernmethode Gesamtworkload, Workloadkomponente in Stunden

Literatur – SVGqueryLiteratur

Genutzt:

  • Param
  • moduleUri

Basierend auf URI werden detaillierte Informationen zur Literatur angefragt

  • URI
  • Titel
  • Auflage
  • Autor
    • URI
    • Lable
    • Vor- und Nachname
    • Link zum Profil
  • Datum der Veröffentlichung
  • ISBN
  • DOI (?litIdentifier)
  • Start- und Endseite
  • Herausgeber URI und Name

Wiederverwendbarkeit

  • Nicht für die Filterseite nützlich
  • Bei der Detailseite Modulbeschreibung und deren Subpage Literatur wichtig
  • Es gibt Subqueries für die aufgelisteten Details

PDF Für PDF Erstellung? Genutzt:

  • Param
  • moduleUri
  • studyProgram
  • code

wenig kommentiert und unübersichtlich, aber viele OPTIONALS, die genutzt werden könnten, möglicherweise zu aufwendig

Clone this wiki locally