參數標籤

元件會使用參數(例如,視圖 ID、字串及數字),將資訊加入報告中。會使用 fp:*Param 標籤來指定這些參數。
每個元件都有必要和選用的標籤。所有參數標籤都有屬性。
表 1. 參數標籤與屬性
名稱 說明
參數標籤
fp:attrParam 指定屬性。例如「需求」模組中的狀態
fp:checkboxParam 包含布林值 true 或 false。
fp:critParam 包含整數值。例如 (..., -2, -1, 0, 1, 2, ....)。
fp:memberParam 指定成員。例如管理者
fp:stringParam 包含字串值。
fp:viewParam 指定視圖。例如「所有需求」。
參數標籤屬性
changeable 必要屬性,可決定參數會在何時變更,且適用於所有 *Param 標籤。此屬性有四個值:
  • 範本:會在建立或編輯報告類型時變更。
  • 執行時期:會在建立報告時變更。
  • 永不:不能變更,若在建立範本時就已經知道值,便會使用此屬性值。此值讀取自 defaultvalue 屬性。
  • 提取:會自動提取值。提取的值取決於「名稱」屬性的值:
    • currentdate:今天的日期
    • currenttime:目前的時間
    • currentuser:登入的使用者
    • fortune:「幸運籤餅」,每次都不一樣。若新增額外的 .jar 檔案,便會使用此值。
    • numpages:報告中的頁數。此值可在標頭及標底中使用。
    • workspacename:工作區的名稱
    • pageno:現行頁碼。此值可在標頭及標底中使用。
id 必要屬性,可指定參數的 ID,且適用於所有 *Param 標籤。每個參數都有唯一 ID。您可以在多個參數中使用相同的 ID。

只有第一個參數會顯示在使用者介面中。其他參數會從第一個參數複製其值。若要在多個標頭中顯示相同的資訊,或在多個元件中使用相同的視圖,那麼這個使用慣例會很有用。

name 必要屬性,可指定參數的名稱,且適用於所有 *Param 標籤。在元件標籤中,名稱是在搜尋參數時使用的唯一 ID。共用名稱為 viewId、attrId、elementId、pageno。
masterid 負責控制參數之參數的 ID。此為必要屬性,但不一定會使用,視元件而定。此屬性適用於 attrParam。主要參數通常是 viewParam。您必須先設定主要參數,否則您無法知道可以使用哪些屬性或元素。
type 決定可用於此參數的屬性類型。此為必要屬性,但不一定會使用,視元件而定。此屬性適用於 attrParam。您可以使用下列類型屬性:
  • choice:適用於選項屬性
  • number:適用於整數及浮點屬性
  • numbertext:適用於整數、浮點與矩陣屬性
  • link:適用於鏈結與鏈結清單屬性
  • all:適用於所有屬性類型
defaultvalue 第一次建立或編輯報告類型時,或第一次產生報告時,參數會設為 defaultvalue。此為選用屬性,適用於所有 *Param 標籤。預設值是空字串:defaultvalue=""
descr 參數的說明。這是選用屬性。在建立、編輯報告類型時或產生報告時,都會顯示說明。預設值是不使用說明:descr=""

建議與意見