Csv Import

Aus HI-LONa
Version vom 31. Juli 2026, 13:15 Uhr von Bschneider (Diskussion | Beiträge) (→‎Einlesen von Lernthemen zu einem Katalog)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Importieren von großen Datenmengen über CSV-Dateien

Um massenweise automatisch erstellte Inhalte zu importieren, kann die Spezialseite Spezial:CSV_importieren benutzt werden. Nach dem Klick auf "Importieren" muss unbedingt auf dem Server "docker compose exec mediawiki php maintenance/runJobs.php" ausgeführt werden, sonst werden die Änderungen nicht durchgeführt.

Allgemeine Formatvorgaben für CSV-Dateien

  • Komma als Trennzeichen
  • UTF-8 als Textkodierung
  • Wenn Texte Kommas enthalten, muss der komplette Text in Anführungszeichen gesetzt werden. Die Kommas selbst werden dann nicht weiter escaped.
  • Keine Leerzeile am Ende.

Richtiges Beispiel:

Titel,Lernthema[Name-DE]
LT-PIN-101,Krieg und Frieden
LT-PIN-102,"Rot, Gelb und Grün"

Vorgehen beim Einlesen eines neuen Kataloges

  • Neuen Katalog in HI-LONa anlegen (über Benutzeroberfläche).
  • Domänen des Kataloges in HI-LONa anlegen (über Benutzeroberfläche).
  • Lernthemen als CSV-Datei einlesen, falls der Katalog einen Gegenstandskatalog hat.
  • Lernziele als csv-Datei einlesen.

Formatvorgaben für das Einlesen von Lernthemen und Lernzielen

Die erste Zeile der CSV-Datei beschreibt,

  • zu welcher Kategorie Seiten angelegt bzw. üverschrieben und ergänzt werden und
  • welche Felder (Attribute) die Datei enthält. Es kann auch nur eine Untermenge aller Felder einer Kategorie eingelesen werden.

Einlesen von Lernthemen zu einem Katalog

Beispiel:

Titel,Lernthema[Thema-ID],Lernthema[Name-DE],Lernthema[Domäne],Lernthema[Katalog],Lernthema[Toplevel-Thema]

Für eine Liste aller Felder der Kategorie Lernthema siehe Vorlage:Lernthema.

Alle weiteren Zeilen, die den eigentlichen einzulesenden Inhalt enthalten, folgen genau dem Schema der ersten Zeile. Titel ist der neue Seitenname. Für Lernthemen bitte LT-PIN-n verwenden, wobei n noch nicht im Zahlenraum der LT-PINs vergeben sein darf. Beispiel:

Titel,Lernthema[Thema-ID],Lernthema[Name-DE],Lernthema[Domäne],Lernthema[Katalog],Lernthema[Toplevel-Thema]
LT-PIN-101,1.1,Grundlagen,D-PIN 101,HKI,Ja
LT-PIN-102,1.2,Informationssysteme,D-PIN 101,HKI,Ja
LT-PIN-103,1.3,Telematikinfrastruktur,D-PIN 101,HKI,Ja
LT-PIN-104,1.4,KI Grundlagen,D-PIN 101,HKI,Ja
LT-PIN-105,1.5,Klinische Entscheidungsunterstützung,D-PIN 101,HKI,Ja 
LT-PIN-106,2.1,Grundlagen des Informationsmanagements,D-PIN 102,HKI,Ja
LT-PIN-107,2.2,Datenquellen & Interoperabilität,D-PIN 102,HKI,Ja

Hinweise:

  • Lernthema[Domäne]: Hier muss der Seitenname der Domäne angegeben werden (z.B. D-PIN 102), zu der das Lernthema gehört - siehe dazu die zuvor angelegten Domänen.
  • Lernthema[Katalog]: Hier muss der Seitenname des Katalogs angegeben werden (z.B. Test-Katalog), zu dem das Lernthema gehört - siehe dazu das Kürzel des zuvor angelegten Katalogs.

Einlesen von Lernzielen zu einem Katalog

Beispiel:

Titel,Lernziel[LZ-ID],Lernziel[Beschreibung-DE],Lernziel[Kompetenzniveau in Level 1],Lernziel[Katalog],Lernziel[Domäne],Lernziel[Thema],

Für eine Liste aller Felder der Kategorie Lernziel siehe Vorlage:Lernziel.

Alle weiteren Zeilen, die den eigentlichen einzulesenden Inhalt enthalten, folgen genau dem Schema der ersten Zeile. Titel ist der neue Seitenname. Für Lernziele bitte LZ-PIN_n verwenden, wobei n noch nicht im Zahlenraum der LZ-PINs vergeben sein darf. Beispiel:

Titel,Lernziel[LZ-ID],Lernziel[Beschreibung-DE],Lernziel[Kompetenzniveau in Level 1],Lernziel[Katalog],Lernziel[Domäne],Lernziel[Thema]
LZ-PIN 70001,1.1.1,"Erläutert zentrale Begriffe der digitalen Medizin (z.B. mHealth, eHealth, Telemedizin, ...) und wendet diese in fachlichen Kontexten des Hebammenwesens korrekt an.",Kennen & Verstehen,HKI,D-PIN 111,LT-PIN-101
LZ-PIN 70002,1.1.2,"Definiert und unterscheidet zentrale Begriffe der medizinischen Informatik (z.B. Informationen, Wissen, Daten, Interoperabilität) und wendet sie in fachlichen Kontexten des Hebammenwesens korrekt an.",Kennen & Verstehen,HKI,D-PIN 111,LT-PIN-101

Hinweise:

  • Lernziel[Katalog]: Hier muss der Seitenname des Katalogs angegeben werden (z.B. Test-Katalog), zu dem das Lernziel gehört - siehe dazu das Kürzel des zuvor angelegten Katalogs.
  • Lernziel[Domäne]: Hier muss der Seitenname der Domäne angegeben werden (z.B. D-PIN 102), zu der das Lernziel gehört - siehe dazu die zuvor angelegten Domänen.
  • Lernziel[Thema]: Hier muss der Seitenname des Lernthemas angegeben werden (z.B. LT-PIN-101), zu dem das Lernziel gehört - siehe dazu die zuvor angelegten Lernthemen.

Ergänzen von Attributen (Feldern) über eine CSV-Datei

Sollen nur bestimmte Attribute bei einem Katalog o.ä. ergänzt werden, so können die Seiten über den Seitennamen (Titel) identifiziert werden und die fehlenden Attribute angegeben werden. In der Einleseroutine Spezial:CSV_importieren kann für bereits vorhandene Seiten ausgewählt werden ob

  • Nur in der Datei enthaltene Felder (Attribute) überschrieben werden (sollte hier ausgewählt werden)
  • solche Seiten nicht importiert werden
  • Vorhandener Inhalt ergänzt wird.