הכן את דף ה-HTML בשביל תוכן משובץ של Oracle Analytics

לשיבוץ תוכן של Oracle Analytics, עליך ליצור או לעדכן את דף ה-HTML כך שיכלול את הכרזת DOCTYPE הדרושה, תכונה גלובלית dir (כיוון), ויפנה למקור JavaScript embedding.js ולכתובת ה-URL של חוברת העבודה המשובצת. עליך לציין גם את מצב השיבוץ (JET או עצמאי), שיטת אימות, ולהוסיף תכונות כלשהן.

נושא זה מכיל את המידע הבא:

הכרזת Doctype

הגדר את הכרזת Doctype כ-<!DOCTYPE html>. התנהגות בלתי צפויה, למשל הדף אינו מציג נכון תוצאות אם אתה משתמש בהכרזת doctype שאינה <!DOCTYPE html>, או אם אתה שוכח לכלול הכרזת doctype.

תכונה גלובלית dir (כיוון)

הגדר את התכונה הגלובלית dir כפי שנדרש על ידי ההגדרות האזוריות של דף האינטרנט. התכונה הגלובלית dir מציינת את כיוון המתווה של תוכן Analytics המשובץ.

הערה :

אם אתה צריך לתמוך במספר הגדרות אזוריות, השתמש ב-JavaScript להגדרת התכונה.

האפשרויות לגבי ערך התכונה הן:

  • rtl - השתמש בערך זה לכיוון המתווה מימין לשמאל.
  • ltr - השתמש בערך זה לכיוון המתווה משמאל לימין.
  • auto - אל תשתמש. ערך זה אינו נתמך על ידי Oracle Analytics.

תגית <script> והפניה למקור JavaScript

הערה :

Oracle Analytics מפיק את התגית <script> ואת כתובת ה-URL של מקור JavaScript שאתה צריך לכלול.

הוסף תגית <script> שמפנה את embedding.js לדף HTML שלך.

מבנה URL של מקור JavaScript הוא:
  • ”https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v1/embedding/<embeddingMode>/embedding.js”. הדוגמאות במסמך זה משתמשות בכתובת URL זו.
  • לפריסות ישנות יותר, השתמש ב: "http://<instance>.analytics.ocp.oraclecloud.com/ui/dv/v1/embedding/<embeddingMode>/embedding.js".

כאשר <embeddingMode> צריך להיות jet או עצמאי:

  • השתמש ב-jet אם אתה משבץ תוכן של Analytics בתוך יישום קיים של Oracle JET. אם אתה משתמש ב-jet, אזי הגרסה של Oracle JET שבה היישום משתמש חייבת להתאים לאותה גרסה ראשית של Oracle JET שבה משתמש Oracle Analytics. לדוגמה, אם Oracle Analytics עושה שימוש ב-JET 11.0.0, אזי גם היישום המותאם אישית שלך חייב להשתמש ב-JET 11.0.0 או 11.1.0. Oracle Analytics משתמש בגרסה 11.1.10 של Oracle JET.

    לחיפוש גרסת JET שבה משתמש Oracle Analytics, התחבר אל Oracle Analytics, פתח את קונסולת הדפדפן, והרץ את הפקודה הבאה: 
    requirejs('ojs/ojcore').version

    אם היישום המשבץ משתמש ב-Oracle JET, אזי Oracle Analytics מרחיב את היישום עם הרכיבים הדרושים לו. ראה שבץ תוכן של Oracle Analytics לתוך יישום מותאם אישים המשתמש ב-Oracle JET.

    Oracle JET היא מערכת של ספריות מבוססות Javascript המשמשות לממשק המשתמש של Oracle Analytics.

  • השתמש בstandalone בעת שיבוץ תוכן של המחשה גרפית ביישום כללי שאינו עושה שימוש ב-Oracle JET.

    אם היישום המשבץ לא משתמש ב-JET, אזי Oracle Analytics מביא את הפצת JET שלו לדף עם רכיבים נוספים. ראה שבץ תוכן של Oracle Analytics לתוך יישום מותאם אישית שלא משתמש ב-Oracle JET.

אימות

להצגת תוכן Analytics המשובץ תזדקק למושב עבודה מאומת. אתה יכול להשתמש במנחה התחברות או באימות זהות באמצעות OAuth תלת-רגלי. ראה הוספת אימות.

רכיב <oracle-dv>

כדי לשבץ חוברת עבודה, עליך להוסיף את מקטע HTML הבא עם ערכי תכונות בתוך רכיב בגודל מתאים. Oracle Analytics מפיק את ה-HTML שאתה צריך לכלול..

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

התכונות הנתמכות — תכונות אלה תומכת במחרוזות סטטיות ובמאפיינים המוגדרים במודל Knockout. Knockout היא טכנולוגיה בשימוש ב-Oracle JET.

הערה :

ראה שבץ תוכן של Oracle Analytics לתוך יישום מותאם אישית שלא משתמש ב-Oracle JET לקבלת דוגמה לאיגוד תכונות אלה למודל Knockout.

  • project-path: מציינת את נתיב חוברת העבודה שאותה תרצה להציג.

  • active-page: (אופציונלית) מציינת אם תוצג תובנה שאינה ברירת המחדל. כאשר אתה מציין active-page, אתה משתמש גם ב-active-tab-id כדי לציין את יריעת 'הצגה' המדויקת שאתה מציג. הערך התקף הוא insight.

    הערה :

    הערך canvas של active-page is אינו בשימוש. Oracle ממליצה שתשנה את קוד השיבוץ שלך שעושה שימוש ב-canvas ל-insight. תוכן Analytics משובץ קיים שמשתמש בcanvas ימשיך לפעול ותוצג אזהרה בקונסולת הדפדפן.

  • active-tab-id: (אופציונלית) מציינת את מזהה 'צור המחשה גרפית של יריעה' או מזהה היריעה הנוכחית שאתה מציג.

  • filters: (אופציונלי) מתירה העברה תוכניתית של ערכי סינון לחוברת עבודה משובצת.

  • project-options: (אופציונאלי) בתכונה זו, פרויקט מתייחס לחוברת עבודה. מאפשר לך להעביר אפשרויות אלו:
    • bDisableMobileLayout: חוסמת או מאפשרת את מתווה הנייד. מתווה נייד מתייחס למתווה כרטיס הסיכום הזמין במכשירי טלפון בלבד. הערך חייב להיות true או false.
    • bShowFilterBar: מציגה או מסתירה את סרגל הסינון. הערך חייב להיות true או false.
    • showCanvasNavigation: מציגה או מסתירה את היריעות בחוברת העבודה על-פי הגדרת ניווט היריעה בכרטיסייה 'הצגה' של חוברת העבודה. הערך חייב להיות true או false.

    לדוגמה, <oracle-dv project-path="{{projectPath}}" active-page="canvas" active-tab-id="1" filters="{{filters}}" project-options='{"bDisableMobileLayout":true, "bShowFilterBar":false}'></oracle-dv>

  • brushing-type: קובעת כיצד פועלת ההברשה. הערך שאתה מציין דורס את כל ההגדרות האחרות, כולל ברירות מחדל של המערכת והגדרות בחוברת העבודה השמורה. הערך חייב להיות המחרוזת on, off, או auto.
    • on: משמש להנפקת שאילתות הברשה עם קדימות רגילה. שאילתות הברשה ושאילתות המחשה גרפית מעורבות ורצות באותו הזמן.
    • auto: ברירת המחדל. משמש להנפקת שאילתות הברשה עם קדימות נמוכה. כאשר משתמש יוצר אינטראקציה עם המחשה גרפית, ייתכן שתהיה השהיה בהצגת סימנים בהמחשות אחרות עד ששאילתות ההברשה יושלמו.
  • compatability-mode: לשימוש כאשר נמצאות גרסאות עיקריות שונות של Oracle JET. זה יוצר iFrame בזמן ריצה כדי ליצור שולחן חול לתוכן Analytics המשובץ. הערך חייב להיות המחרוזת yes, no, או auto.

    הערה :

    בעת הגדרת תכונה זו, שים לב לשני הפריטים הבאים:

    אם אתה משתמש במצב תאימות, אשר שהאפשרות התר מסגרות נבחרה בשביל היישום שאותו המנהלן שלך רשם כדומיין בטוח. ראהרשום יישום כדומיין בטוח.

    לחיפוש גרסת JET שבה משתמש Oracle Analytics, התחבר אל Oracle Analytics, פתח את קונסולת הדפדפן, והרץ את הפקודה הבאה: 
    requirejs('ojs/ojcore').version
    • yes: לשימוש כאשר תמיד תרצה ליצור שולחן חול לתוכן Analytics המשובץ. זה יהיה שימושי בעת שיבוץ לתוך יישומי Oracle APEX.
    • no: ברירת המחדל. כשאין ברצונך ליצור iFrame.
    • auto: משמש לאיתור אוטומטי של הבדלים גדולים בגרסת Oracle JET בין היישום המארח את השיבוץ לבין Oracle Analytics. זה יהיה שימושי בעת שיבוץ לתוך Oracle APEX.

דוגמה

בדוגמה זו, כל המופעים של פרויקט מפנים אל חוברת עבודה.

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