Gestão de Pessoas - Manual do Usuário > Customizações > Funções > ValidaAbrStr

ValidaAbrStr

Esta função permite validar se o parâmetro "xAbrIn" é um conjunto de valores alfanuméricos válidos e retorna no parâmetro "xAbrOut" este conjunto no formato padrão das abrangências. A sintaxe de uma abrangência válida deve ser esta: Uma lista de itens onde cada item pode ter um valor ou um intervalo de valores. Os itens são separados por vírgula ou ponto-e-vírgula(',' ou ';'), e caso um item seja um intervalo, o primeiro elemento deve ser ligado ao segundo através de hífen, dois-pontos, ou ponto-ponto ('-', ':' ou '..').

Sintaxe: ValidaAbrStr (Alfa xAbrIn, Alfa End xAbrOut);

Parâmetros:

Nome	Tipo	Descrição
xAbrIn	Alfa	Conjunto (abrangência) que será validada.
xAbrOut	Alfa	Retorna a abrangência otimizada.

Exemplo:

Definir alfa xAbrIn;
Definir alfa xAbrOut;
Definir alfa xAbrSQL;

/*
Situação 1 - Otimizar uma abrangência válida:
Considerando o valor da variável de entrada = 1,2,3,4,5,6 temos uma
abrangência válida porque contém valores alfanuméricos separados por vírgula.
O valor da variável xAbrOut será "1","2","3","4","5","6"
*/
xAbrIn = "1,2,3,4,5,6";
ValidaAbrStr (xAbrIn, xAbrOut);

/*
Situação 2 - Corrigir a digitação de separadores e valores repetido:
Considerando o valor da variável de entrada = "1,2,3,3," temos um valor repetido e uma vírgula excedente no final da string
A função eliminará esta vírgula e otimizará o valor da variável para "1","2","3"
*/
xAbrIn = "1,2,3,3,";
ValidaAbrStr (xAbrIn, xAbrOut);
MontaAbrangencia("R024CAR.CODCAR", xAbrOut, xAbrSQL);
/* xAbrSQL = "(((R024CAR.CODCAR = '1') OR (R024CAR.CODCAR = '2') OR (R024CAR.CODCAR = '3')))" */

Utilização: Gerador de relatórios e regras.

Disponível para os módulos: Todos os módulos do Gestão de Pessoas | HCM.