Documento de API

Considerações Gerais

Objetivo

Importar para o EMS 2.0 dados das tabelas de ordens de produção, reservas de materiais e operações da ordem.

Funcionamento

A geração das informações referentes a ordens de produção, reservas de materiais e operações será feita baseada somente nas temp-tables passadas como parâmetro para o programa. A princípio não serão buscadas informações da estrutura cadastrada na engenharia para geração das reservas e operações de um item.

Parâmetros de Entrada:

Tabelas Temporárias

Nos atributos das tabelas temporárias de entrada e saída:

Observação: Os campos Veículo e Per-ppm somente são usados a partir da release 206 do EMS, caso o cliente possua implantada a função Controle Concentração/PPM. Assim, caso o item da reserva seja do tipo Veículo, e esta reserva deva ser tratada como veículo para efeito de Balanceamento, o campo Veículo deverá ser passado com o valor Yes. Neste caso, no campo Per-ppm deverá ser informado o Percentual de distribuição que será aplicado para o veículo em questão no momento do processo de balanceamento da ordem.

Utilização da temp-table tt-lixo

No caso do campo c-arquivo seja diferente de  “res”, “ope” ou  “”

Exemplo :

if  c-arquivo <> "ord":U and

                c-arquivo <> "res":U and

                c-arquivo <> "ope":U and

                c-arquivo <> "" then do:

                create tt-lixo.

                assign tt-lixo.nr-ord-produ   = 0

                       tt-lixo.c-arquivo1     = "lixo":U

                       tt-lixo.linha          = i-linha.                         

end.

Execução

Execução: O programa cpapi002.p irá executar estas validações básicas:

1ª Validação: Versão de Integração

O programa irá verificar se o programa chamador está íntegro com a API, e isto ocorre por meio da verificação da versão de integração passada como parâmetro. Caso a versão esteja incompatível, a API abortará a execução retornando o código de erro 3941.

Outras Validações:

- Verifica se existe numeração disponível para a inclusão de mais ordens;

- Consiste a existência do item da ordem;

- Verifica se tal item não está obsoleto;

- Consiste a unidade de medida do item de acordo com seu cadastro;

- Consiste se as datas de início e término da ordem coincidem com os períodos de produção cadastrados;

- Valida a conta contábil de acordo com o cadastro.

- Observação:

- Se a cpapi002.p for utilizada em programa específico e o cliente deseja ver a tela de acompanhamento, deve-se declarar no mesmo a variável h-acomp como new shared variable e setar o handle por meio do comando

- run utp/ut-acomp.p persistent set h-acomp.

- Desta forma se o usuáro setar esta variável com um handle válido, o programa emitirá a caixa de acompanhamento.

Parâmetros de Saída

No retorno da execução do cpapi002.p, será retornado um dos valores abaixo (via RETURN-VALUE):

NOK: houveram erros durante o processamento

OK: execução com sucesso