Utilización de la actividad Buscar objetos de JIRA

Utilice la actividad Buscar objetos para captar los registros que coinciden con la serie de búsqueda para Issue, User, UsersOverMultiProject, AssignableUser y UsersWithPermissions de JIRA. La actividad Buscar para Issue obtendrá los datos de campos personalizados.

Acerca de esta tarea

Utilice esta tarea para buscar objetos de la instancia de JIRA estableciendo los parámetros de consulta. La llamada a esta actividad es una llamada síncrona en la que se envían los datos de entrada a la actividad para ser procesados y se devuelve la respuesta a la orquestación.

Procedimiento

  1. En una orquestación activa, abra el separador Actividades y expanda el contenido de la carpeta JIRA.
  2. Arrastre el icono de la actividad Buscar objetos a la orquestación.Seleccione la actividad. Se mostrará la Lista de comprobación de Buscar objetos de JIRA.
  3. En la lista de comprobación, pulse Resumen.
  4. Revise el contenido del campo Nombre de actividad y realice los cambios necesarios.
  5. En la lista de comprobación, pulse Elegir punto final.
  6. Pulse Examinar y utilice el recuadro de diálogo Explorador de proyectos para seleccionar el punto final de JIRA correspondiente.
  7. Opcional: para crear el punto final pulse Nuevo y especifque los detalles de conexión necesarios. Pulse Aceptar para guardar y utilizar el punto final para esta configuración.
  8. Para realizar los cambios que sean necesarios en la configuración de punto final seleccionada, pulse Editar para acceder a las opciones en una ventana separada. Cualquier cambio que se realice afectará de forma global a todos los usos del punto final en las orquestaciones activas.
  9. En la lista de comprobación, pulse Configurar.
  10. Pulse Examinar para seleccionar el tipo de objeto. Se mostrará la ventana Examinar JIRA.
  11. En Examinar JIRA, puede seleccionar el tipo de objeto de la lista de tipos de objeto. Pulse Aceptar.
  12. En la lista de comprobación, pulse Reintentar. Revise los valores predeterminados y realice los cambios que sean necesarios.
  13. Seleccione las Entradas de correlación en la Lista de comprobación. Los esquemas XML generados a partir del objeto seleccionado de la actividad Recuperar objetos se muestran como nodos bajo el parámetro de entrada de la solicitud en el panel A actividad.
  14. Cree una correlación entre las variables de orquestación y el parámetro de entrada de la actividad.
    Nota: Los valores deben proporcionarse durante el tiempo de ejecución para todos los elementos obligatorios de la estructura de entrada. Se puede indicar un valor especificando un valor predeterminado para el elemento o enlazando el elemento con un nodo de entrada. Durante el tiempo de ejecución, si no se suministra ningún valor para un elemento obligatorio, la actividad lanza una excepción que es notificada por la consola de gestión web (WMC). Si no se proporciona un valor en tiempo de ejecución para un parámetro opcional de entrada, no se lanza ninguna excepción durante el tiempo de ejecución.
  15. Seleccione las Salidas de correlación en la lista de comprobación. El esquema XML generado para contener la respuesta de la actividad se muestra como nodos bajo el parámetro de salida de respuesta en el panel Desde actividad.
  16. Cree una correlación entre los parámetros de salida y las variables de orquestación. Parámetro de consulta

    A continuación se detallan los parámetros de consulta de la búsqueda de objetos:

    Tabla 1. Parámetros de consulta comunes para todos los objetos de búsqueda
    Nombre del campo Descripción
    startAt El índice del primer registro que se va a devolver (a partir de 0)
    maxResults El número máximo de usuarios que se van a devolver (toma como valor predeterminado 50). El valor máximo permitido es 1000. Si especifica un valor superior a este número, se truncarán los resultados de búsqueda.
    Tabla 2. Parámetros de consulta para los objetos Issue
    Nombre del campo Descripción
    validateQuery Este parámetro se utiliza para validar la consulta JQL
    responseFields La lista de campos que se van a devolver para cada issue. De forma predeterminada, se devolverán todos los campos navegables.
    criteria El campo, el operador, el valor y el operador lógico se definen en los criterios. Se pueden especificar varios criterios expandiendo las apariciones para el nodo de criterios.
    field Se debe especificar el nombre de campo estándar que se va a utilizar en los criterios.
    operator El operador que se va a aplicar. (Por ejemplo, los operadores válidos son =, !=, <, >, <=, >=, ~, !~, IN, NOT IN, IS e IS NOT)
    value El valor del campo utilizado en la búsqueda.
    logicalOperator El operador lógico que se va a aplicar (por ejemplo: los operadores lógicos válidos son AND, OR, NOT y ORDER BY)
    orderBy El campo y el orden se definen en orderBy. Se pueden especificar varias cláusulas orderby expandiendo las apariciones para el nodo orderBy.
    field El nombre de campo estándar que se va a utilizar para mostrar los campos en orden.
    order El orden puede ser ASC y DESC
    Tabla 3. Parámetros de consulta comunes para los objetos de usuario
    Nombre del campo Descripción
    includeActive El parámetro se utiliza para incluir los usuarios activos.
    includeInActive El parámetro se utiliza para incluir los usuarios inactivos.
    Tabla 4. Parámetros de consulta comunes para los objetos UserWithPermission
    Nombre del campo Descripción
    permissions Lista separada por comas de permisos de proyecto o problema devueltos que los usuarios deben tener
    Nota: El conector no admite la enumeración por lo que el usuario tiene que introducir los datos en parámetros de consulta.

Resultados

Habrá configurado la actividad Buscar objetos de JIRA.