RFI_newURLAccessToken

Gera novo token de acesso para uma determinada URL e retorna o link completo acrescido do token gerado.

Sintaxe

RFI_newURLAccessToken( < 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 (Neste caso é um caminho relativo sem constar a BaseURL no início).

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

Retorno

Tipo

Descrição

CHAR

Link de acesso completo ao sistema, acrescido do parâmetro com o código do token de acesso.

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

Exemplo

FUNCTION RFI_newURLAccessToken_test()
  DEFINE l_url            CHAR(250)
  DEFINE l_urlAccessToken CHAR(300)

  #Caminho completo para acessar o recurso em portal WEB
  #Neste caso a BASE URL está incluida e ficará fixa na base de dados.
  LET l_url     = "https://www.empresaAcesso.com.br/logix/ecotacao/cotacaoPreco.aph"
  
  CALL RFI_clearParameters()
  CALL RFI_addParameter("item","A001X40")
  
  LET l_urlAccessToken = RFI_newURLAccessToken(l_url)
  IF l_urlAccessToken IS NULL THEN
     CALL conout("RFI - Falha ao gerar link de acesso. Motivo: "||RFI_getErrorMessage())
  ELSE
     CALL conout("RFI - Link de acesso gerado com BASE URL fixada no link de geração do Token: "||l_urAccessToken CLIPPED)
  END IF
 

  #Caminho relativo para acessar o recurso em portal WEB
  #Neste caso a BASE URL não é armazenada na base e irá ser acrescida automaticamente pela URL BASE configurada na chave de profile "logix.rfi.baseURL" no momento da recuperacao da URL.
  LET l_url     = "/ecotacao/cotacaoPreco.aph"
  
  CALL RFI_clearParameters()
  CALL RFI_addParameter("item","A001X40")
  
  LET l_urlAccessToken = RFI_newURLAccessToken(l_url)

  IF l_urlAccessToken IS NULL THEN
     CALL conout("RFI - Falha ao gerar link de acesso. Motivo: "||RFI_getErrorMessage())
  ELSE
     CALL conout("RFI - Link de acesso gerado com BASE URL setado no profile: "||l_urAccessToken CLIPPED)
  END IF


  ##Neste caso deseja fixar um base URL diferente do que pode estar setado no arquivo de profile do appserver
  CALL RFI_setBaseURL("https://www.empresaAcesso.com.br/logix")

  #Caminho relativo para acessar o recurso em portal WEB
  #Neste caso a BASE URL não é armazenada na base e irá ser acrescida automaticamente pela URL BASE configurada na chave de profile "logix.rfi.baseURL" no momento da recuperacao da URL.
  LET l_url     = "/ecotacao/cotacaoPreco.aph"
  
  CALL RFI_clearParameters()
  CALL RFI_addParameter("item","A001X40")
  
  LET l_urlAccessToken = RFI_newURLAccessToken(l_url)

  IF l_urlAccessToken IS NULL THEN
     CALL conout("RFI - Falha ao gerar link de acesso. Motivo: "||RFI_getErrorMessage())
  ELSE
     CALL conout("RFI - Link de acesso gerado com BASE URL fixada no programa: "||l_urAccessToken CLIPPED)
  END IF
END FUNCTION

Informações

Fonte: rfi.4gl

Observações

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.

Veja também

RFI - Chaves de profile

Páginas filhas