Histórico da Página

Características do Requisito

Descrição

Implementação da funcionalidade de integração via mensagem única  - EAI - para o Easy Import Control (Protheus), com o objetivo de flexibilizar a comunicação entre as soluções TOTVS com a utilização da tecnologia de WEB Services, o que ocorrerá com a troca de informações (mensagens) no formato XML entre esses sistemas

Estão previstas nessa atualização as seguintes integrações:

...

Procedimento para Configuração

As atualizações disponibilizadas através deste Boletim Técnico adequam o produto Easy Import Control para sua utilização na integração via Mensagem Única – EAI. Para a configuração das integrações, devem ser observadas as orientações do manual de integração com o ERP em questão.

Sobre o EAI Protheus, consulte as informações adicionais disponíveis no portal TDN:

http://tdn.totvs.com/display/framework/EAI+Protheus

http://tdn.totvs.com/pages/releaseview.action?pageId=107939550

CONFIGURAÇÃO DE PARÂMETROS

      1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:
          Obs.: Configuração obrigatória.

      2. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:
          Obs.: Configuração opcional.

CONFIGURAÇÃO DE WEB SERVICE PROTHEUS

1. Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
2. Informe o Usuário e a Senha.
3. Acesse Módulos WEB e clique em Incluir.
4. Em Módulo Web, selecione o módulo WS – Microsiga Protheus 11 Web Services; em Nome da Instância, informe um nome para o Web Service(exemplo: “ws”). Selecione o enviroment e o ambiente. Marque a opção “Habilitar processos na Inicialização do Servidor”. Clique em Avançar.
5. Será exibida a pergunta “Deseja descompactar o pacote de arquivos HTTP na pasta especificada?”, clique em “Sim”.
6. Em host digite o endereço http do seu web service (Exemplo: “localhost:81/ws”). Selecione a Empresa/Filial e clique em Relacionar. O relacionamento será exibido na parte inferior da tela. Clique em Avançar.
7. Informe o número mínimo (Exemplo: 10) e máximo de usuários (Exemplo: 10) e clique em Finalizar.
8. O sistema irá exibir um aviso sobre a instalação do Web Service e questiona se deseja iniciar tal instalação. Clique em Sim.

CONFIGURAÇÃO DE JOB DO SCHEDULER DO PROTHEUS

1. Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
2. Informe o Usuário e a Senha.
3. Acesse Processos Comuns e clique em Incluir.

4. Preencha os campos conforme abaixo:

   Itens/Pastas	Descrição
   Nome do JOB:	FWSCHDMANAG
   Função ADVPL:	FWSCHDMANAG
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Instâncias:	1
   Parâmetros:	(não informar parâmetros)
   Habilitar JOB no START:	(deixe a opção marcada)

5. Clique em finalizar.
6. Acesse novamente Processos Comuns e clique em Incluir.

7. Preencha os campos conforme abaixo:

   Itens/Pastas	Descrição
   Nome do JOB:	FWSCHDQUEUE
   Função ADVPL:	FWSCHDQUEUE
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Instâncias:	1
   Parâmetros:	(não informar parâmetros)
   Habilitar JOB no START:	(deixe a opção marcada)

8. Clique em finalizar.
9. Após essa configuração, é necessário reiniciar o serviço do Protheus.

CONFIGURAÇÃO DE AGENTE DO SCHEDULER DO PROTHEUS

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
2. Em Agent/Cadastro, clique em Incluir.
3. Preencha os dados na tela para criação do Agente e clique em Confirmar.
4. Em Agent inicie o serviço criado.
5. Em Schedule inicie os serviços: Task Manager e Queue Manager.

CONFIGURAÇÃO DA TAREFA DE PROCESSAMENTO DE INTEGRAÇÕES ASSINCRONAS DO SCHEDULER DO PROTHEUS

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
2. Em Agendamentos/Cadastro, clique em Incluir.
   

3. Preencha os dados na tela para criação da tarefa conforme abaixo:

   Itens/Pastas	Descrição
   Usuário:	Administrador
   Rotina:	FWEAI
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Empresa/Filial:	(preencha com o empresa/filial em uso no protheus)
   Módulo:	99 – Configurador
   Habilitado:	(deixe a opção marcada)

4. Clique no botão recorrência e informe a periodicidade para processamento da tarefa de integração das mensagens assíncronas. Recomendado deixar na opção “Sempre Ativo” e “Sem data de término”.
   

5. Clique em Confirmar para fechar a tela de recorrência. Clique em confirmar para salvar a configuração da tarefa.
   
6. Recomendado reiniciar o serviço do Protheus após a configuração do agendamento.
   

CONFIGURAÇÃO DO APPSERVER DO PROTHEUS

...

CONFIGURAÇÃO DO SERVIÇO DO PROTHEUS PARA ATUALIZAÇÕES

Após as configurações de webservice e scheduler do Protheus, haverão tarefas em execução no servidor do Protheus mesmo que nenhum usuário esteja logado no sistema. Com isso as aplicações de patchs e updates que necessitam de acesso exclusivo ao sistema podem ser dificultadas pois é necessário derrubar os processos em execução. Recomenda-se fazer uma copia da instalação do serviço do Protheus (pasta “\bin\” que contem os binários do serviço do Protheus) e nessa instalação retirar a configuração da execução dos Jobs (basta remover a seção [ONSTART] no appserver.ini. É importante que todas as outras configurações sejam mantidas). Assim, quando for necessário aplicar um patch ou update, pare o serviço do Protheus que possuir as configurações dos Jobs, inicie o serviço que não possua execução de Jobs, aplique a atualização necessária, pare o serviço que não possuir execução de Jobs e inicie novamente o serviço que possuir a execução de Jobs.

Tome cuidado para executar esse processo da maneira descrita para que o Protheus possa ser atualizado e para que não fique sem a inicialização dos Jobs.

PROCEDIMENTO PARA BACK-UP DE BASE DE DADOS

Devido ao controle e configurações internas do TOTVS DBACCESS, toda criação de backup e restore de backup de base de dados, assim como replicação da base de dados para outros ambientes, deve ser feita através da importação de tabelas da ferramenta APSDU. Isso garante a integridade das tabelas e correta interpretação dos dados pelo TOTVS DBACCESS e consequentemente pelas aplicações do Protheus. Não utilize ferramentas de backup de tabelas diretamente pelo banco de dados, pois isso pode exigir a reinicialização do serviço e até mesmo a reinstação do TOTVS DBACCESS.

RELAÇÃO DE/PARA DE EMPRESAS / FILIAIS

Outros ERPs TOTVS diferentes do Protheus não possuem o conceito de Empresa/Filial como no Protheus, existindo uma ou mais empresas/filiais distintas utilizando o mesmo sistema, são todas cadastradas no ERP como empresas diferentes. Além disso os códigos de empresa do ERP são distintos dos códigos de empresa/filial do Protheus. Por isso é necessário acessar o cadastro da relação DE/PARA no módulo configurador (Ambiente/Schedule/Emp.fil Msg.Unica) para cadastrar esta relação.

Por exemplo, se tivermos a empresa 21 no ERP Logix e quisermos associar á empresa 01 filial 10 do Protheus, devemos cadastrar conforme abaixo.

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Emp.fil Msg.Unica (APCFG050).

2. Clique na opção Incluir e preencha os campos conforme exemplo abaixo:

   Itens/Pastas	Descrição
   Referência	LOGIX (nome do ERP externo)
   Company	21 (código da empresa no ERP)
   Branch	(em branco)
   Emp.Protheus	01
   Fil.Protheus	10

3. Clique em confirmar para salvar o relacionamento empresa/filial.
   

ADEQUAÇÃO DO TAMANHO DOS CAMPOS DO PROTHEUS

O tamanho de campos de algumas tabelas do Easy precisará ser adequado para que fique compatível com o tamanho dos campos no ERP.

Campos como código de cliente, código de fornecedor e código de produto podem ficar divergentes e gerar problemas de integração caso não fiquem com o mesmo numero de caracteres que o ERP.

 Verifique o tamanho dos grupos de campos do Protheus através do módulo configurador, na opção de menu Base de dados / Dicionário / Base de dados. Selecione a empresa do lado esquerdo da tela, selecione Dicionário de dados e Grupo de campos. Veja ao lado direito todos os grupos de campo e na coluna tamanho, o tamanho atualmente em uso no Protheus.

 É recomendado rever os seguintes grupos de campos:

CONFIGURAÇÃO DE ADAPTER

O módulo Easy Import Control está preparado para a realização das integrações que seguem. Para configurar as integrações, conforme a necessidade, siga as instruções abaixo:

1. No Configurador (SIGACFG) acesse Schedule/Adapter E.A.I. (CFGA020).

2. Acesse a opção Incluir e informe os dados do adater, conforme as opções que seguem:

...