Csv Import: Unterschied zwischen den Versionen

Aus HI-LONa
Zur Navigation springen Zur Suche springen
(Ergänzung um Einlesen noch fehlender Attribute (Felder))
 
(8 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
== Importieren von großen Datenmengen über CSV-Dateien ==
Um massenweise automatisch erstellte Inhalte zu importieren, kann die Spezialseite [[Spezial:CSV_importieren]] benutzt werden.
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.
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.


Die CSV-Dateien müssen folgendermaßen aufgebaut sein:
=== Allgemeine Formatvorgaben für CSV-Dateien ===


* Komma als Trennzeichen
* Komma als Trennzeichen
Zeile 11: Zeile 12:
Richtiges Beispiel:
Richtiges Beispiel:


<code>
<pre>
<pre>
Titel,Lernthema[Name-DE]
Titel,Lernthema[Name-DE]
Zeile 17: Zeile 17:
LT-PIN-102,"Rot, Gelb und Grün"
LT-PIN-102,"Rot, Gelb und Grün"
</pre>
</pre>
</code>


Meistens wählt man nun "vorhandenen Inhalt überschreiben" aus, das bedeutet, dass Unterseiten, die durch die erste Spalte identifiziert werden, komplett neu angelegt und mit den Infos aus der jeweiligen Zeile überschrieben werden.
===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.


Beispiel für eine syntaktisch valide, komplette Eingabedatei (Lernthemen eines Kataloges):
=== Formatvorgaben für das Einlesen von Lernthemen und Lernzielen ===


<code>
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'':
<pre>
Titel,Lernthema[Thema-ID],Lernthema[Name-DE],Lernthema[Domäne],Lernthema[Katalog],Lernthema[Toplevel-Thema]
</pre>
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'':
<pre>
<pre>
Titel,Lernthema[Thema-ID],Lernthema[Name-DE],Lernthema[Domäne],Lernthema[Katalog],Lernthema[Toplevel-Thema]
Titel,Lernthema[Thema-ID],Lernthema[Name-DE],Lernthema[Domäne],Lernthema[Katalog],Lernthema[Toplevel-Thema]
Zeile 33: Zeile 50:
LT-PIN-106,2.1,Grundlagen des Informationsmanagements,D-PIN 102,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
LT-PIN-107,2.2,Datenquellen & Interoperabilität,D-PIN 102,HKI,Ja
LT-PIN-108,2.3,Datenqualität,D-PIN 102,HKI,Ja
LT-PIN-109,3.1,Digitale Identität,D-PIN 103,HKI,Ja
LT-PIN-110,3.2,Digitale Kommunikation,D-PIN 102,HKI,Ja
LT-PIN-111,4.1,IT-Sicherheit & Datenschutz,D-PIN 104,HKI,Ja
LT-PIN-112,4.2,Qualitäts- und Risikomanagement,D-PIN 104,HKI,Ja
LT-PIN-113,4.3,Zugangssicherheit bei digitalen Anwendungssystemen,D-PIN 104,HKI,Ja
LT-PIN-114,5.1,Rechtliche Grundlagen,D-PIN 105,HKI,Ja
LT-PIN-115,5.2,Ethische Aspekte,D-PIN 105,HKI,Ja
LT-PIN-116,6.1,Forschungsgrundlagen,106,HKI,Ja
LT-PIN-117,6.2,Informationsbeschaffung & Wissensquellen,D-PIN 106,HKI,Ja
LT-PIN-118,6.3,Datenanalyse,D-PIN 106,HKI,Ja
LT-PIN-119,7.1,Digitale Technologien in der Versorgung,D-PIN 107,HKI,Ja
LT-PIN-120,7.2,Systemkompetenz & Kontinuität,D-PIN 107,HKI,Ja
LT-PIN-121,8.1,Digital Health Literacy,D-PIN 108,HKI,Ja
LT-PIN-122,8.1,Unterstützung & Beratung,D-PIN 108,HKI,Ja
LT-PIN-123,9.1,Innovationen & Zukunft,D-PIN 109,HKI,Ja
</pre>
</pre>
</code>


''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'':
<pre>
Titel,Lernziel[LZ-ID],Lernziel[Beschreibung-DE],Lernziel[Kompetenzniveau in Level 1],Lernziel[Katalog],Lernziel[Domäne],Lernziel[Thema],
</pre>
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'':
<pre>
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
</pre>
''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.
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  
In der Einleseroutine [[Spezial:CSV_importieren]] kann für bereits vorhandene Seiten ausgewählt werden ob  

Aktuelle Version vom 31. Juli 2026, 13:15 Uhr

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.