O que é a função GETNEWPAR()

A função GETNEWPAR() é utilizada para buscar o conteúdo de um parâmetro no arquivo SX6, respeitando a filial da conexão ativa no Protheus. Ela retorna o valor do parâmetro se encontrado, ou aplica um conteúdo padrão caso o parâmetro não exista.

Sintaxe da função

Descrição dos parâmetros

• <nome do parâmetro>: Nome do parâmetro no SX6, sem a especificação da filial.
• <conteúdo padrão>: Valor que será retornado caso o parâmetro não seja localizado no SX6.
• <Filial> (opcional): Código da filial a ser considerada. Se não informado, será usada a filial atual da conexão.

Comportamento da função

Ao utilizar GETNEWPAR(), será considerada a filial ativa no momento da execução. Se o parâmetro não estiver cadastrado, o sistema exibe uma mensagem de help indicando a ausência do parâmetro no SX6.

Esse comportamento é diferente da função SuperGetMv(), que não exibe mensagem ao não encontrar o parâmetro — retornando simplesmente o valor padrão.

Exemplo de utilização

Imagine que o parâmetro MV_DIAS não existe na base de dados:

Como o parâmetro não está presente no SX6, o valor da variável nDias será 45. Se o parâmetro existisse com o valor 30, o retorno seria esse valor em vez do padrão.

Código completo fornecido

Retorna o conteúdo do parâmetro especificado no Arquivo SX6, considerando a filial parametrizada na conexão.

Conclusão

A função GETNEWPAR() é essencial para desenvolvedores ADVPL que precisam garantir o uso de parâmetros de forma segura e contextualizada por filial no Protheus. Usá-la corretamente ajuda a evitar erros de configuração e permite fallback automático para valores padrão.