Bagikan melalui


Uji aplikasi berbasis model dengan Test Engine (pratinjau)

Catatan

Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

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

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

Membuat rencana pengujian

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

Tip

Tinjau paket sampel 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 allowPowerFxNamespaces extensionModules testSettingsAnda.

Contoh ini menunjukkan cara menambahkan ini:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Menyiapkan pengguna Anda

Test Engine saat ini memiliki metode autentikasi berikut:

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

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 Dataverse integrasi, Anda diharuskan membuka Azure CLI dengan pengguna atau perwakilan layanan yang memiliki hak ke Dataverse lingkungan. Anda dapat menggunakan perintah: az login Informasi selengkapnya: 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.