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.

Sintaxe

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

Parâmetros

...

Nome

...

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.

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

Exemplo:

Bloco de código

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