Árvore de páginas

Versões comparadas

Chave

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

...

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

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

Existem duas formas de utilização da API de Notificações do Fluig: através do módulo "foundation-alert-api", interno ao Fluig e através da API Pública. Este tutorial mostra 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 que utilize a API de Notificações, é necessário criar um projeto Java (padrão maven) e adicionar o seguinte trecho de código no arquivo "pom.xml":

Bloco de código
languagehtml/xml
<dependency>
    <groupId>com.fluig</groupId>
    <artifactId>foundation-alert-api</artifactId> 
    <version>1.2.0-SNAPSHOT</version>
    <scope>compile</scope>
</dependency>
Módulos de Notificações:

Para criação de um novo módulo de notificações, é necessário realizar uma chamada ao método "registerModule", da interface "com.totvs.technology.foundation.alert.service.AlertModuleService". Um exemplo de chamada deste método segue abaixo:

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

	@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 module = 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.