A partir da versão 1.2, além das notificações padrão do Fluig, é possível criar novos tipos de notificações customizadas, através da API de Notificações do produto. É possível criar aplicativos, widgets, etc que criem e enviem notificações customizadas, além de fazer este processo através de aplicações externas, utilizando a API Pública do Fluig. Este tutorial tem o objetivo de mostrar passo-a-passo como criar um aplicativo que cria uma notificação customizada e envia para os usuários do tenant. Para fazer este mesmo processo através da API Pública do Fluig, consulte a documentação clicando aqui.

Projeto de exemplo

Para facilitar o entendimento e desenvolvimento deste tutorial, foi gerado um projeto de exemplo. Neste projeto, foi implementado um aplicativo que cria uma notificação customizada, simulando um aviso do RH Online: "Seu holerit já está disponível". Este projeto é apenas um exemplo, não foi implementada nenhuma integração real com o sistema RH Online. Para testar o projeto, realizar os seguintes passos:

1. Baixar o projeto: Clique aqui
2. Compilar o projeto (é um projeto padrão maven, para compilar, executar "mvn clean install" na raíz do projeto)
3. Fazer deploy do arquivo "/alert-creator-sample-server/target/alert-creator-sample-server.ear" em um servidor com o Fluig instalado (não fazer este teste em produção!)

Entendendo os conceitos para criação de notificações customizadas

Módulos de Notificações:

Os módulos de notificação são apenas agrupadores, para que as notificações semelhantes se apresentem agrupadas para o usuário. Os módulos padrão do Fluig são: Colaboração (notificações de apoiar, comentar, etc), Documentos (notificações de indicação de leitura, atualização de versão, etc), Processos (notificações de movimentação de processo, tarefas atrasadas, etc) e Portal (notificações de alteração no layout de páginas, etc).

É possível criar novos módulos de notificações. No projeto exemplo, é criado um novo módulo chamado "Notificações de RH".

Eventos de Notificações:

Antes de criar notificações customizadas, é importante que fique claro o conceito de "Eventos de Notificações". Um evento é uma representação de alguma ação que pode gerar notificações no Fluig. O evento contém todas as configurações das notificações. Por exemplo, o evento de notificação "LIKE" possui o formato padrão de todas as notificações do tipo "Fulano curtiu o post 'Olha que post bacana...". Através do evento o usuário pode configurar o recebimento de notificações. Por exemplo: eu posso configurar o recebimento das notificações do tipo "SHARE" por e-mail e SMS, as notificações do tipo "LIKE" apenas pela Central de Notificações do Fluig, e não receber nenhuma notificação do tipo "FOLLOW_REQUEST_ACCEPTED". Para configurar este recebimento, o usuário deve acessar a tela de configurações de notificações:

Para criar notificações customizadas, é necessário criar novos eventos de notificações. No projeto exemplo, é criado um novo evento chamado "Holerit disponível no RH online".

Atributos de Eventos de Notificações:

Como dito anteriormente, um evento contém as configurações das notificações. Estas configurações são:

• Requerido: Indica se o usuário pode deixar de receber as notificações relacionadas ao evento. Se o evento for requerido, o usuário deverá obrigatoriamente receber as notificações referentes a ele. Um exemplo de notificação obrigatória é a solicitação de participação em uma comunidade. Obrigatóriamente o moderador da comunidade deve receber todos os pedidos de participação.
• Agrupado: Indica se as notificações daquele evento são agrupadas por objeto. Caso a notificação seja agrupada, o sistema irá exibir assim: "Fulano, Beltrano, Ciclano e mais 5 pessoas apoiaram o post 'Post do Fulano de Tal...'". Caso a notificação não seja agrupada, o sistema gerará uma notificação nova para cada vez que uma ação for gerada sobre um objeto. OBS: Notificações agrupadas não podem ter ações associadas.
• Pode ser removido: Indica se a notificação pode ser removida pelo usuário. Caso não possa, o sistema não deixará o usuário remover a notificação, até que seja executada alguma das ações disponibilizadas.
• Remove após executar uma ação: Se configurada desta forma, após realizar alguma ação, o sistema excluirá automaticamente a notificação. Caso contrário, o sistema exibirá a notificação com uma mensagem informando a ação já executada. Por exemplo: "Fulano que seguir você. (Você já aceitou esta requisição)". O sistema então permitirá que o usuário remova aquela notificação.
• Apenas para administradores: Indica se aquele tipo de notificação é exclusivo para administradores do tenant.

Notificações:

As notificações devem ser criadas obrigatóriamente com um evento associado. Desta forma a Central de Notificações poderá fazer o gerenciamento de criação, envio e exibição da notificação. As notificações criadas contém alguns objetos associados, que são:

• Usuários que enviaram a notificação: Uma notificação pode ter nenhum, um ou vários usuário que a enviaram. Na criação da notificação pode ser informado nenhum ou um usuário que está enviando. Caso a notificação seja agrupada, a Central de Notificações fará o agrupamento automaticamente.
• Objeto associado: Uma notificação pode ter ou não um objeto associado. O objeto pode ser um post, um documento, ou qualquer objeto existente dentro ou fora do sistema. Na criação da notificação pode ser informado ou não um objeto associado.
• Lugar onde foi gerada: Uma notificação pode conter ou não a informação de onde ela foi gerada. Um lugar pode ser uma comunidade, um processo, ou qualquer lugar existente dentro ou fora do sistema. Na criação da notificação pode ser informado ou não um lugar associado.
• Ações: São as ações disponibilizadas por uma notificação. Confira a seguir uma documentação detalhada.
• Metadados: São dados do tipo chave-valor que podem ser associados à notificação. Eles podem ser utilizados por aplicativos customizados de envio de notificações.

Ações de Notificações:

Uma notificação pode disponibilizar uma ou mais ações. Estas ações são informadas no momento da criação da notificação. As ações são individuais por notificação, não sendo associadas ao evento relacionado a ela. As ações possuem os seguintes atributos:

• Tipo de integração: Indica o tipo de integração que será utilizado para executar aquela ação. Atualmente o Fluig suporta três tipos de integração:
  
  1. JMS: Ao executar aquela ação o sistema irá disparar uma mensagem JMS com os dados da ação. A mensagem JMS disparada é do tipo "EXECUTE_ALERT_ACTION_EVENT". Cabe ao desenvolvedor implementar uma rotina que se conecte ao tópico "TOTVSTechIntegrationListenerTopic", ouça estas mensagens e execute efetivamente as ações.
  2. HTTP: Ao executar aquela ação, o sistema fará uma chamada HTTP a uma URL cadastrada no momento da criação da notificação. Os métodos HTTP suportados atualmente são GET e POST. Cabe ao desenvolvedor disponibilizar um serviço que responda naquela URL e execute efetivamente a ação.
  3. NONE: Ao executar aquela ação o sistema a marcará como executada, mas não realizará nenhuma ação.
• Tipo: Existe atualmente dois tipos de ação.
  
  1. MAIN: É a ação principal. O sistema exibirá na Central de Notificações esta ação como ação de destaque.
  2. DEFAULT: É uma ação padrão. O sistema exibirá como ação comum, sem destaque.