Jira Spoke

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 Programações jurídicas - Visão geral do IntegrationHub.

Versão do spoke

Jira spoke v4.3.2 é 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 - External Authentication Framework (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:

Se sua instância Jira for compatível com outra versão da API, especifique a versão da API em Versão da API na lista relacionada Atributos. Por padrão, a versão da API é 2. Consulte Configurar 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 de webhooks

Os webhooks bidirecionais podem ser configurados para serem notificados sobre os eventos necessários. A política de roteamento define as condições que devem ser atendidas para notificar a instância ServiceNow. Essas condições são baseadas nos eventos em Jira sobre os quais 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 as Jira tarefas.

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

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

Use o módulo Jira Registros de 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 módulo Jira Políticas de roteamento do WebHook. A política de roteamento padrão é compatível com estes campos:


Categoria	Campo
Problema	URL da instância do Jira Evento o Webhook Descrição do problema Criação Atualizado em Resolução de Problemas Resolução de problema anterior Resumo do Problema Tipo de Problema Tipo de problema anterior Prioridade do problema Prioridade do problema anterior Status de Incidentes Status do problema anterior Categoria de status do problema Categoria de status do problema anterior Projeto
Comentário	Jira URL da instância Evento o Webhook Comentário Criação Atualizado em Resumo do Problema Tipo de Problema Prioridade do problema Status de Incidentes Categoria de status do problema Projeto
Worklog	Jira URL da instância Evento o Webhook Tempo gasto no log de trabalho Criação Atualizado em
Anexo	Jira URL da instância Evento o Webhook Criação Nome do Arquivo Anexado Tamanho do Anexo Tipo de anexo MIME
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 com a versão Descrição da versão mesclada para

Para usar outras condições na política de roteamento, crie uma política de roteamento no módulo Jira Políticas de roteamento do WebHook e especifique as condições de acordo com seu requisito. Consulte Configurar um webhook bidirecional para obter informações sobre como instalar e configurar os webhooks.

Subfluxo do spoke

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


Categoria	Campo
Problema	Usuário Problema Anexos Log de mudança do problema Projeto
Comentário	Problema Projeto Comentário
Worklog	Worklog
Anexos	Anexo
Projeto	Projeto
Versão	Versão
Evento o Webhook
Carimbo de data/hora
Carga Nota: Esta é a carga inteira Jira.

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 seus requisitos. A carga é uma das entradas do subfluxo.

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

Nota:

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

Ações do spoke

Use ações em Spoke do Jira em Flow Designer para automatizar tarefas Jira quando ocorrer um evento em Now Platform. As ações disponíveis incluem:

Nota:

Algumas das ações de spoke desta versão em diante não têm a entrada Alias de conexão.
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 sufixo obsoleto e você não pode usá-las a partir desta versão.
Recursos de avaliação de erro são fornecidos em algumas das ações do spoke.


Categoria	Campo	Descrição
Audit Management	Pesquisar fluxo de logs de auditoria	Recupera a atividade de login das assinaturas do usuário AtlassianJira.
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 da Atlassian, incluindo os grupos padrão. Nota: Esta ação pode ser usada somente com Jira Assinatura em nuvem.
	Pesquisar usuários por fluxo de nome de grupo	Recupera detalhes de todos os membros de um grupo 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 problemas	Adicionar Comentário	Adiciona um comentário ao problema especificado em Jira.
	Adicionar observador	Adiciona o usuário especificado como um observador para o problema especificado.
	Atribuir problema	Atribui o problema em Jira ao usuário.
	Copiar anexo	Copia o anexo necessário associado ao o registro ServiceNow para 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 erro de software, uma tarefa de projeto, um tíquete de help desk ou muito mais. Um problema em Jira representa uma tarefa no Now Platform.
	Criar problemas	Cria até 50 problemas em massa. O tipo de problema que a ação cria depende da configuração Jira.
	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 de um projeto.
	Pesquisar problema	Recupera os detalhes de um problema.
	Pesquisar prioridades do problema	Recupera a lista de prioridades de problemas e detalhes das prioridades de problemas individuais.
	Pesquisar fluxo de problemas	Recupera uma lista de problemas que correspondem a uma cadeia de caracteres de consulta JQL.
	Pesquisar fluxo de problemas de 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 quadros (metadados)	Recupera os detalhes de todos os quadros em Jira.
	Obter campos que podem ser criados (metadados)	Recupera a lista de todos os campos em um projeto Jira necessário.
	Obter campos editáveis (metadados)	Recupera a lista de todos os campos editáveis em um problema Jira necessário.
	Obter tipos de problema (metadados)	Recupera a lista de todos os tipos de problema em um projeto Jira necessário.
	Obter projetos (metadados)	Recupera a lista de todos os projetos Jira.
Gestão de projetos	Criar Projeto	Cria um projeto em Jira.
	Pesquisar projeto	Recupera detalhes do projeto especificado por ID ou chave.
	Pesquisar projetos	Recupera detalhes de todos os projetos. Nota: Esta ação funciona somente para o servidor Jira.
	Pesquisar fluxo de projetos	Recupera detalhes de todos os projetos. Nota: Esta ação funciona somente para a nuvem Jira.
	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ória	Criar história	Cria uma história na instância do Cloud Jira. 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 na nuvem Jira 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 grupo para usuário	Recupera detalhes de todos os grupos de um usuário Atlassian.
	Pesquisar fluxos de usuários	Recupera detalhes de todas as assinaturas de usuário da Atlassian Jira. Nota: Esta ação pode ser usada somente com uma assinatura de nuvem Jira.
	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 uma assinatura de servidor Jira 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 registro	Copia o anexo de Jira para qualquer registro na instância ServiceNow. 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 problema do comentário	Recupera os detalhes do problema analisando a carga do comentário especificado. Você pode usar esta ação no subfluxo Processar Jira Webhook para o servidor local do Jira quando somente as informações relacionadas ao comentário forem especificadas sem detalhes sobre o problema Jira. Por exemplo, quando somente as 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.
Gestão de Webhook	Pesquisar webhooks	Recupera detalhes de todos os webhooks registrados da instância Jira.
	Assinar webhook	Registra um webhook na instância Jira.
	Cancelar assinatura do webhook	Exclui o webhook registrado na instância Jira.
	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.

Jira requisitos de conta

O Jira requer a geração de um token de API para Jira usando sua conta da Atlassian.

Requisitos de aliases de conexão e credencial

IntegrationHub O usa aliases para gerenciar informações de conexão e de credencial 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 o registro de alias Jira. Para usar essas ações, você deve criar um registro de conexão ce um registro de redential ce associá-los ao registro de alias Jira.

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