Menguji aplikasi berbasis model dengan Test Engine (tidak digunakan lagi)

Note

Mesin Uji tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Gunakan sampel Power Platform Playwright untuk kemampuan otomatisasi pengujian di Power Platform dan layanan Dynamics 365.

Menguji aplikasi berbasis model Anda dengan Test Engine memerlukan langkah-langkah berikut:

  1. Membuat rencana pengujian
  2. Menyiapkan pengguna Anda
  3. Jalankan pengujian
  4. Menampilkan hasilnya

Membuat rencana pengujian

Buat file yaml menggunakan skema rencana pengujian yang dijelaskan dalam format YAML Power Apps Test Engine (tidak digunakan lagi).

Tip

Tinjau rencana contoh yang tersedia di repositori GitHub.

Mengaktifkan Pratinjau

Saat ini, semua kemampuan pengujian ekstensi aplikasi berbasis model memerlukan penggunaan fungsi Pratinjau. Untuk mengaktifkannya, tambahkan Preview ke daftar di allowPowerFxNamespacesextensionModules dari testSettings Anda.

Contoh ini menunjukkan cara menambahkan ini:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Mengatur akun pengguna Anda

Test Engine saat ini memiliki metode autentikasi berikut:

Metode Deskripsi
Status Penyimpanan Simpan status pengguna yang diautentikasi secara lokal di profil pengguna menggunakan Microsoft Windows Data Protection API
Dataverse Simpan status pengguna terautentikasi di dalam Dataverse menggunakan kunci terkelola pelanggan Anda sendiri yang dienkripsi dengan sertifikat X.509 menggunakan ASP.NET Core Perlindungan Data

Anda tidak dapat menyimpan kredensial pengujian dalam file rencana pengujian. Anda harus memilih Storagestate atau Dataverse sebagai lokasi aman untuk menyimpan kredensial. File rencana pengujian berisi referensi ke variabel lingkungan mana yang digunakan untuk persona pengguna. Misalnya, cuplikan YAML berikut menunjukkan bahwa user1Email variabel lingkungan digunakan:

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Lihat Pengguna untuk informasi selengkapnya.

Gunakan skrip PowerShell berikut untuk menyimpan nama pengguna di variabel lingkungan Anda.

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

Jalankan pengujian

Gunakan perintah PAC CLI pac test run untuk menjalankan rencana pengujian Anda.

Parameter yang Diperlukan

Anda perlu memberikan informasi berikut:

  • --test-plan-file: Jalur ke file rencana pengujian Anda
  • --tenant: ID penyewa Anda
  • --environment-id: ID lingkungan Anda
  • --domain: URL domain halaman aplikasi berbasis model yang akan diuji

Format URL untuk aplikasi berbasis model

Untuk aplikasi berbasis model, parameter bervariasi --domain berdasarkan jenis halaman yang Anda uji. Format URL harus menentukan yang benar pagetype berdasarkan skenario pengujian Anda:

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

Untuk mengaktifkan Dataverse integrasi dengan pengujian aplikasi berbasis model, tambahkan parameter di enableDataverseFunctionstestSettings:

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

Saat mengaktifkan integrasi Dataverse, Anda diharuskan membuka Azure CLI dengan pengguna atau perwakilan layanan yang memiliki hak atas lingkungan Dataverse. Anda dapat menggunakan perintah: az login Untuk informasi lebih lanjut, lihat Masuk dengan Azure CLI.

Dataverse URL API yang digunakan untuk integrasi diperoleh baik dari nama domain host parameter pac test run--domain atau dengan menentukan variabel lingkungan PowerShell bernama DATAVERSE_URL.

Lihat hasilnya

Setelah pengujian selesai, Anda dapat melihat hasil pengujian Anda di file yang .trx terletak di direktori output. Folder ini berisi cuplikan layar atau video yang diambil oleh pengujian Anda saat recordVideo diatur ke true dalam rencana pengujian yaml.