新增 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。

關於這項作業

語法著色指定 JavaScript 原始碼如何用其自己的顏色和樣式來呈現。如果要變更預設語法顏色喜好設定,請在 Document Studio 中,選取視窗 > 喜好設定 > JavaScript > 編輯器 > 語法著色

內容輔助會在蹦現視窗中顯示有效的替代項目清單,以用來完成現行的程式碼行。如果要啟動內容輔助,請按 ALT + 空格鍵

這是 JavaScript 編輯器的畫面擷取。

程序

  1. 按兩下 JavaScript 程式碼元素。 這時會開啟「JavaScript 程式碼元素的輸入程式碼」視窗。
  2. 選擇性的: 如果您要包含另一個檔案中的新 Script,請按一下包含 Script,並從電腦、遠端伺服器或「文件建置器」元件中選取一個檔案。按一下確定

    如果是從電腦或遠端伺服器選取的檔案,會在 JavaScript 編輯器中,開啟所選檔案中之 JavaScript 程式碼的副本。

    如果是從「文件建置器」中選取的檔案,會開啟「使用 Script 參照」視窗。您必須選擇是否要在範本中包含 JavaScript 作為參照鏈結:
    • 如果您選取,會將指向 JavaScript (.js) 檔案的鏈結內嵌在 <Script> 標籤內。例如,下列參照鏈結會新增至 JavaScript 編輯器,且不得修改:
      <Script src= "library://api/scripts/51"></Script>
      記住: 當您從範本產生文件,並在範本中以 JavaScript 作為參照鏈結,「文件建置器」必須已啟動,並且已連接至 Document Studio。如需詳細資料,請參閱連接至「文件建置器」元件主題。
    • 如果您選取,則會在 JavaScript 編輯器中開啟所選檔案中之 JavaScript 程式碼的副本。
  3. 選擇性的: 按一下在編輯器中開啟,以在 Eclipse JavaScript 編輯器中輸入 Script。 這時,Script 會以暫時的 .js 檔案形式,在新的編輯器標籤中開啟,這樣您就可以編輯 JavaScript,並透過「大綱」視圖中的選項來管理 Script。在編輯 Script 之後,儲存您所作的變更,並關閉暫時的 JavaScript 編輯器標籤,回到「輸入 JavaScript 程式碼元素的程式碼」視窗。
  4. 按一下測試 Script,驗證程式碼。
  5. 按一下確定,儲存變更並結束視窗。