Поділитися через

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

  • Стаття

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

Підказка

Відомості про настроювані властивості вхідних даних та вихідних даних в компонентах див. в розділі Настроювані властивості в компонентах.

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

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

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

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

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

Настроювана властивість вхідних даних очікує на тип даних таблиці.

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

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

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

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

Смак Ціна Номер
Полуниця 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}

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

Оскільки джерело даних Морозиво очікує імена стовпців Смак, Ціна та Номер, потрібно буде змінити зіставлення запису після додавання компонента до програми.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Див. також