Columnas Format y FormatName

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

Format es la columna anterior que almacena los valores usados por Microsoft Dataverse. Para mantener la compatibilidad con versiones anteriores, no se pudieron introducir nuevos formatos. Debido a esto, algunas de las respuestas de api no se alinearán con el nuevo formato. Para las columnas Text y Multiline Text, se recomienda usar 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. FormatName column proporciona una respuesta más precisa para el formato seleccionado y admite tipos de formato más recientes.

Comportamiento de las API

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

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

  • Formato: 'Texto'
  • FormatName: "RichText".
  • La operación de recuperación corrige los valores Format o FormatName incompatibles presentes en un tipo de datos cambiando los valores a predeterminados. Por ejemplo, si se cambia una columna Texto a Fecha solo en Dataverse, la operación de recuperación corrige el formato a los valores siguientes:
    • Formato: 'Texto'
    • FormatName: 'Text'.

• En la operación de Update, el sistema solo tiene en cuenta el valor FormatName. El valor de FormatNOse considera aunque el valor FormatName no esté presente.

En la tabla siguiente se proporcionan los valores Format y FormatName y las respuestas de API para cada tipo:

Tipo de columna	Formato de plataforma/Valor en XML de la solución	Formato de definición del SDK	Definición del FormatName SDK	Valor de respuesta de API	Comentarios
Mensaje de texto	Mensaje de texto	StringFormat.Text	StringFormatName.Text	Formato: Texto FormatName: Text	Valor de formato predeterminado para la columna String.
	Correo Electrónico	StringFormat.Email	StringFormatName.Email	Formato: Correo electrónico FormatName: Correo electrónico
	Área de texto	StringFormat.TextArea	StringFormatName.TextArea	Formato: TextArea FormatName: TextArea
	URL	StringFormat.Url	StringFormatName.Url	Formato: Dirección URL FormatName: Url
	Símbolo del valor	StringFormat.TickerSymbol	StringFormatName.TickerSymbol	Formato: TickerSymbol FormatName: TickerSymbol
	Número de versión	StringFormat.VersionNumber	StringFormatName.VersionNumber	Formato: NúmeroDeVersión FormatName: VersionNumber
	Teléfono	StringFormat.Phone	StringFormatName.Phone	Formato: Texto FormatName: Teléfono
	JSON	StringFormat.Json	StringFormatName.Json	Formato: Texto FormatName: Json
	Texto enriquecido	StringFormat.RichText	MemoFormatName.RichText	Formato: Texto FormatName: RichText	Solo se permite para el proveedor de datos no SQL.
Texto de nota/multilínea	Mensaje de texto	StringFormat.Text	MemoFormatName.Text	Formato: Texto FormatName: Text	Valor de formato predeterminado para la columna Memo/Multiline.
	Correo Electrónico	StringFormat.Email	MemoFormatName.Email	Formato: Correo electrónico FormatName: Correo electrónico
	Área de texto	StringFormat.TextArea	MemoFormatName.TextArea	Formato: TextArea FormatName: TextArea
	InternalExtentdata	StringFormat.Te	StringFormatName.Text	Formato: Texto FormatName: Text
	Json	StringFormat.Json	MemoFormatName.Json	Formato: Texto FormatName: Json	Solo se permite para el proveedor de datos no SQL.
	Texto enriquecido	StringFormat.RichText	MemoFormatName.RichText	Formato: Texto FormatName: RichText
Número entero	None/String.Empty	IntegerFormat.Ninguno	N/A	Formato: Ninguno	Valor de formato predeterminado para la columna Entero.
	Duración	IntegerFormat.Duration	N/A	Formato: Duración
	Zona horaria	IntegerFormat.ZonaHoraria	N/A	Formato: Zona horaria
	Language	IntegerFormat.Language	N/A	Formato: Idioma
	Configuración regional	IntegerFormat.Locale	N/A	Formato: configuración regional
Fecha y hora	DateTime	DateTimeFormat.DateAndTime	N/A	Formato: DateAndTime	Valor de formato predeterminado para la columna DateTime.

Artículos relacionados

Conversiones de formato de tipo de datos
Dar formato a las validaciones