Índice

Considerações gerais
Com a liberação da versão 12 do fluig | ESB houve mudanças estruturais que introduz um novo con-ceito nas metodologias para implantação e configuração nos servidores. O objetivo desse manual é demonstrar como instalar e configurar um ambiente funcional utilizando o TDS (TOTVS | Developer Studio) em conjunto com o fluig | ESB.
A primeira etapa para a montagem desse ambiente é a instalação do plugin fluig | ESB. O TDS é uma ferramenta que possibilita realizar tarefas diferenciadas de administração e desenvolvimento com auxílio de plugins específicos para cada finalidade. O plugin fluig | ESB é responsável pela configu-ração e diagramação do servidor fluig | ESB.
Pré-requisitos
Um dos pré-requisitos é realizar o download e instalar o TDS. As instruções para realizar o download e instalação do TDS se encontram no link http://ds.totvs.com/. Não é necessário a instalação de todos os opcionais (plugins), apenas a instalação do plugin fluig | ESB que será descrito os procedimentos em pormenores logo a seguir.
Outro pré-requisito é realizar o download e instalar o motor fluig | ESB. O download do motor fluig | ESB é realizado através do portal do suporte (http://suporte.totvs.com). Após o login e acessar a página de Download, deve-se selecionar as opções abaixo e clicar no botão Pesquisar:

Selecionar a mídia correspondente ao sistema operacional em que se deseja instalar e imediatamente será redirecionado para baixar o arquivo desejado. Deve-se descompactar o arquivo e seguir as instruções contidos na pasta docs/Configuracao de Ambiente/pt/Guia de Instalacao do fluig ESB.pdf para a instalação do produto.
Instalação TDS + Plugin ESB
Com o TDS aberto, deve-se selecionar o item de menu Help → Install New Software... Na tela aberta, clica-se no botão Add... e preencha os campos conforme abaixo. Dessa forma, permitirá que o TDS atu-alize o plugin do ESB juntamente com as ou-tras atualizações. Clica-se em OK para efeti-var a operação. 
|
A tela sofrerá uma atualização e na listagem central aparecerá o plugin do fluig | ESB com o resultado semelhante à imagem a seguir. Na listagem superior, o plugin fluig | ESB deve ser selecionado bem como o item Contact all update sites during install to find required software. Caso esse último não seja selecionado, o TDS não irá buscar outros pacotes necessários para o devido funcionamento do plugin ESB. Ao clicar o botão Next é possível que haja uma lentidão para veri-ficar e buscar os pacotes dependentes, de-pendendo da conexão à Internet. 
|
Após o término desse processo, aparecerá uma tela solicitando a confirmação da instalação do plugin fluig | ESB, mencionando uma pequena descrição e a versão a ser instalada no TDS. 
|
Após clicar em Next será exibido um termo de licença que deverá ser aprovado para prosseguir com a instalação. Para iniciar os procedimentos de instalação deve-se clicar em Finish. 
|
Imediatamente, o TDS realizará o download dos pacotes necessários para o funcionamento do plugin fluig | ESB. Nessa etapa, é possível que haja uma lentidão no processo dependendo da conexão à Internet. Durante o download um aviso é exibido com os dizeres abaixo. O aviso pode ser ignorado por clicar no botão OK. 

|
Finalizando a instalação do plugin, é solicitado para reiniciar o TDS. Esse procedimento é recomendado para o bom funcionamento do produto. Com isso, o plugin fluig | ESB se encontra devidamente instalado no TDS e pronto para configurar e realizar a diagramação do processador (motor) fluig | ESB. 
|
Para que o plugin fluig | ESB se comunique com o motor fluig | ESB, é necessário que o último es-teja executando. Para a primeira configuração deve-se acessar o diretório de instalação do motor fluig | ESB e acessar a pasta bin. Executar os arquivos nessa ordem: startup-db.bat e startup-esb.bat. Uma alternativa seria acessar o menu principal do sistema operacional e acessar os ícones Database Startup e ESB Startup. Espere até que a mensagem Esb started! 
|
Voltando ao TDS, selecione o menu Window → Open Perspective → Other... Abrirá uma caixa de diálogo, semelhante ao exibido abaixo, com todas as perspectivas possíveis para o TDS. Seleciona-se a opção TOTVS Servers e clica-se em OK. 
|
A área de trabalho do TDS sofrerá modificações se adequando à perspectiva selecionada. No painel esquerdo denominado de Servers Extensions, será visualizado uma lista com um item raiz com a descrição Servers. Deverá clicar com o botão direito do mouse em cima do item raiz e selecionar o item de menu fluig ESB → ESB Server. 
|
Em seguida será aberto uma tela solicitando informações para conexão ao motor fluig | ESB. As informações para se comunicar inicialmente com o motor fluig | ESB são: - Server Name: Identificador do servidor para identifica-ção por parte do usuário.
- Host: Nome ou número IP do motor fluig | ESB. Nesse caso utilizaremos localhost.
- Port: Porta de comunicação com o motor fluig | ESB. O padrão é 8085.

|
Finalizando o cadastro, um novo item será mostrado no painel Servers Extension. Deve-se executar um duplo clique em cima do item que foi cadastrado para que o TDS se comunique com o motor fluig | ESB para capturando as informações necessárias. No painel central, abrirá uma tela com todas as configurações do motor fluig | ESB que incluem banco de dados, servidor de licença, servidor HTTP, etc. Após as configurações serem realizadas, deve-se clicar no botão “Save (Ctrl+S)”, situado no painel superior, para enviar os dados para o motor fluig | ESB. 
|
Nesse momento é importante realizar as configurações na aba License Configuration, especialmente em integrações que não envolvem produtos TOTVS (componentes TOTVS) e que fazem uso de outros componentes como FileSender, MockReceiver, etc. Caso as integrações façam uso de componentes TOTVS, essa configuração não é necessária. A tela abaixo mostra as configurações do motor fluig | ESB. 
|
Com a comunicação como motor fluig | ESB pronto, é possível construir e publicar diagramas. Ainda no TDS, selecione o menu Window → Open Perspective → O-ther... deverá selecionar a perspectiva fluig | ESB e clicar em OK. A área de trabalho irá ser atualizada e no painel esquerdo para o ESB Navigator que conterá os projetos com os diagramas do ESB. Clicando com o botão direito no centro do ESB Navigator selecione o item de menu New → ESB Project. Ao exibir a tela, preencha com todas as informações e após clicar no botão Finish para criar um projeto. 
|
No painel ESB Navigator aparecerá o projeto criado com uma estrutura de pastas padrão. Dentro desse projeto serão criados os diagramas para o fluig | ESB. Para criar um diagrama, clique com o botão direito em cima do projeto e selecione o item New → ESB Diagram. Abrirá a tela abaixo solicitando o nome do arquivo e, após digitar, clica-se no botão Finish para concluir a criação do arquivo de diagrama. 
|
Na parte central da área de trabalho do TDS, será aberto um editor próprio para construir diagramas com os componentes ESB situados no painel esquerdo do editor. Assim, o mesmo é utilizado para definir os receptores, transformadores e enviadores de mensagens. As propriedades de cada componente colocado no diagrama serão exibidas no painel Properties situado na parte inferior do TDS. 
|
Após a constituição do diagrama, deve-se publicar o mesmo no motor fluig | ESB. Para isso, deve-se clicar no meio do diagrama com o botão direito e acessar o menu Deploy to ESB Server... conforme figura ao lado. 
|
Com isso aparecerá uma tela permitindo usuário selecionar o servidor fluig | ESB cadastrado anteriormente. Ainda permite que o usuário opte por somente adicionar o diagrama atual aos diagramas existentes no motor fluig | ESB ou se deseja substituir todos os diagramas existentes no motor fluig | ESB pelo selecionado. Ao clicar no botão Finish, o processo de deploy será iniciado. Com esses procedimentos, o diagrama relacionado se encontra disponível no motor fluig | ESB, porém, não estará habilita-do. O diagrama somente estará funcional após o reinício do motor fluig | ESB. 
|
|