新增 JavaScript 程式碼元素

針對範本中使用的每一個程式碼區塊,使用 JavaScript 程式碼元素。
限制: 「新特性」圖示 JavaScript 程式碼元素僅適用於第 2 版範本。

關於這項作業

JavaScript 的範圍可以從簡單的引數到複雜的 Script。
  • 若為簡單的引數,您可以將 Script 套用至「文字」元素等之類元素的內容。按兩下該文字元素,選取 Script 表示式標籤,並輸入 Script。
  • 若為複雜的 Script,您可以利用這項作業,使用 JavaScript 程式碼元素來套用您的 Script。
相較於使用元素的「Script 表示式」標籤,使用 JavaScript 程式碼元素的好處如下:
  • 您可以重複使用其他使用者的 Script。
  • 您可以將計算分組,而不必煩惱其執行順序。
  • 您可以建立一般和複雜的資料結構(例如:集合),然後繼續新增到資料結構中。
    提示:Rational® Publishing Engine 2.1 版開始, 您可以在 Script 程式碼中設定程式庫 Script 內容, 來呼叫另一個 JavaScript 程式碼或「Script 表示式」中之某個 JavaScript 程式碼元素內所定義的函數。 如果要設定程式庫 Script 內容, 請移至 JavaScript Code 元素的內容視圖, 選取特定標籤,並啟用程式庫 Script勾選框。 如需程式庫 Script 內容的詳細資料,請參閱 JavaScript 程式碼元素內容主題。

您的安裝檔案和預先定義的「中央管理」元件檔案中包含 JavaScript 檔 utils.js,以供您用於簡式 JavaScript,例如:在報告輸出中包含現行日期。

如果要查看您範本中現有的 JavaScript 程式碼清單,請按一下範本 > 檢閱 JavaScript。這時會開啟「搜尋」視圖,並顯示使用 JavaScript 的元素清單。在這個環境定義中,原生過濾器不算是 JavaScript。原生過濾器不會列在搜尋結果中。

程序

  1. 在開始處理 JavaScript 之前,請先儲存您的範本。
  2. 在「選用區」視圖中,選取 「JavaScript 程式碼」圖示 JavaScript 程式碼元素,並將它拖曳到範本內容編輯器中。
  3. 按兩下 JavaScript 程式碼元素。
  4. 從「Script 表示式」標籤中的樹狀結構,選取要套用 JavaScript 程式碼的變數。
  5. 使用下列其中一個選項,來輸入 JavaScript 程式碼:
    • 在這個視窗中手動撰寫 Script
    • 從外部編輯器複製 Script,並貼到這個視窗中
    • 按一下併入 Script,並從電腦、遠端伺服器或「中央管理」元件選取一個檔案
  6. 選擇性的: 如果您是從 XHTML 複製 Script,您可以:
    • 選取 XHTML 輸入選項,以容許編輯 Script 中包含的 XHTML 標籤。
    • 清除 XHTML 輸入選項,以移除 Script 中的所有 XHTML 標籤。
    如果您要複製 Rich Text,或在條件中使用 Rich Text,必須選取 XHTML 輸入選項。
    重要: 無效 XHTML 導致文件產生失敗。 儲存變更之前,請確認您的 XHTML 有效。
  7. 選擇性的: 如果您要將範本產生為 XHTML 輸出,您可以:
    • 選取 XHTML 輸出選項,剖析 Script,並將 Script 呈現為 Rich Text。
    • 清除 XHTML 輸出選項,將 Script 視為純文字。
    這項選擇會套用至表示式中的所有資料來源屬性。在 Script 中不能混合使用純文字和 XHTML。

    如果您要複製 Rich Text,或基於權宜建立 Rich Text,您必須選取 XHTML 輸出選項。

  8. 輸入 Script 之後,按一下測試 Script,來驗證程式碼。 如果 JavaScript 中發生錯誤,可能無法順利產生文件。
  9. 按一下確定來儲存變更。 程式碼區塊在元素中會收合起來。您可以展開程式碼,以便在範本內容編輯器中檢視。

在 JavaScript 編輯器中工作

使用 JavaScript 編輯器來處理您的 Script,使其具備顏色格式化和行號。

程序

  1. 按兩下 JavaScript 程式碼元素。 這時會開啟「JavaScript 程式碼元素的輸入程式碼」視窗。
  2. 選擇性的: 如果您要併入另一個檔案中的新 Script,請按一下併入 Script,並從電腦、遠端伺服器或「中央管理」元件選取一個檔案。按一下確定,關閉視窗,並按兩下元素,再次開啟「JavaScript 程式碼元素的輸入程式碼」視窗。
  3. 按一下在編輯器中開啟,以在 Eclipse JavaScript 編輯器中輸入 Script。 這時 Script 會在新的編輯器標籤中開啟為暫存 .js 檔,您可以編輯 JavaScript。
    註: 當您開始輸入時,在輸入句點或另一個字元作為值之後,可能會出現存取 JavaScript 檔時發生錯誤訊息。後面可能還接著內容輔助期間發生問題訊息。如果您遇到這些訊息,請完成訊息中的指示,來停用其他 JavaScript 提案選項:
    1. 按一下視窗 > 喜好設定 > JavaScript > 編輯器 > 內容輔助 > 進階
    2. 在「內容輔助循環」區段中,清除其他 JavaScript 提案選項。
    3. 按一下確定,關閉視窗。
  4. 透過「大綱」視圖中的選項來管理 Script。
  5. 儲存變更。
  6. 關閉暫時的 JavaScript 編輯器標籤。 這時會回到「JavaScript 程式碼元素的輸入程式碼」視窗。
  7. 按一下測試 Script,驗證程式碼。
  8. 按一下確定,儲存變更並結束視窗。