Gömülü Oracle Analitik İçeriği İçin HTML Sayfasını Hazırlama

Oracle Analitik içeriğini gömmek için gerekli DOCTYPE bildirimini ve dir global özelliğini dahil etmek üzere HTML sayfasını oluşturmalı veya güncellemeli, embedding.js JavaScript kaynağını ve gömülü çalışma kitabının URL'sini referans almalısınız. Ayrıca gömme modu (JET veya bağımsız) ile bir kimlik doğrulama yöntemi belirtmeniz ve varsa öznitelikleri eklemeniz gerekir.

Doctype Bildirimi

Doctype bildirimini <!DOCTYPE html> olarak ayarlayın. <!DOCTYPE html> dışında bir doctype ifadesi kullanırsanız veya bir doctype ifadesi eklemeyi unutursanız sayfanın doğru biçimde görüntülenmemesi gibi tahmin edilemeyen davranışlar ortaya çıkabilir.

Dir Global Özelliği

Web sayfasının yerel ayarının gerektirdiği şekilde dir global özelliğini ayarlayın. dir global özelliği, gömülü analitik içeriğinin yerleşim yönünü belirtir.

Not:

Birden fazla yerel ayar desteklemeniz gerekiyorsa özelliği ayarlamak için JavaScript kullanın.

Özelliğin değer seçenekleri şunlardır:

  • rtl - Sağdan sola yerleşim yönünü kullan.
  • ltr - Soldan sağa yerleşim yönünü kullan.
  • auto - Kullanma. Bu değer Oracle Analitik tarafından desteklenmez.

<script> Etiketi ve JavaScript Kaynak Referansı

Not:

Oracle Analitik <script> etiketini ve dahil etmeniz gereken JavaScript kaynağının URL'sini oluşturur.

HTML sayfanıza embedding.js kaynağını referans gösteren bir <script> etiketi ekleyin.

JavaScript kaynağının URL yapısı şu şekildedir:
  • ”https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v1/embedding/<embeddingMode>/embedding.js”. Bu dokümandaki örnekler bu URL'yi kullanır.
  • Daha eski devreye alımlar için şunu kullanın: "http://<instance>.analytics.ocp.oraclecloud.com/ui/dv/v1/embedding/<embeddingMode>/embedding.js".

Burada <embeddingMode> jet veya standalone olmalıdır:

  • Mevcut bir Oracle JET uygulaması ile analitik içeriği gömüyorsanız jet kullanın. jet kullanırsanız, uygulamanın kullandığı Oracle JET sürümü, Oracle Analitik tarafından kullanılan Oracle JET ana sürümü ile eşleşmelidir. Örneğin, Oracle Analitik JET 11.0.0 kullanıyorsa, özel uygulamanız JET 11.0.0 veya 11.1.0'ı kullanmalıdır. Oracle Analitik, Oracle JET sürüm 11.1.10 kullanır.

    Oracle Analitik'in kullandığı JET sürümünü bulmak için Oracle Analitik'te oturum açın, tarayıcı konsolunu açın ve şu komutu çalıştırın:
    requirejs('ojs/ojcore').version

    Gömme uygulaması Oracle JET kullanıyorsa, Oracle Analitik uygulamayı ihtiyacı olan bileşenlerle genişletir. Bkz. Oracle Analitik İçeriğini Oracle JET Kullanan Özel Bir Uygulamaya Gömme.

    Oracle JET, Oracle Analitik kullanıcı arayüzü için kullanılan Javascript tabanlı kitaplıkların bir grubudur.

  • Oracle JET kullanmayan genel bir uygulamaya görselleştirme içeriği gömerken standalone kullanın.

    Gömme uygulaması Oracle JET kullanmıyorsa, Oracle Analitik JET dağıtımını sayfaya ek bileşenlerle getirir. Bkz. Oracle Analitik İçeriğini Oracle JET Kullanmayan Özel Bir Uygulamaya Gömme.

Kimlik Doğrulama

Gömülü analitik içeriğini görüntülemek için doğrulanmış bir oturuma ihtiyacınız vardır. Oturum açma bilgi istemini veya 3 Aşamalı OAuth kimlik doğrulamasını kullanabilirsiniz. Bkz. Kimlik Doğrulama Ekleme.

<oracle-dv> Öğesi

Bir çalışma kitabını gömmek için uygun boyutlu bir öğeye özellik değerleriyle aşağıdaki HTML bilgi parçacığını eklemeniz gerekir. Oracle Analitik, dahil etmeniz gereken HTML'i oluşturur.

<oracle-dv project-path="" active-page="" active-tab-id="" filters=""></oracle—dv>

Desteklenen özellikler - Bu özellikler bir Knockout modeli içinde tanımlı statik dizeleri ve nitelikleri destekler. Knockout, Oracle JET'te kullanılan bir teknolojidir.

Not:

Bu özellikleri bir Knockout modeline bağlamaya örnek için bkz. Oracle Analitik İçeriğini Oracle JET Kullanmayan Özel Bir Uygulamaya Gömme.

  • project-path: Görüntülemek istediğiniz çalışma kitabının yolunu belirtir.

  • active-page: (İsteğe bağlı) Öndeğer olan dışında bir içgörünün görüntülenip görüntülenmediğini belirtir. active-page belirttiğinizde, göstermekte olduğunuz Sunum fonunu tam olarak belirtmek için active-tab-id de kullanırsınız. Geçerli değer insight'tır.

    Not:

    active-page değeri canvas kullanımdan kaldırıldı. Oracle, canvas kullanan gömme kodunuzu insight olarak değiştirmenizi önerir. canvas kullanan mevcut gömülü analitik içeriği çalışmaya devam edecek ve tarayıcı konsolunda bir uyarı görüntülenecektir.
  • active-tab-id: (İsteğe bağlı) Göstermekte olduğunuz Görselleştir fonunun veya Sun fonunun No'sunu belirtir.

  • filters: (İsteğe bağlı) Filtre değerlerinin gömülü bir çalışma kitabına programa dayalı olarak iletilmesine izin verir.

  • project-options: (İsteğe bağlı) Bu özellikte, proje, çalışma kitabı'nı referans gösterir. Bu seçenekleri iletmenizi sağlar:
    • bDisableMobileLayout: Mobil yerleşimi devre dışı bırakır veya etkinleştirir. Mobil yerleşim, sadece telefon cihazlarında kullanılabilen özet kart yerleşimini referans alır. Değer true veya false olmalıdır.
    • bShowFilterBar: Filtre çubuğunu gösterir veya gizler. Değer true veya false olmalıdır.
    • showCanvasNavigation: Çalışma kitabının Sunum sekmesindeki fon gezinme ayarına göre çalışma kitabındaki fonları gösterir veya gizler. Değer true veya false olmalıdır.

    Örneğin, <oracle-dv project-path="{{projectPath}}" active-page="canvas" active-tab-id="1" filters="{{filters}}" project-options='{"bDisableMobileLayout":true, "bShowFilterBar":false}'></oracle-dv>

  • brushing-type: Renklendirmenin nasıl çalıştığını kontrol eder. Belirttiğiniz değer, kaydedilen çalışma kitabındaki ayarlar ve sistem öndeğerleri dahil olmak üzere tüm diğer ayarları geçersiz kılar. Değer, on, off veya auto dizesi olmalıdır.
    • on: Normal önceliğe sahip renklendirme sorgularını düzenlemek için kullanın. Renklendirme sorguları ve görselleştirme sorguları karışıktır ve aynı zamanda çalışır.
    • auto: Öndeğer. Düşük önceliği olan renklendirme sorgularını düzenlemek için kullanın. Bir kullanıcı bir görselleştirme ile etkileşime geçtiğinde, renklendirme sorguları tamamlanana kadar diğer görselleştirmelerdeki işaretleri gösteren bir gecikme olabilir.
  • compatibility-mode: Oracle JET'in farklı ana sürümleri mevcut olduğunda kullanın. Bu, gömülü analitik içeriğini güvenli ortama almak için çalıştırma zamanında bir satır içi çerçeve oluşturur. Değer yes, no veya auto dizesi olmalıdır.

    Not:

    Bu özniteliği ayarlarken şu iki öğeye dikkat edin:

    Uyumluluk modunu kullanıyorsanız yöneticinizin güvenli etki alanı olarak kaydettiği uygulama için Çerçevelere İzin Ver'in seçildiğini doğrulayın. Bkz. Bir Uygulamayı Güvenli Etki Alanı Olarak Kaydetme.

    Oracle Analitik'in kullandığı JET sürümünü bulmak için Oracle Analitik'te oturum açın, tarayıcı konsolunu açın ve şu komutu çalıştırın:
    requirejs('ojs/ojcore').version
    • yes: Analitik gömülü içeriğini her zaman güvenli ortama almak istediğinizde kullanın. Bu, Oracle APEX uygulamalarına gömme yapılırken kullanışlıdır.
    • no: Öndeğer. Satır içi çerçeve oluşturmak istemediğinizde kullanın.
    • auto: Ana bilgisayar gömme uygulaması ile Oracle Analitik arasındaki Oracle JET sürümündeki büyük farklılıkları otomatik olarak algılamak için kullanın. Bunu Oracle APEX'e gömme yaparken kullanabilirsiniz.

Örnek

Bu örnekte tüm proje anları çalışma kitabı'nı referans gösterir.

<!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>