Saltar para o conteúdo principal

​
Visão Geral

O Twenty suporta a importação de relações entre objetos durante a importação por CSV. Isto permite-lhe ligar registos (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 Twenty

​
Um para Muitos / Muitos para Um

O Twenty suporta relações padrão em que um registo 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 registos a ligar-se, cada um, a um registo 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 registo por tipo de objeto. Padrão 2: Um registo a receber ligações de muitos registos de diferentes tipos de objeto Um Projeto pode receber ligações de vários registos 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 registos 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
Isto está no nosso roadmap.

​
O que não é suportado hoje

Relações muitos-para-muitos ainda não estão disponíveis. Por exemplo, atualmente não pode criar uma relação em que:
  • Muitas Pessoas estão ligadas a muitos Projetos
Relações muitos-para-muitos estão planeadas para o 1.º semestre de 2026.

​
Ligar registos 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 registos do lado “Um”

Antes de importar o lado “muitos”, os registos do lado “um” já devem existir no Twenty.
  • Importe ou crie primeiro os registos do lado “um” (por exemplo, Empresas)
  • Valide o seu identificador único. Isto pode ser:
    • O id (UUID do Twenty)
    • 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 registo que não existe.

​
Passo 3: Prepare o seu ficheiro CSV

Adicione uma coluna no seu ficheiro CSV do lado “muitos” que referencia o registo do lado “um”. Exemplo: Para um ficheiro CSV de Pessoas ligado a Empresas: 
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
Importante:
  • O valor deve corresponder exatamente ao campo único no registo da Empresa
  • Para domínios, use o 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 ficheiro, garanta que o campo de relação existe entre os seus objetos. Se não existir:
  1. Vá a Definiçõ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 ficheiro 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 Twenty ligará automaticamente cada registo ao pai correspondente

​
Campos únicos disponíveis para relações

ObjetoCampos únicos disponíveis
Empresasid, domain, qualquer campo único personalizado
Pessoasid, email, qualquer campo único personalizado
Membros do Espaço de Trabalhoid, email (não o nome)
Outros objetos padrão e personalizadosid, qualquer campo marcado como único
Ligação a Membros do Espaço de Trabalho: Quando a relação aponta para Membros do Espaço de Trabalho (a sua equipa que inicia sessão no Twenty), refira-os pelo seu endereço de email, 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 folhas de cálculo.
Lembrete: Registos suavemente eliminados (visíveis em Menu de Comandos → Ver registos eliminados) contam para os critérios de unicidade. Se importar um registo com o mesmo valor único que um registo eliminado, o registo eliminado 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 registo pai deve existir antes de o poder referenciar.