XFILIAL()

Sintaxe

XFILIAL( <cAlias> )

Propósito

Retorna a filial utilizada por um determinado arquivo e na qual o usuário se logou no sistema.

Argumentos

<cAlias>

Define o alias do arquivo cuja filial será obtida. Se não for especificado, o arquivo tratado será o da área de trabalho corrente.

Utilização

Essa função é utilizada para permitir que pesquisas e consultas em arquivos trabalhem somente com os dados da filial corrente, dependendo, é claro, se o arquivo está compartilhado ou exclusivo (definição realizada no módulo Configurador – Dicionários de Dados (SX2)).

É importante salientar que essa função não tem como objetivo retornar apenas a filial corrente, mas retorná-la caso o arquivo seja exclusivo. Se o arquivo estiver compartilhado, a função retornará dois espaços em branco.

Exemplos

Nesse exemplo, a função POSICIONE() pesquisa o arquivo SB1, na ordem 1, para retornar o conteúdo do campo B1_DESC. Essa função utiliza a função XFILIAL() para obter a filial corrente.

LOCAL cDesc := “”

cDesc := POSICIONE(“SB1”, 1, xFilial(“SB1”) + AB2->AB2_CODPRO, “B1_DESC”)