Sumário
< Todos os tópicos
Imprimir

Gestão de consultas

Consulta dinâmica personalizada

Permite que o usuário possa consultar qualquer informação do sistema, sem amarras, atendendo necessidades para a coleta de dados e construção de massa de dados para planilhas.

A consulta dinâmica é baseada em instruções do tipo SQL Ansi, permitido acesso à quaisquer recursos disponíveis no banco de dados, com a devida permissão, para a confecção de uma instrução para retorno de dados.

Dica!

A consulta dinâmica consegue utilizar o padrão SQL do PostgreSQL.

    Variáveis especiais

    A consulta dinâmica permite o uso de variáveis especiais do próprio sistema, para facilitar e otimizar o tempo de espera para o retorno da informação.

    As variáveis especiais devem ser usadas exatamente como são descritas abaixo, incluindo a diferenciação entre maiúscula e minúscula.

    Informações do sistema

    Permite identificar informações gerais do sistema.

    VariávelResumo
    :pIdPeriodoApuracaoRecupera a identificação única do período selecionado

    Exemplo de uso:

    select :pIdPeriodoApuracao;

    Informações do usuário logado

    Permite identificar informações sobre o usuário logado no sistema.

    VariávelResumo
    :pUsuarioNomeRecupera o nome do usuário logado
    :pUsuarioEmailRecupera o email do usuário logado

    Exemplo de uso:

    select :pUsuarioNome, :pUsuarioEmail;

    Informações da empresa selecionada

    Permite identificar informações sobre a empresa atualmente selecionada no sistema.

    VariávelResumo
    :pEmpresaTipoInscricaoRecupera o tipo de inscição da empresa
    :pEmpresaInscricaoRecupera a inscrição da empresa
    :pEmpresaRazaoRecupera a razão social da empresa
    :pEmpresaFantasiaRecupera o nome de fantasia da empresa
    :pEmpresaClassTribRecupera a classificação tributária da empresa
    :pEmpresaNaturezaRecupera a natureza jurídica da empresa
    :pEmpresaCnpjEnteRecupera o CNPJ do Ente Federativo1 da empresa

    Exemplo de uso:

    select :pEmpresaInscricao, :pEmpresaRazao;

    Funções de transformação / conversão

    A consulta dinâmica permite o uso de diversas funções para converter ou transformar determinados valores.

    Funções de transformação

    Permite transformar um determinado conteúdo, como aplicar máscaras, formatar endereços e etc.

    Função

    Descrição

    Exemplos de uso

    fmtCaepf( text ) → text

    Aplica a máscara padrão para um nº de CAEPF válido

    select fmtCaepf( ‘00000000000000’ ); → 000.000.000/000-00

    fmtCbo( text ) → text

    Aplica a máscara padrão para um nº de CBO válido

    select fmtCbo( ‘000000’ ); → 0000-00

    fmtNis( text ) → text

    Aplica a máscara padrão para um nº de NIS válido

    select fmtNis( ‘00000000000’ ); → 000.00000.00-0

    fmtCno( text ) → text

    Aplica a máscara padrão para um nº de CNO válido

    select fmtCno( ‘000000000000’ ); → 00.000.00000/00

    fmtCei( text ) → text

    Aplica a máscara padrão para um nº de CEI válido

    select fmtCei( ‘000000000000’ ); → 00.000.00000/00

    fmtInscricao( text, text, bool ) → text

    Aplica a máscara padrão para um nº de inscrição válido, de acordo com o tipo

    select fmtInscricao( ‘1’, ‘00000000000000’, false ); → 00.000.000/0000-00

    select fmtInscricao( ‘2’, ‘00000000000’, true ); → CPF: 000.000.000/00

    capitalizar( text ) → text

    Capitaliza o caractere inicial, convertendo para maiúsculo

    select capitalizar( ‘acesseRH’ ); → ‘AcesseRH’

    fmtCep( text ) → text

    Aplica a máscara padrão para um nº de CEP válido

    select fmtCep( ‘00000000’ ); → 00.000-000

    fmtCnae( text ) → text

    Aplica a máscara padrão para um nº de CNAE válido

    select fmtCnae( ‘0000000’ ); → 0000.0/00

    fmtCnpj( text ) → text

    Aplica a máscara padrão para um nº de CNPJ válido

    select fmtCnpj( ‘00000000000000’ ); → 00.000.000/0000-00

    fmtCpf( text ) → text

    Aplica a máscara padrão para um nº de CPF válido

    select fmtCpf( ‘00000000000’ ); → 000.000.000-00

    fmtFone( text ) → text

    Aplica a máscara padrão para um nº de telefone válido, com 10 ou 11 dígitos

    select fmtFone( ‘00000000000’ ); → (00) 00000-0000

    select fmtFone( ‘0000000000’ ); → (00) 0000-0000

    fmtEndereco( text, text, text, text, text, text, text, text ) → text

    Criar padrão de retorno para os dados do endereço. Os parâmetros devem seguir a ordem definida abaixo:

    1. Tipo de logradouro
    2. Logradouro
    3. Nº do endereço
    4. Complemento
    5. Nº do CEP
    6. Bairro
    7. Município
    8. Estado

    select fmtEndereco( ‘R’, ‘Dois’, ’99’, ‘CASA’, ‘50000000’, ‘Alvêz’, ‘Recife’, ‘PE’ );
    → R Dois, 99, CASA, CEP 50.000-000, Alvêz, Recife/PE

    👍 Todos os exemplos deste documento podem ser utilizados, como estão, para testes reais!

    Funções de conversão

    Permite converter determinados valores.

    Função

    Descrição

    Exemplos de uso

    fmtSimNao( bool ) → text

    Converte valor lógico para o seu correspondente textual

    select fmtSimNao( true ); → Sim

    👍 Todos os exemplos deste documento podem ser utilizados, como estão, para testes reais!

    Tabelas

    Tipos de inscrições

    TipoDescrição
    1Inscrição tipo CNPJ
    2Inscrição tipo CPF
    3Inscrição tipo CAEPF
    4Inscrição tipo CNO
    5Inscrição tipo CGC
    6Inscrição tipo CEI

    1. CNPJ do Ente Federativo é uma informação exclusiva para Órgãos Públicos. ↩︎