Устранение распространенных проблем с приложением управления порталом

Сводка

В этой статье описываются распространенные проблемы, которые могут возникнуть при использовании приложения управления порталом или приложения управления Power Pages для настройки сайтов Power Pages. Он предоставляет решения для сайта или приложения, которое не отображается, ошибки скрипта и записи, которые зависают при загрузке, доступ к приложениям и проблемы с ролью безопасности, назначение веб-ролей и проблемы с переводом.

Устранение неполадок рабочего процесса

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

1. Убедитесь, какое приложение и модель данных использует ваш сайт. См. сведения о том, какое приложение и модель данных использует ваш сайт. Этот шаг решает или объясняет множество проблем.
2. Убедитесь, что у вас есть необходимая роль безопасности. См. предварительные требования.
3. Найдите симптом в следующей таблице и перейдите в соответствующий раздел.

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

Чтобы использовать приложение "Управление порталом", вам потребуется роль системного администратора в той же среде Dataverse, что и сайт. Пользователи, имеющие роль настройщика системы , также могут открывать приложение, но у них могут быть ограниченные привилегии для определенных таблиц (например, примечания и вложения, связанные с веб-файлами), которые не позволяют им просматривать или обновлять записи, созданные другими пользователями.

Определение приложения и модели данных, которую использует ваш сайт

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

• Стандартная модель данных: приложение называется "Управление порталом". Конфигурация хранится в стандартных таблицах с adx_ префиксом (например, adx_website и adx_webrole).
• Расширенная модель данных: приложение называется Power Pages Management. Конфигурация хранится в таблицах с mspp_ префиксом (например, mspp_website и mspp_webrole).

Чтобы определить, какую модель данных использует ваш сайт, попробуйте один из следующих методов:

• Откройте Центр администрирования Power Platform, перейдите к ресурсам>Power Pages сайтам, выберите свой сайт и нажмите кнопку "Управление". В поле "Модель данных " в разделе "Сведения о сайте" показана модель данных.
• Откройте рабочую область установки в студии разработки Power Pages.
• Откройте модель-управляемое приложение Если имя — управление порталом, сайт использует стандартную модель данных. Если имя Power Pages Management, сайт использует расширенную модель данных.

Имя приложения отображается в заголовке рядом с Power Apps. В приложении "Управление порталом " (стандартная модель данных) заголовок считывает управление порталом:

В приложении управления Power Pages (расширенная модель данных) заголовок считывает Power Pages Management:

Дополнительные сведения см. в статье "Расширенная модель данных".

Сайт или приложение не отображаются должным образом.

Symptoms

• Сайт не указан в приложении "Управление порталом".
• Приложение "Управление порталом" не отображается или его невозможно открыть.
• При импорте или создании записей веб-сайта они переходят в приложение управления Power Pages вместо приложения управления порталом (или обратно).
• При настройке сайта нельзя выбрать или повторно использовать имеющуюся запись веб-сайта.
• При создании веб-сайта данные из существующего веб-сайта недоступны.

Cause

Открытое приложение не соответствует модели данных сайта. Сайт, созданный на основе расширенной модели данных, настраивается с помощью приложения управления Power Pages и ее mspp_ таблиц, и он не отображается в приложении "Управление порталом", где отображаются только стандартные adx_ таблицы. Записи веб-сайта, создаваемые или импортируемые, связаны с моделью данных приложения, которое вы используете.

Резолюция

1. Определите, какую модель данных использует ваш сайт, как описано в разделе "Определение используемой приложения и модели данных".
2. Откройте приложение, которое соответствует модели данных:
   • Для стандартного сайта модели данных используйте приложение "Управление порталом ".
   • Для сайта расширенной модели данных используйте приложение управления Power Pages.
3. Выберите правильную запись веб-сайта из приложения, соответствующего модели данных сайта.

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

Появится ошибка скрипта или запись зависает при загрузке

Symptoms

• При открытии записи, например веб-страницы, базовой формы, списка или многоэтапного шага формы, вы получите ошибку, похожую на следующее сообщение: An error has occurred in one of the scripts for this record. Download the log file for more information.
• Скачанный файл журнала ссылается на ошибку, похожую на ReferenceError: Web resource method does not exist.
• Форма или настройка зависает при загрузке или вы получаете сообщение, похожее на We can't get that information right now. Either try again or check our support page to see if there are any known issues.

Cause

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

Резолюция

1. Отключите расширения браузера, такие как блокировщики рекламы, а затем перезагрузите запись. Кроме того, откройте приложение в другом браузере, у которых нет таких расширений.
2. Если проблема продолжается, убедитесь, что у вашей учетной записи есть необходимая роль безопасности в среде, как описано в предварительных требованиях.
3. Проверьте доступность обновления пакета веб-сайта. В Центре администрирования Power Platform выберите свой сайт, а затем выберите сведения о пакетах веб-сайтов , чтобы просмотреть установленные пакеты и версии. Если более поздняя версия доступна для пакета сайта (CDSBasePortal для стандартной модели данных или PowerPagesCore для расширенной модели данных), обновите его во время внепиковой нагрузки, так как обновление часто устраняет ошибки скриптов, вызванные устаревшим пакетом. Инструкции см. в разделе "Обновление решения Power Pages".

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

Дополнительные сведения см. в обзоре браузера в приложении "Управление порталом".

Невозможно поделиться приложением с пользователем

Symptoms

Вы не можете предоставить другому пользователю доступ к приложению "Управление порталом" или приложению управления Power Pages.

Cause

Доступ к приложению предоставляется через роли безопасности Dataverse, а не путем прямого доступа к приложению.

Резолюция

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

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

Вы не можете назначить веб-роль контакту

Symptoms

• Вы не можете выбрать веб-роли или добавить контакт в веб-роль.
• Вы не можете извлекать контакты в веб-роль.
• Невозможно создать связь между контактом и таблицей mspp_webrole . Связь между контактом и таблицей adx_webrole можно создать только.

Cause

Причина зависит от модели данных сайта:

• Расширенная модель данных: веб-роль (mspp_webrole) — это виртуальная таблица. Невозможно настроить виртуальные таблицы, поэтому они не отображаются в списке таблиц, которые можно использовать для создания связи с другой таблицей. В результате вы не можете связать контакт с mspp_webrole ним, создав связь. Вместо этого вы назначаете веб-роли из расширенной формы контакта в приложении управления Power Pages.
• Стандартная модель данных: веб-роль (adx_webrole) использует стандартную связь "многие ко многим" с контактами, поэтому ограничения виртуальной таблицы отсутствуют. Веб-роли назначаются непосредственно из связанных контактов веб-роли, как описано в следующих шагах.

Резолюция

Используйте метод, соответствующий модели данных сайта.

Стандартная модель данных (приложение "Управление порталом")

1. В приложении "Управление порталом" выберите"Веб-роли>" и выберите веб-роль.
2. Перейдите на вкладку "Связанные " и выберите "Контакты".
3. Выберите "Добавить существующий контакт", найдите и выберите пользователей сайта, нажмите кнопку "Добавить" и нажмите кнопку "Сохранить".

Расширенная модель данных (приложение управления Power Pages)

1. В приложении управления Power Pages выберите"Контакты>" и выберите контакт.
2. Выберите контакт на портале (расширенная форма).
3. На вкладке "Общие " прокрутите страницу до раздела "Веб-роли ", а затем выберите "Добавить существующую веб-роль".
4. Найдите и выберите веб-роли, нажмите кнопку "Добавить", а затем нажмите кнопку "Сохранить".

Назначьте веб-ролям записи отдельных контактов (пользователя сайта). Встроенный способ сопоставления группы Microsoft Entra ID (Azure AD) с веб-ролью не существует, поэтому назначьте веб-роль каждой записи контакта пользователя, прошедшей проверку подлинности, с помощью действий, описанных в этом разделе.

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

Дополнительные сведения см. в статье "Создание и назначение веб-ролей".

Языки или переводы не отображаются

Symptoms

• Необходимо включить новый язык для сайта.
• Переводы не отображаются после добавления языка.
• Вы хотите настроить многоязычный сайт.

Cause

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

• Вы не включите язык в Dataverse, или процесс подготовки языка не завершен. Подготовка языка может занять час или более.
• Вы не добавили язык веб-сайта или не в опубликованном состоянии.
• Вы не создали локализованное содержимое для языка, поэтому страницы возвращаются на язык по умолчанию.

Резолюция

1. Включите язык в Dataverse для среды и дождитесь завершения подготовки, прежде чем продолжить. Инструкции см. в разделе "Включить языки".
2. В приложении "Управление порталом" перейдите на веб-сайты>, выберите свой сайт и в разделе "Поддерживаемые языки" добавьте новый язык веб-сайта. Задайте состояние публикации в опубликованном состоянии и при необходимости задайте язык сайта по умолчанию.
3. Создайте и опубликуйте локализованное содержимое для каждого языка. В студии дизайна Power Pages перейдите на язык и переведите веб-страницы, фрагменты содержимого и другие компоненты, которые видят посетители.

Сквозное пошаговое руководство см. в разделе "Включение поддержки веб-сайтов с несколькими языками".

После подготовки, добавления и публикации языка, а также локализованного содержимого посетители могут выбрать язык и просмотреть переведенное содержимое.

Настройка компонентов сайта с помощью приложения "Управление порталом"

Используйте приложение "Управление порталом" (или приложение управления Power Pages для расширенных сайтов модели данных) для настройки следующих компонентов сайта. Если при сохранении компонента возникает ошибка скрипта или запись зависает при сохранении компонента, появится сообщение об ошибке скрипта или запись зависает.

Простые формы

Базовые формы можно настроить из студии разработки Power Pages или приложения "Управление порталом". Базовые формы можно связать с сайтом несколькими способами. Дополнительные сведения см. в разделе "Основные формы". Сведения о настройке метаданных, которые управляют поведением базовой формы, см. в разделе "Настройка базовых метаданных формы".

Многоэтапные формы

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

Lists

Список — это конфигурация на основе данных, используемая для добавления веб-страницы, которая отображает список записей без необходимости поверхности сетки на сайте. С помощью списков можно предоставлять записи Dataverse для отображения на веб-странице. Дополнительные сведения см. в разделе "Обзор списков". Сведения о конфигурации, такие как сортировка, представления списка (включая представления сетки, карты и календаря), а также настраиваемые представления JavaScript, см. в разделе "Конфигурация списка".

Лучшие практики

• Всегда открывайте приложение, соответствующее модели данных сайта. Для расширенных сайтов модели данных используйте приложение управления Power Pages. Для стандартных сайтов модели данных используйте приложение "Управление порталом ".
• Записи в приложении "Управление порталом" и в приложении управления Power Pages представляют конфигурацию динамического сайта. Удаление записи конфигурации может нарушить ссылки на сайт, поэтому измените или удалите записи, только если вы уверены в эффекте.
• По возможности используйте студию разработки Power Pages для распространенных задач конфигурации. Зарезервировать приложение "Управление порталом" для расширенной настройки.

Обратитесь в службу поддержки Microsoft

Если действия, описанные в этой статье, не устраняют проблему, обратитесь в службу поддержки Microsoft. Чтобы ускорить диагностику, соберите следующие сведения, прежде чем открыть случай поддержки:

• URL-адрес сайта и имя среды или идентификатор.
• Модель данных, используемая сайтом (стандартная или расширенная), и имя приложения, которое вы используете (управление порталом или управление Power Pages).
• Точное сообщение об ошибке и файл журнала, если ошибка скрипта предложит скачать его.
• Снимок экрана: проблема и шаги по воспроизведению.
• Роль безопасности, назначенная затронутному пользователю или контакту.

См. также

• Обзор приложения "Управление порталом"
• Расширенная модель данных
• Создание и назначение веб-ролей
• Включение поддержки веб-сайта с несколькими языками
• О базовых формах
• Настройка базовых метаданных формы
• Многоэтапные формы
• Настройка метаданных формы multistep
• Общие сведения о списках
• Конфигурация списка