使用 JavaScript 及 Dojo 的組合來實例化 Web 工作表物件。載入物件之後,您就可以將它指派為 Dojo 標籤儲存器或其他儲存器的子項,以在網頁中顯示。
您可以使用下列格式來載入 Web 工作表物件,以指定用來定義物件的必要內容及選用函數。
new Workbook({properties ..., functions ...});
properties 內含的值可以指定登入認證及您要開啟的 Web 工作表物件。
functions 可以包括選用程式碼,以通知您有關物件的 onLoad 及 onTitleDimensionElementChange 事件。
如需相關資訊,請參閱Cognos TM1 Web JavaScript 檔案庫 Workbook 類別。
實例化物件的程式碼必須使用特定 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();
});
});
};