Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

A partir da versão 1.2, além das notificações padrão do Fluigfluig, é possível criar novos tipos de notificações personalizadas , através da API de Notificações do produto.

É possível criar aplicativos, widgets, etc. que criem e enviem notificações personalizadas, além de fazer este processo através de aplicações externas, utilizando a API Pública do Fluigfluig.

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 da empresa (tenant). Para fazer este mesmo processo através da API Pública do Fluigfluig, consulte a documentação clicando aqui. As notificações enviadas pelo aplicativo são exibidas tanto na web, como nos dispositivos móveis. 

...

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 holerite já está disponível". Este

Informações

Lembrando que este projeto é apenas um exemplo, não

...

tendo sido implementada nenhuma integração real com o sistema RH Online.

Para testar o projeto, realizar os seguintes passos: 

Deck of Cards
effectDuration0.5
historyfalse
idsamples
effectTypefade
Card
defaulttrue
id1
labelPasso 1

 

 

Para conhecer e obter o Maven acesse o site oficial: http://maven.apache.org/.
  • .
  • Serão gerados os componentes alert-creator-sample-server.ear e holeritweb.rar.

 

Card
id2
labelPasso 2

 

  • Compilar Após obter o projeto, é necessário fazer a compilação.
  • O projeto utiliza o (é um projeto padrão Maven, portanto para compilar , executar execute "mvn clean install" na raiz do projeto).

 

Informações
Card
id3
labelPasso 3

 

  • Fazer deploy do arquivo "/alert-creator-sample-server/target/alert-creator-sample-server.ear" em um servidor com o Fluig instalado.
  • Para fazer o deploy dos componentes gerados, pare o serviço do fluig e copie ambos os arquivos na pasta [Instalação do fluig]/appserver/apps. Em seguida, inicie novamente o fluig.
  • A partir de agora, o sistema deverá
Feitos estes passos, o sistema deve
  • gerar um novo tipo de alerta. É possível verificar que o evento foi criado corretamente através da tela de
configuraçoes Deve aparecer
  • Será apresentado um novo agrupamento, chamado
"
  • Notificações
de
  • do RH
"
  • , com um novo tipo de notificação, conforme imagem a seguir:
Image Removed

Image Added

 

Nota

Em um ambiente com muitos usuários, pode haver lentidão entre o deploy do aplicativo e a criação do evento na tela de configurações.

 

 

Card
id4
labelPasso 4


  • Após a instalação do aplicativocomponente, o sistema enviará de 2 em 2 minutos uma notificação fake informando o usuário que o holerit está disponível no RH Online, conforme a imagem a seguir:

 

 

Image Removed

 

Image Added


Nota

É recomendada a leitura de todo este material, mesmo

se

que o desenvolvedor

utilizar como base

utilize o projeto de exemplo como base. Este tutorial apresenta conceitos importantes para trabalhar corretamente com notificações dentro do

Fluig

fluig.

 

 

 

 

 

 

 

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

...

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 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".

...

Antes de criar notificações personalizadas, é 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 Fluigfluig. 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 Fluigfluig, 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:

Image RemovedImage Added

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

...

  • 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. OBSObservação: Notificações agrupadas não podem ter ações associadas.

...

  • Apenas para administradores: Indica se aquele tipo de notificação é exclusivo para administradores do da empresa (tenant).

...

 

Notificações

As notificações devem ser criadas obrigatóriamente obrigatoriamente 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:

...

  • 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:

  • Tipode integração: Indica o tipo de integração que será utilizado para executar aquela ação. Atualmente o Fluig fluig suporta três tipos de integraçãointegrações:
    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: Existem atualmente dois tipos de ação.ações:
    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.

...

 

Utilizando a API de Notificações para criar eventos customizados

Existem duas formas de utilização da API de Notificações do Fluigfluig: através do módulo interno do fluig "foundation-alert-api" , interno ao Fluig, e através da API Pública. Este tutorial mostra contém um exemplo utilizando -se o módulo "foundation-alert-api". Para mais informações sobre a API Pública, clique aqui.

Para criação de um aplicativo interno ao Fluig fluig que utilize a API de Notificações, é necessário criar um projeto Java (padrão mavenMaven) e adicionar o seguinte trecho de código no arquivo "pom.xml":

...

Bloco de código
languagejava
@Singleton(mappedName = "MyModuleRegister", name = "MyModuleRegister")
public class ModuleRegister {

	@EJB(lookup = AlertModuleService.JNDI_REMOTE_NAME)
	private AlertModuleService alertModuleService;


	public void registerModule() {
		
		/*
		 * Cria um novo módulo de notificações. Os módulos padrão do Fluig são:
		 * 1. DOCUMENT
		 * 2. PROCESSES
		 * 3. PORTAL
		 * 4. COLABORATION
		 * 
		 * Caso o novo evento de notificações se encaixe em um destes módulos, 
		 * não é necessário criar um novo.
		 */
		final AlertModuleVO myModule = alertModuleService.registerModule(
				"RH_MODULE", "Notificações do RH", myTenantId);
				
	}
}

...

Os parâmetros para execução do método são:

  1. moduleKey: Chave única de identificação do módulo
  2. description: É a descrição do módulo. Pode ser um texto plano ou uma chave para tradução. Para que a tradução funcione, a chave deve estar previamente cadastrada no serviço I18n, no bundle "foundation_alert".
  3. tenantId: Id do tenant para qual o módulo está sendo criado.

 

 

Cadastrando eventos de Notificações

...

Bloco de código
languagejava
@Singleton(mappedName = "MyEventRegister", name = "MyEventRegister")
public class EventRegister {
	
	@EJB(lookup = AlertEventService.JNDI_REMOTE_NAME)
	private AlertEventService alertEventService;
	

	public void registerEvent() {
				
		alertEventService.createEvent(
				"MY_EVENT",
				Boolean.FALSE,
				"Meu evento customizado",
				"criou",
				"criaram",
				"/myapp/myimg.jpg",
				myModule.getId(),
				Boolean.TRUE,
				Boolean.TRUE,
				Boolean.FALSE,
				Boolean.FALSE,
				tenantId);
		
	}
}

 

Os parâmetros para execução do método são:

  1. eventKey - String única que representa o evento no Fluigfluig.
  2. required - Indica se o evento é requerido. Caso seja, o usuário não conseguirá configurar para não receber notificações do evento.
  3. descriptionKey - Descrição do evento. Pode ser um texto plano ou uma chave para obter descrição traduzida no I18n. Caso queira utilizar a tradução, a chave deve estar previamente cadastrada no I18n, no bundle "foundation_alert".
  4. singleDescriptionKey - Descrição da ação feita por um usuário. Pode ser um texto plano ou uma chave para obter descrição traduzida no I18n. Caso queira utilizar a tradução, a chave deve estar previamente cadastrada no I18n, no bundle "foundation_alert".
  5. groupDescriptionKey - Descrição da ação feita por por vários usuários. Pode ser um texto plano ou uma chave para obter a descrição traduzida no I18n. Caso queira utilizar a tradução, a chave deve estar previamente cadastrada no I18n, no bundle "foundation_alert".
  6. eventIcon - Ícone que representa o evento (opcional). Este ícone será exibido pelo sistema em notificações que não tenham um usuário que a enviou. Caso tenha um usuário "enviador", o sistema exibirá a foto deste usuário. Caso haja mais de um usuário "enviador", o sistema mostrará a foto do último usuário que enviou a notificação.
  7. moduleId - Módulo ao qual pertence este evento
  8. grouped - Indica se a notificação pode ser agrupada por ação e objeto.
  9. canRemove - Indica se a notificação pode ser removida.
  10. removeAfterExecAction - Indica se a notificação é removida após ser executada uma ação.
  11. onlyAdmin - Indica se o evento é válido somente para usuários administradores.
  12. tenantId - Tenant para o Empresa (tenant) para a qual o evento está sendo cadastrado.

...

Enviando Notificações

Para enviar uma notificação é necessário realizar uma chamada ao método "sendAlert", da interface "com.totvs.technology.foundation.alert.service.AlertService". Um exemplo de chamada deste método segue abaixo:

Bloco de código
languagejava
@Stateless(name = "AlertCreator", mappedName = "AlertCreator")
public class AlertCreator {
	
	@EJB(lookup = AlertService.JNDI_REMOTE_NAME)
	private AlertService alertService;
	
	public void sendHoleritAlert() {
		
		alertService.sendAlert("MY_EVENT", loginUserThatSendsTheNotification, loginUserThatIsGoingToReceiveTheNotification, objectAttached, placeWhereTheEventOccurs, actions, metadata);
				
	}
}

Os parâmetros para execução do método são:

  1. eventKey - Chave do evento cadastrado para envio de notificações.
  2. loginSender - login do usuário que envia a notificação. (opcional)
  3. loginReceiver - login do usuário que irá receber a notificação.
  4. object - objeto associado à notificação (opcional) - implementação padrão para a interface "AlertObject" é a classe "com.totvs.technology.foundation.alert.GenericAlertObject", da API de Notificações do
Fluig
  1. fluig.
  2. place - lugar onde a notificação foi gerada (opcional) - objeto e lugar são tratados com a mesma estrutura de dados - implementação padrão para a interface "AlertObject" é a classe "com.totvs.technology.foundation.alert.GenericAlertObject", da API de Notificações do
Fluig
  1. fluig.
  2. actions - ações disponibilizadas pela notificação (opcional) -  implementação padrão para a interface "AlertAction" é a classe "com.totvs.technology.foundation.alert.GenericAlertAction", da API de Notificações do
Fluig
  1. fluig.
  2. metadata - metadados da notificação (opcional).

 

Desabilitando eventos de Notificações:

É possível desabilitar qualquer evento de notificações. Atualmente este serviço está disponível na API Pública do Fluigfluig. Uma vez desabilitado, o sistema não gerará mais nenhuma notificação para aquele tipo de evento, e também não o exibirá mais na tela de configurações. 

Nota

...

titleAtenção

...

Obrigatoriamente o valor informado deve ser um formulário. Outros tipos de documentos não serão tratados e ocorrerá erro na execução do evento.

...

 

...