Integraciones
En Configuraciones > Integraciones, la organización conecta Proton con las herramientas que ya usa: el git con el código de las automatizaciones, Jira, Xray y Zephyr, BrowserStack y Firebase. Cada integración guarda la dirección y las credenciales de la herramienta, y habilita en el portal las funciones que dependen de ella.
De Proton a tu empresa
En la parte de arriba de la pantalla, De Proton a tu empresa lleva al camino inverso: los datos de Proton en las herramientas de la empresa.
- API de consulta (en Configuraciones > API de consulta): ejecuciones, logs, indicadores y ocurrencias en el Data Warehouse, en Power BI y en los paneles, con un token de solo lectura. Ver Monitoreo y Data Warehouse.
- Webhooks (en la pestaña Webhooks de Configuraciones > Alertas y webhooks): los eventos al momento, firmados, para el monitoreo y los tickets. Ver Webhooks.
Las dos forman parte del plan Enterprise.
Qué conecta cada integración
| Integración | Categoría | Campos | Qué conecta en Proton |
|---|---|---|---|
| GitHub | Control de Versiones | Organización (opcional, solo para la prueba) y Token | Repositorios en GitHub.com. |
| GitLab | Control de Versiones | URL Base (vacía para gitlab.com) y Token | Repositorios en gitlab.com o en un GitLab de la empresa. |
| Bitbucket | Control de Versiones | Workspace, Usuario y Clave de Acceso | Repositorios en Bitbucket Cloud. |
| Jira | Gestión de Proyectos | URL Base, Correo electrónico y Token de API | Requisitos, bugs y las columnas de Jira en la trazabilidad. Ver Jira. |
| Xray | Gestión de Pruebas | URL Base, Client ID y Client Secret, y los proyectos | Publicación de resultados, Tests, importación de Test Plan y ejecución desde Jira. Ver Xray y Zephyr. |
| Zephyr | Gestión de Pruebas | URL Base, región de la API, Token de API y los proyectos | Lo mismo que Xray, con los nombres de Zephyr. |
| BrowserStack | Infraestructura de Pruebas | Usuario y Clave de Acceso | Dispositivos en la nube al iniciar la ejecución y el envío de las apps. Ver Apps Móviles. |
| Firebase | Distribución de Apps | ID del Proyecto y la Clave de Cuenta de Servicio (JSON) | La importación de las releases de App Distribution en Apps Móviles. |
La pantalla también ofrece Azure DevOps, SauceLabs, Synthesized, Slack y Teams. Puedes registrarlas, pero por ahora ninguna pantalla de Proton usa esas integraciones.
Jira, Xray y Zephyr tienen que ser de la nube (Jira Cloud, en https://suempresa.atlassian.net). Las versiones Data
Center y Server no están soportadas.
Registrar
Añadir abre Crear Integración:
- Selecciona la plataforma entre las tarjetas.
- En General, escribe el Nombre y completa la dirección o el campo de contexto de la plataforma.
- En Autenticación, completa las credenciales. Los campos secretos quedan ocultos, con el ícono del ojo para revisarlos.
- En Xray y Zephyr, indica los Proyectos de Jira (las claves, como QA) y el Proyecto predeterminado, que las pantallas muestran ya elegido. En Zephyr, elige también la Región de la API de Zephyr, la misma de tu Jira Cloud (si tienes dudas, Estados Unidos).
- Probar Conexión verifica las credenciales antes de guardar. Guarda.
Las credenciales quedan cifradas en Proton y nunca vuelven a la pantalla. Al editar, el tipo no cambia, y las credenciales solo se reemplazan con Actualizar Credenciales (o se conservan con Mantener credenciales actuales).
:::tip Usa una cuenta de servicio Para las credenciales, prefiere un usuario técnico de la herramienta en lugar de la cuenta de una persona: así la integración no deja de funcionar cuando alguien sale de la empresa. :::
La lista
Las tarjetas muestran el nombre, el tipo, la categoría, la dirección, la fecha de la última validación y el estado (Activo o Error). La búsqueda y los filtros (Activas, Con error) ayudan a encontrar una integración.
Probar Conexión, en la tarjeta, prueba las credenciales guardadas y actualiza el estado. La prueba verifica de verdad las credenciales de GitHub, GitLab, Jira, Xray, Zephyr, BrowserStack y Firebase.
Después de registrar Jira, Xray o Zephyr, sus funciones pueden tardar hasta un minuto en aparecer en el portal.
Eliminar
Antes de eliminar, revisa qué depende de la integración:
- una integración git usada por un repositorio no se puede eliminar: cambia primero la integración del repositorio;
- eliminar Jira, Xray o Zephyr elimina en Proton los requisitos y los bugs vinculados, la publicación de los grupos, los vínculos de los datasets con los Tests y el histórico de publicación. Nada cambia en Jira.
Integraciones git
El camino completo del código, de la integración al runner, está en Sistemas y repositorios. En resumen: registra la integración con el token, registra el repositorio usando esa integración, vincula el sistema al repositorio y elige la rama al iniciar la ejecución.
El token necesita leer los repositorios de las automatizaciones y listar las ramas. En los repositorios marcados con BDD
en GitHub, Proton también crea la rama proton-bdd, y el token necesita permiso de escritura.
Permisos y celular
Ver, crear, editar y eliminar las integraciones son permisos de la entidad Integration, en la pestaña Configuración del perfil. Probar la conexión de una integración guardada requiere permiso de edición.
La pantalla está pensada para la computadora. Las funciones de Jira, Xray y Zephyr en el detalle de la ejecución y en la trazabilidad funcionan en el celular.