Migrer à partir du moteur de test Power Apps

Power Apps Moteur de test utilise des définitions de test basées sur YAML qui s’exécutent sur un hôte de test spécialisé. Les exemples Playwright power Platform utilisent TypeScript et l’exécuteur de test Playwright standard, ce qui vous donne accès à l’API Playwright complète, aux outils de l’écosystème et aux intégrations CI/CD.

Ce guide correspond les concepts du moteur de test à leurs équivalents Playwright et décrit un exemple de migration concret.

Mappage de concepts

Le tableau suivant montre comment les concepts du moteur de tests sont mappés à leurs équivalents Playwright.

Avant de commencer

Remplissez ces conditions préalables avant de commencer la migration.

1. Clonez le référentiel et installez les dépendances :

   git clone https://github.com/microsoft/power-platform-playwright-samples.git
   cd power-platform-playwright-samples
   node common/scripts/install-run-rush.js install
   

2. Copiez l’URL de votre application à partir du moteur de test YAML appLogicalName ou du portail de création de Power Apps.

3. Configurer l’authentification : consultez le guide d’authentification.

Étape 1 : Identifier votre type d’application

Le moteur de test prend en charge les applications Canvas. Si vous migrez :

• Tests des applications canevas → Suivez Tester les applications canevas.
• Tests de page personnalisés → Suivre les pages personnalisées de test.
• Tests d'applications pilotées par modèle → Suivez les tests d'applications pilotées par modèle.

Étape 2 : Mapper votre structure de test

YAML du moteur de test

Une définition typique de test de Test Engine ressemble à ceci.

testSuite:
  testSuiteName: OrdersTests
  testCases:
    - testCaseName: CreateOrder
      testSteps: |
        Select(AddButton);
        SetProperty(OrderNumberInput, "ORD-TEST");
        Select(SaveButton);
        Assert(Label1.Text = "Saved");

Équivalent TypeScript de Playwright

Voici le même test réécrit à l’aide de Playwright et du kit de ressources Power Platform.

import { test, expect } from '@playwright/test';
import { AppProvider, AppType, AppLaunchMode, buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';

test.describe('OrdersTests', () => {
  test('CreateOrder', async ({ page, context }) => {
    const app = new AppProvider(page, context);
    await app.launch({
      app: 'Orders App',
      type: AppType.Canvas,
      mode: AppLaunchMode.Play,
      skipMakerPortal: true,
      directUrl: buildCanvasAppUrlFromEnv(),
    });

    const canvasFrame = page.frameLocator('iframe[name="fullscreen-app-host"]');

    // Wait for app to load
    await canvasFrame
      .locator('[data-control-part="gallery-item"]')
      .first()
      .waitFor({ state: 'visible', timeout: 60000 });

    // Select(AddButton)
    await canvasFrame.locator('[data-control-name="AddButton"] [role="button"]').click();

    // SetProperty(OrderNumberInput, "ORD-TEST")
    await canvasFrame.locator('input[aria-label="Order Number"]').fill('ORD-TEST');

    // Select(SaveButton)
    await canvasFrame.locator('[data-control-name="SaveButton"] [role="button"]').click();

    // Assert(Label1.Text = "Saved")
    await expect(canvasFrame.locator('[data-control-name="Label1"]')).toHaveText('Saved');
  });
});

Étape 3 : Sélecteurs Map Control

Le moteur de test utilise des noms de contrôle de Power Apps Studio directement dans YAML. Dans Playwright, utilisez data-control-name des attributs avec les mêmes valeurs :

Étape 4 : Mapper des variables d’environnement

Le moteur de test utilise une environmentVariables section dans YAML. Déplacez ces valeurs vers votre .env fichier :

# Test Engine YAML
environmentVariables:
  - name: appUrl
    value: https://apps.powerapps.com/play/...

# packages/e2e-tests/.env
CANVAS_APP_URL=https://apps.powerapps.com/play/...

Étape 5 : Mapper la configuration et le nettoyage

Convertissez les hooks de cycle de vie Test Engine en fonctions intégrées beforeEach et afterEach de Playwright.

# Test Engine
testSuite:
  onTestCaseStart: |
    Navigate(HomeScreen);

// Playwright
test.beforeEach(async ({ page, context }) => {
  // Re-launch the app for each test (equivalent to onTestCaseStart navigation)
  const app = new AppProvider(page, context);
  await app.launch({ ... });
});

Étape 6 : Remplacer les assertions Power Fx

Le moteur de test utilise des expressions Power Fx dans Assert(). Remplacez par les assertions Playwright expect() :

Différences clés à connaître

Gardez ces différences comportementales à l’esprit lorsque vous migrez vos tests.

Exécutez vos tests migrés

Après avoir migré vos tests, authentifiez-les et exécutez-les à l’aide de ces commandes.

cd packages/e2e-tests
npm run auth:headful      # authenticate
npx playwright test       # run all tests
npx playwright test --ui  # run with interactive UI

Résoudre les problèmes liés à la migration

Reportez-vous au tableau suivant pour connaître les problèmes de migration courants et leurs solutions.

Étapes suivantes

• Tester des applications de canevas
• Tester des applications basées sur des modèles
• Exemples de tests

Voir également

• Démarrer
• Guide d’authentification
• Modèle de page objet