Páginas filhas
  • Manual de Integração PIMS MultiCultivos x Protheus (V.12.1.10)

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Integração Backoffice Protheus x PIMS MultiCultivos 

 12.1.

...

10 (

...

Março/2016)

Âncora
_Toc379529482
_Toc379529482
Âncora
_Toc379532242
_Toc379532242
Âncora
_Toc379549388
_Toc379549388
Âncora
_Toc380063575
_Toc380063575
Âncora
_Toc380486751
_Toc380486751
Âncora
_Toc380496056
_Toc380496056
Âncora
_Toc437268228
_Toc437268228

...

1. Contexto de negócio (Introdução)


2. Sistemas Envolvidos


3. Integração


4. PIMSConnector
4.1. EAI PIMSConnector
4.2. PIMSConnector Console
4.3. Mensagem Única
4.4. InternalID


5. Escopo


6. Pré-requisitos instalação/implantação/utilização
6.1. PIMS Multicultivos
6.2. Protheus
6.3. PIMSConnector


7. Instalação/Atualização
7.1. PIMSConnector
7.2. Protheus


8. Controle de Versão


9. Suporte


10. Transações/Entidades/Mensagens únicas


11. Fluxo das Informações
11.1. Cadastros
11.2. Processos


12. Fluxo das Informações


13. Anexos

Âncora
_Toc363117574
_Toc363117574
Âncora
_Toc437268229
_Toc437268229
Contexto de negócio (Introdução)

...

no dia atual e considerando as mensagens enviadas. 

 

Image RemovedImage Added

 

Filtros que podem ser aplicados:

  • Aplicação:
    • É possível escolher se as informações exibidas nos gráficos serão as informações enviadas pelo Protheus, PIMS ou por ambos.

  • Período:
    • Nesse campo é possível escolher 4 períodos padrão (Hoje, Semana, 2 Semanas e Mês), ou se desejar é possível escolher um período personalizado escolhendo a opção outro e preenchendo os campos Data Inicial e Data Final.

  • Data Inicial:
    • Campo exibido quando no campo período é selecionada a opção outro. Esse campo contém a data inicial para o filtro dos dados que serão exibidos nos gráficos.

  • Data Final
    • Campo exibido quando no campo período é selecionada a opção outro. Esse campo contém a data final para o filtro dos dados que serão exibidos nos gráficos.

...

 

Na parte superior do Monitor contém os totalizadores, eles informam a quantidade de integrações separadas por seus status que correspondam as opções aplicadas no filtro (Erros, Em Processamento, Finalizados). 







 

 

 


Listagem de Integrações

Em todos os gráficos e totalizadores é possível saber exatamente quais as integrações compõem aquela quantidade, bem como visualizar o seu XML, para isso é necessário apenas clicar na fatia do gráfico desejado ou no ícone do totalizador. Em alguns casos (Totalizadores, gráfico Mensagens x Status, gráfico Mensagens x Filial e Ranking: Mensagens x Aplicação) ao clicar na fatia ou no ícone uma lista contendo os nomes técnicos das integrações e suas quantidades será exibida.
Image Removed
Image Added

 

Clicando no ícone da lupa (ao lado esquerdo do nome técnico) é aberta uma lista das transações contidas ali. Essa lista de transações também é aberta diretamente ao clicar no gráfico Transações x Mensagens com Erros, Transações x Mensagens Finalizadas e Transações x Mensagens em Processamento.




Ainda é possível visualizar informações detalhadas da transação, basta clicar no ícone da lupa (ao lado esquerdo do status). Serão exibidas informações detalhadas sobre aquela transação.


Image RemovedImage Added


MENU MONITOR DE INTEGRAÇÃO

...


Nesta tela, as informações são organizadas em uma tabela de quatro colunas. Na coluna Grupo, é informado o grupo de cada parâmetro, na coluna Nome é informada o nome de cada parâmetro,

na coluna descrição é informada a descrição de cada propriedade, na coluna Valor é informado o valor de cada parâmetro são informados os valores que o usuário pode indicar, e na coluna Valor, é

 é possível cadastrar as configurações desejadas.


Image AddedImage Removed

Ao abrir a tela não é exibido nenhum parâmetro, para que eles sejam visualizados é necessário aplicar uma consulta, para isso utilize o menu Procurar. Caso deseje procurar por nome preencha o valor desejado no campo nome, caso deseje procurar pela descrição preencha o valor desejado no campo descrição. Os resultados exibidos serão aqueles que contenham em seu nome ou descrição o valor inserido no campo no momento da busca. Caso seja necessário exibir todos os parâmetros do PIMSConnector, é necessário deixar o campo Nome e o campo Descrição em branco e clicar no botão consultar.

...

Nome

Descrição

Valor Sugerido

default_locale

Informação de idioma (localização) para as mensagens

Português

pimsconnector.versao.pimsConnectorProperties

Controle de Versão do PimsConnector

12.1.910

pimscs.instanciapadrao

Configuração da Instancia Padrão do PIMSCS

 

mensagemunica.protheus.integration.type

Tipo de integração (DB) banco de dados (WS) webservices

Endereço Web Service

mensagemunica.protheus.ws.url

Endereço de comunicação com webservices do ERP

 

mensagemunica.protheus.store.response

Insere a mensagem de resposta na base de dados

Sim

mensagemunica.protheus.response.resend.enabled

Habilita o reenvio de mensagem com falha de comunicação

Não

mensagemunica.protheus.response.resend.expression

Configurar uma expressão CRON (Agendamento) para reenvio de mensagem - Padrão 5 minutos

0 */5 * * * ?

mensagemunica.pims.products

Produtos que serão integrados com o ERP

PIMS Multicultivos

mensagemunica.pims.request.separacompra

Gera XML da solicitação de material separado por tipo (Requisição/Compra)

Sim

pimsconnector.ambiente.pimsConnectorProperties

Nome do Ambiente

Produção / Homologação

mensagemunica.pims.erpIntegrado

ERP utilizado

Protheus

mensagemunica.pims.nomeCliente

Nome do Cliente

 

mensagemunica.protheus.ws.url.custoonline

Endereço de comunicação com webservices de Custo Itens Online

Endereço Web Service - Protheus

mensagemunica.pimsmc.ws.url.materiaprimaEndereço de comunicação com webservices do PIMSMC para o módulo de matéria primaEndereço Web Service - PIMS
mensagemunica.protheus.ws.url.atualizaindiceeconomicoEndereço de comunicação com webservices do Protheus para atualização de indice econômicoEndereço Web Service - Protheus

...

  • Nome do Serviço do PIMSConnector. Valores válidos = PIMSConnector

  • Porta de acesso ao banco de Dados do PIMSConnector via conexão por padrão é utilizado 9092, porém pode ser utilizada outras portas.

  • Permite acesso remoto via conexão. Valores válidos = true/false

  • Porta de acesso via Web ao Banco de Dados do PIMSConnector por padrão é utilizado 8082, porém pode ser utilizada outras portas.

  • Permite acesso remoto via Web. Valores válidos = PIMSConnector

  • Hostname ou IP de acesso ao PIMSConnector.

  • Porta de acesso JNDI por padrão é 1099, porém pode ser utilizada outras portas

  • Porta de acesso ao PIMSConnector por padrão é 8080, porém pode ser utilizada outras portas

  • Tipo de esquema de comunicação é forma de comunicação entre os módulos dentro do PIMSConnector.

...

  • Nome do Remetente: Nome do remetente de e-mail

  • E-mail Remetente: Endereço de e-mail que será utilizado como remetente;

  • Usuário: Usuário de acesso ao servidor de e-mail do remetente;

  • Senha: Senha do de acesso ao servidor de e-mail do remetente;

  • Servidor SMTP: Endereço SMTP do servidor de e-mail;

  • Porta SMTP: Número da porta de conexão com o servidor de e-mail;

  • Assunto: Assunto do e-mail;

  • Mensagem padrão: Texto que será exibido no corpo do e-mail;

  • Utiliza Protocolo SSL: Marcar caso o servidor de e-mail necessite de protocolo SSL;

  • Utiliza Protocolo TLS: Marcar caso o servidor de e-mail necessite de protocolo TLS;

  • Extrato Versão: Com essa opção marcada o PIMSConnector enviará uma vez por mês de forma automática um e-mail para a TOTVS Agro, informando a versão do PIMSConnector.

...

  • Movimentos dos Ruralistas: será enviado ao destinatário um e-mail com os erros ocorridos durante as integrações de Movimentos dos Ruralistas, de acordo com o período agendado;



 


E-Mail --> Agendamento


Objetivo: Disponibilizar as configurações de agendamento, para enviar e-mails automaticamente no período selecionado.

...

  • Nome do Driver: Nome do Driver responsável por executar o processo de exclusão das Transações;

  • Aplicação: Aplicação na qual está registrado o Driver;

  • Tipo do Driver: Campo que descreve se o Driver é referente ao PIMS ou ao ERP;

  • Nome da Integração: Nome da integração pertinente ao Driver registrado;

  • Nome do Wrapper: Nome do Wrapper responsável por executar o processo de exclusão das Transações;

  • Tipo de Comunicação: Indica de que maneira as informações recebidas durante a integração serão armazenadas;

  • Versão da Mensagem: Informa ao usuário, em qual versão de desenvolvimento estão as mensagens de integração;

  • Service URL: Indica a URL de comunicação do Web Service do PIMSConnector.

...

Ao selecionar a Excluir de Transações Manual, o sistema exibe ao usuário a grid de transações, que inicialmente estará vazia. Para consultar os registros existentes, o

usuário deve preencher os filtros localizados do lado esquerdo da tela.

 

Os filtros disponíveis para consulta são:

  • Data Inicial: Campo obrigatório, que define a partir de qual data os registros serão selecionados.

  • Hora Inicial: Indica em que período os registros serão selecionados.

  • Data Final: Campo obrigatório, que define até qual data os registros serão selecionados.

  • Hora Final: Indica em que período os registros serão selecionados, levando em consideração apenas as informações existentes com Data Final e Hora Final inferiores ou iguais aos valores informados nos filtros.

  • Tipo Transação: Seleciona integrações de envio ou recebimento de informações.

  • Tipo Mensagem: Seleciona integrações do tipo BusinessMessage, ResponseMessage ou ReceiptMessage.

  • Tipo Processamento: Seleciona integrações do tipo síncrona ou assíncrona.

  • Status: Seleciona a integração de acordo com sua situação
    • Finalizado
    • Falha
    • Aviso

  • Transação: Campo que restringe a busca das integrações de acordo com o nome da transação informado.

...


Todas as colunas possuem a opção de filtro, que permite refinar a busca entre os registros exibidos na grid.


Para apagar a Transação escolhida, o usuário pode clicar sobre o ícone de exclusão, exibido para cada linha da tabela. Desta forma, será excluída apenas uma transação por vez.


Para apagar todas as transações filtradas, existe na parte inferior direita da tela, o botão Excluir todos. Desta forma, todas as transações selecionadas pelo filtro lateral serão excluídas.

 De/Para Msg Única

Configurações PIMS --> Conexão PIMS

Objetivo:  Exibir os relacionamentos entre o PIMS x Protheus, pois cada registro possui um identificador de referência única, tanto da aplicação de origem quanto da aplicação de destino. Sendo assim, torna-se possível rastrear o cadastro e verificar seu relacionamento correspondente em ambos os sistemas.Configurar a conexão com o banco de dados do PIMS Multicultivos de forma intuitiva.


Image Added

 

Configurações PIMS --> Parâmetros PIMS

Objetivo: Realizar a configuração dos parâmetros do PIMS. É possível configurar todos os parâmetros do PIMS MultiCultivos referente ao processo de

integração  (CONTEXT_APL = PIMSGRAOS.EAI).

 

Image Added

Ao abrir a tela não é exibido nenhum parâmetro, para que eles sejam visualizados é necessário aplicar uma consulta, para isso utilize o menu Procurar. Caso deseje procurar pelo nome

preencha o valor desejado no campo nome, caso deseje procurar pela descrição preencha o valor desejado no campo descrição. Os resultados exibidos serão aqueles que contenham em

eu nome ou descrição o valor inserido no campo no momento da busca. Caso seja necessário exibir todos os parâmetros do PIMSMC referentes a integração, é necessário deixar o campo

 

Nome e o campo Descrição em branco e clicar no botão consultar.

Image Added

Image Added Observação: Para configurar o parâmetro clique no botão editar

 

Wizard --> Configuração

Objetivo: O Wizard de Configuração tem como objetivo facilitar o processo configuração do PIMSConnector 

 

Na tela inicial do Wizard, selecione Configuração.
 

Image Added

 

Selecione o modelo de integração a ser utilizada e clique em Avançar.
 

Image Added

 

Preencha a URL do Web Service de comunicação com ERP, se necessário informar usuário e senha e clique em Avançar.
 

Image Added


Na tela seguinte desmarque as mensagens que não serão integradas e clique em Avançar.


Image Added

 

A próxima tela realizaremos as parametrização do PIMSConnector e PIMS Multicultivos.


Image Added


Após realizar todas as configurações necessárias dos Parâmetros clique em Avançar.


 Image Added

 

Na próxima etapa poderá realizar as configurações de e-mail, se optar por não configurar  marque a opção Desabilitar Configuração


Image Added


Na tela seguinte configure os destinatários que receberam os e-mail com resumo do processamento das mensagens.

Observação: Esta tela não aparecerá, caso seja desabilitar a configuração de e-mail no passo anterior. 
 

Image Added

 

Configure o tempo para execução das mensagens que serão integradas de forma Assíncrona.  A mensagem MensagemUnicaDataDriver é obrigatório a sua configuração.

 

Image Added


Por questões de segurança altere a senha do usuário ADMIN  (usuário padrão do Sistema) 

 

Image Added


Ao finalizar as configurações do Wizard, será apresentado o resumo dos procedimentos efetuados, clique em Concluir para finalizar as configurações.

 

Image Added

 

Wizard  --> Diagnóstico


Objetivo: Realizar uma avaliação no sistema em busca de possíveis problemas de configuração.

Na tela inicial do Wizard, selecione Diagnóstico.
 

Image Added

 

Clique em Iniciar Diagnóstico para iniciar a avaliação do sistema.
 

Image Added

 

Após finalizar a avaliação aparecerá um resumo dos teste executados, se o diagnóstico terminar sem erros clique em Concluir, senão clique e Avançar para prosseguir com diagnóstico. 


Observação: Representação dos ícones

Image Added Sucesso   Image Added Alerta   Image Added Erro

 

Image Added

 

A tela seguinte mostra todos os erros encontrados, clique em Solucionar Problemas.

 

Image Added

 

Após clicar em Solucionar Problemas será aberto a tela de configuração dos itens listados anteriormente, faça as configurações e clique em Validar para que o sistema valide as alterações feitas. 

 

Image Added

 

Após o sistema validar as configurações com sucesso clique em Avançar para ir para próximo item a ser ajustado.  

 

Image Added

 

Ao percorrer os itens e realizar as alterações necessárias, clique em Concluir para finalizar o Wizard.

 

Image Added

 

Adapter EAI


Objetivo:  Listar  todas as mensagens disponíveis no PIMSConnector. O Adapter EAI possibilitar habilitar ou desabilitar as mensagens que serão integradas pelo PIMSConnector.

 

 Selecionar as mensagens que serão integradas.

Image Added

 

Observação:  Caso seja apresentado uma mensagem, informando que a integração não esta habilitado, é necessário avaliar as configurações do Adapter EAI.  

Exemplo.("A Integração UnitOfMeasure do Modulo de Estoque não esta habilitada no PIMSConnector.")


De/Para Msg Única


Objetivo: Exibir os relacionamentos entre o PIMS x Protheus, pois cada registro possui um identificador de referência única, tanto da aplicação de origem quanto da aplicação de destino.

Sendo assim, torna-se possível rastrear o cadastro e verificar seu relacionamento correspondente em ambos os sistemas.


Image Added

As colunas 'Origem', 'Transação' e 'Descrição' permitem ao usuário selecionar as opções disponíveis para a consulta, já as colunas 'Valor Externo', 'Valor Image Removed
As colunas 'Origem', 'Transação' e 'Descrição' permitem ao usuário selecionar as opções disponíveis para a consulta, já as colunas 'Valor Externo', 'Valor Interno', 'Data' e 'Hora' permitem que o usuário digite as informações desejadas. As colunas 'Data' e 'Hora' possuem máscarasde máscaras de digitação, que restringem a digitação aos formatos dd/MM/yyyy para data e HH:mm para a hora. 

...

  • UUID: Identificador único da mensagem de integração;

  • Origem: Nome da Aplicação de origem das informações integradas;

  • Transação: Nome da transação que contém a mensagem de integração;

  • Descrição: Descrição em Português do nome da transação realizada;

    Âncora
    OLE_LINK4
    OLE_LINK4
    Âncora
    OLE_LINK5
    OLE_LINK5
    Âncora
    OLE_LINK6
    OLE_LINK6
  • Valor Externo: Código gerado na aplicação de origem da integração;
  • Valor Interno: Código gerado pelo PIMSConnector;
  • Data: Data de geração do registro de De/Para;
  • Hora: Hora de geração do registro de De/Para.

 

Empresa e Filial

Objetivo: Registrar o mapeamento de Empresa  e Filial existente no Protheus.

Image Removed

 

Ao abrir a tela pela primeira vez nenhum registro será exibido, para incluir um registro é necessário clicar no botão "Novo".
Image Removed
Detalhe dos  Campos; 
  • Código - Apenas informativo;
  • Origem - Definir a Origem das informações (Protheus / Datasul);

...

  • de origem da integração;

  • Valor Interno: Código gerado pelo PIMSConnector;

  • Data: Data de geração do registro de De/Para;

  • Hora: Hora de geração do registro de De/Para.

 

Empresa e Filial


Objetivo: Registrar o mapeamento de Empresa  e Filial existente no Protheus.

Image Added

 

Ao abrir a tela pela primeira vez nenhum registro será exibido, para incluir um registro é necessário clicar no botão "Novo".

Image Added
Detalhe dos  Campos; 
  • Código - Apenas informativo;

  • Origem - Definir a Origem das informações (Protheus / Datasul);

  • Descrição - preencher com um descritivo;

  • Grupo de Empresa - caso exista grupo de empresa no ERP preencher com o código do grupo de empresa;

  • Empresa - caso exista empresa no ERP preencher com o código da empresa;

  • Unidade de Negócio - caso exista unidade de negócio no ERP preencher com o código da unidade de negócio;

  • Filial - caso exista filial no ERP preencher com o código da filial.

 

Reprocessar Mensagens


Objetivo: Reprocessar as mensagens assíncronas que apresentaram erros.

Image Added

 

Ícones disponíveis

  • Image AddedSeleciona a mensagem para ser reprocessada. 
  •  Image Added Exibe os detalhes da mensagem.   

  •  Image Added Reprocessa a mensagem corrente.

 

Ao selecionar Reprocessar Mensagens, o sistema exibe ao usuário uma grid, que inicialmente estará vazia. Para consultar os registros existentes, o usuário deve preencher os filtros localizados do lado esquerdo da tela.

 

Os filtros disponíveis para consulta são:

 

  • Data Inicial: Campo obrigatório, que define a partir de qual data os registros serão selecionados.

  • Hora Inicial: Indica em que período os registros serão selecionados.

  • Data Final: Campo obrigatório, que define até qual data os registros serão selecionados.

  • Hora Final: Indica em que período os registros serão selecionados.

  • UUID: Campo que restringe a busca dos registros de acordo com o Identificador único.

  • Conteúdo XML:  Campo utilizado para filtrar os registros de acordo com o conteúdo XML informado.

  • Transação: Campo que restringe a busca das mensagens de acordo com o nome da transação informado.

O usuário poderá realizar o reprocessamento individual de cada mensagem ou selecionar as mensagens para serem reprocessadas e clicar em Reprocessar selecionados.

 

...

Wizard de Configuração

Objetivo: Realizar as configurações do PIMSConnector de modo rápido e fácil 

 

Na tela inicial do Wizard, selecione o modelo de integração a ser utilizada e clique em Avançar.

 

Image Removed

Na tela seguinte desmarque as mensagens que não serão integradas e clique em Avançar.

Image Removed

Preencha a URL do Web Service de comunicação com ERP, se necessário informar usuário e senha e clique em Avançar.

 Image Removed

 

A próxima realizaremos as parametrização do PIMSConnector e PIMS Multicultivos.

Image Removed

Após realizar todas as configurações necessárias dos Parâmetros clique em Avançar.

 Image Removed

 

Na próxima etapa poderá realizar as configurações de e-mail, se optar por não configurar pode marcar a opção Desabilitar Configuração

Image Removed

Na tela seguinte configure os destinatários que receberam os e-mail com resumo do processamento das mensagens.

 

Image Removed

 

Configure o tempo para execução das mensagens que serão integradas de forma Assíncrona.  A mensagem MensagemUnicaDataDriver é obrigatório a sua configuração.

 

Image Removed

Por questões de segurança altere a senha do usuário ADMIN (usuário padrão do Sistema) 

 

Image Removed

Ao finalizar as configurações do Wizard, será apresentará o resumo dos procedimentos efetuados, clique em Concluir para finalizar as configurações.

 

Image Removed

 

Parâmetros PIMS

...

preencha o valor desejado no campo nome, caso deseje procurar pela descrição preencha o valor desejado no campo descrição. Os resultados exibidos serão aqueles que contenham em

seu nome ou descrição o valor inserido no campo no momento da busca. Caso seja necessário exibir todos os parâmetros do PIMSMC referentes a integração, é necessário deixar o campo

Nome e o campo Descrição em branco e clicar no botão consultar.

...

 

...

Manutenção de Usuário


Objetivo: Realizar a criação ou alteração dos usuários do sistema PIMSConnector.


Na tela de Manutenção de Usuários, as informações serão demonstradas em uma tabela com quatro colunas. Na primeira coluna, cada usuário, exibe o ícone de alteração.

 

As colunas 'Nome' e 'Login' possuem o filtro que permite ao usuário digitar as informações que deseja buscar, a coluna 'Perfil' possui o filtro que permite ao usuário selecionar a opção de consulta, como ilustrado na imagem abaixo;

...

  • Login: será informado o login que o usuário utilizará para acessar o sistema.

  • Nome de Usuário: nome completo do usuário?  

  • Perfil: define as permissões de acesso ao sistema, de acordo com o tipo de usuário.

  • Senha: a senha de acesso ao sistema

  • Confirmar Senha:  para confirmar se a senha digitada está correta.

  • Idioma: selecionar o idioma dos textos exibidos para esse funcionário.

...

As empresas e filais selecionadas para aquele usuário, serão as que ele terá permissão para visualizar as mensagens integradas.


Observação: Caso não seja selecionada nenhuma empresa/filial o usuário terá acesso as mensagens de todas as empresas/filais.

...

Para usuários logados com perfil "MANAGER" aparecerá no rodapé ao lado do cadeado um novo ícone, clicando nesse ícone abrirá um pop-up listando todas as empresas/filiais que o usuário tem permissão para visualizar as informações.

 

Image RemovedImage Added

 

MENU MONITORAMENTO

...





Na primeira coluna da tabela de Integrações é exibido um ícone que direciona o usuário para a tela de detalhes.

 

  • UUID: Identificador único da mensagem de integração, não pode ser igual ao identificador de qualquer outra mensagem em qualquer um dos aplicativos participantes da integração.

  • Código: Número sequencial gerado pelo PIMSConnector para controle interno das transações.

  • Transação: Nome da transação que contém a mensagem de integração

  • Descrição: Nome da integração

  • Data: Data de processamento da integração.

  • Hora: = Hora de processamento da integração.

  • Tipo Transação: Informa se a mensagem integrada é de envio ou recebimento de informações.

  • Tipo Processamento: Informa se a integração é síncrona ou assíncrona.

  • Tipo Mensagem: Informa se a mensagem integrada é do tipo BusinessMessage, ResponseMessage ou ReceiptMessage.

  • Status: Demonstra a situação da integração (Não processado, Em execução, Finalizado, Falha, ou Bloqueado).

  • Dados da Transação: Exibe a estrutura do arquivo XML gerado pela aplicação de origem da integração.

  • Mensagem de Processamento: Campo utilizado apenas para integrações de Movimentação de Estoque quando o tipo for síncrono, para exibir mensagens de processamento contidas no retorno da transação.

...

  • Data Inicial: Campo obrigatório, que define a partir de qual Data os registros serão selecionados.
  • Hora Inicial: Indica em que período os registros serão selecionados, a partir da Hora Inicial informada.

  • Data Final: Campo obrigatório, que define até qual Data os registros serão selecionados.

  • Hora Final: Indica em que período os registros serão selecionados.

  • Código: Seleciona o código sequencial e único gerado para cada integração.

  • UUID: Seleciona o Identificador único da mensagem de integração.

  • Conteúdo XML: quando preenchido, seleciona apenas as transações que possuem no conteúdo do XML os valores informados;

  • Tipo Transação: Seleciona integrações de envio ou recebimento de informações.

  • Tipo Mensagem: Seleciona integrações do tipo BusinessMessage, ResponseMessage ou ReceiptMessage.

  • Tipo Processamento: Seleciona integrações do tipo síncrona ou assíncrona.

  • Status: Seleciona a integração de acordo com sua situação

  • Transação: Campo que restringe a busca das integrações de acordo com o nome da transação informado.

...

  • Data Inicial: campo obrigatório para filtrar a data inicial do período no qual o usuário deseja realizar a busca;

  • Hora Inicial: quando preenchido indica a partir de que período os registros serão selecionados;

  • Data Final: campo obrigatório para filtrar a data final do período no qual o usuário deseja realizar a busca;

  • Hora Final: quando preenchido, indica em que período os registros serão selecionados, levando em consideração apenas as informações existentes com Data Final e Hora Final inferiores ou iguais aos valores informados nos filtros;

  • UUID: seleciona os registros levando em consideração o número de identificação único de cada log;

  • Conteúdo da Mensagem: campo que restringe a busca, para selecionar apenas mensagens de log que possuem os caracteres informados no filtro;

  • Origem: seleciona a integração de acordo com sua aplicação de origem;

  • Destino: seleciona a integração de acordo com sua aplicação de destino;

  • Status: seleciona o log de acordo com o status de retorno do processamento (Todos, Falha, Sucesso ou Aviso);

  • Operação: para este campo, é possível escolher as opções: Todos, Atualização/Inclusão ou Exclusão, para selecionar os logs de acordo com a operação realizada;

  • Transação: campo no qual se informa o nome da integração que será filtrada;

...


Objetivo: Disponibilizar ao usuário os logs gerados pelo Jboss durante a execução do PIMSConnector. Os logs são demonstrados em tabela. Os dados são organizados por nome e cada linha é referente a um arquivo de log.


 

  • A primeira coluna possibilita ao usuário selecionar um ou mais arquivos para realizar o download.

  • Nome: Apresenta o nome do arquivo.

  • Tamanho: Exibe o tamanho do arquivo.

  • Tipo: Exibe o tipo (extensão do arquivo).

  • Data: Exibe a data da última alteração ou inclusão dos arquivos de log.

  • Download: Permite ao usuário realizar o download dos logs.

...

  • Data Inicial: campo obrigatório, que define a partir de qual Data as transações serão procuradas;

  • Hora Inicial: quando preenchido, indica a partir de que período os registros serão selecionados;

  • Data Final: Campo obrigatório, que define até qual Data as transações serão procuradas;

  • Hora Final: quando preenchido, indica em que período os registros serão selecionados, levando em consideração apenas as informações existentes com Data Final e Hora Final inferiores ou iguais aos valores informados nos filtros;

  • UUID: campo opcional que se refere ao número de identificação de cada transação;

  • Conteúdo XML: quando preenchido, seleciona apenas as transações que possuem no conteúdo do XML os valores informados;

  • Tipo Driver Origem: define se serão filtradas as transações que tiveram origem no Driver do PIMS ou no Driver do ERP. Por padrão, este campo é preenchido com o valor 'Todos';

  • Aplicação de Origem: define se serão filtradas as transações que tiveram origem no PIMS ou no ERP. Por padrão, este campo é preenchido com o valor 'Todos';

  • Nome da Integração: campo responsável por restringir a busca de acordo com o nome da Integração selecionada. Por padrão é preenchido com o valor 'Todos';

  • Status: indicar se a consulta deve recuperar transações com status de Sucesso, Falha, Em Execução ou Todos.

...


Cada coluna, assim como nas outras grids mostradas anteriormente, possui o campo de filtro, no qual é possível informar os dados que deseja consultar.




 

Monitor de Recursos


Objetivo: Exibir na forma de gráficos o uso de recursos do servidor onde está instalado o PIMSConnector


Image RemovedImage Added


Os gráficos exibidos apresentam a seguintes informações;
  • Memória Usada;

  • CPU;

  • Memória física usada;

  • Sessões HTTP;

  • Classes carregadas;

  • Contagem de Threads;

  • Acessos SQL por minuto;

  • Transações por minuto;

  • Conexões JDBC usadas.

É possível filtrar o período que será exibido as informação;

  • Hoje;
  • Semana;
  • Mês;
  • Outro

 

Selecionando a opção "Outro" é possível personalizar o período para exibir as informações.

 

Image RemovedImage Added

 

Clicando sobre o gráfico, será exibido em detalhe as informações do processo.

 

Image RemovedImage Added


Monitor de usuários 

Objetivo: Exibir todos os usuários conectados ao PIMSConnector.

 

Image RemovedImage Added

 

Nessa tela é possível visualizar o nome, login, IP e perfil dos usuários conectados ao PIMSConnector. Caso um mesmo usuário esteja conectado em ip's diferentes, ambas as conexões serão exibidas.
Existe a possibilidade de encerrar a conexão de qualquer um dos usuários dessa lista, para isso é necessário conectar ao PIMSConnector com um usuário com perfil de administrador (ADMIN), navegar até o menu Monitor de Usuários e clicar no ícone ao lado do nome do usuário para finalizar a conexão daquele usuário. 


Observação: 

Ícone para Ícone para encerrar a conexão Image Modified. 


Após clicar no ícone ícone Image Added, será exibida a pergunta "Deseja realmente encerrar a sessão?", clicando em "Sim" a conexão do usuário sera será encerrada obrigando o usuário a realizar o login novamente.


Image RemovedImage Added

 

Monitor de Processos

Objetivo: Exibir ao usuário os processos agendados que estão em execução.

...

Informações disponíveis para a consulta são:

 

  • Agendamento: Exibe o nome do Driver que possui um agendamento configurado.

  • Status: Indica o status atual da Integração exemplo: Aguardando Execução, Executando, etc.

  • Última Execução: Exibe Data e Hora que o agendamento foi executado pela última vez.

  • Próxima Execução: Exibe Data e Hora que o agendamento será executado novamente.

  • Expressão CRON: Exibe a expressão que demonstra a configuração do agendamento.

...

Objetivo: A tela de Agendamentos têm como objetivo exibir ao usuário os detalhes dos agendamentos, além de permitir que usuário configure o período para o qual deseja agendar os processos e integrações.

 

Os dados dos processos são dispostos em tabela (grid). Na parte superior da grid, para cada coluna, existe um campo de consulta, no qual é possível inserir informações que serão buscadas entre os

 

registros existentes. 

 





A primeira coluna da grid exibe o ícone que habilita os campos de agendamento, caso o processo não possua agendamento serão exibidos apenas os detalhes do processo.

...

  • Nome do Driver: Nome do Driver responsável por manipular os dados da integração.

  • Aplicação: Aplicação na qual o Driver de integração está registrado

  • Tipo do Driver: Indica se o Driver está registrado para o PIMS ou ERP.

  • Nome da Integração: Nome da integração pertinente ao Driver registrado.

  • Nome do Wrapper: Nome do Wrapper responsável pela comunicação entre o Driver e a Bridge.

  • Tipo de Comunicação: Indica de que maneira as informações recebidas durante a integração serão armazenadas.

  • Service URL: Url de comunicação do PIMS Multicultivos com o PIMSConnector

 

Âncora
OLE_LINK1
OLE_LINK1
Âncora
OLE_LINK2
OLE_LINK2
Âncora
OLE_LINK3
OLE_LINK3

...


Os parâmetros do Driver suportam dados que formarão uma expressão CRON. Uma Expressão CRON é composta por seis campos ordenados e separados por espaço em branco. Os campos podem conter qualquer um dos valores permitidos, juntamente com várias combinações de caracteres especiais também permitidos para este campo. 


As informações referentes aos parâmetros Segundo, Minuto, Hora, Dia do Mês, Mês e detalhes sobre expressão CRON estão descritas no tópico 15 - Anexos do manual.

...

MEUS DADOS

Objetivo: Permitir ao usuário logado, consultar ou alterar as informações do seu perfil.


Image AddedImage Removed


Esta tela apresenta ao usuário as seguintes informações:

  • Login: campo no qual será informado o login que o usuário utilizará para acessar o sistema.

  • Nome de Usuário: campo preenchido com o nome do usuário.

  • Perfil: campo que define as permissões de acesso ao sistema de acordo com o tipo de usuário.

  • Senha: campo no qual será cadastrada a senha de acesso.

  • Confirmar Senha: campo para confirmar se a senha digitada está correta.

...


É uma ferramenta utilizada para converter campos de chaves primárias de aplicativos externos para a chave primária do aplicativo interno. Pode ser referenciada como EAI de – para ou depara.


Durante a troca de mensagens, o aplicativo externo pode ter mais, menos ou diferentes campos correspondentes à chave primária. Assim, fica impossível identificar qual registro corresponde aos valores recebidos na mensagem. Isso pode ocorrer com vários aplicativos externos ao mesmo tempo e para a mesma mensagem. Para resolver essa situação, tornando-a invisível para o Helper e o Adapter durante a extração dos dados recebidos, foram criadas as funções do InternalId.


Foi adicionado um código interno (InternalId) no XML da mensagem para identificar os campos chaves do aplicativo externo. Chegando ao destino, os campos são convertidos para os valores locais no corpo da estrutura.

...

  • Envio de inclusão e atualização da Unidade de Medida do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.

  • Envio de inclusão e atualização do Grupo de Produto do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.

  • Envio de inclusão e atualização do Produto do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.

  • Envio de inclusão e atualização do Depósito do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.

  • Envio de inclusão e atualização do Centro de Custo do Protheus, para o PIMS Multicultivos, módulo de contabilidades gerencial, via mensagem única.

  • Envio de inclusão e atualização do Fornecedor do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.

  • Envio de inclusão e atualização da Conta Contábil do Protheus, para o PIMS Multicultivos, módulo de contabilidades gerenciais, via mensagem única.

  • Envio dos Valores dos Materiais do Protheus, para o PIMS Multicultivos, estoque e custos, via mensagem única.

  • Envio dos valores de Despesas Gerais do Protheus, para o PIMS Multicultivos, módulo de contabilidades gerenciais, via mensagem única.

  • Envio de valores de Depreciação mensal do Protheus, para o PIMS Multicultivos, módulo de contabilidades gerenciais, via mensagem única.

  • Envio da Movimentação de Estoque do PIMS Multicultivos, para o Protheus, estoque e custos, via mensagem única.
  • Envio da mensagem de Solicitação de Armazém / Compra do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Lançamentos Contábeis do PIMS Multicultivos para o Protheus

  • Envio da mensagem de Cargo do Protheus para o PIMS Multicultivos

  • Envio da mensagem de Funcionário do Protheus para o PIMS Multicultivos.

  • Envio da mensagem de Verbas do Protheus para o PIMS Multicultivos

  • Envio da mensagem de Sindicatos do Protheus para o PIMS Multicultivos

  • Envio da mensagem de Situação do Funcionário do Protheus para o PIMS Multicultivos

  • Envio da mensagem de Movimento dos Ruralistas do PIMS Multicultivos para o Protheus

  • Envio da mensagem de Horários/Escalas do Protheus para o PIMS Multicultivos

  • Envio da mensagem de Histórico de Horários/Escalas do Protheus para o PIMS Multicultivos

  • Envio da mensagem de Transferência do Protheus para o PIMS Multicultivos

  • Envio da mensagem de Histórico Salário do Protheus para o PIMS Multicultivos

...

  • Visualizar as mensagens processadas pelo PIMSConnector.

  • Visualizar os logs de processamentos das mensagens que foram enviadas e recebidas pelo ERP e PIMS Multicultivos.

  • Visualizar os logs de processamentos do servidor de Aplicação Jboss.

...

  • Realizar as configurações de agendamento, para as integrações de envio do PIMS Multicultivos para o Protheus, nas integrações assíncronas.

  • Realizar a parametrização de envio e recebimento das mensagens via monitor.

  • Realizar as parametrizações do PIMSConnector via Monitor.

...

  • Envio da mensagem de Unidade de Medida do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Grupo de Produto do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Produto do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Depósito do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Centro de Custo do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Fornecedor do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Conta Contábil do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Valores dos Materiais do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Despesas Gerais do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Depreciação mensal PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Movimentação de Estoque do Protheus, para PIMS Multicultivos.
  • Envio da mensagem de Solicitação de Armazém / Compra do Protheus, para PIMS Multicultivos.

  • Envio da mensagem de Lançamentos Contábeis do Protheus, para PIMS Multicultivos.

  • Envio da mensagem de Cargo do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Funcionário do PIMS Multicultivos para o Protheus.

  • Envio da mensagem de Verbas do PIMS Multicultivos para o Protheus

  • Envio da mensagem de Sindicatos do PIMS Multicultivos para o Protheus

  • Envio da mensagem de Situação do Funcionário do PIMS Multicultivos para o Protheus

  • Envio da mensagem de Movimento dos Ruralistas do Protheus para PIMS Multicultivos

  • Envio da mensagem de Horários/Escalas do PIMS Multicultivos para o Protheus

  • Envio da mensagem de Histórico de Horários/Escalas do PIMS Multicultivos para o Protheus

  • Envio da mensagem de Transferência do PIMS Multicultivos para o Protheus

  • Envio da mensagem de Histórico Salário do PIMS Multicultivos para o Protheus

...

  1. Em Agent, selecione Cadastro. O Schedule permite que Agents sejam adicionados automaticamente.

  2. Clique em Adicionar Agent (mais) e informe um Agent para cada empresa existente no cadastro de empresas.

  3. Para incluir Agents manualmente clique em (mais).

  4. Para alterar ou excluir Agents clique em (erro).

...

  1. Em Agendamentos, selecione Cadastro.

  2. Caso necessário, clique em Importar agendamentos antigos para registros de versões anteriores.

  3. Na pasta Detalhes clique em (mais) para adicionar um agendamento. Também é possível alterar (lápis) e excluir (erro).

  4. Posicione o cursor no campo Rotina e, em seguida, clique em (interrogação) para informar uma rotina (FWEAI).

  5. Informe a rotina e os parâmetros entre parênteses para que sejam lidos.

  6. Selecione a(s) empresa(s)/filial(is)

  7. Clique em Recorrência e selecione uma das seguintes opções:
    • Diária: informe o período de dias que deve ser considerado.

    • Semanal: informe os dias da semana considerados.

    • Mensal: informe o mês a ser considerado.

    • Anual: informe o ano a ser considerado.

    • Sempre ativo: mantém a rotina agendada em funcionamento contínuo até a data de término, se houver. Pode ser definida uma data de término para a recorrência.

...

Método

ID

Descrição

Origem

Destino

XSD (versões podem variar)

Cadastros

01

Unidade de Medida

Protheus

PIMS

UnitOfMeasure_2_000.xsd

 

02

Centro de Custo

Protheus

PIMS

CostCenter_2_000.xsd

 

03

Grupo de Produtos

Protheus

PIMS

Family_2_002.xsd

 

04

Produtos

Protheus

PIMS

Item_ 2_001.xsd

 

05

Depósito / Armazém

Protheus

PIMS

WareHouse_ 1_000.xsd

 

06

Fornecedor

Protheus

PIMS

CustomerVendor_2_002.xsd

 

07

Plano de Contas / Conta Contábil

Protheus

PIMS

AccountantAccount_2_000.xsd

 

08

Cargos

Protheus

PIMS

EmployeePosition_1_001

 

09

Verbas

Protheus

PIMS

PayrollAmount_1_000

 

10

Sindicatos

Protheus

PIMS

LaborUnion_1_001

 

11

Funcionários

Protheus

PIMS

Employee_3_001

 

12

Horários/Escalas

Protheus

PIMS

ScheduleWork_1_000

Processos

13

Movimento de Estoque

PIMS

Protheus

StockTurnover_1_003.xsd

 

14

Valores de Materiais

Protheus

PIMS

ItemCosting_1_000.xds

 

15

Saldo de Conta x Centro de Custo / Despesas Gerais

Protheus

PIMS

PeriodGlBalance_1_000.xsd

 

16

Depreciação Mensal

Protheus

PIMS

AssetDepreciation_1_000.xsd

 

17

Situação do Funcionário

Protheus

PIMS

EmployeeSituations_1_000

 

18

Histórico de Horários/Escalas

Protheus

PIMS

EmployeeHistoryWorkShift_1_000

 

19

Transferência

Protheus

PIMS

SetEmployeeBranchTranfer_1_000

 

20

Histórico Salário

Protheus

PIMS

EmployeeHistorySalaryPosition_1_000

 

21

Movimento dos Ruralistas

PIMS

Protheus

MonthlyPayroll_1_000

 

22

Solicitação de Materiais da OS de Oficina

PIMS

Protheus

Request_1_005

 

23

Retorno de Processamento de Custo

PIMS

Protheus

AccountingEntry_2_000

...


A integração de Prestador de Serviços pode ser utilizada em modo totalmente exclusivo ou compartilhada, realizando as configurações descritas abaixo;
Para funcionamento em modo exclusivo, o cadastro de Prestador de Serviços no Protheus precisa estar totalmente exclusivo ao nível de Empresa e Filial e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo:

 

Nome Parâmetro

Contexto

Descrição

Valor

FG_PSERVICOS_COMPARTILHADO

PIMSGRAOS.EAI

Flag que verifica se o Prestador de Serviços será Compartilhado ou por Unidade Administrativa

False


Para funcionamento em modo compartilhado, o cadastro de Prestador de Serviços no Protheus, precisa estar como compartilhado, e precisa alterar o parâmetro no PIMS Multicultivos, como descrito no quadro abaixo;

 

Nome Parâmetro

Contexto

Descrição

Valor

FG_PSERVICOS_COMPARTILHADO

PIMSGRAOS.EAI

Flag que verifica se o Prestador de Serviços será Compartilhado ou por Unidade Administrativa

True

...

  • Empresa – opcional em modo compartilhado

  • Filial – opcional em modo compartilhado

  • Código do Horário

  • Descrição do Horário

  • Sequencia

  • Tipo de Dia

  • Tipo de Hora

  • Hora Inicial

  • Hora Final


Processo:


No processo de integração de horários no PIMS Multicultivos serão gerados:

...


Para acessar o console do Jboss, basta navegar até o endereço http://localhost:8080 onde localhost é o IP do servidor e 8080 a porta configurada para iniciar o PIMSConnector, as informações de usuário e senha encontram-se no arquivo LEIA-ME.txt dentro do diretório server do Jboss.