iGRPIGRP 3.0Documentation

Notificações de tarefas

Aviso in-app automático a quem tem de tratar a tarefa seguinte, e a configuração que precisa na app de execução.

Quando alguém conclui uma tarefa na app de execução (Concluir Tarefa), o runtime de processos (@igrp/platform-process-management-client-ui, incluído no bundle Process Management UI) avisa quem tem de tratar a etapa seguinte. Não é preciso escrever código: basta configurar o acesso ao Notification Service.

QuandoLogo a seguir a concluir uma tarefa, para cada User Task que fica ativa a seguir
A quemAo responsável da tarefa, se já estiver atribuída; senão, aos grupos candidatos da tarefa (cada grupo enviado como roleCode)
CanalIN_APP — aparece no sino de notificações das apps iGRP
ConteúdoTítulo = nome da tarefa; assunto <tarefa> · <número>; texto Tem uma nova tarefa no processo <número> (<processo>): <tarefa>.
IdentidadeEnviado em nome da aplicação Process Management (IGRP_PROCESS_MANAGEMENT), categoria igrp-task-next, com businessKey = número do processo
DuplicadosidempotencyKey por instância de tarefa — repetir o envio não duplica a notificação

O envio é best-effort: se o Notification Service estiver em baixo ou mal configurado, a tarefa é concluída na mesma e o motivo fica no log do servidor da app ([igrp-task-next] …).

Configuração na app de execução

# Notification Service (rota do gateway)
NOTIFICATION_SERVICE_BASE_URL=http://<slug>:2575/gateway-api/igrp-notification-service
# Cliente M2M do Process Management no Access Management (não o da tua app)
IGRP_M2M_PROCESS_CLIENT_ID=igrp-process-management-api
IGRP_M2M_PROCESS_CLIENT_SECRET=<segredo>
# Emissor dos tokens (um dos dois)
IGRP_ACCESS_MANAGEMENT_API=http://<slug>:2575/gateway-api/<slug>-access-management
# Opcionais
IGRP_PROCESS_APP_CODE=IGRP_PROCESS_MANAGEMENT   # default
IGRP_NOTIFY_NEXT_TASK=false                     # desliga as notificações de tarefa

Sem NOTIFICATION_SERVICE_BASE_URL ou sem o par IGRP_M2M_PROCESS_CLIENT_*, o envio é ignorado (skip: missing Notification Service access env).

Os grupos candidatos decidem quem é avisado

Uma tarefa sem responsável e sem grupos candidatos não gera notificação. Configura os grupos em Configuração de Processos (ao nível do processo ou da tarefa) com os códigos de papel do Access Management.

Para outras notificações do teu processo (por exemplo, um email ao requerente quando o pedido é aceite), chama o Notification Service a partir do código do passo ou de um serviço — ver Notificações › Envio — SDKs e API.

How is this guide?

Última atualização: