Es posible que algunas partes de esta página usen traducción automática.

Prácticas recomendadas y resolución de problemas del Conector de Smartsheet para Jira

El Conector de Smartsheet para Jira 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:

  • Smartsheet Advance Package
  • 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.

Averigüe si esta capacidad está incluida en Smartsheet Regions o 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 un recuento de la cantidad de errores de sincronización de un flujo de trabajo y el mensaje de error con 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 de errores: Consulte 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:

  • Sincronizar con Smartsheet: El flujo de trabajo se ejecuta para los cambios de Jira que se sincronizaron con Smartsheet.
  • 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 los cambios realizados en los problemas que deben filtrarse en función de 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 

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

Causas posibles

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

Filtered out by Connector—not synced (Filtrar por conector: sin sincronizar)

Asunto

Detalles

Causas posibles

Esto ocurre con el conector de Salesforce y Jira. La fila Filtered Out by Connector-Not Synced (Filtrado por conector no sincronizado) no agrega filas con problemas de sincronización, solo elementos eliminados en Salesforce o filas que ya no cumplen con los criterios de los filtros de Salesforce y no se sincronizan con Salesforce.

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 Salesforce.
  • 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.

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 flujos de trabajo automatizados, los registros se ordenan de forma ascendente por Clave 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 clave 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))

Error: Campo '<field name>' no se puede establecer. No se encuentra en la pantalla correspondiente, o bien, se desconoce.

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.

Para solucionar este problema, haga lo siguiente:

  • Configure la pantalla Editar en Jira y agregue el campo especificado a la pantalla. Para obtener más información sobre las pantallas de Jira, incluidos los pasos para cambiar la configuración, consulte Definición de una pantalla en la documentación de Jira.
    -o-
  • También puede asignar el campo especificado solo en una dirección, de Jira a Smartsheet. Esto creará una asignación unidireccional. Las revisiones que implemente en los campos de Smartsheet no se trasladarán a Jira.

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.

When I try to access the Jira Connector, it's saying I'm not authorized to perform this action. What do I do?

It's possible that you don't have the permissions needed to access the Jira Connector yet. Reach out to your Smartsheet Sys Admin for assistance. 

Learn how to contact your Sys Admin.