Teilen

Freigaben

Öffentliche Links für Dateien und unterstützte Datensätze erstellen, absichern und eingehende Einsendungen prüfen.

Freigaben

Freigaben erzeugen öffentliche Links für Dateien und unterstützte Datensätze. Nutze sie, wenn jemand ohne normales Konto Daten ansehen, Änderungen vorschlagen, Dateien hochladen oder neue Informationen einreichen soll.

Wo Freigaben verwendet werden

  • Öffne Freigaben, um alle Links des aktuellen Workspaces zu prüfen.
  • Neue Freigaben entstehen in den jeweiligen Modulen, zum Beispiel in Dateien, Gebäuden, Geräten und Werkzeugen.
  • Das Modul hängt von der Capability shares ab. Feature-Sichtbarkeit und Sidebar-Konfiguration werden in Systemeinstellungen verwaltet.

Modell einer Freigabe

  • Eine Freigabe gehört zu genau einem Workspace und genau einer Ziel-Collection wie files, buildings, equipment, tools oder organizations.
  • Gespeichert werden Berechtigung (read, edit oder create), optionaler Titel und Nachricht, Ablaufdatum, Widerruf, Passwort-Hash, Pflicht für persönliche Angaben, Maximalnutzungen und aktueller Nutzungszähler.
  • read- und edit-Freigaben verweisen über shareItems auf bestehende Datensätze.
  • create-Freigaben brauchen keine bestehenden Datensätze. Sie öffnen ein öffentliches Formular für die Ziel-Collection.
  • Öffentliche Interaktionen landen in shareAccessLogs und shareSubmissions.
  • Bearbeitungs-Einsendungen erzeugen zusätzlich Einträge im Versions-System.

Berechtigungsmodi

Read

  • Empfänger öffnen die öffentliche Seite und sehen freigegebene Felder.
  • Angezeigt werden nur Felder, die in den Backend-Felddefinitionen öffentlich erlaubt sind.
  • Read-Freigaben nehmen keine Einsendungen an.
  • Das Öffnen einer öffentlichen Freigabe benachrichtigt die Besitzerin oder den Besitzer, höchstens einmal pro Freigabe und Tag.

Edit

  • Empfänger sehen ein öffentliches Formular mit Daten des freigegebenen Datensatzes.
  • Eine Einsendung erzeugt shareSubmission und eine ausstehende Version zur internen Prüfung.
  • Der Ersteller der Freigabe bekommt Benachrichtigungen über Einsendung und Version.

Create

  • Empfänger sehen ein leeres öffentliches Formular für die Ziel-Collection.
  • Bei Nicht-Datei-Collections speichert die aktuelle Implementierung die Einsendung zur internen Prüfung. Der finale Datensatz wird beim ersten Submit nicht direkt angelegt.
  • Für die Collection files arbeitet create als Upload-Link. Hochgeladene Dateien werden in Dateien mit pendingReview und Referenz auf die Freigabe angelegt.

Öffentlicher Ablauf

  1. Ein Empfänger öffnet /s/:shareId.
  2. Wenn ein Passwort gesetzt ist, muss die Freigabe zuerst entsperrt werden.
  3. Wenn persönliche Angaben Pflicht sind, werden Name und E-Mail abgefragt. Firma ist optional.
  4. Danach rendert die öffentliche Seite genau eine von drei Ansichten:
    • read: reine Detailansicht
    • edit: vorausgefülltes Formular für Änderungsvorschläge
    • create: leeres Formular oder Upload-Zone bei Datei-Freigaben
  5. Erfolgreiche Ansichten und Einsendungen erhöhen den Nutzungszähler. Ansichten können zusätzlich die Besitzerin oder den Besitzer benachrichtigen; Einsendungen verwenden eigene Einsendungs- und Versionsbenachrichtigungen.

Feldsichtbarkeit und Formularumfang

  • Die öffentliche Sichtbarkeit wird pro Feld in den Backend-Metadaten gesteuert, nicht frei im UI.
  • Felder mit never sind für öffentliche Ansicht und öffentliche Einsendungen gesperrt.
  • Felder mit opt-in werden nur freigegeben, wenn der Ersteller sie im Freigabe-Dialog aktiviert.
  • Die Opt-in-Auswahl gibt es für edit- und create-Freigaben.
  • Relationsfelder in öffentlichen Formularen nutzen freigabebezogene Optionenabfragen, damit nur die minimal nötigen Labels sichtbar sind.

Freigaben verwalten

  • Die Liste unter Freigaben zeigt Titel, Collection, Berechtigung, Anzahl der Elemente, Nutzungen, Status, Erstellungsdatum und Ablauf.
  • In den Zeilenaktionen kannst du die öffentliche URL kopieren, die Freigabe bearbeiten, widerrufen oder löschen.
  • Ein Widerruf setzt revokedAt und archiviert den Link.
  • Beim Löschen werden Freigabe, zugehörige Elemente, Einsendungen und Zugriffslogs entfernt.
  • Die Standardbearbeitung ändert Metadaten und Sicherheitsoptionen. Die verknüpften Elemente werden dabei aktuell nicht ersetzt.

Wichtiges aktuelles Verhalten

  • Datei-Freigaben sind der eigentliche Multi-Item-Fall. Sie rendern alle verknüpften Dateien mit Download- oder Upload-Verhalten.
  • Nicht-Datei-Freigaben können technisch mehrere verknüpfte Elemente speichern, aber der aktuelle öffentliche Viewer lädt für read und edit nur das erste verknüpfte Element.
  • maxUses zählt keine eindeutigen Besucher. Der Zähler steigt bei erfolgreichen öffentlichen Ansichten und erneut bei erfolgreichen Einsendungen oder Uploads.
  • Passwörter werden nur gehasht gespeichert. Öffentliche Endpunkte sind rate-limitiert.
  • Zugriffslogs existieren im Backend für Audits, aber die normale Freigabenliste zeigt aktuell Zusammenfassungen statt eines vollständigen Log-Viewers.

Verwandte Dokumente