Dokumente
Dokumente bieten in SDA ein flexibles, versioniertes Repository für jede Art von Datei oder Referenzmaterial, das Sie Assets plattformweit zuordnen möchten. Sie dienen als zentraler Ort, um Inhalte zu speichern, zu organisieren und nachzuverfolgen – unabhängig davon, ob diese technischer, betrieblicher oder administrativer Natur sind. Da sich Dokumente mit Gateways, Geräten, Projekten, Pipelines und weiteren Ressourcen verknüpfen lassen, tragen sie dazu bei, den vollständigen Kontext Ihrer Automatisierungsumgebung zu erhalten.
%20(1).webp)

Überblick
Dokumente sind Dateien für allgemeine Zwecke, die in der SDA-Plattform hochgeladen, gespeichert, versioniert und referenziert werden können. Unterstützt werden sowohl klassische Dokumentformate – etwa Word-Dokumente, PowerPoint-Präsentationen und PDFs – als auch praxisnahe OT-spezifische Dateien wie Konfigurationsdateien, Änderungsprotokolle, Wartungsnotizen oder andere Artefakte, die dauerhaft bei einem Gerät oder Projekt verbleiben sollen.
Dokumente ermöglichen es Teams, eine einheitliche verlässliche Quelle für Referenzmaterialien, Spezifikationen, Verfahren und unterstützende Dateien zu pflegen – und dabei die Versionierung, Auditierbarkeit und das Berechtigungsmodell von SDA zu nutzen.
Typische Anwendungsfälle
Dokumente unterstützen ein breites Spektrum industrieller und betrieblicher Abläufe, darunter:
- Geräteinformationen
Handbücher, Schaltpläne, Antriebsspezifikationen oder Datenblätter direkt beim Gerät hinterlegen. - Systemanforderungen & Spezifikationen
Engineering-Spezifikationen, Anforderungslisten oder Steuerungsbeschreibungen zu einem Projekt pflegen. - Wartungs- & Serviceunterlagen
Prüfberichte, Wartungsprotokolle und Servicedokumente als Teil der Betriebshistorie eines Geräts hochladen. - Betriebsanweisungen
Standardarbeitsanweisungen, Schichtübergabeprotokolle oder Anleitungen zur Fehlerbehebung zugänglich und versioniert vorhalten. - Konfigurations- & Begleitdateien
Konfigurationsdateien, Skripte, Parametersätze oder Dokumentation anhängen, die einem Gerät, Gateway oder Projekt folgen müssen.
Wesentliche Funktionen
1. Versionierung
Alle Dokumente in SDA werden standardmäßig versioniert. Jeder Upload und jede Änderung erzeugt eine neue Version, sodass Benutzer:
- Änderungen über die Zeit nachverfolgen
- Frühere Versionen wiederherstellen
- Die Dokumenthistorie im Zuge der Weiterentwicklung von Assets nachvollziehen
- Auditierbarkeit und Nachvollziehbarkeit für Compliance-Zwecke wahren
2. Verknüpfung über die Plattform hinweg
Dokumente lassen sich mit vielen Objekttypen verknüpfen, darunter:
- Gateways
- Geräte
- Projekte
- Pipelines
- Ressourcengruppen
- Und weitere, sobald der Funktionsumfang der Plattform wächst
Diese Zuordnung auf Objektebene sorgt dafür, dass Dokumente im richtigen Kontext bleiben und leicht auffindbar sind.
3. Viewer und Vergleichswerkzeuge
SDA bietet derzeit Ansicht und Vergleich im Browser für textbasierte Dokumente, einschließlich Konfigurationsdateien, Skripten und einfacher Textdokumentation.
Unterstützt werden dabei:
- Inline-Darstellung
- Vergleichsansicht nebeneinander
- Vergleich von Version zu Version
- Hervorhebung von Änderungen
Weitere Dokumenttypen – darunter komplexere Formate wie PDFs, Office-Dokumente und Binärformate – werden in kommenden Releases unterstützt.
4. Flexible Dateiunterstützung
Dokumente können praktisch jeden Dateityp umfassen, der für Engineering, Betrieb oder Compliance relevant ist, unter anderem:
- Word, Excel, PowerPoint
- PDFs
- Text- & Markdown-Dateien
- Gerätekonfigurationsdateien
- XML-/JSON-Konfigurationsartefakte
- Bilder oder Diagramme
- Sonstige unterstützende Dateien
Organisation & Verwaltung von Dokumenten
Jedes in SDA gespeicherte Dokument umfasst:
- Name & Beschreibung – zur verständlichen Identifikation
- Dateityp & Metadaten – Endung, Größe, Versionsnummer
- Zugeordnete Objekte – wo das Dokument innerhalb der Plattform verknüpft ist
- Versionshistorie – chronologische Aufzeichnung aller Änderungen
- Berechtigungen – durchgesetzt über das rollenbasierte Zugriffsmodell von SDA
Teams können neue Dokumente hochladen, bestehende Dateien ersetzen, die Versionshistorie einsehen und Zuordnungen direkt in der SDA-Oberfläche für Geräte, Gateways oder Projekte verwalten.
Künftige Erweiterungen
Der Funktionsbereich Dokumente wird in kommenden Releases erweitert und umfasst dann:
- Vollwertige Viewer für Office-Formate
- Vergleichsfunktionen für PDFs
- Verbesserte Vorschau für Binärformate
- Erweiterte Metadaten und Tagging von Dokumenten
- Workflow-Integrationen (z. B. Freigaben, Lebenszyklusstatus)