La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

Enviar notificaciones por correo electrónico con los resultados de Polyspace Bug Finder Server

Si ejecuta un análisis de Polyspace® como parte de la integración continua, cada nuevo envío de código produce resultados nuevos. No solo se ven resultados nuevos en componentes que se han modificado, sino también en componentes que dependían de los componentes modificados. Puede configurar alertas por correo electrónico para que los propietarios de componentes reciban notificaciones cuando aparezcan resultados nuevos de Polyspace en sus componentes.

Crear notificaciones por correo electrónico

Para crear notificaciones por correo electrónico:

  1. Exporte los nuevos resultados de análisis a un archivo de texto delimitado por tabulaciones (formato .tsv). Para cada resultado, el archivo contiene enlaces para abrir el resultado en la interfaz web de Polyspace Access.

    Aplique filtros para exportar tipos específicos de resultados, por ejemplo, defectos de gran impacto. Si es necesario, también puede aplicar filtros adicionales a los archivos exportados utilizando utilidades de búsqueda y reemplazo. Consulte Exportar resultados para adjuntos de correo electrónico.

  2. Envíe un correo electrónico con el archivo de resultados como adjunto.

    Por ejemplo, si utiliza un complemento de correo electrónico en Jenkins, puede crear un paso poscompilación para enviar un correo electrónico una vez que se complete el análisis.

Si utiliza el complemento de Polyspace en Jenkins, puede usar las utilidades auxiliares de Polyspace para todo el proceso de notificación por correo electrónico. Consulte Sample Scripts for Polyspace Analysis with Jenkins.

Alternativamente, los resultados pueden asignarse directamente a los propietarios en función de sus rutas de archivos. Puede configurar notificaciones por correo electrónico que exporten un archivo de resultados independiente por propietario y envíen un correo electrónico a cada propietario con el correspondiente archivo de resultados como adjunto. Consulte Asignar propietarios y exportar resultados asignados.

Requisitos previos

Para ejecutar este tutorial:

  • Debe haber cargado algún resultado en el servidor web de Polyspace Access™. Si completa el tutorial Ejecutar PolyspaceBug Finder en un servidor y cargar los resultados en la interfaz web, debería ver una carpeta testProject en el panel Project Explorer de la interfaz web de Polyspace Access. La carpeta contiene un proyecto myFirstProject.

    Para ver los resultados en el proyecto, con myFirstProject seleccionado, haga clic en el botón Review. Verá una lista de defectos. La columna Information muestra el impacto de los defectos. En este tutorial, solo los defectos de gran impacto se exportarán para adjuntos de correo electrónico.

  • Deberá poder interactuar con la interfaz de Polyspace Access desde la línea de comandos. Por ejemplo, vaya a polyspaceserverroot\polyspace\bin e introduzca:

    polyspace-access login -list-project

    En este caso, polyspaceserverroot es la carpeta de instalación de Polyspace Bug Finder™ Server™; por ejemplo, C:\Program Files\Polyspace Server\R2025a. La variable login hace referencia a la siguiente combinación de opciones. Proporcione estas opciones con cada uso del comando polyspace-access.

    -host hostName -port portNumber -login username -encrypted-password pwd

    En este caso, hostName es el nombre del servidor web de Polyspace Access. Para un servidor hospedado localmente, use localhost. portNumber es el número de puerto opcional del servidor. Si se omite el número de puerto, se utiliza 9443. username y pwd hacen referencia al inicio de sesión y a una versión cifrada de la contraseña. Para crear una contraseña cifrada, introduzca:

    polyspace-access -encrypt-password

    Copie la contraseña cifrada y proporcione esta contraseña para usos posteriores del comando polyspace-access.

Exportar resultados para adjuntos de correo electrónico

Puede exportar todos los resultados de un proyecto o solo determinados tipos de resultados.

Abra una ventana de comandos. Vaya a la carpeta donde desea exportar los resultados.

  • Para exportar todos los resultados, introduzca lo siguiente:

    polyspace-access login -export testProject/myFirstProject -output .\result.txt

  • Para exportar solo defectos de gran impacto, introduzca lo siguiente:

    polyspace-access login -export testProject/myFirstProject -defects High -output .\result_high_impact.txt

Abra cada archivo de texto en una utilidad de visualización de hojas de cálculo, como Microsoft® Excel®. En el primer archivo, verá todos los defectos, pero, en el segundo, solo verá los defectos de gran impacto. En lugar de -defects High, puede aplicar otros filtros. Por ejemplo:

  • Para ver solo defectos nuevos en comparación con los análisis previos del mismo proyecto, utilice la opción -new-findings.

  • Para aplicar un conjunto de filtros más detallado, puede utilizar objetivos de calidad del software (SQO). Los objetivos de calidad del software se especifican por medio de un conjunto de niveles SQO progresivamente más estrictos, numerados del 1 al 6. Puede personalizar los requisitos de cada nivel en la interfaz web de Polyspace Access y, a continuación, utilizar la opción -open-findings-for-sqo con el número de nivel para exportar únicamente aquellos resultados que deban revisarse para que cumplan los requisitos. Consulte también Evaluate Polyspace Bug Finder Results Against Bug Finder Quality Objectives.

Para ver todas las opciones de filtrado, introduzca:

polyspace-access -h -export

Puede configurar la utilidad de correo electrónico para enviar estos archivos exportados como adjunto.

Si es necesario, también puede aplicar filtros adicionales a los archivos exportados utilizando utilidades de búsqueda y reemplazo. Por ejemplo, utilice utilidades de búsqueda y reemplazo en el archivo de resultados para incluir solo resultados de archivos y funciones específicos. En Linux®, puede utilizar grep y sed para conservar solo resultados de archivos específicos.

En lugar de exportar a archivos de texto, también puede generar informes en PDF o Word con plantillas de informe predefinidas. Para obtener más información, consulte polyspace-report-generator.

Asignar propietarios y exportar resultados asignados

Puede asignar propietarios a resultados en archivos o carpetas específicos. Después, puede exportar un archivo de resultados por propietario y enviar un correo electrónico a cada propietario con el correspondiente archivo como adjunto.

Puede asignar propietarios en la interfaz web de Polyspace Access o en la línea de comandos.

En este tutorial, asigne todos los resultados del archivo numerical.c a jsmith y todos los resultados del archivo dataflow.c a jboyd.

polyspace-access login -set-unassigned-findings testProject/myFirstProject -owner jsmith -source-contains numerical.c
polyspace-access login -set-unassigned-findings testProject/myFirstProject -owner jboyd -source-contains dataflow.c

Después de la asignación, exporte un archivo de resultados por propietario.

polyspace-access login -export testProject/myFirstProject -output .\results.txt -output-per-owner

Estos archivos contienen los resultados exportados:

  • results.txt contiene todos los resultados.

  • results_jsmith.txt y results_jboyd.txt contienen resultados asignados a jsmith y jboyd, respectivamente.

  • results.txt.owners.list contiene la lista de propietarios, en este caso:

    jsmith
jboyd

Antes de asignar propietarios a los resultados, utilice la opción -dryrun para realizar una simulación de las asignaciones. Sin realizar la asignación, la opción muestra los archivos con resultados que están asignados y el propietario a quien se han asignado los resultados.

Consulte también

(Polyspace Access) | (Polyspace Access) | (Polyspace Access)