ביצוע פעולות נתונים שמכילות תוכן משובץ

ביצוע פעולות נתונים

כשלוחצים על פעולת נתונים 'פרסם אירוע', הפעולה קובעת את מידע ההקשר להמחשה הגרפית ומעבירה את המידע לשירות פעולת הניווט כדי לעבד אותו. תהליך השירות של פעולת הניווט מפעיל אירוע שנקרא “oracle.bitech.dataaction” עם מידע המסר של ההקשר. תוכל להצטרף כמנוי לאירוע זה ולקבל את המסר ב-callback של האירוע, ותוכל גם לעשות שימוש נוסף במסר לפי הצורך.

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

.gif

פורמט והקשר של אירוע ומסר

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

הדוגמאות להלן הן מקובץ JSON ,לדוגמה, obitech-cca/cca/component.json.

פורמט אירוע

"events": {
   "oracle.bitech.dataaction": {
      "description": "Generic DV Event published from an embedded data visualization.",
      "bubbles": true,
      "cancelable": false,
      "detail": {
         "eventName": {
         "description": "The name of the published BI Event",
         "type": "string"
      },
      "payload": {
         "description": "The payload contains context and related information to the event published",
         "type": "object"
      }
   }
}

פורמט מסר

{"context":[
   "or": [
      "and":[
         {"contextParamValues":[...],
          "contextParamValuesKeys":[...],
          "colFormula":"...",
          "displayName":"...",
          "isDoubleColumn":true/false,
          "dataType":"..."
         }
      ]
   ]
 ]
}

העברת ערך בודד לעמודה יחידה ב'העבר לפי הקשר'

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

{
   "context": [
      {
         "contextParamValues": [
            "Inbound Org."
         ],
         "contextParamValuesKeys": [
            "Inbound Org."
         ],
         "colFormula": "\"A - Sample Sales\".\"Offices\".\"D3  Organization\"",
         "displayName": "D3  Organization",
         "isDoubleColumn": false,
         "dataType": "varchar"
      }
   ]
}

העברת ערך בודד לכל עמודה ב'העבר לפי הקשר'

בדוגמה זו, כאשר תלחץ על תא בעמודה ,לדוגמה, ארגון פנימי עם מוצרים דיגיטליים, ותלחץ על אפשרות התפריט DA1 משובץ כדי לבחור את הפעולה המשובצת, המידע שיועבר הוא ערך ההכנסה בדולרים של הארגון והתחום העסקי שנבחרו. לדוגמה, ההכנסה שהועברה ממוצרים דיגיטליים בארגון המקומי היא $1, 458,738.42 בדוגמה זו.

{
   "context": [
      {
         "contextParamValues": [
            "Digital"
         ],
         "contextParamValuesKeys": [
            "Digital"
         ],
         "colFormula": "\"A - Sample Sales\".\"Products\".\"P3  LOB\"",
         "displayName": "P3  LOB",
         "isDoubleColumn": false,
         "dataType": "varchar"
      },
      {
         "contextParamValues": [
            "Inbound Org."
         ],
         "contextParamValuesKeys": [
            "Inbound Org."
         ],
         "colFormula": "\"A - Sample Sales\".\"Offices\".\"D3  Organization\"",
         "displayName": "D3  Organization",
         "isDoubleColumn": false,
         "dataType": "varchar"
      }
   ]
}

העברת ערכים מרובים ב'העבר לפי הקשר'

בדוגמה זו, כאשר תלחץ על שני תאי שורה (לדוגמה, ארגון פנימי וארגון בינלאומי של מוצרים דיגיטליים) ותלחץ על אפשרות התפריט DA1 משובץ כדי לבחור את הפעולה המשובצת, המידע שיועבר הוא ערך ההכנסה בדולרים של שני התאים שנבחרו לארגון ולתחומים עסקיים. לדוגמה, לחיצה על הכנסה של מוצרים דיגיטליים משני הארגונים שנבחרו (ארגון מקומי וארגון בינלאומי) מעבירה את הערכים $1, 458,738.42, וגם $915,528.97.

{
   "context": [
      {
         "or": [
            {
               "and": [
                  {
                     "contextParamValues": [
                        "Digital"
                     ],
                     "contextParamValuesKeys": [
                        "Digital"
                     ],
                     "colFormula": "\"A - Sample Sales\".\"Products\".\"P3  LOB\"",
                     "displayName": "P3  LOB",
                     "isDoubleColumn": false,
                     "dataType": "varchar"
                  },
                  {
                     "contextParamValues": [
                        "Inbound Org."
                     ],
                     "contextParamValuesKeys": [
                        "Inbound Org."
                     ],
                     "colFormula": "\"A - Sample Sales\".\"Offices\".\"D3  Organization\"",
                     "displayName": "D3  Organization",
                     "isDoubleColumn": false,
                     "dataType": "varchar"
                  }
               ]
            },
            {
               "and": [
                  {
                     "contextParamValues": [
                        "Digital"
                     ],
                     "contextParamValuesKeys": [
                        "Digital"
                     ],
                     "colFormula": "\"A - Sample Sales\".\"Products\".\"P3  LOB\"",
                     "displayName": "P3  LOB",
                     "isDoubleColumn": false,
                     "dataType": "varchar"
                  },
                  {
                     "contextParamValues": [
                        "International Org."
                     ],
                     "contextParamValuesKeys": [
                        "International Org."
                     ],
                     "colFormula": "\"A - Sample Sales\".\"Offices\".\"D3  Organization\"",
                     "displayName": "D3  Organization",
                     "isDoubleColumn": false,
                     "dataType": "varchar"
                  }
               ]
            }
         ]
      }
   ]
}

השתמש בשלבים אלה כדי להגדיר תצורה של דף ה-HTML לדוגמה המוצג להלן.

1. הוסף או שנה את מיקום הנתיב של חוברת העבודה.

   ראה <======== 1 להלן.

2. הצטרף כמנוי לאירוע שפורסם, שנקרא ‘oracle.bitech.dataaction’.

   ראה <======== 2 להלן.

3. הגדר listener של אירוע ו-callback של אירוע.

   ראה <======== 3 להלן.

דוגמה לדף HTML עם המחשה גרפית, שמקבל אירועים

דף ה-HTML להלן מכיל המחשה גרפית משובצת ויכול לקבל אירועים. דף ה-HTML מוגדר להקשיב לאירוע “oracle.bitech.dataaction.”

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"><html>
   <head>
      <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
      <title>Standalone DV CCA Demo</title>
      <script src="http://hostname:port/bali/ui/api/v1/plugins/embedding/standalone/embedding.js" type="text/javascript"></script>
   </head>
   <body>
      <h1>Standalone DV CCA Embedded Data Action Demo</h1>
      <div id="mydiv" style="position: absolute; width: calc(100% - 40px); height: calc(100% - 120px)" >
         <oracle-dv project-path="/Shared Folders/RR/sample"></oracle-dv>         <=============== 1
      </div>
      <script>
         requirejs(['knockout', 'ojs/ojcore', 'ojs/ojknockout', 'ojs/ojcomposite', 'jet-composites/oracle-dv/loader'], function(ko) {
          ko.applyBindings();
         });
           
      </script>
      <script>
         var eventName = 'oracle.bitech.dataaction'; <========== 2
         var element = document.getElementById("mydiv");
         if (element) {
         var oEventListener = element.addEventListener(eventName, function (e) { <================= 3
         console.log("***** Payload from DV ***** ");
         console.log("eventName = " + e.detail.eventName);
         console.log("payload = " + JSON.stringify(e.detail.payload));
         console.log("***** Payload from DV end ***** ");
         }, true);
         }
      </script>
   </body>
</html>