Usina BRAdvPL Guia
Entrar
← Todos os tópicos
GUIA PRÁTICOEm revisão

RetSqlName e nomes físicos de tabelas

Resolve o nome SQL sem fixar sufixos de empresa.

RetSqlName e nomes físicos de tabelasAdvPL
01 · VISÃO GERAL

Visão geral

RetSqlName recebe o alias lógico do dicionário e retorna o nome físico configurado. Não basta concatenar 010 ao alias: a configuração da empresa pode ser diferente. Resolver nome não adiciona filtros de filial, exclusão lógica ou autorização. Em joins, calcule xFilial para cada tabela, sem igualar filiais de tabelas com compartilhamentos diferentes. O exemplo retorna somente o nome de SB1; requer ambiente preparado e não executa consulta. Para valores de entrada, use parâmetros vinculados conforme a API SQL disponível. (Fontes: refs. 1–2.)

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed628()
    // Bloco nao invocado; exige ambiente com dicionario disponivel.
    Local bNome := {|| RetSqlName("SB1")}
    ConOut(ValType(bNome))
Return Nil
Resultado esperado

Cria bloco B; não presume SB1010 nem lê produtos. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Nomes físicos não devem vir de entrada livre do usuário. Resolver tabela não concede permissão sobre seus registros.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Desenvolvendo queries no Protheus. Consulta em 2026-10-27.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_421_Funcao_RetSQLName.prw. Arquivo completo consultado; adaptação editorial. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha