Schulungsunterlagen

Zum Erstellen, Bearbeiten und Abfragen von Seiten mit Semantic MediaWiki, sind folgende Elemente nötig:

• Attribute: Legen fest, welche Werte später abgefragt werden können.
• Vorlage(n): Definiert, wie die Seiten aussehen, an welcher Stelle die Formulareingaben ausgegeben werden und was als Attributwert geschrieben wird.
• Formular: Hier wird angegeben, welche Werte erfasst werden und auch, auf welche Weise (es gibt verschiedene Feldtypen und Optionen).
• Kategorie: Ermöglicht das Bearbeiten mit dem Formular und ist neben den Attributen ein wichtiges Mittel zum Abfragen und Filtern der Seiten.

Die im Folgenden aufgeführten Schritte haben eine logische Reihenfolge, welche das Erstellen der ineinandergreifenden Elemente erleichtert. Diese ist aber nicht fest vorgegeben und nur ein Vorschlag.

Überlegungen vorab

Zunächst sollte festgelegt werden, welche Struktur die zu erstellenden Seiten grundsätzlich haben sollen.

Vor allem sollte eine erste Idee vorhanden sein, welche Attribute verwendet werden sollen, d.h. welche Informationen der Seite von Relevanz für spätere Abfragen sind.

Beispiel: Wir möchten Kundendaten semantisch erfassen. Jeder Kunde bekommt eine eigene Wikiseite, auf der wir Daten, wie den Standort, Ansprechpartner und das Datum des ersten Kontaktes festhalten möchten.

Nomenklatur

Es bietet sich an, alle beteiligten Dokumente gleich zu benennen. In unserem Beispiel hätten wir dann etwa Vorlage:Kunde, Formular:Kunde und Kategorie:Kunde. Auch ein entsprechender Namensraum "Kunde" ist denkbar bzw. sinnvoll.

Bei den Attributen sollte man etwas differenzieren, da z.B. ein "Standort" evtl. auch bei anderen Seiten Verwendung finden kann.

Man kann hier mit einer Art Unterseitensystem arbeiten und z.B. mit den Attributen Attribut:Kunde/Standort, Attribut:Kunde/Erstkontakt, etc. arbeiten. Soll "Standort" auch an anderer Stelle verwendet werden, bietet es sich an, stattdessen Attribut:Standort zu wählen. Bei Attributen, die eindeutig einem Anwendungsfall zuzuordnen sind oder wenn es mehrere Anwendungsfälle gibt, die das Attribut auf unterschiedliche Weise verwenden, ist es sinnvoll, diese auch entsprechend zu benennen. So kann beispielsweise Attribut:Kunde/Vertragsnummer eine laufende, ganzzahlige Nummer sein, aber Attribut:Partner/Vertragsnummer Einträge wie "1.1.5" und "4.3.7" enthalten.

Attribute anlegen

Auf der Spezialseite Spezial:Attribut erstellen können sehr einfach neue Attribute erstellt werden und gleichzeitig der Datentyp, sowie ggf. vorgegebene Werte angegeben werden.

Mögliche Datentypen sind etwa:

• Wikiseite
• Text
• Datum
• Zahl
• Wahrheitswert

Die richtige Wahl des Datentyps ist insofern wichtig, da bei Abfragen z.B. eine Datumsangabe im (passenden) Typ "Datum" anders sortiert wird, als mit dem Typ "Text".

Das Anlegen der Attributsseiten ist zwar optional, wenn Sie diesen Schritt aber überspringen, erhalten alle Attribute den Standardtyp "Seite", was die Ausgabe von Abfragen unschön und ggf. verwirrend erscheinen lassen kann.

Vorlage erstellen

Über Spezial:Vorlage erstellen kann leicht eine Vorlage erstellt werden, die auf bereits vorhandene Attribute zurückgreift.

Hinweis: Die Feldnamen können beliebig gewählt werden. Sie ermöglichen die Kommunikation zwischen Vorlage und Formular und werden auch nur dafür verwendet. D.h. in Vorlage/Formular:Kunde kann derselbe Feldname verwendet werden, wie in einem anderen Formular, allerdings müssen die Feldnamen innerhalb eines Formulars einzigarig sein.

Im unteren Teil der Spezialseite, können verschiedene Stylingoptionene, wie etwa als seitlicher Kasten, ausgewählt werden. In der Regel wird man das Styling aber dennoch manuell nacharbeiten müssen. Spätestens wenn man nach der initialen Erstellung der Vorlage noch etwas ändern will, muss man sich mit dem Quelltext auseinandersetzen.

Formular erstellen

Auf Spezial:Formular erstellen kann ein zugehöriges Formular erstellt werden, dass sowohl die bereits vorhandene Vorlage, als auch die darin verwendeten Attribute einbindet.

Hier können verschiedene Feldtypen ausgewählt werden, Beispiele dafür sind:

• (einfaches) Textfeld
• Textarea (ggf. mit visuellem Editor)
• Dropdown
• Checkbox
• Radio-Buttons
• Datumsauswahl

Die Spezialseite formatiert das Formular als zweispaltige Tabelle, was im Nachhinein natürlich noch angepasst werden kann, aber an sich ist für die Formular-Ansicht nicht vorgesehen, dass ein spezielles Styling verwendet wird.

Kategorie anlegen

Spezial:Kategorie erstellen ermöglicht es, eine Kategorie zu erstellen und gleichzeitig das bereits vorhandene Formular mit allen Seiten zu verknüpfen, die die Kategorie verwenden.

Neue Seiten erstellen

Haben Sie die oben erwähnten Schritte ausgeführt, können Sie jede Seite mit der erstellten Kategorie "mit Formular bearbeiten", d.h. neue Seiten müssen zunächst angelegt und mit der Kategorie verknüpft werden, damit der Mechanismus mit Formular/Vorlage greift.

Das geht natürlich einfacher... Zum Einen kann ein "magisches Wort" verwendet werden, welches ein Eingabefeld samt "Erstellen"-Button erzeugt. Hier geben Sie den Titel der zu erstellenden Seite ein, welche per Klick auf den Button erstellt wird und es wird direkt die Formularbearbeitung gestartet.

Außerdem ist es möglich, eine "One-Click-Variante" davon zu gestalten, d.h. ohne Benutzereingabe wird per Knopfdruck eine neue Seite erstellt. Diese muss natürlich auch einen Titel haben. Dieser kann aus einem vorgegebenen Textbaustein (z.B. "Protokoll") bestehen, aber er muss auch einen einzigartigen Teil haben. Hier wird meist ein Zeitstempel (Datum/Uhrzeit der Erstellung) oder eine laufende Nummer verwendet.

Bei beiden Varianten kann vorher ein Namensraum angegeben werden, in dem die neuen Seiten abgelegt werden. Es ist auch möglich, die neuen Seiten als Unterseiten einer bestimmten Seite anzulegen. So kann z.B. durch Klick auf einen Button eine Seite mit dem vollständigen Titel Protokoll:Übersicht/2020-09-17 erstellt werden (Namensraum "Protokoll", übergeordnete Seite "Übersicht" und Zeitstempel als Titel).