Testen modellgesteuerter Anwendungen mit Testmodul (veraltet)

Anmerkung

Das Testmodul ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie Power Platform Playwright-Beispiele für Testautomatisierungsfunktionen in Power Platform- und Dynamics 365-Diensten.

Zum Testen Ihrer modellgesteuerten Anwendung mit Test Engine sind die folgenden Schritte erforderlich:

  1. Erstellen eines Testplans
  2. Benutzerkonto einrichten
  3. Test ausführen
  4. Ergebnisse anzeigen

Testplan erstellen

Erstellen Sie eine YAML-Datei mit dem Testplanschema, das im Power Apps Test Engine YAML-Format (veraltet) erläutert wird.

Tipp

Überprüfen Sie die verfügbaren Musterpläne im GitHub-Repository.

Aktivieren der Vorschau

Derzeit ist für alle Funktionen zum Testen von Erweiterungen für modellgesteuerte Apps die Verwendung von Vorschaufunktionen erforderlich. Um diese zu aktivieren, fügen Sie Preview zur Liste allowPowerFxNamespaces in extensionModules Ihrer testSettings hinzu.

Dieses Beispiel zeigt Ihnen, wie Sie dies hinzufügen:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Benutzer einrichten

Test Engine verfügt derzeit über die folgenden Authentifizierungsmethoden:

Methode Beschreibung
Speicherstatus Speichern Des authentifizierten Benutzerstatus lokal im Benutzerprofil mithilfe der Microsoft Windows Datenschutz-API
Dataverse Speichern Sie den authentifizierten Benutzerstatus in Dataverse mithilfe Ihres eigenen vom Kunden verwalteten Schlüssels, der mit einem X.509-Zertifikat mit ASP.NET Core Datenschutz verschlüsselt ist

Sie können Testanmeldeinformationen nicht in Testplandateien speichern. Sie müssen Storagestate oder Dataverse als sicheren Speicherort für Anmeldeinformationen auswählen. Die Testplandatei enthält Verweise darauf, welche Umgebungsvariablen für die Benutzerpersona verwendet werden. Der folgende YAML-Ausschnitt gibt beispielsweise an, dass die user1Email-Umgebungsvariablen verwendet werden:

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Weitere Informationen finden Sie unter Benutzende.

Verwenden Sie das folgende PowerShell-Skript, um den Benutzernamen in Ihren Umgebungsvariablen zu speichern.

$env:user1Email = "someone@example.com"

Test ausführen

Verwenden Sie den PAC-CLI-Befehl PAC-Testausführung, um Ihren Testplan auszuführen.

Erforderliche Parameter

Sie müssen die folgenden Informationen angeben:

  • --test-plan-file: Pfad zu Ihrer Testplandatei
  • --tenant: Ihre Mandanten-ID
  • --environment-id: Ihre Umgebungs-ID
  • --domain: Domänen-URL der zu testenden Seite der modellgesteuerten App

URL-Formate für modellgesteuerte Apps

Bei modellgesteuerten Apps variiert der Parameter --domain je nach Typ der Seite, die Sie testen. Das URL-Format sollte basierend auf Ihrem Testszenario den richtigen pagetype angeben:

# For custom pages
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=custom&name=dev_home_c8017"

# For entity lists (views)
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=entitylist&etn=account&viewid=5a84c584-df1c-ed11-9db0-000d3a991110"

# For entity records (forms)
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=entityrecord&etn=account&id=72e0e163-df1c-ed11-9db0-000d3a991110"

Dataverse-Integration

Um die Dataverse-Integration in Ihre Tests der modellgesteuerten App zu ermöglichen, fügen Sie den Parameter enableDataverseFunctions in Ihren testSettingshinzu:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview
    parameters:
      enableDataverseFunctions: true

Wenn Sie die Dataverse-Integration aktivieren, müssen Sie Azure CLI mit einem Benutzer- oder Dienstprinzipal öffnen, der über Rechte für die Dataverse-Umgebung verfügt. Sie können den Befehl verwenden: az login Weitere Informationen: Sign in with Azure CLI.

Die für die Integration verwendete Dataverse-API-URL wird entweder aus dem Hostdomänennamen des Parameters pac-Testlauf--domain oder durch Festlegen einer PowerShell-Umgebungsvariable mit dem Namen DATAVERSE_URL abgerufen.

Ergebnisse anzeigen

Wenn die Tests abgeschlossen sind, können Sie die Ergebnisse Ihres Tests in der Datei .trx im Ausgabeverzeichnis anzeigen. Dieser Ordner enthält alle Screenshots oder Videos, die von Ihren Tests erfasst wurden, wenn recordVideo im Testplan-YAML auf true gesetzt ist.

  • Last updated on