Jira Spoke

Solicitar aplicativos na Store

Visite ServiceNow Storepara exibir todos os apps disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.

Assinatura do IntegrationHub

Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.

Versão do spoke

Jira spoke v 6.0.0 é a versão mais recente.

Dependências do spoke

Se você estiver tendo problemas para instalar o aplicativo, verifique se estes plug-ins dependentes estão instalados:

Modelo de ação do ServiceNow IntegrationHub — fluxo de dados (com.glide.hub.action_type.datastream)
Objeto complexo (com.glide.cobject)
Etapa de ação do ServiceNow IntegrationHub — Obter informações de conexão (com.glide.hub.action_step.get_connection_info)
Tempo de execução do ServiceNow IntegrationHub (com.glide.hub.integration.runtime)
Etapa de ação do ServiceNow IntegrationHub — REST (com.glide.hub.action_step.rest)
ServiceNow Flow Designer - Entradas dinâmicas (com.glide.hub.dynamic_inputs)
Integrações - Estrutura de autenticação externa (com.glide.external.app)

Nota:

Alguns desses plug-ins são recursos licenciáveis e exigem uma licença apropriada, se usados fora da implementação do spoke. Para obter informações sobre licenças, entre em contato com o gerente da sua conta.

Versões compatíveis

Este spoke foi criado para a API versão v2, mas pode ser compatível com versões posteriores.

Nota:

. Jira A instância é compatível com outra versão da API, especifique a versão da API em Versão da API No respectivo registro de conexão na lista relacionada Atributos. Por padrão, o. Versão da API é 2 .
O Jira Service Desk não é compatível com o spoke do Jira. Ofertas da ServiceNow Jira Service Management spoke Para integrar com o Jira Service Management, essa é a nova versão do Jira Service Desk.

Jira Módulo webhooks

Os webhooks bidirecionais podem ser configurados para serem notificados sobre os eventos necessários. A política de roteamento define condições que devem ser atendidas para notificar o. ServiceNow instância. Essas condições são baseadas nos eventos em Jira sobre o qual você deseja ser notificado. Quando as condições são atendidas, a política de roteamento aciona o subfluxo associado, que, por sua vez, automatiza o. Jira tarefas.

Os webhooks bidirecionais exigem configuração separada e podem ser usados independentemente sem usar as ações do spoke. Por padrão, o. Jira A aplicação webhooks está disponível no Jira e tem os seguintes módulos:

Registros do Webhook do Jira
Políticas de roteamento do webhook do Jira

Use o. Jira Webhook Registries para atribuir um token e fornecer o caminho da API. Você deve gerar um URL de retorno de chamada aqui e fornecer o URL em Jira. Uma política de roteamento padrão é fornecida no Jira Módulo de políticas de roteamento do webhook. A política de roteamento padrão oferece suporte a estes campos:


Categoria	Campo
Problema	URL da instância do Jira Evento o Webhook Descrição da ocorrência Criação em Atualização em Resolução de ocorrências Resolução de ocorrências anteriores Resumo da ocorrência Tipo de ocorrência Tipo de problema anterior Prioridade da ocorrência Prioridade do problema anterior Status da ocorrência Status do problema anterior Categoria de status do problema Categoria de status do problema anterior Projeto
Comentar	Jira URL da instância Evento o Webhook Comentar Criação em Atualização em Resumo da ocorrência Tipo de ocorrência Prioridade da ocorrência Status da ocorrência Categoria de status do problema Projeto
Worklog	Jira URL da instância Evento o Webhook Tempo gasto no worklog Criação em Atualização em
Anexo	Jira URL da instância Evento o Webhook Criação em Nome do Arquivo Anexado Tamanho do Anexo Tipo de MIME do anexo
Projeto	Jira URL da instância Evento o Webhook Projeto
Versão	Jira URL da instância Evento o Webhook Versão Descrição da versão Mesclado à versão Mesclado à descrição da versão

Para usar outras condições na política de roteamento, crie uma política de roteamento na Jira Webhook Routing Policies e especifique as condições de acordo com seu requisito. Consulte Configure um webhook bidirecional para o spoke do Jira para obter informações sobre como configurar os webhooks.

Dica:

Para configurar e usar webhooks, você deve configurar registros de webhook, tabelas de decisão e criar subfluxos. Para uma alternativa low-code com menos configurações, você pode usar Gatilhos do spoke.

Subfluxo de spoke

. Jira o spoke fornece um subfluxo de amostra para lidar com vários Jira eventos de webhook. O subfluxo de amostra disponível é Processo Jira Webhooks. O processo Jira O subfluxo webhooks oferece suporte a estes campos:


Categoria	Campo
Problema	Usuário Problema Anexos Log de mudanças de ocorrências Projeto
Comentar	Problema Projeto Comentar
Worklog	Worklog
Anexos	Anexo
Projeto	Projeto
Versão	Versão
Evento o Webhook
Carimbo de data/hora
Carga Nota: Este é o todo Jira carga.

Para personalizar o subfluxo padrão, você deve criar uma cópia do subfluxo de amostra, analisar a carga e personalizar o subfluxo de acordo com seu requisito. A carga é uma das entradas para o subfluxo.

Ao personalizar subfluxos, você deve garantir que os subfluxos estejam configurados para evitar loops infinitos.

Nota:

Você deve configurar webhooks para usar o subfluxo do spoke. Consulte Configure um webhook bidirecional para o spoke do Jira para obter informações sobre como configurar e configurar o webhook.
O subfluxo de amostra é executado como um usuário por padrão. Th e subfluxo pode ser configurado para ser executado como sistema.

Gatilhos do spoke

Use gatilhos no Spoke do Jira para assinar os eventos necessários. O endpoint permite que os webhooks se conectem à sua instância da ServiceNow. Você pode configurar os fluxos para serem executados somente quando as condições do gatilho especificadas forem atendidas. Os eventos compatíveis são:


Categoria	Gatilho	Descrição
Gestão do conselho	Quadro excluído	O gatilho é iniciado quando um quadro é excluído.
	Quadro atualizado	O gatilho é iniciado quando um quadro é atualizado.
	Quadro criado	O gatilho é iniciado quando um quadro é criado.
Gestão de comentários	Comentário excluído	O gatilho é iniciado quando um comentário é excluído.
	Comentário atualizado	O gatilho é iniciado quando um comentário é atualizado.
	Comentário criado	O gatilho é iniciado quando um comentário é criado.
Gestão de ocorrências	Problema atualizado	O gatilho é iniciado quando um problema é atualizado. Os eventos como Problema atribuído, Problema resolvido, Problema encerrado, Problema reaberto, Problema movido, e outros eventos relacionados à atualização de um problema estão neste evento de webhook.
	Problema atribuído	O gatilho é iniciado quando um problema é atribuído.
	Problema excluído	O gatilho é iniciado quando um problema é excluído.
	Problema criado	O gatilho é iniciado quando uma ocorrência é criada.
Gestão de sprint	Sprint atualizado	O gatilho é iniciado quando um sprint é atualizado.
	Sprint excluído	O gatilho é iniciado quando um sprint é excluído.
	Sprint criado	O gatilho é iniciado quando um sprint é criado.
	Sprint encerrado	O gatilho é iniciado quando um sprint é encerrado.
	Sprint iniciado	O gatilho é iniciado quando um sprint é iniciado.

Para obter informações sobre como configurar os gatilhos para o Jira Spoke, consulte Configure gatilhos para o spoke do Jira. Para obter mais informações sobre integração de entrada, consulte Integração de entrada condicional e orientada por eventos.

Ações do spoke

Use ações no Spoke do Jira em Workflow Studio para automatizar Jira quando ocorre um evento no ServiceNow AI Platform. As ações disponíveis incluem:

Nota:

Algumas das ações do spoke desta versão em diante não têm Alias de conexão entrada.
Os fluxos existentes em sua instância que usam ações das versões anteriores continuam funcionando. No entanto, essas ações anteriores são renomeadas adicionando o. descontinuado e você não pode usá-los a partir desta versão em diante.
As capacidades de avaliação de erros são fornecidas em algumas das ações do spoke.


Categoria	Ação	Descrição
Gestão de auditorias	Pesquisar fluxo de logs de auditoria	Recupera a atividade de login para Jira assinaturas do usuário. Nota: Esta ação é compatível com Jira Server 9 e versões anteriores, e. Jira Nuvem.
Gestão de auditorias	Pesquisar fluxo de logs de auditoria (Server 10 ou posterior)	Recupera registros de log de auditoria do Jira instância em um intervalo de datas especificado. Nota: Esta ação é compatível em Jira Server 10 e versões posteriores.
Gestão de grupo	Adicionar usuário ao grupo	Adiciona determinado usuário a um grupo em Jira.
	Criar Grupo	Cria um grupo em Jira.
	Pesquisar fluxos de grupos	Recupera todos os grupos na conta do Jira, incluindo os grupos padrão. Nota: Esta ação pode ser usada com Jira Assinatura de nuvem somente.
	Pesquisar usuários por fluxo de nome de grupo	Recupera detalhes de todos os membros em um grupo do Jira.
	Remover grupo	Remove o grupo fornecido de Jira.
	Remover usuário de grupo	Remove o usuário fornecido de um grupo em Jira.
Gestão de ocorrências	Adicionar Comentário	Adiciona um comentário ao problema especificado em Jira.
	Adicionar observador	Adiciona o usuário especificado como observador do problema especificado.
	Atribuir ticket	Atribui o problema em Jira para o usuário.
	Copiar anexo	Copia o anexo necessário associado a. . ServiceNow registre o problema necessário em Jira.
	Criar Problema	Cria um problema em Jira. Dependendo de como sua organização está usando Jira, um problema pode representar um bug de software, uma tarefa de projeto, um tíquete de help desk ou mais. Um problema em Jira representa uma tarefa no ServiceNow AI Platform.
	Excluir anexo	Exclui o anexo necessário em Jira.
	Excluir Problema	Exclui um problema em Jira.
	Excluir observador	Exclui o usuário como observador do problema especificado.
	Fazer a transição	Faz a transição de um problema em Jira de um estado para outro.
	Pesquisar status de tipo de problema por projeto	Recupera detalhes dos status em um projeto.
	Pesquisar problema	Recupera os detalhes de um problema.
	Pesquisar prioridades de problema	Recupera a lista de prioridades de problema e detalhes de prioridades de problema individuais.
	Pesquisar fluxo de ocorrências	Recupera uma lista de problemas correspondentes a uma cadeia de caracteres de consulta JQL.
	Pesquisar fluxo de tickets do sprint	Recupera os detalhes de todos os problemas do sprint fornecido.
	Pesquisar transições	Recupera informações sobre todas as transições de um determinado ID de problema.
	Pesquisar observadores	Recupera a lista de observadores do problema especificado.
	Atualizar problema	Atualiza um número definido de campos de um problema em Jira com valores passados como entrada.
Recuperação de Metadados	Obter campos que podem ser criados (metadados)	Recupera a lista de todos os campos em um obrigatório Jira projeto.
	Obter campos editáveis (metadados)	Recupera a lista de todos os campos editáveis em um obrigatório Jira problema.
	Obter tipos de problema (metadados)	Recupera a lista de todos os tipos de problema em um Obrigatório Jira projeto.
Gestão de projetos	Criar Projeto	Cria um projeto em Jira.
	Pesquisar projeto	Recupera detalhes do projeto especificado por seu ID ou chave.
	Pesquisar projetos	Recupera detalhes de todos os projetos. Nota: Esta ação só funciona para Jira servidor.
	Pesquisar fluxo de projetos	Recupera detalhes de todos os projetos. Nota: Esta ação só funciona para Jira Nuvem.
	Pesquisar usuários atribuíveis a projetos	Recupera uma lista de usuários que podem ser atribuídos a problemas em um ou mais projetos.
Gestão de sprint	Criar sprint	Cria um sprint em Jira.
	Excluir sprint	Exclui um sprint em Jira.
	Pesquisar sprint	Recupera os detalhes do sprint necessário como um objeto complexo.
	Pesquisar sprints por quadro	Recupera os detalhes de todos os sprints no quadro necessário.
	Atualizar sprint	Atualiza os detalhes de um sprint em Jira.
Gestão de histórias	Criar história	Cria uma história no Jira Instância de nuvem. Isso é comparável à história no plug-in ServiceNow Agile Development.
	Pesquisar fluxo das histórias	Recupera detalhes de todas as histórias.
	Atualizar história	Atualiza um número definido de campos de uma história em Jira Nuvem com os valores de entrada fornecidos.
Gestão de usuários	Criar usuário	Cria um usuário em Jira.
	Pesquisar usuário autenticado	Recupera detalhes da conta do usuário autenticada.
	Pesquisar associações de grupos para usuário	Recupera detalhes de todos os grupos de um usuário do Jira.
	Pesquisar fluxos de usuários	Recupera detalhes de todos Jira assinaturas do usuário. Nota: Esta ação pode ser usada com um Jira Assinatura de nuvem somente.
	Pesquisar fluxo de usuários por nome	Recupera uma lista de usuários que correspondem à cadeia de caracteres de pesquisa. Nota: Esta ação pode ser usada com um Jira assinatura do servidor somente.
	Remover usuário	Remove um usuário de Jira.
	Relatar dados pessoais	Relata dados pessoais de determinadas contas ao app Jira.
Ações de utilitário	Copiar anexo do problema para o registro	Copia o anexo de Jira para qualquer registro em ServiceNow instância. Ao usar esta ação em um subfluxo, certifique-se de que a cápsula de dados da URL do conteúdo esteja especificada no campo URL do anexo.
	Pesquisar campos	Recupera o nome interno e outros detalhes do rótulo do campo obrigatório em Jira.
	Pesquisar ticket a partir do comentário	Recupera os detalhes do problema analisando a carga do comentário especificado. Você pode usar esta ação no processo Jira Subfluxo do webhook para o servidor local do Jira quando somente as informações relacionadas ao comentário são especificadas sem detalhes sobre o. Jira problema. Por exemplo, quando somente informações de comentário são especificadas, esta ação analisa a carga e extrai os detalhes do problema.
	Pesquisar anexo mais recente no problema	Recupera o anexo mais recente do problema especificado de Jira. Você pode usar esta ação em um fluxo ou subfluxo para validação. Por exemplo, um subfluxo adiciona um anexo adicional somente quando o anexo mais recente de um problema em Jira não é o mesmo anexo especificado.
	Pesquisar comentário mais recente sobre o problema	Recupera o comentário mais recente do problema especificado do Jira. Você pode usar esta ação em um fluxo ou subfluxo para validação. Por exemplo, um subfluxo adiciona um comentário adicional somente quando o comentário mais recente de um problema em Jira não é o mesmo comentário especificado.
	Pesquisar servidor	Recupera informações gerais sobre a instância atual do Jira.
Gestão de Webhook	Pesquisar webhooks	Recupera detalhes de todos os webhooks registrados do Jira instância.
	Assinar webhook	Registra um webhook no Jira instância.
	Cancelar assinatura do webhook	Exclui o webhook registrado em Jira instância.
	Atualizar webhook	Atualiza o webhook com o ID fornecido em Jira. Nota: Esta ação não é compatível quando a autenticação OAuth 2,0 é usada.

Agentes de IA disponíveis

Instalar Now Assist para IntegrationHub E comece a usar os agentes de IA disponíveis. Para obter mais informações, consulte Now Assist para IntegrationHub.

Este spoke fornece agentes de IA autônomos que imitam inteligência semelhante à humana para executar tarefas em seu ServiceNow instância.

Em ServiceNow Sistema agentic, você pode criar um fluxo de trabalho agentic que compreende um conjunto de instruções de modelo de linguagem grande (LLM) junto com um ou mais agentes de IA autônomos para executar um objetivo. Consulte Para obter informações sobre como adicionar agentes de IA para criar fluxos de trabalho do agente de acordo com sua necessidade e fornecer o gatilho necessário.
Você também pode pesquisar outros agentes de IA disponíveis e adicioná-los ao fluxo de trabalho do agente. Para obter mais informações, consulte Find AI agents.
Você pode criar um clone do agente de IA do spoke necessário e personalizá-lo de acordo com sua necessidade. Consulte para obter mais informações sobre como criar um clone.
Consulte Para obter informações sobre agentes de IA.

Os agentes de IA disponíveis incluem:


Agente de IA	Descrição
Agente de IA para gestão de histórias do Jira	Recupera informações sobre histórias em um fluxo, cria novas histórias e atualiza as histórias existentes.
Agente de IA para gestão de utilitário do Jira	Fornece ações de utilitário que podem copiar o anexo do problema para o registro, recuperar o anexo e os comentários mais recentes em um problema do Jira e recuperar detalhes do campo usando rótulos. Garante a recuperação precisa de dados.
Agente de IA para gestão de usuários do Jira	Cria e remove o usuário necessário. Recupera informações sobre usuários, associações de grupo e contas de usuário autenticadas.
Agente de IA para gestão de auditorias do Jira	Gerencia logs de auditoria e fornece informações acionáveis automatizando tarefas repetitivas.
Agente de IA para gestão de sprints do Jira	Exclui sprints, atualiza detalhes do sprint e recupera informações específicas do sprint.
Agente de IA para gestão de projetos do Jira	Recupera detalhes do projeto, cria novos projetos, recupera fluxos de projeto e identifica usuários atribuíveis a projetos.
Agente de IA para gestão de grupos do Jira	Gerencia grupos executando ações como criar e excluir grupos, adicionar e remover usuários, recuperar detalhes sobre grupos, recuperar dados e atualizações e recuperar membros do grupo.
Agente de IA para gestão de tickets do Jira	Gerencia problemas executando ações como excluir problemas, gerenciar transições, lidar com observadores e trabalhar com anexos. Gerencia transições, comentários, anexos e observadores.

Pode haver agentes de IA instalados com o. Now Assist aplicações que não são usadas em fluxos de trabalho agentivos. Para saber como ver todos os agentes disponíveis para você, consulte Encontre agentes de IA .

Nota:

Certifique-se de que o usuário que executa um agente de IA tenha as funções e permissões necessárias para acessar dados ou executar operações em dados na tabela associada ao agente de IA.

Jira requisitos de conta

. Jira Requer a geração de um token de API para Jira Usando sua conta do Jira.

Requisitos de aliases de conexão e credencial

IntegrationHub usa aliases para gerenciar informações de conexão e credenciais. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão.

Este spoke usa Jira registro de alias. Para usar essas ações, você deve criar um c registro de conexão e a. c registro de redencial e associe-os ao Jira registro de alias.

Essas ações usam chamadas REST, que podem ser executadas em uma instância. Use o registro de conexão associado ao Jira alias para configurar o endpoint em relação ao qual as ações executar.