Importar relações entre objetos

Importar relações entre registros via CSV.

Visão geral

O Vecta Desk suporta a importação de relações entre objetos durante a importação por CSV. Isto permite ligar registros (por exemplo, associar Pessoas a Empresas) como parte da sua migração de dados.

Atualmente suportado para importação: relações um-para-muitos que apontam para um único tipo de objeto de cada lado (por exemplo, Pessoas → Empresas). Relações que apontam para vários tipos de objeto ainda não são suportadas na importação/exportação.

Como funcionam as relações no Vecta Desk

Um para muitos / Muitos para um

O Vecta Desk suporta relações padrão em que um registro se liga a muitos outros:

• Uma Empresa → Muitas Pessoas: uma empresa pode ter vários colaboradores, mas cada pessoa pertence a uma empresa
• Uma Empresa → Muitas Oportunidades: uma empresa pode ter vários negócios, mas cada oportunidade pertence a uma empresa

Relações que podem apontar para vários tipos de objeto

Algumas relações podem ligar-se a diferentes tipos de objetos. Isto funciona de duas formas.

Padrão 1: muitos registros a ligar-se, cada um, a um registro de diferentes tipos de objeto. Várias Notas, Tarefas ou Atividades podem ser anexadas, cada uma, a vários tipos de objeto ao mesmo tempo:

• Notas podem ser ligadas a uma Pessoa, uma Empresa e uma Oportunidade em simultâneo
• Tarefas podem ser ligadas a uma Pessoa, uma Empresa e uma Oportunidade em simultâneo

Aqui, as Notas/Tarefas estão do lado “muitos”. Cada uma liga-se a um registro por tipo de objeto.

Padrão 2: um registro a receber ligações de muitos registros de diferentes tipos de objeto. Um Projeto pode receber ligações de vários registros de diferentes tipos de objeto:

• Um Projeto pode ter muitas Pessoas ligadas a ele, muitas Empresas ligadas a ele e muitas Notas anexadas a ele

Aqui, o Projeto está do lado “um”. Vários registros de diferentes objetos podem ligar-se todos ao mesmo Projeto.

Limitação de importação/exportação: relações que apontam para vários tipos de objeto (como Notas → Pessoas/Empresas/Oportunidades) ainda não são suportadas na importação ou exportação por CSV.

• Importação: apenas podem ser importadas relações um-para-muitos que apontem para um único tipo de objeto de cada lado
• Exportação: as colunas para relações que apontam para vários tipos de objeto são, atualmente, deixadas em branco

O que não é suportado hoje

Relações muitos-para-muitos ainda não estão disponíveis. Por exemplo, atualmente não é possível criar uma relação em que muitas Pessoas estejam ligadas a muitos Projetos.

Ligar registros durante a importação

Lembrete: só podem ser importadas relações um-para-muitos que apontem para um único tipo de objeto (por exemplo, Pessoas → Empresas). Relações que apontem para vários tipos de objeto (por exemplo, Notas → Pessoas/Empresas/Oportunidades) ainda não são suportadas.

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

Primeiro, determine qual o objeto que está do lado “um” e qual está do lado “muitos” da relação.

Exemplo:

• Empresa é o lado “um” (uma empresa tem muitos colaboradores)
• Pessoas é o lado “muitos” (cada pessoa pertence a uma empresa)

Passo 2: Garanta que existem os registros do lado “um”

Antes de importar o lado “muitos”, os registros do lado “um” já devem existir no Vecta Desk.

• Importe ou crie primeiro os registros do lado “um” (por exemplo, Empresas)
• Valide o seu identificador único. Isto pode ser:
  • O id (UUID do Vecta Desk)
  • Um campo definido como único (por exemplo, domain para Empresas, ou um ID externo do seu sistema anterior)

A importação falhará se for feita referência a um registro que não existe.

Passo 3: Prepare o seu arquivo CSV

Adicione uma coluna no seu arquivo CSV do lado “muitos” que referencia o registro do lado “um”.

Exemplo: para um arquivo CSV de Pessoas ligado a Empresas:

firstName,lastName,email,companyDomain
João,Silva,joao@acme.com,https://acme.com
Maria,Souza,maria@widgets.co,https://widgets.co

Importante:

• O valor deve corresponder exatamente ao campo único no registro da Empresa
• Para domínios, use a URL de domínio (por exemplo, https://acme.com), não o rótulo do domínio
• Mapeie apenas um identificador único por relação: isto leva a uma importação mais fluida

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

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

Se não existir:

1. Vá a Configurações → Modelo de dados
2. Selecione o seu objeto (por exemplo, Pessoas)
3. Crie um campo de relação que aponte para o objeto de destino (por exemplo, Empresa)

Passo 5: Carregue e mapeie a relação

1. Carregue o seu arquivo CSV através da interface de importação
2. No passo de mapeamento de campos, encontre a sua coluna de relação (por exemplo, companyDomain)
3. Mapeie-a para o campo de relação (por exemplo, Empresa)
4. O Vecta Desk ligará automaticamente cada registro ao pai correspondente

Campos únicos disponíveis para relações

Ligação a Membros do espaço de trabalho: quando a relação aponta para Membros do espaço de trabalho (a sua equipe que faz login no Vecta Desk), refira-os pelo seu endereço de e-mail, não pelo nome.

Recomendamos usar domain para Empresas e email para Pessoas, pois são legíveis para humanos e fáceis de manter em planilhas.

Lembrete: registros excluídos logicamente (visíveis em Menu de Comandos → Ver registros excluídos) contam para os critérios de unicidade. Se importar um registro com o mesmo valor único que um registro excluído, o registro excluído será restaurado. Veja Restrições de unicidade para mais detalhes.

Regra da ordem de importação

Importe sempre primeiro o lado “um”:

1. Empresas primeiro (sem dependências)
2. Pessoas em segundo (ligadas a Empresas)
3. Oportunidades em terceiro (ligadas a Empresas/Pessoas)
4. Objetos personalizados seguindo as suas dependências

O registro pai deve existir antes de você poder referenciá-lo.