wiki:TracTicketsCustomFields

Version 2 (modified by trac, 12 years ago) (diff)

--

カスタムチケット属性

Trac ではチケットにユーザ定義の属性を追加できます。カスタムチケット属性を使用すると、定型で、プロジェクト特有のプロパティをチケットに持たせることができます。

Note: Trac 0.8 では、この機能は、まだ実験段階です。

設定方法

カスタムチケット属性を設定するためには、 TracIni 設定ファイルを変更します。

カスタムフィールドは、 trac.ini ファイルの [ticket-custom] セクションに書く必要があります。

各属性の定義は以下のように記述します:

 属性名 = タイプ
 (属性名.オプション = 値)
 ...

構文の詳細は以下の例を見てください。

属性のタイプとオプション

  • text: シンプルな(1行の)テキスト。
    • label: 説明となるラベル
    • value: デフォルト値
    • order: ソート時の並び順 (フォーム内での相対的位置を決定します。)
  • checkbox: ブーリアン値をもつチェックボックス。
    • label: 説明となるラベル。
    • value: デフォルト値 (0 または 1).
    • order: ソート時の並び順
  • select: ドロップダウンするリストボックス。
    • options: リストに表示する値を | (vertical pipe) 区切りで記述。
    • value: デフォルト値 (0から始まるリスト内での番号) 。
    • order: ソート時の並び順
  • radio: ラジオボタン。HTMLの select 要素と同じ。
    • label: 説明となるラベル。
    • options: リストに表示する値を | (vertical pipe) 区切りで記述。
    • value: デフォルト値 (0から始まるリスト内での番号) 。
    • order: ソート時の並び順
  • textarea: 複数行のテキストエリア。
    • label: 説明となるラベル。
    • value: デフォルトで設定されるテキスト。
    • width: 入力領域のカラム幅。
    • height: 入力領域の行数。
    • order: ソート時の並び順

サンプル

[ticket-custom]
test_one = text
test_one.label = Just a text box

test_two = text
test_two.label = Another text-box
test_two.value = Just a default value

test_three = checkbox
test_three.label = Some checkbox
test_three.value = 1

test_four = select
test_four.label = My selectbox
test_four.options = one|two|third option|four
test_four.value = 2

test_five = radio
test_five.label = Radio buttons are fun
test_five.options = uno|dos|tres|cuatro|cinco
test_five.value = 1

test_six = textarea
test_six.label = This is a large textarea
test_six.value = Default text
test_six.width = 60
test_six.height = 30

参考: TracTickets, TracIni