Condividi tramite

Testare le applicazioni basate su modelli con Test Engine (anteprima)

Nota

Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Vengono rese disponibili prima di una versione ufficiale in modo che i clienti possano accedervi con anticipo e fornire i loro commenti.

Per testare la tua applicazione basata su modello con Test Engine sono necessari i seguenti passaggi:

  1. Creare un piano di test
  2. Configura il tuo utente
  3. Esegui il test
  4. Visualizzare i risultati

Creare un piano di test

Creare un file yaml utilizzando lo schema del piano di test spiegato nel formato YAML del Power Apps Test Engine (anteprima).

Suggerimento

Esamina i piani di esempio disponibili nel repository GitHub.

Abilitare l'anteprima

Attualmente, tutte le funzionalità di test delle estensioni delle app basate su modello richiedono l'utilizzo di funzioni di anteprima. Per abilitarli, aggiungi Preview all'elenco allowPowerFxNamespaces in extensionModules delle tue impostazioni di test.

Questo esempio mostra come aggiungere questo:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Imposta il tuo utente

Test Engine attualmente dispone dei seguenti metodi di autenticazione:

Metodo Descrzione
Stato di archiviazione Archiviare lo stato utente autenticato localmente nel profilo utente usando l'API Microsoft Windows Data Protection
Dataverse Archiviare lo stato dell'utente autenticato in Dataverse usando la propria chiave gestita dal cliente, crittografata con un certificato X.509, utilizzando ASP.NET Core Data Protection

Non è possibile memorizzare le credenziali di test nei file del piano di test. È necessario selezionare Storagestate o Dataverse come posizione sicura in cui archiviare le credenziali. Il file del piano di test contiene riferimenti alle variabili ambientali utilizzate per la persona utente. Ad esempio, il seguente frammento YAML indica che vengono utilizzate le variabili d'ambiente: user1Email

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Per ulteriori informazioni, vedere Utenti .

Utilizzare il seguente script di PowerShell per memorizzare il nome utente nelle variabili di ambiente.

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

Esegui il test

Utilizzare il comando PAC CLI pac test run per eseguire il piano di test.

Parametri richiesti

È necessario fornire le informazioni seguenti:

  • --test-plan-file: Percorso al file del piano di test
  • --tenant: Il tuo ID tenant
  • --environment-id: Il tuo ID ambiente
  • --domain: URL del dominio della pagina dell'app basata sul modello da testare

Formati URL per app basate su modelli

Per le app basate su modello, il parametro varia in base al tipo di pagina che stai testando. --domain Il formato URL dovrebbe specificare quello corretto in base allo scenario di test: pagetype

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

Integrazione con Dataverse

Per abilitare l'integrazione Dataverse con i test delle app basate su modelli, aggiungi il parametro enableDataverseFunctions nelle impostazioni di prova testSettings:

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

Quando si abilita l'integrazione di Dataverse, è necessario aprire Azure CLI con un utente o un'entità servizio con diritti per l'ambiente Dataverse. È possibile usare il comando az login Altre informazioni: Sign in with Azure CLI.

L'URL API Dataverse utilizzato per l'integrazione viene ottenuto dal nome di dominio host del parametro pac test run--domain oppure definendo una variabile di ambiente PowerShell denominata DATAVERSE_URL.

Visualizza i risultati

Una volta completati i test, potrai visualizzarne i risultati nel file .trx che si trova nella directory di output. Questa cartella contiene tutti gli screenshot o i video acquisiti dai test quando recordVideo è impostato su true nel file YAML del piano di test.

  • Last updated on