Exemple d'upload optionnel.
Consultez cet exemple pour avoir un aperçu de certaines méthodes (non utilisées dans les exemples précédents) qui permettent d'élargir le domaine d'application du module. L'intérêt est de pouvoir conserver les fonctionnalités concernant l'upload des fichiers tout en exerçant un contrôle complémentaire complet sur l'ensemble du formulaire.
Côté client :
- Un contrôle javascript est effectué "onSubmit" sur des champs de type non file (ici le champ titre) avec la fonction javascript événementielle "config.func_onFormSubmit()". Après contrôle on soumettra le formulaire avec la fonction "func_SubmitForm()".
- Les informations spécifiques concernant les fichiers (bloc "UpAbci_infosFile") seront cachées en fin de traitement si aucune erreur n'est survenue durant l'upload.
- Une information sera néanmoins affichée en cas de sauvegarde de fichier disponible.
- On affiche les erreurs (ex: champ titre composé uniquement d'espaces vides) dans le bloc ".UpAbci_infosServer" ainsi qu'un récapitulatif construit côté serveur en fin de traitement.
- On laisse ce récapitulatif affiché lors des événements "onChange" du sélecteur de fichier et de l'événement "onSubmit" du formulaire si l'utilisateur veut compléter le téléchargement de fichiers pour le titre en cours.
Côté serveur :
- Le script est configuré pour permettre à l'utilisateur de compléter le téléchargement de fichiers tant qu'il n'a pas soumis le formulaire avec un autre titre.
- Un récapitulatif html est construit en fin de traitement et envoyé dans le bloc d'information ".UpAbci_infosServer".
- Les méthodes stopForm() et addMixteServer() sont utilisées.
- La méthode saveAll() a été employée pour permettre la sauvegarde temporaire de tous les fichiers tant que l'upload n'a pas été arrêté avant la fin du traitement du premier et éventuellement dernier fragment ("dernier" si la taille du fichier est inférieure à la taille d'un fragment). L'objectif est de pouvoir re soumettre les mêmes fichiers en cas d'erreur externe au fichier comme par exemple un champ texte non conforme et de ne pas avoir à attendre une nouvelle fois pour l'upload du fragment déjà transféré. Par défaut, sans l'utilisation de cette méthode, seuls les fichiers dont la taille dépasse celle d'un fragment bénéficieraient d'un sauvegarde temporaire.
- Pour exemple un contrôle interdit de rentrer le titre "toto" car déjà existant.