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)

  LET l_url     = "https://www.empresaAcesso.com.br/logix/sup/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: "||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