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
- En una orquestación activa, abra el separador Actividades y expanda el contenido de la carpeta JIRA.
- 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.
- En la lista de comprobación, pulse Resumen.
- Revise el contenido del campo Nombre de actividad y realice los cambios necesarios.
- En la lista de comprobación, pulse Elegir punto final.
- Pulse Examinar y utilice el recuadro de diálogo Explorador de proyectos para seleccionar el punto final de JIRA correspondiente.
- 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.
- 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.
- En la lista de comprobación, pulse Configurar.
- Pulse Examinar para seleccionar el tipo de objeto. Se mostrará la ventana Examinar JIRA.
- En Examinar JIRA, puede seleccionar el tipo de objeto de la lista de tipos de objeto. Pulse Aceptar.
- En la lista de comprobación, pulse Reintentar. Revise los valores predeterminados y realice los cambios que sean necesarios. Nota: Para obtener más información, consulte Especificación de las opciones de reintento para las actividades de la API REST de JIRA.
- 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.
- 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.
- 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.
- 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
Tema principal: Actividades de JIRA