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 e Orçamentos.

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)
   3. PE GVFLDCJ - Adicionar na interface do PGV campos adicionais do Cabeçalho do Orçamento (SCJ)
   4. PE GVFLDCK - Adicionar na interface do PGV campos adicionais dos Itens do Orçamento (SCK)

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

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

   a. Dados Gerais
      Ponto de entrada GVFLDCJ

   b. Itens

       Ponto de entrada GVFLDCK

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.

   e. Campos que não serão apresentados como customizados

Alguns dados não serão personalizados, mesmo que informados nos pontos de entrada. Isso significa que eles não aparecerão na tela do Portal de Gestão de Vendas porque já estão lá por padrão ou não podem ser alterados manualmente. Esses são os campos:
        
        C5_FILIAL - Filial      
        C5_NUM - Numero      
        C5_TIPO - Tipo Pedido 
        C5_TABELA - Tabela      
        C5_CONDPAG - Cond. Pagto 
        C5_EMISSAO - DT Emissao  
        C5_CLIENTE - Cliente     
        C5_LOJACLI - Loja        
        C5_TRANSP - Transp.     
        C5_TPFRETE - Tipo Frete  
        C5_FRETE - Frete       
        C5_SEGURO - Seguro      
        C5_DESPESA - Despesa     
        C5_DESC1 - Desconto 1  
        C5_DESC4 - Desconto 4  
        C5_MOEDA - Moeda       
        C5_TPLIB - Tipo de Liberação
        C5_CODA1U - Cod Intermed
        C5_INDPRES - Presença Com
        C5_MENNOTA - Mens.p/ Nota
        C5_COMENT - Comentario
        CJ_FILIAL - Filial
        CJ_NUM - Numero 
        CJ_NUMEXT - Descrição
        CJ_TABELA - Tabela de Preços
        CJ_CONDPAG - Condição de Pagamento
        CJ_CLIENTE - Cliente
        CJ_LOJA - Loja
        CJ_PROSPE - Prospect
        CJ_LOJPRO - Loja do Prospect
        CJ_EMISSAO - Emissão
        CJ_TPFRETE - Tipo do Frete
        CJ_FRETE - Frete
        CJ_SEGURO - Seguro
        CJ_DESPESA - Despesa
        CJ_DESC1 - Descrição
        CJ_MOEDA - Moeda
        CJ_TIPLIB - Tipo de Liberação
        CJ_TIPOCLI - Tipo do Cliente
        CJ_STATUS - Status 
        CJ_PROPOST - Proposta
        CK_FILIAL - Filial
        CK_NUM - Numero
        CK_ITEM - Item
        CK_PRODUTO - Produto  
        CK_DESCRI - Descrição do Produto
        CK_QTDVEN - Quantidade
        CK_PRUNIT - Preço Unitário
        CK_PRCVEN - Preço de Venda
        CK_VALOR - Valor Total
        CK_DESCONT - Desconto 
        CK_VALDESC - Valor do Desconto
        CK_TES - TES - Tipo de Entrada ou Saída
        CK_OPER - Tipo de Operação