Variante 2 Das 100% Frameset




Was ist das 100% Frameset?

Die Variante 2 beschreibt das so genannte "100%"-Frameset. Es handelt sich um ein einteiliges Frameset, das die volle Höhe des Browserfensters ausnutzt.

Die Inhalte des Frames werden vollständig vom VitaBook-Server geladen.


Technische Details & Module zur Variante 2

Wir stellen Ihnen alle Inhalte in einem separaten Ordner „ordermed“ zur Verfügung (als zip-Datei, siehe unten).



Dieser Ordner ist zunächst zu entpacken.


Er enthält die folgenden Dateien:


  • ordermed.php (Frameset)
  • example.html
  • header.html (der obere Inhalt des Framesets)

Die enthaltenen Dateien sind zum Teil noch zu bearbeiten. Lesen Sie dazu bitte das nächste Kapitel „Was ist zu tun?“.


Was ist zu tun?


1. Das Frameset modifizieren


  • Das Frameset ist in dieser Variante einteilig, d.h. es werden die vollständigen Abmessungen des Browserfensters genutzt.
<?php

//	ordermed.php
//	(c) 2012 Ordermed GmbH, www.ordermed.de
//	Entwicklung: SeSoft e.K., www.sesoft.de
//  Version: 12.12.2012



//  Externe Konfiguration: Änderung der drei folgenden Parameter möglich

$standard_url_topframe	= './header.html';	// Standard-Datei, die in den Topframe geladen werden soll.
$standard_hoehe_topframe	= '110';	// Standard-Höhe des Topframes in px.
$standard_titel_framesetseite	= 'Ordermed Integration';	// Erscheint als <title>...</title> der Frameset-Seite

...

to-do Sie haben die Möglichkeit, den Titel der Seite zu ändern.

Bitte ändern Sie nicht dessen Variablennamen! Eine Änderung der beiden anderen zugewiesenen Werte (in dem Beispiel "'./header.html'; " bzw. "'110';") hat keinerlei Auswirkungen auf diese Variante des Framesets.

$standard_titel_framesetseite	= 'Ordermed Integration';

Ändern Sie den Titel nach Ihren Wünschen, z.B. so:

$standard_titel_framesetseite	= 'Ihre Gesund-ist-Bunt-Apotheke';



2. 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?ex=100&layout=**&pfad=#####" type="text/javascript" id="om-menu"></script>
   ...
</body>

Er ruft die Funktion auf, die zur Einbindung des Medikations-Centers benötigt wird.

to-do Bitte ersetzen Sie die Zeichen ** durch einen Zahlenwert, ferner die Zeichenfolge ##### durch den Pfad zur Datei ordermed.php.

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

Als Beispiel werden ** und ##### gefüllt:

layout=1&pfad=http://www.meineurl/verzeichnis/ordermed/ordermed.php
  • 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.
  • Die URL, die in dem Parameter pfad angegeben wird, muss stets absolut sein (s.o.).

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

to-do Ordner und Dateien bereitstellen

Laden Sie bitte den Ordner ordermed mit den geänderten Inhalten auf den Server.

Tipps dazu:

  • Der Dateipfad des Scripts &pfad=http://www.meineurl/verzeichnis/ordermed/ordermed.php entspricht dabei der Stelle, an der Sie diese Inhalte auf dem Server bereitstellen.
    • Beispiel: haben Sie das Verzeichnis ordermed im Root bereitgestellt. Der Pfad ist dann: &pfad=http://www.meineurl/ordermed/ordermed.php
  • Eine Bereitstellung der Dateien / des Verzeichnisses ist für eine vollständige Funktionalität des Widgets Voraussetzung.

3. 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 ordermed -> 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

Download der Dateien zur Variante 2

Die zur Implementierung benötigten Dateien sind in einer zip-Datei zusammengefasst und stehen zum Download bereit:

Download der Datei ordermed.zip (Version vom 28.12.2012)

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.2014: Widget layout=8 findet nun Berücksichtigung in der Dokumentation

19.09.2014: Tipps zur Einbindung des Dateipfades zur Datei ordermed.php hinzugefügt

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

12.05.2014: Textliche Korrekturen und Verlinkung einer Beispielseite (speziell für diese Variante)

11.01.2013: Die Einbindung des JavaScript-Codeschnipsels (unter 2. Medikations-Center einbinden) ist nun anschaulicher dargestellt.

28.12.2012: Die Dateien ordermed.php und config-extern.php wurden miteinander kombiniert. Der Download beinhaltet jetzt nur noch drei Dateien: ordermed.php, example.html und header.html