フィードバック

Format 列と FormatName 列

  • [アーティクル]

Format と FormatName は、フォーマット値を格納し、コンテンツの表示方法を知るためにコントロールと UI が使用する列です。

Format は、Microsoft Dataverse が使用する値を格納する古い方の列です。 下位互換性を維持するために、新しい形式を導入できませんでした。 このため、一部の API 応答は新しい形式と一致しません。 Text と Multiline Text 列の場合、FormatName 列を使用することをお勧めします。

FormatName は、Text と Multiline Text 列のデータ型に形式を指定するために使用する新しい列です。 FormatName 列では、選択した形式に対してより正確に応答し、新しい形式タイプをサポートします。

API 動作

  • 作成 操作で、受信ペイロードに Format と FormatName 両方の情報が含まれている場合、FormatName 値が最初に考慮されます。 ペイロードに値が 1 つしかない場合、システムはペイロードに存在するものをすべて考慮します。

  • 取得 操作では、互換性に基づいた Format と FormatName API 応答で使用される、定義された形式のデータ型の値が異なる場合があります。 たとえば、RichText 形式に設定されたテキスト列は次を返します。

    • フォーマット: 'テキスト'
    • FormatName: 'RichText'。
    • 取得操作は、値を既定に変更することで、データ型に存在する互換性のない Format または FormatName 値を修正します。 たとえば、テキスト列が Dataverse で 日付のみ に変更された場合、取得操作が形式を次の値に修正します。
      • フォーマット: 'テキスト'
      • FormatName: 'テキスト'。

  • アップデート 操作で、システムは FormatName 値のみを考慮します。 たとえ FormatName 値が存在しないとしても、Format に値は、考慮されていません。

次のテーブルには、各タイプの Format 値と FormatName 値、および API 応答が表示されます。

列の種類 プラットフォーム フォーマット / ソリューション XML の価値 Format SDK 定義 FormatName SDK 定義 API 応答値 意見
テキスト テキスト StringFormat.Text StringFormatName.Text 形式: テキスト
FormatName: テキスト		 文字列の列の既定形式値。
メール StringFormat.Email StringFormatName.Email 形式: メール
FormatName: メール
テキスト領域 StringFormat.TextArea StringFormatName.TextArea 形式: TextArea
FormatName: TextArea
URL StringFormat.Url StringFormatName.Url 形式: URL
FormatName: URL
株式銘柄コード StringFormat.TickerSymbol StringFormatName.TickerSymbol 形式: TickerSymbol
FormatName: TickerSymbol
バージョン番号 StringFormat.VersionNumber StringFormatName.VersionNumber 形式: VersionNumber
FormatName: VersionNumber
電話番号 StringFormat.Phone StringFormatName.Phone 形式: テキスト
FormatName: 電話
JSON StringFormat.Json StringFormatName.Json 形式: テキスト
FormatName: Json
リッチ テキスト StringFormat.RichText MemoFormatName.RichText 形式: テキスト
FormatName: RichText		 SQL 以外のデータ プロバイダーにのみ許可されます。
メモ/複数行テキスト テキスト StringFormat.Text MemoFormatName.Text 形式: テキスト
FormatName: テキスト		 メモ/複数行列の既定形式値。
メール StringFormat.Email MemoFormatName.Email 形式: メール
FormatName: メール
テキスト領域 StringFormat.TextArea MemoFormatName.TextArea 形式: TextArea
FormatName: TextArea
InternalExtentdata StringFormat.Te StringFormatName.Text 形式: テキスト
FormatName: テキスト
JSON StringFormat.Json MemoFormatName.Json 形式: テキスト
FormatName: Json		 SQL 以外のデータ プロバイダーにのみ許可されます。
リッチ テキスト StringFormat.RichText MemoFormatName.RichText 形式: テキスト
FormatName: RichText
整数 なし/String.Empty IntegerFormat.None N/A 形式: なし 整数列の既定形式値。
長さ IntegerFormat.Duration N/A 形式: 間隔
TimeZone IntegerFormat.TimeZone N/A 形式: TimeZone
言語 IntegerFormat.Language N/A 形式: 言語
ロケール IntegerFormat.Locale N/A 形式: ローカル
日時 DateTime DateTimeFormat.DateAndTime N/A 形式: DateAndTime DateTime 列の既定形式値。

データ型形式の変換
形式検証