Referência de tipos de propriedade do Notion
Tipos de propriedade do Notion suportados e como mapeiam para campos externos
O 2sync suporta 20 tipos de propriedade do Notion para mapeamento de campos. Alguns são editáveis (o 2sync pode atualizá-los), enquanto outros são somente leitura (definidos automaticamente pelo Notion). Entender cada tipo ajuda você a configurar automações precisas e confiáveis.
Quais tipos de propriedade do Notion o 2sync suporta?
Todos os tipos de propriedade disponíveis no Notion estão listados abaixo com seu comportamento de sincronização e casos de uso recomendados.
Quais são os tipos de propriedade editáveis?
Essas propriedades podem ser atualizadas pelo 2sync durante um ciclo de sincronização.
| Tipo de propriedade | Descrição | Ideal para |
|---|---|---|
| Title | Título da página (obrigatório em todo banco de dados) | Nomes de eventos, títulos de tarefas, nomes de contatos |
| Rich Text | Conteúdo de texto formatado | Descrições, notas, corpo de e-mail |
| Number | Valores numéricos | Níveis de prioridade, contagens |
| Select | Menu suspenso de escolha única | Nomes de calendário, categorias, rótulos de status |
| Multi-select | Tags de múltipla escolha | Rótulos, lista de participantes, categorias |
| Status | Status de fluxo de trabalho com grupos | Conclusão de tarefas, rastreamento de estado de sincronização |
| Date | Datas com horários opcionais de início/fim | Datas de eventos, datas de vencimento, aniversários |
| Checkbox | Toggle verdadeiro/falso | Status de conclusão, flag de evento recorrente |
| URL | Links web | Links de reunião, permalinks de e-mail |
| Endereços de e-mail | E-mails de contato, endereços de remetente | |
| Phone Number | Números de telefone | Campos de telefone de contato |
| People | Usuários do workspace Notion | Responsáveis (limitado a membros do workspace) |
| Files | Anexos de arquivo | Metadados de anexos |
| Relation | Links para linhas em outros bancos de dados | Participantes para contatos, tarefas para projetos |
Propriedades Select funcionam melhor para campos com um conjunto fixo de valores como nomes de calendário ou categorias. O 2sync cria automaticamente novas opções quando encontra valores que ainda não existem.
Quais são os tipos de propriedade somente leitura?
O Notion define estes automaticamente. O 2sync pode lê-los para sincronização unidirecional para aplicativos externos, mas não pode escrever neles.
| Tipo de propriedade | Descrição | Caso de uso |
|---|---|---|
| Rollup | Dados agregados de bancos de dados relacionados | Resumir registros vinculados |
| Formula | Valores computados de outras propriedades | Combinar campos para sincronização (ex.: nome completo) |
| Created Time | Timestamp de quando a página foi criada | Apenas referência |
| Created By | Usuário que criou a página | Apenas referência |
| Last Edited Time | Timestamp da última modificação | Apenas referência |
| Last Edited By | Usuário que modificou a página por último | Apenas referência |
Como escolher o tipo de propriedade certo
Para nomes de calendário: Use Select. Cada calendário se torna uma opção no menu suspenso, mantendo valores consistentes.
Para datas de eventos: Use Date com horário ativado. O 2sync mapeia horários de início e fim automaticamente.
Para participantes: Use Relation vinculada a um banco de dados de contatos. O 2sync combina participantes por endereço de e-mail.
Para descrições: Use Rich Text. A formatação do aplicativo externo é preservada quando possível.
Para rastreamento de conclusão: Use Checkbox ou Status. Checkbox é mais simples; Status oferece estágios de fluxo de trabalho agrupados.
Prefira Status em vez de Checkbox para rastreamento de conclusão quando você precisa de estágios de fluxo de trabalho como "Não Iniciado", "Em Andamento" e "Concluído". Checkbox suporta apenas marcado/desmarcado, enquanto Status permite agrupar itens por estágio de fluxo de trabalho nas visualizações do Notion.
Por que algumas propriedades são somente leitura?
O Notion impõe comportamento somente leitura em propriedades computadas e geradas automaticamente. Valores de Formula e Rollup são calculados pelo próprio Notion, então nenhuma ferramenta externa pode escrever neles. Created Time e Created By são registros imutáveis.
Você ainda pode usar propriedades somente leitura em sincronização unidirecional do Notion para seu aplicativo externo. Por exemplo, mapeie uma Formula que combina nome e sobrenome para o título de um evento.
Para fórmulas que referenciam propriedades de Relation ou Rollup, o banco de dados vinculado também deve estar conectado ao 2sync. Sem acesso, a fórmula retorna valores vazios.
Quais são os erros comuns de mapeamento?
Usar Text em vez de Select para nomes de calendário: Campos de texto permitem entrada livre, o que leva a valores inconsistentes ("Trabalho", "trabalho", "Calendário Trabalho"). Use Select para que os valores sejam restritos a opções predefinidas e o 2sync possa combiná-los de forma confiável.
Usar People em vez de Relation para participantes: Propriedades People referenciam apenas membros do workspace Notion. Participantes externos (clientes, parceiros) não podem ser representados. Use uma Relation para um banco de dados de Contatos em vez disso, que suporta qualquer endereço de e-mail.
Mapear uma propriedade de fórmula como bidirecional: Fórmulas são computadas pelo Notion e não podem receber escrita. Se você mapear uma fórmula, defina a direção como unidirecional do Notion para o aplicativo externo. Mapeamento bidirecional faz com que o valor do aplicativo externo seja ignorado.
Relacionados
- Direção de sincronização para entender como a direção afeta o comportamento editável vs somente leitura
- Relações para vincular bancos de dados usando propriedades de Relation
- Valores padrão para definir padrões em tipos específicos de propriedade
- Campos do Google Calendar para quais tipos de propriedade cada campo de calendário suporta
- Campos do Todoist para quais tipos de propriedade cada campo do Todoist suporta
FAQ
Posso mapear uma propriedade Formula para um campo externo?
Sim, mas apenas na direção unidirecional do Notion para o aplicativo externo. Fórmulas são computadas pelo Notion e não podem receber escrita do 2sync ou qualquer outra ferramenta.
O que acontece se uma opção Select ainda não existir?
O 2sync cria a opção automaticamente quando encontra um novo valor do aplicativo externo. A nova opção aparece no seu menu suspenso Select.
Qual tipo de propriedade devo usar para participantes?
Use uma propriedade Relation vinculada a um banco de dados de contatos. O 2sync combina participantes por endereço de e-mail e cria a relação automaticamente. Isso oferece uma configuração estilo CRM conectado.
Posso sincronizar propriedades People com contatos externos?
Propriedades People referenciam apenas membros do workspace Notion, não contatos externos. Para contatos externos, use uma Relation para um banco de dados de contatos ou uma propriedade Email em vez disso.
Como posso definir o título de um item com uma fórmula do Notion?
Mapeie sua propriedade Formula para o campo de título e defina a direção de sincronização como unidirecional do Notion para o aplicativo externo. Como fórmulas são somente leitura (computadas pelo Notion), elas só podem enviar valores para fora. Isso é útil para combinar campos como nome e sobrenome em um único título de evento de calendário.