Zum Einbetten von Oracle Analytics-Inhalt müssen Sie die HTML-Seite erstellen oder aktualisieren, um die erforderliche DOCTYPE-Deklaration und das globale Attribut "dir" aufzunehmen, und die JavaScript-Quelle "embedding.js" sowie die URL der eingebetteten Arbeitsmappe referenzieren. Außerdem müssen Sie den Einbettungsmodus (JET oder Standalone) sowie eine Authentifizierungsmethode angeben und gegebenenfalls Attribute hinzufügen.
DOCTYPE-Deklaration
Setzen Sie die DOCTYPE-Deklaration auf <!DOCTYPE html>. Wenn Sie eine andere DOCTYPE-Deklaration als <!DOCTYPE html> verwenden oder wenn Sie vergessen, eine DOCTYPE-Deklaration aufzunehmen, kann dies zu unvorhersehbarem Verhalten führen, beispielsweise werden die Ergebnisse auf der Seite nicht korrekt wiedergegeben.
Globales Attribut "dir"
Legen Sie das globale Attribut dir entsprechend dem Gebietsschema der Webseite fest. Das globale Attribut dir gibt die Layoutrichtung des eingebetteten Analyseinhalts an.
Hinweis:
Wenn Sie mehrere Gebietsschemas unterstützen möchten, legen Sie das Attribut mit JavaScript fest.
Folgende Attributwerte sind verfügbar:
rtl: Wird für die Layoutrichtung von rechts nach links verwendet.ltr: Wird für die Layoutrichtung von links nach rechts verwendet.auto: Nicht verwenden. Dieser Wert wird von Oracle Analytics nicht unterstützt.Referenz zu <script>-Tag und JavaScript-Quelle
Hinweis:
Oracle Analytics generiert das<script>-Tag und die URL der JavaScript-Quelle, die Sie aufnehmen müssen.Fügen Sie ein <script>-Tag hinzu, das "embedding.js" zur HTML-Seite referenziert.
”https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v1/embedding/<embeddingMode>/embedding.js”. Die Beispiele in diesem Dokument verwenden diese URL."http://<instance>.analytics.ocp.oraclecloud.com/ui/dv/v1/embedding/<embeddingMode>/embedding.js".Dabei muss <embeddingMode> entweder jet oder standalone lauten:
Verwenden Sie jet beim Einbetten von Analyseinhalt in einer vorhandenen Oracle JET-Anwendung. Wenn Sie jet angeben, muss die von der Anwendung verwendete Version von Oracle JET mit der Oracle JET-Hauptversion übereinstimmen, die von Oracle Analytics verwendet wird. Beispiel: Wenn Oracle Analytics JET 11.0.0 verwendet, muss Ihre benutzerdefinierte Anwendung JET 11.0.0 oder 11.1.0 verwenden. Oracle Analytics verwendet Oracle JET Version 11.1.10.
requirejs('ojs/ojcore').versionWenn die Einbettungsanwendung Oracle JET verwendet, erweitert Oracle Analytics die Anwendung um die erforderlichen Komponenten. Siehe Oracle Analytics-Inhalt in eine benutzerdefinierte Anwendung einbetten, die Oracle JET verwendet.
Oracle JET ist eine Gruppe von auf JavaScript basierenden Librarys, die für die Oracle Analytics-Benutzeroberfläche verwendet werden.
Verwenden Sie standalone beim Einbetten von Visualisierungsinhalt in einer generischen Anwendung, die nicht Oracle JET verwendet.
Wenn die Einbettungsanwendung nicht Oracle JET verwendet, fügt Oracle Analytics die JET-Distribution mit zusätzlichen Komponenten zur Seite hinzu. Siehe Oracle Analytics-Inhalt in eine benutzerdefinierte Anwendung einbetten, die nicht Oracle JET verwendet.
Authentifizierung
Zum Anzeigen des eingebetteten Analyseinhalts ist eine authentifizierte Session erforderlich. Sie können die Authentifizierung über Anmelde-Prompt oder dreibeiniges OAuth verwenden. Siehe Authentifizierung hinzufügen.
<oracle-dv>-Element
Zum Einbetten einer Arbeitsmappe fügen Sie das folgende HTML-Snippet mit Attributwerten innerhalb eines Elements mit entsprechender Größe hinzu. Oracle Analytics generiert die HTML, die Sie aufnehmen müssen.
<oracle-dv project-path="" active-page="" active-tab-id="" filters=""></oracle—dv>
Hinweis:
Unter Oracle Analytics-Inhalt in eine benutzerdefinierte Anwendung einbetten, die nicht Oracle JET verwendet finden Sie ein Beispiel für das Binding dieser Attribute an ein Knockout-Modell.
project-path: Gibt den Pfad der Arbeitsmappe an, die Sie rendern möchten.
active-page: (Optional) Gibt an, ob eine andere Insight als der Standard gerendert wird. Wenn Sie active-page angeben, verwenden Sie auch active-tab-id, um die genaue Leinwand "Präsentieren" anzugeben, die angezeigt wird. Gültiger Wert: insight.
Hinweis:
Deractive-page-Wert canvas ist veraltet. Oracle empfiehlt, dass Sie Einbettungscode, der canvas verwendet, in insight ändern. Vorhandener eingebetteter Analyseinhalt, der canvas verwendet, funktioniert weiterhin. Dabei wird allerdings eine Warnung in der Browserkonsole angezeigt.active-tab-id: (Optional) Gibt die ID der Leinwand "Visualisieren" oder "Präsentieren" an, die Sie anzeigen.
filters: (Optional) Ermöglicht die programmgesteuerte Übergabe von Filterwerten an eine eingebettete Arbeitsmappe.
project-options: (Optional) In diesem Attribut bezieht sich project auf Arbeitsmappe. Damit können Sie die folgenden Optionen übergeben:
bDisableMobileLayout: Deaktiviert oder aktiviert das mobile Layout. Das mobile Layout bezieht sich auf das Übersichtskartenlayout, das nur auf Mobiltelefonen verfügbar ist. Der Wert muss true oder false lauten.bShowFilterBar: Blendet die Filterleiste ein oder aus. Der Wert muss true oder false lauten.showCanvasNavigation: Blendet die Leinwände in der Arbeitsmappe entsprechend der Leinwandnavigationseinstellung auf der Registerkarte "Präsentieren" der Arbeitsmappe ein oder aus. Der Wert muss true oder false lauten.Beispiel: <oracle-dv project-path="{{projectPath}}" active-page="canvas" active-tab-id="1" filters="{{filters}}" project-options='{"bDisableMobileLayout":true, "bShowFilterBar":false}'></oracle-dv>
brushing-type: Steuert das Brushing. Der angegebene Wert setzt alle anderen Einstellungen außer Kraft, einschließlich Systemstandardwerte und Einstellungen in der gespeicherten Arbeitsmappe. Der Wert muss die Zeichenfolge on, off oder auto sein.
on: Brushing-Abfragen werden mit normaler Priorität ausgegeben. Brushing- und Visualisierungsabfragen werden gemischt und gleichzeitig ausgeführt.auto: Standard. Brushing-Abfragen werden mit niedriger Priorität ausgegeben. Wenn ein Benutzer mit einer Visualisierung interagiert, kann es zu einer Verzögerung bei der Anzeige von Markierungen in anderen Visualisierungen kommen, bis die Brushing-Abfragen abgeschlossen sind.compatibility-mode: Verwenden Sie diese Option, wenn unterschiedliche Hauptversionen von Oracle JET vorhanden sind. Damit wird zur Laufzeit ein iFrame für das Sandboxing des eingebetteten Analyseinhalts erstellt. Der Wert muss die Zeichenfolge yes, no oder auto sein.
Hinweis:
Beachten Sie die folgenden zwei Punkte beim Festlegen dieses Attributs:
Stellen Sie im Kompatibilitätsmodus sicher, dass Frames zulassen für die Anwendung ausgewählt ist, die der Administrator als sichere Domain registriert hat. Siehe Anwendung als sichere Domain registrieren.
requirejs('ojs/ojcore').versionyes: Verwenden Sie diese Option, wenn Sie den eingebetteten Analyseinhalt immer in einer Sandbox anzeigen möchten. Das ist beim Einbetten in Oracle APEX-Anwendungen nützlich.no: Standard. Verwenden Sie diese Option, wenn Sie keinen iFrame erstellen möchten.auto: Verwenden Sie diese Option, um Unterschiede in der Oracle JET-Hauptversion zwischen der Hostanwendung zum Einbetten und Oracle Analytics automatisch zu erkennen. Diese Option können Sie beim Einbetten in Oracle APEX verwenden.Beispiel
In diesem Beispiel beziehen sich alle Vorkommen von project auf Arbeitsmappe.
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Embedded Oracle Analytics Workbook Example</title>
<script src="https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v1/embedding/<embedding mode>/embedding.js" type="application/javascript">
</script>
</head>
<body>
<h1>Embedded Oracle Analytics Workbook</h1>
<div style="border:1px solid black;position: absolute; width: calc(100% - 40px); height: calc(100% - 120px)" >
<!--
The following <oracle-dv> tag is the tag that will embed the specified workbook.
-->
<oracle-dv
project-path="<project path>"
active-page="insight"
active-tab-id="snapshot!canvas!1">
</oracle-dv>
</div>
<!--
Apply Knockout bindings after DV workbook is fully loaded. This should be executed in a body onload handler or in a <script> tag after the <oracle-dv> tag.
-->
<script>
requirejs(['knockout', 'ojs/ojcore', 'ojs/ojknockout', 'ojs/ojcomposite', 'jet-composites/oracle-dv/loader'], function(ko) {
ko.applyBindings();
});
</script>
</body>
</html>