KSIDol-Dokumentation > KSIDol-Module > Dokumente per Drag & Drop

Modulanleitung: Dokumente per Drag & Drop

Nicht-technische Anleitung: wofür das Modul dient, wie man es verwendet und wie es mit Dolibarr zusammenspielt.

KompatibilitätDolibarr 18 bis 24

Einstellungsoptionen3 Ein/Aus-Einstellungen

Auswirkung auf die DatenbankKeine Tabelle angelegt

GeltungsbereichAlle Datensätze mit Reiter „Dokumente"

1. Moduluberblick

Das Modul „Dokumente per Drag & Drop" bringt den Komfort des Ziehens und Ablegens auf die Datensätze von Dolibarr. Anstatt auf die Schaltfläche + zu klicken, ein Fenster zu öffnen, Ihre Festplatte zu durchsuchen und dann zu bestätigen, greifen Sie eine Datei (oder einen Link) und legen sie direkt auf einem eigens dafür vorgesehenen Bereich ab, der unter dem Titel des Blocks „Angehängte Dateien und Dokumente" bzw. „Verknüpfte Dateien und Dokumente" erscheint. Das Dokument wird damit in einer einzigen Aktion an den Datensatz angehängt. Das Modul ersetzt nichts: Es legt lediglich eine visuelle Ebene über die vorhandenen Dokumentenblöcke von Dolibarr. Der Upload verwendet unverändert das native Formular von Dolibarr und all seine Prüfungen (Sicherheitstoken, Kennung und Typ des Objekts, Benutzerrechte, maximale Upload-Größe, Kontrollen). Keine Datei des Dolibarr-Kerns wird verändert, und nichts wird an einem anderen Ort gespeichert als dort, wo Dolibarr Ihre Anhänge üblicherweise ablegt.

Wird als externes Modul installiert und über die Liste der Dolibarr-Module aktiviert
Funktioniert überall dort, wo ein Datensatz den Reiter / den Block „Dokumente" besitzt (Geschäftspartner, Rechnungen, Angebote, Bestellungen, Produkte, Projekte usw.)
Legt keine Tabelle, kein Menü und keine geplante Aufgabe an: Es ist lediglich eine Verbesserung der Oberfläche
Nutzt die nativen Upload-Formulare von Dolibarr: gleiche Rechte, gleiche Grenzen, gleiche Sicherheitsprüfungen
Oberfläche verfügbar in Französisch, Englisch, Italienisch, Deutsch und Spanisch, je nach Sprache des Benutzers

2. Dateien per Drag & Drop ablegen

Auf jedem Datensatz, der den Block „Angehängte Dateien und Dokumente" besitzt, wird unter dem Blocktitel ein Ablagebereich hinzugefügt, mit der Aufforderung „Ziehen Sie Ihre Dateien hierher".

Ziehen Sie eine Datei von Ihrem Computer und lassen Sie sie über dem Bereich los: Sie wird automatisch an den Datensatz angehängt
Das Ablegen mehrerer Dateien gleichzeitig wird unterstützt (eine Meldung zeigt „X Dateien werden hochgeladen…")
Der Upload erfolgt über das native Upload-Formular von Dolibarr: Die Datei wird genau dort abgelegt, wo sie die Schaltfläche + abgelegt hätte
Während des Uploads wird eine Fortschrittsmeldung angezeigt; wird in der Ablage keine Datei erkannt, meldet dies eine Fehlermeldung

3. Einen Link (URL) per Drag & Drop ablegen

Auf Datensätzen, die den Block „Verknüpfte Dateien und Dokumente" besitzen, erscheint ein zweiter Ablagebereich mit der Aufforderung „Ziehen Sie einen Link hierher", um eine Webadresse statt einer Datei zu verknüpfen.

Ziehen Sie einen Link (aus der Adressleiste, einem Lesezeichen, einer E-Mail oder einer Webseite) und legen Sie ihn auf dem Bereich ab
Das Modul erkennt Adressen, die mit http, https, ftp oder mailto beginnen; eine ungültige Adresse wird mit einer Meldung angezeigt
Eine Bezeichnung wird automatisch übernommen, wenn der gezogene Link eine enthält (der Linktext der Ursprungsseite)
Der Link wird über das native Links-Formular von Dolibarr gespeichert; wird er ohne verwertbare URL abgelegt, erscheint die Meldung „Keine URL erkannt"

4. Klicken statt Ablegen (Ausweichlösung)

Wenn Sie lieber klicken oder wenn Drag & Drop nicht praktisch ist (Tablet, misslungene Geste), sind die Ablagebereiche auch anklickbar.

Ein Klick auf den Dateibereich öffnet die übliche Dateiauswahl, um ein Dokument auf Ihrem Gerät auszuwählen
Ein Klick auf den Linkbereich blendet das native Feld ein und setzt den Cursor hinein, um die Adresse von Hand einzugeben
Erlaubt Ihr Browser kein direktes Ablegen, zeigt das Modul automatisch das klassische Dolibarr-Formular an, damit Sie den Vorgang ohne Blockade abschließen können

5. Barrierefreiheit über die Tastatur

Die Ablagebereiche lassen sich ohne Maus verwenden, für Personen, die mit der Tastatur navigieren.

Die Bereiche sind über die Tabulatortaste erreichbar
Die Tasten Eingabe und Leertaste aktivieren den Bereich: Öffnen der Dateiauswahl oder Wechsel zum Linkfeld

6. Visuelle Rückmeldungen und geführte Meldungen

Das Modul begleitet jede Aktion mit einer klaren visuellen Rückmeldung, um jede Unklarheit darüber zu beseitigen, was gerade geschieht.

Der Bereich ändert beim Ziehen sein Aussehen beim Überfahren („Loslassen zum Ablegen")
Je nach Ergebnis wird ein Erfolgszustand (grüner Rahmen) oder Fehlerzustand (roter Rahmen) angezeigt
Die Meldungen (Upload läuft, Link wird hinzugefügt, fehlende Datei, nicht kompatibler Browser…) passen sich der Sprache des Benutzers an

7. Konfiguration und Anpassung

Das Modul verfügt über eine Konfigurationsseite, die über die Modulliste erreichbar ist, mit drei einfachen Schaltern (aktiviert / deaktiviert). Alle sind standardmäßig aktiviert.

Native +-Schaltflächen ausblenden: blendet die +-Schaltflächen der Datei- und Linkblöcke aus, um Drag & Drop hervorzuheben (die nativen Formulare werden im Hintergrund weiterhin verwendet); deaktivieren Sie diese Einstellung, um die gewohnten Schaltflächen wieder erscheinen zu lassen
Abgelegte Links automatisch bestätigen: Ein abgelegter Link wird sofort gespeichert; deaktiviert wird er vorausgefüllt, aber Ihrer Bestätigung überlassen
Die Ausweich-Dateiauswahl automatisch bestätigen: Wenn Sie über den Klick und die Dateiauswahl gehen, startet der Upload automatisch nach der Auswahl der Datei
Die Konfigurationsseite weist darauf hin, dass keine Änderung am Dolibarr-Kern vorgenommen wird

8. Verknupfungen mit Dolibarr

Das Modul arbeitet nicht isoliert: Es ist mit den nativen Bausteinen von Dolibarr verzahnt.

Dokumente und angehängte Dateien : Das Modul setzt am nativen Block „Angehängte Dateien und Dokumente" an, der auf den Dolibarr-Datensätzen vorhanden ist. Das Ablegen einer Datei verwendet das native Upload-Formular, sodass die Datei genau wie mit der gewohnten Schaltfläche + gespeichert und aufgelistet wird.
Links / verknüpfte Dokumente : Auf die gleiche Weise stützt es sich auf den nativen Block „Verknüpfte Dateien und Dokumente", um eine Webadresse über das Standard-Links-Formular von Dolibarr an den Datensatz anzuhängen.
Native Datensätze (Geschäftspartner, Rechnungen, Angebote, Bestellungen, Produkte, Projekte…) : Da es auf die generischen Dokumentenblöcke von Dolibarr abzielt, funktioniert es automatisch auf allen Datensätzen, die diese Blöcke besitzen: Geschäftspartner, Rechnungen, Angebote, Bestellungen, Produkte, Projekte und andere Objekte, die mit dem Reiter Dokumente ausgestattet sind.
Sicherheit, Rechte und Grenzen von Dolibarr : Nichts umgeht Dolibarr: Das Modul verwendet den Sicherheitstoken (CSRF), die Kennung und den Typ des Objekts, die Rechte des Benutzers und die nativ definierte maximale Upload-Größe wieder. Es legt weder ein Recht noch eine Tabelle noch einen spezifischen Einstiegspunkt an.