funcoes.docx

3
Customização de campos – Dicionário de Dados Validações de campos e perguntas As funções de validação têm como característica fundamental um retorno do tipo lógico, ou seja, um conteúdo .T. – Verdadeiro ou .F. – Falso. Com base nesta premissa, a utilização de validações, no Dicionário de Dados (SX3) ou nas Perguntas de Processos e Relatórios (SX1), deverá focar sempre na utilização de funções ou expressões que resultem em um retorno lógico. Através do módulo Configurador é possível alterar as propriedades de um campo ou de uma pergunta, de forma a incluir regras de validação para as seguintes situações: SX3 – Validação de usuário (X3_VLDUSER). SX1 – Validação da pergunta (X1_VALID). Dentre as funções que a linguagem ADVPL, em conjunto com os recursos desenvolvidos pela aplicação ERP, para validação de campos e perguntas serão detalhadas: Função Descrição X3CBOX Retorna o conteúdo de um campo tipo combo contido no dicionário de dados X3DESCRIC Retorna a descrição do campo de acordo com o registro posicionando no SX3 e o idioma corrente. X3PICTURE Retorna a máscara de um campo do dicionário de dados SX3. X3USO Avalia se um campo está em uso para um determinado módulo X3TITULO Retorna o título do campo de acordo com o registro posicionado no SX3 e o idioma corrente. Posicione A função posicione é utilizada para posicionar uma tabela em determinado registo. Normal ExistChav Função utilizada normalmente para verificar se um determinado código de cadastro já existe na tabela na qual a informação será inserida. ExistCpo Verifica chave estrangeira em outra tabela. ExistUnic o Verificar se uma operação de inclusão ou alteração em um determinado alias é válida. DataValid a Retorna se a data é valida dentro do sistema. Verdade Retorna sempre verdadeiro CGC Valida se um campo é um CPF ou CNPJ valido. Positivo Retorna Verdadeiro caso o campo seja Positivo. Negativo Retorna Verdadeiro caso o campo seja Negativo.

Upload: wagner-ferreira

Post on 25-Nov-2015

37 views

Category:

Documents


0 download

TRANSCRIPT

Customizao de campos Dicionrio de Dados Validaes de campos e perguntas As funes de validao tm como caracterstica fundamental um retorno do tipo lgico, ou seja, um contedo .T. Verdadeiro ou .F. Falso. Com base nesta premissa, a utilizao de validaes, no Dicionrio de Dados (SX3) ou nas Perguntas de Processos e Relatrios (SX1), dever focar sempre na utilizao de funes ou expresses que resultem em um retorno lgico. Atravs do mdulo Configurador possvel alterar as propriedades de um campo ou de uma pergunta, de forma a incluir regras de validao para as seguintes situaes: SX3 Validao de usurio (X3_VLDUSER). SX1 Validao da pergunta (X1_VALID).

Dentre as funes que a linguagem ADVPL, em conjunto com os recursos desenvolvidos pela aplicao ERP, para validao de campos e perguntas sero detalhadas:

FunoDescrio

X3CBOXRetorna o contedo de um campo tipo combo contido no dicionrio de dados

X3DESCRICRetorna a descrio do campo de acordo com o registro posicionando no SX3 e o idioma corrente.

X3PICTURERetorna a mscara de um campo do dicionrio de dados SX3.

X3USOAvalia se um campo est em uso para um determinado mdulo

X3TITULORetorna o ttulo do campo de acordo com o registro posicionado no SX3 e o idioma corrente.

PosicioneA funo posicione utilizada para posicionar uma tabela em determinado registo. Normal

ExistChavFuno utilizada normalmente para verificar se um determinado cdigo de cadastro j existe na tabela na qual a informao ser inserida.

ExistCpoVerifica chave estrangeira em outra tabela.

ExistUnicoVerificar se uma operao de incluso ou alterao em um determinado alias vlida.

DataValidaRetorna se a data valida dentro do sistema.

VerdadeRetorna sempre verdadeiro

CGCValida se um campo um CPF ou CNPJ valido.

PositivoRetorna Verdadeiro caso o campo seja Positivo.

NegativoRetorna Verdadeiro caso o campo seja Negativo.

VazioRetorna Verdadeiro se o campo estiver vazio.

NaoVazioRetorna Verdadeiro caso o campo no esteja vazio

EntreDetermina se o campo esta dentro de um limite inferior e superior.

TextoRetorna Verdadeiro caso o texto no inicie com espao em branco.

PertenceA funo Pertence verifica se o contedo a ser atribudo pelo usurio vlido conforme definido no parmetro da funo.

Pictures de formatao disponveis

Com base na documentao disponvel no DEM Documentao Eletrnica Microsiga, a linguagem ADVPL e a aplicao ERP Protheus admitem as seguintes pictures: Dicionrio de Dados (SX3) e GET Funes

Contedo Funcionalidade

A Permite apenas caracteres alfabticos.

C Exibe CR depois de nmeros positivos.

E Exibe numrico com o ponto e vrgula invertidos (formato Europeu).

R Insere caracteres diferentes dos caracteres de template na exibio, mas no os insere na varivel do GET.

S Permite rolamento horizontal do texto dentro do GET, um nmero inteiro que identifica o tamanho da regio.

X Exibe DB depois de nmeros negativos.

Z Exibe zeros como brancos.

( Exibe nmeros negativos entre parnteses com os espaos em branco iniciais.

) Exibe nmeros negativos entre parnteses sem os espaos em branco iniciais.

! Converte caracteres alfabticos para maisculo.