Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- manual:setup [2023/08/01 09:49] – jwesenberg
+++ manual:setup [2025/05/21 14:27] (aktuell) – [Installation] * GitLab-Wiki-Link sklemm
@@ Zeile 3: / Zeile 3: @@
 ===== Installation =====
-Die Einrichtung des Servers und Installation der Software ist im internen [[https://gitlab-zit.senckenberg.org/sklemm/florawebplus/-/wikis/Installation|GitLab-Wiki]] bzw. der README beschrieben.
+Die Einrichtung des Servers und Installation der Software ist im internen [[https://gitlab.senckenberg.de/florawebplus/sebotacoms/-/wikis/Installation|GitLab-Wiki]] bzw. der README beschrieben.
 :!: Wird im Browser die Startseite des frisch installierten CMS aufgerufen, erscheint eine Fehlermeldung bezüglich eines fehlenden Moduls. Dies ist beabsichtigt und resultiert daraus, dass bisher keinerlei Konfiguration im Backend des CMS erfolgt ist!
@@ Zeile 31: / Zeile 31: @@
   * Menüpunkt **//Konfiguration//** --> **//Datensatztypen//**
   * Button **[Neuer Listeneintrag]**
-  * bei //__Wert__// einen systemweit eindeutigen Bezeichner eingeben, //__Attribut__// ''code'' wählen
-  * Button **[Neuer Einzelwert]**
   * bei //__Wert__// einen beschreibenden deutschen Namen eingeben, //__Attribut__// ''name_de'' wählen
+  * sollen weitere Attribute vergeben werden dann Button **[Neuer Einzelwert]**
+  * :todo: z. B. bei //__Wert__// einen systemweit eindeutigen Bezeichner eingeben, //__Attribut__// ''code'' wählen
   * ggf. die letzten beiden Schritte für weitere Sprachen wiederholen
@@ Zeile 65: / Zeile 65: @@
      * Speichern
   * ggf. die letzten Schritte für Hinzufügen weiterer Attribute wiederholen
+==== Bedeutung der Attribute ====
+  * //__name_xy__// -> Der obligatorische Name des Elementes (in diesem Fall des Anzeigefeldes) in der definierten Sprache ''xy''. Dieser wird im Frontend und Backend einheitlich verwendet und sollte möglichst kurz und prägnant sein.
+  * //__description_xy__// -> Ein längerer Beschreibungstext (der Sprache ''xy''), der den Inhalt des Anzeigefeldes näher beschreibt und als Hilfetext bei Eingabe-/Bearbeitungsformularen von Datensätzen im Backend angezeigt wird.
+  * //__placeholder_xy__// -> Ein optionaler Platzhaltertext (der Sprache ''xy''), der in Eingabefeldern bei Eingabe-/Bearbeitungsformularen von Datensätzen im Backend angezeigt wird.
+  * //__tooltip_xy__// -> Ein optionaler Beschreibungstext (der Sprache ''xy''), der mit einem runden "i"-Icon hinter dem Namen des Anzeigefeldes im Frontend und Backend symbolisiert wird. Wird der Mauszeiger über dem Icon platziert (auch "Hoover" oder "Mouse over" genannt), so erscheint der Text schwebend neben dem Mauszeiger als sogenannter "Tooltip".
+  * //__config__// -> Weitere Konfigurationsoptionen, die nur für Datensatztypen und Gliederungspunkte benötigt werden. Diese müssen derzeit noch von Hand im **[[wpde>JSON|JSON]]**-Format angegeben werden. Eine Liste der möglichen Optionen ist im [[https://gitlab.senckenberg.de/florawebplus/sebotacoms/-/wikis/Configuration#data-related-config|GitLab-Wiki]] zu finden.
+{{:manual:backend-elemente_beschriftet_bunt.png?direct|}}
+==== Import der Namen inkl. Attribute ====
+Wenn viele Anzeigefelder verwendet werden sollen, lohnt es sich, die Namen der Anzeigefelder in Form einer Tabelle im **[[wpde>CSV_(Dateiformat)|CSV]]**-Format zu importieren. Diese kann mit LibreOffice Calc, MS Excel oder einem beliebigen Texteditor erstellt werden und muss unbedingt mit der Zeichencodierung **[[wpde>UTF-8|UTF-8]]** gespeichert werden.
+Jede Spalte der Importtabelle entspricht dabei einem zu importierenden Attribut und sollte in der ersten Zeile den Namen des Attributs enthalten, um eine halb-automatische Zuordnung zu ermöglichen. Jede Zeile entspricht einem Anzeigefeld-Namen.
+  * Menüpunkt **//Konfiguration//** --> **//Anzeigefelder-Namen//**
+  * Button **[Importieren]**
+Der Import-Vorgang ist in einem folgenden [[manual:import#auswahllisten|Kapitel]] beschrieben.
+Auch die oben beschriebenen Gliederungspunkte und Datensatztypen können bei Bedarf nach dem gleichen Schema importiert werden.
 ===== Anzeigefelder definieren =====
@@ Zeile 81: / Zeile 104: @@
 Zwingend ist die Auswahl des //[[manual:glossar#datentyp|Datentyp]]//s. Dieser legt fest, welchen Inhalt das Anzeigefeld enthalten und darstellen kann. Dies bestimmt ganz wesentlich die Struktur der zu verwaltenden Datensätze.
-:!: Achten Sie auf die Auswahl des richten Datentyps.
+:!: Achten Sie auf die Auswahl des richtigen Datentyps.
 :!: Es empfiehlt sich, während des Anlegens eines Anzeigefeldes auch die //[[manual:glossar#feldzuordnung|Feldzuordnung]]// anzulegen. Dazu wird der Haken der Checkbox //__Eine neue Zuordnung für dieses Anzeigefeld anlegen__// gesetzt. Daraufhin wird das Eingabeformular um mehrere Felder erweitert: