PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Traitements gérés par défaut
  • Traitement de réception des fichiers
  • Exemple
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Traitements gérés par défaut
WEBDEV gère par défaut les traitements suivants (ordre d'apparition sous l'éditeur de code) sur le champ de type Upload :
TraitementCondition d'exécution
Initialisation
(Code serveur)
Exécuté à l'ouverture de la page. *
A chaque modification de la liste des fichiers sélectionnés
(Code navigateur)
Exécuté lors de la modification de la liste des fichiers à uploader.
Dans le cas d'un champ Upload mono fichier, ce traitement est exécuté dès qu'un fichier est sélectionné.
Dans le cas d'un champ Upload multi fichiers, ce traitement est exécuté dès qu'un fichier est ajouté dans la liste.
Progression du transfert
(Code navigateur)
Exécuté lors de l'envoi des fichiers sur le serveur.
Lors de l'avancement de l'envoi, ce traitement est régulièrement appelé pour permettre la mise à jour d'une éventuelle jauge.

Remarque : Ce traitement continue d'être appelé après la fin du transfert. S'il est utilisé pour déclencher une action en code serveur (à l'aide de ExecuteTraitement sur un bouton de type Submit ou grâce à la fonction AJAXExécute par exemple), il est nécessaire de s'assurer que le traitement ne sera pas appelé plusieurs fois (en protégeant son appel par une variable de type booléen par exemple).
Pour plus de détails, reportez-vous à l'exemple WW_Upload livré en standard avec WEBDEV.
Réception des fichiers uploadés
(Code serveur)
Exécuté lors de la réception des fichiers uploadés par le serveur.
ATTENTION : Si vous utilisez les champs Upload prédéfinis (mono fichier ou multi fichier), le code présent dans ce traitement doit être modifié pour indiquer l'emplacement où les fichiers doivent être copiés sur le serveur.
Versions 17 et supérieures
Le traitement "Réception des fichiers uploadés" est exécuté en AJAX. Il est possible d'utiliser toutes les fonctions supportées en code serveur AJAX. Ce traitement permet notamment en fin d'upload de mettre à jour la page sans faire un aller-retour supplémentaire vers le serveur.
Nouveauté 17
Le traitement "Réception des fichiers uploadés" est exécuté en AJAX. Il est possible d'utiliser toutes les fonctions supportées en code serveur AJAX. Ce traitement permet notamment en fin d'upload de mettre à jour la page sans faire un aller-retour supplémentaire vers le serveur.
Le traitement "Réception des fichiers uploadés" est exécuté en AJAX. Il est possible d'utiliser toutes les fonctions supportées en code serveur AJAX. Ce traitement permet notamment en fin d'upload de mettre à jour la page sans faire un aller-retour supplémentaire vers le serveur.
Versions 17 et supérieures
Après réception des fichiers uploadés
(Code navigateur)
Nouveauté 17
Après réception des fichiers uploadés
(Code navigateur)
Après réception des fichiers uploadés
(Code navigateur)
Exécuté lorsque tous les fichiers ont été uploadés sur le serveur.
Permet notamment d'exécuter un traitement navigateur lorsque l'upload est terminé, sans avoir à retourner sur le serveur.
(*) Par défaut, le traitement "Initialisation" de chaque champ est exécuté selon l'ordre de création des différents champs dans la page. Pour modifier cet ordre d'exécution :
  1. Sélectionnez l'option "Page .. Ordre de navigation .. Editer".Sous le volet "Page", dans le groupe "Edition", déroulez "Navigation" et sélectionnez "Editer".
  2. Dans la fenêtre qui s'affiche, utilisez les flèches situées sur la droite pour modifier l'ordre d'initialisation des champs.
Versions 17 et supérieures
Remarques :
  • Dans les champs Upload créés avec une version précédente de WEBDEV (avant la version 17), le traitement "Après réception des fichiers uploadés (Code navigateur)" est automatiquement ajouté.
  • Si le champ Upload est créé à partir de la version 17, le code généré dans le champ Upload est optimisé pour utiliser le traitement "Après réception des fichiers uploadés".
Nouveauté 17
Remarques :
  • Dans les champs Upload créés avec une version précédente de WEBDEV (avant la version 17), le traitement "Après réception des fichiers uploadés (Code navigateur)" est automatiquement ajouté.
  • Si le champ Upload est créé à partir de la version 17, le code généré dans le champ Upload est optimisé pour utiliser le traitement "Après réception des fichiers uploadés".
Remarques :
  • Dans les champs Upload créés avec une version précédente de WEBDEV (avant la version 17), le traitement "Après réception des fichiers uploadés (Code navigateur)" est automatiquement ajouté.
  • Si le champ Upload est créé à partir de la version 17, le code généré dans le champ Upload est optimisé pour utiliser le traitement "Après réception des fichiers uploadés".
Traitement de réception des fichiers
Le traitement "Réception des fichiers uploadés" permet de gérer l'emplacement des fichiers uploadés sur le serveur. Ce traitement permet également de gérer les paramètres passés par la fonction UploadLance.
En effet, la fonction UploadLance permet de lancer l'upload des fichiers. Si la fonction UploadLance est appelée avec des paramètres supplémentaires, ces paramètres sont transmis au traitement "Réception des fichiers uploadés" à la fin de l'upload. Pour récupérer ces paramètres, il est nécessaire de déclarer une procédure dans ce traitement (via l'instruction PROCEDURE).
Cette procédure est de la forme :
PROCEDURE NomProcédure(<Paramètre 1> [, ... [, <Paramètre N>]])
Le traitement "Réception des fichiers uploadés" peut également permettre de charger les images uploadées dans une rubrique mémo d'un fichier HFSQL, via la fonction HAttacheMémo.
Limite : Le code utilisé dans le traitement "Réception des fichiers uploadés" ne peut pas gérer d'affichage.
Versions 17 et supérieures
Le traitement "Réception des fichiers uploadés" est exécuté en AJAX. Il est possible d'utiliser toutes les fonctions supportées en code serveur AJAX.
Nouveauté 17
Le traitement "Réception des fichiers uploadés" est exécuté en AJAX. Il est possible d'utiliser toutes les fonctions supportées en code serveur AJAX.
Le traitement "Réception des fichiers uploadés" est exécuté en AJAX. Il est possible d'utiliser toutes les fonctions supportées en code serveur AJAX.
Exemple de code utilisé dans le traitement "Réception des fichiers uploadés" :
// Insérer ici le code de traitement des fichiers uploadés
// Exemple de code :
// Copie le fichier uploadé dans un répertoire spécifique
// UploadCopieFichier(MoiMême, sRépertoireDestination, "")

// Traitement de chaque fichier à uploader
POUR Indice = 1 A NbFichiersAUploader
Trace(UploadNomFichier(UPL_Upload, Faux, Indice))
Trace(UploadNomFichier(UPL_Upload, Vrai, Indice))
UploadCopieFichier(UPL_Upload, "c:\temp2", "", Indice)
FIN
Exemple
Exemple de code permettant de charger les images uploadées depuis un champ Upload multi-fichiers dans une rubrique mémo.
// Pour chaque image uploadée
POUR i = 1 _A_ UPL_ChampUpload..Occurrence
// Ajout dans la base de données
HRAZ(Photo)
EcranVersFichier()

// UploadNomFichier(UPL_ChampUpload, Vrai, i) :
// permet de récupérer le chemin du ième fichier uploadé sur le serveur
// Ce fichier est un fichier temporaire créé sur le serveur
// Ce fichier est donc supprimé automatiquement à la fin du traitement
// "réception des fichiers uploadés"
HAttacheMémo(Photo, Image, UploadNomFichier(UPL_ChampUpload, Vrai, i))

HAjoute(Photo)
FIN
Version minimum requise
  • Version 15
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire