RFI_addParameter

Define um novo parâmetro em memória que será considerado na próxima geração de link de acesso RFI.

Em resumo, após acionar a função RFI_clearParameters, pode-se definir 1 ou mais parâmetros (1 ou mais chamadas da função RFI_addParameter), para então gerar um novo link de acesso RFI usando a função RFI_newURLAccessToken ou RFI_newToken.

Acesse a seção Observações e veja a ordem de chamada das funções RFI para ficar mais claro.

Sintaxe

RFI_addParameter( [ < l_paramName > ] , [ < l_paramValue > ] )

Parâmetros

Nome	Tipo	Obrigatório?	Descrição
l_paramName	`CHAR`	Sim	Nome do parâmetro.
l_paramValue	`CHAR`	Sim	Valor do parâmetro. Pode ser informado o valor como NULL ou " " (brancos) se houver necessidade.

Exemplo

#--------------------------------#
 FUNCTION RFI_addParameter_test()
#--------------------------------#
  DEFINE l_url            CHAR(250)
  DEFINE l_urlAccessToken CHAR(300)

  LET l_url     = "https://www.empresaAcesso.com.br/logix/sup/cotacaoPreco.aph"

  #Definindo lista de parâmetros a serem incluídos na próximo link de acesso RFI gerado.
  CALL RFI_clearParameters()  
  CALL RFI_addParameter("item","A001X40")

  #Criando novo link de acesso RFI
  LET l_urlAccessToken = RFI_newURLAccessToken(l_url)

  IF l_urlAccessToken IS NULL THEN
     CALL log0030_mensagem(RFI_getErrorMessage(),"stop")
  ELSE
     CALL log0030_mensagem("Link de acesso gerado: "||l_urlAccessToken CLIPPED,"info")
  END IF
END FUNCTION

Informações

Fonte: rfi.4gl

Observações

A ordem para criação de um novo link de acesso RFI sempre terá a seguinte ordem de chamada de funções:

# Limpar lista de parâmetros
CALL RFI_clearParameters()

# Definição de parâmetro
CALL RFI_addParameter( [< nome_parâmetro > ], [ < valor_parâmetro > ] )

# Criar novo link de acesso RFI
LET l_url = RFI_newURLAccessToken( [ < url_ou_recurso_web > ] )

Poderá ser feita criação de 1 ou mais parâmetros, desde que não exceda o limite do tamanho previsto na base de dados para armazenar a informação de parâmetros para o novo link.

Veja também

RFI_clearParameters

Páginas filhas