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 modelos

Propiedades

Name	Description	Type	Obligatorio	Disponible para
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.	string	Opcionales	Aplicaciones basadas en modelo
description-key	Se usa en las pantallas de personalización como cadenas localizadas que describen la descripción de la propiedad.	string	Opcionales	Aplicaciones de lienzo y basadas en modelos
display-name-key	Se usa en las pantallas de personalización como cadenas localizadas que describen el nombre de la propiedad.	string	Sí	Aplicaciones basadas en modelo
name	Nombre de la propiedad.	string	Sí	Aplicaciones de lienzo y basadas en modelos
of-type-group	Nombre del type-group definido en el manifiesto	string	Opcionales	Aplicaciones basadas en modelo
of-type	Deeine el tipo de datos de la propiedad	Vea Uso de of-type	Opcionales	Aplicaciones de lienzo y basadas en modelos
pfx-default-value	El valor de la expresión PFX predeterminado proporcionado al componente.	Vea Uso de pfx-default-value	Opcionales	Aplicaciones de lienzo
obligatorio	Si la propiedad es requerida o no	booleano	Opcionales	Aplicaciones basadas en modelo
usage	La propiedad de uso identifica si la propiedad está diseñada para representar una columna de tabla que el componente puede cambiar valores (enlazados), de solo lectura (entrada) o salida.	enlazados, de entrada o de salida	Sí	Aplicaciones basadas en modelo

Comentarios

Esta sección contiene orientación sobre el uso de los atributos del elemento Propiedad.

Uso de of-type

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.
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.
Enumeración	Tipo de datos enumerados.
FP	Hasta cinco puntos decimales de precisión se pueden usar para valores entre -100 000 000 000 y -100 000 000 000 en esta columna.
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.
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.
Objecto	Tipo de datos de objeto. Solo se puede usar con propiedades de salida.
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	Description
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.
Razón para el estado	Una columna del sistema que tiene opciones que proporcionan más información sobre la columna Estado. Cada opción está asociada con una de las opciones de Estado disponibles. Puede agregar y editar las opciones.
Status	Una columna del sistema que tiene opciones que corresponden normalmente a los estados activo e inactivo. Algunas columnas del sistema tienen más opciones, pero todas las columnas personalizadas solo tienen las opciones de estado Activo e Inactivo.
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 tres 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.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 id. de configuración regional válidos pueden encontrarse en el gráfico de identificadores de configuración regional (LCID).
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.

Nota

En este momento, las columnas no se admiten. Más información: Columnas de archivos

Uso de pfx-default-value

Utilice el valor de propiedad pfx-default-value para evaluar eventos y propiedades usando expresiones Power Fx en lugar de valores predeterminados estáticos. Puede usar esto para:

• Dimensionar el control de manera responsiva
• Acceder a conectores
• Proporcionar datos de ejemplo
• Hacer referencia a propiedades de tema
• Eventos personalizados

Nota

• Puede utilizar cualquier expresión Power Fx, pero debe asegurarse de que la expresión sea válida al importar el control.
• Si utiliza comillas internas u otros caracteres especiales, incluya el valor entre comillas simples, por ejemplo: pfx-default-value='"Test"'
• Puede hacer referencia a otros controles (incluidas las pantallas) y sus propiedades. Escriba estas referencias como: %ControlName.ID%.ControlProperty. Por ejemplo: pfx-default-value='SubmitForm(%MyFormName.ID%)'
• Escriba enumeraciones, como DisplayType y ScreenTransition como: %EnumName.RESERVED%.EnumValue. Por ejemplo: pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
• Si se incluye pfx-default-value, tiene prioridad sobre default-value.

Elementos primarios

Elemento	Description
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).