Power Pages DevTools-Erweiterung
Die Power Pages-Erweiterung für Microsoft Edge DevTools ist ein Entwicklertool, das die Entwicklungs- und Fehlerbehebungserfahrung für Ersteller und Administratoren verbessern soll, die an Power Pages-Websites arbeiten. Sie bietet Funktionen wie die Anzeige von Liquid-Ablaufverfolgungsmeldungen und serverseitigen Fehlermeldungen. Mit diesem Tool können Ersteller und Administratoren Probleme innerhalb der Power Pages-Umgebung effizient identifizieren, diagnostizieren und lösen. Indem sie Protokollierungs- und Ablaufverfolgungsfunktionen in Liquid-Code ermöglicht und klare Einblicke in Fehlerszenarien gewährt, erleichtert die Power Pages-Erweiterung reibungslosere Entwicklungsabläufe und verbessert die Gesamtqualität von Power Pages-Websites.
Anmerkung
Die Entwicklertool-Erweiterung ist derzeit nur für Microsoft Edge verfügbar.
Um mit den Entwicklertools zu arbeiten, müssen Sie:
- Die Browsererweiterung installieren.
- Diagnoseeinstellungen aktivieren.
- Serverseitige Fehler überprüfen und Details zur Schadensbegrenzung folgen.
- Mit Liquid-Code hinzugefügte benutzerdefinierte Protokollmeldungen anzeigen.
Die DevTools-Browsererweiterung installieren
So installieren Sie die DevTools-Browsererweiterung für Power Pages:
- Gehen Sie zu Microsoft Power Pages-Erweiterung für Microsoft Edge.
- Wählen Sie Abrufen.
Diagnoseeinstellungen aktivieren
Anmerkung
Wenn Ihr Website-Sichtbarkeitsstatus privat ist, ist die Diagnoseeinstellung standardmäßig aktiviert.
So aktivieren Sie die Diagnoseeinstellung für eine öffentliche Website:
- Öffnen Sie die Power Pages Management-App.
- Fügen Sie die Website-Einstellung mit dem Namen UserTrace/Debug hinzu oder aktualisieren Sie sie.
- Legen Sie den Wert auf true fest.
Serverseitige Fehlermeldungen überprüfen
Wenn Sie die Diagnoseeinstellung aktivieren, protokolliert die Plattform alle Fehler, die auf dem Server auftreten. Um diese Serverfehlermeldungen zu erfassen, müssen Sie:
Öffnen Sie den Microsoft Edge-Webbrowser.
Navigieren Sie zu Ihrer Power Pages-Website.
Öffnen Sie die DevTools für den Browser.
Wählen Sie die Registerkarte Power Pages aus.
Reproduzieren Sie das Szenario, in dem der Fehler aufgetreten ist.
Das Tool zeigt eine Liste aller serverseitigen Fehlermeldungen zusammen mit möglichen Lösungen an.
Anmerkung
Derzeit wird Ihnen möglicherweise nur eine begrenzte Anzahl von Fehlermeldungen angezeigt. Jedes nachfolgende Release wird jedoch zusätzliche Fehlermeldungen für verschiedene Arten von Fehlern enthalten.
Im Folgenden finden Sie einige Beispielfehlermeldungen:
Fehler mit dem lokalen Anmeldeanbieter, wenn das Attribut „LogonEnabled“ für den Portalkontakt „false“ ist.
Die Suche nach externen Entitäten ist nicht richtig konfiguriert.
Benutzerdefinierte Nachrichten mit Liquid protokollieren
Ersteller können Protokollanweisungen in ihren Liquid-Code einfügen. Wenn die Power Pages-Website ausgeführt wird, werden die vom Ersteller im Liquid-Code hinzugefügten Protokolle in der Power Pages-Entwicklertool-Erweiterung angezeigt. Ersteller haben die Möglichkeit, Protokollanweisungen in ihren Liquid-Code zu integrieren. Diese vom Ersteller eingebetteten Protokolle werden in der Entwicklertool-Erweiterung angezeigt, wenn die Diagnoseeinstellung aktiviert ist.
Die folgende Syntax kann im Liquid-Code verwendet werden, um benutzerdefinierte Nachrichten zu protokollieren:
{% log message:'Custom message' level:'Warning' %}
Parameter | Beschreibung |
---|---|
log | Liquid-Objektname |
Nachricht | Eine Zeichenfolge, die alle zu protokollierenden benutzerdefinierten Nachrichten darstellt |
level | Die Meldung wird als Info, Warnung oder Fehler protokolliert |
Beispiel:
{% log message: 'Log from Home page' %}
{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}
{% assign contacts = query.results.entities %}
{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %}
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}