Objetivo

A integração com Identity usando modo "pull" é uma alternativa ao modo original como o Identity realiza a sincronização dos dados com o ERP (modo "push"). Antes desta funcionalidade, era necessário que o Datasul estivesse acessível pela World Wide Web (também conhecida como Internet), o que requer ajustes na infraestrutura de rede do cliente. Além desta complexidade adicional, essas alterações implicam numa exposição maior a riscos de segurança de acesso, que precisam ser muito bem gerenciados.

...

Permitir a exportação de configurações de EAI de um ambiente, e a respectiva importação em outro, possibilitando a realização de cópias de segurança (backups) de configurações realizadas, bem como a replicação de configurações em outros ambientes Logix, com o intuito de agilizar o "setup" de um novo ambiente.

 Realizando a integração com modo "pull", procura eliminar a necessidade de exposição do ERP na Internet, mitigando as eventuais fraquezas encontradas na integração com modo "push".

Funcionamento

Esta seção, além de descrever o funcionamento da integração utilizando o modo "pull", apresenta os pré-requisitos e os procedimentos de configuração necessários para utilização da mesma.

Visão geral

...

Exportação

A integração entre Identity e Datasul usando modo "pull" baseia-se no seguinte fluxo:

...

As duas filas do Identity - de aplicativo e de usuário - serão consultadas com frequências distintas - 15 e 30 segundos - respectivamente, mas também serão consultadas a cada acesso feito ao Datasul a partir do Identity (consulta sob demanda). Eventuais erros de processamento das operações, quer por consulta periódica, quer por consulta sob demanda, interromperão a busca das operações, sendo necessária a intervenção do administrador para restabelecer o funcionamento normal da integração.

...

Importação

O correto funcionamento do modo "pull" bem como o adequado monitoramento das situações de erro requerem alterações nos arquivos de configuração do Datasul, conforme segue:

Configuração do arquivo de log fluig-integration.log

Esta configuração é necessária para registro das ações do serviço de busca periódica das operações, bem como dos eventuais erros de processamento das mesmas e deve ser feita no arquivo  jboss-log4j.xml, situado em <dir_inst_datasul>\jboss-4.3.2.GA\server\<instancia>\conf. No quadro abaixo mostra-se as principais alterações a realizar:

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" debug="false">
 
    (...)
 
    <!-- A size based file rolling appender -->
   <appender name="FLUIG" class="org.jboss.logging.appender.RollingFileAppender">
     <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
     <param name="File" value="${jboss.server.log.dir}/fluig-integration.log"/>
     <param name="Append" value="false"/>
     <param name="MaxFileSize" value="100MB"/>
     <param name="MaxBackupIndex" value="5"/>
 
     <layout class="org.apache.log4j.PatternLayout">       
       <param name="ConversionPattern" value="%d %-5r %-5p (%t:%x) [%c{1}] %m%n"/>
     </layout>        
   </appender>
 
    (...)
    
   <logger name="com.totvs.fluig">
     <level value="INFO" />
     <appender-ref ref="FLUIG"/>
   </logger>   
 
    (...)
 
</log4j:configuration>

Configuração do envio de e-mail a partir do JBoss

Esta configuração é necessária para o envio do e-mail de notificação que será disparado em caso de erro durante a inicialização do serviço de busca, consulta das filas ou processamento das operações. Na parte que trata do monitoramento será dado mais detalhes. Para o momento, demonstraremos apenas as configurações que habilitam o envio.

O arquivo de configuração a alterar é o mail-service.xml, localizado em <dir_inst_datasul>\jboss-4.2.3.GA\server\<instancia>\deploy. 

Os parâmetros que devem editados neste arquivo são:

...

...

Configuração

O fluxo para ativação do modo "pull" inicia-se pelo Identity, alterando-se as configurações do aplicativo e ligando-se o parâmetro "Modo Pull", na aba Provisionar.

Image Removed

A partir deste momento, as ações efetuadas no Identity passam a gerar operações pendentes nas filas. É necessário efetuar a próxima etapa do fluxo - configuração do Datasul - que consiste em realizar o chamado "One click Configuration" através da ferramenta Fluig Configurator.

Para acessar o Fluig Configurator, acesse o menu principal do Datasul e selecione as opções descritas abaixo, conforme o tipo de menu:

Menu Flex	Menu HTML
Clique no botão Ferramentas, na parte inferior da tela.	Clique no botão Configurações, na parte superior da tela.
Selecione a opção Configurações do Fluig.	Selecione a opção Fluig Identity e clique em Abrir.
Image Removed	Image Removed

Uma vez dentro do Fluig Configurator, informe no campo Base da URL do Fluig Identity a URL correspondente ao Identity onde está configurado o aplicativo desejado e no campo Token o valor correspondente ao token de configuração, disponível na página de configuração do aplicativo, aba Visão Geral, opção Token de Configuração. Clique no botão Configurar para efetuar a sincronização das configurações.

Image Removed

Após concluído o processo, o serviço de busca de operações será iniciado no Datasul. Se necessário, é possível alterar a frequência com que as filas são consultadas no Identity. Para isso, basta ir na aba Configurações, descer a tela até o botão Editar e, após clicar no mesmo, editar os campos Busca de operações de aplicativo (ms) e Busca de operações de usuário (ms). Os valores destes campos devem ser informados em milissegundos, aceitando a faixa entre 1.000 (1 segundo) e 31.536.000.000 (1 ano).

Image Removed

É possível também desabilitar a busca de operações (tanto periódica quando sob demanda) desmarcando o campo Modo Pull habilitado, na mesma página. Realizada as operações necessárias, clique no botão Salvar para efetivá-las.

Monitoramento

Para acompanhar o status do serviço de busca das operações o Fluig Configurator disponibiliza a aba Gerenciamento, a qual exibe o status do serviço (Executando, Parado ou Desabilitado), permitindo pará-lo e iniciá-lo a qualquer tempo. A aba também disponibiliza um link para baixar o arquivo de log da integração (fluig-integration.log).

...

Erros relacionados ao funcionamento do modo "pull" também serão exibidos nesta aba, quando ocorrerem.

Além do registro dos erros em arquivo de log e da exibição dos mesmos na aba Gerenciamento, será disparado um e-mail para o usuário informado nas configurações do aplicativo no Identity, na aba Provisionar, campo Nome do Usuário Administrador do Domínio. Lembrando que este usuário deve existir no cadastro de usuários do Datasul e possuir e-mail informado no campo correspondente.

Image Removed  Image Removed

O e-mail enviado ao usuário terá um formato semelhante ao template abaixo.

Image Removed

...

...

Componentes

...

Esta seção relaciona os principais componentes da funcionalidade, suas características e o relacionamento entre eles, com o objetivo de fornecer uma visão geral da arquitetura.

...