Tempo aproximado para leitura: 00:07:40 min
Dúvida
Como configurar o JOB do Datasul para a Transmissão de Documentos?
Ambiente
Cross Segmentos - TOTVS Backoffice (Linha 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 - Extensible Markup Language 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.
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.
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 - Extensão de Arquivo, sendo que possui três parâmetros de entrada que devem ser informados ao iniciar, conforme exemplo a seguir:
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:
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 - Arquivo de Inicialização 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 - Enterprise Resource Planning , 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.
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.
0 Comentários