Columnas Format y FormatName

Las columnas Format y FormatName almacenan los valores de formato y los controles y la interfaz de usuario las utilizan para saber cómo mostrar el contenido.

Format es la columna más antigua que almacena los valores utilizados por Microsoft Dataverse. Para mantener la compatibilidad con versiones anteriores, no se pudieron introducir nuevos formatos. Debido a esto, algunas de las respuestas de la API no se alinearán con el nuevo formato. Para las columnas Text y Multiline Text, se recomienda utilizar la columna FormatName.

FormatName es la nueva columna que se utiliza para especificar el formato de los tipos de datos de columna Text y Multiline Text. La columna FormatName proporciona una respuesta más precisa para el formato seleccionado y admite tipos de formato más nuevos.

Comportamiento de API

• En la operación Crear, si la carga útil entrante contiene información de Format y de FormatName, el valor FormatName se considera primero. Si la carga útil contiene solo un valor, el sistema considera lo que esté presente en la carga útil.

• En la operación Recuperar, un tipo de datos con un formato definido puede proporcionar diferentes valores para las respuestas de la API Format y FormatName basadas en compatibilidad. Por ejemplo, una columna de texto establecida en formato RichText devuelve lo siguiente:

  • Format: 'Text'
  • FormatName: 'RichText'.
  • La operación de recuperación corrige cualquier incompatibilidad de los valores Format o FormatName presentes en un tipo de datos cambiando los valores por defecto. Por ejemplo, si una columna de texto se cambia a Solo fecha en Dataverse, la operación de recuperación corrige el formato a los siguientes valores:
    • Format: 'Text'
    • FormatName: 'Text'.

• En la operación Actualizar, el sistema solo tiene en cuenta el valor FormatName. El valor de Format NO se tiene en cuenta incluso si el valor FormatName no está presente.

La siguiente tabla proporciona los valores y respuestas de API de Format y FormatName para cada tipo:

Tipo de columna	Formato de plataforma/Valor en la solución XML	Definición de SDK de Format	Definición de SDK de FormatName	Valor de respuesta API	Comentarios
Text	Text	StringFormat.Text	StringFormatName.Text	Format: Text FormatName: Text	Valor de formato predeterminado para la columna String.
	Email	StringFormat.Email	StringFormatName.Email	Format: Email FormatName: Email
	Área de texto	StringFormat.TextArea	StringFormatName.TextArea	Format: TextArea FormatName: TextArea
	Dirección URL	StringFormat.Url	StringFormatName.Url	Format: Url FormatName: Url
	Símbolo del valor	StringFormat.TickerSymbol	StringFormatName.TickerSymbol	Format: TickerSymbol FormatName: TickerSymbol
	Número de versión	StringFormat.VersionNumber	StringFormatName.VersionNumber	Format: VersionNumber FormatName: VersionNumber
	Teléfono	StringFormat.Phone	StringFormatName.Phone	Format: Text FormatName: Phone
	JSON	StringFormat.Json	StringFormatName.Json	Format: Text FormatName: Json
	Texto enriquecido	StringFormat.RichText	MemoFormatName.RichText	Format: Text FormatName: RichText	Solo permitido para proveedor de datos que no sea SQL.
Nota/Texto de varias líneas	Text	StringFormat.Text	MemoFormatName.Text	Format: Text FormatName: Text	Valor de formato predeterminado para la columna Memo/Multiline.
	Email	StringFormat.Email	MemoFormatName.Email	Format: Email FormatName: Email
	Área de texto	StringFormat.TextArea	MemoFormatName.TextArea	Format: TextArea FormatName: TextArea
	InternalExtentdata	StringFormat.Te	StringFormatName.Text	Format: Text FormatName: Text
	Json	StringFormat.Json	MemoFormatName.Json	Format: Text FormatName: Json	Solo permitido para proveedor de datos que no sea SQL.
	Texto enriquecido	StringFormat.RichText	MemoFormatName.RichText	Format: Text FormatName: RichText
Número entero	None/String.Empty	IntegerFormat.None	N/D	Format: None	Valor de formato predeterminado para la columna Integer.
	Duration	IntegerFormat.Duration	N/D	Format: Duration
	TimeZone	IntegerFormat.TimeZone	N/D	Format: TimeZone
	Lenguaje	IntegerFormat.Language	N/D	Format: Language
	Configuración regional	IntegerFormat.Locale	N/D	Format: Locale
Fecha y hora	Fecha y hora	DateTimeFormat.DateAndTime	N/D	Format: DateAndTime	Valor de formato predeterminado para la columna DateTime.

Artículos relacionados

Conversiones de formato de tipo de datos
Validaciones de formato