FAQs - Suporte técnico

DS - TC2 - Configuração do JOB no Datasul

time.png Tempo aproximado para leitura: 00:03:30 min

Dúvida
Como configurar o JOB do Datasul?

Ambiente
Datasul - Totvs Colaboração 2.0 - Versão 12

Solução
Para atender a solução TC2.0 - TOTVS Colaboração 2.0 foi desenvolvido um novo agente de leitura dos XMLs retornados na integração com a Neogrid de nome JOB TC 2.0.

Este JOB é um console de processamento, também conhecido por Adapter de Recebimento, sendo um programa Progress que tem por objetivo verificar a existência de documentos XML retornados na pasta IN do ClientEDI - Neogrid.

Esse JOB apenas é utilizado no processo do TC 2.0.

JOB.jpg

Basicamente esse serviço deverá ser executado em um servidor dedicado a esse propósito, porém sem a necessidade de grandes configurações de hardware para seu funcionamento.

Para a instalação do JOB são necessárias permissão de leitura e gravação no diretório IN da Neogrid e nas demais pastas configuradas no Sistema.

Funcionamento
Ao iniciar o JOB TC 2.0, por intermédio da ferramenta Serviço do Windows, o JOB será carregado automaticamente dentro do serviço.

Quando o JOB é carregado, ele fica analisando a pasta IN, que representa os retornos dos documentos integrados pelo TC2.0 retornados pela Neogrid, verificando se há algum novo XML a ser processado.

Se existir algum documento a ser processado, é efetuada autenticação no Sistema e a mensagem é processada. Após o processamento, o diretório é verificado novamente em busca de novas mensagens a serem processadas.

job2.jpg

Configuração do JOB no TOTVS Colaboração 2.0
A ativação do JOB deve ser por intermédio de um atalho do Windows ou arquivo de lote - BAT, sendo que possui três parâmetros de entrada que devem ser informados ao iniciar, conforme exemplo a seguir:

job3.jpg

C:\dlc102b\bin\prowin32.exe

Chamada ao programa Progress
Deve ser selecionado de acordo com a versão instalada na máquina e não deve ser alterado o nome do programa prowin32.exe.

-ininame [CAMINHO]\propath.ini
Arquivo de Propath, como padrão deve ser o mesmo Propath do ambiente para evitar que ao executar algum processo ocorra erro de execução.

-pf [CAMINHO]\JOB.pf
Arquivo .PF utilizado no acesso ao ambiente.
Também deve ser o mesmo utilizado no acesso ao Sistema Datasul para evitar que ao executar algum processo ocorra erro. Este arquivo deve possuir as seguintes opções configuradas:

01.jpg

Linhas 01 a 19
Para a configuração desses parâmetros pode ser adotado o mesmo utilizado no arquivo .PF principal do ambiente Datasul.

-param "-param "ems2.usuario.senha.nome da empresa,,,,,,,"
Parâmetro que determina qual é o Sistema que será acessado, EMS2, o usuário e a senha.

Importante lembrar que deverá ser configurado um usuário e senha para acesso ao Sistema contendo a permissão de gravação.

Verifique também a empresa principal configurada para esse usuário, pois o Sistema irá utilizar esses dados para gravação do registro de retorno nas tabelas do TC2.0. Caso exista a necessidade em identificar a qual empresa o JOB está processando os documentos deve ser configurado um quarto parâmetro, que é o nome da Empresa.

As vírgulas ,,,,,,, são para separar os parâmetros obrigatórios que devem ser passados. Podem ser deixados em branco, mas a partir da versão 12.1.4 é necessário colocar nesta estrutura devido a uma alteração liberada na include de tecnologia. Se não estiver desta forma, pode ocorrer o erro abaixo ao inicializar o JOB:

A conexão ao servidor na porta  não está disponível. Contate o administrador do ambiente

-p "[CAMINHO]\cd0590a.r"
Caminho para o programa principal que fica executando o monitoramento do diretório, analisando o retorno dos XMLs na pasta IN.

-debugalert
-clientlog c:\temp\Clientlog_JOBTC2_DTS11.log
Comando que ativa o Clientlog na execução do serviço de atualização dos documentos pelo JOB de leitura. Esse parâmetro pode ser ativado ou retirado da execução conforme necessidade do usuário. Não é um parâmetro obrigatório.

Passo a Passo para a criação do JOB de Leitura da Solução TOTVS Colaboração 2.0

1. Selecione o servidor onde ficará em execução o JOB TC 2.0 e caso desejar, crie uma pasta para armazenar todos os atalhos e arquivos utilizados pelo serviço;

2. Crie um arquivo com a extensão .BAT com o nome JOB_TC_2.BAT e abra-o para edição pelo bloco de notas;

3. Copie e cole a seguinte instrução para o arquivo BAT

c: 
cd %temp%
start C:\dlc102b\bin\prowin32.exe -pf "[CAMINHO]\JOB.pf" -basekey "INI" -ininame "[CAMINHO]\propath.ini"

4. Altere o comando C:\dlc102b\bin\prowin32.exe conforme sua instalação do Progress;

5. Altere o comando -pf "[CAMINHO]\JOB.pf" colocando o correto caminho para o arquivo .PF de acesso ao ambiente Datasul criado para ser utilizado pelo JOB TC2.0;

6. Altere o comando -ininame "[CAMINHO]\propath.ini" colocando o correto caminho para o arquivo .INI de acesso ao ambiente Datasul. Não existe a necessidade em criar um arquivo INI específico, basta apontar para o mesmo utilizado pelo ambiente Datasul.

7. Abra o arquivo .PF que foi apontado no passo 5 e acrescente as seguintes linhas de comando:

-param "ems2.usuario.senha.nome da empresa,,,,,,," 
-p "[CAMINHO]\cd0590a.r" 
-debugalert 
-clientlog c:\temp\Clientlog_JOBTC2_DTS11.log

8. Altere o comando -param "ems2.usuario.senha.nome da empresa" trocando a palavra usuario pelo usuário que foi criado para acesso do JOB e trocando a palavra senha pela senha definida para esse usuário. Troque a palavra empresa pelo nome da Empresa Principal que o JOB estará processando os documentos, esse parâmetro pode ser passado em branco. Importante lembrar que o . - ponto, entre as palavras deve ser mantido pois é a forma como o Sistema identifica cada um dos parâmetros;

9. Altere o comando -p "[CAMINHO]\cd0590a.r" trocando para o correto caminho onde se encontra o programa CD0590a conforme propath do ambiente;

10. Caso não deseje gerar o Log de execução do ClientLog pelo JOB TC 2.0, as linhas contendo os comandos -debugalert e -clientlog c:\temp\Clientlog_JOBTC2_DTS11.log podem ser retiradas do arquivo .PF.

Como diferenciar o JOB por empresa principal

O JOB TC 2.0 é o serviço que irá buscar os XMLs retornados na pasta IN trazendo essa informação para o Datasul. Esse serviço deve ser configurado por empresa principal, visto que a cada empresa o banco físico é diferente dentro do ERP, dessa forma caso exista a necessidade em configurar mais de um JOB no ambiente para identificar a qual empresa principal o JOB está processando os documentos, será possível realizando a seguinte parametrização:

No comando -param que se encontra no arquivo .PF definido para o JOB altere a quarta informação para o nome que será exibido na execução do JOB-param "ems2.usuario.senha.empresa"

Caso informado esse parâmetro, o resultado será apresentado na tela, conforme exemplo abaixo.

JOB.jpg

Esse parâmetro pode ser passado em branco, nesse caso não será exibida nenhuma informação na posição indicada.

Versão 12.1.17:
A partir da versão 12.1.17 foi incluído um parâmetro para a configuração do arquivo .PF, que é o tempo:

-param "ems2.USUARIO.SENHA.EMPRESA.tempo"

Caso deseje, troque palavra tempo pelo número relativo aos segundos que deseja que o JOB aguarde entre os processamentos das notas, esse parâmetro também pode ser passado em branco. O tempo padrão é 3 segundos.

Importante
Lembrar que o . - ponto entre as palavras deverá ser mantido pois é a forma como o Sistema identifica cada um dos parâmetros.

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _