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 Integration Hub

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

Jiraspoke v 5.1.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:

. JiraA instância é 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, o. Versão da API é 2 . Consulte Configure uma conexão para o Jira SpokePara 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

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. ServiceNowinstância. Essas condições são baseadas nos eventos em Jirasobre 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. Jiratarefas.

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

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

Use o. JiraWebhook 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 JiraMódulo de políticas de roteamento do webhook. A política de roteamento padrão oferece suporte a estes campos:


Categoria	Campo
Ocorrência	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 JiraWebhook Routing Policies e especifique as condições de acordo com seu requisito. Consulte Configure um webhook bidirecional para o spoke do Jirapara obter informações sobre como configurar os webhooks.

Subfluxo de spoke

. Jirafornece um subfluxo de amostra para lidar com vários Jiraeventos de webhook. O subfluxo de amostra disponível é Processo JiraWebhooks. O processo JiraO subfluxo webhooks oferece suporte a estes campos:


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

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 sua necessidade. 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 Jirapara 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 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 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 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 Studiopara automatizar Jiraquando ocorre um evento no Now 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 a funcionar. No entanto, essas ações anteriores são renomeadas adicionando o. obsoleto 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 Jiraassinaturas do usuário.
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 JiraSomente assinatura de nuvem.
	Pesquisar usuários por fluxo de nome de grupo	Recupera detalhes de todos os membros em 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 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 ocorrência	Atribui o problema em Jirapara o usuário.
	Copiar anexo	Copia o anexo necessário associado a. . ServiceNowregistre 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 Jirarepresenta uma tarefa no Now Platform.
	Criar ocorrências	Cria até 50 ocorrências em massa. O tipo de ocorrência que a ação cria depende de Jiraconfiguração.
	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 Jirade 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 do 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 que correspondem a uma cadeia de caracteres de consulta JQL.
	Pesquisar fluxo de ocorrências de sprint	Recupera os detalhes de todas as ocorrências 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.
	Problema de atualização	Atualiza um número definido de campos de um problema em Jiracom valores passados como entrada.
Recuperação de metadados	Obter quadros (metadados)	Recupera os detalhes de todos os quadros em Jira.
	Obter campos criáveis (metadados)	Recupera a lista de todos os campos em um Obrigatório Jiraprojeto.
	Obter campos editáveis (metadados)	Recupera a lista de todos os campos editáveis em um Obrigatório Jiraproblema.
	Obter tipos de problema (metadados)	Recupera a lista de todos os tipos de problema em um Obrigatório Jiraprojeto.
	Obter projetos (metadados)	Recupera a lista de todos Jiraprojetos.
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 Jiraservidor.
	Pesquisar fluxo de projetos	Recupera detalhes de todos os projetos. Nota: Esta ação só funciona para JiraNuvem.
	Pesquisar usuários atribuíveis a projetos	Recupera uma lista de usuários que podem ser atribuídos a ocorrências 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 JiraInstância de nuvem. Isso é comparável à história no plug-in Desenvolvimento ágil da ServiceNow.
	Pesquisar fluxo de histórias	Recupera detalhes de todas as histórias.
	Atualizar história	Atualiza um número definido de campos de uma história em JiraNuvem 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 de usuário autenticado.
	Pesquisar associações de grupo para o usuário	Recupera detalhes de todos os grupos de um usuário Atlassian.
	Pesquisar fluxo de usuários	Recupera detalhes de todos os Atlassian Jiraassinaturas do usuário. Nota: Esta ação pode ser usada com um JiraSomente assinatura de nuvem.
	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 Jirasomente assinatura do servidor.
	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 o anexo de Jirapara qualquer registro em ServiceNowinstância. Ao usar esta ação em um subfluxo, certifique-se de que a cápsula de dados do URL de conteúdo esteja especificada no campo URL do anexo.
	Campos de pesquisa	Recupera o nome interno e outros detalhes do rótulo de campo obrigatório em Jira.
	Pesquisar ocorrência do comentário	Recupera os detalhes do problema analisando a carga do comentário especificado. Você pode usar esta ação no processo JiraSubfluxo do webhook para o servidor Jira no local quando somente as informações relacionadas ao comentário são especificadas sem detalhes sobre o. Jiraproblema. Por exemplo, quando somente informações de comentário são especificadas, esta ação analisa a carga e extrai os detalhes do problema.
	Consulte o 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 Jiranã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 é Jiranão é o mesmo comentário especificado.
Gestão de webhook	Pesquisar webhooks	Recupera detalhes de todos os webhooks registrados do Jirainstância.
	Webhook	Registra um webhook no Jirainstância.
	Cancelar assinatura do webhook	Exclui o webhook registrado em Jirainstâ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.

Jira requisitos da conta

. JiraRequer a geração de um token de API para JiraUsando sua conta Atlassian.

Requisitos de aliases de conexão e credencial

Integration Hub 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 Jiraregistro 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 Jiraregistro de alias.

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