Troubleshooting bei Hinzufügen einer Datenquelle

Probleme beim Hinzufügen einer Datenquelle beheben, wenn der Power Apps CLI pa app add data-source-Befehl fehlschlägt. Führen Sie die folgenden Schritte aus, um Konfigurations-, Authentifizierungs- oder Netzwerkprobleme zu identifizieren und die Datenquelle erfolgreich hinzuzufügen.

Symptome

Fehler treten in der Regel auf, weil etwas auf Ihrem Computer oder Netzwerk die Verbindung blockiert oder die Authentifizierung unterbrochen wird.

Symptom Beispielnachricht
Fehler beim Abrufen Fetch Failed (kein zusätzlicher Stapel)
Timeout- oder Netzwerkfehler ETIMEDOUT, ENOTFOUND oder ECONNRESET
Umgebungsinkompatibilität Datenquelle nicht gefunden oder unerwartetes Schema

Voraussetzungen

  1. Stellen Sie sicher, dass Sie die neueste Power Apps CLI installiert haben. Aktualisieren Sie es, wenn Sie nicht sicher sind.

  2. Verwenden Sie pa auth login zum Anmelden und pa auth status, um das aktive Konto zu überprüfen:

    pa auth login
pa auth status

  3. Stellen Sie sicher, dass Ihr Netzwerk ausgehende HTTPS-Aufrufe an Power Platform-Endpunkte zulässt.

Schritte zum Beheben von Datenquellenfehlern

Führen Sie die folgenden Schritte aus, um die Ursache zu diagnostizieren.

Schritt 1: Überprüfen der Konfiguration

Öffnen Sie die power.config.json Datei, und bestätigen Sie Folgendes:

  • environmentId entspricht der Umgebung, die Sie als Ziel festlegen möchten.
  • region ist auf prod festgelegt, es sei denn, Sie möchten eine andere Region als Ziel festlegen. Fügen Sie es hinzu, falls es fehlt.

Schritt 2: Umgebungskontext überprüfen

Wird pa auth status verwendet, um zu bestätigen, dass das richtige Konto aktiv ist:

pa auth status

Vergleichen Sie das environmentId in power.config.json mit der Umgebungs-ID, die in der URL der Power Apps-Umgebung angezeigt wird.

Beispiel power.config.json Ausschnitt:

{
  "environmentId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "region": "prod"
}

Schritt 3: Befehl erneut ausführen

Führen Sie pa app add data-source erneut aus. Zum Beispiel:

pa app add data-source --connector dataverse --table account

Suchen Sie in der Ausgabe nach HTTP-Statuscodes oder Fehlermeldungen.

Schritt 4: Netzwerk- und Sicherheitsüberprüfung

Wenn der Befehl immer noch fehlschlägt:

  • Vergewissern Sie sich, dass kein Unternehmensproxy oder keine Firewall CLI-Prozesse oder anderen nichtbrowsern Datenverkehr blockiert.
  • Genehmigen Sie die erforderlichen Power Platform-Endpunkte. Siehe Power Platform-Konnektivitätsanforderungen.

Überprüfen der Browserkonnektivität

In diesem Schritt wird sichergestellt, dass Ihr Benutzerkonto über die richtigen Berechtigungen verfügt und dass die Datenquelle von Ihrem Computer aus erreichbar ist.

  1. Öffnen Sie einen Webbrowser auf demselben Computer, auf dem Sie die Power Apps CLI verwenden.
  2. Wechseln Sie direkt zur Datenquelle, die Sie hinzufügen möchten, z. B. die URL der SharePoint Website oder der Dataverse-Umgebung.
  3. Melden Sie sich mit demselben Konto an, das von pa auth status angezeigt wird.
  4. Wenn Sie nicht auf die Ressource zugreifen können, ist ein Berechtigungsproblem mit Ihrem Benutzerkonto die wahrscheinliche Ursache.
  5. Wenn Sie darauf zugreifen können, fahren Sie mit der Analyse des Netzwerkdatenverkehrs fort.

Analysieren des Netzwerkdatenverkehrs

Verwenden Sie ein Netzwerküberwachungstool, um die Kommunikation zwischen der Power Apps CLI und dem Datenquellenendpunkt zu prüfen.

  1. Laden Sie Fiddler Classic herunter und installieren Sie sie.

  2. Starten Sie Fiddler, und stellen Sie sicher, dass der Datenverkehr erfasst wird. Wechseln Sie zu Datei>Datenverkehr erfassen.

  3. Führen Sie an einer Eingabeaufforderung den fehlgeschlagenen pa app add data-source Befehl aus.

  4. Suchen Sie in der Fiddler-Sitzungsliste nach Anfragen an Ihren Datenquellenendpunkt, z. B. yourorg.crm.dynamics.com oder yourtenant.sharepoint.com.

  5. Analysieren Sie die Antwort:

    • Ein 200 Statuscode gibt an, dass der Erfolg erfolgreich war.
    • Ein 401 Statuscode (nicht autorisiert) oder 403 (Verboten) verweist auf ein Authentifizierungs- oder Berechtigungsproblem.
    • Andere Fehlercodes oder ein vollständiger Antwortmangel können darauf hinweisen, dass eine Firewall oder ein Proxy die Anforderung blockiert.

Schritt 5: Löschen oder Zurücksetzen des Authentifizierungskontexts

Wenn das falsche Konto aktiv ist, verwenden Sie :pa auth switch

pa auth switch

Wenn das Konto nicht aufgeführt ist, verwenden Sie pa auth login:

pa auth login

Um alle gespeicherten Anmeldeinformationen zu löschen und sich erneut anzumelden, verwenden Sie pa auth logout und anschließend pa auth login:

pa auth logout
pa auth login

Eskalationsdaten

Bevor Sie sich an den technischen Support wenden, um ein Problem zu übermitteln, geben Sie Folgendes an:

  • CLI-Version von pa --version
  • Betriebssystem und die Shell, z. B. die Windows-Eingabeaufforderung, PowerShell oder WSL
  • Der vollständige Befehl, der verwendet wird
  • Bereinigte Debug-Ausgabe
  • power.config.json nachdem Sie vertrauliche Werte geschwärzt haben
  • Last updated on