Identificador de Regra

VEN-120PREIP02

Módulo: VEN - Vendas.

Finalidade: valida os dados dos itens do pedido antes do item ser gravado no pedido. Segue o modelo dos identificadores VEN-120CONIP01 e VEN-120CONIP02, com a diferença de ser executado antes do item ser gravado (tanto em uma inclusão quanto em uma alteração).

Importante

Quando o pedido é gerado a partir de um web service, o sistema não executa os identificadores de regra VEN-120PREIP02 e VEN-120ALPRE04. Nesse caso, utilize os identificadores CPR-000CONIT01, VEN-120CONIP01, VEN-120CONDG01 ou VEN120CONDG03.

Os diferenciais entre eles seguem descritos abaixo:

Funcionalidade VEN-120CONIP01 VEN-120CONIP02 VEN-120PREIP02
Disponibiliza dados do item já calculado Não Sim Sim
Disponibiliza campos de usuário para consulta Sim Sim Sim
Disponibiliza campos de usuário para alteração Sim Sim* Sim

*O identificador de regras VEN-120CONIP02 disponibiliza campos de usuário para alteração, porém como o identificador é executado após a gravação ele não é recomendado para essa finalidade.

Observação

É possível atribuir na regra valores a campos de sistema, porém esses valores são descartados quando a regra é finalizada. Isso devido ao fato de que o retorno de valores via campos de sistema necessita de tratamentos e consistências, e alguns campos são de controle interno e não podem ser alterados. Outro detalhe é que a leitura e manipulação de valores a campos de usuário só é possível com campos da tabela de itens de produto. Valores atribuídos a campos de usuário da tabela de dados gerais do pedido são descartados.

Características: as características abaixo fornecem valores de variáveis que não são campos de tabelas e são inerentes ao processo que está sendo executado, que é a gravação dos itens de produto do pedido:

Tela: F120GPD.

Transação: pode estar ligado a uma transação de produto.

Regra:

Variáveis disponibilizadas:

Nome Tipo Observações Retorna Valor
VsEstado ALFA Estado em que o registro do item do pedido se encontra no momento de gravação (INSERINDO OU ALTERANDO) N
VSInteracao ALFA Indica o tipo de interação com o usuário na execução da rotina de pedidos. Assume os valores "AUTOMATICO" (sem interação) ou "INTERATIVO" (com interação) N
VSModificado ALFA Indica se o item de pedido foi efetivamente modificado antes de ser passado à regra. N
VSTelaOrigem ALFA Representa uma tela em específico ou o processo do sistema responsável pela execução da rotina de pedido N
VsBloIte NÚMERO Retorna indicando ao sistema se o processo de gravação do item de produto deve ou não continuar. O valor padrão da mesma é 0 (zero). Se um valor diferente de zero for retornado, o sistema irá cancelar o processo de gravação S

Atenção

Caso o parâmetro global LisVarReg esteja habilitado, a variável ListaVariaveis estará disponível em todos os identificadores de regras do sistema. O conteúdo desta variável lista os campos disponibilizados no identificador de regras em questão.

Não é aconselhada a ativação desse parâmetro global para o uso cotidiano. Esse recurso de listagem dos campos de identificadores auxilia a construção de regras e o Suporte para, por exemplo, depuração ou quando não houver acesso à documentação dos identificadores de regras.

Este artigo ajudou você?