Publikationslisten aus mediaTUM-Daten mit CurlContent
Diese Seite beschreibt, wie Sie Publikationsdaten aus mediaTUM mit Hilfe der TYPO3-Extension CurlContent einbinden können.
Neues Contentelement anlegen
Klicken Sie auf das Modul Page und legen Sie innerhalb der gewünschten Seite (Page) ein neues Contentelement mit Type „General Plugin“ an.
Wenn Sie das List-Modul nutzen, klicken Sie den Button "Create new record" und legen ein neues Contentelement vom Type "Insert Plugin" an.
Plugin „CurlContent“ auswählen
Wählen Sie den Reiter Plugin und dann im Auswahlmenü „CurlContent“ (Bild 2). Wenn das Plugin nicht in der Liste auftaucht, ist es in Ihrem Webauftritt noch nicht installiert. Bitte wenden Sie sich in diesem Fall an typo3@tum.de.
Node-ID kopieren
Öffnen Sie die Publikation (oder Publikationsliste), die Sie in Ihrem Webauftritt wiederspiegeln möchten, in mediaTUM. Kopieren Sie sich im nächsten Schritt die Node-ID in der Adressleiste, wie in Bild 3 dargestellt (Zahl zwischen „id=“ und „&“).
Plugin-Einstellungen: Datenquelle
Sie können mit einer Reihe Voreinstellungen alle Einträge unterhalb eines mediaTUM-Nodes ansprechen oder nur die mit einem bestimmten Dokumenttyps. Es gibt auch eine Einstellung für das Kombinieren mehrerer Nodes. Die Voreinstellung wählen Sie im Feld URL pre-set (Bild 4). Die Node-ID tragen Sie in das Feld Parameters for preset ein (Bild 5).
Hinweis: Mit den meisten Presets können keine einzelnen Dokumente abgerufen werden; nur Unterelemente von Verzeichnissen. Wollen Sie eine einzelne Publikation ausgeben lassen, müssen Sie das Preset „mediaTUM: One or more single documents“ benutzen.
Alle Dokumenttypen
Die folgende Voreinstellung liefert alle Publikationen unterhalb (!) einer Node-ID: Zeitschriftenbeitrag, Buch, Buchbeitrag, Report, Dissertation, Habilitation, Seminarunterlagen usw., aber keine Videos, Bilder und Verzeichnisse. Optional können Sie (mit Komma getrennt) eine Zahl angeben, um die maximale Anzahl der angezeigten Publikationen anzugeben. Dabei werden die jeweils neuesten genommen.
- mediaTUM: All documents (node ID): alle Dokumente
Bestimmte Dokumenttypen
Die folgenden Voreinstellungen liefern alle Publikationen unterhalb einer Node-ID, die einen bestimmten Dokumenttyp haben. Optional können Sie (mit Komma getrennt) eine Zahl angeben, um die maximale Anzahl der angezeigten Publikationen anzugeben. Dabei werden die jeweils neuesten genommen.
- mediaTUM: Journals only (node ID): nur Zeitschriftenbeiträge
- mediaTUM: Books or book chapters only (node ID): nur Bücher oder Buchbeiträge
- mediaTUM: Conference presentations, talks, papers (node ID): nur Konferenzbeiträge ("Vortrag/Präsentation" und "Textbeitrag/Aufsatz")
- mediaTUM: Conference presentations and talks (node ID): nur Konferenzbeiträge der Art "Vortrag/Präsentation"
- mediaTUM: Conference papers (node ID): nur Konferenzbeiträge der Art "Textbeitrag/Aufsatz"
- mediaTUM: Reports only (node ID): nur Forschungsberichte
- mediaTUM: Dissertations or habilitations (node ID): nur Dissertationen oder Habilitationsschriften
Mehrere Nodes
Diese Voreinstellung kombiniert mehrere mediaTUM-Nodes. Hierzu tragen Sie einfach bis zu 10 Node-IDs mit Komma getrennt in das Feld Parameters for preset ein.
- mediaTUM: All Documents from multiple nodes (node ID, node ID, ...): Alle Dokumente mehrerer Nodes
- mediaTUM: One or more single documents (node ID, node ID, …): Dieses Preset ist das einzige, mit dem man einzelne Dokumente anzeigen lassen kann.
Plugin-Einstellungen: Ausgabe
Im Reiter Processing haben Sie die Möglichkeit, eine Formatierung zu wählen. Für mediaTUM-Daten gibt es vier verschiedene Ansichten. Diese können Sie unter XSL file wählen (Bild 6). Für die jeweiligen Ansichten gibt es unterschiedliche Möglichkeiten, die Ausgabe zu beeinflussen. Diese sind im Folgenden beschrieben.
Plugin-Einstellungen: XSL-Parameter
mediaTUM: Simple list
Diese XSL-Datei formatiert die Publikationen als einfache Liste. Die folgenden Parameter können Sie im Feld Parameters for this XSL file setzen, um das Aussehen zu beeinflussen.
| Parameter | Beschreibung | Voreinstellung | Beispiel |
|---|---|---|---|
| perpage | Hiermit können Sie eine Aufteilung der Liste über mehrere Seiten erreichen (Paginierung). Sie geben die Anzahl der Einträge pro Seite an. | 0 (d.h. keine Paginierung) | perpage=20 |
| num |
| 0 | num=1 |
| bibtex | Diese Option (kein Wert nötig ) schaltet die Anzeige von Links zu BibTeX-Dateien an. | 0 | bibtex |
| full | Diese Option (kein Wert nötig ) schaltet die Anzeige von Links zu Volltexten der Publikation an. Das sind Volltexte auf mediaTUM oder DOI-Links | 0 | full |
| math | Diese Option (kein Wert nötig) bewirkt die Anzeige von mathematischen Symbolen aus LaTeX-Ausdrücken. | 0 | math |
| html | Diese Option (kein Wert nötig) bewirkt, dass HTML-Formatierungen in Titeln bestimmter Publikationstypen interpretiert werden. | 0 | html |
mediaTUM: List, grouped by year
Diese XSL-Datei gruppiert die Publikationen nach Jahr. Es gibt einen Jahres-Index über der Liste. Die folgenden Parameter können Sie im Feld Parameters for this XSL file setzen, um das Aussehen zu beeinflussen.
| Parameter | Beschreibung | Voreinstellung | Beispiel |
|---|---|---|---|
| bibtex | Diese Option (kein Wert nötig) schaltet die Anzeige von Links zu BibTeX-Dateien an. | 0 | bibtex |
| full | Diese Option (kein Wert nötig) schaltet die Anzeige von Links zu Volltexten der Publikation an. Das sind Volltexte auf mediaTUM oder DOI-Links. | 0 | full |
| math | Diese Option (kein Wert nötig) bewirkt die Anzeige von mathematischen Symbolen aus LaTeX-Ausdrücken. | 0 | math |
| html | Diese Option (kein Wert nötig) bewirkt, dass HTML-Formatierungen in Titeln bestimmter Publikationstypen interpretiert werden. | 0 | html |
| tabs | Diese Option (kein Wert nötig) bewirkt die Anzeige in Reitern (Tabs); einer für jedes Jahr. | 0 | tabs |
| tab_all | Option: einen Tab mit allen Publikationen erzeugen. | 0 | tab_all |
| tab_search | Option: einen Such-Tab mit einer Schnellsuche anzeigen. | 0 | tab_search |
| search_auto | Mit der Voreinstellung startet die Schnellsuche automatisch, sobald mindestens drei Zeichen eingegeben wurden. Mit Wert 0 gibt es einen „Suchen“-Knopf, den man drücken muß. | 1 | search_auto=0 |
| tab_initial |
| first | tab_initial=all |
mediaTUM: List, grouped by year, then by type
Diese XSL-Datei gruppiert die Publikationen zunächst nach Jahr. Es gibt einen Jahres-Index über der Liste. Innerhalb der Jahr-Blöcke wird nach folgenden Publikationstypen gruppiert.
- Zeitschriftenartikel / Journal articles (dt-zeitschriftenaufsatz)
- Begutachtete Konferenzbeiträge / Peer Reviewed Conference Papers (dt-konferenzbeitrag)
- Beiträge zu Sammelbänden / Contributions to Collections (dt-buchbeitrag)
- Poster (dt-poster, dt-konferenzbeitrag außer Textbeitrag/Aufsatz)
- Sonstiges / Misc. (alle übrigen)
Die folgenden Parameter können Sie im Feld Parameters for this XSL file setzen, um das Aussehen zu beeinflussen.
| Parameter | Beschreibung | Voreinstellung | Beispiel |
|---|---|---|---|
| math | Diese Option (kein Wert nötig) bewirkt die Anzeige von mathematischen Symbolen aus LaTeX-Ausdrücken. | 0 | math |
mediaTUM: Detail
Diese XSL-Datei macht eine tabellarische Ausgabe der einzelnen Daten; ähnlich der Detailansicht auf der mediaTUM-Website.
| Parameter | Beschreibung | Voreinstellung | Beispiel |
|---|---|---|---|
| bibtex | Diese Option (kein Wert nötig) schaltet die Anzeige von Links zu BibTeX-Dateien an. | 0 | bibtex |
| full | Diese Option (kein Wert nötig) schaltet die Anzeige von Links zu Volltexten der Publikation an. Das sind Volltexte auf mediaTUM oder DOI-Links. | 0 | full |
| math | Diese Option (kein Wert nötig) bewirkt die Anzeige von mathematischen Symbolen aus LaTeX-Ausdrücken. | 0 | math |
Tipps (z.B.: Suche nach Autor oder Autorin)
Nur bestimmte Publikationen ausgeben: Suche nach Autor oder Autorin
Manchmal möchte man aus den Datensätzen eines Nodes nur bestimmte herausfiltern, zum Beispiel diejenigen eines bestimmten Autoren oder einer Autorin. So etwas geht am einfachsten mit einer eigenen Abfrage an den mediaTUM-Webservice, die die gewünschten Publikationen liefert. Dazu mancht man eine Filterung (Suche) anhand der Datenfelder author und author-contrib. Eine Abfrage-URL als Beispiel:
https://mediatum.ub.tum.de/services/export/node/976025/allchildren?q=author=campestrini%20or%20author-contrib=campestrini.
Hier müssen Sie die 976025 durch Ihre Node-ID ersetzen, und campestrini durch den gewünschten Namen (zwei mal). Bei Namen mit Umlauten oder Accents müssen Sie URL-kodieren. Zum Testen kann man diese URL im Browser eingeben und die resultierenden XML-Daten prüfen. Beim Experimentieren mit diesen und weiteren Parametern hilft die Anleitung zum mediaTUM-Webservice.
Im CurlContent-Formular wählt man dann im Reiter Data source bei URL preset „Custom URL (http://...)“ (Bild 7; 1) und gibt die URL in das Feld Parameters for preset ein (Bild 7; 2).
- Mit der Abfrage oben werden die meisten Publikationstypen berücksichtigt. Bei Dissertationen und Habilitationen heißt das Autorenfeld allerdings author.fullname_comma; bei Bachelor- und Masterarbeiten studentauthor.
- Die maximale Anzahl der Datensätze ist auf 100 voreingestellt. Das kann man mit dem limit-Parameter ändern (z.B. &limit=200).
- Die Abfrage verwendet den kompletten Namen. Wer nach „huber“ sucht, sollte also nichts von Schubert finden. Falls doch, oder um die Publikationen unterschiedlicher Personen mit gleichem Nachnamen richtig zuzuordnen, gibt es zwei Möglichkeiten:
- Man kann in mediaTUM einen Ordner anlegen, in den man die gewünschten Publikationen kopiert. Die Node-ID dieses Ordners gibt man dann als Parameter für das Preset „all documents...“ an.
- Man kann das Feld Stichworte analog zu der unten beschriebenen Methode für Projekte verwenden, z. B. mit LSXY_Mueller1 und LSXY_Mueller2.
Nur bestimmte Publikationen ausgeben: thematisch
Die Publikationen zu einen bestimmten Thema (Forschungsprojekt, Arbeitsgruppe) kann man auf ähnliche Weise herausfiltern, wenn man einen zugeordneten Bezeichner in das Datenfeld Stichworte einträgt. Die Abfrage filtert dann anhand des Feldes keywords. Hier ein Beispiel für Publikationen, die mit dem Stichwort GISTop_Semantic_modeling_and_transformation versehen wurden:
Nur bestimmte Publikationen ausgeben: Dissertationen eines Lehrstuhls (via Betreuer)
Dissertationen sind Fakultäten zugeordnet und nicht Lehrstühlen. Möglicherweise kann man aber über die Suche nach Betreuerin oder Betreuer die passenden Dissertationen finden. Dazu wird im Feld advisor gesucht; zum Beispiel nach Prof. Busch:
Nur bestimmte Publikationen ausgeben: Zeitraum
Um nur die Publikationen eines bestimmten Zeitraums auszugeben, kann man eine Abfrage über das Feld year verwenden. Ein Beispiel für Publikationen der letzten vier Jahre:
Um immer die aktuellen Ergebnisse zu erhalten, muss man jährlich die Jahreszahlen aktualisieren, indem man jeweils die früheste Jahreszahl durch die aktuelle ersetzt. Eine Beschränkung auf aktuelle Publikationen kann helfen, wenn bei sehr vielen Datensätzen (z. B. gesamte Fakultät) der mediaTUM Webservice zu langsam antwortet.