Dela via


Testa modellbaserade appar med Test Engine (förhandsversion)

Anteckning

Förhandsversionsfunktioner ska inte användas i produktion och funktionerna kan vara begränsade. funktionerna är tillgängliga före den officiella publiceringen så att kunderna kan få tillgång tidigare och ge oss feedback.

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 resultatet

Skapa en testplan

Skapa en yaml-fil med hjälp av testplanschemat som förklaras i Power Apps Test Engine YAML-format (förhandsversion).

Tips

Granska tillgängliga exempelplaner på GitHub-lagringsplatsen.

Aktivera förhandsversion

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

Test Engine har för närvarande följande autentiseringsmetoder:

Metod Beskrivning
Lagringstillstånd Lagra autentiserat användartillstånd lokalt i användarprofilen med hjälp av Microsoft Windows API:et för dataskydd
Dataverse Lagra autentiserat användartillstånd med Dataverse hjälp av din egen kundhanterade nyckel som krypteras med ett X.509-certifikat med hjälp av ASP.NET Core-dataskydd

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 user1Email-miljövariablerna 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 ge följande information:

  • --test-plan-file: Sökväg till testplansfilen
  • --tenant: Din klientorganisations-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 huvudnamn som har behörighet till 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 resultatet

När testerna är klara kan du visa resultatet av testet i filen .trx 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 yaml-testplanen.