Dateien werden nach dem Upload hier erscheinen

⇓ Details ein/ausblenden

Die Funktionsweise

Die A8Dropzone generiert POST-Requests genau wie ein Upload-Element eines normalen HTML-Formulars. D.h. die Programmierung auf der Serverseite MUSS nicht geändert werden.
Aber durch Einsatz der A8Dropzone KANN man Web-Applikationen - und speziell die Datei-Uploads - für die Benutzer absolut neu und extrem einfach gestalten: Seiteninhalte können dynamisch ausgetauscht werden. Zur Demonstration bitte das oben stehende Video ansehen und natürlich die A8Dropzone selbt testen!
Übrigens: Hat der Benutzer ein Bild in der Systen-Zwischenablage und klickt einfach auf die A8Dropzone, so konvertiert die A8Dropzone das Bild in das PNG-Format und öffnet es im Image Center - optimal auch für Screenshots!

Einfache Integration

Stellen Sie einfach die Datei a8dropzone.jar auf Ihren Server und betten Sie z.B. so in Ihren HTML-Code ein:

<applet mayscript code="at.activ8.A8Dropzone.A8Dropzone" codebase="../a8dropzone" archive="a8dropzone-2.5.jar" name="A8Dropzone" width="150" height="50">
  <param name="postURL" value="http://your.domain.com/someURLForUploads">
  <param name="postParam0" value="someParam1=someValue1">
  <param name="postParam1" value="someParam2=someValue2">
  <param name="javascriptFunction" value="updateFiles">
  <param name="label" value="Dropzone">
  <param name="encoding" value="UTF-8">
  <param name="directoryUpload" value="true">
</applet>
    

Erklärung dazu: Das Applet generiert POST-Requests an die URL die Sie in postURL angeben. Sie können dem Request noch beliebige Parameter hinzufügen (z.B. Session-ID), die bei jedem Datei-Upload mitgeschickt werden: "postParamX" (X=0..n). Die Javascript-Funktion, die nach einem Datei-Upload ausgeführt werden soll, können Sie in "javascriptFunction" definieren. Diese Funktion wird mit einem Parameter aufgerufen: und zwar dem Response vom Server. (Hinweis: der "mayscript"-Parameter beim Applet-Tag teilt dem Browser mit, dass das Applet Javascript-Funktionen aufrufen darf). Wenn der Benutzer mehrere Dateien auf einmal hochlädt, so wird jede Datei über einen separaten POST-Request zum Server geladen. Nach jedem Request wird die Javascript-Funktion aufgerufen. Sie können die Beschriftung angeben, die angezeigt werden soll wenn die A8Dropzone inaktiv ist. Der "encoding"-Parameter teilt der A8Dropzone mit wie sie den Response vom Server lesen soll. Mit dem "directoryUpload"-Parameter bestimmen sie, ob ein Benutzer komplette Verzeichnisse (inkl. Unterverzeichnissen!) hochladen kann: Im Falle von "true" sendet die A8Dropzone pro POST-Request zusätzlich die HTTP-Header "A8AbsolutePath" und "A8RelativePath" mit.

Hier nur ein kleines Beispiel für die Implementierung einer "javascriptFunction":

function updateFiles(html) {
  document.getElementById("someElement").innerHTML = html;
}
    

Natürlich benötigen Ihre Benutzer das Java plugin im Browser, welches Teil der Java Runtime Environment (JRE) 6 ist und von folgendem Link heruntergeladen werden kann: SUN Java Downloads. Sehr große Bilder können in der Regel aufgrund der Java-Speicherplatzzuweisung durch den Browser nicht im ImageCenter bearbeitet werden. Für den Upload gibt es aber keine Größenbeschränkung.

Auf der Serverseite behandeln Sie den Request genau wie jeden anderen Datei-Upload-Request, den ein Standard-HTML-Formular mit enctype="multipart/form-data" auch generieren würde. Da dieser Upload "im Hintergrund" stattfindet während der Benutzer die aktuelle Seite nicht verlässt, sollten Sie diese Requests am Server auch separat bearbeiten - ähnlich wie Sie einen AJAX-Request am Server bearbeiten würden.

Wenn bei der Einbettung der Parameter "directoryUpload" auf true gestellt ist, können Benutzer komplette Verzeichnis-Strukturen hochladen indem sie ein Verzeichnis über Drag&Drop auf die A8Dropzone fallen lassen. In diesem Fall sendet die A8Dropzone folgende HTTP-Header pro Datei an den Server:

• A8AbsolutePath ... der Absolute Pfad der Datei am Client (zB: "C:\temp\test.pdf")
• A8RelativePath ... der Pfad der Datei relativ zum hochgeladenen Stammverzeichnis.
  zB: der Benutzer lädt das Verzeichnis "C:\temp\files" hoch:
  C:\temp\files\f1.pdf
  C:\temp\files\subdir1\f2.pdf
  A8RelativePath ist dann entsprechend "files\f1.pdf" und "files\subdir1\f2.pdf". Somit kann am Server sehr leicht die hochgelandene Verzeichnisstruktur inkl. der Pfade ausgelesen werden.

Hinweis: Die Pfade beinhalten die systemspezifischen Pfad-Separatoren (\ unter Windows und / unter Linux).

Damit das Applet all diese Funktionen im Browser durchführen darf, wird die JAR-Datei mit unserem Code-Signing-Zertifikat signiert.

Parameter

postURL

Ziel-URL für Datei-Uploads (üblicherweise Script am Server, das Dateien entgegennimmt und bearbeitet)

javascriptFunction

Name der JavaScript-Funktion, die von A8Dropzone nach jedem Upload einer Datei aufgerufen wird
1 Parameter = Response-Body vom Server

encoding

Zeichen-Kodierung des HTTP-Responses vom Server (z.B: UTF-8)

postParam0, postParam1, ...

Parameter die im POST-Request an den Server pro Datei mitgeschickt werden (z.B. Session-ID)

label

A8Dropzone-Beschriftung

directoryUpload

true / false ... Verzeichnis-Upload akzeptieren

filenameMustMatch

Java Regular Expression um genau zu definieren welche Dateien hochgeladen werden können
Bsp: ^.*\.(jpg|wav)$ ... akzeptiert nur jpg und wav Dateien

filenameMustMatchError

Fehlermeldung wenn Dateiname nicht zu 'filenameMustMatch' passt

maxFileSize

Dateigrößenbeschränkung (in Bytes)

maxFileSizeError

Fehlermeldung wenn eine Datei die Dateigrößenbeschränkung überschreitet

imageCenter

never, possible (=default), always ... Image Center PLUS verhindern / erlauben / erzwingen (für Bilder)

imageMaxWidth

Maximale Bildbreite des Bild-Uploads aus Image Center (in Pixel)

imageMaxHeight

Maximale Bildhöhe des Bild-Uploads aus Image Center (in Pixel)

transcoder

never, possible (=default), always ... Media Converter PLUS verhindern / erlauben / erzwingen (für Audio/Video-Dateien)

transcoderDownload0, transcoderDownload1, ...

optionale URLs für Downloads der Utilities (ffmpeg.exe, preset-files, MP4Box.exe, ...)

transcoderAudio

true / false ... Audio-Uploads akzeptieren

audioProfile0, audioProfile1, ...

Audio-Profil-Definition im Format
name|ffmpeg-encoder|extension|bitraten|samplingraten|kanäle
Bsp: mp3|libmp3lame|.mp3|32k,64k,96k*,128k,192k,256k,320k|22050*,44100,48000|1,2
(Sternchen = Default-Auswahl)

transcoderVideo

true/false ... Video-Uploads akzeptieren

videoProfile0, videoProfile1, ...

Video-Profil-Definition im Format
name|ffmpeg-encoder|extension|bitraten|frameraten|audioprofil|ffmpeg params|mp4box params
Bsp: h264|libx264|.mp4|256k,512k*,768k,1024k|6,12,25*|aac|-fpre libx264-hq.ffpreset|-inter 1000
(Sternchen = Default-Auswahl)

videoMaxWidth

Maximale Videobreite des Video-Uploads aus Media Converter (in Pixel)

videoMaxHeight

Maximale Videohöhe des Video-Uploads aus Media Center (in Pixel)

Lizenz	Single Domain License €29,00 Single Domain + Verzeichnisse €39,00 Wildcard Subdomain License €49,00 Wildcard Domain + Verzeichnisse €59,00 Unlimited + Verzeichnisse €499,00	"Verzeichnisse" = mit Verzeichnis-Upload-Feature
Domain		Beispiel Single Domain: sub.mydomain.com Beispiel Wildcard Domain: *.mydomain.com