Histórico da Página

Gera novo Retorna o token de acesso para uma determinada URL e retorna o link completo acrescido do token geradode acordo com os parâmetros cadastrados em sua geração.

Nota

title	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

Bloco de código
RFI_newToken( < l_url >getTokenByParameters( ) => CHAR

Parâmetros

...

Tipo

...

Obrigatório?

...

Descrição

...

l_url

...

CHAR

...

Sim

...

Link completo (Protocolo + URL) OU Nome do recurso (URN) para geração de novo link de acesso ao sistema através de Token.

Veja informações adicionais em Observações.

Retorno

Tipo

Descrição

CHAR

Código do token de acesso gerado para o link ou recurso passado como parâmetro.

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

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

FUNCTION RFI_newTokengetTokenByParameters_test()
  DEFINE l_token          CHAR(36)
  DEFINE l_url            CHAR(250)
  DEFINE l_urlAccessToken CHAR(300)
 
  LET l_url     = "https://www.empresaAcesso.com.br/logix/sup/cotacaoPreco.aph"
 
  CALL RFI_clearParameters() 
  CALL RFI_addParameter("item","A001X40")
 
  LET l_token = RFI_newTokengetTokenByParameters(l_url)
  IF l_token <> " " THEN
 
      LET l_urlAccessToken = RFI_getURLAccessByToken(l_token)
      IF l_urlAccessToken IS NULL THEN 
         CALL conout("RFI - Falha ao gerarrecuperar linko de acessotoken. Motivo: "||RFI_getErrorMessage())
      ELSE
         CALL conout("RFI - Link de acesso geradoToken: "||l_urAccessTokentoken CLIPPED)
      END IF
  END IF
END FUNCTION

Informações

Fonte: rfi.4gl

...

Observações

A ordem para utilizar a pesquisa criação

...

Na geração de um novo link de acesso , o parâmetro poderá ser informado de 2 formas distintas:

...

[URN - nome recurso]

Quando não for informados o protocolo e URL no conteúdo inicial, o link com o token de acesso considera o protocolo e URL Base configurados na chave de profile logix.rfi.URLBase.

...

[protocolo] + [URL - localização recurso] + [URN - nome recurso]

Quando informados o protocolo e URL no conteúdo inicial, o link com o token de acesso assumirá a URL base informada.

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

Nota

title	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.

Bloco de código

language	ruby
theme	Confluence
title	EXEMPLO
linenumbers	true

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