RFI_newToken

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

Sintaxe

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

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 do token. Neste caso faça uso da função RFI_getErrorMessage para recuperar o motivo do erro.

Exemplo

FUNCTION RFI_newToken_test()
  DEFINE l_token          CHAR(36)
  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_token = RFI_newToken(l_url)
  IF l_token <> " " THEN
 
      LET l_urlAccessToken = RFI_getURLAccessByToken(l_token)
      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
  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_token = RFI_newToken(l_url)
  IF l_token <> " " THEN
      LET l_urlAccessToken = RFI_getURLAccessByToken(l_token)
      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
  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_getURLAccessByToken

Páginas filhas