Automatización de pruebas de Playwright con la habilidad uipath-test (vista previa)

Incorpore una suite Playwright existente a UiPath Test Manager con la habilidad uipath-test, sin necesidad de cambios en el código.

Nota:

Esta característica está en vista previa. Las características de vista previa no son compatibles con el uso de producción y pueden tener una funcionalidad limitada.

La habilidad uipath-test permite a un agente de codificación compatible tomar un conjunto de pruebas de Playwright existente, sin cambios de código, y traerlo a UiPath Test Manager.

Pregúntale a tu agente en lenguaje sencillo y creará el proyecto de Test Manager, empaquetará la suite, la cargará en Orchestrator, creará automáticamente casos de prueba vinculados, creará un conjunto de pruebas, lo ejecutará e informará de los resultados aprobados, fallidos y omitidos.

Cuando las pruebas fallan, puedes pedir al agente que las corrija, las vuelva a empaquetar, las vuelva a publicar y las vuelva a ejecutar, completamente desde el terminal. Sin esta habilidad, incorporar una suite de Playwright existente a Test Manager requeriría reescribir las pruebas como automatizaciones de UiPath: este flujo empaqueta tu código de Playwright sin cambios.

Requisitos previos

• UiPath CLI (uip) instalado y autenticado (uip login). Se requiere la versión de CLI 1.200.0 o posterior para el indicador --playwright-projects utilizado en este flujo.
• Habilidades de UiPath instaladas para tu agente de codificación (uip skills install --agent <agent>), que instala el paquete de habilidades uipath-test.
• Playwright instalado localmente en el proyecto que quieres incorporar a Test Manager, instalado con npm (debe estar presente un package-lock.json). La habilidad empaqueta tu suite existente tal cual y no instala Playwright por ti.
• La cuenta de UiPath Robot, que Test Manager utilizará para ejecutar las pruebas, tiene el rol de Ejecutor de pruebas en el proyecto de Test Manager de destino. Sin ella, las pruebas se ejecutan pero los resultados nunca llegan a Test Manager. Para obtener más información, consulta Requisitos previos en la guía de automatización de pruebas de Playwright.

Incorpore su suite a Test Manager

1. Abre tu agente de codificación en la carpeta raíz de tu proyecto de Playwright.

2. Pídele que traiga la suite a Test Manager:

   "He escrito algunos scripts de Playwright para probar mi sitio web [Nombre del producto]. ¿Puede ayudarme a ejecutar estas pruebas utilizando el servicio Test Manager de UiPath?"

3. Responde a las preguntas de configuración del agente en la primera ejecución: en qué proyecto de Test Manager deben aterrizar las pruebas (o si se debe crear una nueva) y qué ámbito de Playwright (por ejemplo, regression, smoke o checkout-critical) ejecutar primero.

4. Revisa el resumen de aprobación, error y omisión que informa el agente, incluido qué errores parecen desajustes de aserción reales frente a problemas de entorno o infraestructura.

Resultado:

En segundo plano, el agente crea el proyecto de Test Manager y su carpeta de ejecución predeterminada de Orchestrator, empaqueta el proyecto de Playwright en un .nupkg y lo carga en la fuente del paquete de Orchestrator.

Test Manager crea y vincula automáticamente un caso de prueba por prueba descubierta. A continuación, el agente crea un conjunto de pruebas cuyo ámbito es el proyecto de Playwright seleccionado, lo ejecuta y sondea hasta que finaliza la ejecución.

Corregir una prueba fallida y volver a ejecutar

Pídale a su agente que corrija y vuelva a ejecutar:

"Corrige las pruebas que fallan y vuelve a ejecutar el conjunto de pruebas de humo".

El agente corrige el código de prueba fallido, luego vuelve a empaquetar con una versión de paquete mejorada, vuelve a cargar y vuelve a ejecutar el mismo conjunto de pruebas. El proyecto de Playwright y la selección de ámbito persisten en el conjunto de pruebas, por lo que no es necesario volver a especificarlo.

ADVERTENCIA:

No pidas al agente que utilice uip tm executions retry para volver a ejecutar después de una corrección. Ese comando vuelve a ejecutar los fallos de la ejecución anterior en la versión anterior del paquete, lo contrario de este bucle. En su lugar, el agente actualiza --package-version, vuelve a empaquetar y vuelve a cargar, y luego vuelve a ejecutar el mismo conjunto de pruebas.

Referencia de los comandos

El agente selecciona estos comandos automáticamente a partir de tus solicitudes; no es necesario que los escribas tú mismo. Son útiles para solucionar problemas o para crear scripts del mismo flujo en CI.

Paso	Comando
Crear el proyecto de Test Manager	uip tm project create --name "SwagLabs" --project-key SWAG --description "..." --output json
Establecer la carpeta de ejecución predeterminada	uip tm project set-default-folder --project-key SWAG --folder-key <key> --output json
Empaquetar el proyecto de Playwright	uip tm pack --project-path . --type playwright --project-key SWAG --name SwagLabsPlaywright --package-version 1.0.0 -o .packages --output json
Cargar en Orchestrator	uip or packages upload ".packages/SwagLabsPlaywright.1.0.0.nupkg" --output json
Encuesta para casos de prueba ingeridos	uip tm testcases list --project-key SWAG --output json
Ejecutar el conjunto de pruebas, con ámbito en un proyecto de Playwright	uip tm testsets run --test-set-key SWAG:37 --playwright-projects regression --output json
Estado de ejecución y resultados de la encuesta	uip tm report get --execution-id <id> --project-key SWAG --output json
Extraer detalles del error para el triaje	uip tm executions testcaselogs list --execution-id <id> --project-key SWAG --only-failed --output json

Nota:

uip tm testcases list no tiene el marcador --limit.

Ver también

• Pruebas : la lista completa de lo que tu agente de codificación puede hacer con Test Manager.
• uip tm pack : referencia completa para el comando de empaquetado utilizado en este flujo.
• uip tm testsets : referencia completa para testsets run y el marcador --playwright-projects .
• uip or packages : referencia completa para publicar paquetes en Orchestrator.