Del via


Test modelbaserede programmer med testprogram (prøveversion)

Bemærk

Forhåndsversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Test af dit modelbaserede program med testprogram kræver følgende trin:

  1. Opret en testplan
  2. Konfigurere din bruger
  3. Kør testen
  4. Se resultaterne

Opret en testplan

Opret en yaml-fil ved hjælp af skemaet for testplanen, der er forklaret i Power Apps YAML-format (prøveversion).

Tip

Gennemse tilgængelige eksempler planer i GitHub-repositoriet.

Aktivér forhåndsvisning

I øjeblikket kræver alle testfunktioner for modelbaserede appudvidelser brug af prøveversionsfunktioner. For at aktivere disse skal du tilføje Preview til listen i allowPowerFxNamespaces udvidelsenModuler i dintestIndstillinger.

Dette eksempel viser dig, hvordan du tilføjer dette:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Konfigurere din bruger

Testprogrammet har i øjeblikket disse godkendelsesmetoder:

Metode Description
Opbevaring Tilstand Gem godkendt brugertilstand lokalt i brugerprofilen ved hjælp af Microsoft Windows Data Protection API
Dataverse Gem godkendt brugertilstand i Dataverse ved hjælp af din egen kundeadministrerede nøgle krypteret med et X.509-certifikat ved hjælp af ASP.NET Core Databeskyttelse

Du kan ikke gemme testlegitimationsoplysninger i testplanfiler. Du skal vælge Storagestate eller Dataverse som den sikre placering for at gemme legitimationsoplysninger. Testplanfilen indeholder referencer til, hvilke miljøvariabler der bruges til brugerpersona. Følgende YAML-kodestykke angiver f.eks., at miljøvariablerne user1Email bruges:

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Se Brugere for at få flere oplysninger.

Brug følgende PowerShell-script til at gemme brugernavnet i dine miljøvariabler.

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

Kør testen

Brug kommandoen PAC CLI pac test run til at køre din testplan.

Påkrævede parametre

Du skal angive følgende oplysninger:

  • --test-plan-file: Sti til din testplanfil
  • --tenant: Dit lejer-id
  • --environment-id: Dit miljø-id
  • --domain: Domæne-URL-adressen til den modelbaserede appside, der skal testes

URL-formater til modelbaserede apps

For modelbaserede apps varierer parameteren --domain afhængigt af den type side, du tester. URL-formatet skal angive det korrekte pagetype baseret på dit testscenarie:

# 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"

Dataverseintegration

Hvis du vil aktivere Dataverse integration med dine modelbaserede apptest, skal du tilføje parameteren enableDataverseFunctions i dine testSettings:

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

Når du aktiverer Dataverse-integration, skal du åbne Azure CLI med en bruger eller tjenesteprincipal, der har rettigheder til Dataverse-miljøet. Du kan bruge kommandoen: az-logon Flere oplysninger: Log ind med Azure CLI.

Den Dataverse API-URL, der bruges til integration, hentes enten fra værtsdomænenavnet for pac-testkørselsparameteren--domain eller ved at definere en PowerShell-miljøvariabel med navnet DATAVERSE_URL.

Se resultaterne

Når testene er fuldført, kan du se resultaterne af din test i filen .trx i outputmappen. Denne mappe indeholder alle skærmbilleder eller videoer, der er optaget af dine test, når recordVideo den er indstillet til true i testplanens yaml.