Redmine Reminders

Notifications

5.0 (0)·New instalações

Lembretes manuais, agendados e por regras para as tarefas que vão ficando pelo caminho — enviados a partir da tarefa, de uma consulta guardada ou da consola de administração, pelo servidor de correio que já usa.

$199 / um servidor

Vários servidores: $399

Reembolso em 5 dias úteis12 meses de atualizaçõesCódigo-fonte incluído

Tipos de lembrete: 3
Modos de destinatário: 4
Agendamentos: Diário · semanal · mensal
Permissões: 4, por projecto
Dados fora do servidor: Nunca

Lembrar já o responsável

Um botão na página da tarefa. Determina o responsável — na falta dele o autor, depois um administrador — e a mensagem segue viagem antes de a página recarregar.

Lembrar alguém mais tarde

Escolhe destinatário, data e uma nota, e o lembrete fica à espera. Se a tarefa for fechada antes dessa data, fica marcado como ignorado em vez de ser enviado.

Regras sobre uma consulta guardada

Ligue uma regra a qualquer consulta de tarefas: diária, semanal nos dias que escolher ou mensal nas datas que escolher, a uma hora fixa. As tarefas abertas do resultado são lembradas, no máximo uma vez por dia.

Enviar apenas a contagem

Aponte uma regra a várias consultas e envie os números em vez das tarefas — uma pulsação permanente para quem coordena e quer a ordem de grandeza, não a lista.

Ninguém é chateado duas vezes

Tarefas fechadas, módulos desactivados e contas bloqueadas são filtrados no momento da entrega, e os destinatários são desduplicados antes de sair uma única mensagem.

Quatro permissões, por projecto

Ver, gerir, enviar e ver estatísticas — atribuídas por perfil, por cima de um módulo de projecto que pode desligar por completo. Cada envio e cada salto fica no registo de actividade.

Um clique, uma data, ou uma regra

Todos os lembretes são guardados, entregues e registados da mesma maneira. O que muda é quem decide quando saem: você, já; você, para uma data futura; ou uma regra que vigia uma consulta guardada em seu lugar.

Manual — lembrar já o responsável

Um botão na página da tarefa. Determina o responsável, recorre ao autor e por fim a um administrador se ninguém estiver atribuído, e a mensagem sai antes de a página recarregar.

Agendado — lembrar alguém mais tarde

Escolhe destinatário, data e uma nota, e o lembrete fica à espera. Se a tarefa for fechada antes dessa data, é discretamente marcado como ignorado em vez de enviado: a nota dizia respeito a trabalho que já não existe.

Automático — uma regra sobre uma consulta guardada

Ligue uma regra a qualquer consulta de tarefas: diária, semanal nos dias escolhidos ou mensal nas datas escolhidas, a uma hora fixa. As tarefas abertas do resultado são lembradas, e uma regra dispara no máximo uma vez por dia.

A consulta que já mantém é a regra

Não há uma segunda linguagem de filtros. Uma regra aponta para uma das suas consultas guardadas — em atraso, sem responsável há três dias, pedidos de suporte parados — de modo que a definição de «está a ficar para trás» continua onde a sua equipa já a mantém. Altere a consulta e todas as regras assentes nela acompanham.

Vive em três sítios que já usa

O plugin acrescenta coisas à página da tarefa, ao projecto e à consola de administração — e a mais nenhum sítio. Todos os ecrãs abaixo são um Redmine 6 a correr o Redmine Reminders 1.0.0.

Na tarefa

view_issues_show_description_bottom · separador de histórico

A janela «Novo lembrete» aberta sobre uma tarefa do Redmine, com os campos Destinatário, Data do lembrete e Notas e um botão Criar. — Lembrar mais tarde Destinatário, data, nota — depois fica à espera da data.

Uma tarefa do Redmine com o separador Lembretes seleccionado, a listar um lembrete agendado com a hora de criação, tipo, autor, destinatário, estado pendente, data do lembrete e nota. — Separador Lembretes Todos os lembretes da tarefa, com estado e nota.

No projecto

Configuração › Lembretes · menu do projecto

A configuração de um projecto Redmine com a secção Módulos aberta e a caixa Redmine Reminders assinalada ao lado de Gestão de tarefas e Registo de tempo. — Primeiro passo O módulo aparece na lista de módulos do próprio projecto — ligado ou desligado, projecto a projecto.

O separador Lembretes na configuração do projecto Redmine: um formulário com assunto, enviar apenas a contagem, consulta personalizada, notas, destinatário, agendamento, hora e campo activo, por cima de uma tabela com seis regras existentes. — Configuração › Lembretes Construa uma regra a partir de uma consulta guardada e depois acompanhe a tabela de regras — agendamento, destinatários, número de execuções, último resultado.

A página «Os meus lembretes» num projecto Redmine, a listar três lembretes pendentes com a sua tarefa, data, autor e nota. — Os meus lembretes Os lembretes pendentes de cada pessoa — tarefa, data, quem pediu e porquê.

A página de estatísticas de lembretes do projecto, com as contagens manuais e automáticas ao lado de uma tabela de estrangulamentos por responsável que lista utilizadores e as suas tarefas abertas. — Estatísticas de lembretes Contagens por tipo, e tarefas abertas acumuladas por responsável.

Na consola de administração

Administração › Redmine Reminders

O separador de estatísticas da administração do Redmine Reminders: total de lembretes manuais e automáticos e uma tabela por utilizador das notificações, com colunas manual e automático. — Estatísticas de lembretes Quem foi avisado, com que frequência e por que tipo de lembrete — cada contagem desce até aos e-mails exactos.

O separador Lembretes da administração a listar uma regra de comunicação personalizada com a data de notificação, data de fim, agendamento diário, lista de destinatários e estado activo. — Comunicações Lembretes escritos por administradores, com uma janela de datas.

O formulário de lembretes de estrangulamento, com nome, descrição, conteúdo do e-mail, datas de notificação e de fim, tipo de notificação, hora, um selector «Utilizador bloqueado como» definido para Responsável ou autor, e um selector de utilizadores. — Estrangulamentos Vigiar tarefas abertas presas a contas bloqueadas.

Feito para as filas que já mantém

Os lembretes lêem as suas consultas guardadas, respeitam as suas permissões e escrevem tudo o que fazem no seu próprio registo de actividade.

O que se pode pedir a uma regra
Aspecto	Capacidade	Como se comporta
Quem	Responsável, autor, observadores ou uma lista escolhida	Cada regra escolhe os seus destinatários. Utilizadores inactivos e utilizadores sem endereço de correio são descartados antes de sair seja o que for.
Quando	Diária, semanal ou mensal às HH:MM	As regras semanais escolhem dias da semana, as mensais escolhem datas, e uma data de início e uma de fim delimitam toda a série.
Resumo	Enviar apenas a contagem	Aponte uma regra a várias consultas e envie os números em vez das tarefas — uma pulsação permanente para quem coordena.
Salvaguarda	Uma tarefa fechada nunca é chateada	Tarefas fechadas, módulos de projecto desactivados e contas bloqueadas são filtrados no momento da entrega, e não no do agendamento.
Prova	Um registo de actividade completo	Criado, enviado, ignorado, execução de regra iniciada, execução de regra terminada — cada um com o assunto e o corpo exactos que saíram.
Acesso	Quatro permissões, por projecto	Ver, gerir, enviar e ver estatísticas — atribuídas por perfil, por cima de um módulo de projecto que pode desligar por completo.

Entra um tique do cron, sai um e-mail

Quatro passos, todos dentro do seu Redmine. Do servidor não sai nada além do correio que a sua instância já envia.

Passo	O que acontece
1. O cron faz tique	Uma linha de crontab corre rake redmine_reminders:queue, que coloca um trabalho em fila. Sem nenhum worker a correr, a tarefa síncrona :run faz o mesmo trabalho ali mesmo.
2. As regras interrogam-se	Cada regra activa pergunta se lhe compete: dentro da sua janela de datas, a coincidir com o dia da semana ou a data de hoje, passada a hora agendada e ainda não executada hoje.
3. Os destinatários resolvem-se	A consulta corre, as tarefas fechadas caem e os destinatários passam a utilizadores reais, activos e contactáveis. Os repetidos fundem-se: ninguém leva o mesmo toque duas vezes.
4. Enviar e depois registar	A entrega passa pelo próprio mailer do Redmine, herdando assim a sua configuração SMTP e os cabeçalhos de correio das tarefas. Cada envio — e cada salto — é escrito no registo de actividade dos lembretes com o seu assunto e o seu corpo.

O que chega à caixa de entrada

Um assunto que traz o projecto e a tarefa — [Support — #4821] Redmine Reminder: SSO login fails on Safari — sobre um corpo que liga de volta à tarefa e cita a nota escrita por quem criou o lembrete. É o mailer da sua instância, a sua configuração SMTP e o seu endereço de remetente; o plugin não acrescenta nenhum caminho de entrega próprio.

Ninguém é chateado duas vezes

Um plugin de lembretes justifica-se por aquilo que se recusa a enviar. Entre uma regra em dia de correr e uma caixa de entrada estão quatro verificações.

Filtrado na entrega, não no agendamento

Tarefas fechadas, projectos com o módulo desligado e contas bloqueadas são reverificados no momento exacto em que a mensagem vai sair — um pedido resolvido há uma hora já está fora do lote.

Só utilizadores reais e contactáveis

Os destinatários são expandidos em contas efectivas e depois caem os utilizadores inactivos e os que não têm endereço. Um grupo de observadores em que metade já saiu da empresa chega à outra metade.

No máximo uma vez por dia, por regra

Uma regra que já correu hoje não volta a correr, faça o cron o que fizer. Dentro de uma execução os destinatários repetidos fundem-se: quem aparece em três das tarefas encontradas recebe apenas uma mensagem.

Os saltos também ficam escritos

Um lembrete agendado para uma tarefa entretanto fechada é registado como ignorado, com o seu motivo. O registo responde a «porque é que ninguém foi avisado?» tão bem como a «quem foi avisado?».

Comunicações, estrangulamentos e prova

A consola de administração acrescenta as três coisas que só fazem sentido olhando para todos os projectos ao mesmo tempo.

Comunicar a quem precisa

Escreva assunto e corpo, escolha destinatários e uma janela de datas, e é o mesmo agendador que corre as regras a entregar. Sem ferramenta de envio à parte, e com o mesmo registo de actividade a seguir.

Encontrar as contas que travam

Uma regra vigia cada tarefa aberta atribuída a uma conta bloqueada, ou criada por ela, e envia a lista a quem deve reatribuir o trabalho. As saídas deixam de ser um atraso silencioso.

Estatísticas com nomes

Contagens manuais e automáticas por pessoa, no período que escolher, com detalhe do assunto e do corpo exactos que cada utilizador recebeu. Útil quando alguém diz que nunca foi avisado.

As quatro permissões, atribuíveis por perfil
Permissão	O que permite
Ver lembretes	Ver os lembretes e as regras associados às tarefas de um projecto
Gerir lembretes	Criar, editar, suspender e apagar as regras assentes nas consultas guardadas de um projecto
Enviar lembretes	Usar o botão manual numa tarefa e agendar um para mais tarde
Ver estatísticas	Abrir as contagens por pessoa e o registo de actividade que as sustenta

Instalação em três passos

Requer acesso por shell e a possibilidade de executar tarefas rake. Faça sempre uma cópia de segurança antes de instalar uma extensão.

Descompactar para a pasta de plugins

cd /path/to/redmine
# the package arrives by email, or from your download link
unzip redmine_reminders-1.0.0.zip -d plugins/
bundle install

Migrar e reiniciar

RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=redmine_reminders
touch tmp/restart.txt   # or systemctl restart redmine

Acrescentar a linha de crontab

# every minute: enqueue due rules and scheduled reminders
* * * * * cd /path/to/redmine && RAILS_ENV=production \
  bundle exec rake redmine_reminders:queue >> log/redmine_reminders_cron.log 2>&1

# no ActiveJob worker? use the synchronous task instead
# bundle exec rake redmine_reminders:run

É preciso um worker em segundo plano?

Não. A entrada do cron corre redmine_reminders:queue, que coloca um ActiveJob em fila e devolve o controlo de imediato — a forma certa se já tem um worker a correr. Se não tiver, aponte a mesma linha para redmine_reminders:run e o trabalho é feito de forma síncrona nesse processo. Ambas as tarefas podem correr a cada minuto sem problema.

O que acontece se uma tarefa for fechada antes do lembrete agendado?

Não sai nada. O lembrete é marcado como ignorado e escrito no registo de actividade com o seu motivo, de modo que fica a memória da intenção sem que alguém seja avisado por trabalho já concluído. A mesma verificação vale para os lembretes por regra: as tarefas fechadas saem do resultado da consulta no momento da entrega.

Quem recebe realmente um lembrete?

Cada regra escolhe um dos quatro modos de destinatário: o responsável, o autor, os observadores ou uma lista de utilizadores indicada por si. Os lembretes manuais determinam primeiro o responsável, depois recorrem ao autor e por fim a um administrador. Em qualquer modo, os utilizadores inactivos e os que não têm endereço são descartados antes da entrega, e os destinatários repetidos fundem-se numa só mensagem.

Pode uma regra cobrir várias consultas e enviar apenas os números?

Pode. Uma regra no modo «apenas contagem» pode apontar a várias consultas guardadas e envia os totais em vez das tarefas — doze em atraso, três sem responsável, uma bloqueada — que é normalmente aquilo que quem coordena quer encontrar na caixa de entrada às nove da manhã.

Passa alguma coisa por um serviço externo?

Não. O correio é entregue ao próprio mailer do Redmine, pelo que usa a configuração SMTP e o endereço de remetente que a sua instância já tem. Não há serviço externo, não há chave de API para obter e não há telemetria: o plugin acrescenta tabelas e tarefas rake, não um caminho de entrega.

Como se evitam avalanches de correio?

De três maneiras. Uma regra dispara no máximo uma vez por dia, por mais vezes que o cron corra; os destinatários são desduplicados dentro de cada execução, pelo que quem aparece em trinta tarefas recebe uma mensagem; e os filtros do momento da entrega retiram tarefas fechadas, módulos desactivados e contas bloqueadas antes de endereçar seja o que for.

Quem pode criar regras?

Quem você quiser. Quatro permissões — ver, gerir, enviar e ver estatísticas — são atribuídas por perfil e só se aplicam onde o módulo Lembretes tenha sido activado para o projecto. Um projecto que nunca ligue o módulo não tem lembretes, nem entrada de menu, nem regras.

Que versões de Redmine suporta e o que acrescenta à base de dados?

Redmine 4.0 e mais recentes, pela API padrão de plugins — nenhum ficheiro do núcleo é alterado. Acrescenta três tabelas próprias através de migrações normais; desinstalar consiste em remover a pasta do plugin e reverter essas migrações.