Como Importar Obras em Lote via Planilha CSV
"Aplica-se a: Guardian Essencial, Guardian Pro" "Keyword: importar obras csv planilha lote guardian coleção" "Title: Importar Obras em Lote via CSV | Central de Ajuda - Acervo Vivo Guardian" "Meta: Aprenda a importar dezenas de Obras de uma só vez no Acervo Vivo Guardian usando uma planilha CSV, com suporte a imagens, dimensões e valor de avaliação." "Slug: importar-csv-guardian" "Alt-Capa: Ilustração mostrando uma planilha sendo carregada para uma coleção digital de arte"
O que é este recurso?
O Importador de Planilha CSV permite que você traga dezenas ou centenas de Obras para a sua coleção de uma só vez, sem precisar cadastrar peça por peça. É ideal para coleções que estão migrando de sistemas legados (como Tainacan, IPAC ou planilhas internas) ou que receberam um novo conjunto de obras com ficha técnica já documentada.
💡 O importador é inteligente: ele reconhece automaticamente os nomes das colunas mais comuns, mapeia os dados para os campos corretos do sistema e evita duplicatas usando o "Código no Atelier" de cada Obra como chave única.
Como acessar
No menu lateral esquerdo, navegue até Inventário da Coleção → Coleção Completa.
No canto superior direito da tela, clique no ícone de planilha (importar CSV). O painel do Importador se abrirá em 3 etapas.
Como usar
Etapa 1 — Carregar o arquivo
Arraste o seu arquivo .csv para a área de upload ou clique para selecionar do computador.
⚠️ Limite: até 500 linhas por importação. Para coleções maiores, divida em lotes e importe sequencialmente.
Seletor de linhas: após carregar o arquivo, você pode definir a Linha Inicial e a Linha Final para importar apenas um trecho. Isso é útil para testar com um lote pequeno (ex: linhas 1 a 5) antes de submeter a coleção completa.
Codificação do arquivo: se os acentos aparecerem errados no preview, alterne entre UTF-8 e Windows-1252. CSVs exportados do Excel geralmente usam Windows-1252.
Etapa 2 — Mapear as colunas
O sistema exibe as colunas encontradas no seu CSV e sugere automaticamente para qual campo do Acervo Vivo cada uma deve ir.
Revise os mapeamentos e corrija os que estiverem errados usando os menus suspensos.
Campos disponíveis para mapeamento
| Campo | O que é |
|---|---|
| Título (obrigatório) | Nome principal da Obra |
| Ano | Ano ou período de criação (ex: 2021 ou 1987–1989) |
| Técnica e Materiais | Descrição da técnica (ex: têmpera sobre madeira) |
| Altura (cm) | Altura principal em centímetros |
| Largura (cm) | Largura principal em centímetros |
| Profundidade (cm) | Profundidade (para esculturas e objetos tridimensionais) |
| Dimensões (string bruta) | Dimensões já formatadas em texto (ex: "40 x 60 cm") |
| Código no Atelier | Código ou número de inventário legado — usado para evitar duplicatas |
| Assinatura | Informação sobre como/onde a obra está assinada |
| Inscrição | Inscrições, carimbos ou marcas no verso |
| Observação | Notas internas de curadoria ou conservação |
| Localização (Detalhe/Texto) | Texto livre de localização física (ex: "Sala 3, Parede Norte") |
| Descrição das Partes | Descrição de obras compostas (polípticos, instalações) |
| Cuidados de Conservação e Transporte | Instruções de manuseio e armazenamento |
| Valor Base / Preço | Valor de avaliação ou referência da Obra |
| URL da Imagem (Pública) | Link público para a foto principal — o sistema faz o download automaticamente |
| Autoria | Nome do artista criador — criado automaticamente se não existir |
| Linguagem Artística | Linguagem da obra (ex: Fotografia, Escultura) |
| Situação | Status atual da Obra na coleção |
| Materiais | Lista de materiais (ex: Bronze, Mármore) |
| Suportes | Lista de suportes (ex: Tela, Papel) |
| Gênero | Tipologia ou gênero da obra (ex: Retrato, Paisagem) |
Destino Fixo do Lote — Autoria
Como gestor de coleção (Guardian), você deve indicar a qual Artista as Obras desta importação pertencem. Você pode fazer isso de duas formas:
- Campo Fixo (recomendado): Selecione o artista no campo "Artista Fixo para o Lote". Todas as Obras irão para esse artista.
- Coluna por linha: Mapeie a coluna de autoria do seu CSV — o sistema criará o artista automaticamente se ele ainda não existir na sua coleção.
Etapa 3 — Importar
Clique em Importar. O sistema irá:
- Verificar duplicatas — Obras com o mesmo "Código no Atelier" são atualizadas, não duplicadas.
- Criar os dados de apoio — Artistas, Materiais, Suportes, Gêneros e outros itens novos são criados automaticamente, sempre vinculados à sua coleção.
- Enviar as Obras em lotes de 10, respeitando os limites da API.
- Processar as imagens — Se você mapeou uma coluna de URL de imagem, o sistema faz o download e envia a foto para o Google Drive e a coleção automaticamente.
Ao final, um Relatório de Auditoria é exibido mostrando:
- Quantas Obras foram criadas
- Quantas foram atualizadas
- Quantas imagens foram processadas
- Avisos sobre dimensões ou valores que precisam de revisão manual
Sobre o campo "Valor Base / Preço"
O Importador aceita o valor monetário em vários formatos. Você não precisa limpar a planilha antes de importar:
| Formato na planilha | O sistema interpreta como |
|---|---|
1500 |
R$ 1.500,00 |
1500.00 |
R$ 1.500,00 |
1.500,00 |
R$ 1.500,00 ✅ (padrão brasileiro) |
R$ 1.500,00 |
R$ 1.500,00 ✅ |
a combinar |
Ignorado (campo fica em branco) |
O valor importado é salvo como Valor Base na ficha da Obra e pode ser revisado individualmente após a importação.
Perguntas Frequentes
P: E se a minha planilha vier de um sistema legado com nomes de coluna não padronizados? R: O sistema usa detecção inteligente por sinônimos. Por exemplo, "Denominação", "Titulo da Obra" e até o formato do Tainacan/IPAC são reconhecidos automaticamente. Se uma coluna não for detectada, mapeie-a manualmente no menu suspenso da Etapa 2.
P: Posso importar apenas um trecho para testar? R: Sim! Na Etapa 1, use o Seletor de Linhas para importar apenas as primeiras linhas. Verifique o resultado na coleção e, se estiver correto, continue com o restante.
P: O que acontece se uma Obra do CSV já existir na minha coleção? R: Se o CSV tiver um "Código no Atelier" que já existe na sua coleção, o sistema atualiza o registro existente com os novos dados — em vez de criar um duplicado.
P: Posso importar imagens de um sistema institucional legado? R: Sim, desde que as imagens tenham uma URL pública acessível. Mapeie a coluna com os links para o campo "URL da Imagem". O sistema faz o download automaticamente. Se o servidor bloquear downloads externos (como ocorre com alguns servidores do IPAC), o sistema tentará contornar a proteção — mas este recurso funciona apenas na versão em produção.
P: Se eu alterar o "Código no Atelier" de uma Obra após a importação, a próxima importação vai criar um duplicado? R: Sim. O sistema usa o Código no Atelier como chave única. Mantenha os códigos consistentes entre importações para garantir que as atualizações funcionem corretamente.