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: keine Numerierung
  • 1: fortlaufende Numerierung, Bsp.: [2]
  • 2: fortlaufende Numerierung mit Gesamtzahl, Bsp.: [2/84]
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: Oberes Jahr (eigentlich das letzte/jüngste)
  • last: Unterstes Jahr (das früheste)
  • all: Der Tab mit allen Publikationen
  • search: Der Such-Tab
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:
  1. 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.
  2. 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:

https://mediatum.ub.tum.de/services/export/node/670373/allchildren?q=keywords=GISTop_Semantic_modeling_and_transformation.

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:

https://mediatum.ub.tum.de/services/export/node/680891/allchildren?type=document%2Fdiss%7Cdiss&limit=555&add_shortlist&q=advisor=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:

https://mediatum.ub.tum.de/services/export/node/645120/allchildren?limit=999&q=year=2015%20or%20year=2014%20or%20year=2013%20or%20year=2012.

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.