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