Saltar a contenido

Tu primera evidencia

Registra una captura en un caso de Robot y genera el HTML al terminar. Necesitas Python 3.12 o superior, Robot Framework 7 y SeleniumLibrary para las capturas del navegador.

1. Instala la librería

La biblioteca está publicada en PyPI.

poetry add robotframework-evidence-reporter
poetry add robotframework-seleniumlibrary

pip install robotframework-evidence-reporter
pip install robotframework-seleniumlibrary

En un proyecto de equipo, fija una versión del paquete en el archivo de dependencias para hacer reproducible la instalación. Consulta el repositorio para el código actualizado.

2. Registra una captura

Guarda este ejemplo como evidence.robot. Usa BROWSER:chrome para abrir una ventana o conserva headlesschrome para ejecutarlo sin interfaz visible.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
*** Settings ***
Library    SeleniumLibrary
Library    EvidenceReporter
Test Teardown    Close All Browsers

*** Variables ***
${BROWSER}    headlesschrome

*** Test Cases ***
Consultar El Portal
    Open Browser    https://example.com    ${BROWSER}
    Set Report Metadata    Aplicación=Portal de ejemplo    Ambiente=Demo
    Wait Until Element Is Visible    css:h1
    Element Text Should Be    css:h1    Example Domain
    Capture Page Evidence    Portal disponible    status=PASS

Empieza sin hitos

Las evidencias directas funcionan sin crear bloques. Añade hitos opcionales cuando necesites agrupar un flujo de negocio.

3. Ejecuta y genera

poetry run robot --outputdir results evidence.robot
poetry run rf-evidence build results/evidence --output reports

robot --outputdir results evidence.robot
rf-evidence build results/evidence --output reports

Abre el archivo de reports/ en tu navegador. El HTML incluye las imágenes, estilos y controles; no necesita conexión a Internet para consultarlo.

Una carpeta por ejecución

El generador incluye todos los case.json que encuentre. Usa una carpeta nueva por ejecución para no mezclar resultados anteriores.

Continuar con hitos y metadatos Ver el reporte completo

Directorio de salida

Normalmente importa EvidenceReporter sin argumentos de salida y ejecuta robot --outputdir results tests. Las evidencias van a results/evidence. Para elegir otra ubicación, usa robot --outputdir results --variable EVIDENCE_OUTPUT_DIR:artifacts/evidence tests. El argumento explícito output_dir de la librería conserva la prioridad por compatibilidad. Para Pabot, consulta ejecución paralela.

Elige la captura adecuada

Qué quieres mostrar Keyword Cuándo usarla
Página visible del navegador Capture Page Evidence Una pantalla completada o confirmación
Un elemento del navegador Capture Element Evidence Un resultado, mensaje o componente específico
Escritorio Capture Desktop Evidence Una sesión de escritorio con captura disponible
Archivo de imagen existente Attach Image Evidence Una imagen producida por otra herramienta

Consulta los argumentos exactos y requisitos del entorno en Keyword Reference. La captura de página registra el viewport; no es una captura de página completa.