Actividad de búsqueda de Jira

Introducción

Una actividad de Búsqueda de Jira, que utiliza su conexión de Jira, recupera datos de objetos de un proyecto Jira y está destinado a ser utilizado como una fuente para proporcionar datos en una operación.

Crear una actividad de búsqueda de Jira

Se crea una instancia de una actividad Search de Jira desde una conexión de Jira utilizando su tipo de actividad Buscar.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño de tela de diseño o cópielo y péguelo en él. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad de Búsqueda de Jira existente se puede editar desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto)

Configurar una actividad de búsqueda de Jira

Siga estos pasos para configurar una actividad de Búsqueda de Jira:

• Paso 1: Ingrese un nombre y seleccione un proyecto
  Asigne un nombre a la actividad y seleccione un proyecto.

• Paso 2: Seleccionar un objeto
  Selecciona un objeto.

• Paso 3: Especificar la configuración
  Especifique los criterios de búsqueda.

• Paso 4: Revisar los esquemas de datos
  Se muestran todos los esquemas de solicitud o respuesta.

Paso 1: Ingrese un nombre y seleccione un proyecto

En este paso, asigne un nombre a la actividad y seleccione un proyecto. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

Nombre: Introduzca un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Jira Search y no debe contener barras diagonales. /o dos puntos :.

• Seleccionar un proyecto: Esta sección muestra los proyectos disponibles en el extremo de Jira.

  • Proyecto Jira seleccionado: Después de seleccionar un proyecto, este aparece aquí.

  • Buscar: Introduzca el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de proyectos. La búsqueda no distingue entre mayúsculas y minúsculas. Si los proyectos ya se muestran en la tabla, los resultados se filtran en tiempo real con cada pulsación de tecla. Para recargar proyectos desde el extremo durante la búsqueda, introduzca los criterios de búsqueda y actualice, como se describe a continuación.

  • Actualizar: Recarga los proyectos desde el extremo de Jira. Esto puede ser útil si se han añadido proyectos a Jira. Esta acción actualiza todos los metadatos utilizados para crear la tabla de proyectos que se muestra en la configuración.

  • Seleccionar un proyecto: Dentro de la tabla, haga clic en cualquier parte de una fila para seleccionar un proyecto. Solo se puede seleccionar un proyecto. La información disponible para cada proyecto se obtiene del extremo de Jira:

    • Nombre: El nombre del proyecto.

    • Descripción: La descripción del proyecto.

  Consejo

  Si la tabla no se completa con los proyectos disponibles, la conexión Jira podría no funcionar correctamente. Asegúrese de estar conectado reabriendo la conexión y probando las credenciales.

• Configuración opcional: Haga clic para expandir esta configuración opcional:

  • Fallar la operación en caso de error: Seleccione para forzar que una operación devuelva un Error estado de la operación cuando la carga útil de respuesta de la API de Jira contiene un código de estado de error. Si no está seleccionado (predeterminado), se debe verificar la carga útil de la respuesta para determinar su éxito en Jira.

• Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Paso 2: Seleccione un objeto

En este paso, seleccione un objeto. A continuación se describe cada elemento de la interfaz de usuario.

• Seleccionar un objeto: Esta sección muestra los objetos disponibles en el extremo de Jira.

  • Proyecto Jira seleccionado: El proyecto Jira seleccionado en el paso anterior aparece aquí.

  • Objeto de Jira seleccionado: Después de seleccionar un objeto, este aparece aquí.

  • Buscar: Introduzca el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue entre mayúsculas y minúsculas. Si los objetos ya se muestran en la tabla, los resultados se filtran en tiempo real con cada pulsación de tecla. Para recargar objetos desde el extremo durante la búsqueda, introduzca los criterios de búsqueda y actualice, como se describe a continuación.

  • Actualizar: Recarga objetos desde el extremo de Jira. Esto puede ser útil si se han añadido objetos a Jira. Esta acción actualiza todos los metadatos utilizados para crear la tabla de objetos que se muestra en la configuración.

  • Seleccionar un objeto: Dentro de la tabla, haga clic en cualquier parte de una fila para seleccionar un objeto. Solo se puede seleccionar un objeto. La información disponible para cada objeto se obtiene del extremo de Jira:

    • Nombre: El nombre del objeto.

    • Descripción: La descripción del objeto.

  Consejo

  Si la tabla no se completa con los objetos disponibles, la conexión Jira podría no funcionar correctamente. Asegúrese de estar conectado reabriendo la conexión y probando las credenciales.

• Atrás: Haga clic para guardar temporalmente la configuración de este paso y volver al paso anterior.

• Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Paso 3: Especificar la configuración

En este paso, especifique los criterios de búsqueda. A continuación, se describe cada elemento de la interfaz de usuario.

• JQL: Ingrese los criterios de búsqueda utilizando lenguaje de consultar de Jira Sintaxis (JQL). variables globales son compatibles con la declaración JQL.

  Nota

  Puede usar el campo JQL para especificar varios proyectos (más allá del proyecto especificado en el Paso 1).

• Expandir (solo para problemas y proyectos): Ingrese una lista separada por comas de las entidades que desea incluir en la respuesta. Estas entidades no se devuelven por defecto y se pueden especificar:

  Entidad	Descripción
  renderedFields	Devuelve valores de campo representados en formato HTML.
  names	Devuelve el nombre para mostrar de cada campo.
  schema	Devuelve el esquema que describe un tipo de campo.
  transitions	Devuelve todas las transiciones posibles para el problema.
  operations	Devuelve todas las operaciones posibles para el problema.
  editmeta	Devuelve información sobre cómo se puede editar cada campo.
  changelog	Devuelve una lista de actualizaciones recientes de un problema, ordenadas por fecha, comenzando por la más reciente.

  Importante

  Cuando especifique una entidad en este campo, debe editar el esquema de respuesta (en el paso 4) para incluir cada entidad como un campo en el esquema. De lo contrario, los datos de la entidad no se incluirán en la respuesta.

  Nota

  Este campo solo funciona cuando se interactúa con proyectos o problemas de Jira (especificados en el paso 2).

• Máximo de resultados: Introduzca el número máximo de resultados que se mostrarán en una página. Si no se especifica, se mostrarán todos los registros del objeto seleccionado sin paginación.

• Inicio en: Introduzca el índice del primer elemento que se mostrará en la página.

• Atrás: Haga clic para guardar temporalmente la configuración de este paso y volver al paso anterior.

• Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Paso 4: Revisar los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

• Esquemas de datos: Estos esquemas de datos son heredados por las transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.

  Nota

  Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

  El conector Jira utiliza la Jira REST API v3 para el tipo de instancia Jira Cloud y Jira REST API v2 para el tipo de instancia Jira Local. Consulte la documentación de la API para obtener información sobre los nodos y campos del esquema.

• Actualizar: Regenera esquemas desde el extremo de Jira. Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

• Editar: Permite acceder al editor del esquema de datos. El editor permite agregar, eliminar y reorganizar nodos y campos, así como cambiar sus tipos de datos. Todos los nodos y campos recién agregados se configuran como [0, 1] cardinalidad los cambios realizados en los esquemas de datos deben ser aceptables para el extremo y deben realizarse únicamente tras consultar la documentación disponible. Tras realizar modificaciones en el esquema, se muestra la fecha de la última edición en la parte superior del esquema extremo para indicar que se han realizado modificaciones manuales. Al actualizar los esquemas, se restablecerán a sus estructuras predeterminadas.

• Atrás: Haga clic para guardar temporalmente la configuración de este paso y regresar al paso anterior.

• Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad de Búsqueda de Jira, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de la operación, lo que incluye la posibilidad de encadenar operaciones que se encuentren en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para más detalles, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades de Búsqueda de Jira se pueden utilizar como fuente con estos patrones de operación:

• Patrón de Transformación
• Patrón de archivo de dos objetivos (solo como primera fuente) - Patrón de archivo HTTP de dos destinos (solo como primera fuente) - Patrón de dos transformaciones (como primera o segunda fuente)

Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.

Cuando esté listo, desplegar y ejecutar la operación y validar el comportamiento comprobando los registros de operación.