FAQ: Häufig gestellte Fragen

Ticketing

Was ist beim Eröffnen eines Tickets zu beachten?

Ein Ticket soll möglichst im passenden Projekt eröffnet werden. Also „Druck“ für alle druckbezogenen Probleme, für die Module entsprechend PA, PD, PE oder PO-Modul, für alle anderen Desktop-Applikationen passt der Bereich „Tools“. Zeugnisse haben ihren eigenen Bereich.

Für die Web-Komponenten gibt es ebenfalls diverse Unterkategorien. Achtung, FN2PA ist nicht das Desktop-PA-Modul, sondern der Web-Zugang für das Prüfungsamt.

Besonders wichtig ist eine „sprechende“ Überschrift. Dieser Titel wird später in den Release Notes verwendet. Je verständlicher der Titel gewählt wird, umso weniger Zeit müssen später alle investieren, um zu verstehen, worum es hier geht.

Fehlermeldungen sollen das Problem möglichst genau schildern. Das bedeutet, es soll nicht nur die reine SQL-Fehlermeldung genannt werden, sondern auch der Zusammenhang, in dem das Problem aufgetreten ist. Es sollte möglich sein, anhand der Beschreibung den Fehler zu reproduzieren.

Hilfreich sind Beispielfälle, insbesondere mit Lesezeichen. Auch Screenshots können zum Verständnis beitragen.

Auch Erweiterungswünsche und Anforderungen sollen so beschrieben sein, dass eine Person, die nicht direkt involviert ist, verstehen kann, worum es geht.

Welchen Tracker/Ticket-Typ soll ich verwenden?

Fehler: Bei allen Arten von Fehlern, die reproduzierbar auftreten.

Support: Setzen wir, wenn sich herausstellt, dass ein gemeldeter Fehler gar kein Programmfehler ist, sondern z.B. ein Problem in der Modellierung. Auch für umfangreicheren Support mit Dokumentationsaufwand oder Abstimmung zwischen mehreren Beteiligten. Für einfache Supportanfragen ist aber immer noch ein Anruf das Mittel der Wahl.

Vorschlag für Erweiterung: Für kleinere Erweiterungen, die deutlich unter dem Aufwand für eine Anforderung liegen. Auch hier ist eine vorherige Absprache von uns erwünscht.

Erweiterung: Bitte nicht benutzen. Wird ein Vorschlag für eine Erweiterung von uns angenommen, setzen wir diesen Typ.

Vorschlag für Anforderung: Für die Vorschläge, die Ihr während der Usergroup-Tagung vorstellen wollt.

Anforderung: Bitte nicht benutzen. Wird ein Vorschlag für eine Anforderung während der Usergroup-Tagung angenommen, setzen wir diesen Typ.

Support (abrechnen): Ein Sonderfall. Bitte ignorieren.

Einführung: Für Einführungsprojekte an neuen Hochschulen.

Auftragsprojekt: Für Sonderaufträge.

Wem soll ich ein Ticket zuweisen?

Wenn die zuständige Person bekannt ist, kann das Ticket auch entsprechend zugewiesen werden. Eine Liste der Zuständigkeiten ist hier zu finden: Zuständigkeiten im FlexNow-Team
Falls Unsicherheit besteht, geht das Ticket an Gerlinde Fischer; sie verteilt dann entsprechend um.

Ein Ticket, das an niemanden zugewiesen ist, sehen wir unter Umständen erst deutlich zeitverzögert!

Ein Ticket mit dem Status „erledigt“ muss nicht mehr zugewiesen werden.

Mein Ticket ist gelöst, was jetzt?

Bitte testet, ob die Erweiterung/Fehlerbehebung wie gewünscht umgesetzt wurde. Falls ja, setzt das Ticket auf den Status „erledigt“. Falls nein, meldet Euch bitte zeitnah bei der zuständigen Person.

Falls wir innerhalb von vier Wochen nichts von Euch hören, gilt das Ticket als abgenommen. Gewünschte Ergänzungen (nicht Fehlerkorrekturen) bedürfen dann eines neuen Tickets.

Screenshots in Tickets

Screenshots helfen in vielen Fällen bei der Suche nach Fehlern. Oft werden Screenshots mitgeliefert, aber in eine Word- oder pdf-Datei gesteckt. Dies führt dazu, dass man die Datei erst herunterladen und öffnen muss, bevor man an die eigentliche Information heran kommt. Schöner ist ein direktes Einbinden in ein Ticket:

Dazu den Screenshot als Bilddatei speichern: Unter Windows

mit strg-S

mit Hilfe der App „Snipping Tool“

mit Windows-Taste + Umschalten + S: öffnet die App „Ausschneiden und Skizzieren“

oder mit Hilfe einer geeigneten App, z.B. Greenshot

und dann jeweils speichern.

Im Ticket dann auf „Dateien auswählen“ klicken. Es öffnet sich ein Datei-Auswahldialog. Dort die gewünschte Datei auswählen und auf „Öffnen“ klicken. Als Ergebnis wird der Dateiname im Ticket angezeigt, das Bild ist ans Ticket angehängt.

Um das Bild direkt beim Öffnen des Tickets ohne weiteren Klick anzeigen zu können, einfach den Dateinamen ins Ticket schreiben und je ein ! vor und hinter dem Dateinamen einfügen:

Im Ergebnis sieht das so aus:

Anforderungen

Gewünschte Anforderungen werden als Vorschläge bei den Usergroup-Tagungen der Gruppe vorgestellt. Sie sind bis spätestens eine Woche vor der Tagung als „Vorschlag für Anforderung“ ins Ticketsystem einzustellen.

Nachdem der Vorschlag von der Usergroup angenommen wurde, wird der Typ des Tickets von uns auf „Anforderung“ geändert. Spätestens dann ist eine konkrete und detaillierte Beschreibung der gewünschten Funktionalitäten/Änderungen im Ticket zu hinterlegen.

Updates

fn2Module

Größere Versionen (Releases) mit neuen Funktionen planen wir für Januar und September, in Abstimmung mit fn2Web. Falls es aufgrund dringend benötigter Anforderungen/Erweiterungen erforderlich ist, werden wir auch außerplanmäßige Releases veröffentlichen.

Fehlerbehebungen bringen wir als Patches des jeweils letzten Release heraus.

Bei kritischen Fehlern bezeichnen wir den Patch als Hotfix. Für Hotfixes ist ein baldiges Einspielen dringend empfohlen, sofern das zugehörige Release im Einsatz ist.

Testversionen gibt es weiterhin nach Absprache; diese sind nicht für den Einsatz in Echtsystemen vorgesehen.

In den Release Notes weisen wir in der Überschrift aus, ob es sich um Release, Patch oder Hotfix handelt. Sofern eine Version nur gemeinsam mit bestimmten Versionen der fn2Web-Komponenten eingesetzt werden darf, weisen wir natürlich darauf hin.

Wenn eine Version herauskommt, informieren wir über den Verteiler „Updates“, auf dem nun alle Hochschulen mit mindestens einer Adresse vertreten sind.

Bei den Modulen gibt es keinen Versionierungsschlüssel, aber die Versionen sind über Release und Patch-Datum eindeutig identifizierbar. Beispiel: „Hochschule X hat das Release von April 2020 im Patch vom 23.07. im Einsatz“.

Wichtig:

Fehlerbehebungen sind immer nur im aktuellen Release möglich, eingeschränkt (für schwere Fehler) noch im vorangegangenen Release.

Die Möglichkeit zum Debug gibt es immer im aktuellen sowie im vorangegangenen Release. Für frühere Versionen ist dies nicht sichergestellt.

Weiterentwicklung findet stets im kommenden Release statt, eingeschränkt (für kleine Änderungen, die keine umfangreichen Tests erfordern) auch im aktuellen Release.

fn2Web

Für die fn2 Webmodule existiert ein Versionierungsschlüssel:

[fn2Web-Version].[Release].[Update]

Die Version 2.04.03.002 ist somit das zweite Update im dritten Release der fn2-Version 2.04.

Die fn2Web-Versionen unterscheiden sich grundlegend in Funktion und Präsentation. Wir haben kein festgelegtes Intervall für Inkremente, die Neugestaltung von FN2SSS und der Prüfungs An-/Abmeldung wird jedoch zum Beispiel die fn2Web-Version erhöhen.

Releases veröffentlichen wir in etwa halbjährlich oder in Sonderfällen (wie z.B. 2.04.03, um Kompabilität mit den fn2Modulen besser kennzeichnen zu können).

Achtung Wir supporten grundsätzlich nur die letzten beiden Release-Versionen!

Updates beinhalten neben einer Vielzahl von Fehlerbehebungen auch umgesetzte Erweiterungen und Anforderungen. Sie werden nach Bedarf veröffentlicht, meist ein bis zwei Mal pro Woche.

Die Release Notes für fn2Web sind nach den einzelnen Releases sortiert. Auch wir weisen darauf hin, wenn Abhängigkeiten zu bestimmten fn2Modulen bestehen.

Neue Releases und dringende Hotfixes werden per Verteiler angekündigt.

Zusätzlich zu den Release Notes im Wiki können unsere Releasenotes auch im Verzeichnis
{git-Repository}/Release-Notes/ in den *.md-Dateien gefunden werden.

Eine ausführliche Dokumentation zur Aktualisierung von fn2Web kann hier im Wiki gefunden werden.