Elemento property

El nodo property define un dato específico y configurable que el componente espera de Microsoft Dataverse.

Disponible para

Aplicaciones de lienzo y basadas en modelo

Propiedades

Name	Descripción	Tipo	Necesario	Disponible para
name	Nombre de la propiedad.	cadena	Sí	Aplicaciones de lienzo y basadas en modelo
display-name-key	Se usa en las pantallas de personalización como cadenas localizadas que describen el nombre de la propiedad.	cadena	Sí	Aplicaciones basadas en modelos
of-type	Deeine el tipo de datos de la propiedad	Consulte Notas	Opcionales	Aplicaciones de lienzo y basadas en modelo
usage	La propiedad de uso identifica si la propiedad está diseñada para representar una columna que el componente puede cambiar (enlazada) o valores de sólo lectura (entrada)	enlazado o entrada	Sí	Aplicaciones basadas en modelos
obligatorio	Si la propiedad es requerida o no	booleano	Opcionales	Aplicaciones basadas en modelos
of-type-group	Nombre del type-group definido en el manifiesto	cadena	Opcionales	Aplicaciones basadas en modelos
description-key	Se usa en las pantallas de personalización como cadenas localizadas que describen la descripción de la propiedad.	cadena	Opcionales	Aplicaciones de lienzo y basadas en modelo
default-value	El valor de configuración predeterminado proporcionado al componente. En las aplicaciones basadas en modelos, esta propiedad solo se permite en las entradas, ya que los parámetros enlazados esperan tener una columna asociada.	cadena	Opcionales	Aplicaciones basadas en modelos

Comentarios

El valor de la propiedad of-type debe ser uno de los siguientes:

valor	Descripción
Moneda	Los valores monetarios entre -922 337 203 685 477 y 922 337 203 685 477 pueden estar en esta columna. Puede establecer un nivel de precisión o elegir basar la precisión en una divisa específica o una precisión estándar única usada por la organización.
DateAndTime.DateAndTime	Muestra fecha y hora.
DateAndTime.DateOnly	Solo muestra la fecha.
Decimal	Hasta 10 puntos decimales de precisión se pueden usar para valores entre -100.000.000.000 y -100.000.000.000 en esta columna. Puede especificar el nivel de precisión y los valores máximo y mínimo.
Enum	Tipo de datos enumerados.
FP	Hasta 5 puntos decimales de precisión se pueden usar para valores entre -100 000 000 000 y -100 000 000 000 en esta columna. Puede especificar el nivel de precisión y los valores máximo y mínimo.
Lookup.Simple	Permite una única referencia a una tabla específica. Todas las búsquedas personalizadas son de este tipo.
Múltiple	Esta columna puede contener hasta 1 048 576 caracteres de texto. Puede establecer que la longitud máxima sea inferior a esta. Cuando agrega esta columna a un formulario, puede especificar el tamaño de la columna.
MultiSelectOptionSet	Puede personalizar formularios (principal, creación rápida y vista rápida) así como plantillas de correo electrónico agregando columnas de elecciones. Cuando agrega un columnas de elecciones, puede especificar múltiples valores que los usuarios pueden seleccionar. Cuando los usuarios rellenan el formulario pueden seleccionar uno, varios o todos los valores mostrados en una lista desplegable.
OptionSet	Esta columna proporciona un conjunto de opciones. Cada opción tiene un valor y una etiqueta del número. Cuando se agrega a un formulario, esta columna muestra un control para que lo usuarios solo puedan seleccionar una opción.
SingleLine.Email	Esto almacena la hora de la cadena en el formato válido para correos electrónicos. Los controles Interfaz unificada listos para usar los convierten automáticamente en enlaces en los que se puede hacer clic.
SingleLine.Phone	Esto almacena la hora de la cadena en el formato válido para el teléfono. Los controles Interfaz unificada listos para usar los convierten automáticamente en enlaces en los que se puede hacer clic.
SingleLine.Text	Esta opción solo muestra el texto.
SingleLine.TextArea	Esta opción de formato se puede usar para mostrar varias líneas de texto. Pero con un límite de 4000 caracteres, la columna Varias líneas de texto es una opción mejor si se prevén grandes cantidades de texto.
SingleLine.Ticker	Esto almacena la hora de la cadena en el formato válido para Ticker. Los controles Interfaz unificada listos para usar los convierten automáticamente en enlaces en los que se puede hacer clic.
SingleLine.URL	El texto esperado proporciona un hipervínculo para abrir la página especificada. Los controles Interfaz unificada listos para usar anteponen automáticamente "https://" para ingresar valores que no comiencen con un protocolo válido. En este campo solo se admiten los protocolos HTTP, HTTPS, FTP, FTPS, OneNote y TEL en esta columna.
TwoOptions	Esta columna proporciona dos opciones. Cada opción tiene un valor numérico de 0 o 1 correspondiente a un valor true o false. Cada opción también tiene una etiqueta para poder representar valores true o false como "Sí" y "No", "muy interesado" y "No interesado", "Activado" y "Desactivado" o un par de etiquetas que desee mostrar.
Whole.None	Esta opción solo muestra un número.

Advertencia

Si el archivo manifest.xml contiene al menos un conjunto de datos, en ese caso las propiedades de tipo Lookup.Simple también deben envolverse en el elemento conjunto de datos.

Elementos de valor que no son compatibles

Los valores de propiedad of-type siguientes no son compatibles actualmente:

valor	Descripción
Whole.Duration	Esta opción de formato se puede usar para mostrar una lista de opciones de duración. Pero los datos almacenados en la base de datos siempre serán varios minutos. La columna parece una lista desplegable y proporciona opciones sugeridas como 1 minuto, 15 minutos, 30 minutos y así hasta 3 días. Los usuarios pueden elegir estas opciones. Sin embargo, los usuarios solo pueden escribir varios minutos y se resuelve en ese período de tiempo.
Whole.TimeZone	Esta opción muestra una lista de determinas zonas horarias como (GMT-12: 00) Línea internacional de fecha del oeste y (GMT-08: 00 ) Hora del Pacífico (EE.UU. y Canadá). 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. Más información: Clase TimeZoneCode (ensamblado Sdk)
Whole.Language	Esta opción muestra una lista de los idiomas aprovisionados para la organización. Se muestran los valores como una lista desplegable de nombres de idioma, pero los datos se almacenan como un número con códigos LCID. Los códigos de idioma son identificadores de configuración regional de cuatro o cinco dígitos. Los valores de identificadores de configuración regional válidos pueden encontrarse en el gráfico de identificadores de configuración regional (LCID).
Lookup.Customer	Permite una única referencia a una cuenta o un registro de contacto. Estas búsquedas están disponibles para las tablas Oportunidad, Caso, Oferta, Pedido y Factura. Estas tablas también tienen búsquedas de Cuenta y Contacto independientes que puede usar si sus clientes son siempre de un mismo tipo. También puede incluir ambas opciones en lugar de usar la búsqueda de Cliente.
Lookup.Owner	Permite una única referencia a un equipo o un registro de usuario. Todas las tablas propiedad del equipo el usuario presentan una de estas opciones.
Lookup.PartyList	Permite asignar varias referencias a varias tablas. Estas búsquedas se encuentran en las columnas Para y CC de la tabla Correo electrónico. También se usan en las tablas Teléfono y Cita.
Lookup.Regarding	Permite asignar una sola referencia a varias tablas. Estas búsquedas se encuentran en la columna referente usado en las actividades.
Estado	Una columna del sistema que tiene opciones que corresponden normalmente a los estados activo e inactivo. Algunas columnas del sistema tienen opciones adicionales, pero todas las columnas personalizadas solo tienen las opciones de estado Activo e Inactivo.
Razón para el estado	Una columna del sistema que tiene opciones que proporcionan información adicional sobre la columna Estado. Cada opción está asociada con una de las opciones de Estado disponibles. Puede agregar y editar las opciones.

Elementos primarios

Elemento	Descripción
control	Define el espacio de nombres, la versión y la información para mostrar del componente.

Ejemplo

<property name="myFirstProperty" display-name-key="myFirstProperty_Display_Key"
description-key="myFirstProperty_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />

Temas relacionados

Referencia de esquema de manifiesto de Power Apps component framework
Referencia de la API de Power Apps component framework
Información general sobre Power Apps component framework

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).