# Edição em massa de registros

> Permite alterar de uma vez o mesmo campo em vários registros selecionados em uma lista, sem abrir um por um.

Fonte: https://docs.kmee.com.br/odoo/modulos/administracao/server-action-mass-edit/

- Módulo `server_action_mass_edit`
- Origem: OCA
- Licença AGPL-3
- Odoo 16.0, 17.0, 18.0

Permite alterar de uma vez o mesmo campo em vários registros selecionados em uma lista, sem abrir um por um. O administrador define quais campos podem ser editados e em qual modelo, e a opção aparece no menu Ação da lista. Para cada campo é possível definir um valor, limpar o valor ou, em campos de várias escolhas, adicionar e remover itens.

## Quando usar

- Atualizar um mesmo dado em muitos cadastros de uma vez, como o vendedor, a posição fiscal ou um marcador de vários clientes.
- Corrigir em lote um campo preenchido errado em uma importação.
- Oferecer a uma equipe uma edição em lote restrita a poucos campos, em vez de liberar a edição completa dos registros.
- Alterar em lote campos como imagens, cores ou campos com várias escolhas.

## Como configurar

1. Ative o modo desenvolvedor e abra Definições -> Técnico -> Ações -> Ações no Servidor.
2. Clique em Novo, dê um nome, escolha o Modelo e, em Ação a ser feita, selecione Registros de Edição em Massa.
3. Na aba Campos, adicione uma linha para cada campo que poderá ser alterado. Use a aba Mensagem para exibir uma orientação na janela de edição.
4. Se quiser limitar quem usa a ação, informe os grupos na aba Segurança.
5. Clique em Criar Ação Contextual para que a opção apareça no menu Ação das listas daquele modelo.
6. Na lista, selecione os registros, abra Ação, escolha a edição criada, defina para cada campo o que fazer e confirme em Aplicar.

## Cuidados

- A alteração vale para todos os registros selecionados. Confira a seleção e o resumo exibido na janela antes de aplicar.
- A gravação segue as permissões e validações do usuário que aplica a edição.
- Ao marcar Aplicar Domínio em um campo cuja lista de opções depende de outros campos, inclua também esses campos na mesma ação.

## Módulos relacionados

- [Recursos técnicos sem modo desenvolvedor](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/base-technical-features/)
- [Ações automatizadas](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/base-automation/)

## Código e fontes

- Código-fonte: [OCA/server-ux](https://github.com/OCA/server-ux)
- [Documentação do módulo na OCA (16.0)](https://github.com/OCA/server-ux/tree/16.0/server_action_mass_edit)

Mais módulos em [Empresas, usuários e e-mail](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/) e na [referência de módulos](https://docs.kmee.com.br/odoo/enterprise/modulos/).