FUNCIóNEn revisión

XFILIAL()

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

Obtiene filial de tabla según configuración de compartición.

XFILIAL()AdvPL

01 · DESCRIPCIÓN GENERAL

Descripción general

xFilial considera compartición SX2. Puede retornar filial aplicable o espacios, incluso por nivel de empresa; no equivale simplemente a cFilAnt. Omitir cAlias usa área actual; omitir cFil usa cFilAnt. Ejemplos históricos tienen anchos distintos: no fije dos espacios en instalaciones actuales. Adaptación consulta SB1 explícitamente sin buscar registros ni cambiar empresa. (Fuentes: refs. 1–2.)

02 · SINTAXIS

Sintaxis

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

Parámetros

cAlias

CarácterOpcional

Tabla; por defecto área actual.

cFil

CarácterOpcional

Filial de referencia; por defecto cFilAnt.

Retorno

Carácter con representación de filial de tabla.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed733()
    // Requiere contexto Protheus inicializado y diccionario SB1 válido.
    Local cFilial := xFilial("SB1")
    // Participa en claves; no aplicar AllTrim para búsquedas.
    ConOut(ValType(cFilial))
Return Nil

Resultado esperado

Muestra C; contenido y ancho dependen de configuración. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS

Resuelva filial por tabla incluso en joins. No sustituye autorización, filtro de exclusión ni clave completa.
En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS

Estado: En revisión
Página creada el: 28/10/2026 a las 10:40
Última revisión el: 28/10/2026 a las 10:40
Idioma original: Portugués
Revisión: Usina.BR