Voltar à Documentação

Sistema de Visualização de Conteúdo

O que é o Sistema de Visualização de Conteúdo?

O Sutram inclui um viewer integrado que permite pré-visualizar, reproduzir e interagir com uma grande variedade de formatos de arquivo e links diretamente no navegador, sem necessidade de baixar arquivos ou instalar softwares externos. Equipes de projeto podem visualizar documentos, imagens, modelos CAD, vídeos, áudios e muito mais — tudo dentro do workspace do projeto.

O sistema foi construído com uma abordagem de privacidade em primeiro lugar. Serviços externos como Microsoft Office 365 e Autodesk Platform Services (APS) são opt-in no nível do projeto, dando aos proprietários do projeto controle total sobre como seus dados são tratados.

Requisitos de Plano

Nem todas as funcionalidades de visualização estão disponíveis em todos os planos. Veja o que está incluído:

Funcionalidade Basic Pro Plus Max
Viewer universal de arquivos (PDF, texto, código, dados) Sim Sim Sim Sim
Exibição de imagens Sim Sim Sim Sim
Visualização de Microsoft Office Sim Sim Sim Sim
Incorporação de links de vídeo/áudio Sim Sim Sim Sim
Metadados de links web Sim Sim Sim Sim
Suporte a arquivos de imagem com compressão - Sim Sim Sim
Suporte a arquivos de vídeo com compressão - Sim Sim Sim
Suporte a arquivos de áudio com compressão - Sim Sim Sim
Visualização de arquivos CAD/BIM (Autodesk) - Sim Sim Sim
Editor Markdown (assistido por IA) - Sim Sim Sim
Comentários em itens de conteúdo - Sim Sim Sim

Formatos de Arquivo Suportados

Imagens

Formatos: JPEG, PNG, GIF, WebP, SVG, BMP

As imagens são exibidas diretamente no navegador com exibição em resolução total, controles de zoom e pan, e extração de metadados EXIF. Nenhuma configuração necessária.

Disponível em: Todos os planos


Documentos PDF

Formato: .pdf

Os PDFs são renderizados nativamente no navegador com busca, navegação por páginas, controles de zoom e download.

Disponível em: Todos os planos


Arquivos Markdown

Extensões: .md, .markdown

Arquivos Markdown são convertidos para HTML com destaque de sintaxe para blocos de código, listas de tarefas, tabelas, notas de rodapé e URLs com links automáticos. Limite de tamanho: 5 MB.

Disponível em: Todos os planos


Documentos Microsoft Office

Formatos: Word (.docx, .doc), Excel (.xlsx, .xls), PowerPoint (.pptx, .ppt)

Documentos Office podem ser visualizados usando duas estratégias:

Opção 1: Viewer Microsoft Office 365 (Baseado em Nuvem)

  • Renderização com fidelidade total — exatamente como no Microsoft Office
  • Excel suporta múltiplas planilhas, fórmulas e gráficos
  • PowerPoint suporta animações e transições
  • Rápido (sem atraso de conversão)

Nota de privacidade: A URL do arquivo é enviada aos servidores da Microsoft, onde o arquivo pode ser temporariamente armazenado em cache. Habilite essa opção apenas se sua organização permite serviços em nuvem da Microsoft.

Como habilitar: Vá em Configurações do ProjetoIntegraçõesServiços Microsoft → Ative "Permitir Viewer Microsoft Office 365"

Opção 2: Conversão LibreOffice (Preservação de Privacidade)

Quando os serviços Microsoft estão desabilitados (o padrão), arquivos Office são automaticamente convertidos para PDF localmente no servidor:

  • Totalmente privado — nenhum dado sai da sua infraestrutura
  • O PDF convertido é armazenado em cache para visualizações subsequentes instantâneas
  • Atraso de 1 a 5 segundos na primeira visualização

Limitações: Pode perder alguma formatação. Arquivos Excel são paginados. Animações do PowerPoint são perdidas.

Disponível em: Todos os planos


Arquivos CAD/BIM/3D (50+ Formatos)

O Sutram suporta visualização de arquivos CAD padrão da indústria por meio da integração com o Autodesk Platform Services (APS) — a mesma tecnologia por trás dos viewers em nuvem da própria Autodesk.

Formatos Suportados

Categoria Formatos
AutoCAD DWG, DXF, DWT
Revit (BIM) RVT, RTE (RFA não suportado como standalone)
Inventor IPT, IAM, IDW, IPN
Fusion 360 F3D, F2D, F3Z
3ds Max MAX
Navisworks NWD, NWF, NWC
Alias / VRED WIRE, VPB
SolidWorks SLDPRT, SLDASM, SLDDRW
CATIA V5 CATPart, CATProduct, CGR
Siemens NX PRT
Neutro STEP, STP, IGES, IGS, STL
Modelos 3D OBJ, FBX, GLTF, GLB, DAE
Outros DWF, DWFX, DGN, IFC (BIM)
Arquivos ZIP ZIP (quando contendo arquivos CAD, com configuração habilitada)

Como Funciona

  1. Faça upload de um arquivo CAD para o seu projeto
  2. A conversão inicia automaticamente em segundo plano (normalmente de 30 segundos a 5 minutos)
  3. Uma notificação aparece quando o arquivo está pronto para visualização
  4. Clique no arquivo para abrir o viewer 3D completo no navegador

Arquivos convertidos são armazenados em cache — fazer upload do mesmo arquivo novamente carrega o viewer instantaneamente.

Funcionalidades do Viewer

  • Navegação 3D: rotação, pan, zoom, ajustar à tela
  • Árvore do modelo: navegador hierárquico de componentes
  • Painel de propriedades: metadados e atributos do objeto
  • Ferramentas de medição: distância, área, ângulo
  • Planos de seção: vistas em corte
  • Vistas explodidas: para montagens
  • Modos de câmera: ortográfico e perspectiva
  • Modo tela cheia

Suporte a Arquivos ZIP

Para modelos complexos com múltiplos arquivos e dependências (arquivos Revit vinculados, montagens com referências externas, modelos com texturas):

  1. Crie um arquivo ZIP contendo todos os arquivos do modelo
  2. Nomeie o arquivo principal de forma clara (ex.: main.rvt, assembly.sldasm)
  3. Faça upload do ZIP — o Sutram o envia ao APS, que detecta automaticamente o arquivo principal

Requisito: "Incluir arquivos ZIP na conversão CAD" deve estar habilitado nas Configurações do Projeto.

Configurando o Autodesk APS

Esta é uma integração Bring Your Own Key (BYOK). Você fornece suas próprias credenciais da Autodesk, e o uso do APS é cobrado diretamente na sua conta da Autodesk.

  1. Crie um app em aps.autodesk.com (nível gratuito: ~100 créditos/mês)
  2. Vá em Configurações do ProjetoIntegraçõesServiços Autodesk
  3. Ative "Permitir Viewer CAD Autodesk"
  4. Insira seu Client ID e Client Secret
  5. Opcionalmente habilite "Converter arquivos CAD automaticamente após upload" e "Incluir arquivos ZIP na conversão CAD"
  6. Clique em Salvar

Disponível em: Plano Pro e acima


Arquivos de Texto e Código

Texto Simples

Extensões: .txt, .log, .conf, .cfg, .ini, .properties, .yaml, .yml, .toml, .rtf

Exibido com fonte monoespaçada.

Arquivos de Código (40+ Linguagens)

Extensões: .js, .jsx, .ts, .tsx, .py, .rb, .ex, .exs, .java, .c, .cpp, .h, .go, .rs, .php, .sh, .sql, .html, .css, .vue, .svelte, .dart, .kt, .swift, e mais.

Exibido com destaque de sintaxe, números de linha e formatação legível.

Disponível em: Todos os planos


Arquivos de Dados Estruturados

Formato Funcionalidades
CSV (.csv) Tabela interativa com cabeçalhos de coluna e colunas ordenáveis
JSON (.json) Formatação indentada com destaque de sintaxe, objetos recolhíveis
XML (.xml) Formatação indentada com destaque de tags

Disponível em: Todos os planos


Links de Vídeo (Incorporados)

Plataformas Suportadas:

  • YouTube (youtube.com, youtu.be)
  • Vimeo (vimeo.com)
  • Dailymotion (dailymotion.com, dai.ly)
  • Wistia (wistia.com, wi.st)
  • Loom (loom.com)
  • TikTok (tiktok.com, vm.tiktok.com, vt.tiktok.com)

Funcionalidades: Player incorporado, rastreamento de progresso (retome de onde parou), exibição de duração, pré-visualização de thumbnails, metadados da plataforma, suporte a tela cheia.

Como adicionar: Clique em "Adicionar Link de Vídeo" no conteúdo do seu projeto, cole a URL e o Sutram detecta automaticamente a plataforma e busca os metadados.

Disponível em: Todos os planos


Links de Áudio (Incorporados)

Plataformas Suportadas:

  • Spotify: Faixas, álbuns, playlists, podcasts
  • SoundCloud: Faixas e playlists
  • Apple Podcasts: Links de episódios
  • Plataformas de Podcast: Anchor, Fireside, Buzzsprout, Podbean, Simplecast, Transistor, Megaphone
  • URLs de Áudio Personalizadas: Links diretos MP3, OGG

Funcionalidades: Player incorporado, exibição de capa, metadados do artista, duração, controles de reprodução.

Como adicionar: Clique em "Adicionar Link de Áudio" no conteúdo do seu projeto e cole a URL.

Disponível em: Todos os planos


Links Web

Qualquer URL HTTP/HTTPS pode ser adicionada como um item de conteúdo. O Sutram busca automaticamente o título da página, descrição e favicon para exibição. Clicar no link o abre em uma nova aba.

Como adicionar: Clique em "Adicionar Link Web" no conteúdo do seu projeto e cole a URL.

Disponível em: Todos os planos


Upload de Arquivos

Como Funciona

  1. Clique em Upload de Arquivos ou arraste e solte arquivos no seu projeto
  2. O sistema valida o tamanho do arquivo de acordo com os limites do seu plano
  3. Os arquivos são enviados diretamente para o armazenamento com uma barra de progresso
  4. Após o upload, os arquivos são processados automaticamente de acordo com o tipo:
    • Imagens, vídeos, áudios (Pro+): Comprimidos/otimizados em segundo plano
    • Arquivos CAD (Pro+): Enviados para conversão via Autodesk APS
    • Arquivos Office: Convertidos para PDF na primeira pré-visualização (se o viewer Microsoft estiver desabilitado)
  5. Uma notificação aparece quando o processamento é concluído
  6. Todos os membros do projeto veem o novo arquivo em tempo real

Status do Arquivo

  • Enviando: O arquivo está sendo enviado
  • Processando: Compressão ou otimização em andamento
  • Convertendo: Conversão CAD via Autodesk em andamento
  • Pronto: O arquivo está pronto para visualização e download

Pré-visualização de Conteúdo

Modal de Pré-visualização

Clique em qualquer item de conteúdo para abrir o modal de pré-visualização. O modal se adapta ao tipo de conteúdo:

  • Arquivos (imagens, PDFs, Office, CAD): Viewer inline com botão de download
  • Links de vídeo/áudio: Player incorporado
  • Links web: Abre em uma nova aba com pré-visualização dos metadados

Navegação

  • Teclas de seta: Navegar entre itens (esquerda/direita)
  • ESC: Fechar o modal
  • F: Alternar tela cheia
  • Botão de download disponível para todos os tipos de arquivo

Conversão em Tempo Real

Para arquivos CAD e Office que requerem conversão:

  1. O modal exibe um indicador de "Convertendo..."
  2. A conversão acontece em segundo plano
  3. Quando concluída, o viewer carrega automaticamente — sem necessidade de atualizar a página
  4. Você pode manter o modal aberto e acompanhar a conversão sendo concluída

Download de Arquivos

  1. Clique no botão Download no modal de pré-visualização ou na lista de conteúdo
  2. O navegador baixa o arquivo com o nome original
  3. Os links de download expiram após 1 hora por segurança

Configurando Integrações

Todas as integrações com serviços externos são controladas por projeto em Configurações do ProjetoIntegrações.

Viewer Microsoft Office 365

Configuração Padrão Descrição
Permitir Viewer Microsoft Office 365 Desativado Habilita visualização Office baseada em nuvem com fidelidade total

Nenhuma credencial necessária. Quando desabilitado, arquivos Office utilizam a conversão local para PDF.

Autodesk Platform Services (Viewer CAD)

Configuração Obrigatório Descrição
Permitir Viewer CAD Autodesk Sim Controle principal para visualização CAD
Client ID Sim Seu Client ID do APS
Client Secret Sim Seu Client Secret do APS (criptografado no banco de dados)
Nome do Bucket Não Nome personalizado do bucket (gerado automaticamente se vazio)
Converter arquivos CAD automaticamente Não Converter arquivos CAD imediatamente após upload
Incluir ZIP na conversão CAD Não Processar arquivos ZIP contendo arquivos CAD

Regras de validação:

  • As credenciais são obrigatórias quando o Viewer CAD está habilitado
  • O suporte a ZIP requer que a conversão automática esteja habilitada primeiro

Solução de Problemas

"Pré-visualização não disponível para este tipo de arquivo"

O formato do arquivo não é suportado. Baixe o arquivo e abra-o no aplicativo apropriado.

"Arquivo muito grande para pré-visualização"

Arquivos de texto e código têm um limite de 5 MB para pré-visualização. Baixe o arquivo ao invés disso.

"Viewer CAD Não Configurado"

As credenciais do Autodesk APS estão faltando. Vá em Configurações do ProjetoIntegraçõesServiços Autodesk e insira seu Client ID e Client Secret.

"Falha na conversão do documento Office"

Tente habilitar o Viewer Microsoft Office 365 nas Configurações do Projeto para melhor compatibilidade. Se estiver usando conversão via LibreOffice, o arquivo pode estar corrompido — tente fazer upload novamente.

Link de vídeo/áudio mostra "URL Inválida"

Verifique se a URL é válida. Tente copiá-la diretamente da plataforma (não um link encurtado).

Conversão CAD travada

Aguarde até 10 minutos para modelos complexos. Atualize a página. Verifique o status do serviço Autodesk em status.autodesk.com. Tente fazer upload do arquivo novamente.


Limites de Tamanho de Arquivo

Tipo de Conteúdo Limite de Pré-visualização Limite de Upload
Imagens Sem limite Dependente do plano
PDF Sem limite Dependente do plano
Markdown 5 MB Dependente do plano
Código/Texto 5 MB Dependente do plano
Office Sem limite Dependente do plano
CAD Sem limite Dependente do plano
Links de vídeo/áudio N/A N/A (apenas links)

Os limites de upload dependem do seu plano de assinatura:

  • Basic: 10 MB por arquivo
  • Pro: 500 MB por arquivo
  • Plus: 1 GB por arquivo
  • Max: 2 GB por arquivo

Matriz Completa de Suporte a Formatos

Categoria Formatos Configuração
Imagens JPEG, PNG, GIF, WebP, SVG, BMP Nenhuma
PDF PDF Nenhuma
Markdown MD, MARKDOWN Nenhuma
Office DOCX, DOC, XLSX, XLS, PPTX, PPT Configuração do projeto (opcional)
CAD (2D) DWG, DXF, DWF, DWFX Credenciais APS (Pro+)
CAD (3D) STEP, IGES, STL, OBJ, FBX, GLTF, GLB, DAE Credenciais APS (Pro+)
BIM RVT, IFC, NWD, NWF, NWC Credenciais APS (Pro+)
SolidWorks SLDPRT, SLDASM, SLDDRW Credenciais APS (Pro+)
CATIA CATPart, CATProduct, CGR Credenciais APS (Pro+)
Inventor IPT, IAM, IDW, IPN Credenciais APS (Pro+)
Fusion 360 F3D, F2D, F3Z Credenciais APS (Pro+)
3ds Max MAX Credenciais APS (Pro+)
Revit RVT, RTE Credenciais APS (Pro+)
Alias / VRED WIRE, VPB Credenciais APS (Pro+)
Siemens NX PRT Credenciais APS (Pro+)
Navisworks NWD, NWF, NWC Credenciais APS (Pro+)
Código JS, TS, PY, RB, EX, e 35+ mais Nenhuma
Dados CSV, JSON, XML Nenhuma
Texto TXT, LOG, CONF, YAML, TOML, RTF, etc. Nenhuma
Links de Vídeo YouTube, Vimeo, Dailymotion, TikTok, Wistia, Loom Nenhuma
Links de Áudio Spotify, SoundCloud, Apple Podcasts, e 7 mais Nenhuma
Links Web Qualquer URL Nenhuma

Perguntas Frequentes

P: Posso pré-visualizar arquivos sem baixá-los? R: Sim, a maioria dos tipos de arquivo pode ser pré-visualizada diretamente no navegador. Apenas formatos não suportados requerem download.

P: Meus dados são enviados para serviços externos? R: Apenas se você habilitar explicitamente. O Viewer Microsoft Office 365 e o Autodesk APS são opt-in por projeto. Quando desabilitados, todo o processamento acontece localmente no servidor do Sutram.

P: Por que meu arquivo CAD demora tanto para carregar? R: Arquivos CAD precisam ser convertidos para um formato visualizável na web pela Autodesk. Isso normalmente leva de 30 segundos a 5 minutos dependendo da complexidade. Uma vez convertido, as visualizações subsequentes são instantâneas (em cache).

P: Por que meu arquivo Excel parece diferente na pré-visualização? R: Se o Viewer Microsoft Office 365 estiver desabilitado, arquivos Excel são convertidos para PDF localmente, o que pode perder alguma formatação (fórmulas mostradas como valores, planilhas largas paginadas). Habilite o Viewer Office 365 nas Configurações do Projeto para fidelidade total.

P: Preciso pagar pelo Autodesk APS? R: A Autodesk oferece um nível gratuito (~100 créditos/mês). Para maior uso, você assina diretamente com a Autodesk. O Sutram não cobra pelo uso do APS — você usa suas próprias credenciais (modelo BYOK).

P: O que acontece com as conversões CAD quando eu excluo um arquivo? R: Quando um arquivo é excluído permanentemente (da lixeira), os recursos associados na Autodesk são limpos automaticamente.

P: Posso visualizar arquivos no celular? R: Sim, todos os viewers funcionam em navegadores móveis modernos (iOS Safari, Android Chrome). Modelos CAD muito grandes podem ter desempenho reduzido em dispositivos móveis.

P: Onde posso ver meu progresso de visualização de vídeo? R: Links de vídeo rastreiam seu progresso de visualização automaticamente. Quando você reabrir um vídeo, ele retoma de onde você parou.