Jira Spoke
Gerencie problemas, usuários, histórias e grupos no Jira. Recupere dados do Jira para usar em um fluxo. Use webhooks bidirecionais e assine Jira com um URL de retorno de chamada ServiceNow.
Solicitar aplicativos na Store
Acesse o site ServiceNow Store para ver todos os aplicativos 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 5.3.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 com suporte
Este spoke foi criado para a API versão v2, mas pode ser compatível com versões posteriores.
Nota:
- . Jira A instância oferece suporte a outra versão de API, especifique a versão da API em Versão da API Na lista relacionada Atributos. Por padrão, o Versão da API . 2 . Consulte Configure uma conexão para o spoke do Jira Para obter informações sobre como criar um registro de Conexão.
- Jira A Central de serviços não é compatível com o spoke.
Jira Módulo webhooks
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, o 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 de webhook do Jira
- Políticas de roteamento de webhooks do Jira
Use Jira Módulo de registros do webhook 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 Políticas de roteamento do webhook. A política de roteamento padrão oferece suporte a estes campos:
| Categoria | Campo |
|---|---|
| Ocorrência |
|
| Comentário |
|
| Worklog |
|
| Anexo |
|
| Projeto |
|
| Versão |
|
Para usar outras condições na política de roteamento, crie uma política de roteamento no Jira Módulo Políticas de roteamento do webhook 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.
Subfluxo do spoke
. Jira 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:
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.
| Categoria | Campo |
|---|---|
| Ocorrência |
|
| Comentário |
|
| Worklog | Worklog |
| Anexos | Anexo |
| Projeto | Projeto |
| Versão | Versão |
| Evento do webhook | |
| Carimbo de data/hora | |
| Carga Nota: Este é o todo Jiracarga. |
|
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 Jirapara 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 painel | 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 problemas | 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. | |
| Exclusão do problema | O gatilho é iniciado quando um problema é excluído. | |
| Problema criado | O gatilho é iniciado quando um problema é criado. | |
| 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 spoke do Jira, 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 Jiraem Workflow Studio para automatizar Jiratarefas 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. 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 do Atlassian Jira assinaturas do usuário. Nota: Esta ação é compatível com Jira Server 9 e versões anteriores, e. Jira Nuvem. |
| 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 com Jira Server 9 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 Atlassian, 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 os detalhes de todos os membros em um grupo da Atlassian. | |
| 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 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 problemas | 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. Nota: Esta ação não é compatível quando a autenticação OAuth 2,0 é usada. |
| Pesquisar usuário autenticado | Recupera detalhes da conta do usuário autenticada. | |
| Pesquisar associações de grupos para usuário | Recupera os detalhes de todos os grupos de um usuário do Atlassian. | |
| Pesquisar fluxos de usuários | Recupera detalhes de todos os Atlassian 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. Nota: Esta ação não é compatível quando a autenticação OAuth 2,0 é usada. |
|
| Ações de utilitário | Copiar anexo do problema para o registro | Copia 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 Jira no local quando somente as informações relacionadas ao comentário são especificadas sem detalhes sobre 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 Spokes e comece a usar os agentes de IA disponíveis. Para obter mais informações, consulte Now Assist Para Spokes.
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 Create an agentic workflow 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 seu requisito. Consulte Duplicate an AI agent para obter mais informações sobre como criar um clone.
- Consulte Now Assist AI agents 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. |
Procurando um agente de IA?
- Pode haver agentes de IA instalados com o. Now Assistaplicações que não são usadas em fluxos de trabalho agentivos. Para saber como ver todos os agentes disponíveis em sua instância, consulte Encontre agentes de IA .
- Para encontrar agentes que podem não estar instalados em sua instância, visite Mercado de agentes de IA em ServiceNow Store.
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 Atlassian.
Requisitos de aliases de conexão e credencial
IntegrationHub usa aliases para gerenciar conexões e informações de credenciais e credenciais de OAuth. 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 um 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.