Funções de Validação de Texto

Essas funções fornecem para um script de validação a mesma validação que pode ser definida para um formato de arquivo de documento de texto.

Validate

Declaração

bool Validate(string op, string arg[, boolean ignoreCase])

Sintaxe

Validate(<op>, <arg>[, <ignoreCase>])

Parâmetros Obrigatórios

• op: O operador de comparação a ser usado para a validação
• arg: O valor a ser usado com o operador de comparação na validação

Parâmetros Opcionais

• ignoreCase: Se deve ser ignorado o caso ao realizar a validação; padrão, false

Descrição

Esta função deve ser chamada a partir de um script usado para validação de texto. Ele fornece para esse script de validação a mesma validação que pode ser definida para um formato de arquivo de documento de texto. Normalmente esta função é chamada em um script usado na validação de um formato de arquivo de documento de texto de origem. Observe que a validação funciona apenas para origens, não para destinos.

O Validate a função assume que o script de chamada possui estes três argumentos de entrada fornecidos, pois os utiliza para obter o valor que irá validar:

• _1: O valor de entrada, como uma string
• _2: Uma string com o tipo de dados do valor de entrada (o campo "Tipo" usado no formato de arquivo)
• _3: Uma string de formato do valor de entrada (o campo "Formato" conforme usado no Formato de Arquivo)

Veja o ArgumentList função para obter mais informações sobre como os valores são passados usando o _n sintaxe.

Operadores e Valores de Comparação

Dependendo do tipo de dados passados para o script chamado, diferentes operadores e valores de comparação podem ser usados. Em todos os casos, pode ser usada uma expressão regular que segue o Aprimorar a sintaxe da biblioteca de expressões regulares. É uma variação da sintaxe da expressão regular Perl.

Valores de Comparação de Datas

Para datas, esses valores de comparação podem ser usados, além das próprias datas. Observe que algumas variações usam um parâmetro inteiro para indicar uma quantidade.

Exemplos

Você pode usar esta função em um script ou mapeamento. Primeiro, crie um script ("ValWrap") que envolva o Validate função para que as variáveis locais necessárias sejam preenchidas:

<trans>
// This code could be a script called
// "ValWrap". It would be called from
// another script or mapping.

// Argument List:
// _1 (input_string_value), _2 (data_type),
// _3 (format) _4 (comparison operator),
// _5 (comparison value), _6 (ignore case)

Validate(_4, _5, _6);
</trans>

Em seguida, chame o script wrapper de outro script (ou mapeamento) para usar seu Validate função:

// This code calls a wrapper script to access
// the Validate function.
// Wrapper Argument List:
// _1 (input_string_value), _2 (data_type),
// _3 (format), _4 (comparison operator),
// _5 (comparison value), _6 (ignore case)

// Validation of a Date
a1 = Date(CVTDate("02192018", "mmddyyyy", "yyyy-mm-dd HH:MM:SS"));
a2 = "Date";
a3 = ""; // Format not required if a Date passed
a4 = "=";
a5 = "THIS_QUARTER";
a6 = "true";
resultA = RunScript("<TAG>script:ValWrap</TAG>",
    a1, a2, a3, a4, a5, a6);

// Validation of a String Date
b1 = "02192018";
b2 = "Date";
b3 = "mmddyyyy";
b4 = "=";
b5 = "THIS_QUARTER";
b6 = "true";
resultB = RunScript("<TAG>script:ValWrap</TAG>",
    b1, b2, b3, b4, b5, b6);

// Validation of an Integer
c1 = 100;
c2 = "Integer";
c3 = "";
c4 = ">";
c5 = 1000;
c6 = "true";
resultC = RunScript("<TAG>script:ValWrap</TAG>",
    c1, c2, c3, c4, c5, c6);