Migrar desde el motor de pruebas de Power Apps

Power Apps motor de pruebas usa definiciones de prueba basadas en YAML que se ejecutan en un host de prueba especializado. Los ejemplos de Power Platform Playwright usan TypeScript y el ejecutor de pruebas estándar de Playwright, lo que proporciona acceso a la API completa de Playwright, las herramientas del ecosistema y las integraciones de CI/CD.

En esta guía se asignan los conceptos del motor de pruebas a sus equivalentes de Playwright y se recorre un ejemplo concreto de migración.

Mapa conceptual

En la tabla siguiente se muestra cómo se asignan los conceptos del entorno de pruebas a sus equivalentes de Playwright.

Antes de empezar

Complete estos requisitos previos antes de iniciar la migración.

1. Clone el repositorio e instale las dependencias:

   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. Copie la dirección URL de la aplicación desde el YAML del motor de pruebas appLogicalName o el portal de creación de Power Apps.

3. Configuración de la autenticación: consulte la guía de autenticación.

Paso 1: Identificar el tipo de aplicación

Test Engine admite aplicaciones basadas en lienzo. Si va a migrar:

• Pruebas de aplicaciones de lienzo → Seguir Probar aplicaciones de lienzo.
• Pruebas de página personalizadas → Seguir probar páginas personalizadas.
• Pruebas de aplicaciones basadas en modelos → seguir Probar aplicaciones basadas en modelos.

Paso 2: Mapear la estructura de la prueba

Motor de pruebas YAML

Una definición de prueba típica del Motor de Pruebas se ve así.

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

Equivalente de TypeScript de Playwright

Esta es la misma prueba reescrita mediante Playwright y Power Platform Toolkit.

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');
  });
});

Paso 3: Selectores de control de mapa

Test Engine usa nombres de control de Power Apps Studio directamente en YAML. En Playwright, usa los atributos data-control-name con los mismos valores:

Paso 4: Asignar variables de entorno

El motor de pruebas usa una environmentVariables sección en YAML. Mueva estos valores al .env archivo:

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

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

Paso 5: Configuración y desmontaje del mapa

Convierta los hooks del ciclo de vida del motor de prueba a las funciones integradas beforeEach y 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({ ... });
});

Paso 6: Reemplazar aserciones de Power Fx

Test Engine usa expresiones de Power Fx en Assert(). Reemplace por aserciones de Playwright expect() :

Diferencias clave a tener en cuenta

Tenga en cuenta estas diferencias en el comportamiento a medida que migre sus pruebas.

Ejecución de las pruebas migradas

Después de migrar las pruebas, autentíquelas y ejecútelas mediante estos comandos.

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

Solución de problemas de migración

Consulte la tabla siguiente para conocer los problemas comunes de migración y sus soluciones.

Pasos siguientes

• Probar aplicaciones de lienzo
• Probar aplicaciones controladas por modelos
• Pruebas de ejemplo

Consulte también

• Introducción
• Guía de autenticación
• Modelo de objetos de página