Datenbank erstellen: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
(Inkonsistenz. Datenbankeinträge importieren wurde zur Kategorie "Nutzung" zum gleichnamigen Artikel verschoben bzw. vereint.)
(doppelten Text mit Seite Datenbankvorlagen entfernt)
Zeile 85: Zeile 85:
[[File:Numberfield.png]]
[[File:Numberfield.png]]


==Vorlagen==
Vorlagen für [[Datenbank | Datenbanken]] erlauben Ihnen die volle Kontrolle über das Aussehen der Datenbankeinträge, wenn Sie diese in einer Liste oder einzeln betrachten, aber auch bei der Eingabe der Einträge. Diese Funktionalität ist ähnlich wie in den Serienbrieffunktionen gängiger Textverarbeitungsprogramme. Sie verwenden Platzhalter, die später durch die eigentlichen Einträge ersetzt werden.
[[Image:Datenbankvorlagen.jpg|thumb|right|Vorlage für Einzelansicht]]
Um die verschiedenen Vorlagen zu erstellen, gehen Sie wie folgt vor:
# Klicken Sie die Datenbank auf der Kursseite oder im Block ''[[Navigation-Block|Navigation]]'' an. Sie gelangen auf die Ansichtsseite der Datenbank.
# Auf der Ansichtsseite der Datenbank klicken Sie auf den Reiter ''Vorlagen''. Oder Sie wählen im Block ''[[Einstellungen-Block|Einstellungen]] > Datenbank-Administration > Vorlagen'' die gewünschte Vorlage aus. Es erscheint eine Seite, auf der Sie die jeweilige Vorlage bearbeiten können.
#Das Erstellen eigener Vorlagen erfordert Grundkenntnisse der [[Datenbank erstellen#Syntax in Datenbankvorlagen|Syntax]]. Im einfachsten Fall verwenden Sie die vorgegebene Standardvorlage und klicken nur auf den Button ''Vorlage speichern''.
'''''Wichtiger Hinweis: Sie müssen alle Vorlagen einzeln anklicken und speichern - andernfalls können keine Einträge in der Datenbank erstellt bzw. angezeigt werden!'''''
In Moodle gibt es derzeit folgende Datenbankvorlagen:
;Vorlage für Liste
:Mit dieser Vorlage können Sie die Ansicht der Felder und das Layout der Seite (wenn Sie mehrere Einträge auf einmal anzeigen möchten, z.B. Suchergebnisse) festlegen. Mit dieser Ansicht ist es möglich, eine einfache Übersicht über alle Einträge zur Verfügung zu stellen. Weiterführende Informationen zu den einzelnen Einträgen erhält man, wenn man auf den jeweiligen Eintrag klickt.
:Die Vorlage für die Listenansicht kann auch genutzt werden, um die Datenbank in eine CSV-Datei zu [[Datenbank nutzen#Datenbankeinträge exportieren |exportieren]].
;Vorlage für Einzelansicht
:Mit dieser Ansicht wird immer nur ein einziger Eintrag dargestellt. So steht Ihnen hier mehr Platz zur Anzeige des Eintrages zur Verfügung, und Sie können neben allen Feldern, die dieser Eintrag umfasst, auch größere Bilder als in der Listenansicht zur Verfügung stellen.
;Vorlage zur erweiterten Suche
:Die Vorlage für die erweiterte Suche erlaubt eine Anpassung der Ansicht der Suchergebnisse.
;Vorlage für neue Einträge
:Mit dieser Vorlage bestimmen Sie das Aussehen der Seite zum Hinzufügen bzw. Bearbeiten von Datenbankeinträgen.
;Vorlage für RSS-Feed
:Mittels der Vorlage für RSS-Feeds können Sie den Inhalt Ihres RSS-Feeds zur Datenbank bestimmen.
==== CSS für Vorlagen ====
Wenn Sie in Ihrer Datenbank HTML-Tags verwenden, die spezielle Formatierungen via CSS benötigen, so können Sie im Block ''[[Einstellungen-Block|Einstellungen]] > Datenbank-Administration > Vorlagen > CSS für Vorlagen'' anklicken und die datenbankspezifische CSS-Datei bearbeiten.
==== JavaScript für Vorlagen ====
Sie können JavaScript zur Manipulation der Elemente nutzen, die in der Listen- oder Einzelansicht sowie beim Hinzufügen von Datensätzen angezeigt werden. Zur Programmierung klicken Sie im Block ''[[Einstellungen-Block|Einstellungen]] > Datenbank-Administration > JavaScript für Vorlagen''.
Prinzipiell müssen Sie den Teil, den Sie bearbeiten möchten, in ein benanntes HTML-Element einschließen. Die Benennung ist wichtig, da sie es erlaubt, das Element bei der Bearbeitung eindeutig zu identifizieren.
'''Beispiel''':
Sie haben ein Feld in Ihrer Datenbank, welches den Namen ein Person speichert, und wenn Sie die Namen in der Listenansicht ansehen, möchten Sie bestimmte Vorkommen von Namen zählen und das Ergebnis anzeigen lassen.
Ihre Datenbank beinhaltet nun ein Feld ''Name''. In Ihrer Listenansicht können Sie dieses Feld durch <nowiki>[[name]]</nowiki> an der Stelle anzeigen lassen, wo Sie es benötigen. Zum Beispiel haben Sie dann im Eingabebereich ''Wiederholter Bereich'' stehen:
<pre>
<table>
  <tr>
    <td>Name: [[name]]</td>
  </tr>
<table> 
</pre>
Nun müssen Sie diesen Code bearbeiten um sicherzustellen, dass der Teil, den Sie mittels JavaScript verarbeiten möchten, ein benanntes HTML-Element ist.
<pre>
<table>
  <tr>
    <td name="named">Name: [[name]]</td>
  </tr>
<table> 
</pre>
Im Fußzeilenbereich Ihrer Listenansicht können Sie ein weiteres benanntes Feld einfügen, um zum Beispiel das Ergebnis anzuzeigen.
<pre>
  <div name="result"></div>
</pre>
Ihre JavaScript-Vorlage kann nun zum Beispiel so aussehen:
<pre>
var cnt = 0;
var re = /foo|Foo/;
function init(){
  var namedElements = document.getElementsByName("named");
  for (i=0; i < namedElements.length; i++) {
      if(re.test(namedElements[i].innerHTML)) cnt++;
    }
  var namedResult = document.getElementsByName("result");
  namedResult[0].innerHTML = cnt;
  }
window.onload = init;
</pre>
Dieser Code zeigt eine Tabelle aller Namen in der Listenansicht an, ohne sie zu verändern. In der Fußzeile hingegen wird noch die Anzahl der Namen angezeigt, die mit ''foo'' oder ''Foo'' übereinstimmen.
==== Syntax in Datenbankvorlagen ====
Der Inhalt jedes Datenbankfelds, dass Sie in Ihrer Datenbank anlegen und einige spezielle Elemente(Tags) können in die Datenbankvorlage eingearbeitet werden.
Felder werden im Format <code><nowiki>[[fieldname]]</nowiki></code> angegeben. Alle anderen Elemente(Tags) sehen so aus: <code>##sometag##</code>.
Um die einzelnen Elemente (Tags), die in der Box links auf der Seite zur Verfügung stehen, Ihrer Vorlage hinzuzufügen, nutzen Sie den Editor (HTML-Modus ausgeschaltet). Positionieren Sie den Cursor an der Stelle, an der Sie eines der Felder oder Elemente einfügen möchten. Klicken Sie nun links auf den gewünschten Eintrag, und das Feld / Element wird an der korrekten Stelle übernommen. Alternativ können Sie die Platzhalter auch manuell einfügen, in dem Sie die entsprechenden Werte und die benötigten Symbole eintippen: <code>##this##</code> oder <code><nowiki>[[this]]</nowiki></code>.
* <code>##edit##</code> erzeugt ein anklickbares Symbol, mit dem es Ihnen möglich ist, den aktuellen Eintrag zu bearbeiten (dieses Symbol erscheint aber immer nur dann, wenn es Ihnen auf Grund Ihrer Rollenrechte gestattet ist, Einträge zu bearbeiten).
* <code>##delete##</code> erzeugt ein anklickbares Symbol, mit dem es Ihnen möglich ist, den aktuellen Eintrag zu löschen (dieses Symbol erscheint aber immer nur dann, wenn es Ihnen auf Grund Ihrer Rollenrechte gestattet ist, Einträge zu löschen).
* <code>##approve##</code> erzeugt ein anklickbares Symbol, mit dem es Ihnen möglich ist, den aktuellen Eintrag zu prüfen und freizugeben (dieses Symbol erscheint aber immer nur dann, wenn es Ihnen auf Grund Ihrer Rollenrechte gestattet ist, dies zu tun).
* <code>##more##</code> erzeugt einen Link zur Einzelansicht eines Eintrages, so können alle Informationen des Eintrages aufgerufen werden.
* <code>##moreurl##</code> erzeugt nur die URL für den oben erwähnten Link. Dies ist hilfreich, wenn Sie Ihre eigenen Links nutzen möchten. Sie können auf das Link-Symbol klicken und schreiben <code>##moreurl##</code> in das URL-Feld, oder Sie schreiben im HTML-Modus <pre><a href="##moreurl##">[[fieldname]]</a></pre>
* <code>##comments##</code> erzeugt einen Link um Kommentare anzusehen / hinzuzufügen. Als Linktext wird die aktuelle Anzahl an Kommentaren verwendet. (Dieser Link erscheint nur, wenn Kommentare in der Datenbank erlaubt sind.)
* <code>##user##</code> erzeugt einen Link zur Profilseite des Nutzers, der diesen Eintrag erstellt hat. Als Linktext wird der Name des Nutzers verwendet.
Weitere Elemente sind:
* <code>##timeadded##</code> zeigt an, wann der Eintrag hinzugefügt wurde.
* <code>##timemodified##</code> zeigt an, wann der Eintrag zum letzten Mal bearbeitet wurde.
* <code>##firstname##</code> gibt den Vornamen des Nutzers an, der den Beitrag erstellt hat.
* <code>##lastname##</code> gibt den Nachnamen des Nutzers an, der den Beitrag erstellt hat.
==== Vorlagen zurücksetzen ====
Wenn Sie zum ersten Mal eine Datenbank erstellen, sind die Vorlagen mit einem entsprechenden HTML-Code gefüllt. Wenn Sie später Felder hinzufügen, dann können Sie die Schaltfläche ''Vorlage zurücksetzen'' nutzen, um eine ähnliche Standard-HTML-Formatierung zu erzeugen. Haben Sie jedoch bereits Änderungen an der Vorlage durchgeführt, dann gehen diese verloren. Daher wird empfohlen, zuerst alle Datenbankfelder anzulegen und erst zum Schluss die Vorlagen zu bearbeiten.


==Vorlagensätze verwenden==
==Vorlagensätze verwenden==

Version vom 20. März 2023, 10:33 Uhr

Baustelle.png Diese Seite muss überarbeitet werden, weil sie neue Funktionalitäten enthält. Greif zu!
Wenn du dich um diesen Artikel kümmern willst, dann kennzeichne das, indem du die Vorlage {{ÜberarbeitenNeu}} durch die Vorlage {{ÜberarbeitenVergeben}} ersetzt.
Wenn du mit deiner Arbeit fertig bist, dann entferne die Vorlage aus dem Artikel.
Danke für deine Mitarbeit!


Nachdem Sie eine Datenbank im Kurs angelegt und konfiguriert haben, müssen Sie nun

  • die Datenbankfelder festlegen, und zwei Textfelder für den Maler und für den Titel des Gemäldes. Alternativ können Sie eine Datenbankvorlage verwenden.
  • Optional können Sie die Datenbankvorlagen bearbeiten, um die Darstellung der Datenbankeinträge zu ändern.


Datenbankfelder

Ein Feld ist eine Informationseinheit mit einem Namen und einem Datentyp. Wenn Sie sich eine Datenbank als Tabelle mit Datensätzen vorstellen, dann entsprechen die Felder den Spalten der Tabelle. Ein Datenbankeintrag besteht aus einem oder mehreren Feldern und entspricht einer Zeile in der Tabelle. Wenn Sie die Felder mit den passenden Datentypen anlegen, können Sie alle relavanten Informationenin ihren Datenbankeintrag speichern.

Hinweis: Wenn Sie die Felder nachträglich bearbeiten, müssen Sie die Vorlagen über den entsprechenden Button zurücksetzen oder manuell bearbeiten, damit die neuen Felder in der Anzeige der Datenbankeinträge erscheinen.

Feldname und Feldbeschreibung

Der Name des Feldes wird angezeigt, wenn Sie später einen Datenbankeintrag erstellen. Er sollte kurz und eindeutig sein. Die Beschreibung ist nur für Sie gedacht, um das Feld zu identifizieren.

Pflichtfeld

Wenn Sie möchten, dass ein Feld zwingend ausgefüllt werden, muss, dann markieren Sie die Checkbox. Bei der Erstellung eines Datenbankeintrags werden Pflichtfelder mit einem roten Stern markiert. Der Eintrag kann erst gespeichert werden, wenn alle Pflichtfelder ausgefüllt sind. Trainer/innen sehen in der Ansicht Felder in einer Extraspalte, welche Felder Pflichfelder sind und welche nicht.

databaserequiredfields.png

Feldtypen

In Moodle gibt es verschiedene Datentypen für die Felder einer Datenbank. Die Screenshots zeigen die verschiedenen Typen einmal aus der Sicht der Trainer/innen, wenn sie ein Feld anlegen, und einmal aus der Sicht der Kursteilnehmer/innen, wenn sie einen Datenbankeintrag erstellen und das Feld ausfüllen.

Bild
Nutzen Sie dieses Feld, wenn Nutzer/innen der Datenbank Bilddateien hochladen sollen. Neben dem Feldnamen und der -beschreibung können Sie hier auch jeweils definieren, welche Größe das Bild (Breite / Höhe) in der Einzel- und der Listenansicht haben soll. Die Darstellung in der Einzelansicht kann größer sein als die in der Listenansicht. Sie können auch eine maximale Bilddateigröße festlegen.

Picturefield.png

Checkboxen
Mit diesem Feld können Sie Checkboxen zur Verfügung stellen, die die Nutzer/innen anklicken können. Tragen Sie die einzelnen Optionen zeilenweise untereinander ein. Die einzelnen Optionen werden in der Teilnehmeransicht neben der jeweiligen Checkbox angezeigt. Die Nutzer/innen können eine oder mehrere Checkboxen markieren.

Checkboxfield1.png

Datei
Hier haben Nutzer/innen die Möglichkeit, eine beliebige Datei hochzuladen. Wenn es sich um eine Bilddatei handelt, eignet sich der Feldtyp Bild besser.

Filefield.png

Datum
Hier können Nutzer/innen ein Datum eingeben, indem sie einen Tag, einen Monat und ein Jahr aus einem Auswahlmenü auswählen.

Datefield1.png

Dropdown-Menü
Bei diesem Feldtyp können Nutzer/innen eine Option aus einem Auswahlmenü auswählen. Tragen Sie die einzelnen Optionen zeilenweise untereinander ein.

Menufield.png

Einfachauswahl
Stellen Sie den Nutzer/innen die Möglichkeit zur Verfügung, genau eine Auswahl unter mehreren Optionen zu treffen. Der Datenbankeintrag kann erst gespeichert werden, wenn eine Option ausgewählt ist. (Hinweis: Wenn Sie nur zwei gegenteilige Optionen haben, z.B. Wahr/Falsch oder Ja/Nein, können Sie auch den Feldtyp Checkboxen nutzen. Beachten Sie jedoch, dass Checkboxen standardmäßig unmarkiert sind, so dass Nutzer/innen ihren Datenbankeintrag speichern können, ohne eine der beiden Optionen zu wählen. Prüfen Sie daher, ob das in Ihrem Kontext sinnvoll ist.)

Radiofield.png

Koordinaten
Mit diesem Feldtyp können Nutzer/innen einen geografischen Ort als Breiten- und Längenangabe angeben. Zum Beispiel befindet sich das Moodle HQ bei -31.9545 Breite, 115.877 Länge. Wenn der Datenbankeintrag angezeigt wird, werden diese Angaben automatisch mit geografischen Diensten wie Google Earth, OpenStreetMap, GeaBios,Mapstars und anderen verlinkt. Trainer/innen können wählen, welcher dieser Links zum Einsatz kommt.
Die Eingaben für dieses Feld müssen relativ zu Nord und Ostkoordinaten angegeben werden. Um West- oder Südkoordinaten in Nord- und Ostkoordinaten zu konvertieren (z.B. 120W), tragen Sie den Wert mit vorangestelltem Minuszeichen ein (z.B. -120). Die Daten müssen außerdem im Dezimalformat angegeben werden (nicht im Gradmaß: Für die Umwandlung nutzen Sie passende Konvertierer im Web). T

Latlongfield.png

Kurzer Text
Nutzer/innen können in dieses Feld Text bis zu einer Länge von 60 Zeichen eingeben. Für längeren Text oder Text, der mit Formatierungen (Aufzählungszeichen etc.) versehen werden soll, nutzen Sie bitte das Feld Textbereich.

Textfield.png

Mehrfachauswahl
Bei diesem Feldtyp können Nutzer/innen eine oder mehrere Optionen aus einem Auswahlmenü auswählen. Drücken Sie die Strg-Taste, wenn Sie mehrere Optionen auswählen wollen. Tragen Sie die einzelnen Optionen zeilenweise untereinander ein. (Hinweis: Wenig erfahrene Nutzer/innen kennen diese Funktion der Strg-Taste nicht. In diesem Fall ist es besser, den Feldtyp Checkboxen zu verwenden).

Multiselectfield.png

Textbereich
Hier können Nutzer formatierten Text eingeben. Die Funktionsweise ähnelt sehr stark der, wenn man einen Beitrag in einem Forum verfasst.

Textareafield.png

URL
Hier können Links zu Webseiten (URLs) erfasst und gespeichert werden. Wenn Sie die Option Automatische Verlinkung der URL wählen, werden die Einträge automatisch in einen anklickbaren Link umgewandelt. Wenn Sie im Eingabefeld Namenseintrag für den Link erzwingen einen Titel vergeben, wird dieser statt dem reinen URL-Text für die Linkgenerierung verwendet.
Sie können wählen, ob die Webseite in einem neuen Fenster geöffnet wird.

Urlfield.png

Zahl
Dieses Feld speichert eine beliebige Dezimalzahl, z.B. 42, -1000, 0, 0.123, 3.0e8.

Numberfield.png


Vorlagensätze verwenden

Datenbank-Vorlagensätze

Vorlagensätze bestehen aus einer Sammlung von Vorlagen einer Datenbank, die Felder und Aussehen der verschiedenen Ansichten vollständig beschreiben. Vorlagensätze können verwendet werden, um nicht jedes Mal bei der Erstellung einer Datenbank alle Felder neu anlegen und alle Vorlagen speichern zu müssen. Standardmäßig ist in Moodle ein Vorlagensatz für eine Bildergalerie installiert. Sie können aber auch eigene Vorlagensätze erstellen, exportieren und in neue Datenbanken importieren.

Vorlagensatz importieren

Um einen Vorlagensatz zu nutzen, gehen Sie wie folgt vor:

1. Klicken Sie die Datenbank auf der Kursseite oder im Block Navigation an. Sie gelangen auf die Ansichtsseite der Datenbank.
2. Auf der Ansichtsseite der Datenbank klicken Sie auf den Reiter Vorlagensätze. Oder Sie klicken im Block Einstellungen > Datenbank-Administration > Vorlagensätze.
3. Import aus ZIP-Datei: Klicken Sie auf den Button Datei wählen. Es öffnet sich der Datei-Browser. Laden Sie eine Datei von Ihrem PC hoch oder wählen Sie eine bereits hochgeladene Datei aus einem Repository aus. Die ausgewählte Datei wird unterhalb des Buttons Datei wählen angezeigt.
4. Klicken Sie abschließend auf den Button Import.
5. Alternativ können Sie auch im Bereich Vorlagensatz benutzen eine bereits in der Vergangenheit importierten Vorlagensatz wählen.

Vorlagensatz exportieren

Wenn Sie den Vorlagensatz Ihrer Datenbank mit anderen austauschen möchten, haben Sie zwei Möglichkeiten:

  • Exportieren Sie die Vorlage als ZIP-Datei. Diese kann in einem anderen Moodle-Kurs wieder importiert werden.
  • Speichern Sie die Vorlage als Vorlagensatz, so können alle Nutzer Ihrer Moodle-Installation die Vorlage nutzen. Der Vorlagensatz erscheint dann in der Liste der Vorlagensätze. Dort können Sie ihn jeder Zeit wieder entfernen.

Um Ihren Vorlagensatz zu speichern, gehen Sie wie folgt vor:

  1. Klicken Sie dazu die Datenbank auf der Kursseite oder im Block Navigation an. Sie gelangen auf die Ansichtsseite der Datenbank.
  2. Auf der Ansichtsseite der Datenbank klicken Sie auf den Reiter Vorlagensätze. Oder Sie klicken im Block Einstellungen > Datenbank-Administration > Vorlagensätze.
  3. Klicken Sie im Bereich Export als ZIP-Datei auf den Button Export, um den Vorlagensatz als ZIP-Datei zu exportieren.
  4. Alternativ können Sie Ihre Vorlagen als Vorlagensatz speichern. Klicken Sie dazu im Bereich Als Vorlagensatz speichern auf den Button Weiter.

Hinweis: Wenn Sie den Vorlagensatz exportieren, werden nur die Felder und Vorlagen der Datenbank. Die Einträge werden nicht(!) mitgespeichert.

Vorlagensätze herunterladen

Im Kurs Activity Examples der Moodle School Demo Site finden Sie verschiedene Beispiele für Datenbank-Aktivitäten inklusive der entsprechenden Datenbank-Vorlagen zum Herunterladen.