Passa al contenuto principale

Documenti

I documenti in SDA offrono un repository flessibile e con versionamento per qualsiasi tipo di file o materiale di riferimento che si desidera associare agli asset nell'intera piattaforma. Costituiscono una posizione centralizzata per archiviare, organizzare e tracciare i contenuti, siano essi di natura tecnica, operativa o amministrativa. Poiché i documenti possono essere collegati a gateway, dispositivi, progetti, pipeline e altre risorse, contribuiscono a mantenere il contesto completo del proprio ambiente di automazione.

Panoramica​

I documenti rappresentano file di uso generale che possono essere caricati, archiviati, versionati e richiamati all'interno dell'intera piattaforma SDA. Sono supportati sia i formati documentali tradizionali, come documenti Word, presentazioni PowerPoint e PDF, sia file specifici dell'ambito OT, quali file di configurazione, registri delle modifiche, note di manutenzione o altri artefatti che devono rimanere associati a un dispositivo o a un progetto nel tempo.

I documenti consentono ai team di mantenere un'unica fonte di verità per materiali di riferimento, specifiche, procedure e file di supporto, sfruttando al contempo il modello di versionamento, tracciabilità e autorizzazioni di SDA.

Casi d'uso comuni​

I documenti possono supportare un'ampia gamma di flussi di lavoro industriali e operativi, tra cui:

  • Informazioni sulle apparecchiature
    Archiviare manuali, schemi elettrici, specifiche degli azionamenti o schede tecniche direttamente insieme a un dispositivo.
  • Requisiti e specifiche di sistema
    Mantenere specifiche di progettazione, schede dei requisiti o descrizioni funzionali del controllo associate a un progetto.
  • Registri di manutenzione e assistenza
    Caricare rapporti di ispezione, registri di manutenzione e documenti di assistenza come parte dello storico operativo di un dispositivo.
  • Procedure operative
    Mantenere accessibili e sotto controllo di versione le procedure operative standard, le note di passaggio turno o le guide alla risoluzione dei problemi.
  • File di configurazione e di supporto
    Allegare file di configurazione, script, set di parametri o documentazione che devono accompagnare un dispositivo, un gateway o un progetto.

Funzionalità principali​

1. Versionamento​

Tutti i documenti in SDA sono versionati per impostazione predefinita. Ogni caricamento o modifica crea una nuova versione, consentendo agli utenti di:

  • Tracciare le modifiche nel tempo
  • Ripristinare le versioni precedenti
  • Comprendere la cronologia del documento durante l'evoluzione degli asset
  • Mantenere verificabilità e tracciabilità ai fini della conformità

2. Collegamento all'interno della piattaforma​

I documenti possono essere associati a molti tipi di oggetti, tra cui:

  • Gateway
  • Dispositivi
  • Progetti
  • Pipeline
  • Gruppi di risorse
  • E altri ancora, con l'ampliarsi delle funzionalità della piattaforma

Questa associazione a livello di oggetto garantisce che i documenti rimangano contestualmente pertinenti e facili da individuare.

3. Visualizzatori e strumenti di confronto​

SDA offre attualmente funzionalità di visualizzazione e confronto nel browser per i documenti basati su testo, inclusi file di configurazione, script e documentazione in testo semplice.

Le funzionalità supportate includono:

  • Visualizzazione inline
  • Vista diff affiancata
  • Confronto tra versioni
  • Evidenziazione delle modifiche

Ulteriori tipi di documento, compresi formati più ricchi come PDF, documenti Office e formati binari, saranno supportati nelle prossime release.

4. Supporto flessibile dei file​

I documenti possono includere praticamente qualsiasi tipo di file rilevante per la progettazione, le operazioni o la conformità, incluso ma non limitato a:

  • Word, Excel, PowerPoint
  • PDF
  • File di testo e markdown
  • File di configurazione dei dispositivi
  • Artefatti di configurazione XML / JSON
  • Immagini o diagrammi
  • File di supporto vari

Organizzazione e gestione dei documenti​

Ogni documento archiviato in SDA include:

  • Nome e descrizione – per un'identificazione leggibile dall'utente
  • Tipo di file e metadati – estensione, dimensione, numero di versione
  • Oggetti associati – dove il documento è collegato all'interno della piattaforma
  • Cronologia delle versioni – registro cronologico di tutte le modifiche
  • Autorizzazioni – applicate tramite il modello di controllo degli accessi basato sui ruoli di SDA

I team possono caricare nuovi documenti, sostituire file esistenti, consultare la cronologia delle versioni e gestire le associazioni direttamente dall'interfaccia SDA per dispositivi, gateway o progetti.

Sviluppi futuri​

L'area funzionale Documenti sarà ampliata nelle prossime release per includere:

  • Visualizzatori avanzati per i formati Office
  • Funzionalità di confronto dei PDF
  • Anteprima migliorata per i formati binari
  • Metadati estesi e tagging dei documenti
  • Integrazioni di workflow (ad es. approvazioni, stati del ciclo di vita)