ARAMIS Stand Alone Reader SAR

1. Was ist der ARAMIS SAR?

ARAMIS ist die Datenbank der Bundesverwaltung für die Publikation der Metadaten von Forschungsprojekten und verwandten Projektarten, welche vom Bund finanziert und/oder durchgeführt werden. Der ARAMIS Stand Alone Reader SAR macht ARAMIS-Daten über den ARAMIS-Webservice

https://www.webservice.aramis.admin.ch/public/service.svc

such- und abrufbar und kann auf beliebigen Web-Seiten eingebunden werden.

2. Wie bette ich den ARAMIS SAR auf meiner Web-Seite ein?

2.1 Methode "JavaScript"

Fügen Sie im HTML-Code Ihrer Web-Seite folgende zwei Zeilen ein:

2.2 Methode "Iframe"

Binden Sie die Seite https://www.aramis.admin.ch/sar/ ein, z. B. mittels iframe, hier gezeigt mit automatischer Höhenformatierung:

Ein iframe-Code enthaltend Ihre Konfiguration gemäss untenstehendem Kapitel 3. wird im Konfigurator zum Kopieren bereit stehen. Falls sich dieses iframe in der Höhe nicht automatisch maximieren kann oder soll, sehen Sie die manuelle Höhenformatierung hier

Der im Konfigurator zum Kopieren zur Verfügung gestellte iframe-Code enthält die automatische Höhenformatierung wie folgt:
... style="width:100%;height:400px;border:0;" onload="javascript:(function(o){window.addEventListener('message', function(event) { o.style.height = event.data + 'px'; });}(this));" ...

Falls dies nicht zum gewünschten Ergebnis führt, versuchen Sie diese manuelle Höhenformatierung:
... width="100%" height="10000" srolling="no" frameborder="0" ...

Probieren Sie aus, welche Notation bei Ihnen zu einem ansprecherenden Ergebnis führt.

Für das CMS AEM wird die Methode "Iframe" mit automatischer Höhenformatierung empfohlen und zwar zwingend im AEM-HTML-Modul und nicht im AEM-Iframe-Modul und vorzugsweise auf einer Seite mit breiter Hauptspalte, also ohne rechte Spalte. Falls in Ihrem AEM das HTML-Modul fehlt, bestellen Sie es im BIT!

3. Wie konfiguriere ich den ARAMIS SAR?

Beim Aufrufen des ARAMIS SAR wird das Suchformular und eine initiale Trefferliste angezeigt, ggf. vorgefiltert.

Den ARAMIS SAR konfigurieren bedeutet, dass Sie einstellen, welche UI-Elemente im Suchformular vorhanden sein sollen und wie diese ggf. vorausgefüllt sein sollen; diese Vorausfüllungen steuern die initiale Trefferliste (Vorfilterung).

Im Konfigurator können Sie die Datenquelle steuern. Es wird empfohlen, keine Datenquelle zu fixieren, sondern dem Benutzer die Wahl zu lassen und als Default die Mirror-Quelle zu nutzen. Das Anzeigen von PDF-Dateien bereits in der Trefferliste ist nur mit der Mirror-Quelle möglich.

Anstatt der Standardansicht (Suchformular) können Spezialansichten namens "nur Labels" konfiguriert werden, welche kein Suchformular zeigen, sondern nur farbige Schaltflächen, welche thematische Labels darstellen, mit dem Zweck, geklickt zu werden, um in der Folge eine Liste der passenden (so gelabelten) Projekte zu zeigen. Vergessen Sie dabei nicht, entweder im Konfigurator die zu verwendenden Labels abzufüllen oder die Option "alle aktuellen und zukünftigen Labels" zu verwenden, und wenn ebendies, dann nicht vergessen, ebendort eine Forschungsstelle anzugeben, auf welche sich "alle aktuellen und zukünftigen Labels" bezieht!

Beachten Sie, dass das Konfigurieren sich nicht auf den ARAMIS SAR, welchen Sie gerade benutzen, auswirkt, sondern dass durch das Konfigurieren wie weiter unten in Kapitel 4 beschrieben ein Code-Snippet und eine URL entstehen, welche Sie auf einer beliebigen Web-Seite einbinden können (verwenden Sie das eine oder das andere); es wird dann eine ARAMIS SAR-Ansicht daraus generiert, welche Ihrem Konfigurationsergebnis entspricht.

So starten Sie den Konfigurator: Klicken Sie in einem SAR-Frontend auf den dort präsentierten Konfigurator-Link oder rufen Sie die Seite auf.

Sie sehen nun den Konfigurator, mit welchem Sie das Suchformular einstellen können.

Suchformularelemente, welche Sie im Konfigurator vorausfüllen, wirken entsprechend initial filternd so wie ausgefüllt!

Nur wenn Sie diese Suchformularelemente auch auf "Sichtbar" stellen, können diese durch den Benutzer bedient werden (Werte eingeben/wählen ggf. vorhandener Initialwert ändern).

Es gibt Einstellungen, z. B. bei den "Labels" (Labels sind thematische Projektgruppen), welche zweiteilig sind, nämlich "Filter" und "Anzeige". Unter "Filter" können Sie jeweils - optional - einstellen, wie initial gefiltert werden soll (Vorfilterung der initialen Trefferliste). Unter "Anzeige" stellen Sie ein, welche Filterelemente (davon) dem Benutzer als UI-Elemente zur Filterveränderung (auch) angezeigt werden sollen. Das heisst, wenn Sie unter "Filter" nach einem oder mehreren Elementen vorfiltern, aber diese Elemente dann unter "Anzeige" NICHT auch noch einfüllen, kann der Bentzer die Vorfilterung nie aufheben/ändern, was ein gewünschtes Verhalten sein kann, wenn der Benutzer sich z. B. nur in einer bestimmten Thematik bewegen soll.

4. Erstellte Konfiguration einbinden

4.1 Einbetten: Code-Snippet (JavaScript)

Ihre Einstellungen gemäss obigem Kapitel 3 resultieren unter anderem im Code-Snippet unten im Konfigurator, welches Sie auf Ihrer Web-Seite einbinden können.

4.2 Einbetten: URL (z. B. für iframe)

Des Weiteren resultieren die Einstellungen gemäss obigem Kapitel 3 in einer URL mit GET-Parametern unten im Konfigurater, angeboten als Iframe-HTML-Code zum Kopieren und Einfügen im HTML-Code einer Intrnetseite.

4.3 Verlinken: URL für SAR-Config-Fernsteuerung

Die URL für die SAR-Fernsteuerung ist eine andere URL als die für die Iframe-Einbindung. Die Fernsteuerungs-URL ruft die SAR-enthaltende (vgl. 2.1 und 2.2.) Seite auf (somit zu verwenden als Link) und übersteuert das Erscheinungsbild dieser SAR-Einbindung über die GET-Angaben in ebendieser Top-URL. In andern Worten, die a) Config des hinterlegten SAR (egal ob Iframe oder Code-Snippet) wird durch die b) Config in der Top-URL der SAR-enthaltenden Seite (resp. Parent-URL aus SAR-Perspektive) übersteuert, was aber nur funktioniert, wenn a) auf "Fernsteuern zulassen" konfiguriert ist. Im Gegensatz zu 4.1 und 4.2 ist also der SAR zwar irgendwie konfiguriert irgendwo (=Top-URL) eingebunden, hört aber auf die Angaben in der Top-URL (auf den dort angehängten GET-Parameter "config"), wenn vorhanden. Ziel von 4.3 ist, den SAR nur einmal einbinden zu müssen und in unterschiedlichen Erscheinungsbildern über Links aufrufen zu können. Die Top-URL der Seite (im Sinne von https://meinewebsite.ch/eineseite.html), auf welcher der SAR eingebunden ist, müssen Sie also im Konfigurator im Feld "URL SAR-Einbindung" einfügen, damit der richtige Link komponiert wird.

5. ARAMIS SAR Quellcode

Sie können den ARAMIS SAR Quellcode unter herunterladen, auf Ihrem Server platzieren und auch verändern. Lizenz: GNU GPLv3.