Contents Visão geral, fluxos... 2 Componentes... 2 Instalação... 2 Ativando a APE de Integração... 3 Ativando a APE de Integração - Serviços via Console (Linha de Comando)... 5 Configuração... 6 Configuração... 6 Plug-ins de Integração... 7 Ordens... 7 Negócio Automático... 7 Operador... 8 Distribuição... 8 Negócios... 9 Distribuição... Erro! Indicador não definido. Recompra... 9 Pendência... 10 Monitor de Integração... 11 Empresa... 11 Plug-Ins... 11 Logs... 13 Visão geral, fluxos Componentes Instalação A APE de Integração é instalada pelo instalador do SINACOR segue o procedimento para instalação:
Ativando a APE de Integração Para realizar a ativação dos Serviços do APE de Integração, além dos pré-requisitos validados pelo ativador de componentes que veremos a seguir, é necessário possuir os serviços Windows dos Servidores de Configurações, Dumper e Monitoração previamente ativada e rodando (status iniciado), conforme o mapa de dependência dos componentes, não necessitando que os servidores estejam instalados na mesma máquina. As validações de pré-requisitos de instalação realizadas pelo ativador são as seguintes: Possuir usuário com perfil de administrador, necessário para a instalação do serviço Windows do Servidor Receptor; A não instalação da versão OMM STM na mesma máquina; Sistema operacional Windows; Possuir o Oracle Client 11.2 / ODP.NET 2.112.1.0 instalado; Possuir o serviço Windows NetTcpPortSharing em execução; Windows Management Services (WINMGMT) instalado, necessário para coleta de dados de serviços. Ao realizar as validações de pré-requisitos com sucesso, o ativador habilitará o componente para ativação, bastando selecioná-lo e clicar no botão Concluir para realizar a instalação do serviço:
Após clicar no botão Concluir a seguinte tela de parâmetros de configuração será exibida somente se o Servidor de Configurações não estiver instalado na mesma máquina: Na tela de parâmetros do Servidor de Configurações é preciso informar o endereço e porta onde se encontra instalado o serviço do Servidor de Configurações. Após informar e testar a conexão com o Servidor de Configurações, ao clicar no botão Salvar uma confirmação de parâmetro salvo com sucesso será exibido:
O serviço Windows da APE de Integração poderá ser visualizado pela tela de serviços do Windows, encontrando-se iniciado e pronto para ser utilizado: Ativando a APE de Integração - Serviços via Console (Linha de Comando) O componente APE de Integração também poderá ser ativado/desativado via linha de comando. Utilizando a ferramenta (executável) PSE.Deployment.Tools.InstallUtil, localizada em [Pasta de Instalação SINACOR] \PSE\V12\Tools\InstallUtil\. O usuário deverá ter permissão de administrador para rodar o Processador de Comandos Windows (cmd), para executar a tarefa de ativação ou desativação de cada serviço que compõem o componente APE de Integração. A sintaxe da instalação é: [Pasta de Instalação SINACOR ]\PSE\V12\Tools\InstallUtil\PSE.Deployment.Tools.InstallUtil /i [arquivo de serviço] [nome do serviço] [display do serviço] [descrição do serviço]. Digamos que a pasta onde o SINACOR está instalado seja [ C:\DSEPROJ\Compilados\SINACOR ], para instalar apenas o serviço BVMF Receptor SINACOR, basta executar em linha de comando a seguinte instrução: Ex.: > C:\DSEPROJ\Compilados\SINACOR\PSE\V12\Tools\InstallUtil\PSE.Deployment.Tools.InstallUtil /i C:\BMFBOVESPA\APE\Bovespa\Integration\SINACOR.Ape.Ordens.Integration.WService.exe "APE de Integração de Ordens BOVESPA - SINACOR" "APE de Integração de Ordens BOVESPA - SINACOR" "APE responsável pela integração entre os módulos atual e novo de Ordens" A sintaxe da desinstalação é:
[ Pasta de Instalação SINACOR ]\PSE\V12\Tools\InstallUtil\ PSE.Deployment.Tools.InstallUtil /u [nome do serviço]. Ex. > C:\DSEPROJ\Compilados\SINACOR\PSE\V12\Tools\InstallUtil\PSE.Deployment.Tools.InstallUtil.exe /u " "APE de Integração de Ordens BOVESPA - SINACOR" Configuração A configuração da Integração é feita através do Gerenciador de configurações do SINACOR na opção Configurações ->Bovespa ->Integração. Configuração A imagem a seguir, permite uma melhor visualização da configuração geral para o produto Integração, bem como suas particularidades na configuração.
Abaixo segue a descrição dos parâmetros: Código da empresa: Informar o código de empresa que esta disposta na tabela TGEEMPR. CD_EMPRESA. Intervalo de tempo: Aqui deve inserir o intervalo de tempo (em segundos) que o plug-in deve aguardar para ser executado novamente, caso não possua itens para integrar. Limite de linhas: A quantidade de registros que serão integrados a cada execução do plug-in. Limite de tentativas: A quantidade de tentativas de execução de comando em banco de dados em caso de falha nas integrações. Plug-ins de Integração Ordens O plug-in de Ordens trata as novas ordens abertas pelo Módulo de Ordens automaticamente, via tela (manual) e suas modificações. Após as devidas validações e complementações necessárias realizadas pelo OMMFIX o sistema sensibiliza o Módulo de Integração para que este reflita as informações no módulo atual do SINACOR. Negócio Automático Este plug-in trata todos os negócios gerados automaticamente, sejam pelo OMMFIX ou pelo RTC. Após as validações e complementações necessárias, realizadas automaticamente, o sistema sensibiliza o Módulo de Integração para que este reflita as informações no módulo atual do SINACOR.
Operador O plug-in Operador considera os cadastros e alterações realizados em cada Operador do Módulo de Ordens, a cada cadastro ou modificação o sistema sensibiliza o Módulo de Integração para que este reflita as informações no módulo atual do SINACOR, conforme a parametrização realizada. Distribuição O plug-in Distribuição contempla as distribuições em lote realizadas no Módulo de Ordens, a cada lote criado ou modificação o sistema sensibiliza o Módulo de Integração para que este reflita as informações no módulo atual do SINACOR, conforme a parametrização realizada.
Negócios Todos os negócios que não foram originados de forma automática serão tratados por este plugin: inclusões manuais, modificações, cancelamentos, desdobros, repasses e casamentos, após a finalização o sistema sensibiliza o Módulo de Integração para que este reflita as informações no módulo atual do SINACOR, conforme a parametrização realizada. Recompra As recompras realizadas pelo Módulo de Ordens serão integradas através do Plug-in Recompra, sempre que uma recompra for aberta, executada, cancelada ou ocorrer falha o sistema sensibiliza o Módulo de Integração para que este reflita as informações no módulo atual do SINACOR, conforme a parametrização realizada.
Pendência A pendência sensibiliza todas as ocorrências (erros) nos demais Plug-ins realizadas pelo Módulo de integração. Quando ocorrer a solução (RESOLVER NOTIFICAÇOES E PENDENCIAS) que esta no rodapé da tela ou no acesso principal do SINACOR for executada, sensibiliza o Módulo de Integração para que este reflita as informações no módulo atual do SINACOR, conforme a parametrização realizada.
Monitor de Integração O monitor da Integração se divide em duas áreas que exibem dados das integrações realizadas: ZOOM favoritos legendas Notificações e pendências Empresa Status Geral da Empresa: Exibe através de um indicador com três valores possíveis como está o status de forma geral das empresas. Indicador Verde Laranja Vermelho Cinza Descrição Funcionalidade está OK Existem itens pendentes de integração Algum erro crítico que precisa ser diagnosticado e corrigido imediatamente Plug-in inativo Plug-Ins
Lista de Empresa: Selecionando uma empresa o monitor exibe as informações de integração de cada plug-in referente a ela. Status: Apresenta os plug-ins conforme os status de cada um deles, seguindo a ordem: Vermelho, Laranja, Cinza, Verde. Ordenar por: Possibilita a ordenação dos plug-ins por Status ou por Nome da Empresa. Plug-in: Em cada plug-in o sistema exibe os dados abaixo: Última Data/Hora de integração: Exibe a data e horário da última integração daquele plugin. Último tempo de integração: Exibe o tempo da última integração daquele plug-in. Última quantidade de itens integrados: Exibe quantos itens foram integrados na última execução daquele plug-in. Tempo Médio de integração: Exibe o tempo médio das integrações daquele plug-in. Lista de Erros: Exibe a quantidade de erros que a integração daquele plug-in gerou. Ao lado é exibido o ícone Lupa ( ). Quantidade de execuções do Plug-in: Exibe a quantidade de execuções realizadas na última integração. Quantidade Total Integrada: Exibe os valores totais de itens integrados do plug-in. Quantidade Total Pendente: Exibe os valores totais pendentes de itens integrados do plugin. Quantidade Total Não Integrada: Exibe a quantidade total não integrados Exibe os valores totais de itens integrados do plug-in. Caso a integração possua erros é possível visualizá-los através do ícone Lupa ( ). O sistema exibe a lista detalhada de cada erro (Mensagem) e a hora em que ele ocorreu (Data do Erro). Detahes das ocorrências.
Acessando o menu contextual da lista sobre um determinado Erro, o usuário poderá Verificar o Erro para obter mais informações e detalhes sobre o que aconteceu. Logs Os logs da APE de Integração ficam disponíveis para visualização em uma pasta na rede conforme a configuração do Dumper instalado. Os logs são distribuídos por Data (AAAAMMDD), contendo em cada data o diretório do Servidor onde o serviço Dumper está configurado, dentro da pasta ERRORS são gravados os erros que ocorreram durante as integrações, na pasta SYSTEM são registradas todas as execuções, podendo gravar também os erros e informações adicionais, fluxos executados em looping, dependendo da parametrização realizada durante a configuração. Diretório onde são gravados os Logs Os arquivos são gerados contendo a seguinte nomenclatura: Logs de Erro PluginIntegracaoNomePlugin-HH-AAAAMMDD.error.trace Logs de Execução PluginIntegracaoNomePlugin-HH-AAAAMMDD.technical.trace Os arquivos podem ser visualizados através do Bloco de Notas
Exemplo de Log de execução Exemplo de Log de Erro