Mapeamento de campos

Como o mapeamento de campos funciona durante a importação de dados.

Como funciona o mapeamento de campos

Ao fazer upload de um arquivo, o Vecta Desk analisa as suas colunas e tenta associá-las aos campos existentes.

Mapeamento automático

O Vecta Desk tenta associar as colunas com base em:

Nomes dos cabeçalhos das colunas (correspondências exatas ou semelhantes)
Detecção de tipo de dados (datas, números, e-mails)
Padrões comuns de campos

Dica rápida: exporte algumas linhas do objeto que você deseja importar. O arquivo exportado terá exatamente os nomes de coluna que o Vecta Desk espera, facilitando o mapeamento automático durante a importação.

Opções de mapeamento manual

Para cada coluna, você pode:

Mapear para um campo: selecione o campo correspondente do Vecta Desk em um menu suspenso
Não mapear: ignore a coluna completamente (os dados não serão importados)

Os campos devem existir antes da importação. A importação cria registros, não campos. Crie campos personalizados em Configurações → Modelo de dados antes de importar.

Compatibilidade de tipos de campo

Todos os tipos de campos disponíveis no Modelo de dados são compatíveis com a importação. Você também pode importar valores de id para atribuir um ID específico a novos registros ou atualizar os existentes.

Requisitos de formato de dados

Alguns campos têm sintaxe especial. Recomendamos baixar o arquivo de exemplo antes de preparar sua importação para ver a sintaxe esperada para cada tipo de campo.

Campos de endereço

Endereço é um campo aninhado com várias colunas. Algumas podem ficar em branco.

Endereço / Endereço 1: Linha 1 do endereço
Endereço / Endereço 2: Linha 2 do endereço
Endereço / Cidade: Nome da cidade
Endereço / Estado: Estado ou província
Endereço / País: Nome do país
Endereço / Código Postal: Código Postal/CEP

Campos de array

Use o seguinte formato:

["valor1","valor2"]

Campos booleanos

Use TRUE ou FALSE (em maiúsculas) — não true ou false.

Campos de moeda

Moeda é um campo aninhado com duas colunas que ambas devem ser preenchidas:

Valor / Valor: o valor numérico (por exemplo, 1234.56)
Valor / Moeda: o código da moeda (por exemplo, BRL, USD, EUR)

Campos de data

Formatos suportados:

YYYY-MM-DD (recomendado)
MM/DD/YYYY
DD/MM/YYYY
Formato ISO 8601

Campos de domínio

Recomenda-se usar o formato https://dominio.com para evitar a criação de duplicatas, pois esse é o formato usado para Empresas criadas pelas sincronizações da caixa de correio e do calendário
Um rótulo de domínio (Domain Label) e uma URL de domínio (Domain URL) podem ser preenchidos: a boa prática é preencher dominio.com no rótulo e https://dominio.com na URL
Domínios devem ser exclusivos no objeto Empresas
Os domínios devem ser exclusivos dentro do arquivo a ser importado

Campos de e-mail

Deve estar em um formato de e-mail válido
Os e-mails devem ser exclusivos dentro do objeto Pessoas
Os e-mails devem ser exclusivos dentro do arquivo a ser importado
Para e-mails adicionais: use E-mails / E-mail principal para o e-mail principal e E-mails / E-mails adicionais com este formato:

["maria@empresa.com","maria.silva@empresa.com"]

Campos de ID

Especificar um id durante a importação é opcional. O Vecta Desk gera um automaticamente se não for fornecido.

Casos de uso para mapear uma coluna id:

Definir um ID específico: escolha o UUID para registros recém-criados
Atualizar registros existentes: faça a correspondência com registros existentes para atualizá-los, em vez de criar duplicatas. Nesse caso, recomenda-se não mapear os outros campos exclusivos: mapear apenas um campo exclusivo garante uma importação mais tranquila.

Se você fornecer um id, ele deve estar no formato UUID (por exemplo, c776ee49-f608-4a77-8cc8-6fe96ae1e43f).

Campos JSON

Use um formato JSON válido:

{"chave":"valor","chave2":"valor2"}

Campos de links

Semelhante aos campos de domínio:

Preencha as colunas de rótulo e URL: Links / URL do link e Links / Rótulo do link
Use o formato completo de URL: https://exemplo.com
Para links secundários, use a coluna Links / Links Secundários com este formato:

[{"url":"https://exemplo.com","label":"Exemplo"}]

Campos de seleção múltipla

Use os nomes da API (não os rótulos de exibição) no seguinte formato:

["VALUE1","VALUE2"]

Veja como encontrar os nomes da API.

Novas opções de seleção não serão criadas automaticamente pela importação. Elas devem ser adicionadas em Configurações → Modelo de dados antes de importar.

A importação substitui; não adiciona. Se um registro já tiver VALUE2 e VALUE3 selecionados e você importar ["VALUE1"], o registro terá apenas VALUE1 após a importação. As seleções anteriores são substituídas, não mescladas.

Campos numéricos

Apenas números
Decimais usam ponto: 1234.56
Sem separadores de milhares

Campos de telefone

Telefone é um campo aninhado com várias colunas que devem ser preenchidas:

Telefones / Número de telefone principal: o número de telefone (por exemplo, 11990000000)
Telefones / Código do país do telefone principal: código do país (por exemplo, BR)
Telefones / Código de chamada do telefone principal: código de discagem (por exemplo, +55)

Campos de classificação

Use o formato de nome da API: RATING_1, RATING_2, RATING_3, RATING_4, RATING_5.

Campos de relação

Consulte nosso artigo dedicado: Importar relações entre objetos.

Campos de seleção

Use o nome da API da opção (não o rótulo de exibição):

VALUE1

Veja como encontrar os nomes da API.

Novas opções de seleção não serão criadas automaticamente pela importação. Elas devem ser adicionadas em Configurações → Modelo de dados antes de importar.

Campos de texto

Nenhuma formatação especial é necessária
Espaços no início e no fim são removidos

Encontrar nomes da API

Para campos Seleção, Seleção múltipla e Array com opções predefinidas, você deve usar os nomes da API, não os rótulos de exibição.

Como encontrar nomes da API

Vá para Configurações → Modelo de dados
Selecione o objeto e o campo
Ative o Modo avançado (alternador no canto inferior direito da página de configurações)
Visualize o nome da API de cada opção

Corrigir erros de importação Formatos de arquivo suportados