自訂欄位¶

• 目錄
• 自訂欄位
  • 自訂欄位類型
    • 格式
    • 驗證
    • 值
    • 文字格式
    • 清單和鍵值清單
    • 將值連結到網址
    • 輸入欄位樣式
  • 支援自訂欄位的資料類型
    • 議題欄位
    • 工時輸入欄位
    • 專案欄位
    • 版本欄位
    • 使用者欄位
    • 群組欄位
    • 活動欄位（時間追蹤）
    • 議題優先順序欄位
    • 文件分類欄位

自訂欄位允許您將額外資訊新增至 Redmine 中使用的多種類型資料。請參閱「自訂欄位類型」以瞭解所有支援自訂欄位的資料類型。
每個自訂欄位都可以定義為特定類型。

自訂欄位類型¶

格式¶

自訂欄位可以是以下類型之一

• 布林值：核取方塊
• 日期：日期
• 浮點數：浮點數
• 整數：正數或負數
• 連結：網址
• 清單：下拉式清單
• 長文字：可調整大小的多行文字（從 2.50 版開始支援格式化的文字）
• 文字：多行文字（從 2.50 版開始支援格式化的文字）
• 使用者：可用於參考專案成員的自訂欄位格式
• 版本：可用於參考版本的自訂欄位格式

驗證¶

可以為每個自訂欄位定義一些驗證

• 最小-最大長度：欄位的最小和最大長度（0 表示沒有限制）
• 正規表示式：可以使用正規表示式來驗證欄位內容。範例
  1. 4 個大寫字母，後跟一個或多個數字
     

     ^\[A-Z]{4}\d+$

  2. 僅限字元，不含數字
     

     ^[^0-9]*$

• 完整的正規表示式清單可以在 Ruby 使用者指南中找到。

值¶

某些欄位支援多個值和預設值。

• 多個值：啟用後，可以選擇多個項目。
• 可能的值：「清單」欄位的可能值。每個值一行。
• 預設值：如果未選擇任何值，則套用預設值。

文字格式¶

某些欄位支援文字格式。

• 文字格式：是否將文字維基化。如果啟用，則會*鎖定*「將值連結到網址」欄位。

清單和鍵值清單¶

您可以建立自己的值清單供使用者新增。後續對「清單」類型值的變更不會影響過去建立的任何現有記錄，而對「鍵/值清單」類型值的變更也會影響過去建立的現有記錄。

將值連結到網址¶

「將值連結到網址」可以針對布林值、日期、清單、整數和文字格式欄位定義。

• **將值連結到網址**：使用以下變數建立網址。
  • %value% => 自訂欄位值
  • %id% => 自訂物件的 ID
  • %project_id% => 自訂物件所屬專案的 ID（如果已定義）
  • %project_identifier% => 自訂物件所屬專案的識別碼（如果已定義）
  • %m1%, %m2%... => 自訂欄位正規表示式的捕獲組匹配（如果已定義）

範例

https://redmine.dev.org.tw/issues/%value%

輸入欄位樣式¶

（2.5.2+）某些欄位可能會顯示為單選按鈕或複選框，其行為會根據所選的「格式」略有不同

• **布林值**：複選框（啟用/停用）或單選按鈕（空值/是/否）
• **清單**、**使用者** 和 **版本**
  • 複選框（如果已啟用 **多個值**）
  • 單選按鈕（如果已停用 **多個值**）

自訂欄位支援的資料類型¶

問題欄位¶

問題自訂欄位中的資料可以在 問題、問題清單、自訂查詢 和 工時記錄報表 中使用和/或顯示。

• **追蹤者**：待辦事項
• **必填**：建立/儲存問題時需要的欄位
• **適用於所有專案**：如果勾選，則此欄位用於所有專案的問題。如果未勾選，則每個專案可以選擇是否將此欄位用於其問題（請參閱 專案設定）。
• **用作篩選器**：待辦事項
• **可搜尋**：可以使用 Redmine 搜尋功能 搜尋的欄位

花費時間條目欄位¶

花費時間條目自訂欄位中的資料可以在 工時記錄報表 中使用和/或顯示。

• **必填**：建立/儲存花費時間條目時需要的欄位

專案欄位¶

專案自訂欄位中的資料可以在 專案總覽 中使用和/或顯示。

• **必填**：建立/儲存專案時需要的欄位
• **可搜尋**：可以使用 Redmine 搜尋功能 搜尋的欄位

版本欄位¶

版本自訂欄位中的資料可以在 路線圖 和 版本總覽 中使用和/或顯示。

• **必填**：建立/儲存版本時需要的欄位

使用者欄位¶

使用者自訂欄位中的資料可以在 使用者設定檔 中使用和/或顯示。

• **必填**：建立/儲存使用者時需要的欄位
• **可見**：在 使用者設定檔 中顯示的欄位
• **可編輯**：擁有使用者帳戶的 Redmine 使用者 可以編輯的欄位

群組欄位¶

注意：群組自訂欄位（尚）未在 Redmine 核心程式中使用，但其他外掛或主題*可能*會使用它們。目前這些設定對 Redmine 的任何其他部分都沒有任何影響。

活動欄位（時間追蹤）¶

時間追蹤活動自訂欄位中的資料可以在 時間日誌報告 和 專案設定 中使用和/或顯示¹。另請參閱 #4077，瞭解有關此實用功能的一些詳細資訊。

• 必填：建立/儲存活動時所需的欄位

問題優先順序的欄位¶

注意：問題優先順序自訂欄位（尚）未在 Redmine 核心程式中使用，但其他外掛或主題*可能*會使用它們。目前這些設定對 Redmine 的任何其他部分都沒有任何影響。

文件類別的欄位¶

注意：文件類別自訂欄位（尚）未在 Redmine 核心程式中使用，但其他外掛或主題*可能*會使用它們。目前這些設定對 Redmine 的任何其他部分都沒有任何影響。

¹ 有一些例外情況，請參閱 #19121#note-1。