- 24 Jul 2024
- 8 Minutos para leer
- Impresión
- OscuroLigero
- PDF
Integración de sincronización de Airtable: Jira Server/Data Center
- Actualizado en 24 Jul 2024
- 8 Minutos para leer
- Impresión
- OscuroLigero
- PDF
Aprende a usar la función de integración de sincronización para introducir información de aplicaciones externas en una sola tabla centralizada dentro de Airtable. En este artículo, se explica cómo sincronizar las incidencias de Jira Server/Data Server con una base de Airtable. Usaremos el término Jira Server para referirnos tanto al Data Center como al Server, ya que los mismos pasos funcionan para ambos productos. Esta sincronización en particular es para organizaciones que usan Jira localmente. Si tu organización usa Jira Cloud, lo explicamos en otro artículo de soporte.
Si vas a configurar la primera sincronización de Jira Server en tu organización, asegúrate de que los admins de IT, Airtable o Jira hayan revisado nuestros requisitos de servidor y firewall y hayan seguido los pasos necesarios antes de conectar la cuenta de Jira Server con Airtable. Estos pasos solo deben realizarse una vez, pero son obligatorios.
Introducción
Disponibilidad en plan | Acceso en el plan Enterprise solamente |
Permisos |
|
Plataformas | Web/navegador, app de Mac y app de Windows |
Materiales relacionados |
|
Configurar una sincronización de Jira Server
Para empezar, haz clic en el símbolo + junto a la lista de tablas. Luego, selección la opción Jira Server debajo de Sincronizar datos desde.
Selecciona una cuenta ya existente de Jira Server o conecta una nueva cuenta. Verás una lista de las instancias de Jira Server que el admin de Airtable haya configurado. Para conectar una cuenta de Jira Server, selecciona la instancia que deseas usar para crear la tabla sincronizada. Si no ves el servidor que deseas usar, deberás comunicarte con el equipo de tu cuenta de Airtable para que lo añadan a la lista.
Luego de hacer clic en Continuar, se te pedirá que autorices a Airtable a conectarse a tu cuenta de Jira Server. Para saber más sobre la autenticación, sigue leyendo.
Una vez conectado a un servidor de Jira, podrás elegir qué filtro de incidencias deseas usar para crear registros de Airtable.
Si aparece el error "No se ha podido autorizar la cuenta", es posible que la cuenta conectada haya alcanzado el límite de velocidad de la API REST de Jira.
Para esta sincronización, solo se puede elegir entre los filtros destacados. Consulta la documentación de Atlassian si necesitas ayuda al configurar un nuevo filtro o agregar un filtro a tus favoritos. Es importante elegir un filtro con condiciones que no cambien. Cada vez que se cambian las condiciones de un filtro en Jira, los registros que ya no coinciden se eliminan, junto con cualquier adición que se haga en Airtable.
Por ejemplo, si sincronizaste un filtro que solo tiene errores abiertos, y se cierra un error, el registro de Airtable se eliminará junto con cualquier comentario y actividad del registro, así como otros datos de campo que puedan haberse añadido. Si se vuelve a abrir el mismo error, se creará un nuevo registro de Airtable.
Por ello, recomendamos elegir un filtro que difícilmente cambie.
Después de hacer clic en Siguiente, aparecerán dos opciones de sincronización. Puedes sincronizar:
- Todos los campos de la vista de origen (filtro de Jira), incluyendo cualquier campo que Jira añada en el futuro.
- Campos específicos de la vista de origen (filtro de Jira).
Si eliges sincronizar campos específicos, se te mostrará un menú en el que podrás activar cada campo individual que quieras sincronizar desde Jira.
Encontrarás más información sobre los campos de Jira más abajo.
Antes de crear tu tabla sincronizada, hay opciones de configuración que te permitirán elegir con qué frecuencia quieres sincronizar y cómo manejar los registros que se eliminan u ocultan de la fuente (Jira). Estas son las opciones:
- La frecuencia de la sincronización. Actualmente, las opciones son la sincronización manual y la automática, que ocurre cada 5 minutos.
- Si los registros eliminados (incidencias en el filtro de Jira seleccionado) se deben o no borrar de la tabla de Airtable. De forma predeterminada, los eventos eliminados se borrarán.
Una vez que hayas seleccionado la configuración deseada, haz clic en el botón Crear tabla. La operación de sincronización recuperará todas las incidencias del filtro de Jira seleccionado y generará los registros de Airtable.
Conocer los campos de Jira compatibles
A continuación se muestra una lista de todos los datos de campo proporcionados por Jira que se pueden sincronizar con Airtable dentro de la configuración de sincronización nativa de Airtable:
Clave de incidencia | Prioridad | Principal |
Resumen | Etiquetas | Entorno |
Descripción | Tiempo empleado | Versiones afectadas |
Estado | Agregado | Nombre de epic |
Proyecto | Tiempo empleado | Sprint |
Tipo de incidencia | Tiempo restante | Informante |
Hora de creación | Tiempo restante agregado | Señalado |
Actualizado | Estimación original | Estimación de puntos de historia |
Componentes | Fecha de vencimiento | Fecha de inicio |
Puntos de historia | Color de incidencia | |
Versiones fijas | Responsable |
Esta lista solo incluye los campos personalizados, no los campos del sistema señalados anteriormente. Los nombres y tipos corresponden a los campos personalizados en la página /ViewCustomFields en el servidor de Jira.
> configuración > incidencias > campos personalizados
Encontrarás más información sobre la diferencia entre campos "estándar" y "avanzados" en la documentación de Jira.
Tipo de campo personalizado | Notas |
---|---|
Campo de número | Estándar |
Casillas de verificación | Estándar |
Lista de selección (opción múltiple/opción única) | Estándar |
Botones de opción | Estándar |
Seleccionador de hora y fecha | Estándar |
Seleccionador de fecha | Estándar |
Etiquetas | Estándar |
Campo de texto (varias líneas/una sola línea) | Estándar |
Seleccionador de usuario (un solo usuario) | Estándar. Sincronizado como texto sin formato. |
Campo de URL | Estándar |
Clasificación global | Avanzado |
Campo de sprint de Jira | Avanzado |
Puntos de historia originales | Avanzado. Solo se puede mostrar una vez en una incidencia. |
Fecha de inicio prevista | Avanzado |
Fecha de finalización prevista | Avanzado |
Seleccionador de usuarios (varios usuarios) | Avanzado |
Conmutador de trabajos ocultos | Avanzado |
Casilla de verificación de trabajos | Avanzado |
Seleccionador de proyecto (un solo proyecto) | Avanzado |
Campo de texto (solo lectura) | Avanzado |
Seleccionador de usuarios (varios usuarios) | Avanzado |
Los nombre de los campos guardados previamente/bloqueados también se consideran campos personalizados en Jira. Los usuarios de Jira no pueden crear otros campos personalizados con estos nombres.
Nombre de campo | Función de campo | Notas |
---|---|---|
Color de epic | Color del epic | |
Enlace de epic | Relación entre enlace y epic | Solo aparecerá si la incidencia NO es un epic |
Nombre de epic | Nombre del epic | Solo aparecerá si la incidencia es un epic |
Estado de epic | Estado del epic | Solo aparecerá si la incidencia es un epic |
Clasificación | Clasificación global | Avanzado |
Sprint | Campo de sprint de Jira | Avanzado |
Puntos de historia originales | Puntos de historia originales | Avanzado |
Fecha de inicio prevista | Fecha de inicio prevista | Avanzado |
Fecha de finalización prevista | Fecha de finalización prevista | Avanzado |
Nombre de campo | Tipo de campo | Notas |
---|---|---|
Lista de selección | Cascada | Avanzado |
Enlace principal | Desconocido | Avanzado: no se puede establecer este campo |
Equipo | Desconocido | Avanzado: no se puede establecer este campo |
Seleccionador de versión | Una sola versión/múltiples versiones | Avanzado |
Desarrollo | Desconocido | Avanzado: no se puede establecer este campo |
Seleccionador de grupo | Un solo grupo/múltiples grupos | Avanzado |
Historial de versiones lanzadas por Jira | Avanzado |
Ámbitos de seguridad y OAuth
Autenticación
La integración de Jira Server en Airtable utiliza OAuth para autenticar las solicitudes de usuarios particulares en su instancia de Jira Server. Esto es lo que verás en la pantalla de consentimiento de OAuth:
Airtable solo tendrá acceso a las incidencias y los filtros a los que tenga acceso el usuario que conectó la sincronización de Jira. Si la cuenta de Jira o Airtable del usuario que conectó una sincronización de Jira está desactivada, la sincronización dejará de funcionar.
Ámbitos de Jira Server
Airtable se integra con Jira Server (localmente) mediante OAuth 1.0a. No es necesario proporcionar ámbitos y los permisos de la integración coincidirán con los permisos del usuario concedidos en Jira Server. Para obtener más información, consulte la documentación de Jira aquí.
Los tokens se transmiten entre Airtable y los servidores de Jira de forma segura mediante HTTPS. Por parte de Airtable, los tokens se almacenan en bases de datos cifradas en reposo.
Preguntas frecuentes
Airtable solo tendrá acceso a las incidencias y los filtros a los que tenga acceso el usuario que conectó la sincronización de Jira.
A diferencia de la función de integración de sincronización de Jira Cloud de Airtable, la sincronización de Jira Server/Data Center solo puede extraer información de los filtros destacados.
Si la cuenta de Jira conectada está desactivada, la sincronización dejará de funcionar.
Los campos personalizados que se basan en los tipos de campo integrados en Jira son compatibles, pero es posible que otros tipos de campos personalizados no lo sean. Encontrarás más información al respecto arriba.
La cantidad máxima de incidencias sincronizadas es 10 000. Este es un límite que imponemos para garantizar un rendimiento razonable.
Sí. Para proteger tu Jira Server, aplicamos de forma predeterminada un límite de velocidad de 5 solicitudes por segundo en la solicitud de API que Airtable haría a Jira Server. Si tienes preguntas o dudas sobre este límite, ponte en contacto con tu equipo de Airtable.
Además, la API de Jira es muy limitada en términos de la cantidad de datos que se pueden transferir con cada solicitud, por lo que se puede esperar un rendimiento de sincronización en un margen de 1 segundo por cada 100 incidencias. Te recomendamos que, siempre que sea posible, elijas filtros que reduzcan la solicitud.
Sí. El tipo de sincronización de Airtable actualmente es compatible con la versión 7.13 o más reciente de Jira Software.