Identificador de Regra

VEN-120CONIP01

Módulo: VEN - Vendas.

Finalidade: Tem o mesmo intuito do identificador VEN-0000CONIT01, que é o de consistir os dados dos itens do pedido no momento de gravação. Porém, o identificador VEN-000CONIT01 tem um propósito mais genérico e é usando tanto para produtos e serviços no pedido, nas notas fiscais de saída e pré-faturas, sendo identificadas as origens de chamadas por determinadas variáveis. O novo identificador tem o propósito específico de tratar apenas os itens de produto do pedido, e pode ser associado a transações. As características desse novo identificador são:

Disponibiliza todos os campos da tabela de item de produto (E120IPD) e da tabela do pedido (E120PED). Não são utilizados nomes de variáveis predefinidas para acesso aos valores de cada campo das tabelas sendo tratadas. Os campos dos registros associados ao identificador estão disponíveis no formato "Nome da tabela" + "." + "Nome do Campo". Essa nova forma de passagem de valores para as regras garante mais velocidade na carga das regras, pois não é necessário que o sistema atribua valores a todas as variáveis predefinidas, já que os valores dos campos são transferidos para as regras no momento em que são referenciados (usados) na regra.

Acesso a campos de usuário dos campos das tabelas disponibilizadas. Essa opção atualmente só está disponível para a rotina do ComercialVendasPedidosAgrupados e Individual. As demais rotinas de pedidos (Web, SID, rotinas automáticas internas e algumas telas) não retornam valores para campos de usuário referenciados nas regras, embora não ocorram erros se referenciados. Na rotina de pedidos agrupados, é possível inclusive atribuir valores aos campos de usuário da tabela de itens de produto, sendo os mesmos gravados automaticamente. O valor atribuído aos campos via regra e sua consistência são de responsabilidade do autor da lógica da regra. O sistema não irá consistir os valores desses campos.

O identificador continua sendo executado na gravação dos itens de produto do pedido e disponibiliza os valores dos campos dos dados gerais do pedido. Como citado, esses valores são acessados no mesmo formato "Tabela" + "." + "Nome do campo". A tabela dos dados gerais, no caso do pedido é a E120PED.

Os identificadores de regras VEN-120CONIP01, VEN-120CONIP02 e VEN-120PREIP02 possuem comportamentos semelhantes. Os diferenciais entre eles seguem descritos abaixo:

  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, no entanto como o identificador é executado após a gravação, ele não é recomendado para essa finalidade.

Importante

Na regra é possível atribuir valores a campos de sistema também, porém esse valor é descartado quando a regra é finalizada. Isso se deve 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 atribuição de valores a campos de usuário só são considerados quando são 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 demais 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: Pedidos e itens de produtos.

Transação: Não se aplica.

Regra: Exemplos de acessos às tabelas e campos:

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ê?