Atualizar registros existentes via importação

Guia completo passo a passo para atualizar em massa registros através da importação de CSV.

Visão geral

Precisa de atualizar muitos registros de uma só vez? Em vez de os editar um a um, utilize a importação CSV para atualizar em massa os registros existentes.

Casos de uso:

• Atualizar cargos para várias pessoas
• Alterar informações da empresa em massa
• Adicionar dados a novos campos personalizados
• Corrigir erros de dados em muitos registros

Como funciona

Quando importar um arquivo que contenha um identificador único que corresponde a um registro existente, o Vecta Desk atualiza esse registro em vez de criar um duplicado.

Os campos de seleção múltipla são substituídos, não combinados. Se um registro tiver Option A e Option B selecionadas, e importar ["Option C"], o registro terá apenas Option C após a importação. A importação substitui todas as seleções anteriores — não as adiciona.

Para manter os valores existentes, inclua-os todos na sua importação: ["Option A","Option B","Option C"].

Passo 1: Exportar os seus dados atuais

Primeiro, exporte os registros que pretende atualizar:

1. Navegue até o objeto (Pessoas, Empresas, etc.)
2. Adicione as colunas de que precisa — clique em Opções → Campos para mostrar os campos que quer atualizar
3. Filtre se necessário — restrinja apenas aos registros que pretende atualizar
4. Clique em ⋮ → Exportar visualização
5. Salve o arquivo CSV

Por que exportar primeiro? O arquivo exportado tem o formato correto, inclui identificadores únicos e é mapeado automaticamente durante a importação.

O que é exportado

• Todas as colunas visíveis na sua visualização atual
• Os identificadores únicos do registro (id, email, domain)
• Valores atuais de campos que pode modificar

Passo 2: Editar o arquivo CSV

Abra o arquivo exportado na sua aplicação de planilha (Excel, Google Sheets, etc.):

1. Mantenha a coluna do identificador único — não exclua id, email ou domain
2. Atualize os valores nas colunas que quer alterar
3. Remova as colunas que não precisa de atualizar (opcional, mas mais limpo)
4. Não altere os valores do identificador único — caso contrário o Vecta Desk criará novos registros

Exemplo: atualizar cargos

Arquivo exportado:

id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,joao@acme.com,João,Silva,Representante de Vendas
550e8400-e29b-41d4-a716-446655440002,maria@acme.com,Maria,Souza,Representante de Vendas
550e8400-e29b-41d4-a716-446655440003,bruno@acme.com,Bruno,Costa,Representante de Vendas

Após as suas alterações:

id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,joao@acme.com,João,Silva,Executivo de Contas
550e8400-e29b-41d4-a716-446655440002,maria@acme.com,Maria,Souza,Executiva de Contas Sênior
550e8400-e29b-41d4-a716-446655440003,bruno@acme.com,Bruno,Costa,Executivo de Contas

Não altere os valores do identificador único. Se alterar joao@acme.com para joao.silva@acme.com, o Vecta Desk criará um novo registro em vez de atualizar o existente.

Passo 3: Importar o arquivo atualizado

1. Navegue até o objeto
2. Clique em ⋮ → Importar registros
3. Carregue o seu arquivo CSV editado
4. Garanta que o identificador único está mapeado — verifique se email, domain ou id está mapeado corretamente
5. Revise o mapeamento dos campos
6. Verifique se há erros
7. Clique em Confirmar

O Vecta Desk faz a correspondência dos registros pelo identificador único e atualiza-os com novos valores.

Escolher o identificador único correto

Utilize apenas UM identificador único. Não mapeie email E id. Isto pode causar confusão e erros.

Utilizar campos únicos personalizados

Se tiver um campo personalizado marcado como único (como um ID externo de outro sistema):

1. Inclua esse campo na exportação e importação
2. Mapeie-o durante a importação
3. O Vecta Desk fará a correspondência com base nesse campo

Passo 4: Verificar as atualizações

Após a importação:

1. Abra alguns registros atualizados
2. Verifique se as alterações foram aplicadas
3. Confirme que não foram criados registros duplicados

E os campos que não estão no seu arquivo?

Os campos não incluídos no seu arquivo de importação permanecem inalterados.

Isto significa que só precisa de incluir os campos que pretende alterar (além do identificador único).

Combinar atualizações e novos registros

Você pode atualizar registros existentes e criar novos na mesma importação:

email,firstName,lastName,jobTitle
joao@acme.com,João,Silva,Gerente Sênior    (atualiza o existente, e-mail corresponde)
novapessoa@acme.com,Nova,Pessoa,Analista   (cria novo, e-mail não corresponde)

Erros comuns a evitar

Perguntas frequentes

E se alguns registros ainda não existirem?

Registros com identificadores únicos que não correspondam a registros existentes serão criados como novos registros. Isto permite-lhe atualizar e criar na mesma importação.

Posso limpar/esvaziar o valor de um campo?

Sim, deixe a célula vazia no seu CSV. A importação irá limpar o valor desse campo no registro existente.

O que acontece aos campos que não incluo na importação?

Os campos que não estão no arquivo de importação permanecem inalterados nos registros existentes. Apenas os campos que incluir são atualizados.

Posso atualizar campos de relação (como Empresa)?

Sim. Inclua o identificador único da relação (por exemplo, companyDomain) e faça o mapeamento para o campo de relação. A relação será atualizada.

Como sei quais os registros que serão atualizados ou criados?

Durante a etapa de revisão da importação, o Vecta Desk mostra quantos registros serão atualizados ou criados com base nas correspondências do identificador único.

Posso desfazer uma atualização em massa?

Não existe desfazer automático. Recomendamos exportar os seus dados como cópia de segurança antes de fazer atualizações em massa.

Melhores práticas

1. Exporte primeiro — comece sempre a partir de uma exportação para garantir o formato correto
2. Faça uma cópia de segurança antes de atualizar — exporte os seus dados antes de fazer alterações em massa
3. Teste com alguns registros — tente atualizar primeiro 5 a 10 registros antes de fazer um lote grande
4. Utilize identificadores legíveis por humanos — email e domain são mais fáceis de verificar do que id
5. Inclua apenas as colunas necessárias — menos colunas significa menor probabilidade de erros

Resolução de problemas

Está com problemas? Consulte:

• Como corrigir erros de importação
• Restrições de unicidade
• Mapeamento de campos