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

カスタムフィールドタイプとは、フィールドに格納される値に割り当てられるフォーマットのことです。このフォーマットによって、YouTrack がデータをどのように解釈するかが決まります。

サポートされているタイプは 2 つのカテゴリに分けられます。

単純型 — これらのタイプには、テキスト、期間、日付、日付と時刻、整数、文字列のタイプが含まれます。
列挙型 — これらのタイプを使用すると、事前定義されたリストから値を選択できます。

単純型

単純型は単一の値を特定の形式で格納します。

フィールドタイプ	説明
`string`	単一の値を文字列として格納します。文字列型フィールドは、フィールドに入力された値が URL であるかどうかを自動的に認識します。文字列を格納するフィールドに Web アドレスを入力すると、YouTrack はフィールドの値の横に特別なアイコンを表示します。ユーザーはこのアイコンをクリックして、新しいブラウザータブでターゲットリンクを開くことができます。
`text`	課題に表示される際に Markdown 構文で解釈される文字列を格納します。このタイプのフィールドは、他のカスタムフィールドとともにサイドバーには表示されません。代わりに、課題の説明のすぐ下に表示されます。課題の概要や説明と同様に、テキストベースのフィールドの値は、課題が作成モードまたは編集モードで開いている場合にのみ変更できます。これらのフィールドを編集すると、入力のプレビューが Markdown でフォーマットされた状態で表示されます。
`date`	単一の値を日付形式で保存します。ユーザーは、カレンダーコントロールで日付を選択して値を設定および変更します。日付は、現在のユーザーがプロファイルページの日付形式設定で選択した形式で表示されます。
`date and time`	単一の値を日付形式で保存します。完全な日付と時刻は、カスタムフィールドに表示されます。ユーザーは入力フィールドで値を設定および変更します。日付と時刻は、現在のユーザーがプロファイルページの日付形式設定で選択した形式で表示されます。
`period`	期間を表す値を格納します。期間タイプとしてデータを格納するフィールドは、タイムトラッキングに使用されます。
`integer`	単一の値を整数として格納します。
`float`	単一の値を浮動小数点数として格納します。

列挙型

列挙型は、定義済みの一連の値から 1 つ以上の値を格納します。これらのタイプの多くでは、セット内の各値に追加のプロパティを割り当てることができます。詳しくは、値固有の設定を参照してください。

state 型を格納するフィールドは単一値のみを格納できます。単一または複数の値を格納するために他の列挙型のいずれかを構成できます。

フィールドタイプ	説明
`enum`	定義済みの一連の値から値を格納します。このタイプのフィールドの値のセットは、`string` タイプとして保管されている任意の値の配列です。
`group`	グループへの参照を格納します。格納可能な値のセットは、YouTrack のグループリストから取得されます。カスタムフィールドにはグループ名が表示されます。グループへのアクセスは、グループレベルの表示設定によって制限されており、読書グループ機能が有効になっているグループのメンバー、またはプロジェクトの更新もしくは低レベルの管理者読み取りの権限を持つユーザーのみが利用できます。
`user`	ユーザーアカウントへの参照を格納します。デフォルトの担当者フィールドはこのタイプを使用します。可能な値のセットは、YouTrack のユーザーのリストから取得されます。カスタムフィールドにはフルネームが表示されます。ドロップダウンリストには、ユーザー名も表示されます。使用可能なユーザーのリストは、読み取り（ユーザー）許可の割り当てに基づいています。
`ownedField`	定義済みの一連の値から値を格納します。デフォルトのサブシステムフィールドはこのタイプを使用します。このタイプは `enum` タイプと似ていますが、値のセット内の各値に `owner` が格納されている点が異なります。このプロパティは、サブシステムを担当するユーザーへの参照を `user` 型として格納します。
`state`	事前定義された一連の issue 状態から issue の状態を保存します。このタイプも `enum` タイプのバリエーションです。ここでは、値のセット内の各値に `isResolved` プロパティがあります。このプロパティは、このフィールドに対応する値が割り当てられたときに課題が解決されたと見なされるかどうかを示します。この値は `Boolean` 型として格納されています。このタイプの詳細については、複数の状態タイプフィールドとの競合の可能性を参照してください。
`version`	定義済みのバージョンリストからバージョンを保存します。バージョンのセットの各値には、次の情報が格納されます。 `releaseDate` — リリース日を `date` タイプとして格納します。実際のリリース日または予定されているリリース日に対応できます。 `released` — バージョンがリリースされ、`Boolean` タイプとして保存されているかどうかを示します。 `archived` — バージョンがアーカイブされているかどうか、`Boolean` タイプとして保存されているかどうかを示します。バージョンにアーカイブ済みのフラグが付けられている場合、カスタムフィールドの値のリストには表示されなくなります。これは、値を選択してフィールドに追加したり、値を選択してフィールドから削除したりできないことを意味します。アーカイブバージョンは、コマンド、ワークフロー、REST API で引き続き使用できます。つまり、コマンドを使用して、アーカイブされた値を追加または削除したり、プログラムでこれらの値を更新したりできます。
`build`	事前定義されたビルド番号のセットからビルド番号を保管します。一連のビルドの各値には `assembleDate` が格納されています。このプロパティは、選択されたビルドが `date` タイプとしてアセンブルされた日付を格納します。

複数の状態タイプフィールドとの競合の可能性

プロジェクトに state 型を使用する複数のカスタムフィールドを追加すると、望ましくない結果が生じる可能性があります。あなたの課題は、すべての state-type フィールドに解決されると考えられる値が割り当てられるまで解決されません。ユーザーにこの要件について知らされていない限り、混乱が生じます。課題を解決するために 1 つの状態フィールドの値を更新しても、課題の視覚的表示は変わりません。解決された課題で予想されるように、課題 ID の取り消し線付きテキストで淡色表示されません。

そのため、プロジェクト内で複数の状態フィールドを使用することは強くお勧めしません。

プロジェクトに課題を作成する前にこの警告を読んでも運が悪かったとしても、まだ望みはあります。次の解決策は、チームを煩わせることなく、必要な機能を手に入れるのに役立ちます。

最も簡単な回避策は、すべての追加の状態タイプフィールドのすべての値を解決済みとしてマークすることです。ユーザーは、単一のカスタムフィールドの値を管理するだけで、課題が解決したかどうかを判断できます。
推奨される解決策は、追加の状態型フィールドを、一般的な列挙型を使用するフィールドに変換することです。これにより、解決された状態が単一のカスタムフィールドの値に依存するようになります。
フィールドタイプの変更の詳細については、フィールドタイプの変更を参照してください。

これらの解決策のいずれかで課題を解決できない場合があります。例: 追加の状態フィールドが唯一の状態タイプフィールドである他のプロジェクトと共有されている場合、これらのプロジェクトの課題で課題が発生します。この場合、現在追加の状態タイプフィールドに格納されている値を、データを別のタイプとして格納する新しいフィールドに移行することを検討してください。

値を別のフィールドに移行するには:

メインナビゲーションメニューから、管理> カスタムフィールドを選択します。
追加の状態型カスタムフィールドを含むプロジェクトを探します。
フィールドをプロジェクトに追加ボタンをクリックしてください。
設定を使用して、enum タイプを格納するカスタムフィールドを定義します。
追加の状態型カスタムフィールドの 1 つで使用されているものと同じ値を新しいカスタムフィールドに追加します。
終了したら、プロジェクトのカスタムフィールドに保存されている値を更新します。
- 課題リストから、状態タイプのカスタムフィールドに特定の値を含むすべての課題を検索する検索クエリを入力します。セットの最初の値から始めます。例: In #{Project} Status: Submitted
- 検索クエリによって返されるすべての課題を選択します。クエリによって返されるすべての課題を選択するには、キーボードショートカット Ctrl + A を使用します。
- 検索クエリによって返されるすべての課題を選択します。クエリによって返されるすべての課題を選択するには、キーボードショートカット⌘ + A を使用します。
- コマンドを使用して、選択したすべての課題を更新し、新しい列挙型カスタムフィールドに同じ値を割り当てます。例: Secondary State Submitted 通知スパムを最小限に抑えるため、通知を送信せずにコマンドを実行してください。
- 状態タイプカスタムフィールドに格納されたすべての値を新しい列挙カスタムフィールドに追加するまで、この手順を繰り返します。
管理> カスタムフィールドページに戻り、プロジェクトから余分な状態タイプのカスタムフィールドを削除します。
- フィールドとそれに関連する値がプロジェクトから削除されます。
- 以前にこのカスタムフィールドに格納されていたすべての値は、列挙されたカスタムフィールドに格納されるようになりました。
プロジェクト内の余分な状態タイプフィールドをすべて置き換えるまで、この手順を繰り返します。

2026 年 9 月 17 日

関連ページ：

値固有の設定

値の列挙セットには、セット内の各値に割り当てられるプロパティがあります。列挙値のセットのプロパティの標準セットを編集できます。これらの設定を表示するには、セット内の値の横にある編集アイコンをクリックします。基本設定：次の設定は、すべてのフィールドタイプで使用できます。名前値に名前を割り当てます。説明値の説明を追加します。この情報は、課題のフィールドで対応する値が選択されたときに、情報ツールチップに表示されます。色値にカラースキームを割り当てます。この設定により、現在の値に割り当てられた色に基づ

フィールドタイプの変更

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

デフォルトのカスタムフィールド

YouTrack のすべての新しいプロジェクトには、一連のデフォルトのカスタムフィールドがアタッチされています。これらのフィールドには、ソフトウェア開発で一般的に使用される属性とプロパティが含まれています。YouTrack を使用してソフトウェア開発プロジェクトを管理する場合、これらのフィールドをすぐに使用して作業を開始できます。他の種類のプロジェクトの場合、内部ワークフローをサポートするために、新しいカスタムフィールドを追加したり、デフォルトフィールドを変更したりできます。詳細については、カス...

カスタムフィールド設定

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