使用 JavaScript 檔案庫載入 Web 工作表物件

使用 JavaScript 及 Dojo 的組合來實例化 Web 工作表物件。載入物件之後，您就可以將它指派為 Dojo 標籤儲存器或其他儲存器的子項，以在網頁中顯示。

您可以使用下列格式來載入 Web 工作表物件，以指定用來定義物件的必要內容及選用函數。

new Workbook({properties ..., functions ...});

properties 內含的值可以指定登入認證及您要開啟的 Web 工作表物件。

functions 可以包括選用程式碼，以通知您有關物件的 onLoad 及 onTitleDimensionElementChange 事件。

如需相關資訊，請參閱Cognos TM1 Web JavaScript 檔案庫 Workbook 類別。

範例

下列範例顯示 JavaScript 函數，此函數使用 JavaScript 及 Dojo 語法組合來載入 Web 工作表物件。

實例化物件的程式碼必須使用特定 Dojo 語法及 Dojo require 關鍵字。載入物件之後，此函數會將它指派為 Dojo 標籤儲存器物件 (dijit.layout.TabContainer) 的子項。

// Load Websheet with parameters for adminHost, tm1Server, username and password
function loadWebsheet() {
    require([
        "tm1web/websheet/Workbook",
        "dojo/_base/unload",
    ], function(Workbook, unload){
        loadedWebsheet = new Workbook({
            adminHost: "localhost",
            tm1Server: "Planning Sample",
            username: "admin",
            password: "apple",
            path: "Applications/Planning Sample/Management Reporting/Actual v Budget",
            title: "Active v Budget",
            onLoad: function() {
                console.debug("Workbook loaded successfully.");
            },
        });

        // Assign object to a UI container
        dijit.byId("tabContainer").addChild(loadedWebsheet);

        loadedWebsheet.startup();

        unload.addOnUnload(function() {
            loadedWebsheet.destroy();
        });
    });
};

下列範例使用登入的階段作業記號來載入 Web 工作表物件。

// Load Websheet with a session token
function loadWebsheet() {
    require([
        "tm1web/websheet/Workbook",
        "dojo/_base/unload",
    ], function(Workbook, unload){
        loadedWebsheet = new Workbook({
            sessionToken: "yourSessionToken",
            path: "Applications/Planning Sample/Management Reporting/Actual v Budget",
            title: "Active v Budget",
            onLoad: function() {
                console.debug("Workbook loaded successfully.");
            },
        });

        // Assign object to a UI container
        dijit.byId("tabContainer").addChild(loadedWebsheet);

        loadedWebsheet.startup();

        unload.addOnUnload(function() {
            loadedWebsheet.destroy();
        });
    });
};