Histórico da Página
...
- 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:
- 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.
- 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.
- 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.
- MAIN: É a ação principal. O sistema exibirá na Central de Notificações esta ação como ação de destaque.
- 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 | ||
---|---|---|
| ||
<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 | ||
---|---|---|
| ||
@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:
- moduleKey: Chave única de identificação do módulo
- 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".
- tenantId: Id do tenant para qual o módulo está sendo criado.