Testa modelldrivna program med testmotorn (inaktuell)

Anmärkning

Testmotorn är inaktuell och tas bort i en framtida version. Använd Power Platform Playwright-exempel för testautomatiseringsfunktioner i Power Platform och Dynamics 365 tjänster.

Testning av ditt modellbaserade appar med Test Engine kräver följande steg:

  1. Skapa en testplan
  2. Konfigurera din användare
  3. Kör testet
  4. Visa resultaten

Skapa en testplan

Skapa en yaml-fil med hjälp av testplansschemat som beskrivs i Power Apps TEST Engine YAML-format (inaktuellt).

Tip

Granska tillgängliga exempelplaner på GitHub-lagringsplatsen.

Aktivera förhandsgranskning

För närvarande kräver alla testfunktioner för modellbaserade apptillägg att du använder förhandsgranskningsfunktioner. Om du vill aktivera dessa lägger du till Preview till allowPowerFxNamespaces-listan i extensionModules i din testSettings.

Det här exemplet visar hur du lägger till detta:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Konfigurera din användare

Testmotorn har för närvarande följande autentiseringsmetoder:

Metod Beskrivning
Lagrings tillstånd Lagra autentiserat användartillstånd lokalt i användarprofilen med hjälp av Microsoft Windows Data Protection API
Dataverse Lagra autentiserat användartillstånd i Dataverse med hjälp av din egen enskilda kundhanterade nyckel vilken är krypterad med ett X.509-certifikat med hjälp av ASP.NET Core Data Protection

Du kan inte lagra autentiseringsuppgifter för test i testplansfiler. Du måste välja Storagestate eller Dataverse som säker plats för att lagra autentiseringsuppgifter. Testplansfilen innehåller referenser till vilka miljövariabler som används för användarpersona. Följande YAML-kodfragment anger till exempel att miljövariablerna user1Email används:

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Visa Användare för mer information.

Använd följande PowerShell-skript för att lagra användarnamnet i dina miljövariabler.

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

Kör testet

Använd PAC CLI-kommandot pac test run för att köra testplanen.

Obligatoriska parametrar

Du måste ange följande information:

  • --test-plan-file: Sökväg till testplansfilen
  • --tenant: Ditt hyres-ID
  • --environment-id: Ditt miljö-ID
  • --domain: Domän-URL för den modellbaserade appsidan som ska testas

URL-format för modellbaserade appar

För modellbaserade appar varierar parametern --domain beroende på vilken typ av sida du testar. URL-formatet bör ange rätt pagetype baserat på ditt testscenario:

# 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

Om du vill aktivera Dataverse integrering med dina modellbaserade apptester lägger du till parametern enableDataverseFunctions i testSettings:

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

När du aktiverar Dataverse-integrering måste du öppna Azure CLI med en användare eller tjänstens huvudkonto som har behörighet för Dataverse-miljön. Du kan använda kommandot: az login Mer information: logga in med Azure CLI.

Dataverse API-URL:en som används för integrering hämtas antingen från värddomännamnet för parametern pac test run--domain eller genom att definiera en PowerShell-miljövariabel med namnet DATAVERSE_URL.

Visa resultaten

När testerna är klara kan du visa resultatet av testet i .trx filen som finns i utdatakatalogen. Den här mappen innehåller alla skärmbilder eller videor som tagits av dina tester när recordVideo är inställd på true i testplatsfilen YAML.