Você tem um projeto no Linear com tarefas, responsáveis e status como Em Andamento ou Concluído. Precisa trazer esse projeto para o Notion sem perder o estágio do fluxo de trabalho de cada tarefa. A ferramenta de importação nativa do Notion lê a exportação JSON do Linear e mapeia automaticamente os status do Linear para as propriedades de status do Notion. Este artigo mostra como exportar seu projeto do Linear, preparar os dados, executar a importação no Notion e verificar se cada status foi mapeado para o valor correto no Notion.
Principais conclusões: Importar um Projeto do Linear com Mapeamento de Status
- Linear > Configurações > API > Exportar como JSON: Gera uma exportação completa do projeto, incluindo títulos, descrições, responsáveis e status das tarefas.
- Configurações e Membros do Notion > Importar > Linear: A ferramenta de importação oficial que lê o arquivo JSON e cria um novo banco de dados com status mapeados.
- Coluna de propriedade de status no Notion: Cada status do Linear se torna uma opção de seleção; você pode renomear ou recolorir as opções após a importação sem afetar os dados das tarefas.
Como os Status do Linear São Mapeados para Propriedades do Notion
O Linear armazena o status da tarefa como um campo de seleção única com valores predefinidos como Backlog, A Fazer, Em Andamento, Em Revisão e Concluído. A ferramenta de importação do Notion lê a exportação JSON e cria uma propriedade do tipo Selecionar correspondente no novo banco de dados. Cada status único do Linear se torna uma opção de seleção. Se seu projeto no Linear usa estados de fluxo de trabalho personalizados, como “Aguardando QA” ou “Bloqueado”, eles também se tornam opções de seleção. O Notion não cria uma propriedade do tipo Status com barras de progresso automatizadas; ele usa uma propriedade Selecionar comum. Você pode converter a propriedade Selecionar para Status depois, se quiser a barra de progresso visual e o gatilho automático de “Concluído”. A importação preserva títulos, descrições, nomes dos responsáveis e quaisquer rótulos anexados às tarefas. Comentários e links de anexos não são importados. O arquivo JSON deve ser exportado da seção de API do Linear, não de uma exportação CSV, pois o JSON contém o identificador de status necessário para cada tarefa.
Passos para Exportar Seu Projeto do Linear e Importar para o Notion
- Exporte o projeto do Linear como JSON
Abra o Linear no seu navegador. Vá em Configurações > API. Na seção Exportar, clique em Exportar como JSON. O Linear compacta todos os dados do seu espaço de trabalho em um arquivo zip. Baixe esse arquivo zip e extraia-o. Dentro você encontrará um arquivo JSON com nome semelhante a linear-export-2025-01-15.json. Não renomeie o arquivo. Coloque-o em uma pasta de fácil acesso. - Abra o espaço de trabalho do Notion onde deseja o projeto
Faça login no Notion. Navegue até o espaço de trabalho ou página onde o banco de dados importado deve aparecer. Se quiser o banco de dados em uma página específica, abra essa página primeiro. O Notion cria o novo banco de dados dentro da página que você tem aberta ao iniciar a importação. - Inicie a importação do Linear no Notion
Clique em Configurações e Membros na barra lateral esquerda. Selecione a guia Importar. Em “Importar seus dados”, encontre Linear e clique no botão Importar. Uma janela de seleção de arquivo será aberta. - Envie o arquivo JSON
Navegue até o arquivo JSON extraído e selecione-o. O Notion começa a processar o arquivo. Isso pode levar alguns segundos a um minuto, dependendo do número de tarefas. Não feche a aba do navegador durante o processamento. - Mapeie os status do Linear para opções de seleção do Notion
Após o processamento, o Notion exibe uma tela de mapeamento. Para cada status do Linear encontrado no arquivo, você vê um menu suspenso. Selecione a opção de seleção do Notion correspondente que deseja usar. Se o status não tiver uma opção correspondente ainda, digite um novo nome de opção diretamente no campo suspenso. O Notion cria essa opção no novo banco de dados. Repita para cada status. Mapeamentos comuns: Linear “A Fazer” para Notion “Não iniciado”, Linear “Em Andamento” para Notion “Em andamento”, Linear “Concluído” para Notion “Completo”. Clique em Confirmar Mapeamento. - Revise o banco de dados importado
O Notion cria uma nova página de banco de dados dentro da página que você tinha aberta. O banco de dados é nomeado “Importação Linear” por padrão. Você pode renomeá-lo clicando no nome no topo da página. Cada linha de tarefa mostra o título, descrição, responsável e o status que você mapeou. A coluna de status é uma propriedade Selecionar. Se preferir a propriedade Status com barra de progresso, clique no cabeçalho da propriedade, selecione Editar propriedade e altere o tipo de propriedade de Selecionar para Status. Todos os valores de seleção existentes se tornam opções de status. - Verifique a precisão do mapeamento de status
Abra algumas tarefas de cada grupo de status original do Linear. Verifique se o status no Notion corresponde ao status original do Linear. Se encontrar uma incompatibilidade, você pode editar o status da tarefa manualmente. Para corrigir um erro sistemático de mapeamento, exclua o banco de dados e reimporte com as escolhas de mapeamento corretas.
Se a Importação Mostrar Status Ausentes ou Incorretos
Algumas tarefas não exibem status após a importação
Isso acontece quando uma tarefa do Linear não tinha status atribuído no momento da exportação. A API do Linear permite que uma tarefa exista sem status. O Notion deixa a propriedade de status vazia para essas tarefas. Para corrigir, filtre o banco de dados por status vazio e edite em lote a coluna de status para o valor padrão desejado.
Opções de status aparecem com nomes inesperados
O JSON do Linear inclui o identificador interno do status, nem sempre o nome de exibição. Por exemplo, um status personalizado chamado “Verificação QA” pode aparecer como “qaCheck” na tela de mapeamento. Renomeie a opção no banco de dados do Notion após a importação. Clique no cabeçalho da propriedade de status, selecione Editar propriedade, clique no nome da opção e digite o nome de exibição correto.
Opções de status duplicadas criadas
Se você mapear o mesmo status do Linear para nomes de opção diferentes no Notion na tela de mapeamento, o Notion cria duas opções separadas. Exclua a opção duplicada editando a propriedade e clicando no X ao lado da opção indesejada. Em seguida, reatribua todas as tarefas que usavam a duplicada para a opção correta.
Importação de Status do Linear vs Outros Métodos de Importação do Notion
| Item | Importação JSON do Linear via Notion | Importação Manual CSV |
|---|---|---|
| Mapeamento de status | Tela de mapeamento automática com menus suspensos | Você deve criar uma propriedade Selecionar e inserir cada status manualmente |
| Preservação de responsáveis | Nomes dos responsáveis importados como texto | Você deve criar uma propriedade Pessoa e atribuir usuários manualmente |
| Importação de rótulos | Rótulos importados como propriedade Multi-Seleção | Não suportado, a menos que você adicione colunas no CSV |
| Links de anexos | Não importados | Não importados |
| Comentários | Não importados | Não importados |
A importação oficial do Linear economiza tempo porque o mapeamento de status é feito em uma única tela. A importação manual CSV exige que você recrie relacionamentos e atribua status manualmente. Para projetos com mais de 20 tarefas, o método JSON é a escolha mais rápida.
Agora você pode mover seu projeto do Linear para o Notion com todos os status das tarefas preservados como opções de seleção. Após a importação, tente agrupar o banco de dados pela coluna de status para visualizar seu fluxo de trabalho rapidamente. Se depois você adicionar novos status no Linear, lembre-se de reexportar e reimportar apenas as tarefas alteradas, ou atualize as opções de status do Notion manualmente para manter ambas as ferramentas sincronizadas.