Archivos de historial
WARNING
Esta página describe un formato de datos utilizado por Allure. Comprender este formato no es necesario para usar Allure en tu proyecto. Para una descripción más general sobre cómo trabajar con el historial, consulta Historial de pruebas.
El directorio history se utiliza para transferir información simplificada entre informes de prueba consecutivos. El directorio se genera como parte de la creación del informe de prueba y luego se puede copiar al directorio de resultados de prueba para el nuevo informe, ya sea manualmente o mediante un plugin de integración de CI.
La información en el directorio history se utiliza para mostrar la pestaña Historial en los detalles de las pruebas y varios gráficos.
El directorio contiene los siguientes archivos:
history.json
El archivo history/history.json almacena información general sobre las ejecuciones de cada prueba.
En el objeto JSON raíz del archivo, cada clave es el historyId de una prueba. Cada valor es un objeto que contiene:
statistic— las estadísticas relacionadas con la prueba (utilizadas para el Gráfico de estados de prueba).items— información sobre ejecuciones específicas de la prueba (utilizada para la pestaña Historial en los detalles de las pruebas).
Ejemplo:
{
"4da3226ec9761b158ba5f826fc8f8289": {
"statistic": {
"failed": 1,
"broken": 0,
"skipped": 0,
"passed": 0,
"unknown": 0,
"total": 1
},
"items": [
{
"uid": "74556baed1daf783",
"reportUrl": "https://reports.example.com/1234",
"status": "failed",
"statusDetails": "AssertionError: Some fail reason\nassert False",
"time": {
"start": 1682358404995,
"stop": 1682358404995,
"duration": 0
}
}
]
}
}En el objeto statistic, hay una clave correspondiente a cada posible estado de prueba. El valor de cada una de estas claves representa la cantidad de veces que la prueba obtuvo este estado. Además, existe la clave total, cuyo valor representa el número total de informes que incluyen esta prueba.
El arreglo items representa los datos de la prueba desde diferentes informes de prueba. Cada objeto en el arreglo tiene las siguientes propiedades:
uid(string) — el identificador único de este elemento de historial.reportUrl(string) — la URL del informe de prueba del cual se extraen estos datos.status(string) — el estado con el que finalizó la prueba o paso. Copiado destatusen el archivo de resultados de la prueba.statusDetails(string) — el mensaje corto con el que finalizó la prueba. Copiado destatusDetails.messageen el archivo de resultados de la prueba.time(object):start(integer) — el momento en que comenzó la ejecución, en formato de marca de tiempo UNIX. Copiado destarten el archivo de resultados de la prueba.stop(integer) — el momento en que terminó la ejecución, en formato de marca de tiempo UNIX. Copiado destopen el archivo de resultados de la prueba.duration(integer) — la diferencia en segundos entre los valores destartystop.
history-trend.json
El archivo history/history-trend.json almacena datos para el Gráfico de tendencias.
Ejemplo:
[
{
"buildOrder": 1234,
"reportName": "Report #1234",
"reportUrl": "https://reports.example.com/1234",
"data": {
"failed": 0,
"broken": 0,
"passed": 32,
"skipped": 0,
"unknown": 0,
"total": 32
}
}
]Cada objeto en el array tiene las siguientes propiedades:
buildOrder(integer) — el identificador proporcionado por el archivoexecutor.json.reportUrl(string) — la URL del informe de prueba del cual se extraen los datos.reportName(string) — el título del informe del cual se extraen los datos.data(object) — en este objeto, hay una clave correspondiente a cada categoría (consulta Categorías de defectos). El valor de cada una de estas claves representa la cantidad de pruebas en esta categoría. El valor de la clavetotalindica el número total de pruebas.
duration-trend.json
El archivo history/duration-trend.json almacena datos para el gráfico de tendencias de Duración, consulta Gráficos de tendencias.
Ejemplo:
[
{
"buildOrder": 1234,
"reportName": "Report #1234",
"reportUrl": "https://reports.example.com/1234",
"data": {
"duration": 78
}
}
]Cada objeto en el array tiene las siguientes propiedades:
buildOrder(integer) — el identificador proporcionado por el archivoexecutor.json.reportUrl(string) — la URL del informe de prueba del cual se extraen los datos.reportName(string) — el título del informe del cual se extraen los datos.data(object):duration(integer) — número de segundos que se tardó en ejecutar todas las pruebas.
retry-trend.json
El archivo history/retries-trend.json almacena datos para el gráfico de tendencias de Reintentos, consulta Gráficos de tendencias.
Ejemplo:
[
{
"buildOrder": 1234,
"reportName": "Report #1234",
"reportUrl": "https://reports.example.com/1234",
"data": {
"run": 39,
"retry": 15
}
}
]Cada objeto en el array tiene las siguientes propiedades:
buildOrder(integer) — el identificador proporcionado por el archivoexecutor.json.reportUrl(string) — la URL del informe de prueba del cual se extraen los datos.reportName(string) — el título del informe del cual se extraen los datos.data(object):run(integer) — número de ejecuciones de prueba que no causaron un reintento.retry(integer) — número de ejecuciones de prueba que causaron un reintento.
categories-trend.json
El archivo history/categories-trend.json almacena datos para el gráfico de tendencias de Categorías, consulta Gráficos de tendencias.
Ejemplo:
[
{
"buildOrder": 1234,
"reportName": "Report #1234",
"reportUrl": "https://reports.example.com/1234",
"data": {
"Product defects": 2,
"Test defects": 1
}
}
]Cada objeto en el array tiene las siguientes propiedades:
buildOrder(integer) — el identificador proporcionado por el archivoexecutor.json.reportUrl(string) — la URL del informe de prueba del cual se extraen los datos.reportName(string) — el título del informe del cual se extraen los datos.data(object) — en este objeto, hay una clave correspondiente a cada categoría (consulta Categorías de defectos). El valor de cada una de estas claves representa el número de pruebas en esta categoría.