Sistema di visualizzazione dei contenuti
Che cos'è il Sistema di Visualizzazione dei Contenuti?
Sutram include un visualizzatore di contenuti integrato che consente di visualizzare in anteprima, riprodurre e interagire con un'ampia varietà di formati di file e link direttamente nel browser, senza bisogno di scaricare file o installare software esterno. I team di progetto possono visualizzare documenti, immagini, modelli CAD, video, audio e molto altro, il tutto all'interno dell'area di lavoro del progetto.
Il sistema è costruito con un approccio privacy-first. I servizi esterni come Microsoft Office 365 e Autodesk Platform Services (APS) sono attivabili su richiesta a livello di progetto, offrendo ai proprietari del progetto il pieno controllo su come vengono gestiti i loro dati.
Requisiti del Piano
Non tutte le funzionalità di visualizzazione sono disponibili su ogni piano. Ecco cosa è incluso:
| Funzionalità | Basic | Pro | Plus | Max |
|---|---|---|---|---|
| Visualizzatore universale di file (PDF, testo, codice, dati) | Sì | Sì | Sì | Sì |
| Visualizzazione immagini | Sì | Sì | Sì | Sì |
| Visualizzazione Microsoft Office | Sì | Sì | Sì | Sì |
| Incorporamento link video/audio | Sì | Sì | Sì | Sì |
| Metadati link web | Sì | Sì | Sì | Sì |
| Supporto file immagine con compressione | - | Sì | Sì | Sì |
| Supporto file video con compressione | - | Sì | Sì | Sì |
| Supporto file audio con compressione | - | Sì | Sì | Sì |
| Visualizzazione file CAD/BIM (Autodesk) | - | Sì | Sì | Sì |
| Editor Markdown (assistito da IA) | - | Sì | Sì | Sì |
| Commenti sugli elementi di contenuto | - | Sì | Sì | Sì |
Formati di File Supportati
Immagini
Formati: JPEG, PNG, GIF, WebP, SVG, BMP
Le immagini vengono visualizzate direttamente nel browser con visualizzazione a risoluzione piena, controlli di zoom e panoramica ed estrazione dei metadati EXIF. Nessuna configurazione necessaria.
Disponibile su: Tutti i piani
Documenti PDF
Formato: .pdf
I PDF vengono renderizzati nativamente nel browser con ricerca, navigazione tra le pagine, controlli di zoom e download.
Disponibile su: Tutti i piani
File Markdown
Estensioni: .md, .markdown
I file Markdown vengono convertiti in HTML con evidenziazione della sintassi per blocchi di codice, elenchi di attività, tabelle, note a piè di pagina e URL con link automatici. Limite di dimensione: 5 MB.
Disponibile su: Tutti i piani
Documenti Microsoft Office
Formati: Word (.docx, .doc), Excel (.xlsx, .xls), PowerPoint (.pptx, .ppt)
I documenti Office possono essere visualizzati utilizzando due strategie:
Opzione 1: Visualizzatore Microsoft Office 365 (Basato su Cloud)
- Rendering ad alta fedeltà — esattamente come in Microsoft Office
- Excel supporta fogli multipli, formule e grafici
- PowerPoint supporta animazioni e transizioni
- Veloce (nessun ritardo di conversione)
Nota sulla privacy: L'URL del file viene inviato ai server Microsoft, dove il file potrebbe essere temporaneamente memorizzato nella cache. Attivare questa opzione solo se la propria organizzazione consente i servizi cloud Microsoft.
Come attivare: Andare su Impostazioni Progetto → Integrazioni → Servizi Microsoft → Attivare "Consenti Visualizzatore Microsoft Office 365"
Opzione 2: Conversione LibreOffice (Rispettosa della Privacy)
Quando i servizi Microsoft sono disabilitati (impostazione predefinita), i file Office vengono automaticamente convertiti in PDF localmente sul server:
- Completamente privato — nessun dato lascia la vostra infrastruttura
- Il PDF convertito viene memorizzato nella cache per visualizzazioni successive istantanee
- Ritardo di conversione di 1-5 secondi alla prima visualizzazione
Limitazioni: Potrebbe perdere parte della formattazione. I file Excel vengono paginati. Le animazioni di PowerPoint vengono perse.
Disponibile su: Tutti i piani
File CAD/BIM/3D (oltre 50 Formati)
Sutram supporta la visualizzazione di file CAD standard del settore attraverso l'integrazione con Autodesk Platform Services (APS) — la stessa tecnologia alla base dei visualizzatori cloud di Autodesk.
Formati Supportati
| Categoria | Formati |
|---|---|
| AutoCAD | DWG, DXF, DWT |
| Revit (BIM) | RVT, RTE (RFA non supportato come file autonomo) |
| 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 |
| Neutri | STEP, STP, IGES, IGS, STL |
| Modelli 3D | OBJ, FBX, GLTF, GLB, DAE |
| Altri | DWF, DWFX, DGN, IFC (BIM) |
| Archivi ZIP | ZIP (quando contengono file CAD, con impostazione abilitata) |
Come Funziona
- Caricare un file CAD nel progetto
- La conversione inizia automaticamente in background (tipicamente da 30 secondi a 5 minuti)
- Viene visualizzata una notifica quando il file è pronto per la visualizzazione
- Fare clic sul file per aprire il visualizzatore 3D completo nel browser
I file convertiti vengono memorizzati nella cache — caricare nuovamente lo stesso file apre il visualizzatore istantaneamente.
Funzionalità del Visualizzatore
- Navigazione 3D: rotazione, panoramica, zoom, adattamento alla vista
- Albero del modello: navigatore gerarchico dei componenti
- Pannello proprietà: metadati e attributi degli oggetti
- Strumenti di misurazione: distanza, area, angolo
- Piani di sezione: viste in sezione
- Viste esplose: per gli assemblaggi
- Modalità telecamera: ortografica e prospettica
- Modalità schermo intero
Supporto File ZIP
Per modelli complessi con file multipli e dipendenze (file Revit collegati, assemblaggi con riferimenti esterni, modelli con texture):
- Creare un archivio ZIP contenente tutti i file del modello
- Denominare chiaramente il file principale (es.
main.rvt,assembly.sldasm) - Caricare lo ZIP — Sutram lo invia ad APS, che rileva automaticamente il file principale
Requisito: "Includi file ZIP nella conversione CAD" deve essere abilitato nelle Impostazioni Progetto.
Configurazione di Autodesk APS
Questa è un'integrazione Bring Your Own Key (BYOK). Si forniscono le proprie credenziali Autodesk e l'utilizzo di APS viene fatturato direttamente al proprio account Autodesk.
- Creare un'app su aps.autodesk.com (piano gratuito: ~100 crediti/mese)
- Andare su Impostazioni Progetto → Integrazioni → Servizi Autodesk
- Attivare "Consenti Visualizzatore CAD Autodesk"
- Inserire il proprio Client ID e Client Secret
- Opzionalmente abilitare "Converti automaticamente i file CAD dopo il caricamento" e "Includi file ZIP nella conversione CAD"
- Fare clic su Salva
Disponibile su: Piano Pro e superiori
File di Testo e Codice
Testo Semplice
Estensioni: .txt, .log, .conf, .cfg, .ini, .properties, .yaml, .yml, .toml, .rtf
Visualizzato con carattere a spaziatura fissa.
File di Codice (oltre 40 Linguaggi)
Estensioni: .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 altri.
Visualizzati con evidenziazione della sintassi, numeri di riga e formattazione leggibile.
Disponibile su: Tutti i piani
File di Dati Strutturati
| Formato | Funzionalità |
|---|---|
CSV (.csv) |
Tabella interattiva con intestazioni di colonna e colonne ordinabili |
JSON (.json) |
Formattato con evidenziazione della sintassi, oggetti espandibili/comprimibili |
XML (.xml) |
Formattato con evidenziazione dei tag |
Disponibile su: Tutti i piani
Link Video (Incorporati)
Piattaforme Supportate:
- 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)
Funzionalità: Player incorporato, tracciamento del progresso di visione (riprendi da dove hai interrotto), visualizzazione della durata, anteprime delle miniature, metadati della piattaforma, supporto schermo intero.
Come aggiungere: Fare clic su "Aggiungi Link Video" nel contenuto del progetto, incollare l'URL, e Sutram rileva automaticamente la piattaforma e recupera i metadati.
Disponibile su: Tutti i piani
Link Audio (Incorporati)
Piattaforme Supportate:
- Spotify: Brani, album, playlist, podcast
- SoundCloud: Brani e playlist
- Apple Podcasts: Link agli episodi
- Piattaforme Podcast: Anchor, Fireside, Buzzsprout, Podbean, Simplecast, Transistor, Megaphone
- URL Audio Personalizzati: Link diretti MP3, OGG
Funzionalità: Player incorporato, visualizzazione artwork, metadati artista, durata, controlli di riproduzione.
Come aggiungere: Fare clic su "Aggiungi Link Audio" nel contenuto del progetto e incollare l'URL.
Disponibile su: Tutti i piani
Link Web
Qualsiasi URL HTTP/HTTPS può essere aggiunto come elemento di contenuto. Sutram recupera automaticamente il titolo della pagina, la descrizione e la favicon per la visualizzazione. Cliccando sul link si apre in una nuova scheda.
Come aggiungere: Fare clic su "Aggiungi Link Web" nel contenuto del progetto e incollare l'URL.
Disponibile su: Tutti i piani
Caricamento dei File
Come Funziona
- Fare clic su Carica File o trascinare e rilasciare i file nel progetto
- Il sistema verifica la dimensione del file rispetto ai limiti del piano
- I file vengono caricati direttamente nello storage con una barra di avanzamento
- Dopo il caricamento, i file vengono elaborati automaticamente in base al tipo:
- Immagini, video, audio (Pro+): Compressi/ottimizzati in background
- File CAD (Pro+): Inviati per la conversione tramite Autodesk APS
- File Office: Convertiti in PDF alla prima anteprima (se il visualizzatore Microsoft è disabilitato)
- Viene visualizzata una notifica quando l'elaborazione è completata
- Tutti i membri del progetto vedono il nuovo file in tempo reale
Stato del File
- In caricamento: Il file è in fase di caricamento
- In elaborazione: Compressione o ottimizzazione in corso
- In conversione: Conversione CAD tramite Autodesk in corso
- Pronto: Il file è pronto per la visualizzazione e il download
Anteprima dei Contenuti
Finestra di Anteprima
Fare clic su qualsiasi elemento di contenuto per aprire la finestra di anteprima. La finestra si adatta al tipo di contenuto:
- File (immagini, PDF, Office, CAD): Visualizzatore inline con pulsante di download
- Link video/audio: Player incorporato
- Link web: Si apre in una nuova scheda con anteprima dei metadati
Navigazione
- Tasti freccia: Navigare tra gli elementi (sinistra/destra)
- ESC: Chiudere la finestra
- F: Attivare/disattivare lo schermo intero
- Pulsante di download disponibile per tutti i tipi di file
Conversione in Tempo Reale
Per i file CAD e Office che richiedono la conversione:
- La finestra mostra un indicatore "Conversione in corso..."
- La conversione avviene in background
- Al completamento, il visualizzatore si carica automaticamente — non è necessario aggiornare la pagina
- È possibile lasciare la finestra aperta e osservare il completamento della conversione
Download dei File
- Fare clic sul pulsante Download nella finestra di anteprima o nell'elenco dei contenuti
- Il browser scarica il file con il suo nome originale
- I link di download scadono dopo 1 ora per motivi di sicurezza
Configurazione delle Integrazioni
Tutte le integrazioni con servizi esterni sono controllate per progetto in Impostazioni Progetto → Integrazioni.
Visualizzatore Microsoft Office 365
| Impostazione | Predefinito | Descrizione |
|---|---|---|
| Consenti Visualizzatore Microsoft Office 365 | Disattivato | Abilita la visualizzazione Office basata su cloud con piena fedeltà |
Nessuna credenziale necessaria. Quando disabilitato, i file Office vengono convertiti localmente in PDF.
Autodesk Platform Services (Visualizzatore CAD)
| Impostazione | Obbligatorio | Descrizione |
|---|---|---|
| Consenti Visualizzatore CAD Autodesk | Sì | Interruttore principale per la visualizzazione CAD |
| Client ID | Sì | Il proprio Client ID APS |
| Client Secret | Sì | Il proprio Client Secret APS (crittografato nel database) |
| Nome Bucket | No | Nome bucket personalizzato (generato automaticamente se vuoto) |
| Converti automaticamente i file CAD | No | Converte i file CAD immediatamente dopo il caricamento |
| Includi ZIP nella conversione CAD | No | Elabora i file ZIP contenenti file CAD |
Regole di validazione:
- Le credenziali sono obbligatorie quando il Visualizzatore CAD è abilitato
- Il supporto ZIP richiede che la conversione automatica sia abilitata prima
Risoluzione dei Problemi
"Anteprima non disponibile per questo tipo di file"
Il formato del file non è supportato. Scaricare il file e aprirlo nell'applicazione appropriata.
"File troppo grande per l'anteprima"
I file di testo e codice hanno un limite di anteprima di 5 MB. Scaricare il file in alternativa.
"Visualizzatore CAD Non Configurato"
Le credenziali Autodesk APS sono mancanti. Andare su Impostazioni Progetto → Integrazioni → Servizi Autodesk e inserire il proprio Client ID e Client Secret.
"Conversione del documento Office fallita"
Provare ad abilitare il Visualizzatore Microsoft Office 365 nelle Impostazioni Progetto per una migliore compatibilità. Se si utilizza la conversione LibreOffice, il file potrebbe essere corrotto — provare a ricaricarlo.
Il link video/audio mostra "URL Non Valido"
Verificare che l'URL sia valido. Provare a copiarlo direttamente dalla piattaforma (non un link abbreviato).
Conversione CAD bloccata
Attendere fino a 10 minuti per i modelli complessi. Aggiornare la pagina. Controllare lo stato del servizio Autodesk su status.autodesk.com. Provare a ricaricare il file.
Limiti di Dimensione dei File
| Tipo di Contenuto | Limite Anteprima | Limite Caricamento |
|---|---|---|
| Immagini | Nessun limite | Dipende dal piano |
| Nessun limite | Dipende dal piano | |
| Markdown | 5 MB | Dipende dal piano |
| Codice/Testo | 5 MB | Dipende dal piano |
| Office | Nessun limite | Dipende dal piano |
| CAD | Nessun limite | Dipende dal piano |
| Link video/audio | N/D | N/D (solo link) |
I limiti di caricamento dipendono dal piano di abbonamento:
- Basic: 10 MB per file
- Pro: 500 MB per file
- Plus: 1 GB per file
- Max: 2 GB per file
Matrice Completa dei Formati Supportati
| Categoria | Formati | Configurazione |
|---|---|---|
| Immagini | JPEG, PNG, GIF, WebP, SVG, BMP | Nessuna |
| Nessuna | ||
| Markdown | MD, MARKDOWN | Nessuna |
| Office | DOCX, DOC, XLSX, XLS, PPTX, PPT | Impostazione progetto (opzionale) |
| CAD (2D) | DWG, DXF, DWF, DWFX | Credenziali APS (Pro+) |
| CAD (3D) | STEP, IGES, STL, OBJ, FBX, GLTF, GLB, DAE | Credenziali APS (Pro+) |
| BIM | RVT, IFC, NWD, NWF, NWC | Credenziali APS (Pro+) |
| SolidWorks | SLDPRT, SLDASM, SLDDRW | Credenziali APS (Pro+) |
| CATIA | CATPart, CATProduct, CGR | Credenziali APS (Pro+) |
| Inventor | IPT, IAM, IDW, IPN | Credenziali APS (Pro+) |
| Fusion 360 | F3D, F2D, F3Z | Credenziali APS (Pro+) |
| 3ds Max | MAX | Credenziali APS (Pro+) |
| Revit | RVT, RTE | Credenziali APS (Pro+) |
| Alias / VRED | WIRE, VPB | Credenziali APS (Pro+) |
| Siemens NX | PRT | Credenziali APS (Pro+) |
| Navisworks | NWD, NWF, NWC | Credenziali APS (Pro+) |
| Codice | JS, TS, PY, RB, EX, e oltre 35 altri | Nessuna |
| Dati | CSV, JSON, XML | Nessuna |
| Testo | TXT, LOG, CONF, YAML, TOML, RTF, ecc. | Nessuna |
| Link Video | YouTube, Vimeo, Dailymotion, TikTok, Wistia, Loom | Nessuna |
| Link Audio | Spotify, SoundCloud, Apple Podcasts, e altri 7 | Nessuna |
| Link Web | Qualsiasi URL | Nessuna |
Domande Frequenti
D: Posso visualizzare i file in anteprima senza scaricarli? R: Sì, la maggior parte dei tipi di file può essere visualizzata in anteprima direttamente nel browser. Solo i formati non supportati richiedono il download.
D: I miei dati vengono inviati a servizi esterni? R: Solo se lo si abilita esplicitamente. Il Visualizzatore Microsoft Office 365 e Autodesk APS sono attivabili su richiesta per ogni progetto. Quando disabilitati, tutta l'elaborazione avviene localmente sul server Sutram.
D: Perché il mio file CAD impiega così tanto a caricarsi? R: I file CAD devono essere convertiti in un formato visualizzabile sul web da Autodesk. Questo richiede tipicamente da 30 secondi a 5 minuti a seconda della complessità. Una volta convertiti, le visualizzazioni successive sono istantanee (memorizzate nella cache).
D: Perché il mio file Excel appare diverso nell'anteprima? R: Se il Visualizzatore Microsoft Office 365 è disabilitato, i file Excel vengono convertiti in PDF localmente, il che potrebbe perdere parte della formattazione (formule mostrate come valori, fogli larghi paginati). Abilitare il Visualizzatore Office 365 nelle Impostazioni Progetto per la piena fedeltà.
D: Devo pagare per Autodesk APS? R: Autodesk offre un piano gratuito (~100 crediti/mese). Per un utilizzo maggiore, ci si abbona direttamente con Autodesk. Sutram non addebita costi per l'utilizzo di APS — si utilizzano le proprie credenziali (modello BYOK).
D: Cosa succede alle conversioni CAD quando elimino un file? R: Quando un file viene eliminato definitivamente (dal cestino), le risorse Autodesk associate vengono automaticamente eliminate.
D: Posso visualizzare i file su dispositivi mobili? R: Sì, tutti i visualizzatori funzionano sui browser mobili moderni (iOS Safari, Android Chrome). I modelli CAD molto grandi potrebbero avere prestazioni ridotte sui dispositivi mobili.
D: Dove posso vedere il mio progresso di visione dei video? R: I link video tracciano automaticamente il progresso di visione. Quando si riapre un video, la riproduzione riprende da dove si era interrotta.