Disponibilidade
Classe disponível a partir da lib 20180912
Classe responsável pelo acesso ao dicionário SX2.
Métodos:
GetFile()
Sintaxe:
FWSX2Util():GetFile( cAlias ) → cFile
Descrição:
Retorna o arquivo da SX2
Parâmetros:
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
cAlias | Caracter | Nome do alias da tabela | X |
Retorno:
cFile - Caracter - Arquivo da tabela no SX2
Exemplo:
cFile := FWSX2Util():GetFile( "SA1" )
GetPath()
Sintaxe:
FWSX2Util():GetPath( cAlias ) → cPath
Descrição:
Retorna o path da SX2
Parâmetros:
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
cAlias | Caracter | Nome do alias da tabela | X |
Retorno:
cPath - Caracter - Path da tabela na SX2
Exemplo:
cPath := FWSX2Util():GetPath( "SED" )
GetX2Module()
Sintaxe:
FwSX2Util():GetX2Module( cAlias , lSeekByFile ) → nModule
Descrição:
Recupera o número do módulo da tabela no SX2
Este método está disponível a partir do Label 20190131 da LIB Protheus.
Parâmetros:
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
cAlias | Caracter | Indica qual a tabela a ser pesquisada | X |
lSeekByFile | Lógico | Define se a busca deve acontecer pela coluna X2_ARQUIVO (.T.) ou pela coluna de alias padrão (.F.) | conteúdo default .F. |
Retorno:
nModule - Numérico - Valor do campo X2_MODULO da tabela pesquisada.
Exemplo:
nModSA1 := FwSX2Util(): GetX2Module( "SA1" )
nModSE2 := FwSX2Util(): GetX2Module( "SE2990", .T. )
GetX2Name()
Sintaxe:
FwSX2Util():GetX2Name( cAlias , lSeekByFile ) → cName
Descrição:
Recupera a descrição da tabela no SX2
Parâmetros:
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
cAlias | Caracter | Indica qual a tabela a ser pesquisada | X |
lSeekByFile | Lógico | Define se a busca deve acontecer pela coluna X2_ARQUIVO (.T.) ou pela coluna de alias padrão (.F.) | conteúdo default .F. |
Retorno:
cName - Caracter - Valor do campo X2_NAME conforme o idioma do ambiente
Exemplo:
cNameSA1 := FwSX2Util():GetX2Name( "SA1" ) // Deve retornar Clientes
cNameSE2 := FwSX2Util():GetX2Name( "SE2990", .T. ) // Deve retorno títulos a pagar
GetX2SysObj()
Sintaxe:
FwSX2Util():GetX2SysObj(cAlias) → cSysObj
Descrição:
Recupera a informação do campo na tabela SX2
Parâmetros:
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
cAlias | Caracter | Indica qual a tabela a ser pesquisada | X |
Retorno:
cSysObj - Caracter - Valor do campo X2_SYSOBJ da tabela informada
Exemplo:
cSysObj := FwSX2Util():GetX2SysObj('A03')
GetX2UsrObj()
Sintaxe:
FwSX2Util():GetX2UsrObj(cAlias) → cUsrObj
Descrição:
Recupera a informação do campo na tabela SX2
Parâmetros:
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
cAlias | Caracter | Indica qual a tabela a ser pesquisada | X |
Retorno:
cUsrObj - Caracter - Valor do campo X2_USROBJ da tabela informada
Exemplo:
cSysObj := FwSX2Util():GetX2UsrObj('SA3')
GetSX2Data()
Sintaxe:
FwSX2Util():GetSX2Data(cAlias, aFields, lQuery) → aReturn
Descrição:
Retorna os campos informados da SX2, podendo retornar todos os campos
Parâmetros:
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
cAlias | Caracter | Indica qual a tabela a ser pesquisada | X |
aFields | Array | Campos que serão retornados | X |
lQuery | Lógico | Informa se faz query para retornar os dados | X |
Retorno:
aReturn - Array - Campos informados e seus valores
Exemplo:
aReturn:= FwSX2Util():GetSX2data('SA7') // Retorna os campos e valores da tabela informada
aReturn:= FwSX2Util():GetSX2data('SA7', {"X2_UNICO"}) // Retorna apenas o valor do campo informado
SeekX2File()
Sintaxe:
FwSX2Util():SeekX2File( cFile ) → lFound
Descrição:
Posiciona no SX2 conforme o nome físico informado para pesquisa
Parâmetros:
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
cFile | Caracter | Indica qual a tabela a ser pesquisada | X |
Retorno:
lFound - Lógico - Indica se conseguiu posicionar ou não no registro
Exemplo:
lFound := FwSX2Util():SeekX2File( "SE2990" )