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.

...

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

integração  Na tela de Parâmetros do PIMS Multicultivos, é possível configurar todos os parâmetros do PIMS MultiCultivos que se referem ao processo de integração (CONTEXT_APL = PIMSGRAOS.EAI).

 



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

...

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.

...

  • 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.

 

Ícones disponíveis

  • Seleciona a mensagem para ser reprocessada. 
  •   Exibe os detalhes da mensagem.   

  •   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.

 

...


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;

...





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.

...

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.

 

 

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

 

...

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.


 

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.

...

  • 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.