カスタムフィールドを管理する

新しいカスタムフィールドを追加する

プロジェクト管理者は、プロジェクトの課題に新しいフィールドを追加できます。

プロジェクトにフィールドを追加すると、システム内の他のプロジェクトでカスタムフィールドを使用できます。グローバルプロジェクト管理権限を持つシステム管理者またはユーザーは、このフィールドを他のプロジェクトで再利用できます。列挙型カスタムフィールドの場合、使用可能な値のセットは、プロジェクトごとに個別に管理できます。

カスタムフィールドを作成するときは、フィールドに格納されている値に割り当てるフィールドタイプを必ず設定してください。ほとんどのフィールドタイプでは、フィールドの作成時にタイプが設定され、変更できません。あるデータ型から別のデータ型に値を変換することは、時間と労力を要する手動プロセスです。詳細については、フィールドタイプの変更を参照してください。

既存のカスタムフィールドを追加する

プロジェクト内の課題に既存のフィールドを使用する場合は、そのフィールドをプロジェクトにアタッチできます。その後、そのフィールドを使用する他のプロジェクトと同期を維持するか、独立して管理されるコピーを作成するか決定できます。

カスタムフィールドを削除する

プロジェクトに使用しない、または必要のないフィールドがある場合は、削除できます。

プライベートカスタムフィールド

プロジェクトでカスタムフィールドをプライベートまたはパブリックにすることで、そのカスタムフィールドの可用性を管理できます。カスタムフィールドがプライベートとしてマークされている場合、プロジェクトで課題プライベートフィールドの読み取りまたは課題プライベートフィールドの更新権限を持つユーザーのみがそれぞれフィールドを表示または編集できます。

フィールドがパブリックである場合、プロジェクトで読み取り課題または更新の課題権限を持つユーザーはフィールドを表示または編集できます。

この機能は、次の方法でプロジェクト内のデータへのアクセスを制限できます。

• 個人データなどの機密情報を保存するフィールドを非表示にします。

• フィールドの値を編集できるユーザーの数を制限します。例: ユーザーが現在の担当者を表示できるようにプロジェクトでアクセスを構成できますが、マネージャーのみが課題を再割り当てできます。

プライベートフィールドは「オールオアナッシング」ソリューションです。ユーザーがプロジェクトの 1 つのプライベートフィールドを表示および更新する権限を持っている場合、同じプロジェクトの他のプライベートフィールドの値を表示および更新することを妨げるものはありません。

プロジェクト内のさまざまなフィールドに対してフィールドデータを個別に表示および更新するための要件を設定する場合は、詳細設定を使用します。詳細については、ss グループベースのフィールドの可視性を参照してください。

優先度および期限日のカスタムフィールドは、デフォルトでプライベートとしてマークされています。プロジェクトのすべてのユーザーがこれらのフィールドを使用できるようにする場合は、フィールドを選択して、ツールバーの public にするボタンをクリックします。

グループベースのフィールドの可視性

カスタムフィールドの詳細設定は、特定のグループおよびチームのメンバーに対してフィールド値の表示または更新の権限を制限します。これらの設定により、プライバシー設定に依存したり複雑なワークフローを記述したりすることなく、特定のフィールドにきめ細かい制限を適用できます。

グループベースの可視性オプションを使用すると、プロジェクト内の各フィールドに対して個別にフィールドデータを表示および更新するための要件を設定できます。これらの設定の詳細については、詳細設定を参照してください。

ここに示した例では、優先度、状態、担当者フィールドは非公開としてマークされています。このプロジェクトの非公開フィールドは登録ユーザーには表示されますが、更新できるのはプロジェクトチームのメンバーのみです。

タイプなど、プロジェクトの別のフィールドの制限を微調整する場合は、グループベースの可視性設定を使用できます。これらの設定により、プロジェクトチームのメンバーではないユーザーにもフィールド値を更新する機能を提供しながら、登録済みユーザーの可視性を維持できます。

必須のカスタムフィールド

プロジェクトごとにカスタムフィールドの空の値設定を構成できます。この設定で選択するオプションにより、プロジェクトで課題が報告されたときにフィールドが必要かどうかが決まります。

• 単純型（string、date、period、integer または float）を保管するフィールドの場合、空の値オプションが空にできませんに設定されている場合、フィールドは必須です。

  

• 列挙型を格納するフィールドの場合、空の値オプションが空にできませんに設定され、デフォルト値オプションが値なし（必須）に設定されている場合、このフィールドは必須です。

  

ユーザーがプロジェクトの課題を報告すると、必須フィールドが表示され、入力フィールドにメッセージ値の設定が表示されます。

プロジェクトにフィールドが必要になる前に、次の結果を考慮してください。

• プライベートフィールドも手動で入力する必要がある場合、プライベートフィールドの読み取りと更新の権限を持たないユーザーは、プロジェクトで課題を作成できなくなります。

• 条件に基づいて表示されるフィールドを取得し、それを必須フィールドとして設定した場合、そのフィールドは、フィールドを表示するための条件が満たされた場合にのみ必要になります。

• フィールドの要件は、新しい課題が報告されたとき、またはユーザーが必須フィールドを直接編集したときにのみチェックされます。ユーザーが課題を別のプロジェクトに移動すると、新しいプロジェクトで必要なフィールドは空のままになります。

条件付きカスタムフィールド

各プロジェクトでは、別のカスタムフィールドで値が選択されている場合にのみ、特定のカスタムフィールドを表示することができます。最も一般的な使用例は、さまざまな課題タイプに対して表示するフィールドを選択することです。ただし、課題の種類だけでなく、列挙フィールドの選択に基づいて特定のフィールドを表示する条件を追加できます。

プロジェクト内の任意のフィールドに条件を追加できます。条件付きカスタムフィールドには、次の制限があります。

• enum、state、ownedField、version または build を格納するカスタムフィールドでの選択に基づいて、カスタムフィールドを表示するための条件のみを設定できます。

• 連鎖した依存関係を設定することはできません。これは、カスタムフィールドの表示設定を複数レベルの条件に依存させることはできないことを意味します。

カスタムフィールドを表示するための条件を追加する前に、次の結果を考慮してください。

• 条件の背後に隠されているフィールドは、値を永続的に保存しません。つまり、機密情報を隠すためだけにこの機能を使用することはできません。個人データやその他の機密情報を保存するフィールドへのアクセスを制限する場合は、代わりにプライベートフィールドを使用してください。詳細については、プライベートおよびパブリックの課題フィールドを参照してください。

• カスタムフィールドが条件の背後に隠れている場合、ワークフローでフィールドの値を設定することはできません。ワークフローを使用して条件付きカスタムフィールドの値を管理する場合、非表示のフィールドがワークフローで更新されないようにしてください。ワークフローをカスタマイズして、変更が適用される前に条件を確認できます。

• さまざまな課題のデータをすでに格納しているフィールドを非表示にしている場合、既存の値はすぐには削除されません。非表示にするフィールドの値を含む課題をチェックし、非表示にする条件として使用するフィールドの値を確認することをお勧めします。次に、条件を設定した後、フィールドから非表示の値をクリアしても安全だと思うかどうかを検討します。

  詳細は、隠し値をクリアするを参照してください。

隠し値をクリアする

さまざまな課題のデータがすでに格納されているフィールドを非表示にする条件を設定すると、既存の値はすぐにはクリアされません。値は、ユーザーが条件に使用されるフィールドの値を、非表示のフィールドを表示しない値に変更するまで保存されます。これは、フィールドを非表示にする条件を設定するときに偶発的なデータ損失を防ぐために行われます。

その結果、非表示の値は保存されているが表示されないという課題が発生する可能性があります。

• 値が課題自体に表示されていない場合でも、非表示フィールドを参照する検索結果に課題が表示されます。

• 非表示の値が状態の場合、まだ表示されている状態フィールドが解決済みの値に設定されていても、未解決の課題が発生する可能性があります。

条件を設定する前に、非表示にするフィールドの値が含まれている課題を確認し、非表示にする条件として使用するフィールドの値を確認することをお勧めします。これらの値を確認する最も効果的な方法は、has 属性を使用して、非表示にするフィールドに現在値を格納している課題を検索し、条件として使用する値を格納する課題を除外するようにクエリを変更することです。フィールドを非表示にします。例: タイプフィールドの値がバグである課題でのみ、ブラウザーフィールドを表示する場合は、次の検索クエリを使用します。

検索結果には、ブラウザーフィールドに値を格納するバグとして分類されていないすべての課題が表示されます。これは、条件を設定した後にフィールドから非表示の値をクリアしても安全かどうかを判断できます。

これらの非表示の値がセットアップ中にクリアされない場合、検索結果に予期しない課題が含まれたり、未解決として表示されたりする課題が発生する可能性があります。条件によって非表示になっているフィールドに格納されている値に関連する一貫性のない動作が発生した場合は、非表示の値をクリアするオプションを使用して課題を解決してください。

別のフィールドに基づいてフィールド値をフィルタリングする

プロジェクトのカスタムフィールドの詳細設定セクションで設定できるもう 1 つのオプションは、プロジェクト内の別のフィールドの値に基づいて値をフィルタリングする機能です。これは、地域や場所別にフィルタリングされた担当者リストを表示するなど、依存関係のあるフィールドで特に便利です。

たとえば、オフィスフィールドで選択した値に基づいて、担当者フィールドで使用可能な値のリストをフィルタリングすることができます。

ここに示す例では、担当者フィールドで使用可能な値のセットは、オフィスフィールドで選択した値に基づいて変化します。オフィスフィールドに値を設定すると、プロジェクト設定で定義された条件に基づいて、担当者フィールドで使用可能な値のリストが制限されます。

オフィスフィールドの値を更新すると、それに応じて担当者の可能な値のリストも変更されます。

ユーザーが依存フィールド（この例では担当者）で現在のフィルタリング条件に一致しない値を選択した場合、システムは依存フィールドの値を自動的にクリアします。この動作により、プロジェクトに定義された制約内で、フィールド値の一貫性と有効性が維持されます。混乱を避けるため、フィルタリングの依存関係についてチームの他のメンバーに伝え、フィールドが予期せずクリアされる理由を理解してもらうようにしてください。

プロジェクトレベルでフィールドの順序を変更する

課題リストおよび単一課題ビューにフィールドが表示されるデフォルトの順序は、管理者によってグローバルレベルで設定されます。フィールドの順序を変更したい場合は、プロジェクトにカスタム順序を設定できます。プロジェクトレベルの設定はグローバル設定をオーバーライドします。

値のセットを編集する

フィールドで使用される値のセットを編集できます。

フィールドの値を変更できる場合はいつでも、新しい値をセットに追加するオプションがあります。プロジェクト管理者は、プロジェクトに固有のフィールドに値を追加したり、独立した値のセットを使用したりできます。システム管理者およびグローバルプロジェクトのプロジェクト管理者アクセス権を持つユーザーは、すべてのプロジェクトのセットに値を追加できます。作成されると、新しい値が課題に追加されます。このオプションは、次の場所に表示されます。

• 課題リスト

• 単一課題ビュー

• アジャイルボード

値のセットが他のプロジェクトと共有されている場合、セットの独立したコピーを作成し、プロジェクトのフィールドの値を編集できます。

セット内の値を並べ替える

デフォルトでは、セット内の値は、フィールドに追加された順に手動で並べられます。手動で並べ替えると、各値にはリスト内の位置を表す序数値が割り当てられます。

ソート順は、YouTrack の次の動作に影響します。

• カスタムフィールドのドロップダウンリストに表示される値は、指定された並べ替え順序で表示されます。例: デフォルトの優先度フィールドの値は、最高から最低まで手動でソートされます。最高の優先順位（ショーストッパー）を表す値がリストの上部に表示されます。

  

• 値の範囲を指定する検索クエリでは、並べ替え順序により、検索要求に一致する値が決まります。例: Priority: Show-stopper .. Major を含む検索要求は、ショーストッパー、クリティカル、メジャーである課題を返します。

プロジェクト管理者は、プロジェクトで使用されるフィールドの値の並べ替え順序を決定できます。システム管理者は、複数のプロジェクトで使用されるフィールドのグローバルレベルで並べ替え順序を設定できます。詳細については、セット内の値を並べ替えるを参照してください。

プロジェクト設定にあるカスタムフィールドページで、カスタムフィールドの値を並べ替えることができます。並べ替えオプションは、user 型または group 型を格納するフィールドを除き、列挙型を格納するすべてのフィールドで利用できます。

• user タイプを格納するフィールドの場合、値はフルネームでアルファベット順に自動的にソートされ、現在のユーザーがリストの一番上に表示されます。

• group タイプを格納するフィールドの場合、値は名前のアルファベット順にソートされます。

セット内の値をアーカイブする

列挙セットの値を保存するほとんどのフィールドには、特定の値をアーカイブするオプションがあります。いったんアーカイブされると、ユーザーはユーザーインターフェースでフィールドの値をこの値に直接設定できなくなります。

課題のアーカイブされた値を操作する方法の詳細については、アーカイブされた値の使用を参照してください。

後で特定の値での作業を続行することに決めた場合、アーカイブを解除コントロールをクリックして、この操作を元に戻すことができます。

一貫した値のセットをチェックする

非常に稀ですが、特定のプロジェクトのフィールドで使用される値のセットが不整合になることがあります。これは、値のリストを更新する操作が、予期せぬサーバーのシャットダウンやその他の接続切断によって中断された場合に発生する可能性があります。

このような場合、単一のプロジェクトに属する課題は、同じカスタムフィールドに別々の値のセットを使用します。これにより、次の 1 つ以上の課題が発生する可能性があります。

• 指定されたフィールドに一致する値を格納する課題を返す必要がある検索結果は、部分的な結果のみを返します。

• 複数の課題を更新するコマンドが選択範囲全体に適用されません。

ユーザーがこのような奇妙な動作に遭遇した場合は、迅速な整合性チェックを実行して課題を修復できます。

データを新しいフィールドに転送する

プロジェクト管理者は、プロジェクトの更新権限を持っているプロジェクトで排他的に使用されるフィールドのみを更新できます。自動アタッチまたは他のプロジェクトで使用されるカスタムフィールドの場合、フィールドの基本プロパティを編集できないことがあります。これには、フィールド名、フィールドが単一の値を格納するか複数の値を格納するかを決定するフィールドタイプのプロパティ、およびフィールドエイリアスへの変更が含まれます。これらの基本プロパティへの変更は、フィールドを使用するすべてのプロジェクトに影響します。

別の方法として、プロジェクトのこのフィールドに現在保存されているデータを保存して、新しいフィールドに転送することもできます。データを新しいフィールドに転送するときは、元のフィールドのコピーを基本プロパティとともに作成し、一意の名前を割り当てます。その後、他のプロジェクトで元のフィールドの使用に影響を与えることなく、フィールドの基本プロパティを編集できます。

新しいフィールドは、プロジェクトの元のフィールドの代わりに使用されます。フィールドの値のセットと、プロジェクトの各課題に割り当てられる値は変更されません。

データを新しいフィールドに転送する操作は、次の条件のいずれかを満たすカスタムフィールドでのみ使用できます。

• 自動割り当てオプションは、フィールドに対して有効になっています。

• フィールドは 2 つ以上のプロジェクトで使用されます。

カスタムフィールドを置き換える

プロジェクトで使用されているカスタムフィールドを、他のプロジェクトで使用されているカスタムフィールドに置き換えることができます。プロジェクトで設定されているカスタムフィールドの代わりに使用したい他のプロジェクトで使用されているカスタムフィールドがある場合は、この機能を使用します。たとえば、同じカスタムフィールドを使用して、レポートを生成したり、アジャイルボード上のすべてのプロジェクトに対して同じ列とスイムレーンを表示したりできます。

残念ながら、置換関数は、同じデータ型を共有するカスタムフィールドでのみ使用できます。あるデータ型から別のデータ型に値を変換するには、目的の型で新しいカスタムフィールドを作成し、プロジェクト内のすべての課題の新しいフィールドの値を手動で更新する必要があります。詳細については、フィールドタイプの変更を参照してください。

フィールドタイプの変更

課題フィールドタイプを、同様のデータを格納する別のタイプに変換できます。次のフィールドタイプ変換がサポートされています。

• データを string として格納するフィールドは、text または単一または複数の値を持つ列挙型を格納するように変換できます。

• text フィールドを string に変換できます。

• date を保存するフィールドは、date and time を保存するように変換できます。

• データを integer、period、float として格納するフィールドの場合、このタイプのセット内でデータをターゲット形式に変換できます。例: integer タイプを period タイプに変換できます。ここでは、整数として格納されている値を時間数または日数に変換するオプションがあります。

• 単一の値をサポートする列挙型を string または単一の値を持つ別の列挙型（enum[1]、build[1]、ownedField[1]、state[1]、version[1]）に変換できます。

• 複数の値をサポートする列挙型を string または複数の値を持つ別の列挙型（enum[*]、build[*]、ownedField[*]、version[*]）に変換できます。

データが失われる場合がいくつかあります。例: enum タイプ（または build や version などの他の疑似列挙型）を格納するフィールドがあり、それを文字列に変換する場合、列挙値はコンマ区切りの文字列に変換されます。型を列挙型に戻す場合、変換された文字列のいずれにも含まれていない以前の列挙は、フィールドの値のセットに復元されません。列挙セットの特定の値に割り当てられた色分けは、変換中に失われます。リリース日やアーカイブ日（バージョンの場合）などの他の二次プロパティも破棄されます。

次の条件のいずれかが存在する場合、フィールドタイプを変更することはできません。

• このフィールドは、アジャイルボード上の列を識別します。

• フィールドは、アジャイルボード上のスイムレーンを識別します。

• フィールドは、アジャイルボード上のスプリントにリンクされています。

• フィールドは、ビルドサーバー統合設定でマップされます。

既存のカスタムフィールドを別のタイプを使用するフィールドに置き換える場合、置換操作は使用できません。代わりに、目的のタイプの値をプロジェクトに保存するカスタムフィールドをプロジェクトに追加し、元のフィールドからデータを手動で移行する必要があります。

カスタムフィールド設定

次の設定を使用して、単純なデータ型のフィールドを構成します。

これらの追加設定を使用して、列挙データ型のフィールドを構成します。

値固有の設定

値の列挙セットには、セット内の各値に割り当てられるプロパティがあります。列挙値のセットのプロパティの標準セットを編集できます。

これらの設定を表示するには、セット内の値の横にある 編集アイコンをクリックします。次の設定は、すべてのフィールドタイプで使用できます。

いくつかのフィールドタイプには、セット内の値の拡張プロパティがあります。これらのプロパティは、指定したタイプに使用される値のセットを編集する場合にのみ表示されます。

詳細設定

次の設定を使用して、カスタムフィールドを表示または編集する機能を特定のユーザーグループに制限します。

次の設定を使用して、プロジェクトにカスタムフィールドを表示するための条件を設定します。

バージョンフィールドの追加コントロール

version タイプを格納するフィールドの値のセットを表示または編集する場合、これらのコントロールを使用して特定の値を検索および更新できます。これらのオプションはカスタムフィールドの動作には影響しません。