Formulare und Formularsätze¶
Anton gibt kein festes Feldschema vor. Welche Felder eine Verzeichnungseinheit hat, wie sie heissen und in welcher Reihenfolge sie stehen, legt jedes Archiv selbst fest. Gepflegt wird das unter Admin → Formulare und Admin → Formtypen.
Wie sich das für die Erschliessung auswirkt, beschreibt Formulare und Felder im Benutzerteil.
Die drei Ebenen¶
| Ebene | Was sie ist |
|---|---|
| Antonfield | Eine Felddefinition — Name, Typ, Grundbeschriftung. Existiert einmal und wird von beliebig vielen Formularen verwendet. |
| Formular | Eine geordnete Auswahl von Feldern für eine Ansicht. Legt pro Feld Position und Beschriftung fest. |
| Formularsatz | Bündelt fünf Formulare zu einer Einheit — die fünf Ansichten desselben Datensatztyps. |
Ein Feld erscheint also nicht «im Formular», sondern wird verknüpft — und die Verknüpfung trägt die Feinheiten.
Der Formularsatz und seine fünf Ansichten¶
| Slot | Wofür |
|---|---|
| Intern — Bearbeiten | Die Erschliessungsmaske |
| Intern — Detail | Detailansicht für angemeldete Benutzer:innen |
| Intern — Liste | Trefferliste für angemeldete Benutzer:innen |
| Extern — Detail | Detailansicht für die Öffentlichkeit |
| Extern — Liste | Trefferliste für die Öffentlichkeit |
Ein externes Bearbeiten-Formular gibt es nicht. Die Trennung intern/extern ist der Hebel, mit dem gesteuert wird, was Aussenstehende sehen: Ein Feld erscheint nur, wenn es im jeweiligen Formular steht.
Kein Ersatz für Schutzfristen
Ein Feld aus dem externen Formular zu nehmen, verbirgt es in der Anzeige — es ist keine Zugangskontrolle. Für Schützenswertes sind Schutzfristen und das Feld «Datensatz gesperrt» das richtige Mittel.
Standort standardmässig nicht öffentlich
Neuinstallationen liefern das Feld Standort aus den externen Formularen (Extern — Detail/Liste) entfernt aus, damit der physische Aufbewahrungsort nicht im öffentlichen Katalog erscheint. Bestehende Installationen bleiben unverändert; dort lässt sich das Feld hier aus den externen Formularen nehmen.
Formularsätze gibt es nicht nur für Verzeichnungseinheiten, sondern auch für Akteur:innen, Orte, Schlagwörter und Standorte.
Welcher Formularsatz greift?¶
Anton entscheidet in dieser Reihenfolge:
- Ist im Datensatz das Feld Formularsatz gesetzt, gilt dieser.
- Sonst der Formularsatz, dessen Name der Verzeichnungsstufe entspricht —
fonds,file,itemund so fort. - Sonst der Standardsatz.
Für die meisten Archive genügt deshalb: je einen Satz pro Verzeichnungsstufe pflegen. Eigene Sätze lohnen sich, wenn ein Bestandstyp andere Felder braucht — Fotografien, Pläne, Filme.
Vorlage «Publikation»¶
Für die Bücher und Broschüren einer Archivbibliothek gibt es einen fertigen Formularsatz Publikation. Er wird gezielt in einem Archiv eingerichtet, nicht bei einem Update:
php artisan anton:formset-template publication --env=<slug>
Der Befehl legt den Formularsatz mit einer eigenen Bearbeitungsmaske und je einer Detailansicht intern und extern an; die Trefferlisten sind die des Archivs. Die Maske enthält:
- Signatur, Titel, Untertitel, Autor:in als Ereignis mit Verknüpfung ins Personenregister, Verlag, Publikationsort, Erscheinungsjahr (das Entstehungs-Ereignis), Auflage, Reihe, ISBN, Umfang
- Verzeichnungsstufe, Objekttyp, Sprachen, Medien
- Form und Inhalt, Akteur:innen, Schlagwörter
- Schutzfrist, gesperrt, Standort, Standort (Detail), Swisscovery
- Allgemeine Anmerkungen, archivinterne Bemerkungen, Änderungen, Ausleihe
Die extern sichtbare Detailansicht lässt Schutzfrist, Standort, archivinterne Bemerkungen, Änderungen und Ausleihe weg. Untertitel, Auflage, Reihe und ISBN sind einzeilige Textfelder, die es ab dieser Version in jedem Archiv gibt; ohne Formular, das sie enthält, erscheinen sie nirgends.
Ein Datensatz wird zur Publikation, indem man in der Maske unter Formularsatz «Publikation» wählt; üblich ist ein Zweig «Bibliothek» in der Tektonik mit den Publikationen als Einzelstücke. Der Befehl lässt einen bestehenden Formularsatz «publication» unverändert und lässt sich wiederholen. Ein Feld, das es im Archiv nicht gibt, lässt er aus und nennt es. Danach lässt sich der Satz wie jeder andere unter Admin → Formulare anpassen.
Was sich pro Formular überschreiben lässt¶
Dieselbe Felddefinition kann in jedem Formular anders auftreten. Überschreibbar sind unter anderem:
- Beschriftung — dasselbe Feld kann in der Bearbeitungsmaske anders heissen als in der Detailansicht
- Position — die Reihenfolge
- Werteliste — welche Werteliste ein Auswahlfeld speist
- Vorgabewert
- Typ — in Ausnahmefällen
Die Werteliste wird dreistufig aufgelöst: Überschreibung im Formular, sonst die Vorgabe der Felddefinition, sonst ein fest eingebauter Rückfall.
Abschnitte¶
Felder vom Typ section sind keine Eingabefelder, sondern graue Zwischenüberschriften. Ein Abschnitt ohne sichtbares Feld wird ganz weggelassen — leere Abschnitte muss man also nicht von Hand entfernen.
Feldtypen¶
Welche Felder überhaupt zur Verfügung stehen und welchen Typ sie haben, zeigt in der Anwendung die Hilfeseite Anton Fields. Sie listet zu jedem Feld die Beschriftung, den Typ, den Hilfetext und die Formulare, in denen es vorkommt — und ist damit die verlässlichste Auskunft über das eigene Archiv.
Standardfelder nicht umbenennen — im technischen Sinn
Name und Typ der Anton-Standardfelder sind fest; Code und Import verlassen sich darauf. Die Beschriftung dagegen ist frei und bleibt bei Aktualisierungen erhalten.
Trefferlisten¶
Die Listenansichten sind nur eingeschränkt konfigurierbar, weil dort Module
mehrere Angaben in eine Spalte ziehen. Für eine zusätzliche Vorschaubild-Spalte
gibt es die Einstellung form-objects-list.
Konfigurierbare eingebettete Tabellen¶
Die Detailseiten von Akteur:innen, Orten, Schlagwörtern und Standorten zeigen eine eingebettete Objektliste — die Verzeichnungseinheiten, die den Datensatz als Deskriptor verwenden. Diese Liste folgt im Standard einer fest eingebauten Vorgabe.
Unter Admin → Formulare lässt sie sich pro Archiv anpassen: Der Abschnitt Konfigurierbare eingebettete Tabellen bietet eine Aktion Konfigurieren, die die eingebaute Vorgabe in ein editierbares Formular überführt und an den normalen Spalten-Editor übergibt. Ab da lassen sich Spalten und Beschriftungen wie bei jedem anderen Formular ändern. Blosses Ansehen ändert nichts — erst Konfigurieren legt das editierbare Formular an.
Beziehungen zwischen Datensätzen¶
Ein Datensatz kann in einen anderen eingebunden sein, etwa ein Blatt in ein gebundenes Exemplar. Im Archivbaum bleibt das Blatt, wo es ist; das Exemplar führt im Modul Beziehungen unter enthält alle eingebundenen Blätter auf, mit Signatur, Titel (ohne eigenen Titel der des übergeordneten Datensatzes) und alter Signatur, nach der alten Signatur geordnet. Das Blatt nennt unter eingebunden in das Exemplar. Datensätze, die jemand nicht sehen darf, fehlen in seiner Liste.
Dafür muss die Einstellung object_relations unter Admin → Einstellungen eingeschaltet sein (Vorgabe: aus) und das Modul Beziehungen in der Detailansicht der betreffenden Formulare stehen. Anton setzt es in kein Objektformular von selbst; man fügt es im Formular-Editor hinzu. Die Beziehungen selbst werden heute über Importe und Befehle gesetzt, nicht im Formular (anton#706).
Standard-Sortierung¶
In Listenformularen, also den Objektlisten und den eingebetteten Tabellen, hat der Spalten-Editor eine Spalte Standard-Sortierung. Wählen Sie dort bei einer Spalte aufsteigend oder absteigend, zeigt die Tabelle ihre Einträge in dieser Reihenfolge, bis jemand anders sortiert. Es gilt höchstens eine Spalte je Formular: Wählen Sie eine neue, entfällt die bisherige.
Ohne Auswahl gilt die eingebaute Vorgabe, bei den Objekten unter Ereignissen das Datum des Ereignisses, bei den Objekten unter Deskriptoren das Entstehungsdatum. Für die eingebetteten Tabellen muss das Formular zuerst mit Konfigurieren angelegt sein.
Suchformulare der Register¶
Welche Felder die Suche in den Registern der Akteur:innen, Orte und Schlagwörter durchsucht, legt je Register ein Suchformular fest. Was ein Detailformular anzeigt, wird damit nicht automatisch durchsucht: Die Quellen etwa lassen sich anzeigen, ohne dass eine Suche sie trifft.
Eine Suche erreicht ein Register auf drei Wegen:
| Weg | Wo |
|---|---|
| Liste im Browser | das Suchfeld über der Registerliste |
| Auswahlfelder beim Erschliessen | die Vorschläge beim Verknüpfen einer Person, eines Orts oder Schlagworts |
| API | /api/actors, /api/places, /api/keywords |
Unter Admin → Formulare, Abschnitt Suchformulare der Register:
- Suchformular → Konfigurieren legt das Suchformular des Registers an. Es gilt für alle drei Wege. Solange es fehlt, gilt die eingebaute Vorgabe: ID, Name, Typ, weitere Namen, Varianten, Abkürzungen und Beschreibung (bei Orten dazu Ort, Kanton/Bundesland, Land und Adresse; bei Schlagwörtern ID, Name und Beschreibung).
- Liste im Browser, Auswahlfelder beim Erschliessen und API → Hinzufügen legt ein eigenes Formular nur für diesen Weg an. Es übernimmt zunächst die Felder des Suchformulars und ersetzt es dann für diesen Weg. Entfernen stellt den Weg wieder auf das Suchformular zurück.
Durchsucht werden nur die Felder im Formular, die sich durchsuchen lassen; der Editor nennt sie. Den Kommentar durchsucht Anton nur für interne Rollen, auch wenn er im Formular steht.
Die Spalte Standard-Sortierung bestimmt die Reihenfolge, wenn die Anfrage
keine angibt: aufsteigend, absteigend oder Relevanz. Relevanz stellt
bei einer Suche die besten Treffer nach oben (siehe
Gewichtete Suche) und sortiert ohne Suchbegriff nach der
Spalte. Eine Sortierung in der Anfrage (sortField, weighted=1) geht vor.