Додайте програму з вбудованим полотном у форму на основі моделі

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

У цій статті описано два способи інтеграції. По-перше, використовуючи сучасний єдиний інтерфейс досвід, а по-друге, використовуючи класичний досвід.

Примітка

Існує третій і новіший метод вбудовування програм Canvas у сучасну програму, який використовує користувацькі сторінки для кращої інтеграції з програмою Canvas. Огляд користувацьких сторінок для програм на основі моделі.

Вбудовування компонованої програми за допомогою сучасного інтерфейсу

Щоб вбудувати компоновану програму в основну форму модельної програми, наприклад, в основну форму таблиці «Бізнес-партнер», виконайте наведені нижче дії.

1. Увійти до Power Apps.

2. Виберіть середовище, а потім виберіть елемент Рішення в області переходів ліворуч. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.

3. Відкрийте рішення, яке містить таблицю, до якої потрібно додати програму на полотні до головної форми.

4. Відкрийте таблицю, виберіть пункт Форми, а потім відкрийте потрібну форму Головне .

   Підказка

   За замовчуванням мітка компонента програми Canvas — New canvas app. Можна змінити назву етикетки програми на полотні на більш зрозумілу, наприклад назву програми на полотні або короткий опис програми, яку ви вбудовуєте у форму.

5. Виберіть область на формі, де має відображатися програма Canvas, або створіть нову вкладку для відображення програми Canvas.

6. В області переходів ліворуч виберіть елемент Компоненти, розгорніть елемент Дисплей, а потім виберіть компонент програми Canvas.

7. Для елемента керування можна настроїти наведені нижче властивості.

   • Область Ім’я сутності дає змогу вказати такі властивості:

     • Прив’язати до стовпця таблиці: коли вибрано стовпець Прив’язати до стовпця таблиці, властивість Статичне значення змінюється, щоб ви могли вибрати, до якого стовпця таблиці прив’язати. Якщо вибрати прив'язування до стовпця таблиці, стовпець визначатиметься значенням у стовпці таблиці. Наприклад, якщо для параметра Ім’я сутності вибрано параметр Прив’язати до стовпця таблиці, під час виконання програми значення імені таблиці приймає вказане значення вказаного стовпця Таблиця.

     • Статичне значення: використовуйте це, щоб додати ім'я, яке згадуватиме компоновану програму. Зауважте, що це значення не впливає на вбудовану компоновану програму. Він призначений лише для того, щоб служити орієнтиром.

   • Область Назва програми визначає унікальне ім’я програми на полотні.

     • Прив’язати до стовпця таблиці: якщо вибрати параметр Прив’язати до стовпця таблиці, властивість Статичне значення зміниться, щоб ви могли вибрати , до якого стовпця таблиці прив’язати. Якщо вибрати прив'язування до стовпця таблиці, стовпець визначатиметься значенням у стовпці таблиці. Наприклад, якщо вибрати параметр Прив’язати до стовпця таблиці для параметра Назва застосунку , під час виконання програми значення імені застосунку прийматиме значення стовпця Таблиця, наприклад значення настроюваного текстового стовпця.

     • Статичне значення: вказує унікальне ім’я програми на полотні, яку потрібно вбудувати. Введіть унікальне ім’я програми на полотні для наявної програми на полотні. Додаткові відомості: Пошук унікального імені та ідентифікатора програми на полотні

   • У обов’язковій області ідентифікатора додатка вказується ідентифікатор додатка.

     • Прив'язати до стовпця таблиці: якщо вибрати Прив'язати до стовпця таблиці, список зміниться, і ви зможете вибрати стовпець таблиці для прив'язування. Якщо вибрати прив'язування до стовпця таблиці, стовпець визначатиметься значенням у стовпці таблиці. Наприклад, якщо вибрати Прив'язати до стовпця таблиці для Ім'я програми, під час виконання програми значення імені програми приймає значення стовпця, тобто, значення зі стовпця з настроюваним текстом.

     Важливо

     У більшості випадків ми не рекомендуємо використовувати для ідентифікатора додатка параметр Прив’язати до стовпця таблиці, оскільки для цього в полі запису потрібно відображати правильний ідентифікатор додатка.

     • Статичне значення: введіть ідентифікатор наявної компонованої програми. Додаткові відомості: Пошук унікального імені та ідентифікатора програми на полотні

   • Відображення компонента на. Указує тип клієнта для відображення вбудованої компонованої програми. Виберіть один з варіантів: Веб, Мобільний або Планшет.

8. Виберіть Готово. Потім, щоб опублікувати додаток і зробити його доступним для користувачів, натисніть Опублікувати.

Після публікації вбудованої компонованої програми на модельній формі надайте спільний доступ до цієї вбудованої компонованої програми іншим користувачам. Додаткові відомості: Надайте спільний доступ до програми із вбудованим полотном.

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

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

Як знайти унікальну назву та ідентифікатор програми на полотні

Елемент керування програми Canvas спочатку шукає програму Canvas, використовуючи унікальне ім’я, яке можна знайти в полі Назва програми. Якщо програму Canvas з таким унікальним ім’ям не вдається знайти в середовищі, елемент керування програми Canvas використовує вказане значення в полі Ідентифікатор програми, щоб завантажити програму на полотні. Хоча значення потрібно вводити як у поля "Назва додатка", так і в поля "Ідентифікатор додатка", лише одне значення має бути точним, щоб програма із вбудованим полотном завантажила в елемент керування. Зауважте, що програма Canvas має бути в поточному середовищі.

• Поле «Назва програми» – це унікальне ім’я програми на полотні. Щоб знайти унікальне ім’я, додайте програму на полотні до рішення. Унікальне ім’я програми на полотні відображається у стовпці Ім’я та відображається у формі solutionpublisherprefix_appnamenospaces_appendix. Наприклад, contoso_canvasappwithsharepointlist_5ee16.
• Властивість Ідентифікатор програми вказує ідентифікатор програми із вбудованим полотном. Введіть ідентифікатор наявного полотняного додатка. Ідентифікатор компонованої програми можна знайти в Power Apps, для чого відкрийте Програми, виберіть компоновану програму, а потім виберіть Докладні відомості на панелі команд.

Вбудовування компонованої програми допомогою класичного інтерфейсу

1. Увійти до Power Apps.

2. Створення або редагування основної форми таблиці, у нашому прикладі таблиця «Бізнес-партнери».

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

4. У класичному конструкторі форм виберіть розділ у формі, де потрібно, щоб відображалася програма із вбудованим полотном.

5. За допомогою області стовпців додайте потрібний стовпець, наприклад Ім’я бізнес-партнера.

   Важливо

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

6. Вибравши стовпець, на вкладці Головна в групі Редагувати виберіть Змінити властивості.

7. У діалоговому вікні Властивості стовпця виберіть вкладку Елементи керування.

8. У вкладці Елементи керування виберіть Додати елемент керування.

9. У діалоговому вікні Додати елемент керування у списку доступних елементів керування виберіть Програма з полотном, а потім виберіть Додати.

10. У діалоговому вікні Властивості стовпця у списку елементів керування виберіть пункт Компонована програма і виберіть параметр Веб.

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

    • Властивість Ім’я таблиці визначає таблицю, що надаватиме дані для вашої вбудованої компонованої програми. Для неї буде встановлено таблицю, що містить стовпець, доданий у попередньому кроці.
      • Зауважте, що навіть якщо ця властивість виглядає змінною, її зміна не впливає на програму із вбудованим полотном. Він призначений лише для того, щоб служити для вас орієнтиром.
    • Властивість Ім’я програми вказує ім’я компонованої програми, яку необхідно вбудувати. Модельна форма шукає компоновану програму із вказаним іменем у поточному середовищі. Якщо у середовищі не вдається знайти компоновану програму із таким іменем, елемент керування «Компонована програма» для завантаження компонованої програми використовуватиме ідентифікатор програми. Введіть ім'я програми для наявної компонованої програми.
    • Властивість Ідентифікатор програми вказує ідентифікатор програми із вбудованим полотном. Можна ввести ідентифікатор програми для наявної компонованої програми, або ж ідентифікатор програми буде створено та введено автоматично, якщо створити або відредагувати компоновану програму, вибравши Настроїти. Ідентифікатор компонованої програми можна знайти в Power Apps, для чого відкрийте Програми, виберіть компоновану програму, а потім виберіть Докладні відомості на панелі команд.

    Примітка

    Зауважте, що будь-яка зміна значення Ідентифікатора програми може зламати посилання з форми на основі моделі на програму із вбудованим полотном.

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

12. Якщо ви додаєте завершену компоновану програму, переходьте до кроку 20. Якщо ви створюєте нову або редагуєте наявну програму на полотні, продовжуйте виконувати наведені нижче дії. Виберіть Настроїти, щоб створити або змінити компоновану програму. У новій вкладці буде відкрито Power Apps Studio.

    Примітка

    Якщо відкриття Power Apps Studio заблоковано через блокування спливаючих елементів веб-браузера, необхідно ввімкнути сайт web.powerapps.com або тимчасово вимкнути блокувальника спливаючих вікон і знову вибрати Настроювання.

13. Перегляньте наведені нижче дані.

    • Зверніть Power Apps Studio увагу, що в лівій панелі є спеціальний елемент керування ModelDrivenFormIntegration . Цей елемент керування відповідає за внесення контекстних даних із форми-хосту на основі моделі у програму із вбудованим полотном.
    • Зверніть увагу на те, що елемент керування формою полотна автоматично додано до вбудованого застосунку "полотно" і відобразить дані передаються до нього зі форми хост-моделі за допомогою елемента керування ModelDrivenFormIntegration.
    • Перейдіть на вкладку Перегляд, а потім виберіть Джерело даних. Зверніть увагу на те, що джерело даних для батьківської таблиці вашої хост-форми на основі моделі, у цьому випадку для сутності «Бізнес-партнери», буде автоматично додано до вбудованої компонованої програми. - Виберіть елемент керування Form1 і перевірте, чи властивість DataSource встановлено у значення Бізнес-партнери.
    • Коли вибрано елемент керування Form1, перевірте, чи властивість Елемент встановлено у значення ModelDrivenFormIntegration.Item.

    Примітка

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

14. В області властивостей праворуч, поруч із пунктом Стовпці виберіть Змінити стовпці.

15. Виберіть +Додати стовпець, щоб додати інший стовпець до форми компонованої програми або змінити порядок наявних стовпців за допомогою перетягування. Закрийте область даних після додавання стовпців і їх перевпорядкування.

16. Виберіть вкладку Файл, а потім виберіть Зберегти.

17. Виберіть вкладку Хмара. Введіть унікальне ім'я для програми, а потім виберіть Зберегти в нижній частині праворуч. Зверніть увагу на таку поведінку:

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

18. У меню виберіть команду Назад.

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

    Важливо

    • Конструктор форм має пряме посилання на Power Apps Studio, яке було відкрито в іншій вкладці браузера в попередньому кроці.
    • Переконайтеся, що назва програми має значення, схоже на знімок екрана нижче. Властивість назви програми визначає унікальне ім’я, яке використовуватиметься для посилання на компоновану програму під час виконання. Якщо це ім’я не задано, властивість ідентифікатора програми буде використовуватися для посилання на компоновану програму, що може спричинити проблеми під час імпортування компонованої програми як частини рішення. Рекомендуємо задати це ім’я, щоб забезпечити правильне посилання на компоновану програму між середовищами. Щоб задати його, поверніться до кроку 12 і виконайте кроки для створення компонованої програми, яку потрібно вбудувати.
    

20. У діалоговому вікні Властивості стовпця виберіть вкладку Відображення.

21. Зніміть позначку з пункту Відображати підпис у формі та виберіть OK.

    • Якщо у вас вже є програма з полотном, вбудована в цій формі, відображається повідомлення про те, що "Лише одну програму з полотном можна ввімкнути у формі." Для додавання нової компонованої програми слід спочатку вимкнути поточну вбудовану компоновану програму. Потім увімкніть нову вбудовану програму з полотном.

22. У вкладці Головна виберіть Зберегти, а тоді натисніть Опублікувати.

Статті за темою

Редагування програми з вбудованим полотном у формі на основі моделі
Виконання наперед визначених дій у формі розміщення із програми з вбудованим полотном
Властивості та дії елемента керування ModelDrivenFormIntegration
Поради щодо роботи з програмами із вбудованим полотном