Variante 3 - ohne Frameset




Was ist hier gegeben?

Die Variante 3 kommt - im Gegensatz zu den Varianten 1 und 2 - ohne Frameset aus. Die Inhalte "nach dem Klick auf das Medikations-Center" werden in einem neuen Browserfenster- bzw. -Tab geöffnet und vollständig vom VitaBook-Server geladen.


Technische Details & Module zur Variante 3

Es gibt zu dieser Variante - im Gegensatz zu den Varianten 1 und 2 - keinen Download.


Was ist zu tun?


1. Das Medikations-Center einbinden:

Das Medikations-Center wird über ein JavaScript-Codeschnipsel eingebunden.

to-do Den folgenden Codeschnipsel binden Sie bitte an passender Stelle im body-Bereich Ihres Quellcodes ein:

Änderung 18.04.2017:

<body>
   ...
   <script src="https://www.vitabook.de/extern/widgets/medcenter/menu.js?layout=**" type="text/javascript" id="om-menu"></script>
   ...
</body>

Er ruft die Funktion auf, die zur Einbindung des Medikations-Centers benötigt wird. Der Parameter layout ist nicht zwingend erforderlich, um aber Einfluss auf die Breite des MC zu nehmen, wird seine Verwendung empfohlen.

to-do Bitte ersetzen Sie die Zeichen ** durch einen Zahlenwert.

Das Beispiel dazu erklärt diesen Schritt noch näher:

Als Beispiel wird ** gefüllt:

layout=3
  • Der Parameter layout bekommt immer einen Zahlenwert zugewiesen. Möglich sind verschiedene Werte von 1 bis 8. Sie definieren die Größe des Widgets.
  • Alle verfügbaren Größen mit dem betreffenden Parameter können Sie auf der Startseite einsehen.

Tipps zur Umsetzung:

  • Die aufgerufene Funktion erzeugt ein iFrame. Der Inhalt, der dort hineingeladen wird - also das Medikations-Center-Widget - hat einen Platzbedarf von max. 960px in der Breite und 420px in der Höhe (je nach gewähltem Layoutparameter). Details s. Tabelle unten.
  • Bei der Verwendung von z.B. Content-Management-Systemen ist zu prüfen, ob die Verwendung von iFrames in den Einstellungen erlaubt worden ist.

Layout-Parameter Abmessungen des iFrames
1 300 x 378px
2 190 x 256px
3 246 x 256px
4 182 x 256px
5 283 x 256px
6 300 x 352px
7 245 x 361px
8 960 x 420px

Tabelle oben: Größen der jeweils erzeugten iFrames


2. Rücksprungadresse

Die Rücksprungadresse ist diejenige URL, zu der der Privatbenutzer nach dem Logout zurückgelangt. Sie ist unter dem Login der Apotheke bei VitaBook (vormals: ordermed) vom Apotheker einzustellen, und zwar unter:

Konfiguration ordemed -> Konfiguration -> 1) Stammdaten ergänzen -> Website (ohne "http://")


to-do Rücksprungadresse angeben (von bzw. in Abstimmung mit der Apotheke vorzunehmen)



4. Gewünschtes Farbschema festlegen

Damit sich das MC optimal an das Corporate Design Ihrer Webseite anpasst, haben wir eine Möglichkeit geschaffen, die Farbwelt des Medikations-Centers individuell festlegen zu können. Zur Auswahl stehen acht verschiedene Farben. Ihre gewünschte Farbe können Sie unter dem Login der Apotheke bei VitaBook (vormals: ordermed) vom Apotheker einzustellen, und zwar unter:

Konfiguration -> Layout -> 5) Farbe für das Medikationscenter auswählen

Wählen Sie in dem Dropdownmenü die gewünschte Farbe aus. Standard, sofern hier nichts ausgewählt wurde, ist das Farbschema Ihrer Kooperation bzw. das Standard-Farbschema.

to-do Wählen Sie das gewünschte Farbschema aus.


Sie haben damit alle erforderlichen Schritte zur Implementierung vorgenommen.


Mögliche Fehlerursachen

Die folgende Auflistung erhält die häufigsten Fehler, die bei der Einbindung auftreten können.

# Problem Ursache / Behebung des Problems
a) Trotz korrekter Einbindung besitzt das Medikations-Center-Widget keinerlei Funktion. Es werden keine Inhalte angezeigt. 1) Ursache kann die URL der Apotheken-Webseite sein, die möglicherweise nicht in der VitaBook-Datenbank hinterlegt ist.
  • Bitte wenden Sie sich an den VitaBook-Support (s. auch Fragen?).
2) Aktiviertes JavaScript ist Grundvoraussetzung für die Funktionalität. Es ist kein noscript-Part vorgesehen, der Benutzer mit deaktiviertem JavaScript informieren würde.
  • Bitte prüfen Sie, ob JavaScript im Browser aktiviert ist.
b) Trotz korrekter Einbindung besitzt das Medikations-Center-Widget keinerlei Funktion. Die Verlinkung des Medikations-Centers ist nicht mehr gegeben, obwohl sie zu einem früheren Zeitpunkt bereits korrekt funktioniert hatte. Mögliche Ursache können Wartungsarbeiten am Server sein. In der Zeit wird statt des Medikations-Centers ein Ersatz angezeigt, der zwar die Optik, aber nicht die Funktion bieten kann.
  • Der Service ist nach Beendigung der Wartungsarbeiten wieder vollständig und in gewohnter Weise verfügbar.
c) An dem vorgesehenen Platz auf der Webseite erscheint kein Medikations-Center. Sollten Sie die Integration in Kombination über z.B. ein Content-Management-System vornehmen, so stellen Sie bitte sicher, dass der HTML-Tag iframe erlaubt ist. Manche CMS unterbinden standardmäßig die Verwendung des Tags im Quellcode.
d) Es wird der Text
Das Menü Widget ist noch nicht konfiguriert. Bitte wenden Sie sich an den Administrator oder an den VitaBook-Support.
an dem für das Medikations-Center vorgesehenen Platz ausgegeben. 		Ursache ist die URL der Apotheken-Webseite, die noch nicht - oder nicht korrekt - in der VitaBook-Datenbank hinterlegt ist.
  • Bitte wenden Sie sich an den VitaBook-Support (s. auch Fragen?).
e) Es wird der Text
Wartungsarbeiten
Bitte entschuldigen Sie die Wartungsarbeiten und versuchen Sie es in ein paar Minuten erneut.
über dem Medikations-Center ausgegeben. Das Medikations-Center besitzt keinerlei Funktionalität. 		Die URL der Apotheken-Webseite ist noch nicht - oder nicht korrekt - in der VitaBook-Datenbank hinterlegt.
  • Bitte wenden Sie sich an den VitaBook-Support (s. auch Fragen?).
f) Das Widget wird geladen und sieht optisch korrekt aus.
Das Anklicken der Links erzeugt jedoch einen Fehler 404 (Seite kann nicht angezeigt werden / nicht vorhanden) 		Die Datei ordermed.php ist entweder nicht vorhanden oder die darauf verweisende URL ist nicht korrekt.
  • Bitte überprüfen Sie, ob Sie die Inhalte des Ordners ordermed (aus der Download-Datei) auf den Server hochgeladen haben.
  • Ggf. ist der Dateipfad zu diesem Verzeichnis anzupassen
  • Siehe auch Punkt 2: Das Medikations-Center einbinden

Fragen?

Bei Fragen zu dieser Dokumentation kontaktieren Sie uns bitte.

Sie erreichen uns unter:

kundensupport@vitabook.de • Fon 04101 60121 88 • Fax 04101 60121 80

 
Entwicklung ursprünglich durch:
www.SeSoft.de
Web/Database/Solutions
SeSoft® GmbH
Am Alten Markt 12b
22926 Ahrensburg


Änderungshistorie

18.04.2017: Änderung der URL zum Script menu.js: der Verweis führt ab sofort zu https://www.vitabook.de (siehe oben). Im Falle eines nicht funktionierenden Widgets genügt es, diesen Pfad anzupassen.

10.02.2017: Die Farben sind nur noch bei den Widgets individuell. Nach dem Login ins Backend bekommt der Nutzer ab sofort das einheitliches blaue VitaBook-CI.

26.10.2015: Widget layout=8 findet nun Berücksichtigung in der Dokumentation

09.10.2015: Allg. optische Aktualisierung der Inhalte

10.07.2014: Anpassungen wg. des neuen Widgets layout=7 sowie Tipps zum Festlegen des Farbschemas ergänzt

Neben textlichen Korrekturen wurde eine Beispielseite zu Variante 3 erstellt. Link dazu s. oben.

Der Parameter layout ist nun auch in der Variante 3 beschrieben.