Changes between Version 3 and Version 4 of TracTicketsCustomFields
- Timestamp:
- Dec 31, 2005, 5:43:43 PM (18 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracTicketsCustomFields
v3 v4 1 = Custom Ticket Fields=2 Trac supports adding custom, user-defined fields to the ticket module. Using custom fields, you can add typed, site-specific properties to tickets.1 = カスタムチケット属性 = 2 Trac ではチケットにユーザ定義の属性を追加できます。カスタムチケット属性を使用すると、定型で、プロジェクト特有のプロパティをチケットに持たせることができます。 3 3 4 == Configuration==5 Configuring custom ticket fields is done in the [wiki:TracIni trac.ini] file. All field definitions should be under a section named `[ticket-custom]`. 4 == 設定方法 == 5 カスタムチケット属性を設定するためには、 [wiki:TracIni trac.ini] ファイルを変更します。カスタムフィールドは、 trac.ini ファイルの `[ticket-custom]` セクションに書く必要があります。 6 6 7 The syntax of each field definition is:7 各属性の定義は以下のように記述します: 8 8 {{{ 9 FIELD_NAME = TYPE10 ( FIELD_NAME.OPTION = VALUE)9 属性名 = タイプ 10 (属性名.オプション = 値) 11 11 ... 12 12 }}} 13 The example below should help to explain the syntax. 13 構文の詳細は以下の例を見てください。 14 14 15 === Available Field Types and Options===16 * '''text''': A simple (one line) text field.17 * label: Descriptive label.18 * value: Default value.19 * order: Sort order placement. (Determines relative placement in forms.)20 * '''checkbox''': A boolean value check box.21 * label: Descriptive label.22 * value: Default value (0 or1).23 * order: Sort order placement.24 * '''select''': Drop-down select box. Uses a list of values.25 * options: List of values, separated by '''|''' (vertical pipe).26 * value: Default value (Item #, starting at 0).27 * order: Sort order placement.28 * '''radio''': Radio buttons. Essentially the same as '''select'''.29 * label: Descriptive label.30 * options: List of values, separated by '''|''' (vertical pipe).31 * value: Default value (Item #, starting at 0).32 * order: Sort order placement.33 * '''textarea''': Multi-line text area.34 * label: Descriptive label.35 * value: Default text.36 * cols: Width in columns.37 * rows: Height in lines.38 * order: Sort order placement.15 === 属性のタイプとオプション === 16 * '''text''': シンプルな(1行の)テキスト。 17 * label: 説明となるラベル 18 * value: デフォルト値 19 * order: ソート時の並び順 (フォーム内での相対的位置を決定します。) 20 * '''checkbox''': ブーリアン値をもつチェックボックス。 21 * label: 説明となるラベル。 22 * value: デフォルト値 (0 または 1). 23 * order: ソート時の並び順 24 * '''select''': ドロップダウンするリストボックス。 25 * options: リストに表示する値を '''|''' (vertical pipe) 区切りで記述。 26 * value: デフォルト値 (0から始まるリスト内での番号) 。 27 * order: ソート時の並び順 28 * '''radio''': ラジオボタン。HTMLの '''select''' 要素と同じ。 29 * label: 説明となるラベル。 30 * options: リストに表示する値を '''|''' (vertical pipe) 区切りで記述。 31 * value: デフォルト値 (0から始まるリスト内での番号) 。 32 * order: ソート時の並び順 33 * '''textarea''': 複数行のテキストエリア。 34 * label: 説明となるラベル。 35 * value: デフォルトで設定されるテキスト。 36 * cols: 入力領域のカラム幅。 37 * rows: 入力領域の行数。 38 * order: ソート時の並び順 39 39 40 === Sample Config===40 === サンプル === 41 41 {{{ 42 42 [ticket-custom] … … 70 70 }}} 71 71 72 ''Note: To make an entering an option for a `select` type field optional, specify a leading `|` in the `fieldname.options` option.''72 ''Note: `select` タイプのフィールドを非必須(optional)にしたい場合、 `フィールド名.options` オプションの先頭に `バーティカルパイプ (|)` を設定してください。'' 73 73 74 === Reports Involving Custom Fields===74 === カスタム属性を含むレポート === 75 75 76 The SQL required for TracReports to include custom ticket fields is relatively hard to get right. You need a `JOIN` with the `ticket_custom` field for every custom field that should be involved. 76 カスタム属性を含む TracReports では比較的 SQL を間違えやすいです。 `ticket_custom` 表の `JOIN` はカスタム属性ごとにそれぞれ必要です。 77 77 78 The following example includes a custom ticket field named `progress` in the report:78 以下の例は `progress` という名前のカスタム属性を含むレポートです: 79 79 {{{ 80 80 #!sql … … 93 93 }}} 94 94 95 Note in particular the `LEFT OUTER JOIN` statement here. 95 この `LEFT OUTER JOIN` ステートメントに特に注意してください。 96 96 97 97 ----