Manual do usuárioMigração de dadosRestrições de unicidade

Restrições de unicidade

Como o Vecta Desk impõe a unicidade dos dados durante a importação.

Visão geral

O Vecta Desk impõe unicidade em determinados campos para evitar registros duplicados e garantir a integridade dos dados. Compreender estas restrições é essencial para importações bem-sucedidas.

Campos únicos por padrão

ObjetoCampos únicos
Pessoasid, email
Empresasid, domain
Objetos personalizadosid apenas (por padrão)

O campo id é o identificador interno do Vecta Desk, gerado automaticamente para cada registro. Utiliza o formato UUID (por exemplo, c776ee49-f608-4a77-8cc8-6fe96ae1e43f).

Campos únicos personalizados

Você pode definir campos únicos adicionais em Configurações → Modelo de dados:

  1. Vá a Configurações → Modelo de dados
  2. Selecione o objeto
  3. Clique num campo
  4. Ative Único nas configurações do campo

Casos de uso para campos únicos personalizados

  • IDs externos: guardar IDs de outros sistemas (ID do Salesforce, ID do HubSpot)
  • Identificadores empresariais: números de colaborador, códigos de cliente
  • Informações de contato alternativas: perfil do LinkedIn, número de telefone

O nome do campo id é reservado para o ID interno do Vecta Desk. Utilize um nome diferente, como externalId ou legacyId, para identificadores externos.

Comportamento da importação

Criação de novos registros

Se o valor de um campo único não existir, é criado um novo registro.

Atualização de registros existentes

Se o valor de um campo único corresponder a um registro existente, esse registro é atualizado com os novos dados.

Para atualizar registros existentes, recomenda-se corresponder apenas a um campo único.

Registros excluídos logicamente

Registros excluídos logicamente (visíveis em Menu de Comandos → Ver registros excluídos) são incluídos nas verificações de unicidade. Se importar um registro com o mesmo valor único que um registro excluído, o registro excluído será restaurado com os novos dados.

Detecção de duplicados durante a importação

Durante a fase de validação:

  • Os duplicados no seu arquivo são destacados em amarelo
  • Você pode editar ou remover linhas duplicadas na interface antes de iniciar a importação

Melhores práticas

  1. Remova os duplicados do seu arquivo antes de importar
  2. Verifique se existem registros no Vecta Desk antes de importar
  3. Utilize IDs externos ao migrar de outros sistemas
  4. Inclua campos únicos se quiser atualizar registros existentes