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

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

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

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

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

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

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

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

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

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

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

Обмеження

• Настроюваний елемент керування програми з полотном підтримується лише для використання в типі клієнта Веб. Наразі типи клієнтів Телефон і Планшет не підтримуються.
• Не можна використовувати право Компонована програма в ролі безпеки, щоб надавати користувачам програми доступ до вбудованої або автономної компонованої програми. Для отримання додаткових відомостей про надання спільного доступу до компонованої програми, див.: Надання спільного доступу до вбудованих компонованих програм.
• Якщо записати ті самі дані, які відображаються у формі на основі хост-моделі, у формі відображатимуться старі дані, доки їх не буде оновлено. Простий спосіб це зробити — скористатися методом RefreshForm.
• Автономні елементи керування та керування можливостями пристрою, як-от сканування штрих-кодів, зйомка фотографій із пристрою або вкладення файлів, не підтримуються у вбудованих програмах на полотні.

Елемент керування ModelDrivenFormIntegration не надає значення для стовпців пов'язаної таблиці

Наприклад, якщо елемент керування ModelDrivenFormIntegration підключено до таблиці «Облікові записи» за допомогою параметра ModelDrivenFormIntegration.Item.’ «Основний контакт». Повне ім’я’ не повертає значення.

Щоб отримати доступ до стовпців пов‘язаної таблиці, виробники можуть використати будь-який із зазначених нижче виразів. - LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data).ItemId)).'Primary Contact'.'Full Name'
- ItemId пустий під час створення, але матиме значення під час виконання. - LookUp(Accounts, Account = ModelDrivenFormIntegration.Item.Account).'Primary Contact'.'Full Name' (Цей вираз простіше прочитати, але попередній вираз працюватиме трохи краще.)

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

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

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

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

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

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

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

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

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

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

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

1. Відкрийте для редагування компоновану програму, яку ви вбудовуєте на форму модельної програми.
2. У Power Apps Studio виберіть Файл > Параметри > Розмір та орієнтація екрана.
3. У розділі Додаткові параметри установіть для параметра Масштаб за розміром значення Увімкнуто.

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

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

• Керовані рішення: якщо рішення було імпортовано до середовища як кероване рішення, виконайте наведені далі кроки.

  1. Увійдіть до Power Apps та перейдіть до середовища розробки, де було створено вашу вбудовану компоновану програму. Це також середовище, з якого було експортовано рішення.

  2. Відкрийте некероване рішення, яке містить потрібну компоновану програму, а потім знайдіть компоновану програму у списку компонентів рішення. Скопіюйте Ім'я компонованої програми, точно так, як воно відображається у списку компонентів. Наприклад, contoso_flooringestimatesapp_624d7.

  3. У тому самому рішенні відредагуйте модельну програму, що має елемент керування із цією вбудованою компонованою програмою, і задайте значення властивості App Name компонованої програми у елементі керування, використовуючи значення з попереднього кроку. Додаткові відомості: Додавання вбудованої компонованої програми на модельну форму

  4. Експортуйте рішення з середовища розробки, а потім імпортуйте рішення до цільового середовища.

• Некеровані рішення: якщо рішення імпортовано в середовище як некероване, відредагуйте керовану моделлю програму, яка має вбудований елемент керування програмою на полотні, а потім виконайте дії, описані для кероване рішення, щоб установити властивість Назва програми на полотні .

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

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

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

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

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

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

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

1. У Power Apps виберіть середовище, потім в області переходів ліворуч виберіть Програми.
2. Виберіть потрібну програму, виберіть …, а потім виберіть Надати спільний доступ.
3. В області ліворуч виберіть програму, а потім виберіть Керувати ролями безпеки.
4. Відкрийте роль безпеки, призначену програмі, наприклад роль безпеки «Базовий користувач».
5. Виберіть вкладку Настроювані сутності та вкажіть права на читання області застосування організації для таблиці Розширені метадані компонованої програми.
6. Виберіть Зберегти та закрити, щоб закрити вікно ролі безпеки.

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

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

Примітка

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

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).