Поради та виправлення неполадок для вбудованих компонованих програм

2024-01-10

Інструкції щодо вбудовування компонованих програм

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

Вбудовані програми полотна підтримуються лише за допомогою програм єдиного інтерфейсу на основі моделі.
Можна ввімкнути лише три вбудовані компоновані програми для кожної форми для браузера, а також одну для типів клієнтів «Планшет» і «Телефон».
До форми можна додати кілька вбудованих компонованих програм, але можна ввімкнути лише три програми для браузера, а також одну для типів клієнтів «Планшет» і «Телефон».
Якщо ввімкнено більше трьох вбудованих програм полотна з типом веб-клієнта на моделі, у повідомленні про помилку відображається таке «У вас більше трьох програм полотна з веб-форм-фактором, максимум три для цього форм-фактора. Кількість компонованих програм обмежено трьома для форм-фактора «Веб» і однією для форм-факторів «Планшет» і «Телефон».
Щоб увімкнути або вимкнути програму вбудованого полотна, перегляньте статті Увімкнення програми вбудованого полотна та Вимкнення програми вбудованого полотна.
Для кожної вкладки форми рекомендовано мати одну вбудовану компоновану програму для кожного форм-фактора.
Під час додавання вбудованої компонованої програми до форми на основі моделі завжди використовуйте стовпець, який обов'язково повинен мати значення. Якщо стовпець не має значення, програма вбудованого полотна не оновлюватиметься у відповідь на будь-які зміни в даних у формі, керованій моделлю хоста.
Публікація форми на основі моделі також не публікує вбудовану програму полотна.
- Вбудована компонована програма повинна бути опублікована незалежно від форми на основі моделі, в якій її розміщено. Докладніше: Публікація програми.
Якщо відкриття Power Apps Studio для створення або редагування вбудованої програми полотна за допомогою кнопки «Налаштувати » у властивостях керування програмою «Полотно» заблоковано через блокувальник спливаючих вікон у веб-браузері, вам потрібно ввімкнути сайт make.powerapps.com або тимчасово вимкнути блокувальник спливаючих вікон, а потім знову натиснути «Налаштувати ».
Програми вбудованого полотна не відображаються під час створення нового рядка, оскільки їм потрібно передати контекст рядка.
Об'єкт ModelDrivenFormIntegration.Item доступний лише для читання.
- Для запису зворотних даних необхідно використовувати Dataverse коннектор. Додаткова інформація: Microsoft Dataverse
Програми з вбудованим полотном можна створювати через розміщену форму на основі моделі.
Якщо під час перегляду модельної форми з вбудованою компонованою програмою з’являється повідомлення про помилку «Схоже, у вас немає доступу до цієї програми. Попросіть її власника надати вам доступ», переконайтеся, що автор поділився цією компонованою програмою з вами. Додаткові відомості: Спільний доступ до вбудованої програми для роботи з полотном.
Додавання компонованої програми в елементі керування вкладеної сітки більше не доступне.
- У підготовчому випуску виробники могли додати компоновану програму в елементі керування вкладеною сіткою. Оскільки вбудовування компонованої програми у форми на основі моделі тепер загальнодоступне, додавання вбудованої компонованої програми у форму на основі моделі оптимізовано для стовпця.
- Це полегшує роботу виробникам, оскільки їм не потрібно заздалегідь вирішувати, чи передавати поточний рядок (основну форму) як контекст даних або як список рядків, пов'язаних із поточним рядком (основною формою).
- Виробники завжди починають із стовпця і можуть отримати доступ як до поточного рядка (основної форми), так і до списку рядків, пов'язаних із поточним рядком (основною формою).
- Щоб отримати доступ до списку пов’язаних рядків у програмі «Полотно», творці можуть використовувати функцію «З’єднувач» Dataverse і «Фільтр», а в програмі «Полотно» ввімкнено функцію «Покращення джерел даних і Dataverse подань ».
  Наприклад, щоб отримати доступ до перегляду «Активні контакти » таблиці «Контакти », виробники можуть використовувати: Фільтр(Контакти, ’Контакти (Перегляди)’. Активні контакти»).
- Наявні компоновані програми, які використовують елемент керування вкладеною сіткою, продовжуватимуть працювати. Однак рекомендовано перенести ці програми, щоб натомість використовувати стовпець. Додаткові відомості: Міграція вбудованих програм полотна у формах, керованих моделлю, які використовують список рядків, пов’язаних із поточним (основною формою) рядком для отримання детальної інформації.

Увімкніть програму із вбудованим полотном

Виберіть стовпець, який було настроєно для відображення як вбудованої компонованої програми.
У діалоговому вікні «Властивості стовпця» виберіть вкладку «Елементи керування ».
У списку елементів керування виберіть програму Canvas, а потім виберіть опцію Web .
Виберіть ОК.

Вимкніть програму із вбудованим полотном

Виберіть стовпець, який було настроєно для відображення як вбудованої компонованої програми.
У діалоговому вікні «Властивості стовпця» виберіть вкладку «Елементи керування ».
У списку елементів керування виберіть елемент керування за промовчанням, а потім виберіть параметр Веб.
Виберіть ОК.

Збереження даних у вбудованій компонованій програмі

Подія збереження, зроблена з модельної програми, наприклад натискання кнопки «Зберегти» на панелі команд основної форми, не зберігає зміни, внесені в вбудовану програму з полотном.
Щоб зберегти зміни, внесені у вбудовану програму полотна, скористайтеся сполучною конекторою Dataverse .
Елемент керування ModelDrivenFormIntegration OnDataRefresh слід використовувати лише для оновлення даних у вбудованій компонованій програмі. Не рекомендуємо використовувати дію OnDataRefresh, щоб зберегти зміни у вбудованій компонованій програмі.

Відомі проблеми та обмеження із програмами з вбудованим полотном

Обмеження

Користувацький елемент керування програмою «Полотно» підтримується лише для використання з типом веб-клієнта . Наразі типи клієнтів для телефонів і планшетів не підтримуються.
Привілеї програми Canvas у ролі безпеки не можна використовувати, щоб надавати користувачам доступ до вбудованої або окремої програми полотна. Щоб отримати докладнішу інформацію про надання спільного доступу до вбудованої програми полотна, перейдіть за посиланням: Спільний доступ до програми вбудованого полотна.
Якщо записати ті самі дані, що відображаються у формі на основі моделі хоста, у формі відображатимуться старі дані, доки їх не буде оновлено. Простий спосіб зробити це – використовувати метод RefreshForm .
Автономні елементи керування та керування можливостями пристрою, як-от сканування штрих-кодів, зйомка фотографій із пристрою або вкладення файлів, не підтримуються у вбудованих програмах полотна.

Наприклад, коли елемент керування ModelDrivenFormIntegration підключено до таблиці Accounts за допомогою ModelDrivenFormIntegration.Item.’ ’Primary Contact’. Повне ім’я’ не повертатиме значення.

Щоб отримати доступ до стовпців пов’язаної таблиці, виробники можуть використовувати будь-який із перелічених тут виразів: - LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data). ItemId))». Основний контакт». Прізвище, ім’я, по батькові
- ItemId є порожнім під час створення, але матиме значення під час виконання. - LookUp(Облікові записи, Обліковий запис = ModelDrivenFormIntegration.Item.Account).’ Основний контакт». Прізвище, ім’я, по батькові’( Цей вираз легше читається, але попередній вираз буде працювати трохи краще.)

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

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

Для адаптивних програм:

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

Для програм, які не відповідають:

Ми рекомендуємо вам увімкнути опцію Масштаб за розміром . Це допомагає програмі змінювати розмір відповідно до доступного простору.

В обох сценаріях переконайтеся, що значення властивості «Ім’я програми» встановлено та правильно визначено в елементі керування вбудованим полотном програми.

Вбудована компонована програма не враховує висоту

Властивість «Висота поля форми» не дотримується компонентом програми «полотно». Виміри компонента компонованої програми (якщо вбудовано) враховують пропорції, встановлені в компонованій програмі. Оскільки пропорції фіксовані, висота компонента компонованої програми розраховується відносно ширини програми. Ширина програми визначається на підставі горизонтального місця, доступного в модельній програмі. Якщо ви хочете внести корективи в висоту компонента програми полотна, рекомендуємо налаштувати співвідношення сторін у вашій програмі canvas. Зауважте, що для настроювання пропорцій програма повинна бути макетом планшета.

Увімкніть масштаб за розміром

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

Відкрийте для редагування компоновану програму, яку ви вбудовуєте на форму модельної програми.
У Power Apps студії виберіть Налаштування>файлу>Розмір екрана + орієнтація.
У розділі «Додаткові налаштування» встановіть для параметра «Масштаб» значення«Увімк.».

Значення властивості «Ім'я програми» відсутнє або визначено неправильно

Щоб вирішити цю проблему, виберіть правильний варіант.

Керовані рішення: якщо рішення було імпортовано до середовища як кероване рішення, виконайте наведені далі кроки.
1. Увійдіть до Power Apps та перейдіть до середовища розробки, де було створено вашу вбудовану компоновану програму. Це також середовище, з якого було експортовано рішення.
2. Відкрийте некероване рішення, яке містить потрібну компоновану програму, а потім знайдіть компоновану програму у списку компонентів рішення. Скопіюйте ім’я програми canvas точно так, як воно відображається в списку компонентів. Наприклад, contoso_flooringestimatesapp_624d7.
3. У тому ж рішенні відредагуйте програму на основі моделі, яка має вбудований елемент керування полотном, а потім встановіть ім’я програми на полотно для вбудованого елемента керування програмою полотна, використовуючи значення з попереднього кроку. Додаткові відомості: Додавання вбудованої програми полотна у форму, керовану моделлю
4. Експортуйте рішення з середовища розробки, а потім імпортуйте рішення до цільового середовища.
Некеровані рішення: якщо рішення імпортовано в середовище як некероване, відредагуйте програму на основі моделі, яка має вбудований елемент керування полотном, а потім виконайте дії, подібні до описаних для керованого рішення, щоб установити властивість «Ім’я програми» на полотні .

Вбудований елемент керування «Компонована програма» завантажує компоновану програму з іншого середовища

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

Ця проблема виникає, оскільки користувач програми не має доступу для читання до таблиці розширених метаданих компонованої програми в цільовому (поточному) середовищі. Щоб вирішити цю проблему, додайте користувача до ролі безпеки, що використовується для програми, яка має доступ для читання до таблиці розширених метаданих компонованої програми. Додаткові відомості: Надання прав на читання для таблиці розширених метаданих CanvasApp

Повідомлення про помилку: «Вам бракує прав на читання сутності "Компонована програма". Зверніться до адміністратора»

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

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

Надання прав на читання для таблиці розширених метаданих компонованої програми

У Power Apps меню виберіть середовище, а потім на лівій панелі навігації виберіть Програми.
Виберіть потрібну програму, натисніть ..., а потім натисніть кнопку Спільний доступ.
В області ліворуч виберіть програму, а потім – Керування ролями безпеки.
Відкрийте роль безпеки, призначену програмі, наприклад роль безпеки «Базовий користувач».
Виберіть вкладку «Користувацькі сутності » та встановіть привілеї на читання обсягу організації для таблиці розширених метаданих CanvasApp.
Виберіть «Зберегти та закрити», щоб закрити вікно ролі безпеки.

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

Вбудовування програми полотна у форму на основі моделі
Додавання вбудованої програми полотна у форму на основі моделі
Редагування програми полотна, вбудованої у форму на основі моделі
Настроювання розміру та орієнтації екрана програми Canvas, вбудованої у форму на основі моделі
Виконуйте попередньо визначені дії у формі хоста у вбудованій програмі Canvas
Властивості та дії елемента керування ModelDrivenFormIntegration
Надання спільного доступу до вбудованої програми для роботи з полотном
Міграція вбудованих програм полотна у формах на основі моделі, створених за допомогою загальнодоступного попереднього випуску, до останньої версії