Настройка Mobile Offline для приложений на основе холста

Статья
04/13/2024

Включите автономный режим в своем приложении на основе холста, если пользователям нужно работать, не беспокоясь о своем подключении к Интернету.

Предварительные условия

Приложение на основе холста должно находиться в решении.
Явный выбор столбцов должен быть включен. Чтобы включить эту функцию, откройте приложение на основе холста для редактирования, а затем выберите Настройки > Будущие возможности > Предварительная версия. Установите переключатель Явный выбор столбцов в положение Вкл..
Для настройки автономного режима для приложений на основе холста у вас должна быть роль создателя ресурсов среды, системного администратора или настройщика системы. Эти роли имеют права на создание, чтение, запись, удаление и предоставление доступа в отношении таблиц Canvas App и Mobile offline profile. Подробнее о стандартных ролях безопасности.
Пользователи с ролью «базовый пользователь» не могут открывать автономное приложение. Вы должны создать собственную роль безопасности с правами чтения для таблиц Canvas App и Mobile offline profile.
Если у вас уже есть пользовательская роль безопасности, убедитесь, что она предоставляет право на чтение в отношении таблиц Canvas App и Mobile offline profile. Подробнее о других привилегиях.

Оптимизируйте свое приложение для Mobile Offline

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

При разработке приложения для мобильного автономного использования придерживайтесь следующих рекомендаций:

Производительность имеет решающее значение при использовании приложения на мобильном устройстве. Дополнительную информацию о создании производительных приложений на основе холста см. в статье Обзор создания производительных приложений.
Определите функционально связанные сценарии на ходу, например задачи, выполняемые пользователями, работающими в полевых условиях.
Уменьшите сложность своего приложения, ограничив количество таблиц, которые необходимо загружать на устройство. Иногда лучше иметь два приложения вместо одного.
Используйте представления, оптимизированные для работы, а не для отображения большого набора данных. Например, предпочтительнее использовать представление Мои активные организации, а не представление Все организации.

Включение поддержки автономного режима для таблиц

Для таблиц, используемых в вашем автономном приложении, должна быть включена поддержка автономного режима. У некоторых встроенных таблиц она включена по умолчанию. Некоторые таблицы нельзя использовать в автономном режиме. Однако вы можете включить автономный режим для любой новой пользовательской таблицы.

Войдите в Power Apps.
На левой панели выберите Таблицы.
Выберите таблицу и выберите Изменить.
Выберите Изменить свойства таблицы.
Выберите Дополнительные параметры, а затем прокрутите до раздела Строки в этой таблице.
Установите флажок Могут использоваться в автономном режиме.
Выберите Сохранить.

Включение поддержки автономного режима для приложения

В Power Apps Studio на левой панели выберите Приложения.
Выберите свое приложение на основе холста, затем выберите Изменить.
Выберите Параметры.
Выберите Общие сведения.
Включите параметр Может использоваться в автономном режиме.
Выберите автономный профиль. В этом случае у вас есть два варианта.
- Использовать автоматически созданный профиль. Этот вариант обеспечивает загрузку таблиц, используемых в приложении, и является рекомендуемым.
- Создать собственный профиль и выбрать значок Обновить, чтобы увидеть новый профиль в списке, а затем выбрать его.
  
  Если вы не видите параметр Может использоваться в автономном режиме, убедитесь, что приложение входит в состав решения.
Закройте окно Параметры, а затем сохраните и опубликуйте свое приложение.

Страница, основанная на автономном шаблоне, автоматически вставляется в приложение. На странице есть значок, который использует функцию Подключение Power Fx для отражения состояния автономной синхронизации приложения. Вы можете использовать его как есть или изменить в соответствии со своими задачами.

Примечание

Если вы включаете возможность работы в автономном режиме для совершенно нового приложения на основе холста, убедитесь, что первый экран по умолчанию основан на шаблоне Автономный.

Создание профиля Mobile Offline

Если автоматически сгенерированный автономный профиль не соответствует вашим потребностям, создайте свой собственный. Подробнее о рекомендациях по созданию автономных профилей.

Новый автономный профиль необходимо опубликовать, прежде чем вы сможете выбрать его в параметрах своего приложения на основе холста. Если вы редактируете и публикуете автономный профиль, вы также должны опубликовать все приложения на основе холста, в которых он используется.

Создание автономного профиля (с правами администратора)

Войдите в центр администрирования Power Platform с учетной записью администратора.
На левой панели выберите Среды.
Выберите среду, затем выберите Параметры.
Разверните раздел Пользователи + разрешения, затем выберите Мобильная конфигурация.
Выберите Создать новый профиль.
Введите имя и описание, а затем выберите Создать.
После создания профиля выберите его, чтобы продолжить редактирование.
В разделе Данные, доступные в автономном режиме выберите Добавить таблицу.
Выберите таблицу из списка. В списке отображаются только те таблицы, которые можно использовать в автономном режиме.
Выберите Далее.

Выберите фильтр в соответствии с типом собственности таблицы.

Тип владения таблицей	Доступные параметры фильтра для загрузки данных
Пользователь или рабочая группа	Загружать только связанные строки — сделать связанные данные таблицы доступными в автономном режиме. Если не настроить ни одной связи, строки из этой таблицы доступны не будут. Все строки — сделать все строки в этой таблице доступными в автономном режиме. Другой фильтр данных — сделать доступными в автономном режиме только указанные строки в этой таблице. Выберите один из следующих вариантов: Загружать строки пользователя — сделать доступными в автономном режиме только ваши строки. Загружать строки рабочей группы — сделать доступными в автономном режиме строки вашей рабочей группы. Загружать строки моей бизнес-единицы — сделать доступными в автономном режиме строки вашей бизнес-единицы.
Организация	Загружать только связанные строки — сделать связанные данные таблицы доступными в автономном режиме. Если не настроить ни одного отношения, никакие строки из этой таблицы доступны не будут. Все строки — сделать все строки в этой таблице доступными в автономном режиме.
Бизнес	Загружать только связанные данные — сделать доступными в автономном режиме связанные данные таблицы. Если не настроить ни одного отношения, никакие строки из этой таблицы доступны не будут. Все строки — сделать все строки в этой таблице доступными в автономном режиме. Другие строки — сделать доступными в автономном режиме только указанные строки в этой таблице. Выберите один из следующих вариантов: Загружать строки моей бизнес-единицы — сделать доступными в автономном режиме строки вашей бизнес-единицы.
None	Загружать только связанные строки — сделать связанные данные таблицы доступными в автономном режиме. Если не настроить ни одного отношения, никакие строки из этой таблицы доступны не будут.

Если вы выберете Пользовательский, вы сможете определить пользовательский фильтр глубиной до трех уровней со следующими правилами.

Правила
равно	не равно	gt – больше
ge – больше или равно	le – меньше или равно	lt – меньше
like	not-like	в папке
not-in	null	not-null
eq-userid	ne-userid	eq-userteams
eq-useroruserteams	eq-useroruserhierarchy	eq-useroruserhierarchyandteams
eq-businessid	ne-businessid	eq-userlanguage
begins-with	not-begin-with	ends-with
not-end-with

В разделе Включить записи [название таблицы], связанные с этими таблицами выберите отношения связанных таблицы. Вы должны предварительно добавить таблицу, с которой вы хотите создать связь. Например, если вы хотите добавить отношение между таблицами Account и Contact, вам необходимо добавить обе таблицы в профиль Mobile Offline.

Например, если вы выберете Контакт | Имя поля: Основной контакт, это означает, что для каждого контакта система также загружает связанную с ним организацию.
Выберите Сохранить.

Создание автономного профиля (без прав администратора)

Если у вашей учетной записи Power Apps нет прав администратора, вы все равно можете создать профиль Mobile Offline. Скоро вы сможете создавать автономные профили прямо в Power Apps Studio. До тех пор используйте следующий обходной путь.

Создайте в своей тестовой среде приложение, в котором используются те же таблицы, что и в вашем приложении на основе холста.
Настройте приложение на основе модели для автономного использования.
Создайте профиль по умолчанию и добавьте таблицы с фильтрами.
Опубликуйте приложение на основе модели.
Выберите автономный профиль в приложении на основе холста.

Создание автономного приложения на основе холста

Чтобы упростить создание или преобразование приложений на основе холста для автономного использования, мы создали шаблон Автономный. Шаблон включает в себя значок земного шара на панели навигации, который показывает состояние подключения и синхронизации, делая использование автономного режима максимально удобным. Пользователи всегда знают, готовы ли их устройство и данные к автономной работе.

Новая страница, созданная на основе шаблона Автономный, вставляется автоматически, как только вы включаете в своем приложении на основе холста поддержку автономного режима.

Снимок экрана страницы на основе шаблона «Автономный», показанной на холсте Power Apps Studio.

Вы также можете добавить новую страницу на основе шаблона Автономный точно так же, как добавляете страницы из любого другого шаблона.

Снимок экрана с галереей шаблонов с выделенным шаблоном «Автономный».

Значок земного шара на панели навигации шаблона меняет изображение в зависимости от значения функции Power Fx Connection.Sync. Вы можете создать свой собственный значок и установить свойство Icon, используя следующий скрипт Power Fx.

Switch(Connection.Sync, 

   ConnectionSync.Connected, Icon.Globe,  

   ConnectionSync.ConnectedWithWarning, Icon.GlobeWarning, 

   ConnectionSync.ConnectedPendingUpsync, Icon.GlobeChangesPending, 

   ConnectionSync.ConnectedError, Icon.GlobeError, 

   ConnectionSync.ConnectedRefresh, Icon.GlobeRefresh, 

   ConnectionSync.NotConnected, Icon.GlobeNotConnected,  

   ConnectionSync.NotConnectedWithWarning, Icon.GlobeWarning, 

   ConnectionSync.NotConnectedPendingUpsync, Icon.GlobeChangesPending, 

   ConnectionSync.NotConnectedSyncError, Icon.GlobeError)

Вы можете задать свойство OnSelect с помощью функции Power FxShowHostInfo, чтобы отображать страницу «Состояние устройства» при выборе значка глобуса.

ShowHostInfo(HostInfo.OfflineSync)

Вы можете задать свойство Visible с помощью функции Power Fx Host, чтобы значок глобуса отображался только при использовании приложения в проигрывателе, поддерживающем автономный режим.

Host.OfflineEnabled

Как сделать автономный режим максимально удобным для пользователей?

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

Сценарий	Нерекомендуемый подход	Рекомендуемый подход
Отображение информации о связанных таблицах в галерее.	Использование поиска для получения данных.	Использование представления, содержащего столбец связанной таблицы.
Создание фильтруемой галереи с большим количеством записей.	Загрузка записей из Dataverse и сохраните их в коллекции. Добавление элементов галереи в отфильтрованную коллекцию.	Добавление элементов галереи непосредственно в отфильтрованные данные Dataverse.
Обновление нескольких записей	Исправление записей по отдельности.	Массовое исправление коллекции, содержащее все изменения.

Экспортируйте решение, содержащее приложение на основе холста, поддерживающее автономную работу

При экспорте решения с помощью автономного приложения на основе холста вам также необходимо экспортировать автономный профиль для приложения, поскольку он является зависимостью приложения.

Войдите в Power Apps и на левой панели навигации выберите Решения.
Выберите решение, которое нужно экспортировать, затем выберите Экспорт.
Выберите приложение на основе холста, для которого включена работа в автономном режиме, затем выберите Дополнительно > Добавить необходимые объекты.

Убедитесь, что связанный автономный профиль присутствует в решении, после чего его можно экспортировать.

Известные проблемы и ограничения

Автоматически созданный автономный профиль не обрабатывает фильтры. В результате для каждой таблицы, используемой в приложении, загружаются все строки, на которые у пользователя есть разрешения.
Отличные от Dataverse соединители, например соединители SharePoint, не поддерживаются в автономном режиме.
Элементы в галерее в автономном приложении могут отображаться в другом порядке, если не выбран порядок сортировки. Выберите порядок сортировки в элементе управления «Галерея», чтобы приложение вело себя одинаково в мобильных приложениях и веб-браузерах.
Отношения «многие-ко-многим» не поддерживаются в автономном режиме.
Узнайте о возможностях и ограничениях языка Power Fx.
Подробнее о возможностях и ограничениях Mobile Offline.