Teilen über

Fehlerbehebung beim Hinzufügen einer Datenquelle (Vorschau)

Dieser Artikel enthält Schritte zur Problembehandlung, wenn der PAC CLI-Befehl (Befehlszeilenschnittstelle für Power Apps) mit Pac-Code-Add-Data-Source fehlschlägt.

Symptome

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

Symptom Beispielnachricht
Abruf fehlgeschlagen Fetch Failed (kein zusätzlicher Stapel)
Timeout/Netzwerkfehler ETIMEDOUT, ENOTFOUNDECONNRESET
Umgebungsinkompatibilität Datenquelle nicht gefunden/ unerwartetes Schema

Voraussetzungen

  1. Stellen Sie sicher, dass die neueste Power Platform CLI installiert ist. Aktualisieren Sie es, wenn Sie nicht sicher sind.
  2. Überprüfen Sie, ob Sie sich für die richtige Umgebung authentifiziert haben. Verwenden Sie pac auth create und pac auth list Befehle.
  3. Überprüfen Sie, ob Ihr Netzwerk ausgehende HTTPS-Aufrufe an Power Platform-Endpunkte zulässt.

Problembehandlungsschritte

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 den Vorgang:

  • environmentId entspricht der Umgebung, die Sie als Ziel festlegen möchten.
  • region ist auf prod gesetzt, es sei denn, Sie zielen absichtlich auf eine andere Region ab. Bitte bei Fehlen hinzufügen.

Schritt 2: Umgebungskontext überprüfen

Führen Sie den Befehl pac env who aus.

Vergleichen Sie Environment ID in der Ausgabe mit dem environmentId-Wert in power.config.json.

Beispielausgabe (kommentiert):

Connected as user@domain.com
Organization Information
  Org ID:                     00aa00aa-bb11-cc22-dd33-44ee44ee44ee
  Unique Name:                unq2889ab2be728ef118406000d3a33f
  Friendly Name:              User Name
  Org URL:                    https://myorg.crm.dynamics.com/
  User Email:                 user@domain.com
  User ID:                    aaaaaaaa-bbbb-cccc-1111-222222222222
  Environment ID:             aaaabbbb-0000-cccc-1111-dddd2222eeee  <-- Ensure this matches

Entsprechender power.config.json Beispielausschnitt:

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

Schritt 3: Befehl erneut ausführen

Führen Sie erneut den Befehl pac code add-data-source aus. Beispiel:

pac code add-data-source -a dataverse -t account

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

Schritt 4: Netzwerk- und Sicherheitsüberprüfung

Wenn es weiterhin fehlschlägt:

Ü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 PAC CLI verwenden.
  2. Navigieren Sie direkt zur Datenquelle, die Sie hinzufügen möchten. Beispielsweise die SharePoint-Website oder die Dataverse-Umgebungs-URL.
  3. Melden Sie sich mit denselben Anmeldeinformationen an, die Sie für die Authentifizierung mit dem PAC CLI-Pac-Autorisierungs-Erstellungsbefehl verwendet haben.
  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, wechseln Sie zu "Netzwerkdatenverkehr analysieren".

Analysieren des Netzwerkdatenverkehrs

Dies ist die effektivste Möglichkeit, die rohen Netzwerkkommunikationsdaten zwischen der PAC CLI und dem Datenquellenendpunkt anzuzeigen.

  1. Laden Sie Fiddler Classic herunter und installieren Sie sie. Fiddler ist ein Tool zum Überwachen des Netzwerkdatenverkehrs.

  2. Öffnen Sie Fiddler und vergewissern Sie sich, dass der Datenverkehr erfasst wird. Wechseln Sie zu Datei>Datenverkehr erfassen.

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

  4. Suchen Sie in der Fiddler-Sitzungsliste nach Anfragen, die an Ihren Datenquellen-Endpoint gestellt wurden. Beispiel: yourorg.crm.dynamics.com oder yourtenant.sharepoint.com.

  5. Analysieren Sie die Antwortinformationen:

    • 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/Zurücksetzen des Authentifizierungskontexts

Wenn ein Konflikt erkannt wird, sollten Sie den Authentifizierungskontext mithilfe der folgenden PAC CLI-Befehle löschen oder zurücksetzen.

pac auth list
pac auth select --index <n>
pac env who

Wenn falsch, erneut authentifizieren:

pac auth create --environment <yourEnvironmentId>

Eskalationsdaten

Bevor Sie sich an den technischen Support wenden, um ein Problem zu stellen, sammeln Sie die folgenden Daten.

Bereitstellen:

  • CLI-Version. Verwenden des pac --version Befehls
  • Betriebssystem und Shell (Windows cmd / PowerShell / WSL)
  • Der vollständige Befehl, der verwendet wird
  • Auszug aus der bereinigten Debug-Ausgabe
  • power.config.json, nachdem Sie Geheimnisse geschwärzt haben
  • Last updated on