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
DisplayTypeyScreenTransitioncomo:%EnumName.RESERVED%.EnumValue. Por ejemplo:pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)' - Si se incluye
pfx-default-value, tiene prioridad sobredefault-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).
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de