Histórico da Página

...

Exemplo de Criação do JOB

Este JOB é um console de processamento, sendo um programa Progress que tem por objetivo verificar a existência de pedidos de venda de origem e-commerce, alocados em embarques e prontos para serem faturados.

Image Added

Basicamente esse serviço deverá ser executado em um servidor dedicado a esse propósito.

Funcionamento
Ao iniciar o JOB Pedidos e-Commerce, por intermédio da ferramenta Serviço do Windows, o JOB será carregado automaticamente dentro do serviço.

Quando o JOB é carregado, ele fica verificando se possui pedidos de venda de origem e-commerce, já alocados e pronto para serem faturados.

Se existir algum pedido de venda a ser faturado, é gerada uma tabela temporária, com as informações de código do embarque e código do resumo a serem faturados, e enviado para a API de faturamento em lote de embarques. Após o processamento, é realizada a leitura novamente em busca de novos pedidos a serem faturados.

Configuração do JOB 
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:

Image Added

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:

Image Added

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 aplicativo de transmissão. 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_JOB_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

1. Selecione o servidor onde ficará em execução o JOB  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.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;

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_JOB_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, as linhas contendo os comandos -debugalert e -clientlog c:\temp\Clientlog_JOB_DTS11.log podem ser retiradas do arquivo .PF.

Como diferenciar o JOB por empresa principal

O JOB é 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.

Image Added

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.

04. ASSUNTOS RELACIONADOS

DT Novo programa de faturamento de Embarques em Lote (BatchShipmentBillingRPW)

...