Solucionar problemas del conector Jira de Smartsheet

El conector de Jira de Smartsheet está disponible como oferta premium. Si compró el Conector de Smartsheet para Jira en su plan, inicie sesión para crear flujos de trabajo entre Smartsheet y Jira.

¿Quién puede usar esto?

Planes:

  • Advanced Work Management
  • Business
  • Enterprise

Permisos:

Para crear o editar un flujo de trabajo, se requieren los siguientes permisos:

  • Debe ser un usuario con licencia en el entorno de Smartsheet. Esto incluye tener permisos de editor o superiores en cualquier hoja asignada dentro del flujo de trabajo.
  • Debe tener una cuenta de Jira funcional con los derechos de acceso adecuados a los proyectos de Jira para los que desea crear un flujo de trabajo.
  • El administrador del sistema debe habilitar la configuración Restringir usuarios del Conector de Jira y asignarle la función de Usuario del Conector de Jira de Smartsheet. Esta función se puede asignar en el Centro de administración de Smartsheet o directamente en la interfaz del Conector de Jira.

Find out if this capability is included in Smartsheet Regions or Smartsheet Gov.

Detectar y corregir errores de sincronización

Puede usar los siguientes recursos para detectar y resolver errores de flujo de trabajo:

  • Historial de ejecución: Vaya a esta página para ver el recuento de errores de sincronización de un flujo de trabajo, junto con el mensaje de error y los detalles del problema. 
  • Informes de errores: Cuando se producen problemas, el propietario del flujo de trabajo y la persona que editó el campo o la fila del flujo de trabajo que causó el problema reciben un correo electrónico.
  • Columna Error: Marque esta columna en su hoja para revisar un mensaje en las filas con un problema de sincronización.

Historial de ejecución

Después de crear un flujo de trabajo, puede acceder a la página Historial de ejecución para ver el historial de sincronización y los errores que se produjeron. Puede acceder al Historial de ejecución seleccionando la marca de tiempo de su flujo de trabajo en Última ejecución .

Brandfolder Image
Jira last run log

Hay los siguientes tipos de ejecución en su Historial de ejecución :

  • Sync to Smartsheet (Sincronizar con Smartsheet ): El flujo de trabajo se ejecuta para los cambios de Jira que se sincronizaron con Smartsheet.
  • Sync to Jira (Sincronizar con Jira) : El flujo de trabajo se ejecuta para los cambios de Smartsheet que se sincronizaron con Jira.
  • Buscador de filas filtradas: El flujo de trabajo se ejecuta para detectar cambios en cualquier problema que deba filtrarse según la configuración de su flujo de trabajo. El Buscador de filas filtradas es un proceso en segundo plano que se ejecuta cada dos horas. Las incidencias filtradas se agregan a la jerarquía Filtered Out by Connector—Not Synced de la hoja. El proceso del buscador de filas filtradas solo se ejecuta con tipos de flujo de trabajo automatizados. Este proceso se ejecuta incluso si no ha especificado filtros en su flujo de trabajo.

Errores comunes 

A medida que se producen problemas, el propietario del flujo de trabajo y la persona que editó el problema o la fila en el flujo de trabajo que causó el problema reciben informes de errores por correo electrónico. A continuación, le mostramos algunos errores y problemas comunes.

Campo [Grupo] no establecido

Asunto

Detalles

Detalles

Los problemas que no tienen un valor de agrupación establecido en Jira aparecen en una jerarquía denominada grupo de campos no establecido

Resolución de problemas

Asignar un valor de agrupación a las incidencias en Jira

Filtrado por conector: no sincronizado

Asunto

Detalles

Detalles

Esto ocurre con el conector de Salesforce y Jira. La fila Filtered Out by Connector-Not Synced no agrega filas con problemas de sincronización; solo muestra los elementos eliminados en Jira o las filas que ya no cumplen con los criterios del filtro de Jira y no se sincronizan con Jira.

Resolución de problemas

  • Si hay filas con errores o problemas de sincronización, verá un error en el campo Error de sincronización que debe resolverse antes de que la fila se sincronice correctamente con Jira.
  • El conector crea automáticamente la fila Filtered Out by Connector-Not Synced , y las filas que no se sincronizan se aplican sangría a continuación.

No se puede establecer el campo . No se encuentra en la pantalla correspondiente, o bien, se desconoce.

Asunto

Detalles

Detalles

Este error aparece si el valor del campo que desea establecer no está en la pantalla Editar de Jira. Solo los campos de la pantalla Editar en Jira se pueden editar desde el Conector de Smartsheet para Jira.

Resolución de problemas

  • Configure la pantalla Editar en Jira y agregue el campo especificado. Para obtener más información, consulte Definición de una pantalla en la documentación de Jira.
  • Asigne el campo especificado solo en una dirección (de Jira a Smartsheet). Esto crea un mapa unidireccional; los cambios en Smartsheet no se vuelven a escribir en Jira.

Error al configurar las notificaciones

Asunto

Detalles

Detalles

El conector de Jira no puede recibir notificaciones de cambios de Jira a través del webhook. Cuando esto sucede, el conector no puede detectar actualizaciones en Jira y sincronizarlas con Smartsheet.

Resolución de problemas

Verifique el registro del webhook en Jira:

  • Inicie sesión en Jira como administrador del sistema.
  • Vaya a Configuración > Sistema > WebHooks .
  • Confirme que un webhook para el Conector de Smartsheet para Jira aparezca en la lista y esté activo. Si falta o está desactivado, el conector no recibe notificaciones.

Verifique los permisos de administrador del sistema de Jira:

  • La cuenta utilizada para conectarse a Jira debe tener privilegios de administrador del sistema. Si los permisos se modificaron recientemente, es posible que el webhook se haya eliminado o cancelado el registro.

Vuelva a autenticar el conector:

  • En el Conector de Jira , vaya a Configuración y vuelva a autenticarse con una cuenta de Administrador del sistema de Jira. Esto intenta volver a registrar el webhook.

Verifique las restricciones de red o firewall de Jira (solo Jira con alojamiento propio):

  • Si utiliza una instancia de Jira con alojamiento propio (local), asegúrese de que el servidor pueda llegar a los puntos de enlace del conector de Smartsheet. Revise los requisitos para una configuración autohospedada exitosa para confirmar que su red esté configurada correctamente.

Verifique que ninguna actualización de la aplicación Jira rompa el webhook:

  • Después de las actualizaciones de la versión de Jira o de los complementos, a veces se pueden eliminar los webhooks. Confirme que su instancia de Jira esté ejecutando una versión compatible.

 Si el problema persiste después de los pasos anteriores, comuníquese con Soporte de Smartsheet y proporcione un archivo de información de soporte de ejecución de flujo de trabajo (WEX) para ayudar a acelerar la resolución. Consulte Generar un archivo WEX para soporte a continuación.


Generar un archivo WEX para soporte

Si ha realizado los pasos de solución de problemas anteriores y aún necesita ayuda, generar un archivo de información de soporte de ejecución de flujo de trabajo (WEX) antes de ponerse en contacto con el soporte ayuda al equipo a diagnosticar su problema más rápido y reducir las idas y venidas.

El archivo WEX contiene información detallada sobre su flujo de trabajo, incluidas las asignaciones de campos, la dirección de sincronización y las configuraciones de filtros. No contiene sus datos de Smartsheet o Jira.

Cualquier administrador del sistema o del conector de Smartsheet puede generar un archivo WEX siguiendo estos pasos:

  1. Inicie sesión en https://connectors.smartsheet.com/c/jira .
  2. En el panel del conector de Jira, seleccione la marca de tiempo en la columna Fecha de ejecución del flujo de trabajo afectado. Esto abre el historial de ejecución del flujo de trabajo.
  3. Seleccione la marca de tiempo en Última ejecución para la ejecución más reciente.
  4. En la página siguiente, abra el menú de hamburguesas (tres líneas horizontales en la parte superior izquierda) y seleccione Descargar información de soporte de ejecución de flujo de trabajo .

Adjunte este archivo cuando envíe su ticket de soporte o cuando lo comparta con el Soporte de Smartsheet.

El archivo WEX está en formato JSON. El soporte lo analiza por su cuenta; no es necesario que lo interprete usted mismo.

Preguntas frecuentes

Cuando se presentan problemas, se envían informes de errores por correo electrónico al propietario del flujo de trabajo y a la persona que editó el registro o la fila en el flujo de trabajo que provocó el inconveniente. A continuación, le mostramos algunos errores y problemas comunes.

Problema: El orden de las filas no es el esperado

Al ejecutar un flujo de trabajo automatizado, los registros se ordenan de forma ascendente por Referencia del problema, incluso si están ordenados de manera diferente en Jira. Para ordenar los problemas sincronizados con un flujo de trabajo automático, utilice Agrupación de filas .

En el caso de los flujos de trabajo manuales, el proceso del Buscador de filas filtradas no se ejecuta. En este caso, puede ordenar manualmente las filas de la hoja.

Si desea ordenar los registros manualmente al utilizar flujos de trabajo automatizados, siga estos pasos:

  1. Sincronice Jira con otra hoja.
  2. Utilice una fórmula de índice/coincidencia entre hojas o vlookup para llevar los valores a la hoja principal utilizando la referencia del problema. Fórmula de ejemplo: =INDEX({Rango que contiene valor a devolver}, MATCH([Valor de búsqueda]@row, {Rango que contiene valor de búsqueda}, 0))

No pudo guardarse el registro en Jira

Debe tener permisos de escritura en los proyectos de Jira conectados para guardar los datos en ellos.

No se eliminan los datos de una hoja luego de las actualizaciones de filtros

Smartsheet no eliminará los datos extraídos de Jira porque cada fila puede contener datos de columnas, archivos adjuntos o comentarios importantes.
Cuando los problemas de Jira en su hoja ya no cumplen con los criterios de filtro del flujo de trabajo, Smartsheet crea una sección Filtered out by Connector—not synced (Filtrado por conector, no sincronizado) en la parte superior para conservar la información que el conector filtra. Las filas filtradas no se sincronizarán hasta tanto se ajusten a los criterios nuevamente. Dichas filas pueden eliminarse si su equipo ya no precisa que estén incluidas en la hoja.

Error al actualizar la columna de errores en Smartsheet

Verá un mensaje de error cuando la columna Error de sincronización se elimine de la hoja conectada. Asegúrese de que la hoja incluya una columna Error de sincronización; es obligatoria. Puede editar el flujo de trabajo para volver a asignar la columna Error de sincronización a su hoja. Consulte cómo modificar un flujo de trabajo para obtener más información.

Columna de errores

El conector agrega automáticamente esta columna a la hoja; muestra detalles sobre los problemas de sincronización que ocurran en la fila. 

 

…no es un usuario válido para el proyecto de JIRA determinado

Este mensaje puede aparecer cuando se ingresa un correo electrónico no válido en un campo de Smartsheet sincronizado con Jira y puede causar problemas con la sincronización de contactos. 

Además, dentro de Jira Cloud, este error puede ocurrir si el usuario no está asignado al proyecto en Jira o si, en Jira, los servicios externos (como el Conector de Smartsheet para Jira) no pueden ver las direcciones de correo electrónico. Para modificar la configuración por usuario, acceda a Perfil > Administrar su cuenta > Perfil y visibilidad y modifique la opción ¿Quién puede ver esto? configuración para el campo Contacto en la parte inferior. Si se establece en Only you and the admins (Solo usted y los administradores) , el Conector de Jira no podrá acceder a la información de la dirección de correo electrónico del usuario con esta configuración y no completará el campo de correo electrónico.

Cuando intento acceder al Conector de Jira, me dice que no tengo autorización para realizar esta acción. ¿Qué puedo hacer?

Es posible que aún no tenga los permisos necesarios para acceder al Conector de Jira. Comuníquese con el administrador del sistema de Smartsheet para obtener ayuda. 

Aprenda a ponerse en contacto con su administrador del sistema.