Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

XFILIAL()

xFilial([cAlias],[cFil]) -> cBranch

Obtém a filial da tabela conforme seu compartilhamento.

XFILIAL()AdvPL
01 · VISÃO GERAL

Visão geral

xFilial considera o compartilhamento da tabela no SX2. O valor pode ser a filial aplicável ou espaços, inclusive com compartilhamento por nível de empresa; não equivale simplesmente a cFilAnt. cAlias omitido usa a área corrente e cFil omitido usa cFilAnt. Os exemplos históricos incluem larguras diferentes: não fixar dois espaços em instalações atuais. A adaptação do exemplo de Atilio consulta explicitamente SB1, sem montar busca ou modificar o contexto de empresa. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

xFilial([cAlias],[cFil]) -> cBranch

Parâmetros

cAlias
CaractereOpcional

Tabela; padrão área corrente.

cFil
CaractereOpcional

Filial de referência; padrão cFilAnt.

Retorno

Caractere com a representação da filial aplicável à tabela.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed733()
    // Requer ambiente Protheus inicializado e dicionario SB1 valido.
    Local cFilial := xFilial("SB1")
    // O valor participa da chave; nao aplicar AllTrim para montar buscas.
    ConOut(ValType(cFilial))
Return Nil
Resultado esperado

Exibe C; o conteúdo e sua largura dependem da configuração. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Consultar a filial para cada tabela, inclusive em joins. Uma condição de filial correta não substitui autorização, filtro de exclusão e chave completa.
  • 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. XFILIAL. Compartilhamento e exemplos por nível. Consulta em 2026-10-28.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_259_Funcoes_FWxFilial_e_xFilial.prw. Arquivo completo analisado; adaptação editorial. Consulta em 2026-10-28.
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