Freigeben über

Modellgesteuerte Anwendungen mit Test Engine testen (Vorschau)

Anmerkung

Funktionen in der Vorschauversion sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor dem offiziellen Release zur Verfügung, damit Kunden früher Zugriff darauf erhalten und Feedback geben können.

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 mithilfe des testplanschemas, das in Power Apps Test Engine YAML-Format (Vorschau) erläutert wird.

Tipp

Überprüfen Sie die verfügbaren Beispielplä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 Data Protection-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