フィールドのカスタマイズ

このトピックでは、システム定義フィールドおよびユーザー定義フィールド (UDF) の操作方法について説明します。これには、ユーザー定義フィールド (UDF) の作成と、フィールド表示ラベルの変更が含まれます。

このトピックの内容:

スペース間でのUDFの共有

UDFは共有スペースとワークスペースに対して定義できます。この概要では、共有リリースおよび非共有UDFの使用方法について説明します。

個別スペース

スペースが分離されている場合、UDFをスペースレベルで定義することはできません。

代わりに、ワークスペースの管理者は、個々のワークスペースでUDFを定義できます。

UDFは、その個々のワークスペースでのみ使用できます。

共有スペース (Enterpriseエディション)

この表は、共有スペースおよび関連するワークスペースでUDFを定義するときに管理者が実行できるアクションを要約したものです。

共有スペース	関連するワークスペース
スペース管理者は、共有スペースで定義されたUDFを追加および変更できます。 UDFは、関連付けられたすべてのワークスペースで使用できます。	共有スペースのスペース管理者によって定義されたUDFの場合: 特定のワークスペースで作業しているALM Octaneユーザーは、対応する共有スペースに対して定義されたUDFと、そのワークスペースに対して定義されたUDFの両方にアクセスできます。共有UDFは、アイコンで表示されます。 ワークスペースの管理者は、共有UDFを変更できません。 ワークスペースの管理者によって定義されたUDFの場合: ワークスペースの管理者は、これらのUDFを追加および変更できます。 UDFは、個別のワークスペースでのみ使用できます。

UDFの名前とラベルは一意である必要がありますか？

UDFが共有スペースに対して定義されている場合、関連するワークスペースで同じ名前を使用して、UDFの作成や、ラベルの定義を行うことはできません。

UDFが個々のワークスペースに対して定義されている場合、関連する共有スペースで同じ名前を使用して、UDFの作成や、ラベルの定義を行うことはできません。他のワークスペースで同じ名前を使用して、UDFの作成や、ラベルの定義を行うことは可能です。

ユーザー定義フィールドの追加

このセクションでは、ユーザー定義フィールドを追加する方法について説明します。

ユーザー定義フィールドを追加するには:

1. [設定] >スペースで、ユーザー定義フィールドを作成する共有スペースまたはワークスペースを選択します。

2. [エンティティ] タブをクリックします。

3. ペインの左側の [エンティティ] リストで、フィールドを作成する項目 (ユーザーストーリー、手動テスト、エピックなど) を選択します。

4. [フィールド] タブをクリックします。

5. [+] をクリックし、ユーザー定義フィールドを追加します。

6. 次の内容を入力します。 

   名前	説明
   名前	このフィールドへのアクセスでAPIが使用する一意の名前。英大文字や句読点は使用できません。 ALM Octaneは、フィールドの名前に接尾辞_udfを自動的に追加します。
   ラベル	UIで表示される、フィールドの一意の名前です。英語、英語以外の文字、および特殊文字を指定できます。
   フィールドタイプ	ドロップダウンからフィールドタイプを選択します。
   説明	ユーザー定義フィールドの説明を入力します。
   トレンド可能	このオプションは、次のタイプのUDFに対して選択できます。リスト、ブール値、整数、ユーザー、チーム、リリース、および日付と時刻。 UDFをトレンディとして選択すると、UDFはトレンドウィジェットでサポートされます。詳細については、UDFをトレンドとして定義するを参照してください。 注: これは、実行とタスクを除くすべてのトレンディなエンティティで使用できます。

   制限事項: ALM Octaneが特定の言語にローカライズされている場合でも、UDFは英語でのみ定義できます。

   ワークスペースごとに定義できるUDFの数の上限

   フィールドタイプ	ワークスペースごとに作成できるUDFの最大数
   文字列およびブール値	この2つのタイプで合計100。 注: 文字列フィールドで使用できるのは、255文字までです。
   数値	50
   日付時刻	20
   リスト	無制限
   ユーザー	無制限
   リリース	無制限
   チーム	無制限
   長い文字列	5 注: 長い文字列フィールドで使用できるのは、1500文字までです。
   メモ	30 注: この値を変更するには、MEMO_UDFS_LIMIT設定パラメーターMEMO_UDFS_LIMITを設定します。

7. リストタイプのユーザー定義フィールドを追加する場合は、次の操作を実行します。 

   • フィールドで使用するリストを選択します。

     独自のリストの作成の詳細については、リストのセットアップを参照してください。

   • ユーザー定義フィールドで複数値を選択する場合は、[複数値の選択を可能にする] チェックボックスをオンにします。

8. user、release、またはteamタイプのユーザー定義フィールドを追加する場合:  

   • 新しいフィールドの値の基になる参照フィールドを選択します。

   • ユーザー定義フィールドで複数値を選択する場合は、[複数値の選択を可能にする] チェックボックスをオンにします。

9. 既存のフォームにユーザー定義フィールドを追加するには、[追加先フォーム] ドロップダウンリストからフォームを選択します。

   環境	利用可能なフォーム
   分離されたスペースに関連付けられたワークスペースでのUDFの定義	リストから使用できるのはワークスペースフォームのみです。
   共有スペースに関連付けられたワークスペースでのUDFの定義	リストから使用できるのはワークスペースフォームのみです。ワークスペースフォームが定義されていない場合、リストは空です。 共有スペースフォームにUDFを追加するには、スペースレベルでUDFを追加します。
   共有スペースでのUDFの定義	リストから使用できるのは共有スペースフォームのみです。

10. 追加をクリックします。

ユーザー定義フィールドは、他の事前定義のシステムフィールドと同様にALM Octaneで利用できます。

トップに戻る

ユーザー定義フィールドの属性設定

フィールドを必須フィールドにするなど、ユーザー定義フィールドの属性を設定するには、エンティティタイプに対してルールを作成します。詳細については、ビジネスルールのデザインを参照してください。

ユーザー定義フィールドが必須であるが、項目の追加に使用する標準設定のスマートビューフォームに新しいユーザー定義フィールドが表示されない場合、ALM Octaneは [他の無効な必須フィールド] セクションで値の入力を要求します。このセクションは、必要な場合のみ表示されます。

トップに戻る

ユーザー定義フィールドの削除

ユーザー定義フィールド (UDF) が必要なくなった場合は、UDFを削除できます。

エンティティで、グリッドでユーザー定義フィールドを選択し、ツールバーで削除ボタン [X] をクリックします。

削除されたフィールドは、次のように処理されます。

エンティティのフォーム	次回フォームを開いたときに、フォームからフィールドがクリアされます。
ルール	警告が表示されます。削除されたフィールドを含むルールはすべて無効で、非アクティブ化されます。
グラフ	削除されたフィールドは、オプションとして使用できなくなります。また、 現在のステータスのグラフの場合、グラフの設定が無効になっていることを示すメッセージが表示されます。必要に応じて既存の設定を変更します。 既存の設定を変更できない場合は、ウィジェットを削除します。 トレンドベースのグラフの場合、フィールドはグラフデータ内に残ります。
フィルター/ グループ化フィルター	フィルターのフィールドがクリアされ、メッセージが表示されます。必要に応じて、(グリッドまたはダッシュボード設定で) フィルターをリセットします。
ソート順序	フィールドがソートからクリアされ、メッセージが表示されます。
グリッド表示	グリッド表示からフィールドがクリアされます。メッセージは表示されません。
お気に入り	お気に入りのフィールドがクリアされます。メッセージは表示されません。

また、フィールドの名前は、サーバーの監査ログ内に残ります。

トップに戻る

フィールド表示ラベルの変更

UDFとシステムフィールドの表示名を変更できます。

フィールドラベルを変更するには、次の手順を実行します。

1. [設定] >スペースで、共有スペースまたはワークスペースを選択します。

2. [エンティティ] > [フィールド] をクリックし、フィールドを選択します。

3. [ラベル] フィールドを変更し、[保存] をクリックします。

トップに戻る

UDFをトレンドとして定義する

UDFをトレンドとして定義して、トレンドウィジェットでUDFによるフィルタリングとグループ化を有効にすることができます。これは、実行とタスクを除くすべてのエンティティで使用できます。

トレンディなUDFを使用する場合は、次の点に注意する必要があります。

• UDFをトレンドとして定義した場合、トレンドなしに戻すことはできません。必要がない場合は、UDFをトレンドとして定義しないことをお勧めします。大量のUDFをトレンドとして設定すると、パフォーマンスに影響があります。

• UDFをトレンドとして定義すると、UDFのトレンド同期ステータスプロパティに同期のステータスが表示されます。これには数分かかる場合があります。同期ジョブはスペースのスコープ内で実行され、スペース内の保留中の新しくトレンド化可能なすべてのUDFを同期します。スペース管理者が一連のUDFにトレンディとして署名できるように、ジョブがトリガーされると10分の遅延が発生します。遅延はUDF_BECOME_TRENDABLE_SYNC_DELAYと呼ばれるサイトパラメーターであり、管理者が変更できます。

• スペース管理者のフィールドタブで、トレンド可能およびトレンド同期ステータスプロパティを確認できます。トレンド可能の定義は、フィールドのダイアログで設定できます (ただし、グリッドでは設定できません)。

• UDFが同じ名前の複数のエンティティサブタイプで定義されている場合、すべてのサブタイプでトレンド可能またはトレンド不可能のいずれかである必要があります。たとえば、my_udfがDefectエンティティとフィーチャーエンティティの両方に追加された場合、両方でトレンド可能であるか、両方でトレンド不可能である必要があります。両方でトレンディではない場合、フィーチャーでトレンディに設定すると、不具合でも自動的にトレンディに設定されます (警告メッセージと承認後)。

トップに戻る

参照情報:

• フォームのデザイン
• ビジネスルールのデザイン
• リストのセットアップ
• エンティティ表示ラベルのカスタマイズ (Enterpriseエディション)