Changes between Version 1 and Version 2 of TracTicketsCustomFields

Timestamp:

May 13, 2012, 9:15:45 PM (13 years ago)

Author:

trac

Comment:

--

TracTicketsCustomFields

@@ -1 @@
-= カスタムチケット属性 =
-Trac ではチケットにユーザ定義の属性を追加できます。カスタムチケット属性を使用すると、定型で、プロジェクト特有のプロパティをチケットに持たせることができます。
+= カスタムチケット属性 = #CustomTicketFields
+Trac ではチケットにユーザ定義の属性を追加できます。カスタムチケット属性を使用すると、型付けされた、プロジェクト特有のプロパティをチケットに持たせることができます。
 
-== 設定方法 ==
+== 設定方法 == #Configuration
 カスタムチケット属性を設定するためには、 [wiki:TracIni trac.ini] ファイルを変更します。カスタムフィールドは、 trac.ini ファイルの `[ticket-custom]` セクションに書く必要があります。
 
@@ -13 +13 @@
 構文の詳細は以下の例を見てください。
 
-=== 属性のタイプとオプション ===
+=== 属性のタイプとオプション === #AvailableFieldTypesandOptions
  * '''text''': シンプルな(1行の)テキスト。
    * label: 説明となるラベル
    * value: デフォルト値
-   * order: ソート時の並び順 (フォーム内での相対的位置を決定します。)
+   * order: ソート時の並び順 (全てのカスタムフィールドで共通するソートの並び順)
+   * format: 通常のテキストを指す `plain` もしくは WikiFormatting として整形を行う `wiki` のいずれかを指定する。 (''0.11.3 以降'')
  * '''checkbox''': ブーリアン値をもつチェックボックス。
    * label: 説明となるラベル。
@@ -25 +26 @@
    * label: 説明となるラベル。
    * options: リストに表示する値を '''|''' (vertical pipe) 区切りで記述。
-   * value: デフォルト値 (0から始まるリスト内での番号) 。
+   * value: デフォルト値 (options の値から一つを指定)
    * order: ソート時の並び順
  * '''radio''': ラジオボタン。 HTML の '''select''' 要素と同じ。
    * label: 説明となるラベル。
    * options: リストに表示する値を '''|''' (vertical pipe) 区切りで記述。
-   * value: デフォルト値 (0から始まるリスト内での番号) 。
+   * value: デフォルト値 (options の値から一つを指定)
    * order: ソート時の並び順
  * '''textarea''': 複数行のテキストエリア。
@@ -38 +39 @@
    * rows: 入力領域の行数。
    * order: ソート時の並び順
+   * format: 通常のテキストを指す `plain` もしくは WikiFormatting として整形を行う `wiki` のいずれかを指定する。 (''0.11.3 以降'')
 
-=== サンプル ===
+=== サンプル === #SampleConfig
 {{{
 [ticket-custom]
@@ -48 +50 @@
 test_two = text
 test_two.label = Another text-box
-test_two.value = Just a default value
+test_two.value = Default [mailto:joe@nospam.com owner]
+test_two.format = wiki
 
 test_three = checkbox
@@ -57 +60 @@
 test_four.label = My selectbox
 test_four.options = one|two|third option|four
-test_four.value = 2
+test_four.value = two
 
 test_five = radio
 test_five.label = Radio buttons are fun
 test_five.options = uno|dos|tres|cuatro|cinco
-test_five.value = 1
+test_five.value = dos
 
 test_six = textarea
@@ -73 +76 @@
 ''Note: `select` タイプのフィールドを非必須 (optional) にしたい場合、 `フィールド名.options` オプションの先頭に `バーティカルパイプ (|)` を設定してください。''
 
-=== カスタム属性を含むレポート ===
+=== カスタム属性を含むレポート === #ReportsInvolvingCustomFields
 
-カスタム属性を含む TracReports では比較的 SQL を間違えやすいです。 `ticket_custom` 表の `JOIN` はカスタム属性ごとにそれぞれ必要です。
+カスタムチケット属性は `ticket` テーブルに保存されるのではなく、 `ticket_custom` テーブルに保存されます。したがって、レポートのカスタム属性を表示するためには `ticket` と `ticket_custom` の 2 テーブルを join する必要があります。 `progress` と設定されたカスタムチケット属性の使用例を示します。
 
-以下の例は `progress` という名前のカスタム属性を含むレポートです:
+{{{
+#!sql
+SELECT p.value AS __color__,
+   id AS ticket, summary, owner, c.value AS progress
+  FROM ticket t, enum p, ticket_custom c
+  WHERE status IN ('assigned') AND t.id = c.ticket AND c.name = 'progress'
+AND p.name = t.priority AND p.type = 'priority'
+  ORDER BY p.value
+}}}
+'''Note''' この例は progress が設定されたチケットだけを表示します。'''すべてのチケットを表示するのではありません。'''既にいくつかのチケットを作成した''後で''カスタムチケット属性を定義した場合、既に作成されたチケットにはカスタムチケット属性が定義されません。そのため上記のクエリではチケットが表示されないでしょう。既に作成されたチケットにカスタム属性を設定し直せば、カスタムチケット属性は定義されます。そして、上記のクエリによって表示されるでしょう。
+
+しかし、すべてのチケットエントリを ( progress が定義されていないエントリーも一緒に ) 表示したいのであれば、クエリにおいてあらゆるカスタムフィールドに `JOIN` を使用する必要があります。
 {{{
 #!sql
@@ -96 +110 @@
 この `LEFT OUTER JOIN` ステートメントに特に注意してください。
 
+=== データベースを更新する === #Updatingthedatabase
+
+上記に記述したとおり、カスタムフィールド設定以前に作成されたチケットには、該当するフィールドの値が定義されていない状態になります。以下のような SQL を Trac のデータベースで直接実行することで、カスタムフィールドの初期値を設定することができます (SQLite 向けの SQL ですので、 DBMS に応じて調整してください)。カスタムフィールド 'request_source' が存在しない、全てのチケットにデフォルト値 'None' が挿入されます:
+
+{{{
+#!sql
+INSERT INTO ticket_custom
+   (ticket, name, value)
+   SELECT 
+      id AS ticket,
+      'request_source' AS name,
+      'None' AS value
+   FROM ticket 
+   WHERE id NOT IN (
+      SELECT ticket FROM ticket_custom
+   );
+}}}
+
+複数のカスタムフィールドを追加している場合、 {{{ticket}}} 表への副問合わせで対象となるカスタムフィールドの名前を指定しなければなりません (訳注: 通常は上記の例ではなく、こちらを使うといいでしょう):
+
+{{{
+#!sql
+INSERT INTO ticket_custom
+   (ticket, name, value)
+   SELECT 
+      id AS ticket,
+      'request_source' AS name,
+      'None' AS value
+   FROM ticket 
+   WHERE id NOT IN (
+      SELECT ticket FROM ticket_custom WHERE name = 'request_source'
+   );
+}}}
+
 ----
 See also: TracTickets, TracIni