新增 JavaScript 程式碼元素

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

關於這項作業

JavaScript 的範圍可以從簡單的引數到複雜的 Script。
  • 若為簡單的引數,您可以將 Script 套用至「文字」元素等之類元素的內容。請按兩下文字元素,選取 Script 表示式標籤,並輸入 Script。
  • 若為複雜的 Script,您可以利用這項作業,使用 JavaScript 程式碼元素來套用您的 Script。
相較於使用元素的「Script 表示式」標籤,使用 JavaScript 程式碼元素的好處如下:
  • 您可以重複使用其他使用者的 Script。
  • 您可以將計算分組,而不必煩惱其執行順序。
  • 您可以建立一般和複雜的資料結構(例如:集合),然後繼續新增到資料結構中。
    註: 您無法在某一個 JavaScript 程式碼或文字元素中,呼叫另一個 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. 按一下確定,儲存變更並結束視窗。

意見