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 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 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 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" />

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