Histórico da Página
Dica | ||||
---|---|---|---|---|
| ||||
Olá, através dessa documentação vamos te ajudar a fazer algumas configurações no seu Appserver que são pré-requisitos para a integração entre TOTVS Protheus e TOTVS OMNI, sendo elas:
|
MaxStringSize e MemoMegaMaxStringSize e MemoMega
Nota | ||||
---|---|---|---|---|
| Funcionalidade disponível somente na release 12.1.25 ou superior.||||
Essa configuração é necessária para evitar a ocorrência "String size overflow". Esta ocorrência é reproduzida quando atingimos o limite do tamanho de uma string em advpl. A linguagem advpl suporta, por padrão, armazenar e operar uma string com tamanho de até 1 MB (1024 KB). Porem nos builds superiores iguais ou superiores ao 7.00. 131227A-20140829 é possível alterar esse comportamento. Abaixo exemplo de como realizar esta configuração. |
Exemplo:
Na seção General do arquivo Appserver.ini informe a chave maxStringSize e o seu valor como mostra o exemplo.
Bloco de código | ||
---|---|---|
| ||
[general] maxStringSize=100 |
...
Bloco de código | ||
---|---|---|
| ||
;===========================REST================================= [HTTPJOB] MAIN=HTTP_START ENVIRONMENT=SEU_AMBIENTE [HTTPV11] Enable=1 Sockets=HTTPREST [HTTPREST] Port=SUA_PORTA IPsBind= URIs=HTTPURI Security=1 [HTTPURI] URL=/rest PrepareIn=99SUA_EMPRESA Instances=1,1 ;===========================REST================================= [ONSTART] Jobs=HTTPJOB |
...
Nota | ||
---|---|---|
| ||
A porta informada na chave Port, deve ser uma porta liberada para IP externos, para que seja possível o a comunicação e envio/recebimentos de dados entre o TOTVS Protheus e TOTVS OMNI. |
Após finalizar a configuração do REST no Appserver.ini o que devo fazer?
Inicie o seu Appserver.ini e aguarde a inicialização do serviço REST, é possível visualizar no console do Appserver se o serviço foi inicializado com sucesso, como mostra a imagem abaixo:
Expandir | ||
---|---|---|
| ||
[24/10/2022 17:25:56] Totvs Application Server is running Starting Job [HTTPJOB] Starting Job [186F49545DDE1F4FAB54C91BB1151F76APP_MONITOR_THREADPOOL] _____ ______ _____ _______ *** Loading dbapi.dll [INFO ][SERVER] [DBAPI] Using DBAPI Memory Control Functions. [INFO ][SERVER] [Thread 21036] JOB Thread finished [-FWHTTPPREPARE] HTTPV11 is ready. |
2. Em seguida acesse seu navegador de Internet e informe o endereço do servidor e da porta do serviço REST
...
exemplo:
...
...
Após o passo mencionado acima deverá ser apresentado a
...
Lista serviços REST disponíveis:
...
Realize o teste de uma rede externa(
...
4G/Outra
...
rede fora da empresa) para saber se o acesso externo está liberado.
...
Deve aparecer a lista de serviços como no exemplo abaixo:
Expandir | ||
---|---|---|
| ||
3. Feito isso o Endpoint do TOTVS Protheus para recebimento dos dados é composto da seguinte forma:
3 - Na lista de Serviço localize o serviço EAISERVICE:
Clique em "For more details" para exibir os detalhes do serviço:
4 - Nos Detalhes do serviço localize o serviço do tipo POST de nome: "standardmessage/v1/transactions"
Esse é o serviço responsável por receber as mensagens da CIASHOP
5 - Será necessário enviar o Endereço do Serviço Protheus para CIASHOP.
O endereço é formado pelo IP
...
Servidor(IP Externo) e
...
PORTA definido no serviço REST + totvseai/standardmessage/v1/transactions/
...
Exemplo: http://127.0.0.1:
...
8036/rest/totvseai/standardmessage/v1/transactions/
Dica | ||
---|---|---|
| ||
Caso tenha definido um caminho para o serviço REST em URL o mesmo deve ser considerado no caminho do serviço. Isso evita erros como: {"code":404,"detailedmessage":"","message":"The server can't find the requested resource."} Ex : [HTTPURI] então o caminho ficaria: http://127.0.0.1:80708036/restexemplo/totvseai/standardmessage/v1/transactions/ |
Nota | ||
---|---|---|
| ||
O EndPoint do serviço REST configurado deve ser disponibilizado para o time do TOTVS OMNI, para o TOTVS OMNI conseguir conexão com seu ambiente. |
Aviso | ||
---|---|---|
| ||
No Protheus, cada grupo de empresas é um aplicativo diferente para o EAI. Desta maneira, cada grupo de empresas deve possuir um endereço REST diferente. Caso seja recebida uma requisição para um endereço cujo grupo de empresas é diferente do enviado, a seguinte mensagem será apresentada: O grupo de empresas do aplicativo não corresponde ao grupo de empresas deste serviço. Grupo recebido - (A). Grupo do serviço - (B) , onde A e B são respectivamente o grupo recebido na requisição e o grupo de empresas do endereço REST |
GRAVABATCH
Dica | ||
---|---|---|
| ||
O que é o GravaBtach e por que preciso configura-lo? O GravaBatch é um serviço de extrema importância pois é responsável pelo processamento da venda(gera financeiro/Baixa de estoque, geração de Pedido/Livros fiscais etc.). Este serviço deve ser configurado para as filiais utilizadas na integração. Este serviço deve ser configurado no seu appserver.ini, abaixo o exemplo de configuração |
Bloco de código | ||
---|---|---|
| ||
[Integracao_ERP]
Main=LJGRVBATCH
Environment=SEU_AMBIENTE
nParms=2
Parm1=_CODIGO_EMPRESA
Parm2=CODIGO_FILIAL
[ONSTART]
Jobs=Integracao_ERP |
Nota | ||
---|---|---|
| ||
Para maiores detalhes da configuração do serviço acesse: Detalhes GravaBatch |
Próximo passo
Dica | ||
---|---|---|
| ||
Agora que já realizamos as configurações no Appserver, vamos realizar alguns cadastros e parametrizações no modulo Configurador (SIGACFG) do TOTVS Protheus. Vamos lá... |