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.

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