Importar relações entre objetos via CSV

Guia completo, passo a passo, para associar registros durante a importação de CSV.

Visão geral

Este guia orienta você na importação de relações entre objetos — por exemplo, ligar Pessoas a Empresas ou Oportunidades a Pessoas.

O que pode ser importado: apenas relações um-para-muitos que apontem para um único tipo de objeto. Relações que apontam para vários tipos de objeto (como Notas ligadas a Pessoas E Empresas) ainda não são suportadas para importação.

Compreender as relações

O que é uma relação “um-para-muitos”?

Numa relação um-para-muitos:

• Uma Empresa tem muitas Pessoas (colaboradores)
• Uma Empresa tem muitas Oportunidades
• Uma Pessoa tem muitas Tarefas

O lado “um” é o pai. O lado “muitos” é o filho.

Relações comuns no Vecta Desk

Passo 1: Identificar os lados “um” e “muitos”

Antes de importar, determine qual objeto é o pai e qual é o filho.

Pergunte a si mesmo: “UM [Objeto A] tem MUITOS [Objeto B]?”

• Uma Empresa → Muitas Pessoas ✓ (A Empresa é o pai)
• Uma Pessoa → Muitas Empresas ✗ (Isto está errado — uma pessoa pertence a uma empresa)

Passo 2: Importe primeiro os registros pai

O pai (lado “um”) deve existir no Vecta Desk antes de você poder referenciá-lo.

Ordem de importação:

1. Empresas primeiro (sem dependências)
2. Pessoas em segundo (ligar a Empresas)
3. Oportunidades em terceiro (ligar a Empresas e/ou Pessoas)
4. Tarefas/Notas (ligar a qualquer um dos anteriores)

Se o registro pai não existir, a importação falhará. Verifique sempre que as Empresas são importadas antes de importar Pessoas com referências a empresas.

Passo 3: Anote o identificador único do pai

Você precisa de referenciar o registro pai usando um identificador único. Opções disponíveis:

Recomendado: use domain para Empresas e email para Pessoas. São legíveis por humanos e fáceis de verificar na sua planilha.

Encontrar o identificador

Se precisar do id:

1. Exporte os registros pai do Vecta Desk
2. A exportação inclui a coluna id
3. Use estes IDs no seu arquivo de registros filho

Passo 4: Verifique se o campo de relação existe

Antes de importar, garanta que o campo de relação existe entre os seus objetos.

Para verificar ou criar:

1. Vá a Configurações → Modelo de dados
2. Selecione o seu objeto filho (por exemplo, Pessoas)
3. Procure um campo de relação que aponte para o pai (por exemplo, Empresa)
4. Se não existir, crie-o:
   • Clique em + Adicionar campo
   • Selecione o tipo Relação
   • Escolha o objeto pai

Passo 5: Prepare o seu arquivo CSV

Adicione uma coluna ao seu CSV de registros filho que faça referência ao pai utilizando o seu identificador único.

Exemplo: Pessoas ligadas a Empresas

O seu CSV de Pessoas:

firstName,lastName,email,jobTitle,companyDomain
João,Silva,joao@acme.com,CEO,https://acme.com
Maria,Souza,maria@widgets.co,CTO,https://widgets.co
Bruno,Costa,bruno@techstart.io,Desenvolvedor,https://techstart.io

A coluna companyDomain faz referência ao domínio da Empresa.

Requisitos de formato

O formato do domínio é importante. Use https://dominio.com (não apenas dominio.com). Isto corresponde à forma como o Vecta Desk armazena domínios de Empresas e evita erros de correspondência.

Regras importantes

1. Correspondência exata obrigatória — o valor deve corresponder exatamente ao registro pai
2. Mapeie apenas UM identificador único — não inclua companyId E companyDomain
3. Sensível a maiúsculas/minúsculas — Acme.com é diferente de acme.com

Passo 6: Carregue e mapeie a relação

1. Navegue até o objeto filho (por exemplo, Pessoas)
2. Clique em ⋮ → Importar registros
3. Carregue o seu arquivo CSV
4. Na etapa de mapeamento de campos:
   • Encontre a sua coluna de relação (por exemplo, companyDomain)
   • Mapeie-a para o campo de relação Empresa
5. Conclua o mapeamento restante
6. Revise os erros e confirme

O Vecta Desk ligará automaticamente cada registro filho ao pai correspondente.

Passo 7: Verifique a importação

Após a importação:

1. Abra alguns registros filho (por exemplo, Pessoas)
2. Verifique se o campo de relação mostra o pai correto (por exemplo, Empresa)
3. Abra um registro pai e verifique a seção de registros relacionados

Erros comuns a evitar

Ligar a Membros do espaço de trabalho

Ao ligar a Membros do espaço de trabalho (a sua equipe):

• Use o endereço de e-mail deles, não o nome
• Exemplo: responsavel@suaempresa.com, não “João Silva”

taskName,assignedTo
Retornar contato com cliente,joao@suaempresa.com
Revisar proposta,maria@suaempresa.com

Perguntas frequentes

E se o meu registro pai não tiver um domínio ou e-mail?

Você tem duas opções:

1. Use o id do Vecta Desk (exporte os registros pai para obter os respetivos IDs)
2. Crie um campo único personalizado no seu modelo de dados para armazenar um ID externo do seu sistema anterior

Posso atualizar relações em registros existentes?

Sim. Inclua o identificador único do registro filho (por exemplo, email para Pessoas) e o novo valor da relação. A importação atualizará a relação.

Posso importar relações muitos-para-muitos?

Relações muitos-para-muitos ainda não são suportadas para importação.

Posso ligar a vários tipos de objeto (como Notas a Pessoas E Empresas)?

Relações que apontam para vários tipos de objeto ainda não são suportadas para importação/exportação.

O que acontece se um registro pai não existir?

A importação mostrará um erro para essa linha. Você pode:

• Importar primeiro o registro pai e depois voltar a importar
• Corrigir o valor de referência
• Remover a linha da importação

Por que a minha relação não está a ligar corretamente?

Causas comuns:

• Formato incorreto (use https://dominio.com para domínios)
• Incompatibilidade de maiúsculas/minúsculas (verifique a grafia exata)
• O pai não existe (importe primeiro os pais)
• Mapeamento de vários identificadores (use apenas um)

Lembre-se: registros excluídos logicamente contam para a unicidade. Se estiver a receber erros de “não encontrado”, mas o registro parece existir, verifique Menu de Comandos → Ver registros excluídos. O pai pode ter sido excluído logicamente.

Resolução de problemas

Está com problemas? Consulte:

• Como corrigir erros de importação
• Importar relações entre objetos
• Restrições de unicidade