WebViewer-Export

Der Onyx 3D-WebViewer erlaubt die Aufbereitung eines Datensatzes für die Anzeige im Browser auf Geräten ohne OnyxCeph³™, einschliesslich mobilen Endgeräten. Der WebViewer kann in übergeordnete Webseiten oder Webportale von Dienstleistern eingebunden werden, stellt aber selbst keine über die reine Darstellung hinausgehenden Funktionen bereit. Siehe auch Beitrag Webbasierte Kommunikation.

Benutzung

Exportieren Sie einen Web-basierten 3D Datensatz in der Vollbildansicht des Befundes über den Kontextmenüeintrag "Web Export" der Objektliste oder die Thumbnail-Ansicht der Befunde. Zum Ablegen des Links im Onyx vergeben Sie einen Namen und füllen Sie dann den folgenden Dialog aus:

Eintrag	Beschreibung	Standard
Nur Sichtbare Objekte anzeigen	Es werden keine unsichtbaren Objekte mit übertragen, um Speicherplatz zu sparen.	an
Animation (Quelle)	Animation mit übertragen, wenn beim Befund-Speichern mit Exportiert (verfügbar aus den Modulen V.T.O. 3D, Aligner 3D, Sim 3D)	an
Kommentar	Kommentar des Befundes als Text im WebViewer einblenden	aus
Objektliste	Eine Onyx-ähnliche Objektliste anzeigen	aus
Werkzeuge	Eine Werkzeugleiste mit Funktionen zum Ein/Ausblenden von u.a. Attachments, Malokklusion, Zahnfarben, wenn im Datensatz mit abgelegt. Diese Option sollte gerade für mobile Geräte der Objektliste bevorzugt werden	aus
Farben	Individualisierte Farben zur Anzeige des Viewers benutzen	aus
Passwort	Vergeben Sie immer ein neues Passwort zum Schutz der Daten (oder lassen Sie das Feld frei für ein zufälliges Passwort
Passwort in Link einbinden	an: Das Passwort wird als Teil des Links erzeugt (niedrigere Sicherheit), aus: Das Passwort muss dem Betrachter unabhängig vom Link übermittelt werden und beim Start eingegeben werden (höhere Sicherheit)	aus
Patientendaten	Wählen Sie die Daten, die im Info-Fenster sichtbar sein sollen	komplett anonymisiert
Link	Ergebnis, geben Sie diesen Link weiter oder betten Sie diesen Link in eine patientenspezifische Webseite ein
Passwort	Nur angezeigt, wenn nicht im Link eingebunden

Konfiguration

Der Upload muss in den Systemoptionen im Reiter Daten hochladen > 3D-Web-Betrachter konfiguriert werden, bevor er als Menüeintrag verfügbar wird.

Eintrag	Beschreibung	Beispiel
Host	Ihr Dienstleister für den FTP-Speicherplatz	123.456.789.012
Verbindungssicherheit	Protokoll für den Upload	FTPS
Benutzername	Der für den FTP-Zugriff eingerichtete Account-Name	onyxUser
Benutzerpasswort	Das zum Benutzer passende Passwort für den FTP-Zugriff	••••
Host Verzeichnis	Das Verzeichnis der Daten relativ zum root-Verzeichnis des Benutzers	`public_html/OnyxWebviewerUploads`
htaccess	Soll automatisch eine Datei für Zugriffsrechts (CORS) angelegt werden?	an
Viewer Homepage	Ihre individualisierte Seite mit eingebettetem Webviewer (s. Beispiel unten)	`www.image-instruments.de/webviewer/index.html`
Daten Adresse	Die zum Host Verzeichnis gehörige Adresse so wie von Aussen gesehen	`???.de/OnyxWebviewerUploads/`

Achten Sie darauf, in der iFrame-Einbindung und der Onyx-Konfiguration eine gültige Protokoll-Abfolge zu haben (http >= https in Viewer Homepage > iFrame > Daten-Adresse).
Achten Sie auf den ggf. abweichenden Verzeichnispfad der Daten aus Sicht des FTP-Zugangs und des Zugangs von aussen.
Die minimale Seite für einen individualisierten Viewer sieht wie folgt aus:
Bitte beachten, dass sich die Art der Einbindung aufgrund eines neuen Sicherheitsfeature (oder Bugs) im Safari-Browser geändert hat:

<html xmlns="http://www.w3.org/1999/xhtml">
<head> <title>My 3D Viewer</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
  <script> 
    function addIFrame() { // Neue dynamische Einbindung über Script
      var viewerLink = '//onyx.orthorobot.com/webviewer/main.html'; // Ändern Sie diesen Link auf den Viewer-Unterordner, der mit Ihren Daten auf den eigenen Server geladen wird. Im obigen Beispiel wäre das '???.de/OnyxWebviewerUploads/Viewer/main.html'
      var viewerData = window.location.search;                      // Wenn die Daten in ein Labor-Portal geladen werden, kann dieser Link auf den Datensatz auch dynamisch erzeugt werden. In diesem Beispiel wird der Link aus der URL geholt.
      var iframe     = document.createElement('iframe');            // Legen Sie den IFrame bei komplexeren Seiten auch optional in einem Unterelement Ihrer Seite an. Dieses einfache Beispiel fügt ihn ans Ende des Dokumentes ein.
      
      iframe.setAttribute('name', 'OnyxCephWebGL');
      iframe.setAttribute('style', 'position:fixed; top:0px; left:0px; bottom:0px; right:0px; width:100%; height:100%; border:none; margin:0; padding:0; overflow:hidden; z-index:1;');
      iframe.setAttribute('src', viewerLink+viewerData); 
      document.body.appendChild(iframe);
    }
  </script>
</head>
<body onload="addIFrame()">
  <img src="MyLogo.png" style="position:absolute;top:0;left:0;z-index:2">
  <!-- hier fügt es dynamisch den iframe ein -->
</body>
</html>

Hilfe bei Problemen

Der Upload in OnyxCeph funktioniert nicht:

Prüfen Sie Einstellungen und probieren Sie, ob unabhängig vom OnyxCeph ein Dateiexplorer mit FTP-Funktionalität wie TotalCommander oder FileZilla mit Ihren Eingaben verbinden kann
Wenn es mit denselben Anmeldedaten nur in OnyxCeph nicht funktioniert, probieren Sie die verschiedenen Protokolle durch (FTP, FTPS, FTPES, SFTP).

Die Viewer-Seite meldet "Datei nicht gefunden - Bitte Link prüfen":

Überprüfen Sie die Datenadresse in der Konfiguration: kann der in der URL hinter mlink= stehende WebLink auf die iiwgl-Datei alleinstehend aufgerufen werden? Wenn nicht, prüfen Sie mittels einem FTP-Tool, wo die Daten wirklich liegen und wie über http oder https darauf zugegriffen werden kann. Ggf. muss der Dateityp am Server explizit freigegeben werden.
Öffnen Sie die Entwicklerwerkzeuge des Browsers mit F12 und schauen Sie in der Konsole, ob eine rote Warnmeldung ausgegeben wird:
- Wenn eine Fehlermeldung mit dem Inhalt "CORS" auftaucht, handelt es sich um einen Sicherheitsmechanismus, der am Server richtig konfiguriert werden muss.
- Wenn eine Fehlermeldung bzgl. http und https ausgegeben wird: prüfen Sie die Konfiguration, ein Viewer über https kann keine Daten von http abholen

Die Viewer-Seite meldet "Falsches Passwort oder fehlerhafte Datei":

Die von der Datenadresse zurückgelieferte Datei ist auch nicht der korrekte Datensatz, sondern häufig eine Fehlerseite wie "404 - nicht gefunden".
Überprüfen Sie wieder durch die Eingabe der Datenadresse allein, welche Datei der Server ausliefert.

Verweise

	WebView-Upload-Einstellungen
	WebViewer-Bedienelemente
	WebViewer Beispiele