Compartir a través de


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 Aplicaciones basadas en modelo
name Nombre de la propiedad. string 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 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" />

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