Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Microsoft Dataverse tiene varios tipos de datos que se pueden configurar con diferentes formatos. Puede especificar el formato de la columna mediante el Explorador de soluciones o las operaciones de API. En las secciones siguientes se proporcionan más detalles sobre los formatos de tipo de datos, entre los que se incluyen:
Formatos admitidos por tipo de datos
La columna format especifica la interfaz de usuario sobre cómo mostrar el contenido. Algunos formatos disponibles en la interfaz de usuario son Teléfono, Correo electrónico o Duración. Los formatos aplicados no validan el contexto, los dominios ni ningún otro valor. Indican a la interfaz de usuario qué control se va a usar para ese tipo.
Formatos
En la tabla siguiente se proporciona información sobre los formatos disponibles para cada tipo de datos:
| Tipo de dato | Nombre de formato | Descripción | ¿Está disponible para el creador de aplicaciones? | Notas |
|---|---|---|---|---|
| Mensaje de texto | Mensaje de texto | Columna de texto básica que contiene caracteres de texto. | Sí | Valor de formato predeterminado para la columna de texto. |
| Área de texto | Columna de texto que contiene caracteres de texto y también permite saltos de línea. | Sí | ||
| Correo Electrónico | El texto proporciona un vínculo para abrir la aplicación de correo electrónico del usuario. | Sí | ||
| URL | El texto proporciona un hipervínculo para abrir la página especificada.
https:// antepuesto se antepone a cualquier texto que no comience con un protocolo válido. |
Sí | ||
| Símbolo del tic | Para la mayoría de los idiomas, el texto se habilita como enlace para abrir el sitio web de MSN Money y mostrar detalles sobre el precio de la acción representado por el símbolo del ticker. | Sí | ||
| Teléfono | Las columnas están habilitadas para hacer clic para iniciar llamadas. | Sí | ||
| JSON | Almacena texto mediante formato JSON | Sí (solo API) | Solo en almacenes no SQL, como Audit. | |
| Texto enriquecido | Permite el formato de texto enriquecido, incluido el marcado HTML. | Sí (solo API) | ||
| Número de versión | Almacena el número de versión para cada fila. | No | Uso exclusivo del sistema. | |
| Texto multilínea (Memo) | Mensaje de texto | Columna de texto básica que contiene caracteres de texto. | Sí | |
| Área de texto | La columna de texto contiene caracteres de texto y permite saltos de línea. | Sí | ||
| Correo Electrónico | Solo para uso interno. | No | ||
| JSON | Almacena texto mediante formato JSON | Sí (solo API) | Solo en almacenes NoSQL, como Log. | |
| RichText | Permite el formato de texto enriquecido, incluido el marcado HTML. | Y (solo API) | ||
| InternalExtentData | Solo para uso interno. | No | Solo uso del sistema | |
| None/string.Empty | Esta opción solo muestra un número. | Sí | Valor de formato predeterminado para la columna de número entero. | |
| Número entero | Duración | Esta opción de formato muestra una lista de opciones de duración. Los datos que se almacenan en la base de datos siempre son en términos de minutos. El campo es similar a una lista desplegable y proporciona opciones sugeridas como 1 minuto, 15 minutos, 30 minutos hasta 3 días. Las personas pueden elegir estas opciones o escribir un número de minutos y se resuelve en ese período de tiempo. Por ejemplo, escriba 60 y equivale a 1 hora. O pueden escribir "1 hora" o "2 días" y se resuelve para mostrar ese tiempo. La duración debe especificarse en el siguiente formato: "x minutos", "x horas" o "x días". Las horas y los días también se pueden escribir mediante decimales, por ejemplo, "x.x horas" o "x.x días". NOTA: Los valores deben expresarse en minutos, los valores de subminute se redondean al minuto más cercano. |
Sí | El sistema lee este valor en segundos. |
| Timezone | Esta opción muestra una lista de selección de zonas horarias mediante códigos de zona horaria. Cada una de estas zonas se almacena como un número. Por ejemplo, para la zona horaria (GMT-08:00) Hora del Pacífico (EE.UU y Canadá.), el TimeZoneCode es 4. Las aplicaciones guiadas por modelos muestran estos códigos en nombres de zona horaria, mientras que las aplicaciones de Canvas se muestran como el número almacenado. | Sí | ||
| Language | Esta opción muestra una lista de los idiomas aprovisionados para la organización. Los valores se almacenan como un número mediante códigos LCID. Los códigos de idioma son identificadores de configuración regional de cuatro o cinco dígitos. Los valores de id. de configuración regional válidos pueden encontrarse en el gráfico de identificadores de configuración regional (LCID). Las aplicaciones controladas por modelos muestran los idiomas como el nombre del idioma, y las aplicaciones Canvas muestran los idiomas por el número almacenado. | Sí | ||
| Configuración regional | Valor que corresponde a una configuración regional específica mediante valores estándar ISO. | Sí (solo API) | No se muestra en la interfaz de usuario de Power Apps Maker. | |
| Fecha y hora | Solo fecha | Solo fecha. Incluye una hora de 00:00:00 si el usuario local o la opción independiente de la zona horaria está seleccionada. | Sí | |
| Fecha y hora | Formato de fecha y hora. | Sí | Valor de formato predeterminado para la columna DateTime. |
Conversión de formato
Puede cambiar el formato de tipo de datos a cualquiera de los formatos compatibles que admite el tipo de datos. El cambio del formato conserva las definiciones de tabla anteriores (maxsize) si existen en el nuevo formato de destino. Si una carga de entrada no incluye un formato, Dataverse supone que no se debe cambiar el formato. Puede convertir el formato mediante una llamada API con la carga deseada en la FormatName columna. Se recomienda cambiar el valor de la columna Format ya que se omiten las selecciones recién agregadas Format.
Nota:
En este momento, las conversiones de formato solo se realizan realizando operaciones de API. Cambiar formatos no cambia ningún dato presente en la columna. Debido a esto, es posible que observe algunos problemas de formato inesperados que deben resolverse después de la conversión.
Como se mencionó en la tabla anterior, hay algunas restricciones para las conversiones de formato:
- JSON solo se puede usar si una tabla forma parte del almacenamiento que no es SQL (es decir, Registro).
- No se pueden convertir columnas con los formatos de tipo
emailbody,internalextentdataa otros formatos. Cualquier intento de convertir estas columnas se omite y no se proporciona ningún mensaje de error. - No se puede convertir una columna a los formatos de
emailbody,internalextentdataa otros formatos. Si se intenta, se produce un error. - La fecha sola no se puede convertir a DateTime, pero la fecha con el comportamiento de User Local o Time-Zone Independent se puede cambiar a un DateTime.
Si cambia el tipo de datos a un formato incompatible, se muestra el siguiente error:
El formato <<formatname>> no es válido para la columna de tipo <<datatype>>, <<columnname>>, de la tabla <<tablename>>. Por ejemplo, el formato datetime no es válido para la columna de tipo de texto.
Para cambiar el formato de un tipo de datos, debe agregar los nuevos detalles de formato a una llamada PUT de API de OData:
PUT [Organization URI]/api/data/v9.0/EntityDefinitions(<<entity name>>)/Attributes(<<attribute name>>)
To set or change the format of a data type, you need to add the new format details into an OData API **POST** for a new column or **PUT** call to update an existing column:
> [!NOTE]
> For more samples on how to use the API, see https://github.com/microsoft/PowerApps-Samples
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
{
"AttributeType": \<\<Data type you are setting the format for\>\>,
"AttributeTypeName": {
"Value": *\<\<Datatype Type\>\>*
},
"Description": {
"@odata.type": "Microsoft.Dynamics.CRM.Label",
"LocalizedLabels": [
{
"@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
"Label": *\<\<text label to use for the format\>\>*
"LanguageCode": 1033
}
]
},
"DisplayName": {
"@odata.type": "Microsoft.Dynamics.CRM.Label",
"LocalizedLabels": [
{
"@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
"Label": *\<\<text label to use for the format\>\>*
"LanguageCode": 1033
}
]
},
"RequiredLevel": {
"Value": "None",
"CanBeChanged": true,
"ManagedPropertyLogicalName": "canmodifyrequirementlevelsettings"
},
"SchemaName": *\<\<Your chosen schema name\>\>*
"@odata.type": "Microsoft.Dynamics.CRM.StringAttributeMetadata",
"FormatName": {
"Value": *\<\<Formatname value\>\>*
},
"MaxLength": 100
}