Usando a atividade Procurar objetos do JIRA
Use a atividade Procurar objetos para buscar os registros que correspondem à sequência de procura para Problema, Usuário, UsersOverMultiProject, AssignableUser e UsersWithPermissions do JIRA. A atividade Procurar de Problema obterá dados de campos customizados.
Sobre Esta Tarefa
Use essa tarefa para procurar objetos na instância do JIRA configurando parâmetros de consulta. A chamada para essa atividade é uma chamada síncrona em que os dados de entrada são enviados para a atividade para processamento e a resposta é enviada de volta para a orquestração.
Procedimento
- Em uma orquestração ativa, abra a guia Atividades e expanda o conteúdo da pasta JIRA.
- Arraste o ícone da atividade Procurar Objetos para a orquestração. Selecione a atividade. A Lista de verificação de Procurar objetos do JIRA é exibida.
- Na lista de verificação, clique em Resumo.
- Revise o conteúdo do campo Nome da Atividade e faça as mudanças necessárias.
- Na lista de verificação, clique em Selecionar terminal.
- Clique em Procurar e use a caixa de diálogo Explorador de Projetos para selecionar o terminal JIRA relevante.
- Opcional: é possível criar o terminal clicando em Novo e especificando os detalhes necessários da conexão. Clique em OK para salvar e usar o terminal para essa configuração.
- Para fazer as alterações necessárias na configuração do terminal selecionado, clique em Editar para acessar as opções em uma janela separada. Quaisquer mudanças feitas globalmente afetam todos os usos desse terminal em orquestrações ativas.
- Na lista de verificação, clique em Configurar.
- Clique em Pesquisar para selecionar o tipo de objeto. A janela Procurar JIRA é exibida.
- Em Procurar JIRA, é possível selecionar o tipo de objeto na lista de tipos de objetos. Clique em OK.
- Na Lista de Verificação, clique em Tentar Novamente. Revise
as configurações padrão e faça as alterações necessárias. Nota: Para obter informações adicionais, consulte Especificando as opções de Nova tentativa para atividades do JIRA REST API.
- Selecione Mapear Entradas na Lista de Verificação. Os Esquemas XML gerados do objeto selecionado da atividade Recuperar Objetos são exibidos como nós sob o parâmetro de entrada da solicitação no painel Para Atividade.
- Crie um mapa entre as variáveis de orquestração e o
parâmetro de entrada da atividade. Nota: Os valores devem ser fornecidos no tempo de execução para quaisquer elementos obrigatórios da estrutura de entrada. Um valor pode ser fornecido ao especificar um valor padrão para o elemento ou ao vincular o elemento a um nó de entrada. Durante o tempo de execução, se nenhum valor for fornecido para um elemento compulsório, a atividade lançará uma exceção que será relatada pelo Web Management Console. Se um valor não for fornecido no tempo de execução para um parâmetro de entrada opcional, nenhuma exceção será lançada durante o tempo de execução.
- Selecione Mapear Saídas na Lista de Verificação. O Esquema XML gerado para manter a resposta da atividade será exibido como nós sob o parâmetro de saída response no painel Da Atividade.
- Crie um mapa entre os parâmetros de saída e as
variáveis de orquestração. Parâmetro de Consulta
Abaixo estão os parâmetros de consulta de Procurar objetos:
Tabela 1. Parâmetros de consulta comuns para todos os Objetos de procura Nome do Campo Descrição startAt O índice do primeiro registro a ser retornado (baseado em 0) maxResults O número máximo de usuários a serem retornados (padronizado como 50). O valor máximo permitido é 1000. Se você especificar um valor maior que esse número, os resultados da procura serão truncados. Tabela 2. Parâmetros de consulta para Objetos de problema Nome do Campo Descrição validateQuery Esse parâmetro é usado para validar a consulta JQL responseFields A lista de campos a serem retornados para cada problema. Por padrão, todos os campos navegáveis são retornados. critérios campo, operador, valor e logicalOperator são definidos em critérios. É possível especificar múltiplos critérios expandindo ocorrências para o nó de critérios. campo O nome do campo padrão a ser usado nos critérios deve ser especificado. operador O operador a ser aplicado. (Por exemplo: os operadores válidos são =, !=, <, >, <=, >=, ~, !~, IN, NOT IN, IS e IS NOT) Valor O valor do campo usado na procura logicalOperator O operador lógico a ser aplicado (por exemplo: os operadores lógicos válidos são AND, OR, NOT e ORDER BY) orderBy field e order são definidos em orderBy. É possível especificar múltiplos orderby expandindo ocorrências para o nó orderby campo O nome do campo padrão a ser usado para exibir os campos em ordem pedido A ordem é ASC e DESC Tabela 3. Parâmetros de consulta comuns para Objetos de usuário Nome do Campo Descrição includeActive O parâmetro é usado para incluir os usuários ativos includeInActive O parâmetro é usado para incluir os usuários inativos Tabela 4. Parâmetros de consulta comuns para Objetos de UserWithPermission Nome do Campo Descrição permissions lista separada por vírgula de permissões para projeto ou problema retornado que os usuários devem ter Nota: A enumeração não é suportada pelo conector, portanto, o usuário precisa inserir os dados nos parâmetros de consulta.
Resultados
Tópico pai: Atividades do JIRA