Преглед на регистрационни файлове за грешки на уеб сайт
Администраторите и разработчиците на уеб сайтове използват Power Pages, за да създават уебсайтове за своите клиенти. Разработчиците често отстраняват проблеми, докато разработват уеб сайта. За да помогнете при отстраняването на грешки, можете да осъществите достъп до подробните регистрационни файлове за грешки за всякакви проблеми на уеб сайта ви. Има няколко начина да получите регистрационните файлове за грешки за вашия уеб сайт.
Съвет
За да научите за ролите, необходими за изпълнение на задачи в тази статия, прочетете Администраторски роли, необходими за административни задачи на портала.
Персонализирана грешка
Ако в уеб сайта ви възникне каквото и да било изключение от страна на сървъра, по подразбиране ще се покаже персонализирана страница за грешка с удобно за потребителя съобщение за грешка. За да конфигурирате съобщението за грешка, вижте Показване на персонализирано съобщение за грешка.
Въпреки това е по-добре да видите подробната страница за грешка на ASP.NET, позната също и като Жълт екран на смъртта (YSOD), за целите на отстраняване на грешки. Подробната страница за грешка ви помага да получите пълния комплект от грешките на сървъра.
За да разрешите YSOD, трябва да забраните персонализираните грешки на уеб сайта си.
Бележка
- Препоръчително е да забранявате персонализираните грешки само когато сте във фаза на разработка, и да разрешавате персоналзирани грешки, когато стартирате.
- Персонализираните грешки се показват постоянно на частния сайт и не могат да бъдат изключени.
Повече информация за персонализирана грешка: Показване на страница за персонализирана грешка
Забраняване на персонализирана грешка
Можете да забраните показването на подробно съобщение за изключение от персонализирани грешки в уеб сайтовете на Power Pages, ако възникне каквото и да е изключение от страна на сървъра в уеб сайта ви.
В секцията Ресурси изберете Power Pages сайтове.
Изберете уеб сайта си.
От менюто Действия на сайта изберете Забраняване на персонализирани грешки.
Изберете Дезактивиране в съобщението за потвърждение. Докато персонализираните грешки се деактивират, уеб сайтът се рестартира и временно не е наличен.
Разрешаване на персонализирана грешка
Можете да разрешите персонализираните грешки в уеб сайтовете, за да показвате професионално изглеждаща страница вместо YSOD. Тази страница предоставя полезна информация, ако възникне някакво изключени в приложението.
В секцията Ресурси изберете Power Pages сайтове.
Изберете уеб сайта си.
От менюто Действия на сайта изберете Разрешаване на персонализирани грешки.
Изберете Разрешаване в съобщението за потвърждение. Докато персонализираните грешки са активирани, уеб сайтът се рестартира и временно не е наличен.
Бележка
- Ако промените екземпляра, към който е свързан уеб сайтът ви, настройката за персонализирани грешки се задава към разрешена. Трябва да забраните потребителските грешки отново, ако е необходимо.
- Не трябва да разрешавате или забранявате персонализирани грешки, когато екземплярът, към който е свързан уеб сайтът ви, се променя. В противен случай се показва съобщение за грешка.
Показване на персонализирано съобщение за грешка
Можете да конфигурирате уеб сайта си да показва професионално изглеждаща персонализирана грешка вместо обичайна грешка.
За да определите персонализирана грешка, използвайте фрагмента от съдържание Portal Generic Error. Съдържанието, определено в този фрагмент, се показва на страницата за грешка. Този фрагмент от съдържание не е достъпен като предварително зададена опция и трябва да го създадете. Фрагментът от съдържание Тип може да бъде Текст или HTML. За да създадете или редактирате фрагмент от съдържание, вижте Персонализиране на съдържание с помощта на фрагмент от съдържание.
Бележка
Ако във фрагмента от съдържание има вписан течен код, той ще бъде пропуснат и няма да бъде рендиран.
Когато разрешите персонализираните грешки, съобщението се показва в следната структура на страницата за грешка:
<Content Snippet>
<Error ID >
<Date and time>
<Portal ID>
Следното съобщение е пример за персонализирано съобщение за грешка, използващо фрагмент на съдържание от тип HTML:
This is a custom error, file a support ticket with screenshot of error by clicking here
Бележка
Ако уеб сайтът не може да извлече фрагмент от съдържанието, защото не може да се свърже към Microsoft Dataverse, или ако фрагментът не е достъпен в Dataverse, се показва съобщение за грешка.
Достъп до регистрационни файлове за грешки на уеб сайта
След разработването и публикуването на уеб сайта все пак трябва да можете да осъществявате достъп до регистрационните файлове на уеб сайта, за да отстранявате проблеми, докладвани от потребителите. За да осъществявате достъп до регистрационните файлове, конфигурирайте уеб сайта си да изпраща всички грешки на приложението към акаунт за хранилище за BLOB на Azure, който притежавате. Като осъществявате достъп до регистрационните файлове за грешки на уеб сайта, можете да отговаряте на запитвания на потребители ефективно, защото разполагате с подробности за проблема. За да получите регистрационните файлове за грешки на уеб сайта в хранилището за BLOB на Azure, трябва да активирате диагностичното регистриране от центъра за администрация на Power Platform.
Бележка
Ако промените екземпляра на Dataverse, към който е свързан уеб сайтът ви, диагностичното регистриране се забранява. Трябва да разрешите отново диагностичното регистриране.
Разрешаване на диагностичното регистриране
В секцията Ресурси изберете Power Pages сайтове.
Изберете уеб сайта си.
От менюто Действия на сайта изберете Разрешаване на диагностични регистрационни файлове.
Появява се страничен панел, озаглавен Разрешаване на диагностично регистриране, въведете следните стойности:
Изберете период на съхранение: Продължителност за запазване на регистрационните файлове за грешки на портала в хранилището за BLOB. Регистрационните файлове се изтриват след избраното времетраене. Можете да изберете една или повече от следните стойности:
Един ден
Седем дни
30 дни
60 дни
90 дни
180 дни
Винаги
По подразбиране периодът на задържане е 30 дни.
Бележка
В момента потребителският интерфейс показва само периода на съхранение по подразбиране от 30 дни. Промените в периода на съхранение не се отразяват в потребителския интерфейс.
Низ за връзка на услугата за съхранение на BLOB Azure: URL адрес на услугата за съхранение на BLOB Azure за съхраняване на регистрационните файлове за грешки на уеб сайта. Максималната дължина на URL адреса е 2048 знака. Ако URL адресът е по-дълъг от 2048 знака, се показва съобщение за грешка. Повече информация относно низа за връзка: Конфигуриране на низовете за връзка с хранилище на Azure
Изберете Разрешаване.
След като диагностичното регистриране е конфигурирано, във вашия акаунт за съхранение Azure се създава нов контейнер за BLOB файлове на телеметрични регистрационни файлове и регистрационните файлове се записват във файловете с BLOB, съхранени в контейнера. Екранната снимка по-долу показва контейнера за BLOB за телеметрични регистрационни файлове в прозореца на хранилището на Azure:
Когато диагностичното регистриране е активирано успешно, следните действия стават достъпни от менюто Действия на сайта:
- Деактивиране на диагностичното регистриране: Позволява ви да деактивирате конфигурацията на диагностичното регистриране за портала.
- Актуализиране на конфигурацията за диагностично регистриране: Позволява ви да актуализирате или премахнете конфигурацията за диагностично регистриране за портала.
Актуализиране на диагностичното регистриране
В секцията Ресурси изберете Power Pages сайтове.
Изберете уеб сайта си.
От менюто Действия на сайта изберете Актуализиране на конфигурацията за диагностично регистриране.
В панела за актуализиране на конфигурацията на диагностично регистриране въведете следните стойности:
Искате ли да актуализирате низа за връзка на услугата Azure Blob Storage?: Позволява ви да укажете дали да актуализирате низа на връзката на услугата Azure Blob Storage. Тази опция не е избрана по подразбиране.
Изберете период на съхранение: Продължителност за запазване на регистрационните файлове за грешки на уеб сайта в хранилището за BLOB. Регистрационните файлове се изтриват след избраното времетраене. Можете да изберете една или повече от следните стойности:
- Един ден
- Седем дни
- 30 дни
- 60 дни
- 90 дни
- 180 дни
- Винаги
По подразбиране периодът на задържане е 30 дни.
Низ за връзка на услугата за съхранение на BLOB Azure: URL адрес на услугата за съхранение на BLOB Azure за съхраняване на регистрационните файлове за грешки на уеб сайта. Максималната дължина на URL адреса може да е 2048 знака. Ако URL адресът е по-дълъг от 2048 знака, се показва съобщение за грешка. Това поле се показва само ако е избрано квадратчето с отметка Желаете ли да актуализирате низа за връзка с услугата за хранилище за BLOB на Azure?. Повече информация относно низа за връзка: Конфигуриране на низовете за връзка с хранилище на Azure
Дезактивиране на диагностичното регистриране
В секцията Ресурси изберете Power Pages сайтове.
Изберете уеб сайта си.
От менюто Действия на сайта изберете Дезактивиране на диагностичното регистриране.
Изберете Дезактивиране в съобщението за потвърждение.
Показване на грешка в добавката
Друг сценарий, който се случва често при разработването на уеб сайт, е грешка, генерирана от персонализирани добавки и бизнес логика, записани в средата ви на Dataverse. Обикновено можете да получите достъп до тези грешки чрез забраняване на персонализирани грешки или разрешаване на диагностично регистриране. В някои случаи е по-бързо да покажете тези грешки директно в уеб сайта, за да диагностицирате проблема по-късно. Можете да изпълните тази задача, като конфигурирате уебсайта си да показва персонализирани грешки в плъгина от Dataverse вашата уеб страница.
За да покажете персонализирани грешки на добавки, създайте настройката на сайтаSite/EnableCustomPluginError и задайте стойността й на Вярно. Персонализираните грешки в плъгина се показват на екрана вместо обща грешка. Грешката показва само частта от съобщението на грешката на приставката, а не пълното проследяване на стека.
Следват екраните, където се появяват персонализирани грешки в плъгините:
- Списък
- Извличане на записи
- Основен формуляр
- Възобновяване
- Създаване/актуализиране и т.н.
- Многостъпкови формуляри
- Възобновяване
- Създаване/актуализиране и т.н.
Ако настройката на сайта не е налице, тя се третира като невярна по подразбиране и грешките в приставката не се изобразяват.
Преглед на грешки от страна на сървъра в разширението DevTools
Можете да преглеждате съобщения за грешки от страна на сървъра и потенциални решения с помощта на разширението Power Pages DevTools. Също така можете да отстранявате грешки в кода от страна на сървъра, като регистрирате персонализирани съобщения. Научете повече в Power Pages разширението DevTools: регистрирайте персонализирани съобщения с liquid.