Chcete-li vložit obsah ze služby Oracle Analytics, musíte vytvořit nebo aktualizovat stránku HTML tak, aby zahrnovala požadovanou deklaraci DOCTYPE a globální atribut dir a odkazovala na zdrojový soubor jazyka JavaScript s názvem embedding.js a adresu URL vloženého sešitu. Je také nutné určit režim vkládání (JET nebo samostatný), metodu autentizace a přidat veškeré potřebné atributy.
Deklarace Doctype
Nastavte deklaraci doctype na <!DOCTYPE html>. Pokud použijete jinou deklaraci doctype než <!DOCTYPE html> nebo pokud zapomenete zahrnout deklaraci doctype, dojde k nepředvídatelnému chování, jako je nesprávné generování výsledků na stránce.
Globální atribut dir
Globální atribut dir nastavte podle požadavků národního prostředí webové stránky. Globální atribut dir určuje směr rozvržení vloženého analytického obsahu.
Poznámka:
Pokud je potřebné podporovat více národních prostředí, použijte k nastavení atributu jazyk JavaScript.
Mezi dostupné volby hodnoty atributu patří:
rtl – Používá se pro směr rozvržení zprava doleva.ltr – Používá se pro směr rozvržení zleva doprava.auto – Nepoužívejte. Tato hodnota není službou Oracle Analytics podporována.Tag <script> a odkazy na kód jazyka JavaScript
Poznámka:
Služba Oracle Analytics generuje tag<script> a adresu URL zdroje v jazyce JavaScript, které je nutné zahrnout.Přidejte na stránku HTML tag <script>, který odkazuje na soubor embedding.js.
”https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v1/embedding/<režimVkládání>/embedding.js”. Příklady v tomto dokumentu používají tuto adresu URL."http://<instance>.analytics.ocp.oraclecloud.com/ui/dv/v1/embedding/<režimVkládání>/embedding.js".Kde <embeddingMode> musí mít hodnotu jet nebo standalone:
Při vkládání analytického obsahu do stávající aplikace Oracle JET použijte hodnotu jet. Pokud použijete hodnotu jet, pak se verze sady nástrojů Oracle JET používané aplikací musí shodovat s hlavní verzí sady nástrojů Oracle JET používané službou Oracle Analytics. Pokud například Oracle Analytics používá JET 11.0.0, pak vaše vlastní aplikace musí používat JET 11.0.0 nebo 11.1.0. Služba Oracle Analytics používá sadu nástrojů Oracle JET verze 11.1.10.
requirejs('ojs/ojcore').versionKdyž vkládající aplikace používá technologii Oracle JET, služba Oracle Analytics rozšíří aplikaci o potřebné komponenty. Viz Vložení obsahu služby Oracle Analytics do vlastní aplikace, která používá sadu Oracle JET.
Oracle JET je sada javascriptových knihoven používaných pro uživatelské rozhraní Oracle Analytics.
Při vkládání vizualizačního obsahu do obecné aplikace, která nepoužívá Oracle JET, použijte standalone.
Když vkládající aplikace nepoužívá technologii Oracle JET , služba Oracle Analytics vloží do stránky svou distribuci JET společně s dalšími komponentami. Viz Vložení obsahu služby Oracle Analytics do vlastní aplikace, která nepoužívá sadu Oracle JET.
Autentizace
K zobrazení vloženého analytického obsahu potřebujete autentizovanou relaci. Použít můžete výzvu k přihlášení nebo metodu autentizace 3-Legged OAuth. Viz Přidat autentizaci.
<oracle-dv> Prvek
Chcete-li vložit sešit, musíte přidat následující útržek kódu HTML s hodnotami atributu uvnitř prvku se správně zvolenou velikostí. Oracle Analytics generuje kód HTML, který potřebujete vložit.
<oracle-dv project-path="" active-page="" active-tab-id="" filters=""></oracle—dv>
Poznámka:
Příklady navázání těchto atributů na model Knockout najdete v části Vložení obsahu služby Oracle Analytics do vlastní aplikace, která nepoužívá sadu Oracle JET.
project-path: Specifikuje cestu k sešitu, který chcete vykreslit.
active-page: (Nepovinné) Specifikuje, zda se generuje přehled jiný než výchozí. Když zadáte atribut active-page, použijte rovněž atribut active-tab-id k určení konkrétního zobrazovaného kanvasu Prezentovat. Platná hodnota je insight.
Poznámka:
Hodnotaactive-page canvas je zastaralá. Společnost Oracle doporučuje upravit kód vložení, který používá canvas, na insight. Stávající vložený analytický obsah, který používá canvas, bude nadále fungovat a v konzole prohlížeče se zobrazí varování.active-tab-id: (Nepovinný) Určuje ID zobrazovaného kanvasu Vizualizovat nebo Prezentovat.
filters: (Nepovinné) Umožňuje programové předávání hodnot filtru do vloženého sešitu.
project-options: (Nepovinné) V tomto atributu, projektu odkazuje na sešit. Umožňuje předat tyto možnosti:
bDisableMobileLayout: Deaktivuje nebo aktivuje mobilní rozvržení. Mobilní rozvržení se vztahuje na rozvržení souhrnné karty dostupné pouze v telefonních zařízeních. Hodnota musí být true nebo false.bShowFilterBar: Zobrazí nebo skryje panel filtru. Hodnota musí být true nebo false.showCanvasNavigation: Zobrazí nebo skryje kanvasy v sešitě podle nastavení navigace na kanvasu na kartě Prezentacev sešitě. Hodnota musí být true nebo false.Například: <oracle-dv project-path="{{projectPath}}" active-page="canvas" active-tab-id="1" filters="{{filters}}" project-options='{"bDisableMobileLayout":true, "bShowFilterBar":false}'></oracle-dv>
brushing-type: Ovládá, jak funguje čištění. Zadaná hodnota přepíše všechna ostatní nastavení, včetně výchozích hodnot systému a nastavení v uloženém sešitu. Hodnota musí být řetězec on, off, nebo auto.
on: Použijte k vydání dotazů na čištění s normální prioritou. Dotazy na čištění a vizualizaci se zkombinují a spustí se ve stejnou dobu.auto: Výchozí. Použijte k vydání dotazů na čištění s nízkou prioritou. Když uživatel používá vizualizaci, může dojít ke zpoždění zobrazení značek v ostatních vizualizacích, dokud dotaz na čištění nebude dokončen.compatibility-mode: Použijte při výskytu různých hlavních verzí sady Oracle JET. Tím se za běhu vytvoří prvek iFrame, do kterého se vložený analytický obsah umístí. Hodnota musí být řetězec yes, no, nebo auto.
Poznámka:
Při nastavování atributu věnujte pozornost těmto dvěma položkám:
Pokud používáte režim kompatibility, ověřte, zda je pro aplikaci, kterou správce registroval jako bezpečnou doménu, vybrána volba Povolit rámce. Prostudujte si téma Registrace aplikace jako bezpečné domény.
requirejs('ojs/ojcore').versionyes: Použijte v případě, že chcete vložený analytický obsah vždy uložit do prostředí sandbox. To je užitečné při vkládání do aplikací Oracle APEX.no: Výchozí Použijte, pokud nechcete vytvořit prvek iFrame.auto: Slouží k automatickému zjištění hlavních rozdílů ve verzi Oracle JET mezi hostitelskou vkládanou aplikací a službou Oracle Analytics. To můžete použít při vkládání do aplikace Oracle APEX.Příklad
V tomto příkladu všechny instance projektu odkazují na sešit.
<!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>