Funções de Acesso a Banco de Dados/SQL no Protheus

Pesquisando um Registro de um Alias/Tabela com DBSeek em ADVPL

Pesquisando um Registro de um Alias/Tabela com DBSeek em ADVPL

2 minutos A função DBSeek em ADVPL pesquisa um registro de um alias/tabela ativo, com as informações especificadas na chave de busca, fornecendo um retorno lógico indicando se a pesquisa foi efetuada com sucesso, ou seja, se a informação especificada na chave de busca foi localizada na área de trabalho. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: DBSeek(cExpr,lPos)   Parâmetro(s): Retorno:     Exemplo da função DBSeek em ADVPL:     É Continue lendo

Definindo e Ordenando um Indíce de um Alias/Tabela Ativo com DBSetOrder em ADVPL

Definindo e Ordenando um Indíce de um Alias/Tabela Ativo com DBSetOrder em ADVPL

2 minutos A função DBSetOrder em ADVPL define e ordena o índice será utilizado por um alias/tabela ativo, ou seja, pela área previamente selecionada através da função DBSelectArea. As ordens disponíveis no ambiente Protheus são aquelas definidas na SIX(Índice das Tabelas) ou as ordens disponibilizadas por meio de índices temporários. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: DBSetOrder(nOrdem)   Parâmetro(s): Observações: Esta ordem é a responsável pela sequência lógica dos registros Continue lendo

Selecionando um Alias/Tabela com DBSelectArea em ADVPL

Selecionando um Alias/Tabela com DBSelectArea em ADVPL

3 minutos A função DBSelectArea em ADVPL seleciona um alias/tabela ou área de trabalho especificada, deixando ela como ativa para manipularmos seus registros. Todas as operações subsequentes que fizerem referência a uma área de trabalho a utilização, a menos que a área desejada seja informada explicitamente. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: DBSelectArea(xArea)   Parâmetro(s): Observações: xArea pode ser do tipo numérico, indicando o número da área de trabalho, ou do tipo caractere, Continue lendo

Protegendo os Dados de um Alias/Tabela com GetArea em ADVPL

Protegendo os Dados de um Alias/Tabela com GetArea em ADVPL

1 minuto A função GetArea em ADVPL é utilizada para proteger um alias/tabela no momento de algum processamento específico para salvar uma outra área de trabalho(alias) que não o ativo. Essa função deve ser executada dentro do alias: ALIAS->(GetArea()). Esse ambiente protegido é restaurado utilizando a função RestArea. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: GetArea()   Parâmetro(s): Nenhum. Retorno(s):   Exemplo da função GetArea em ADVPL: Suponhamos que o ambiente ativo Continue lendo

Como Executar Queries com os Comandos BeginSQL e EndSQL

Como Executar Queries com os Comandos BeginSQL e EndSQL

2 minutos Olá, no post de hoje iremos ver como executar query Embedded SQL(SQL integrado ou embutido) utilizando o comandos BeginSQL EndSQL no ADVPL.  Muitas vezes como forma de facilitar o desenvolvimento de querys no Protheus utilizamos o que chamamos de Embedded SQL, que são querys SQL embutidas no código ADVPL. Um dos comandos utilizados para isso é o BeginSQL EndSQL conforme veremos. Sintaxe: BeginSQL “SUA_TABELA”   //Comandos SQL   EndSQL    Exemplo básico de BeginSQL e EndSQL: Características dos comandos de instruções acima: Exemplo Continue lendo

Como Executar Stored Procedure com TCSPExec no ADVPL

Como Executar Stored Procedure com TCSPExec no ADVPL

1 minuto Olá, no post de hoje iremos aprender como executar stored procedure com TCSPExec no ADVPL. Stored procedure são um conjunto de comandos SQL que podemos criar e armazenar no banco de dados para serem executadas a qualquer momento por programas externos. Em um exemplo mais objetivo, stored procedure são funções que criamos que contém comandos SQL e assim podemos chamar essas funções para execução desses comandos SQL. No nosso exemplo nesse post a função TCSPExec em ADVPL executa uma stored procedure definida. Continue lendo

Executando Instruções SQL Direto no Banco de Dados com TCSQLExec em ADVPL

Executando Instruções SQL Direto no Banco de Dados com TCSQLExec em ADVPL

2 minutos   A função TCSQLExec em ADVPL é usada para executar instruções SQL diretas (como SELECT, INSERT, UPDATE, DELETE) em bancos de dados compatíveis com o TopConnect (como SQL Server, Oracle, PostgreSQL, etc.). Ela é uma das funções de acesso e manipulação de banco de dados no Protheus e tem por objetivo executar uma instrução de sintaxe SQL(Structured Query Language) diretamente no banco de dados em que está conectado.   Sintaxe: TCSQLExec(<cQuery>)   Parâmetro(s):   Retorno:     Exemplo da função TCSQLExec em Continue lendo

Obtendo Informações da Última Query Executada com GetLastQuery em ADVPL

Obtendo Informações da Última Query Executada com GetLastQuery em ADVPL

2 minutos A função GetLastQuery() em ADVPL a última query executada via BeginSql / EndSqldentro do desenvolvimento de querys no TOTVS Protheus.  Muitas vezes como forma de facilitar o desenvolvimento de querys no Protheus utilizamos o que chamamos de Embedded SQL, que são querys SQL embutidas no código ADVPL, no entanto quando vamos depurar um código ADVPL que tenha essas características não é possível colocar pontos de paradas entre as instruções BeginSQL e EndSQL, assim não conseguiremos obter a consulta SQL que foi montada Continue lendo

Verificando se o Posicionamento dos Registros de um Alias/Tabela está no Início com BoF em ADVPL

Verificando se o Posicionamento dos Registros de um Alias/Tabela está no Início com BoF em ADVPL

1 minuto A função BoF em ADVPL verifica se o posicionamento dos registros está no início do alias/tabela ativo. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: Bof()   Parâmetro(s): Nenhum. Retorno:     Exemplo da função BoF em ADVPL: Enquanto não tiver no primeiro registro da tabela SA1 a contagem dos registros vai sendo feita.     É isso aí, finalizamos aqui mais um post no Blog ProtheusAdvpl. Caso tenha ficado Continue lendo

Posicionando no Primeiro Registro de um Alias/Tabela com DBGoTop em ADVPL

Posicionando no Primeiro Registro de um Alias/Tabela com DBGoTop em ADVPL

2 minutos A função DBGoTop em ADVPL posiciona no primeiro registro lógico da tabela corrente. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: DBGoTop()   Parâmetro(s): Nenhum. Observações: A sequência lógica depende da ordem e do filtro ativo na tabela corrente. Portanto, o primeiro registro lógico pode não ser o primeiro registro físico. Exemplo da função DBGoTop em ADVPL: Vamos supor que nós tenhamos 5 registros na tabela SA2(Fornecedores) do TOTVS Protheus conforme Continue lendo

Retornando Alias de uma Tabela com Alias em ADVPL

Retornando Alias de uma Tabela com Alias em ADVPL

2 minutos A função Alias em ADVPL retorna o alias (Ex.:”SA1″) de uma tabela ou área de trabalho especificada no parâmetro nArea. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: Alias(nArea)   Parâmetro(s): Retorno(s):     Observações: Alias é uma função de banco de dados utilizada para determinar o alias da área de trabalho especificada. Alias é o nome atribuído a uma área de trabalho quando um arquivo de banco de dados está Continue lendo

Verificando se um Alias/Tabela Está Aberto com Select

Verificando se um Alias/Tabela Está Aberto com Select

2 minutos A função Select em ADVPL verifica de um alias/tabela está aberto para uso. Se tiver ela retorna um número que pode variar de 0(zero) a 250. Se não for especificado, é retornado o número do Alias/Tabela corrente. Caso seja especificado e o alias não existir, Select retorna zero. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: Select(cAlias)   Parâmetro(s): Retorno:   Observações: Essa função é muito útil em situações onde Continue lendo