Tratamento TRTVENCTL : TRTVENCTL

CTLSBSITM : Controlo artigo de substituição

Este ponto de entrada afecta a substituição automática de um artigo em registo de uma linha de documento venda.

Permite intervir justamente antes a substituição para efectuar os controlos afim de efectuar ou não esta substituição.

Este ponto de entrada está situado no tratamento TRTVENCTL no sub-programa CTLSBSITM.

A substituição corresponde à substituição automática da referência artigo registado por referência do artigo de substituição presente no separador vende da ficha artigo e isto se a data do documento é superior ou igual à data de substituição.

Contexto e modo de funcionamento

Transacção

Não existe transacção.

Ficheiro rasto

Não existe ficheiro rasto aberto.

Contexto de chamada

Este ponto de entrada está chamado gestão dos orçamemtos, encomendas, entregas, facturas.

É chamado cada vez que se regista uma nova linha, depois a acção de controlo standard do campo artigo (C_ITMREF de SUBSOH por exemplo). É o 1^o controlo efectuado sobre o campo.

O artigo de substituição vem de ser lido na classe [F :ITS].

Variáveis e máscaras disponíveis

As classes ecrãs de objecto estão em linha e alimentados.

No sub-programa CTLSBSITM, as variáveis seguintes estão disponíveis :

·               WITMREF  (valor char)  : Referência do artigo origem

·               DAT (value date)             :  Data do documento (para ctrl com a data de substituição)

·               RET (value integer)         :  Variável de retorno, devolução

                                                                    0=Sem artigo de substituição

                                                                    1=Artigo de substituição mais próprio à leitura do artigo ([F :ITS]

                                                                    2=Substituição ok

Quando o PE está chamado, a classe [F :ITS] está carregada com o artigo de substituição.

RET está alimentada. RET=2. O artigo de origem será preenchido pelo artigo de substituição.

Se não se pretende substituição, falta posicionar RET a 0 ou a 1.

Se está colocado a 0, todo é transparente. Nada se passa. Guarda-se o artigo de origem.

Se ela está colocada a 1, a mensagem de erro seguinte aparecer : "Problema sobre artigo de substituição" . mkstat está posicionado a 2. Resta em erro sobre o campo Artigo.

Se se pretende alterar o artigo de substituição, falta guardar RET ao valor 2 e carregar [F :ITS] com o novo artigo.

Tabelas abertas

As tabelas abertas são as tabelas do objecto (orçamento, encomenda, entrega, factura)