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

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(  )

A pesquisa pelo token considera a ordem dos parâmetros adicionados.

Não é obrigatório informar todos os parâmetros caso a busca seja suficiente para retornar um token ativo único.

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
...
   CALL RFI_clearParameters() 
   CALL RFI_addParameter("item1","A001X41")
   CALL RFI_addParameter("item2","A001X42")
   CALL RFI_addParameter("item3","A001X43")
   LET l_token = RFI_getTokenByParameters()
...

Veja também

RFI_clearParameters

RFI_addParameter

RFI_getErrorMessage