Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- manual:import [2023/01/20 14:27] – jwesenberg
+++ manual:import [2025/07/31 22:35] (aktuell) – [Allgemeines] + Hinweis Zeilenumbrüche sklemm
@@ Zeile 1: / Zeile 1: @@
 ====== Import von CSV-Daten ======
 ===== Allgemeines =====
-Für große Mengen an Daten ist es möglich, diese zu importieren. Die Daten müssen dafür als CSV-Datei vorliegen. Die Anzahl der Spalten ist dabei nicht entscheidend. Es können in der Import-Datei auch überzählige Spalten enthalten sein, die nicht importiert werden sollen, allerdings schränkt dies die Übersichtlichkeit und Verarbeitungsgeschwindigkeit ein.\\
+Für große Mengen an Daten ist es möglich, diese zu importieren. Die Daten müssen dafür als CSV-Datei vorliegen. Die Anzahl der Spalten ist dabei nicht entscheidend. Es können in der Import-Datei auch überzählige Spalten enthalten sein, die nicht importiert werden sollen, allerdings schränkt dies die Übersichtlichkeit und Verarbeitungsgeschwindigkeit ein.
 Die zu importierende Datei darf in der ersten Zeile Spaltennamen/-überschriften enthalten. In diesem Fall muss die Checkbox **CSV enthält in der ersten Zeile Spaltenüberschriften** aktiviert werden.
 :!: Wählen sie unbedingt **UTF-8** als Zeichencodierung beim Erstellen der CSV-Datei.
-Unter dem Menupunkt "Import" muss zunächst ausgewählt werden, welche Daten importiert werden sollen. Drei Möglichkeiten stehen zur Verfügung:
+:!: Es dürfen keine Zeilenumbrüche in den einzelnen Zellen der Import-Tabelle enthalten sein. Andernfalls wird nach dem Upload der CSV-Datei darauf hingewiesen und der Import nicht gestartet.
-  * **[[manual:import#taxa-listen|Taxa-Listen]]**
-  * **[[manual:import#auswahllisten|Auswahllisten]]**
+Ggf. kann mit LibreOffice nach versteckten Zeilenumbrüchen gesucht werden: Suchstring ''\n'' mit Option //Reguläre Ausdrücke//
-  * **[[manual:import#datensätze|Datensätze]]**
+Unter dem Menupunkt //**Import**// muss zunächst ausgewählt werden, welche Daten importiert werden sollen. Drei Möglichkeiten stehen zur Verfügung:
+  * [[manual:import#taxa-listen|Taxa-Listen]]
+  * [[manual:import#auswahllisten|Auswahllisten]]
+  * [[manual:import#datensätze|Datensätze]]
@@ Zeile 23: / Zeile 29: @@
   * im sich öffnenden Dialog zu importierende Datei auswählen und das in der CSV verwendete Trennzeichen auswählen -> **[Hochladen]** drücken
   * im sich öffnenden Dialog Zuordnung der Tabellenspalten zu den vordefinierten Anzeigefeldern vornehmen, ggf. **CSV enthält in der ersten Zeile Spaltenüberschriften** anhaken -> **[Importieren]** drücken
-  * im nachfolgenden Dialog kann noch die **Anzahl der zu überspringenden Datensätze** festgelegt werden (das eröffnet die Möglichkeit eine bekannt Anzahl X bereist früher importierter Datensätze zu überspringen, sofern diese in den ersten X Zeilen der Tabelle stehen) -> **[Importieren]** drücken
+  * im nachfolgenden Dialog kann noch die **Anzahl der zu überspringenden Datensätze** festgelegt werden //(das eröffnet die Möglichkeit eine bekannt Anzahl X bereist früher importierter Datensätze zu überspringen, sofern diese in den ersten X Zeilen der Tabelle stehen)// -> **[Importieren]** drücken
   * der Fortschrittsbalken zeigt in Schritten von 10 Datensätzen den Verlauf des Imports, im Fenster **Log** werden Importfehler angezeigt
   * nach Abschluss des Imports wird entsprechende Meldung angezeigt
@@ Zeile 31: / Zeile 37: @@
 Sollen die möglichen Eingabewerte für bestimmte Daten fest definiert werden, müssen diese in Auswahllisten (Drop-Down-Listen) festgelegt werden. Mit Hilfe solcher vordefinierten Listen können Eingabefehler vermieden werden.
-Auswahllisten können auch hierarchisch aufgebaut sein, d.h. es gibt mehrere Ebenen, deren Elemente miteinander kombiniert werden können (Bsp.: Bei Zeigerwerten, die als Zahlen vorliegen, gibt es teilweise Zusatzattribute, die ein zusätzliche Aussage über den Wert treffen. Ein hinter die Zahl gestelltes Fragezeichen drückt z.B. aus, dass es sich um eine unsichere Angabe handelt).
+Auswahllisten können auch hierarchisch aufgebaut sein, d.h. es gibt mehrere Ebenen, deren Elemente miteinander kombiniert werden können (//Bsp.: Bei Zeigerwerten, die als Zahlen vorliegen, gibt es teilweise Zusatzattribute, die ein zusätzliche Aussage über den Wert treffen. Ein hinter die Zahl gestelltes Fragezeichen drückt z.B. aus, dass es sich um eine unsichere Angabe handelt)//.
 :!: Vor den Import der eigentlichen Liste, ist es notwendig unter dem Menü **//Konfiguration//** Namen, Beschreibung und Typ der Liste (hierarchisch vs. nicht-hierarchisch) zu definieren:
@@ Zeile 49: / Zeile 55: @@
 ===== Datensätze =====
+:todo: gesamten Abschnitt überarbeiten
 :!: Vor dem Import von Datensätzen müssen unter dem Menü **//Konfiguration//** Datensatztypen, Anzeigefelder und Feldzuordnungen definiert und ggf. Auswahllisten und/oder Module konfiguriert werden. Für eine entsprechende Kurzanleitung siehe **[[manual:setup#ersteinrichtung|Ersteinrichtung]]** bzw. **[[manual:import#auswahllisten|Auswahllisten]]**
@@ Zeile 57: / Zeile 64: @@
   * im sich öffnenden Dialog vorab definierten Datensatztyp auswählen, Datei auswählen und die in der CSV verwendeten Trennzeichen für Tabellenspalten und Elemente von Mehrfachauswahllisten festlegen -> **[Hochladen]** drücken
   * im sich öffnenden Dialog Zuordnung der Tabellenspalten zu den vorab definierten Anzeigefeldern vornehmen und ggf. verschiedene Festlegungen treffen:
-    * Checkbox **CSV enthält in erster Zeile Spaltenüberschriften** anhaken, wenn zu importierende Tabelle Spaltenüberschriften enthält
+    * Checkbox **Überschriften in CSV** anhaken, wenn zu importierende Tabelle Spaltenüberschriften enthält
-    * Checkbox **nur einzigartige (keine doppelten) Taxa importieren** anhaken, wenn nur Datensätze von Taxa importiert werden sollen, zu denen es noch keinen entsprechenden Datensatz gibt (:!: Nur relevant für Datensätze, die direkt mit Taxa-Liste verknüpft sind; z.B. Art- und Belegdatensätze bei Bestikri und Virtuellem Herbarium, Standardnamen und Chromosomenzählung bei Chromosomendatenbank)
+    * Checkbox **Doppelte Taxa ignorieren** anhaken, wenn es sich um Nach-Importe handelt und nur Datensätze von Taxa importiert werden sollen, zu denen es noch keinen entsprechenden Datensatz gibt. :!: Ist in den meisten Fällen nicht zutreffend bzw. möglich. //(Nur möglich für Datensätze, die direkt mit Taxa-Liste verknüpft sind und bei denen einem Taxon aus der Taxliste nur ein Datensatz zugeordnet ist; z.B. Artdatensätze bei Bestikri und Virtuellem Herbarium. Siehe auch Anleitung zu Import Artdatensätze unter [[manual:import#import_verschiedener_datensatztypen_am_beispiel_bestikri|Import verschiedener Datensatztypen am Beispiel Bestikri]].)//
-    * Checkbox **Warnungen bei leeren Einträgen für Auswahllisten anzeigen** anhaken, falls dies für die zu importierende Tabelle relevant ist (:!: Nur relevant wenn Auswahllisten enthalten sind, für die bei allen Datensätzen eine Wert ausgewählt sein muss, also keine Leerzellen in der betreffenden Spalte enthalten sein dürfen)
+    * Checkbox **Warnungen bei leeren Einträgen** anhaken, falls dies für die zu importierende Tabelle relevant ist. //(:!: Nur relevant wenn Auswahllisten enthalten sind, für die bei allen Datensätzen eine Wert ausgewählt sein muss, also keine Leerzellen in der betreffenden Spalte enthalten sein dürfen)//
-    * Dropdown **veröffentlicht** -> **ja** auswählen wenn Datensätze im Frontend angezeigt werden sollen
+    * Dropdown **Öffentliche Sichtbarkeit** -> **ja, im Frontend sichtbar** auswählen wenn Datensätze im Frontend angezeigt werden sollen
-    * im Eingabefeld **Übergeordneter Datensatz (Menü-Elternelement)** falls zutreffend den betreffenden Datensatz auswählen (:!: Ist in den meisten Fällen nicht zutreffend. Nur relevant wenn alle Datensätze der zu importierenden Tabelle einem gemeinsamen Eltern-Datensatz zugeordnet werden können/müssen. Notwendig ist dies z.B. bei Import von Artdaten in Bestikri, damit der Menübaum entsprechend dargestellt wird. Bei den für jede Gattung separat erstellten Artdaten für Bestikri können alle jeweils enthaltenen Datensätze einem Gattungsdatensatz zugeordnet werden, z.B. können die Rosa-Artdatensätze alle dem Gattungsdatensatz "Rosa L. - Rose" zugeordnet werden usw. Siehe auch Darstellung Import Artdatensätze unter **[[manual:import#import_verschiedener_datensatztypen_am_beispiel_bestikri|Import verschiedener Datensatztypen am Beispiel Bestikri]]**
+    * im Eingabefeld **Übergeordneter Datensatz (Menü-Elternelement)** falls zutreffend den betreffenden Datensatz auswählen. :!: Ist in den meisten Fällen nicht zutreffend. //(Nur relevant wenn alle Datensätze der zu importierenden Tabelle einem gemeinsamen Eltern-Datensatz zugeordnet werden können/müssen. Notwendig ist dies z.B. bei Import von Artdaten in Bestikri, damit der Menübaum entsprechend dargestellt wird. Bei den für jede Gattung separat erstellten Artdaten für Bestikri können alle jeweils enthaltenen Datensätze einem Gattungsdatensatz zugeordnet werden, z.B. können die Rosa-Artdatensätze alle dem Gattungsdatensatz "Rosa L. - Rose" zugeordnet werden usw. Siehe auch Anleitung zum Import Artdatensätze unter [[manual:import#import_verschiedener_datensatztypen_am_beispiel_bestikri|Import verschiedener Datensatztypen am Beispiel Bestikri]].)//
-    * im Dropdown „Datensatztyp des Elternelements“ den gewünschten Datensatztyp auswählen, wenn die zum importierenden Datensätze mit einem in einem anderen Datensatz enthaltenen Elternelement verknüpft werden sollen/müssen. Das trifft nur zu wenn für eine bestimmte Spalte der zu importierenden Tabelle die Option **Beziehung: Elternelement mittels ...** ausgewählt wurde. (z.B. haben die Belegdatensätze bei Bestikri und Virtuellem Herbarium  eine Kind-Eltern-Beziehung zu den Artdaten, die Bilddatensätze eine Kind-Eltern-Beziehung zu den Belegdaten. Siehe Darstellung Import Beleg- bzw. Bilddatensätze unter **[[manual:import#import_verschiedener_datensatztypen_am_beispiel_bestikri|Import verschiedener Datensatztypen am Beispiel Bestikri]]**.
+    * im Dropdown „Datensatztyp des Elternelements“ den gewünschten Datensatztyp auswählen, wenn die zum importierenden Datensätze mit einem in einem anderen Datensatz enthaltenen Elternelement verknüpft werden sollen/müssen. :!: Das trifft nur zu wenn für eine bestimmte Spalte der zu importierenden Tabelle die Option **Beziehung: Elternelement mittels ...** ausgewählt wurde. //(z.B. haben die Belegdatensätze bei Bestikri und Virtuellem Herbarium  eine Kind-Eltern-Beziehung zu den Artdaten, die Bilddatensätze eine Kind-Eltern-Beziehung zu den Belegdaten. Siehe Darstellung Import Beleg- bzw. Bilddatensätze unter [[manual:import#import_verschiedener_datensatztypen_am_beispiel_bestikri|Import verschiedener Datensatztypen am Beispiel Bestikri]]).//
-    * Checkbox **Geocoder-Dienst benutzen** anhaken, wenn zu importierende Tabelle Einträge enthält die automatisch georeferenziert werden sollen (:!: es muss dann aber auch vorab definiert sein, wo die so erzeugten Geodaten abgelegt werden
+    * Checkbox **Geocoder-Dienst** anhaken, wenn zu importierende Tabelle Einträge enthält die automatisch georeferenziert werden sollen //(:!: es muss dann aber auch vorab definiert sein, wo die so erzeugten Geodaten abgelegt werden.)//
   *  -> **[Importieren]** drücken
-  * im nachfolgenden Dialog kann noch die **Anzahl der zu überspringenden Datensätze** festgelegt werden (das eröffnet die Möglichkeit eine bekannt Anzahl X bereits früher importierter Datensätze zu überspringen, sofern diese in den ersten X Zeilen der Tabelle stehen) -> **[Importieren]** drücken
+  * im nachfolgenden Dialog kann noch die **Anzahl der zu überspringenden Datensätze** festgelegt werden //(das eröffnet die Möglichkeit eine bekannt Anzahl X bereits früher importierter Datensätze zu überspringen, sofern diese in den ersten X Zeilen der Tabelle stehen)// -> **[Importieren]** drücken
   * der Fortschrittsbalken zeigt in Schritten von 10 Datensätzen den Verlauf des Imports, im Fenster **Log** werden Importfehler angezeigt
   * nach Abschluss des Imports wird entsprechende Meldung angezeigt
   * zum Abschluss ggf. Button **[[manual:import#datensatz-namen_aktualisieren|[Datensatz-Namen aktualisieren]]]** drücken
+==== Bilddatensätze ====
+Wenn Datensätze importiert werden, welche [[manual:glossar#anzeigefelder|Anzeigefelder]] des [[manual:glossar#datentyp|Datentyps]] //Bilddatei// enthalten, so sollten die zugehörigen Original-Bilddateien im JPEG-Format (''.jpg'') **vorher** auf den Server ins Verzeichnis ''public/storage/images/full/'' hochgeladen werden. Dies geschieht am besten mittels [[wpde>SSH_File_Transfer_Protocol|SFTP]] oder [[wpde>File_Transfer_Protocol|FTP]], z.B. mit dem Desktop-Programm [[https://filezilla-project.org/|FileZilla]]. Das genaue Vorgehen ist abhängig von der Konfiguration des Servers und der verwendeten Software. Wenden Sie sich bezüglich Zugang und Unterstützung bitte an den zuständigen Server-Administrator.
+Während des Import werden automatisch Vorschaubilder ("Thumbnails") und ggf. Bilder in mittlerer Größe erzeugt. Die Konfiguration der Speicherpfade und genauen Abmessungen sind in der Datei ''config/media.php'' zu finden uns sollten vorher geprüft und ggf. angepasst werden.
+Alternativ ist es möglich, nach abgeschlossenem Import der Datensätze die Vorschaubilder in kleiner und mittlerer Größe eigenständig zu erzeugen und anschließend auf dem Server in den Verzeichnissen ''public/storage/images/preview/'' bzw. ''public/storage/images/medium/'' abzulegen.
@@ Zeile 85: / Zeile 101: @@
 Es ist ebenso möglich, die automatische Erzeugung der Datensatz-Namen jederzeit //nach// einem Import durchzuführen oder zu wiederholen: Menü **//Admin//** -> **//Datensatz-Namen aktualisieren//**
 ==== Import verschiedener Datensatztypen am Beispiel Bestikri ====
-Im Folgenden wird der Import von drei verschiedenen Datensatztypen am Beispiel des Portals Bestikri speziefiziert.
+Im Folgenden wird der Import von drei verschiedenen Datensatztypen am Beispiel des Portals Bestikri spezifiziert.
 === Artdatensätze ===
@@ Zeile 95: / Zeile 112: @@
   * im sich öffnenden Dialog **Datensatztyp** Artdaten auswählen, Datei auswählen und die in der CSV verwendeten Trennzeichen für Tabellenspalten und Elemente von Mehrfachauswahllisten festlegen -> **[Hochladen]** drücken
   * im sich öffnenden Dialog Zuordnung der Tabellenspalten zu den vorab definierten Anzeigefeldern vornehmen und verschiedene Festlegungen treffen:
-    * Spalte "Wissenschaftlicher_Name" -> **Beziehung: Taxon mittels Vollname** auswählen
+    * Spalte "Wissenschaftlicher_Name" -> **Beziehung: Taxon mittels Vollname** auswählen (dadurch wird die Verknüpfung des Datensatzes mit der Taxliste realisiert; entspricht der Auswahl des verknüpften Taxons" bei Anlegen einzelner Datensätze)
     * Spalten "Synonyme" "Dt. Name", "Sektion" ignorieren, werden automatisch erzeugt
-    * Spalte "Menü-Zuordnung" -> **Beziehung: Elternelement mittels Taxon** auswählen
+    * Spalte "Menü-Zuordnung" -> **Beziehung: Elternelement mittels Taxon** auswählen (dadurch wir der Datensatz mit dem Elterndatensatz verknüpft, und zwar über den vollständigen wiss. Namen)
     * für restliche Spalten entsprechende Anzeigenamen wählen
     * Checkbox **CSV enthält in erster Zeile Spaltenüberschriften** anhaken
-    * Checkbox **nur einzigartige (keine doppelten) Taxa importieren** nur anhaken, wenn es sich um Nachimport handelt und nur Datensätze von Taxa importiert werden sollen, zu denen es noch keinen Artdatensatz gibt
+    * Checkbox **nur einzigartige (keine doppelten) Taxa importieren** nur anhaken, wenn es sich um Nach-Import handelt und nur Datensätze von Taxa importiert werden sollen, zu denen es noch keinen Artdatensatz gibt
     * Dropdown **veröffentlicht** -> **ja** auswählen wenn Datensätze im Frontend angezeigt werden sollen
-    * im Eingabefeld **Übergeordneter Datensatz (Menü-Elternelement)** die zu den Artdatensäten gehörende Gattung auswählen
+    * im Eingabefeld **Übergeordneter Datensatz (Menü-Elternelement)** die zu den Artdatensätzen gehörende Gattung auswählen
     * im Dropdown **Datensatztyp des Elternelements** Art-Datensatz auswählen
   *  -> **[Importieren]** drücken
-  * im nachfolgenden Dialog kann noch die **Anzahl der zu überspringenden Datensätze** festgelegt werden (das eröffnet die Möglichkeit eine bekannt Anzahl X bereits früher importierter Datensätze zu überspringen, sofern diese in den ersten X Zeilen der Tabelle stehen) -> **[Importieren]** drücken
+  * im nachfolgenden Dialog kann noch die **Anzahl der zu überspringenden Datensätze** festgelegt werden //(das eröffnet die Möglichkeit eine bekannt Anzahl X bereits früher importierter Datensätze zu überspringen, sofern diese in den ersten X Zeilen der Tabelle stehen)// -> **[Importieren]** drücken
   * der Fortschrittsbalken zeigt in Schritten von 10 Datensätzen den Verlauf des Imports, im Fenster **Log** werden Importfehler angezeigt
   * nach Abschluss des Imports wird entsprechende Meldung angezeigt
@@ Zeile 113: / Zeile 130: @@
 === Belegdatensätze ===
-:!: Spalte "Wissenschaftlicher_Name (_Importname)" in CSV vor dem Import duplizieren (muss zweimal vorhanden sein)
+:!: Spalte "Wissenschaftlicher_Name (_Importname)" in CSV vor dem Import duplizieren //(muss zweimal vorhanden sein)//
   * unter Menü **//Import//** -> **//Datensätze//** auswählen
@@ Zeile 137: / Zeile 154: @@
 === Bilddatensätze ===
-:!: Spalte "Masterbarcode" in CSV vor dem Import duplizieren (muss zweimal vorhanden sein)
+:!: Spalte "Masterbarcode" in CSV vor dem Import duplizieren //(muss zweimal vorhanden sein)//
   * unter Menü **//Import//** -> **//Datensätze//** auswählen
@@ Zeile 143: / Zeile 160: @@
   * im sich öffnenden Dialog Zuordnung der Tabellenspalten zu den vorab definierten Anzeigefeldern vornehmen und verschiedene Festlegungen treffen:
     * Spalte "Masterbarcode" -> Anzeigefeld **Masterbarcode** auswählen
-    * duplizierte Spalte "Masterbarcode_2" -> **Beziehung: Elternelement mittels Detail** auswählen
+    * duplizierte Spalte "Masterbarcode_2" -> **Beziehung: Elternelement mittels Detail** auswählen (dadurch wir der Datensatz mit dem Elterndatensatz verknüpft, und zwar über ein beliebig wählbares Anzeigefeld, hier der Masterbarcode)
     * Spalte "Wissenschaftlicher_Name(_Importname)" -> **Beziehung: Taxon mittels Vollname** auswählen
     * falls vorhanden Spalte "Wissenschaftlicher_Name(_Anzeigename)" -> Anzeigefeld **Wissenschaftlicher Name** auswählen
     * für restliche Spalten entsprechende Anzeigenamen wählen
     * Checkbox **CSV enthält in erster Zeile Spaltenüberschriften** anhaken
-    * Checkbox **nur einzigartige (keine doppelten) Taxa importieren** nie anhaken
+    * Checkbox **nur einzigartige (keine doppelten) Taxa importieren** nie anhaken //(zu jedem Taxon gehören in der Regel mehrere Belegdatensätze, wenn diese Checkbox angehakt wäre, würde aber jeweils nur ein Belegdatensatz pro Taxon importiert werden)//
     * Dropdown **veröffentlicht** -> **ja** auswählen wenn Datensätze im Frontend angezeigt werden sollen
     * im Eingabefeld **Übergeordneter Datensatz (Menü-Elternelement)** -> **keine** auswählen
     * im Dropdown **Datensatztyp des Elternelements** Beleg-Datensatz auswählen
   *  -> **[Importieren]** drücken
-  * im nachfolgenden Dialog kann noch die **Anzahl der zu überspringenden Datensätze** festgelegt werden (das eröffnet die Möglichkeit eine bekannt Anzahl X bereits früher importierter Datensätze zu überspringen, sofern diese in den ersten X Zeilen der Tabelle stehen) -> **[Importieren]** drücken
+  * im nachfolgenden Dialog kann noch die **Anzahl der zu überspringenden Datensätze** festgelegt werden //(das eröffnet die Möglichkeit eine bekannt Anzahl X bereits früher importierter Datensätze zu überspringen, sofern diese in den ersten X Zeilen der Tabelle stehen)// -> **[Importieren]** drücken
   * der Fortschrittsbalken zeigt in Schritten von 10 Datensätzen den Verlauf des Imports, im Fenster **Log** werden Importfehler angezeigt
   * nach Abschluss des Imports wird entsprechende Meldung angezeigt