Freigeben über


Debuggen von JavaScript-Code für modellgesteuerte Apps

Modellgesteuerte Apps verwenden JavaScript-Webressourcen, um benutzerdefinierte Logik zu enthalten. Diese Webressourcen stellen die Bibliotheken bereit, die Funktionen bereitstellen, die Entwickler als Ereignishandler registrieren.

Wenn Sie eine modellgesteuerte App in einem Webbrowser anzeigen, können Sie Entwicklertools verwenden, die alle modernen Browser bereitstellen. Mithilfe dieser Tools können Sie die in der modellgesteuerten Anwendung geladenen JavaScript-Bibliotheken suchen, Haltepunkte festlegen und Ihren Code mithilfe gängiger Methoden debuggen.

Modellgesteuerte Apps, die mithilfe mobiler Apps unter Android oder der Windows-Desktop-App angezeigt werden, erfordern einige weitere Schritte. Siehe:

Notiz

Aufgrund der Art und Weise, wie die Bibliotheken der Seite hinzugefügt werden, finden Sie möglicherweise nicht einfach die Bibliothek, die die JavaScript-Webressource darstellt. Diese Bibliotheken werden möglicherweise nicht in der Dateiliste oder in der Hierarchie der Quelldateien angezeigt.

Wenn Sie den Namen der JavaScript-Webressource kennen, die Sie debuggen möchten, verwenden Sie für Microsoft Edge- oder Google Chrome-Quellen den Ctrl+P Befehl "Datei öffnen", um die Datei anhand des Namens zu suchen und mit dem Debuggen zu beginnen. Wenn Sie über einen Ereignishandler verfügen, der einen Fehler verursacht, sie aber nicht den Namen der Datei kennen, finden Sie informationen zum Identifizieren der JavaScript-Webressource, die einen Fehler verursacht.

Weitere Informationen:

Die fehlerverursachende JavaScript Web-Ressource identifizieren

Wenn ein Ereignis Handler einen Skript-Fehler in einer modellgesteuerten App verursacht, erscheint der folgende Dialog:

Screenshot eines Skriptfehlerdialogfelds mit JavaScript-Debugginginformationen in modellgesteuerten Apps.

Wenn Sie den Link Details anzeigen auswählen, finden Sie die folgenden Details: Ereignisname, Funktionsname, Webressourcenname, Lösungsname und Herausgebername.

Xrm.Navigation.openalertDialog is not a function
Session Id: 53febd7c-3388-4ea5-a195-d84cf5883c30
Correlation Id: aaaa0000-bb11-2222-33cc-444444dddddd
Event Name: onsave
Function Name: Example.formOnSave
Web Resource Name: example_example-form-script
Solution Name: Active
Publisher Name: DefaultPublisherYourOrg
Time: Tue Jan 31 2023 13:36:34 GMT-0800 (Pacific Standard Time)

In diesem Fall war der Name der Funktion falsch, openalertDialog sollte openAlertDialog sein.

Notiz

Sie können die gleichen Details zu Fehlern mithilfe von Monitor abrufen. Weitere Informationen finden Sie unter Benutzerdefinierte Skriptfehler.

JavaScript in mobilen Apps unter Android debuggen

Wenn Sie JavaScript-Webressourcen für mobile Szenarien verwenden, können Sie Ihr Android-Gerät verwenden, um Ihren mobilen spezifischen Code zu debuggen und sicherzustellen, dass es wie erwartet funktioniert.

Führen Sie die folgenden drei Schritte aus, um JavaScript in mobilen Apps unter Android zu debuggen:

1. Konfigurieren Sie Ihr Gerät

Notiz

Stellen Sie sicher, dass USB-Geräte erkennen aktiviert ist.

2. Konfigurieren Sie die mobile Anwendung

  1. Wechseln Sie in der mobilen App zur Liste der Power Apps, und wählen Sie die Menüschaltfläche aus.
  2. Stellen Sie sicher, dass der Schalter Remote-Debugging für modellgesteuerte Apps aktivieren eingeschaltet ist.
  3. Wenn Sie diese Option aktivieren, wird ein Bestätigungsdialogfeld angezeigt. Wählen Sie Bestätigen aus.

3. Debuggen von Ihrem Entwicklungsrechner aus

  1. Schließen Sie Ihren Computer an Ihr Android-Gerät an.

  2. Öffnen Sie eine modellgesteuerte App aus Power Apps oder der Field Service Mobile-Anwendung.

  3. Suchen Sie auf der Seite edge://inspect/#devices in Ihrem Browser die URL Ihrer Organisation im Abschnitt Remote-Ziel.

    Screenshot des Bildschirms

  4. Wählen Sie "Prüfen" aus.

Weitere Informationen finden Sie unter Microsoft Edge: Remotedebugging von Android-Geräten.

JavaScript in mobilen Apps unter iOS debuggen

Verwenden Sie Safari auf einem Mac, um JavaScript-Webressourcen unter iOS zu debuggen.

Führen Sie die folgenden beiden Schritte aus, um JavaScript in mobilen Apps unter iOS zu debuggen:

1. Konfigurieren Sie die mobile Anwendung

  1. Wechseln Sie in der mobilen App zur Liste der Power Apps, und wählen Sie die Menüschaltfläche aus.
  2. Stellen Sie sicher, dass der Schalter Remote-Debugging für modellgesteuerte Apps aktivieren eingeschaltet ist.

2. Debuggen Sie von Ihrem Mac aus

  1. Verbinden Sie Ihr iPhone oder iPad mit Ihrem Mac.
  2. Starten Sie Safari auf Ihrem Mac.
  3. Suchen Sie im Menü Entwickeln Ihr verbundenes iPhone oder iPad, und suchen Sie dann nach Power Apps oder Field Service.

Weitere Informationen finden Sie unter Inspecting iOS und iPadOS | Apple-Entwicklerdokumentation.

Debuggen von JavaScript in der Windows-Desktop-App

Um JavaScript unter Windows zu debuggen, installieren Sie zuerst die erforderlichen Anwendungen.

1. Konfigurieren Sie Ihr Windows-Gerät

  1. Aktivieren Sie den Entwicklermodus.

    1. Öffnen Sie Windows-Einstellungen>Datenschutz & Sicherheit>Für Entwickler.
    2. Aktivieren Sie den Entwicklermodus.
  2. Aktivieren Sie das Geräteportal.

    1. Öffnen Sie Windows-Einstellungen>Datenschutz & Sicherheit>Für Entwickler.
    2. Aktivieren Sie das Geräteportal.
    3. Wählen Sie Ja aus, um das Windows Developer Mode-Paket zu installieren, wenn Sie dazu aufgefordert werden.
    4. Beachten Sie nach der Aktivierung des Geräteportals die URL, die Sie zum Herstellen einer Verbindung über localhost verwenden. Auf den meisten Geräten ist es https://localhost:50080.
    5. Für das lokale Debuggen von Power Apps oder Field Service Mobile können Sie mit aktivierter Option „Nur Loopbackverbindungen zulassen“ und deaktivierter Authentifizierung fortfahren (andernfalls müssen Sie ein Benutzerkennwort festlegen).

    Hier ist eine Screenshot-Zusammenfassung der empfohlenen Entwicklereinstellungen:

    Screenshot der Seite

2. Windows-Anwendung konfigurieren

Konfigurieren Sie die Power Apps- oder Field Service-Windows-Desktop-App für das Remote-Debugging.

Verwenden Sie den Ausführen-Befehl (Tastenkombination Windows + R) und verwenden Sie den folgenden Tiefenlink, um die Windows-App mit speziellen Argumenten zu starten.

  • Power Apps: ms-apps://?addWebView2AdditionalBrowserArgument=--enable-features=msEdgeDevToolsWdpRemoteDebugging
  • Field Service Mobile: ms-apps-fs://?addWebView2AdditionalBrowserArgument=--enable-features=msEdgeDevToolsWdpRemoteDebugging

3. Debuggen Sie von Windows aus

  1. Starten Sie Power Apps oder Field Service für Windows.

  2. Öffnen Sie den Microsoft Edge-Browser, und wechseln Sie zu edge://inspect.

  3. Verwenden Sie den Abschnitt Mit einem entfernten Windows-Gerät verbinden und verbinden Sie sich mit http://localhost:50080. Es dauert ein paar Sekunden, bis eine Verbindung hergestellt wird, aber die Organisations-URL wird angezeigt.

    Screenshot der Microsoft Edge DevTools Inspect-Seite mit den Verbindungsoptionen für Remote-Windows-Geräte.

  4. Wählen Sie „Überprüfen“ aus , und die DevTools werden geöffnet.

JavaScript-Webressourcen
Modellgesteuerte App mit Monitor debuggen
Problembehandlung in der Power Apps Mobile-App