表示価値

レコードページの読み取り専用構成要素:ステータスバッジ、郵便住所、そして電信形式をデコードせずに列の値を読み取る方法。

列の値を読む方法

値を分岐させる(ステータスのティント、フラグ表示、日付の比較など)には、ローカライズされたラベルではなく、列の生の値を読みます。Reactでは、 useColumnValue(columnName) 周囲 RecordContext の列の値を単なるJavaScript型として返し、そこに書式化された文字列と列のメタデータを添えて返します。Blazorでは、 GetValueOrDefault<T>付きでレコードから型付けされた値を読み込みます。いずれにせよ、空欄やカラムセキュリティで保留されている列は nullと読み取られますが、 CanReadColumn が両者を区別します。

React

Blazor

グリッドセルレンダラーやチャートのツールチップなど、RecordContext外では、持っているレコードの@powerportalspro/coreからreadColumnRawValue(record, columnName)を呼び出します。

ステータスバッジ

ColumnStatusBadge レコードのステータス理由(statuscode)を示し、色は状態(statecode)から取られます。アクティブ時はブランドの色合い、それ以外はニュートラルな輪郭線です。色はラベルではなく状態の値から来るため、すべての言語で成立します。ラベルが空または保留されている場合は何もレンダリングされません。

Reactの例

ブレイザーの例

React TypeScript

Razor

Contoso Ltd

Active

Fabrikam, Inc.

Inactive

カスタムトーン

2つ以上の状態を持つテーブルでは、状態の値をバッジの色と外観にマッピングする Tone 関数を渡します。状態が空または保留されていると、この関数は null を受け取ります。

React

Blazor

住所

AddressDisplayValue テーブルのアドレス(address1、 address2など)を <address> 要素で表示し、 ColumnDisplayValueと同じラベルで表示します。ユーザーがDataverseの _composite 列を読むことができるときに表示します。それ以外は、通りの線、次に市、地域、郵便番号、そして国を構成し、国と一致すると省略します HomeCountry。

Reactの例

ブレイザーの例

React TypeScript

Razor

本部

1 Microsoft Way
Building 92
Redmond, WA 98052

支店

70 Wilson Street
London, EC2A 2DB
United Kingdom

反応してください

ブレイザー

ColumnStatusBadge クラス

パラメータ

名称	種類	デフォルト	概要
`IsVisible`	bool	True	バッジは見えるか?
`LabelColumn`	string	statuscode	バッジのテキストがフォーマットされた値の列です。デフォルトはステータスコード、つまりステータスです理由;ステータス理由が読み取れないテーブルには statecode を使用します。
`Size`	BadgeSize?		バッジサイズ。デフォルトはフルエント自身のものです。
`StateColumn`	string	statecode	その値がトーンを決定するカラム。デフォルトは statecodeです。
`Tone`	Func<int?, StatusBadgeTone>?		状態列の値からトーンを選択します — 空の時は `null` 保留。デフォルトは `Nullable{System.Int32})`:アクティブのブランド色合いです (0)でなければ中立の輪郭線。状態が2つ以上あるテーブルに対して1つを提供します。

名称: IsVisible

種類: bool

デフォルト: True

概要: バッジは見えるか?

名称: LabelColumn

種類: string

デフォルト: statuscode

概要: バッジのテキストがフォーマットされた値の列です。デフォルトはステータスコード、つまりステータスです理由;ステータス理由が読み取れないテーブルには statecode を使用します。

名称: Size

種類: BadgeSize?

概要: バッジサイズ。デフォルトはフルエント自身のものです。

名称: StateColumn

種類: string

デフォルト: statecode

概要: その値がトーンを決定するカラム。デフォルトは statecodeです。

名称: Tone

種類: Func<int?, StatusBadgeTone>?

概要: 状態列の値からトーンを選択します — 空の時は null 保留。デフォルトは Nullable{System.Int32}):アクティブのブランド色合いです (0)でなければ中立の輪郭線。状態が2つ以上あるテーブルに対して1つを提供します。

反応してください

ブレイザー

AddressDisplayValue クラス

パラメータ

名称	種類	デフォルト	概要
`Description`	string?		説明はツールチップに表示されます。 {Prefix}にフォールバックします_composite コラムの説明。
`DisplayLabelWhenAvailable`	bool	True	ラベルが表示されるかどうかを指定します。
`DisplayTooltipWhenAvailable`	bool	True	ツールチップが表示されるかどうかを指定します。
`EmptyPlaceholder`	string	—	アドレスが空のときに表示されるテキスト。デフォルトはエムダッシュ(em-dash)です。空文字列をに渡します抑え込む。
`HomeCountry`	string?		国は、例えば「United States」などの構成された住所を、ポータルの代わりに外すべきです住所はほとんどが家庭内です。格やアクセントを無視して比較しました。当てはまりませんアドレスはDataverse独自の合成アドレスであり、Dataverseがフォーマットした際に表示されます。
`IsVisible`	bool	True	住所は見えるか?
`Label`	string?		ラベルとして表示されるテキスト。 {Prefix}_composite 列のラベルに戻る。例:「住所1」などです。
`Prefix`	string	address1	アドレスの列プレフィックス — address1、 address2、またはカスタムアドレスの接頭辞。部分は {Prefix}_line1...3、 _city、 _stateorprovince、 _postalcode、 _country 、 _composite。デフォルトは address1です。

名称: Description

種類: string?

概要: 説明はツールチップに表示されます。 {Prefix}にフォールバックします_composite コラムの説明。

名称: DisplayLabelWhenAvailable

種類: bool

デフォルト: True

概要: ラベルが表示されるかどうかを指定します。

名称: DisplayTooltipWhenAvailable

種類: bool

デフォルト: True

概要: ツールチップが表示されるかどうかを指定します。

名称: EmptyPlaceholder

種類: string

デフォルト: —

概要: アドレスが空のときに表示されるテキスト。デフォルトはエムダッシュ(em-dash)です。空文字列をに渡します抑え込む。

名称: HomeCountry

種類: string?

概要: 国は、例えば「United States」などの構成された住所を、ポータルの代わりに外すべきです住所はほとんどが家庭内です。格やアクセントを無視して比較しました。当てはまりませんアドレスはDataverse独自の合成アドレスであり、Dataverseがフォーマットした際に表示されます。

名称: IsVisible

種類: bool

デフォルト: True

概要: 住所は見えるか?

名称: Label

種類: string?

概要: ラベルとして表示されるテキスト。 {Prefix}_composite 列のラベルに戻る。例:「住所1」などです。

名称: Prefix

種類: string

デフォルト: address1

概要: アドレスの列プレフィックス — address1、 address2、またはカスタムアドレスの接頭辞。部分は {Prefix}_line1...3、 _city、 _stateorprovince、 _postalcode、 _country 、 _composite。デフォルトは address1です。