📂 dbUseArea – Abre uma tabela em uma área de trabalho
A função dbUseArea é utilizada para abrir tabelas em uma área de trabalho no AdvPL, permitindo manipular dados via RDDs locais ou banco de dados. É uma das rotinas mais importantes para acesso a tabelas no Protheus. 🔧📑
Descrição
| Abre uma tabela de dados na área de trabalho atual ou em uma nova área disponível. Permite definir driver (RDD), alias, modo de leitura e compartilhamento. |
Sintaxe
| dbUseArea( <lNovaArea>, <cDriver>, <cTabela>, <cAlias>, <lCompartilhado>, <lSomenteLeitura> ) |
Parâmetros
| Par |
Nome |
Tipo |
Descrição |
Default |
Obg |
Ref |
| 01 |
lNovaArea |
Boolean |
Se verdadeiro, abre a tabela em uma nova área de trabalho |
.F. |
|
|
| 02 |
cDriver |
Caracter |
Driver (RDD) utilizado para abrir a tabela |
__LOCALDRIVE |
|
|
| 03 |
cTabela |
Caracter |
Nome ou caminho completo da tabela |
|
X |
|
| 04 |
cAlias |
Caracter |
Alias que será usado para acessar a tabela |
|
X |
|
| 05 |
lCompartilhado |
Boolean |
Se verdadeiro, abre a tabela em modo compartilhado |
|
|
|
| 06 |
lSomenteLeitura |
Boolean |
Se verdadeiro, permite apenas leitura |
|
|
|
Retorno
| Retorno |
Tipo |
Descrição |
| — |
— |
A função não retorna valor. Verifique NetErr() após a abertura. |
Exemplo
#INCLUDE "TOTVS.CH"
User Function dbUseArea()
dbUseArea( .T., 'TOPCONN', RetSqlName("SA1"), "SA1_UA", .T., .F. )
If Select("SA1_UA") > 0
MsgInfo( SA1_UA->A1_COD + ' - ' + SA1_UA->A1_LOJA, 'UniversoADVPL' )
Else
MsgInfo( 'Erro ao selecionar área', 'UniversoADVPL' )
Endif
Return( Nil )
Resultado
Informações adicionais
Verifique sempre NetErr() após executar dbUseArea(). Se a tabela não existir ou houver problema de permissão, o driver retornará erro crítico AdvPL.
RDDs suportados:
CTREECDX – c-tree
DBFCDX – local (padrão)
DBFCDXADS – ADS Local
DBFCDXAX – ADS Server
DBFCDXTTS – compatível com DBFCDX
TOPCONN – banco de dados relacional
SQLITE_SYS / SQLITE_TMP / SQLITE_MEM – SQLite |
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎
Um abraço, e até a próxima! 👋
#advpl #totvs #protheus #dbusearea #topconn #frameworktotvs #database #tabelas #universodesenvolvedor
