RFI_getTokenByParameters

Retorna o token de acesso de acordo com os parâmetros cadastrados em sua geração.

ATENÇÃO

Para correto uso desta função ela precisa ter chamadas das funções RFI_clearParameters e RFI_addParameter para montar o filtro de pesquisa do Token desejado.

Acesse o código de exemplo abaixo disponível para maiores esclarecimentos.

Sintaxe

RFI_getTokenByParameters( ) => CHAR

Retorno

Tipo

Descrição

CHAR

Código do token de acesso.

Quando o conteúdo retornado for NULL, indica que houve algum erro na recuperação do token. Neste caso faça uso da função RFI_getErrorMessage para verificar o motivo do erro.

Exemplo

FUNCTION RFI_getTokenByParameters_test()
  DEFINE l_token          CHAR(36)
 
  CALL RFI_clearParameters() 
  CALL RFI_addParameter("item","A001X40")
 
  LET l_token = RFI_getTokenByParameters()
  IF l_token IS NULL THEN 
     CALL conout("RFI - Falha ao recuperar o token. Motivo: "||RFI_getErrorMessage())
  ELSE
     CALL conout("RFI - Token: "||l_token CLIPPED)
  END IF  
END FUNCTION

Informações

Fonte: rfi.4gl

Observações

A ordem para utilizar a pesquisa criação de um novo link de acesso RFI sempre terá a seguinte ordem de chamada de funções:

1
2
3
4
5
6
7
8

# Limpar lista de parâmetros
CALL RFI_clearParameters()

# Definição de parâmetros
CALL RFI_addParameter( [< nome_parametro1> ], [ < valor_parametro1 > ] )

...

CALL RFI_addParameter( [< nome_parametroN > ], [ < valor_parametroN > ] )

# Retorna (caso possível) o token de acordo com os parametros
LET l_url = RFI_getTokenByParameters( )

Importante

A pesquisa pelo token considera a ordem dos parâmetros adicionados, sempre respeitando a lista completa dos parametros utilizado no momento da sua geração, para realizar busca de um token único ativo na base, caso contrário correrá risco de detectar mais de um token, invalidando o retorno da função.

EXEMPLO

# Cadastra o token
...
   CALL RFI_clearParameters() 
   CALL RFI_addParameter("item1","A001X41")
   CALL RFI_addParameter("item2","A001X42")
   CALL RFI_addParameter("item3","A001X43")
   CALL RFI_addParameter("item4","A001X44")
...
   CALL RFI_addParameter("itemN","A001X4N")
   LET l_token = RFI_newToken("https://www.empresaAcesso.com.br/logix/sup/cotacaoPreco.aph")

# Resgata o token com todos os parâmetros utilizados no seu cadastro/geração.
...
   CALL RFI_clearParameters() 
   CALL RFI_addParameter("item1","A001X41")
   CALL RFI_addParameter("item2","A001X42")
   CALL RFI_addParameter("item3","A001X43")
   CALL RFI_addParameter("item4","A001X44")
   LET l_token = RFI_getTokenByParameters()
...

Veja também

RFI_clearParameters

RFI_addParameter

RFI_getErrorMessage

Páginas filhas