DR - Campos Personalizados

O Portal Gestão de Vendas permite a inclusão de campos personalizados no cabeçalho, itens e visualização nas operações de inclusão e alteração do Pedido de Vendas.

Para personalização dos formulários do Portal Gestão de Vendas, temos os pontos de entradas disponíveis abaixo:

1. 1. DT PE GVFLDC5 - Adicionar na interface do PGV campos adicionais do Cabeçalho do Pedido de Venda (SC5)
   2. DT PE GVFLDC6 - Adicionar na interface do PGV campos adicionais dos itens do Pedido de Venda (SC6)

Deve ser realizado o login no portal  para ocorrer a carga de dados dos campos personalizados retornados no ponto de entrada.

Ao Incluir, Alterar ou Visualizar um Pedido de Vendas, será apresentados os campos retornados nos pontos de entradas, conforme os exemplos abaixo:
   

   a. Dados Gerais
 Ponto de entrada GVFLDC5

   b. Itens

       Ponto de entrada GVFLDC6

   c. Resumo

        Ponto de entrada GVFLDC5

A seguir serão descritos o funcionamento e o comportamento dos campos customizados no Portal Gestão de Vendas, de acordo com as configurações no Protheus.

   a. Carga de Dados

Os campos informados nos pontos de entrada desta documentação, são carregados para o armazenamento local do navegador com as suas respectivas características descritas no Dicionário de Dados do Protheus.

Porém, se forem informados campos com os tipos não considerados pelo PGV conforme descrito na documentação dos seus respectivos pontos de entrada, os campos não serão carregados no PGV e consequentemente não serão apresentados para o preenchimento. Campos virtuais também não serão carregados.

   b. Características do Dicionário de Dados Protheus aplicadas nos campos customizados do Portal Gestão de Vendas

Os campos customizados são apresentados no PGV seguindo algumas das características descritas no dicionário de dados do Protheus, conforme mencionado no tópico acima.

A relação entre as propriedades de um campo customizado do dicionário de dados Protheus e as propriedades destes mesmo campo no PGV são apresentadas a seguir:

• Título (X3_TITULO): Rótulo do campo exibido.
• Descrição (X3_DESCRIC): Texto de ajuda apresentado abaixo do campo.
• Tipo (X3_TIPO): Tipo do campo
• Tamanho (X3_TAMANHO): Tamanho máximo de caracteres
• Propriedade (X3_VISUAL): Desabilita o campo caso tenha o valor V – Visualizar no dicionário de dados
• Obrigatório (X3_OBRIGAT): Define a obrigatoriedade do campo

Os gatilhos, validações e inicializadores padrões dos campos somente serão executados após o acionamento da opção de salvamento dos dados, conforme a rotina automática correspondente.

As consultas padrões (F3) não são executadas na interface do PGV.

   c. Campos Customizados Obrigatórios

Esta seção vai apresentar alguns detalhes sobre os campos customizados obrigatórios (X3_OBRIGAT).

Estes campos vêm com uma indicação na parte superior com esta informação. Caso o campo seja preenchido e depois for deixado vazio as bordas do campo ficarão vermelhas. Mas, as demais operações na interface não serão interrompidas.

A validação do preenchimento dos campos customizados obrigatórios acontecerá após o acionamento da opção de salvamento dos dados. Caso algum destes campos não esteja preenchido, será apresentada a seguinte mensagem:

   d. Validações do Protheus nos campos

Conforme já mencionado as validações dos campos adicionadas no dicionário de dados do Protheus (X3_VALID e/ou X3_VLDUSR), não são executadas na interface do PGV. Porém, após o acionamento da opção de salvamento dos dados, o PGV irá validar o preenchimento dos campos conforme configuração no Protheus. 

Caso alguma validação retorne um resultado negativo, este será apresentado no PGV. 

Caso contrário o salvamento dos dados ocorrerá com sucesso.