Зіставлення полів вхідних даних компонента

Компонент може отримувати вхідні значення, щоб виводити або обробляти дані за допомогою настроюваних властивостей вхідних даних. У цій статті описано роботу з такими компонентами, які очікують на одну або кілька властивостей вхідних даних з певною схемою для заданої таблиці або запису, а також зіставлення полів вхідних даних компонентів зі стовпцями джерела даних.

Порада

Щоб дізнатися про те, що таке користувацькі властивості вводу та виводу у компонентах, перегляньте статтю Користувацькі властивості у компонентах.

Зіставлення стовпців

Використовуйте функцію RenameColumns(), щоб перейменувати один або кілька стовпців таблиці так, щоб вони відповідали схемі вхідної властивості для вибору стовпця вводу.

Наприклад, розглянемо компонент, який очікує на вхідні дані таблиці в такому форматі:

Смак Ціна за одиницю товару КількістьПродано
Полуниця 1.99 20
Шоколад 2.99 45

Властивість вхідних даних очікує на тип даних таблиці:

Властивість користувацького вводу, яка очікує тип даних таблиці.

Схема властивості вхідних виглядає як наведена нижче формула.

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

Настроювана формула вхідної властивості, визначена як таблиця та вибіркові значення.

Програма, яка використовує цей компонент, має наступну таблицю IceCreams , яка не збігається зі схемою компонентів:

Назва аромату Ціна Номер продажу
Полуниця 1.99 20
Шоколад 2.99 45

Схема морозива таблиця.

Щоб зіставити правильні поля, використовуйте функцію RenameColumn() для перейменування очікуваних стовпців.

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

Додаток використовує компонент, який використовує користувацьке зіставлення властивостей вводу з правильними стовпцями за допомогою функції RenameColumns.

Поля вхідних даних, які очікує компонент, тепер зіставляються з відповідними стовпцями з джерела даних.

Записи зіставлення

Використовуйте функцію With() для відображення одного запису.

Наприклад, продовжуючи попередній приклад для зіставлення стовпців, властивість користувацького введення компонента в програмі очікує тип запису з такою схемою:

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

Настроювана формула властивості вводу, визначена як запис і вибіркові значення.

Оскільки джерело даних IceCreams очікує назви стовпців, як FlavorName, Price і SaleNumber, нам потрібно буде змінити відображення запису, як тільки компонент буде додано до програми.

Використовуйте функцію With(), щоб вибрати стовпці таблиці IceCreams і зіставити їх з полями введення компонента:

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

Запис компонентів у програмі зіставляється зі схемою джерела даних.

Анімація нижче показує приклад компонента, доданого до програми, який показує вибраний запис із колекції (над компонентом):

Анімація, яка показує вибір запису з галереї вище зі зміною тексту екземпляра компонента нижче.

Зіставлення таблиць

Використовуйте функцію ForAll(), щоб зіставити таблицю записів із записами, які очікуються компонентом, доданим до програми.

Наприклад, в кінці прикладу зі стовпцями map ви можете використовувати функцію ForAll(), щоб зіставити всю таблицю з конкретними стовпцями, щоб вказати на поля з компонента для кожного рядка:

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

Зіставте таблицю з використанням функції ForAll() для всіх записів.

Зіставлення за допомогою розкривного списку (вилучено)

Ви можете використовувати вкладку Додатково для компонента, доданого до програми, яка очікує вхідну властивість таблиці або типу запису, і вибрати відповідності полів за допомогою опції розкривного списку. Це зіставлення призначається за замовчуванням, і, якщо вручну не вибрати відповідні поля зіставлення, зіставлення може не давати очікувані результати.

Наприклад, у наведеній нижче анімації показано формулу, що оновлюється для перейменування стовпців. Компонент на екрані не змінює зіставлення поля, оскільки вибір поля за замовчуванням за допомогою цього розкривного списку необхідно оновити вручну.

Застарілий метод для вибору відповідності полів за допомогою випадаючого меню в розділі розширених властивостей компонента, доданого до програми.

Цей метод вибору відповідності за допомогою випадаючого списку вважається застарілим. Замість цього використовуйте методи зіставлення стовпців, записів або таблиць , як описано раніше в цій статті.

Ви все ще можете використовувати розкривний список, щоб вибирати зіставлення для наявних програм, але це не рекомендується. Для нових програм цей параметр буде недоступний за замовчуванням. Щоб увімкнути або вимкнути цю застарілу можливість, перейдіть до розділу Налаштування>Майбутні функції>Вилучено та виберіть Дозволити автоматичне призначення полів для введення компонентів.

Уможливлено автоматичне призначення полів для налаштування вхідних даних компонентів.

Після ввімкнення цього параметра переконайтеся, що програму збережено та повторно відкрито в Power Apps Studio. Після повторного запуску оновіть формулу властивості вхідних даних для виклику перевірки формули, щоб параметри розкривного списку почали відображатися в області «Додаткові властивості».

Див. також

  • Last updated on