Общие проблемы и их разрешение для средства проверки решений
В данной статье перечислены некоторые общие проблемы, которые могут возникнуть при использовании средства проверки решений. Где применимо, представлены временные способы решения.
Вы не можете использовать средство проверки решений для выполнения анализа или загрузки результатов
Вскоре после отправки запроса средства проверки решения на выполнение анализа или загрузки результатов эта операция не выполняется и появляется сообщение об ошибке, например:
"Не удалось выполнить проверку для решения [Имя решения]. Попробуйте запустить повторно".
Если возможно, средство проверки решений пытается вернуть конкретное сообщение об ошибке, содержащее ссылку на сведения о потенциальной причине и шаги по разрешению. Выберите Подробнее для получения дополнительных сведений.
Сбои, которые происходят во время фоновой обработки анализа, происходят со статусом Не удалось завершить и возвращают сообщение об ошибке в портал Power Apps, а также отправляют уведомление по электронной почте пользователю, обратившемуся с запросом.
Выбор уведомления портала связывает с этой страницей общих проблем для дальнейшего устранения неисправностей. Если ни одна из указанных общих проблем не позволяет устранить неисправность, возвращается также ссылочный номер. Передайте этот ссылочный номер в службу поддержки Майкрософт для дальнейшего расследования.
Средство проверки решений не может проверить решение по умолчанию
Средство проверки решения экспортирует решение из среда Microsoft Power Platform для анализа. Экспорт решения по умолчанию не поддерживается, и проверка может быть не пройдена. Дополнительные сведения: Средство проверки решений не может экспортировать крупные решения.
Средство проверки решений завершается сбоем из-за неподдерживаемой версии средства проверки Power Apps
Средство проверки решений обеспечивается приложением "Средство проверки Power Apps". Если установлена версия приложения средства проверки Power Apps до версии 1.0.0.47, работа средства проверки решений может не завершаться успешно. Необходимо выполнить обновление версии средства проверки Power Apps из Центр администрирования Power Platform.
Однако если установлена версия средства проверки Power Apps до версии 1.0.0.45, рекомендуется удалить решение и установить его снова. В связи с недавними изменения схем обновление средства проверки Power Apps с версий до версии 1.0.0.45 может закончиться неудачей.
Если требуется сохранить прошлые результаты из средства проверки решений, экспортируйте результаты из предыдущих выполнений или экспортируйте все данные средства проверки решений с помощью функции Экспорт данных в Excel, чтобы экспортировать данные из следующих таблиц:
- Компонент анализа
- Задание анализа
- Результат анализа
- Подробность результата анализа
Как удалить средство проверки Power Apps
Чтобы удалить решение средства проверки Power Apps:
- Как системный администратор или настройщик системы, откройте портал Power Apps, перейдя по адресу https://make.powerapps.com/environments.
- Выберите Решения.
- Выберите Средство проверки Power Apps, затем на панели инструментов решений выберите Удалить.
Как установить средство проверки Power Apps
Чтобы установить средство проверки Power Apps обратно в среду:
- Как системный администратор или настройщик системы, откройте портал Power Apps, перейдя по адресу https://make.powerapps.com/environments.
- Выберите Решения.
- На панели инструментов выберите Средство проверки, затем выберите Установить.
Средство проверки решений не может получить доступ к средам в режиме администрирования
Среды, которые были переведены в режим администрирования, нарочно ограничивают доступ только пользователями с ролями системного администратора или специалиста по настройке системы. Поскольку идентификатору приложения средства проверки Power Apps по умолчанию не назначена ни одна из этих ролей, оно не может получить доступ к организациям, работающим в этом режиме.
Чтобы использовать средство проверки решений в этой организации режим администрирования должен быть отключен.
Отключение режима администрирования
Чтобы отключить режим администрирования для экземпляра организации:
Войдите в в центр администрирования Power Platform.
Откройте среду, в которой есть проблемы с запуском средства проверки решений, и выберите Изменить.
Отключите Режим администрирования, затем выберите Сохранить.
Снова запустите средство проверки решений.
Работа средства проверки решений завершается ошибкой из-за отсутствия ролей безопасности
Пользователю приложения для средства проверки решений должны быть назначены следующие роли безопасности для предоставления необходимых привилегий для обмена данными с организацией Dataverse. Если какая-либо из этих ролей не назначена пользователю Приложение "Средство проверки Power Apps", попытки выполнить анализ, загрузить результаты и выполнить отмену закончатся неудачей. Так происходит наиболее часто, когда у клиентов действует автоматизация, которая удаляет роли безопасности у неожиданных пользователей. Следующие роли безопасности содержат минимальные необходимые разрешения:
- Экспорт настроек (средство проверки решений)
- Автор статей по обслуживанию
- Средство проверки решений
Назначение отсутствующих ролей безопасности
Чтобы назначить отсутствующие роли безопасности пользователю приложения "Средство проверки Power Apps":
- В центре администрирования Power Platform перейдите к своей среде, а затем выберите Пользователи > список пользователей приложений.
- Выберите пользователя Приложение "Средство проверки Power Apps" в списке пользователей.
- В строке команд выберите Изменить роли безопасности.
- Установите флажки для ролей, перечисленных выше, а затем выберите Сохранить.
- Снова запустите средство проверки решений.
Работа средства проверки решений завершается ошибкой из-за режима ограниченного доступа
Пользователю приложения для средства проверки решений требуется режим доступа "Неинтерактивная" или "Чтение и запись" для связи с этой организацией Dataverse. Если режим доступа был изменен на другое значение, например "Административный", то попытки выполнить анализ, загрузить результаты и отменить выполнение закончатся неудачей.
Чтобы устранить эту проблему, необходимо обновить пользователя приложения Средство проверки Power Apps с режимом доступа "Неинтерактивный".
Как обновить режим доступа пользователей
Чтобы обновить режим доступа для пользователя средства проверки Power Apps:
- Откройте организацию Dataverse и перейдите к Параметры > Безопасность > Пользователи.
- Выберите пользователя Средство проверки Power Apps из списка пользователей и дважды щелкните, чтобы открыть форму пользователя.
- Прокрутите форму до раздела "Администрирование" > "Сведения о клиентской лицензии (CAL)".
- Выберите "Неинтерактивная" в раскрывающемся элементе управления Режим доступа.
- Сохраните и закройте форму пользователя.
- Снова запустите средство проверки решений.
Средство проверки решений завершается ошибкой из-за отключенного пользователя приложения
Пользователь приложения средства проверки Power Apps в организации Dataverse, содержащей решения для анализа, должен быть включен. Если пользователь приложения отключается, запросы на анализ решений в той же организации не будут выполняться. При получении этого сообщения об ошибке сначала убедитесь, что пользователь приложения средства проверки Power Apps действительно отключен. Затем выполните действия по смягчению последствий, приведенные ниже.
Как включить пользователя приложения средства проверки Power Apps
- В центре администрирования Power Platform выберите среду и перейдите Параметры > Разрешения пользователей > Пользователи.
- В представлении Пользователи приложения установите флажок рядом с пользователем приложения средства проверки Power Apps.
- На панели инструментов "Действия" щелкните Включить.
- В сообщении Подтверждение активации пользователя нажмите Активировать.
- Альтернативный подход — открыть форму пользователя приложения и выбрать состояние Включено в нижнем колонтитуле формы. Сохраните изменения.
Средство проверки решений остается в состоянии "Выполняется" более тридцати минут
Средство проверки решений может оставаться в рабочем состоянии неопределенное время, если анализируемое решение содержит подключаемые компоненты, разработанные с использованием .NET Standard 2.0. Подключаемые модули на основе .NET Standard 2.0 в настоящее время не поддерживаются средством проверки решений и должны быть исключены из анализа. Исключите подключаемый компонент, либо удалив его из целевого решения, либо используя параметр ExcludedFileNamePattern в модуле средства проверки PowerShell Power Apps.
Общие условия подключаемого модуля, которые вызывают сбой средства проверки решения
Когда средство проверки решений получает и обрабатывает запросы на анализ, оно должно вызвать конечную точку Dataverse для извлечения или обновления соответствующих данных задания и экспорта выбранных решений. Каждое взаимодействие, выполняемое службой средства проверки решений с Dataverse может потенциально вызвать один или несколько шагов плагина, которые были зарегистрированы в сообщении, отправленном в запросе. Эти подключаемые модули могут, в свою очередь, вводить условия, препятствующие обработке сообщения, как ожидается в Dataverse, и убрать возможность средства проверки решений обрабатывать запрошенное задание анализа. Подобные ситуации могут возникать при загрузке результатов задания средства проверки решения или отмене выполняемого анализа.
Типичные операции Dataverse, запрошенные средством проверки решенияоперация:
- Извлечение данных таблиц решения,
systemuser
и организации - Создание, обновление и получение данных о задании анализа, компоненте анализа и таблице результатов анализа
- Экспорт решений
Шаг подключаемого модуля зарегистрирован для выполнения в контексте нелицензированного пользователя
Когда средство проверки решений дает сбой из-за исключения "нелицензированный пользователь", причиной этого исключения часто является срабатывание шага подключаемого модуля, настроенного для выполнения в контексте определенного системного пользователя, который в настоящее время не лицензирован. Убедитесь, что все шаги подключаемого модуля, которые могут быть вызваны средством проверки решения, выполняются в контексте лицензированного пользователя.
Важно!
Настоятельно рекомендуется, чтобы шаги подключаемого модуля были сконфигурированы для выполнения в контексте вызывающего пользователя, а не конкретных пользователей, лицензия которых может быть отозвана.
Шаг подключаемого модуля выполняет операции, которые требуют привилегий, не предоставленных пользователю приложения средства проверки Power Apps
Если проверка решения завешается сбоем из-за того, что Dataverse отказывает в доступе из-за отсутствующей привилегии, причиной этого часто является сработавший шаг подключаемого модуля, который выполняет операции, требующие привилегий, в данный момент не предоставленных пользователю приложения средства проверки Power Apps. Либо перенастройте шаг подключаемого модуля, чтобы он не выполнялся в операции, вызванной средством проверки решений, либо предоставьте пользователю приложения средства проверки Power Apps необходимые привилегии для выполнения настраиваемого шага подключаемого модулярешение.
Шаг подключаемого модуля неожиданно прерывает выполнение, выдавая InvalidPluginExecutionException
Средство проверки решений может дать сбой из-за ошибок "Код независимого поставщика программного обеспечения прервал операцию" или "Произошла непредвиденная ошибка кода независимого поставщика программного обеспечения". Когда это происходит, это означает, что был запущен шаг подключаемого модуля, который явно прервал выполнение, вызвав исключение InvalidPluginExcecutionException, или что ошибка не была должным образом обработана в коде подключаемого модуля. Либо переконфигурируйте шаг подключаемого модуля, чтобы он не выполнялся в операции, вызванной средством проверки решения, либо настройте реализацию подключаемого модуля, чтобы не прерывать выполнение в соответствии с условиями, представленными средством проверки решения.
Общие операции, вызываемые средством проверки решений, включают создание и обновление. Эти операции могут происходить в следующих таблицах: задание анализа, компонент анализа или результат анализа.
Работа средства проверки решений завершается сбоем из-за отключенного собственного приложения в Microsoft Entra ID
Идентификатор собственного корпоративного приложения, используемый средством проверки решений (PowerApps-Advisor), не должен быть отключен в Microsoft Entra ID. Если он отключен, удостоверение не может пройти проверку подлинности при запросе токенов носителя для Dataverse и других необходимых поставщиков ресурсов от лица запрашивающего пользователя.
Следуйте инструкциям ниже, чтобы проверить, не отключено ли удостоверение приложения в Microsoft Entra и при необходимости включить его.
Как проверить и/или изменить статус включения приложения
Чтобы проверить и/или изменить статус включения удостоверения приложения предприятия PowerApps-Advisor
- Зайдите в свой клиент на портале Microsoft Entra.
- Перейдите в раздел Приложения Enterprise.
- Выберите Все приложение и выполните поиск PowerApps-Advisor.
- Выберите PowerApps-Advisor, чтобы просмотреть сведения приложения.
- Выберите Свойства.
- Проверьте статус Включен ли вход для пользователей. Если "Нет", то приложение отключено.
- Выберите переключатель, чтобы переключиться на значение "Да". Это включает приложение.
- Нажмите кнопку Сохранить. Приложение теперь включено. Может потребоваться подождать несколько минут, пока изменение не распространится.
- Снова запустите средство проверки решений.
Важно!
Для редактирования корпоративных приложений необходимо иметь права администратора в Microsoft Entra ID (Microsoft Entra ID).
Средству проверки решений не удается экспортировать решения с черновиками компонентов потоков бизнес-процесса
Если решение содержит компонент потока бизнес-процесса в состоянии "черновик", который никогда ранее не была активизирован, средство проверки решений не сможет экспортировать решение для анализа. Эта ошибка присуща не только средству проверки решений и вызывается тем, что последовательность операций бизнес-процесса имеет зависимость от базового (пользовательского) компонента таблицы, который не будет создан, пока последовательность операций бизнес-процесса не будет активирована в первый раз. Эта проблема также может возникнуть, если последовательность операций бизнес-процесса активирована в обозревателе решений.
Сведения об этой проблеме и порядке ее устранения см. в статье базы знаний №4337537: Недопустимый экспорт — отсутствует таблица бизнес-процесса.
Средству проверки решений не удается экспортировать решения с компонентами приложения на основе модели
Если решение содержит приложение на основе модели, средство проверки решений не сможет экспортировать решение для анализа. Эта ошибка вызвана безопасностью на основе роли для совместного использования приложений. Если у пользователя приложения проверки Power Apps нет соответствующего доступа к приложениям на основе модели, содержащие их решения невозможно будет экспортировать с помощью средства проверки решений.
Чтобы решить эту проблему, предоставьте роль безопасности Создатель среды для пользователя приложения средства проверки Power Apps.
Средству проверки решений не удается экспортировать исправленные решения
Если к решению было применено исправление, средство проверки решений не сможет экспортировать решение для анализа. Когда к решению было применено исправление, первоначальное решение будет заблокировано, и его нельзя изменить или экспортировать, если имеются зависимые исправления в организации, которые определяют это решение как родительское решение.
Для исправления этой проблемы клонируйте решение, чтобы все исправления, связанные с решением, были свернуты во вновь созданное решение. Это разблокирует решение и позволит экспортировать решение из системы. Дополнительные сведения см. в разделе Клонирование решения.
Средство проверки решений не анализирует пустые решения
Если средство проверки решений экспортирует решение, которое не содержит компоненты для анализа, оно прекратит дальнейшую обработку и будет считать, что выполнение завершилось сбоем. Убедитесь, что выбранное решение, отправленное для анализа в средство проверки решений, содержит по крайней мере один компонент.
Средству проверки решений не удается экспортировать большие решения
Основной сценарий для сбоя экспорта большого решения из среды включает исключение истечения времени ожидания для запроса экспорта. Это произойдет, если время выполнения запроса превысит 20 минут. Большие решения, такие как решение по умолчанию, могут не успеть экспортироваться в течение этого времени, и проверка не завершится успешно. Если средство проверки решений столкнется с истечением времени ожидания во время экспорта, оно предпримет три попытки, прежде чем задание завершится сбоем, поэтому вы можете получить уведомление об ошибке только через час или более.
Обходное решение — создать меньшие решения с меньшим числом компонентов, которые требуется проанализировать. Если большой размер файла решения связан с многими компонентами подключаемой сборки, см. указания в разделе Оптимизация разработки пользовательских сборок.
Важно!
Чтобы свести к минимуму ложные срабатывания, обязательно добавляйте зависимые настройки. При создании решения и добавлении таких компонентов включайте следующее:
- При добавлении подключаемых модулей включите шаги обработки сообщения SDKдля подключаемого модуля.
- При добавлении форм таблиц включите веб-ресурсы JavaScript, прикрепленные к событиям формы.
- При добавлении веб-ресурсов JavaScript включите все зависимые веб-ресурсы JavaScript.
- При добавлении веб-ресурсов HTML включить все зависимые сценарии, которые определены в веб-ресурсе HTML.
- При добавлении пользовательских бизнес-процессов включите сборку, используемую в бизнес-процессе.
Ссылки на номера строк для проблем в ресурсах HTML с внедренным кодом JavaScript указываются неправильно
Когда веб-ресурсы HTML обрабатываются в средстве проверки решений, веб-ресурс HTML обрабатывается отдельно от кода JavaScript в веб-ресурсе HTML. В связи с этим номер строки нарушения, найденного внутри элемента <script>
веб-ресурса HTML, будет неправильным.
Проблема неподдерживаемого в интернете синтаксиса для веб-ресурсов
Средство проверки решений поддерживает глобальные переменные для ECMAScript 2015 (ES6) и вплоть до синтаксиса ECMAScript 2018 (ES9). Когда средство проверки решений анализирует JavaScript с использованием глобальных переменных позже ES6 или синтаксиса более позднего, чем ES9, сообщается о проблеме неподдерживаемого в веб синтаксиса для веб-ресурса.
Несколько нарушений, сообщенных для подключаемых модулей и действий бизнес-процессов на основе области вызова
Для подключаемого модуля и правил действия бизнес-процесса, в которых проблема относится только к контексту вызова, средство проверки решения начинает анализ с реализации интерфейса IPlugin
и обходит граф вызовов для обнаружения проблем в рамках области данной реализации. В некоторых случаях многие пути вызовов могут приводить в одно и то же место, в котором проблема обнаружена. Поскольку проблема связана с областью вызова, средство может сообщать на основе этой области, чтобы давать лучшую картину влияния, а не просто на основе отдельных мест. Поэтому несколько проблем могут указывать на одно расположение, который должно быть исправлено.
app-formula-issues-high может отображать количество ошибок, отличное от тех, которые показаны в режиме разработки
Средство проверки решения перечислит количество ошибок, обнаруженных в приложении, в том числе ошибки из тестов. Средство проверки приложений в режиме разработки показывает только ошибки элементов управления экрана и компонентов. Если количество ошибок, отображаемое в средстве проверки приложений в режиме разработки, меньше, откройте Test Studio и найдите ошибки в выражениях, используемых в тестах.
Средство проверки решений сообщает о нарушениях в компонентах кода
Средство проверки решений сообщает о множественных нарушениях при запуске для решения, в котором есть компоненты кода, собранные в режиме отладки. Одна из распространенных ошибок, возникающих в режиме отладки, — это web-avoid-eval
. Средство проверки решений предназначено для проверки кода для использования в рабочей среде, поэтому компоненты кода должны быть собраны с использованием надлежащего buildMode: npm run build -- --buildMode production
или msbuild /p:configuration=Release
, в зависимости от вашей системы. Дополнительные сведения: Создание и сборка компонента кода
Если в bundle.js
возникают ошибки, связанные с компонентами кода, вы можете исключить этот файл из анализа. Дополнительные сведения: Модуль Microsoft.PowerApps.Checker.PowerShell и Интерфейс командной строки PAC
См. также
Рекомендации и инструкции для Dataverse
Рекомендации и советы для управляемых моделью приложений
Примечание
Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).
Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).