SemesterapparatsManager/docs/semesterapparat/anlegen.md

Semesterapparat anlegen

Um einen neuen Semesterapparat anzulegen, muss zuerst der Knopf neu. App anlegen gedrückt werden. Das Feld der Apparatdetails wird nun zum Bearbeiten entsperrt.

{ loading=lazy }

---

Apparatdetails

Pflichtfelder

Um einen Apparat erfolgreich anzulegen, müssen alle Felder mit einem Sternchen (*) ausgefüllt werden. Ist eine Eingabe nicht valide, wird neben der Eingabe ein :material-close-circle:{ style="color: red" } angezeigt.

!!! warning "Formatierungsanforderungen" Folgende Felder haben spezielle Formatierungsanforderungen:

Feld	Format	Beispiel
Prof. Name	Nachname, Vorname	Müller, Hans
Mail	Gültige E-Mail-Adresse	mueller@ph-freiburg.de
Tel	Mindestens 3 Ziffern	0761-12345
Semester	Automatisch berechnet	siehe unten

Semester-Logik

Das Semester wird automatisch wie folgt berechnet:

=== "Wintersemester"

- Checkbox **Winter** aktivieren
- **Jahr**: 
    - Oktober–Dezember → aktuelles Jahr
    - Januar–September → aktuelles Jahr - 1

=== "Sommersemester"

- Checkbox **Sommer** aktivieren
- **Jahr**: aktuelles Jahr (März–August)

Fehlermeldungen

Beim Versuch, den Apparat zu speichern, bevor alle Felder korrekt ausgefüllt sind, erscheint eine Fehlermeldung:

{ loading=lazy }

!!! tip "Tipp" Über Ok oder Cancel wird die Meldung geschlossen und der Apparat kann weiter bearbeitet werden.

---

Dokumente hinzufügen

Dem Apparat können Dokumente hinzugefügt werden. Besonders hilfreich ist das Hinzufügen der Antragsformulare, da der SemesterapparatsManager diese automatisch auslesen kann.

graph LR
    A[Dokument hinzufügen] --> B{Antragsformular?}
    B -->|Ja| C[Medien aus Dokument hinzufügen]
    B -->|Nein| D[Als Referenz speichern]
    C --> E[Medien werden automatisch erkannt]

1. Klicken Sie auf Dokumente hinzufügen
2. Wählen Sie die gewünschte(n) Datei(en) aus
3. Bei Antragsformularen: Klicken Sie auf Medien aus Dokument hinzufügen

!!! warning "Wichtig: Automatisches Speichern" Beim Klicken auf Medien aus Dokument hinzufügen wird der Apparat automatisch gespeichert. Dies ist erforderlich, da Medien nur einem existierenden Apparat hinzugefügt werden können.

---

Medienliste

{ loading=lazy }

In der Medienliste werden alle dem Apparat zugeordneten Medien angezeigt.

Optionen

Option	Beschreibung
:lucide-eye: gel. Medien anzeigen	Zeigt auch gelöschte Medien an
:lucide-check-circle: im Apparat?	Prüft, ob ausgewählte Medien dem Apparat hinzugefügt wurden
:lucide-plus: Medien hinzufügen	Manuelle Eingabe von Signaturen

Kontextmenü

Mit einem Rechtsklick auf ein Medium öffnet sich das Kontextmenü:

{ loading=lazy }

=== "Allgemeines"

![Kontextmenü Allgemeines](../images/media_context_menu_general.png){ loading=lazy }

- **Bearbeiten**: Metadaten einsehen/bearbeiten
- **Löschen**: Medium aus dem Apparat entfernen (nicht physisch löschen)

=== "Apparate"

![Kontextmenü Apparate](../images/media_context_menu_apparats.png){ loading=lazy }

- **Zum Apparat hinzufügen**: *(derzeit deaktiviert)*
- **In Apparat verschieben**: Medium in anderen Apparat verschieben
- **In Apparat kopieren**: Medium in anderen Apparat kopieren

!!! tip "Mehrfachauswahl" Mit ++ctrl+left-button++ können mehrere Medien ausgewählt werden.

---

Medien manuell hinzufügen

{ loading=lazy }

Eingabe

Geben Sie jede Signatur in eine neue Zeile ein und bestätigen Sie mit ++enter++.

Optionen

Option	Beschreibung
Modus	Wählt die Metadatenquelle
Jedes Buch verwenden	Erlaubt das Hinzufügen von Medien, die noch nicht im Apparat sind
Exakte Signatur	Nur diese spezifische Signatur verwenden (kein alternatives Exemplar)

!!! info "Signatursuche" Ohne Exakte Signatur wird nach der ähnlichsten Signatur gesucht – das gefundene Buch ist dasselbe, aber möglicherweise ein anderes Exemplar.

---

Apparat speichern

Nach dem Ausfüllen aller Pflichtfelder:

1. Klicken Sie auf Speichern
2. Der Apparat wird in der Datenbank gespeichert
3. Optional: Bei aktiviertem Mail senden öffnet sich der Mail-Dialog

!!! note "E-Mail-Versand" Der E-Mail-Versand erfordert konfigurierte Mail-Zugangsdaten.