Documento de Integração BOVESPA

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
Plug-Ins
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




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