llms.txt : 機械可読形式のドキュメント索引。このページの Markdown バージョンも利用可能です。

YouTrack サーバー 2026.2 ヘルプ

カスタムフィールド設定

各カスタムフィールドには、フィールドに格納できる値だけでなく、その動作にも影響を与える一連のプロパティがあります。デフォルトのカスタムフィールドでは、これらのプロパティはあらかじめ定義されています。カスタムフィールドを追加する際には、設定でこれらのプロパティを定義します。

フィールドリストタブでこれらのプロパティを設定するとき、カスタムフィールドのデフォルトの動作を設定します。デフォルト値と空の値のプロパティは、プロジェクトごとに個別に設定できます。

単純型の設定

単純型は、データを string、date、period、integer または float として保存します。次の設定を使用して、単純なタイプのフィールドを構成します。

フィールド

説明

フィールド名

カスタムフィールドの名前を格納します。フィールド名に特殊文字 <、>、/ または : を含めることはできません。また、フィールド名に引用符(")を使用しないことをお勧めします。この文字は、ワークフローのプログラミング言語のフィールド名への参照を中断します。フィールド名の単語をオフセットする場合は、代わりに単一引用符(')を使用します。

タイプ

フィールドに格納されるデータのタイプを決定します。

列挙フィールドタイプの場合、タイプはフィールドの作成時に設定され、変更できません。単純型は、同様のデータを格納する別の型に変換できます。詳細については、フィールドタイプの変更を参照してください。

列挙型を選択すると、選択した型を定義する追加の設定が表示されます。詳細については、列挙型の設定を参照してください。

エイリアス

検索クエリおよびコマンドでフィールド名の代わりとして使用できる 1 つ以上のキーワードをフィールドに割り当てます。例: デフォルトの担当者フィールドのエイリアスは for と assigned to です。これにより、Assignee: <your full name> の代わりに for: me を検索クエリとして使用できます。

省略可能

フィールドに空の値を格納できるかどうかを決定します。単純型のフィールドの場合、このオプションは常に有効です。

空の値名

空のフィールドにデフォルトで表示する値を割り当てます。これにより、検索クエリとコマンドで空の値を参照できます。

既存のフィールドを編集するときは、空の値設定を使用してこのプロパティを更新します。

private にする

プライベートフィールドの表示権限を持つユーザーのみに、このフィールドの表示を制限します。詳細については、プライベートおよびパブリックの課題フィールドを参照してください。

列挙型の設定

列挙型には、定義済みの値セットから 1 つ以上の値が格納されます。これらのフィールドは、enum、group、user、ownedField、state、version または build への参照を格納します。次の追加設定を使用して、列挙型のフィールドを構成します。

設定

説明

複数の値

フィールドに複数の値を保存するオプションを有効にします。このオプションは、状態タイプを保存するフィールドでは使用できません。

既存のフィールドを編集するときは、単一値および複数の値を指定できますトグルを使用してこのプロパティを更新します。

値のセット

カスタムフィールドに保存できる値のデフォルトセットを割り当てます。

  • 新しいセット — 空の値のセットを使用してカスタムフィールドを作成します。カスタムフィールドを作成した後、セットに値を追加できます。

  • 既存のセット — 既存の値のセットをフィールドに添付します。既存の値のセットを選択すると、このフィールドに使用するデフォルト値を設定できます。

このオプションは、group タイプを格納するフィールドには表示されません。これらのフィールドでは、可能な値のセットは YouTrack のグループのリストから取得されます。

デフォルト値(複数)

フィールドにデフォルト値を割り当てます。この設定は、既存の値のセットを選択した場合にのみ使用できます。複数の値設定が有効になっている場合、1 つ以上のデフォルト値を選択できます。

省略可能

フィールドに空の値を格納できるかどうかを決定します。このオプションは、デフォルト値が設定されている場合にのみ無効にできます。

既存のフィールドを編集するときは、省略可能および空にできませんトグルを使用してこのプロパティを更新します。

空の値名

空のフィールドにデフォルトで表示する値を割り当てます。これにより、検索クエリとコマンドで空の値を参照できます。省略可能オプションが無効になっている場合、この設定も無効になります。

条件付き設定

カスタムフィールドを表示するための条件は、プロジェクトごとに設定できます。条件設定は、カスタムフィールド設定ページのプロジェクトのフィールドタブでカスタムフィールドを表示または編集する場合にのみ表示されます。

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

設定

説明

以下の時のみ表示:

カスタムフィールドを表示するための条件として使用するフィールドを決定します。選択は、enum、state、ownedField、version または build を格納するカスタムフィールドに制限されます。

以下に設定:

条件付きカスタムフィールドを表示するために、フィールドのどの値を選択する必要があるかを決定します。

これらの設定の詳細については、条件付きカスタムフィールドを参照してください。

2026 年 9 月 17 日

関連ページ:

フィールドタイプの変更

課題フィールドタイプを、同様のデータを格納する別のタイプに変換できます。次のフィールドタイプ変換がサポートされています。データをとして格納するフィールドは、または単一または複数の値を持つ列挙型を格納するように変換できます。フィールドをに変換できます。を保存するフィールドは、を保存するように変換できます。データを、として格納するフィールドの場合、このタイプのセット内でデータをターゲット形式に変換できます。例: タイプをタイプに変換できます。ここでは、整数として格納されている値を時間数または日数に変換...

プライベートおよびパブリックの課題フィールド

YouTrack では、カスタムフィールドを Private としてマークできます。プライバシーは Private フィールドプロパティによって設定され、これはカスタムフィールドの作成時または編集時に設定します。プライベートフィールドの場合、追加の権限セットによって、ユーザーがフィールドを読み取りまたは更新できるかどうかが決まります。フィールドが非公開の場合、ユーザーはプロジェクト内でそれぞれ課題プライベートフィールドの読み取りと課題プライベートフィールドの更新に対する権限を持っている必要があります。パ...

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

各プロジェクトにおいて、特定のカスタムフィールドで値が選択された場合にのみ、そのカスタムフィールドを表示するように設定できます。最も一般的な使用例は、課題の種類ごとに表示するフィールドを選択することです。ただし、課題の種類だけでなく、任意の列挙フィールドでの選択に基づいて特定のフィールドを表示する条件を追加することも可能です。カスタムフィールドを表示する条件は、各プロジェクトで個別に設定できます。管理者は、すべてのプロジェクトのこれらの設定を表示および更新できます。これらの設定にアクセスするには...

カスタムフィールドタイプ

カスタムフィールドタイプとは、フィールドに格納される値に割り当てられるフォーマットのことです。このフォーマットによって、YouTrack がデータをどのように解釈するかが決まります。サポートされているタイプは 2 つのカテゴリに分けられます。単純型 — これらのタイプには、テキスト、期間、日付、日付と時刻、整数、文字列のタイプが含まれます。列挙型 — これらのタイプを使用すると、事前定義されたリストから値を選択できます。単純型:単純型は単一の値を特定の形式で格納します。単一の値を文字列として格納し...

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

状況によっては、デフォルト値を設定せずに特定のフィールドに入力を要求する場合があります。必須フィールドは、レポートの生成に特定のフィールドが重要な場合、または課題のライフサイクル管理に使用される場合に役立ちます。カスタムフィールドの空の値設定は、プロジェクトごとに構成できます。カスタムフィールド設定ページでは、この設定はプロジェクトのフィールドタブからのみ可能です。この設定で選択したオプションによって、選択したプロジェクトで課題が報告された際に、そのフィールドが必須項目となるかどうかが決まります...