Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

PUTMV()

PutMV(cParametro,xConteudo,[lErro])

Atualiza um parâmetro existente da SX6.

PUTMV()AdvPL
01 · VISÃO GERAL

Visão geral

O TDN informa que PutMV considera a filial da conexão e espera um parâmetro já existente; não recebe a filial junto ao nome. O terceiro argumento controla apresentação do erro quando não consegue atualizar por falta de acesso exclusivo. O exemplo comunitário mostra PutMV e PutMvFil, mas não devemos alterar parâmetros operacionais para demonstrar a API. O bloco usa um nome fictício que deve ser criado e homologado em ambiente de teste; não é invocado. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

PutMV(cParametro,xConteudo,[lErro])

Parâmetros

cParametro
CaractereObrigatório

Nome existente na SX6, sem filial.

xConteudo
Conforme parâmetroObrigatório

Valor compatível com a definição SX6.

lErro
LógicoOpcional

Apresenta erro se .T., padrão documentado; .F. retorna falha sem essa apresentação.

Retorno

Falha retorna .F. segundo TDN; exemplo comunitário descreve .T. no sucesso.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed608()
    // MV_X_ED608 precisa existir no laboratorio; bloco nao invocado.
    Local bAlterar := {|xValor| PutMV("MV_X_ED608",xValor,.F.)}
    ConOut(ValType(bAlterar))
Return Nil
Resultado esperado

Cria bloco B; não altera SX6 e não cria o parâmetro. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Confirmar tipo, filial, permissão, acesso exclusivo e efeito funcional. Não registrar conteúdo sensível de parâmetros.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. PutMV. TDN. Consulta em 2026-10-27.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_396_Funcoes_PutMV_e_PutMvFil.prw. Arquivo completo consultado; adaptação editorial. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha