Mapa de campos de entrada dun compoñente

Un compoñente pode recibir valores de entrada para emitir ou procesar datos mediante propiedades de entrada personalizadas. Neste artigo, aprenderá sobre como traballar con tales compoñentes esperando unha ou máis propiedades de entrada cun esquema específico para a táboa ou rexistro dado e como asignar os campos de entrada de compoñentes ás columnas do orixe de datos.

Suxestión

Para saber cales son as propiedades de entrada e saída personalizadas dos compoñentes, consulte Propiedades personalizadas en compoñentes.

Asignar columnas

Usa o Cambiar o nome de columnas() función para renomear unha ou máis columnas dunha táboa para que coincidan co esquema da propiedade de entrada para a selección da columna de entrada.

Por exemplo, considere un compoñente que espera unha entrada de táboa co seguinte formato:

Sabor	Prezo por unidade	Cantidade vendida
Amorodo	1.99	20
Chocolate	2.99	45

A propiedade de entrada espera o tipo de datos da táboa:

O esquema da propiedade de entrada parece a seguinte fórmula:

Table({Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold:20})

A aplicación que consume este compoñente ten o seguinte Xeados táboa que non coincide co esquema de compoñentes:

Nome do sabor	Prezo	Número de venda
Amorodo	1.99	20
Chocolate	2.99	45

Para mapear os campos correctos, use Cambiar o nome da columna() función para renomear as columnas esperadas.

RenameColumns(IceCreams,"cra56_flavorname","Flavor","cra56_price","UnitPrice","cra56_salenumber","QuantitySold")

Os campos de entrada que espera o compoñente agora están mapeados coas columnas coincidentes do orixe de datos.

Rexistros do mapa

Use Con () función para mapear un único rexistro.

Por exemplo, continuando dende o exemplo anterior para mapear columnas, a propiedade de entrada personalizada dun compoñente dentro dunha aplicación espera un tipo de rexistro co seguinte esquema:

{Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold: 20}

Dende o Xeados orixe de datos espera nomes de columnas como Nome do sabor, ·, e Número de venda, teremos que cambiar a asignación do rexistro unha vez que se engada o compoñente á aplicación.

Use Con () función para seleccionar as columnas do Xeados táboa e mapeaos cos campos de entrada do compoñente:

With(Gallery3.Selected,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})

A seguinte animación mostra o exemplo dun compoñente engadido á aplicación que mostra o rexistro seleccionado da galería (enriba do compoñente):

Táboas de mapas

Use Para todos() función para mapear unha táboa de rexistros cos rexistros esperados polo compoñente engadido á aplicación.

Por exemplo, ao final do columnas do mapa exemplo, pode usar o Para todos() función para asignar toda a táboa coas columnas específicas para apuntar aos campos do compoñente para cada fila:

ForAll(IceCreams,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})

Mapa usando o menú despregable (obsoleto)

Podes usar o Avanzado pestana para un compoñente engadido a unha aplicación que espera a propiedade de entrada da táboa ou tipo de rexistro e seleccione as asignacións de campos usando a opción despregable. Esta asignación atribúese de forma predeterminada e, a menos que seleccione manualmente os campos de asignación apropiados, é posible que a asignación non dea os resultados esperados.

Por exemplo, a seguinte animación mostra a fórmula que se está actualizando para cambiar o nome das columnas. O compoñente na pantalla non cambia a asignación de campos xa que a selección de campos predeterminada que utiliza este menú despregable debe actualizarse manualmente.

Este método para seleccionar a asignación mediante o menú despregable foi obsoleto. En vez diso, use o columna,rexistro, ou táboa métodos de mapeo como se describiu anteriormente neste artigo.

Aínda podes usar a opción despregable para escoller a asignación das aplicacións existentes, aínda que non se recomenda. Para as aplicacións novas, esta opción non estará dispoñible de forma predeterminada. Para activar ou desactivar esta función obsoleta, vai a Configuración > Próximas funcións > Xubilado, e escolle Permitir a asignación automática de campos para entradas de compoñentes.

Ao activar a configuración, asegúrate de gardar e volver abrir a aplicación en Power Apps Studio. Unha vez reaberto, actualice a fórmula da propiedade de entrada para activar a validación da fórmula para que as opcións do menú despregable comecen a aparecer no panel de propiedades avanzadas.

Consulte tamén

• Fórmulas de comportamento dos compoñentes
• Obsoleto: asignar campos de compoñentes usando a opción despregable
• Compoñentes de lenzo
• Biblioteca de compoñentes
• Xestión do ciclo de vida da aplicación da biblioteca de compoñentes (ALM)
• Engadir multimedia a un compoñente
• Fórmulas de comportamento dos compoñentes
• Power Apps Component Framework
• Engade compoñentes de lenzo a unha páxina personalizada nunha aplicación baseada en modelos