MENU
    Integración de sincronización de Airtable: Jira Server/Data Center
    • 24 Jul 2024
    • 8 Minutos para leer
    • Oscuro
    • PDF

    Integración de sincronización de Airtable: Jira Server/Data Center

    • Oscuro
    • PDF

    Resumen del artículo

    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.

    NOTA

    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 planAcceso en el plan Enterprise solamente
    Permisos
    • Propietarios/Creadores : necesitarás tener permisos de creador para configurar una sincronización de Jira Server/Data Center con una base de Airtable.
    • Admins de Enterprise: dependiendo del tipo de acceso de la cuenta que tienes en la organización, es posible que tengas que comunicarte con otra persona para que te ayude a conectar Airtable con Jira. Esto implica configurar los permisos adecuados tanto en Jira como en el panel de administración de Airtable.
    PlataformasWeb/navegador, app de Mac y app de Windows
    Materiales relacionados


    Configurar una sincronización de Jira Server

    Paso 1: añadir una nueva tabla sincronizada

    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.

    acción jira_server_sync_integration_find


    Paso 2: seleccionar una cuenta de Jira

    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.

    image.png

    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.

    Nota

    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.

    Paso 3: elegir un conjunto de datos filtrados desde 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.

    NOTA
    Si has perdido registros de Airtable debido a un cambio de filtro, podemos ayudarte. Ponte en contacto con nuestro equipo de Soporte para solicitar ayuda.
    Paso 4: seleccionar campos para sincronizar

    Después de hacer clic en Siguiente, aparecerán dos opciones de sincronización. Puedes sincronizar:

    1. Todos los campos de la vista de origen (filtro de Jira), incluyendo cualquier campo que Jira añada en el futuro.
    2. Campos específicos de la vista de origen (filtro de Jira).

    image.png

    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.

    image.png

    Encontrarás más información sobre los campos de Jira más abajo.

    Paso 5: crear tabla sincronizada

    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.

    image.png

    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.

    image.png


    Conocer los campos de Jira compatibles

    Datos de campo que se pueden sincronizar desde Jira de forma nativa

    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 incidenciaPrioridadPrincipal
    ResumenEtiquetasEntorno
    DescripciónTiempo empleadoVersiones afectadas
    EstadoAgregadoNombre de epic
    ProyectoTiempo empleadoSprint
    Tipo de incidenciaTiempo restanteInformante
    Hora de creación Tiempo restante agregadoSeñalado
    ActualizadoEstimación originalEstimación de puntos de historia
    ComponentesFecha de vencimientoFecha de inicio
    Puntos de historiaColor de incidencia
    Versiones fijasResponsable
    Campos personalizados de Jira

    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 personalizadoNotas
    Campo de númeroEstándar
    Casillas de verificaciónEstándar
    Lista de selección (opción múltiple/opción única)Estándar
    Botones de opciónEstándar
    Seleccionador de hora y fechaEstándar
    Seleccionador de fechaEstándar
    EtiquetasEstá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 URLEstándar
    Clasificación globalAvanzado
    Campo de sprint de JiraAvanzado
    Puntos de historia originalesAvanzado. Solo se puede mostrar una vez en una incidencia.
    Fecha de inicio previstaAvanzado
    Fecha de finalización previstaAvanzado
    Seleccionador de usuarios (varios usuarios)Avanzado
    Conmutador de trabajos ocultosAvanzado
    Casilla de verificación de trabajosAvanzado
    Seleccionador de proyecto (un solo proyecto)Avanzado
    Campo de texto (solo lectura)Avanzado
    Seleccionador de usuarios (varios usuarios)Avanzado
    Campos guardados previamente/bloqueados

    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 campoFunción de campoNotas
    Color de epicColor del epic
    Enlace de epicRelación entre enlace y epicSolo aparecerá si la incidencia NO es un epic
    Nombre de epicNombre del epicSolo aparecerá si la incidencia es un epic
    Estado de epicEstado del epicSolo aparecerá si la incidencia es un epic
    ClasificaciónClasificación globalAvanzado
    SprintCampo de sprint de JiraAvanzado
    Puntos de historia originalesPuntos de historia originalesAvanzado
    Fecha de inicio previstaFecha de inicio previstaAvanzado
    Fecha de finalización previstaFecha de finalización previstaAvanzado
    Tipos de campos no compatibles

    Nombre de campoTipo de campoNotas

    Lista de selección

    Cascada
    Avanzado

    Enlace principal 

    DesconocidoAvanzado: 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:

    image.png

    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.

    NOTA
    No es necesario instalar ningún complemento o app aparte en la instancia de Jira del usuario. Los datos que recuperamos de la API de Jira se transmiten de forma segura a través de HTTPS y no se utilizarán para ningún otro fin que no sea la tabla sincronizada.

    Á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

    ¿Qué tipo de acceso a Jira tendrá Airtable?

    Airtable solo tendrá acceso a las incidencias y los filtros a los que tenga acceso el usuario que conectó la sincronización de Jira.

    ¿Se puede usar cualquier filtro al configurar esta sincronización?

    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.

    ¿Qué pasa con la sincronización si se desactiva la cuenta de Jira usada?

    Si la cuenta de Jira conectada está desactivada, la sincronización dejará de funcionar.

    ¿Se pueden usar campos personalizados en Jira en la sincronización?

    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.

    ¿Hay alguna limitación que deba conocer?

    La cantidad máxima de incidencias sincronizadas es 10 000. Este es un límite que imponemos para garantizar un rendimiento razonable.

    ¿Hay algún límite de velocidad en la solicitud de API que Airtable enviará a Jira Server?

    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.

    ¿Hay algún requisito de versión para que esta sincronización funcione?

    Sí. El tipo de sincronización de Airtable actualmente es compatible con la versión 7.13 o más reciente de Jira Software.



    ¿Te ha sido útil este artículo?