ドキュメントの検索
karat

+

K

APIリファレンス ↗
オントロジーオブジェクトおよびリンクタイププロパティAdd value formatting
Feedback

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

値のフォーマットは、プロパティの値に特別なフォーマッターを適用し、生の値をより読みやすいバージョンに変換することを指します。下の画像では、左側(Before)がフォーマットを適用していないweightおよびvalue行を表示しています。右側(After)は、weight行に単位(“kg”)を適用し、value行を通貨記号付きのよりコンパクトな形式(“$100K”)で表示しています。これらは両方とも数値のフォーマットの例です。オントロジーは、日付と時間のフォーマット、ユーザーIDのフォーマット、リソースRIDのフォーマットもサポートしています。

Value formatting example

サポートされている値のフォーマット

タイプ説明
数値のフォーマット通貨/単位/接頭辞、各種の表記法(コンパクト、科学的)、パーセンテージを追加します。詳細は数値のフォーマットセクションを参照してください。
日付と時間のフォーマットタイムスタンプと日付を特定の形式およびタイムゾーンでレンダリングします。
Foundry IDのフォーマットFoundry IDをユーザーの名前と姓、またはグループ名として表示します。
リソースRIDのフォーマットFoundryリソースID(RID)をアイコンとリソース名、そのリソースへのルートとなるクリック可能なリンクとして表示します。

値のフォーマットを追加する

プロパティエディターで:

  1. 値のフォーマットを追加したいプロパティを選択します。
  2. プロパティペインの右側のパネルに、プロパティの基本タイプに応じたフォーマットのタイプ(値のフォーマット、数値のフォーマット、日付と時間のフォーマットなど)が表示されます。フォーマットをオンにします。
Value formatting toggle
  1. 数値のフォーマットと日付と時間のフォーマットでは、以下に説明するように、追加のフォーマットオプションが利用可能です。
  2. 利用可能なフォーマットオプションを選択すると、新しいフォーマットが適用された状態でプロパティの値がどのようにレンダリングされるかのプレビューが表示されます。

数値のフォーマットオプション

Numeric formatting options
名前説明使用法
数値のフォーマットOn/Off トグル。これをトグルして数値のフォーマットを追加/削除します。
基本タイプ利用可能な各種のフォーマット(通貨、単位、パーセンテージ、接頭辞/接尾辞、固定値)および各タイプの例と説明を含みます。もしCapacity in Poundsに関連する単位がある場合、このドロップダウンから"Unit"を選択します。
グルーピングを使用ロケールに応じたカンマ区切りを追加します。これをオンにすると123456から123,456になります。
表記法コンパクト/科学的およびエンジニア表記法を含みます。123Kのように値を近似するためにコンパクトを選択します。
プレビュー結果数値のフォーマットを表示してテストします。フォーマットのプレビューを表示するため、入力にはプロパティの値と似たような任意の数値を追加します。

日付と時間のフォーマットオプション

Date and time formatting options
名前説明
日付日付のみ(時間なし)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

Relative to now

タイムゾーン

タイムスタンプをフォーマットする場合、タイムスタンプをどのタイムゾーンでレンダリングするかを指定できます。これは、入力した静的なタイムゾーン、またはアプリケーションユーザーの現在のタイムゾーンとすることができます。静的なタイムゾーンを入力するときは、UTCオフセットまたはロケール名を入力してタイムゾーンを検索できます。

ユーザーIDのフォーマット

値のフォーマットは、Foundry/MultipassのユーザーIDまたはグループIDである文字列に適用でき、Multipass usernameオプションを選択することでユーザーの名前と姓、またはグループ名に変換して表示できます。この値のフォーマットオプションは、通常、プロパティを編集するActionを作成し、ユーザーIDまたはグループIDをプロパティフィールドの一つに格納する場合に使用されます。バックエンドのデータでは、この情報はユーザーのFoundryユーザーIDまたはグループIDとして格納され、値のフォーマットを適用してIDの代わりにユーザー名またはグループをレンダリングできます。

FAQ

これは既存のタイプクラスと一緒に動作しますか?

値のフォーマットはUIにおける既存のタイプクラスよりも優先されます。両方が設定されている場合、値のフォーマットが表示されます。ただし、あるプロパティには値のフォーマットを使用し、別のプロパティにはタイプクラスを使用することができます。

これはObject Viewsの編集可能なプロパティと一緒に動作しますか?

値のフォーマットは、インライン編集が設定されたプロパティでサポートされています。レガシーのhubble:editableタイプクラスを持つプロパティでは、値のフォーマットが無効になります。