Saltar para o conteúdo
PokutsoftPokutsoft

Recurring Issues - Documentação

Atualizado: 2026-06-30

Visão geral

O Recurring Issues cria tickets do Jira de acordo com um agendamento. Ao contrário da automação nativa, compreende um calendário de trabalho (fins de semana e feriados), executa cada agendamento no seu próprio fuso horário, aceita agendamentos escritos em inglês simples e cria tickets com fidelidade total (subtarefas, datas de vencimento, responsáveis e campos personalizados). É executado inteiramente no Atlassian Forge, pelo que os seus dados nunca saem do Atlassian.

Como começar

  1. Instale a aplicação a partir do Atlassian Marketplace no seu site Jira Cloud.
  2. Abra um projeto e aceda à página Recurring Issues a partir da barra lateral do projeto.
  3. Crie um agendamento. Dê-lhe um nome, escolha a frequência de execução, descreva o ticket a criar e clique em Pré-visualizar próximas execuções para verificar as datas antes de guardar.

Agendamento

Escolha uma frequência e uma hora. Cada agendamento mantém o seu próprio fuso horário.

FrequênciaOpções
DiáriaExecuta-se todos os dias à hora escolhida.
SemanalEscolha um ou vários dias da semana.
MensalUm dia fixo do mês, ou uma regra de dia útil (primeiro, último ou enésimo dia útil).

A hora que definir é interpretada no fuso horário do agendamento, não em UTC.

Calendário de trabalho

Quando uma execução agendada cai num fim de semana ou feriado, é você quem decide o que acontece:

  • Não fazer nada — criar mesmo assim.
  • Ignorar essa execução — nenhum ticket é criado.
  • Mover para o dia útil anterior.
  • Mover para o dia útil seguinte.

Os feriados provêm de um calendário de feriados. Um administrador cria calendários na página Recurring Issues Admin, inserindo datas ou importando um ficheiro ICS. Em seguida, associa um calendário a um agendamento.

Agendamentos em inglês simples

No formulário de agendamento, escreva algo como every last working day of the month e clique em Interpretar. A aplicação preenche os campos de frequência por si. Isto utiliza o Forge AI integrado do Atlassian, pelo que o texto permanece dentro do Atlassian. Reveja sempre os campos preenchidos antes de guardar.

O ticket criado

CampoO que faz
ResumoUtilize o token {date} para inserir a data de execução, por exemplo "Relatório semanal {date}".
Desvio da data de vencimentoDefine a data de vencimento como a data de execução mais o número de dias que introduzir.
ResponsáveisIntroduza um ou vários IDs de conta; a aplicação alterna entre eles a cada execução.
EtiquetasAplicadas a cada ticket criado.
SubtarefasUm resumo por linha; cada uma torna-se uma subtarefa real sob o ticket criado.
Criar com antecedênciaCria o ticket um determinado número de dias antes da data-alvo.

Proteção contra duplicados

Ative Não criar um novo enquanto existir uma instância aberta para evitar uma acumulação de cópias. Antes de cada execução, a aplicação verifica se uma instância anterior do mesmo agendamento ainda está aberta e, em caso afirmativo, ignora a execução.

Gerir agendamentos

  • Pré-visualize as próximas execuções antes de guardar para confirmar as datas.
  • Ative ou desative um agendamento a qualquer momento.
  • Executar agora para criar um ticket de imediato, sob demanda.
  • O Histórico regista o que cada agendamento criou e quando.
  • A página Admin gere os calendários de feriados e lista todos os agendamentos do site.
Como decorrem as execuções. A aplicação verifica os agendamentos num ciclo horário e cria os tickets que forem devidos. Como o trabalho agendado não tem um utilizador, esses tickets são criados pela aplicação. Tudo o que faz na interface (incluindo Executar agora) é realizado como você, dentro das suas próprias permissões.

Permissões e tratamento de dados

Âmbitos solicitados (princípio do menor privilégio):

  • read:jira-work — lê metadados do projeto e verifica instâncias abertas.
  • write:jira-work — cria os tickets recorrentes e as suas subtarefas.
  • storage:app — armazena agendamentos, calendários de feriados e histórico de execuções.

A aplicação é executada inteiramente no Atlassian Forge, sem chamadas externas. Os dados de feriados são definidos por um administrador ou importados de ICS, nunca obtidos de terceiros. A análise em inglês simples utiliza o Forge AI do Atlassian. Os seus dados nunca saem do Atlassian e não são usados para treinar nenhum modelo.

Privacidade, termos e suporte