注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
値の書式設定を適用する
値の書式設定とは、プロパティの値に特殊なフォーマッターを適用して、生の値を読みやすい形式に変換することです。下の画像の左側（前）は、書式設定を適用していない weight 列と value 列を示しています。右側（後）では、weight 列に単位（「kg」）が適用され、value 列は通貨記号を付けたコンパクトな形式（「$100K」）で表示されています。どちらも数値の書式設定の例です。オントロジーは、日付と時刻の書式設定に加え、ユーザーID、リソース RID、アーティファクト GID の書式設定もサポートしています。
サポートされている値の書式設定
| 種類 | 説明 |
|---|---|
| 数値の書式設定 | 通貨、単位、接頭辞、さまざまな表記法（コンパクト、科学）、パーセントを適用します。詳細は、数値の書式設定オプションのセクションを参照してください。 |
| 日付と時刻の書式設定 | タイムスタンプと日付を、指定した形式およびタイムゾーンで表示します。 |
| Foundry ID の書式設定 | Foundry ID をユーザーの姓名またはグループ名として表示します。 |
| リソース RID の書式設定 | Foundry リソース ID (RID) をアイコンとリソース名として表示し、そのリソースに移動できるクリック可能なリンクを付けます。 |
| アーティファクト GID の書式設定 | アーティファクトのグローバル ID (GID) をアイコンとアーティファクト名として表示し、そのアーティファクトに移動できるクリック可能なリンクを付けます。 |
値の書式設定を適用する
プロパティエディターで、次の操作を行います。
- 値の書式設定を適用するプロパティを選択します。
- プロパティペインの右側のパネルには、プロパティのベースタイプに応じた書式設定の種類（値の書式設定、数値の書式設定、日付と時刻の書式設定など）が表示されます。書式設定のトグルをオンにします。
- 数値の書式設定と日付と時刻の書式設定では、以下で説明する追加の書式設定オプションを利用できます。
- 利用可能な書式設定オプションを選択すると、新しい書式設定を適用したプロパティの値がどのように表示されるかをプレビューできます。
数値の書式設定オプション
| 名前 | 説明 | 使用方法 |
|---|---|---|
| 数値の書式設定 | オン／オフのトグルです。 | このトグルで数値の書式設定を解除／適用します。 |
| ベースタイプ | 利用可能なさまざまな書式設定の種類（通貨、標準単位、パーセント、接頭辞／接尾辞、固定値）と、それぞれの例および説明が含まれています。 | Capacity in Pounds に関連付けられた単位がある場合は、このドロップダウンから標準単位を選択します。 |
| 桁区切り | ロケールに応じたカンマ区切りを適用します。 | このトグルをオンにすると、123456 が 123,456 になります。 |
| 表記法 | コンパクト、科学、工学の表記法が含まれています。 | 123K のような近似値にするには、コンパクトを選択します。 |
| 小数部の最大桁数 | 小数点以下に表示する最大桁数です。小数部の桁数がこれより多い値は、この桁数に丸められます。 | 3.14159 を 3.14 と表示するには、2 に設定します。 |
| 小数部の最小桁数 | 小数点以下に表示する最小桁数です。桁数がこれより少ない値は、末尾にゼロが追加されます。 | 3.5 を 3.50 と表示するには、2 に設定します。 |
| 有効数字の最大桁数／最小桁数 | 最初のゼロ以外の数字から数えた、表示する有効数字の最大桁数と最小桁数です。 | 3.14159 を 3.14 と表示するには、有効数字の最大桁数を 3 に設定します。 |
| 整数部の最小桁数 | 小数点より前に表示する最小桁数です。不足する桁は先頭にゼロを追加して埋めます。 | 5 を 05 と表示するには、2 に設定します。 |
| プレビュー結果 | 数値の書式設定を表示してテストします。 | プロパティの値として想定されるものに近い任意の数値を入力欄に入力して、書式設定をプレビューします。 |
日付と時刻の書式設定オプション
| 名前 | 説明 | 例 |
|---|---|---|
| 日付 | 日付のみ（時刻なし） | Wed, Jul 22, 2020 |
| 日付と時刻 | 日付と時刻の両方を長い形式で表示 | Wed, July 22, 2020, 1:00:00 PM |
| 日付と時刻（短縮形） | 日付と時刻の両方を短い形式で表示 | Jul 22, 2020, 1:00 PM |
| ISO インスタント | 日付と時刻の両方（ISO 8601 形式） | 2020-07-22T13:00:00.000Z |
| 現在からの相対表示 | 現在を基準とした相対的な日付 | 8 minutes ago |
| 時刻 | 時刻のみ（日付なし） | 1:00 pm |
現在からの相対表示で書式設定する場合、アプリケーションは24時間前までの値のみを相対的に表示します。それより前の値は、曜日を含む日付と時刻（短縮形） の形式で表示されます。例：Wed, Jul 22, 2020, 1:00 PM。
タイムゾーン
タイムスタンプを書式設定する場合、表示に使用するタイムゾーンを指定できます。入力した固定のタイムゾーン、またはアプリケーションユーザーの現在のタイムゾーンを使用できます。固定のタイムゾーンを入力する際は、UTC オフセットまたはロケール名を入力してタイムゾーンを検索できます。
ユーザーIDの書式設定
Foundry/Multipass のユーザーIDまたはグループIDである文字列に値の書式設定を適用し、ユーザー名またはグループ名の選択肢を選択すると、ユーザーの姓名またはグループ名を表示するように変換できます。この値の書式設定オプションは通常、プロパティを編集し、プロパティのいずれかのフィールドにユーザーIDまたはグループIDを保存するアクションを作成した場合に使用します。元データでは、この情報はユーザーの Foundry ユーザーIDまたはグループIDとして保存されます。値の書式設定を適用すると、ID の代わりにユーザー名またはグループを表示できます。
FAQ
既存のタイプクラスと併用できますか？
UI では、値の書式設定が既存のタイプクラスより優先されます。両方を設定している場合は、値の書式設定が表示されます。ただし、あるプロパティには値の書式設定を使用し、別のプロパティにはタイプクラスを使用することはできます。
Object View の編集可能なプロパティで使用できますか？
値の書式設定は、インライン編集が設定されたプロパティでサポートされています。レガシーの hubble:editable タイプクラスを持つプロパティでは、値の書式設定が無効になります。