Datenübertragung mit kitForm & kitUploader

Wenn es Ihnen darum geht, dass Ihnen gelegentlich ein Kunde einen Screenshot auf den Server hochladen kann verwenden Sie einfach den Standard Formular Generator von LEPTON CMS bzw. von WebsiteBaker.

Falls es Ihnen jedoch darum geht, daß

• Dateien die auf den Webserver übertragen werden grundsätzlich in einem geschützten Verzeichnis gesichert werden,
• nur berechtigte Personen auf die geschützten Dateien zugreifen können,
• alle Datenübertragungen im KeepInTouch Konto des jeweiligen Kunden protokolliert werden,
• der Kunde mit Hilfe von kitDirList jederzeit auf seine Dateien zugreifen kann,
• bei der Übertragung von größeren Dateien der Fortschritt der Übermittlung angezeigt wird,
• auch sehr große Dateien z.B. mit 150 oder 200 MB zuverlässig übertragen werden können,

dann wollen Sie deutlich mehr und sind bei kitForm richtig.

Die Grundidee bei Datenübertragungen über kitForm ist schlicht: so einfach und effektiv wie möglich.

Fügen Sie in kitForm einem beliebigen Formular einfach ein Datenfeld Datenübertragung hinzu:

und klicken Sie auf OK.

• Legen Sie den Feld Bezeichner nach Belieben fest.
• Lassen Sie die Übertragungsmethode zunächst auf standard stehen - wir sehen uns diese Option später noch genauer an.
• Bei Erlaubte Dateitypen tragen Sie - jeweils durch ein Komma getrennt - die Dateiendungen ein, deren Hochladen Sie gestatten möchten. Falls Sie dieses Feld leer lassen gestatten Sie die Datenübertragung von allen Dateitypen. Aus Sicherheitsgründen sollten Sie immer festlegen, welche Dateien auf Ihren Webserver übertragen werden dürfen.
• Bei Max. Dateigröße (MB) tragen Sie maximal erlaubte Dateigröße ein.

Anmerkung zur maximalen Dateigröße

Wie groß die Dateien sein dürfen, die auf Ihren Webspace übertragen werden können hängt davon ab wie Ihr Webserver konfiguriert ist. Maßgeblich sind hierbei die Einträge für UPLOAD_MAX_FILESIZE und POST_MAX_SIZE in der php.ini des Webserver. kitForm prüft diese beiden Werte ab und kappt zu große Werte automatisch bei dem höchst zulässigen Wert - Sie erhalten in diesem Fall eine entsprechende Meldung durch kitForm. Bei Webservern bei denen PHP als FastCGI Modul ausgeführt wird muss darüber hinaus der Wert für FcgidMaxRequestLen in der fcgid.conf mit den Einstellungen korrespondieren.

Lassen Sie Änderungen am Webserver bitte nur durch einen erfahrenen Webmaster durchführen!

Speichern Sie Ihr Formular und binden Sie es auf der gewünschten Seite mit dem kitForm Droplet ein (beispielhafter Aufruf):

[[kit_form?form=kit_uploader]]

Fertig!

Das Formular sieht "ganz normal" aus und verhält sich auch wie jedes andere Formular:

Die Unterschiede beginnen nach der Datenübertragung:

• kitForm verschiebt jede Datei automatisch in ein mit .htaccess geschütztes Verzeichnis
• ein direkter Zugriff auf die Datei ist nicht möglich (Vollschutz)
• das Verzeichnis ist eindeutig dem KeepInTouch Konto des Kunden zugeordnet, der die Datei hochgeladen hat
• die Systematik entspricht der automatischen Dokumentenverwaltung durch kitDirList mit dem Parameter kit_auto,
• Jede Datenübertragung wird im Protokoll des KeepInTouch Konto des Kunden dokumentiert, auf die Datei kann von dort aus direkt zugegriffen werden,
• Sowohl der Kunde als auch Sie erhalten eine E-Mail mit Informationen über die Datenübertragung.
• Sie können Ihrem Kunden jederzeit einen geschützten Zugriff auf die von ihm hochgeladenen Dateien gewähren (und natürlich weitere Dateien hinzufügen), hierzu verwenden Sie kitDirList zusammen mit dem Parameter kit_auto

Anzeige von Datenübertragungen im Protokoll des KeepInTouch Konto des jeweiligen Kunden:

Die Dateien können direkt per Klick geöffnet bzw. heruntergeladen werden.

kitForm legt alle übertragene Dateien automatisch in dem mit .htaccess geschützten Verzeichnis /media/kit_protected/ ab und erzeugt dort - sofern dieser noch nicht existiert - einen eigenen Ordner für jeden Ihrer Kunden der mit der E-Mail Adresse bezeichnet wird.

Beispiel: Der Kunde xyz hat am 09.12.2011 um 10:13 mit der E-Mail Adresse kunde@xyz.tld eine Datei übertragen, Sie finden die Datei unter:

/media/kit_protected/contacts/k/kunde@xyz.tld/111209-101300/

um 12:42 überträgt der Kunde weitere Dateien, sie finden diese unter:

/media/kit_protected/contacts/k/kunde@xyz.tld/111209-124200/

alles was Sie wissen müssen um auf übertragene Dateien zuzugreifen ist die E-Mail Adresse ihres Kunden und der ungefähre Zeitpunkt der Übermittlung.

Komfortable Übertragung von großen Dateien

Wenn Ihnen Ihre Kunden regelmäßig größere Dateien übermitteln ist das Standard Formular nicht so gut geeignet, da die Übermittlung immer einige Zeit benötigt und der Kunde nicht erkennen kann ob die Übertragung funktioniert und wie lange sie noch dauert.

Verwenden Sie in diesen Fällen die Erweiterung kitUploader.

Der kitUploader:

• ist geeignet für Datenübertragungen ab etwa 500 KB bis etwa 200 MB pro Datei
• zeigt im Dateiauswahldialog nur die tatsächlich erlaubten Dateitypen an
• zeigt sofort die Größe der zu übermittelnden Datei an
• blendet während der Datenübertragung einen Fortschrittsbalken ein
• gibt den Stand der Übermittlung zusätzlich als Prozentwert an

Nach der Installation von kitUploader können Sie im entsprechenden kitForm Formular die Übertragungsmethode für Datenübertragungen von standard auf uploadify ändern. Speichern Sie anschließend das Formular.

Weitere Änderungen oder Anpassungen sind nicht erforderlich!

Der kitUploader verwendet die jQuery Extension uploadify für die Darstellung der Übermittlung.

Diese Dokumentation ist sicherlich noch nicht vollständig, bitte helfen Sie mit KeepInTouch, kitForm, kitDirList und kitUploader zu verbessern!

Ralf Hertsch, 09.12.2011

Zurück zur Übersicht