PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Champ d'une page dynamique ou statique
  • Créer un champ de type Upload
  • Caractéristiques du champ
  • Remarques
  • Champ upload multi-fichiers en AWP
  • Divers
  • Taille maximale des fichiers à uploader
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
Présentation

Champ d'une page dynamique ou statique

Le champ Upload permet d'uploader des fichiers sur le serveur Web.
Plusieurs champs de type Upload sont disponibles :
  • Champ upload permettant d'uploader un seul fichier. Ce type de champ est un champ avancé, opérationnel immédiatement. Il est composé de plusieurs champs (pouvant être supprimés si nécessaire) :
    • Libellé
    • Jauge
    • Bouton de type Upload (bouton "Envoyer").
  • Champ upload permettant d'uploader un ensemble de fichiers. Ce type de champ est un champ avancé, opérationnel immédiatement. Il est composé de plusieurs champs (pouvant être supprimés si nécessaire) :
    • Liste des fichiers à uploader
    • Jauge (présente dans une popup)
    • Boutons Envoyer, Supprimer, Vider
    • Bouton de type Upload (bouton "Ajouter").
Versions 17 et supérieures
Les champs Upload gèrent directement le Drag and Drop de fichiers depuis l'explorateur (si le navigateur supporte la norme HTML 5). Pour plus de détails, consultez Manipuler un champ Upload par programmation.
Nouveauté 17
Les champs Upload gèrent directement le Drag and Drop de fichiers depuis l'explorateur (si le navigateur supporte la norme HTML 5). Pour plus de détails, consultez Manipuler un champ Upload par programmation.
Les champs Upload gèrent directement le Drag and Drop de fichiers depuis l'explorateur (si le navigateur supporte la norme HTML 5). Pour plus de détails, consultez Manipuler un champ Upload par programmation.
Remarque : Le champ de saisie de type Upload est conservé pour compatibilité. Pour plus de détails, consultez Upload de fichiers.
WEBDEV propose un champ Upload avancé, opérationnel immédiatement. Il est composé de plusieurs champs (pouvant être supprimés si nécessaire) :
  • Zone répétée permettant de gérer les fichiers à uploader. Cette zone répétée permet d'indiquer les caractéristiques des fichiers, affiche une jauge pendant l'upload et propose un bouton permettant de supprimer si nécessaire le fichier de la liste.
  • Libellé indiquant l'endroit où déposer les fichiers à uploader.
  • Bouton "Ajouter" permettant d'ajouter les fichiers.
  • Bouton "Envoyer" pour lancer l'upload des fichiers.
Ce champ peut être utilisé en mode monofichier ou en mode multifichier.
Le champ Upload gère directement le Drag and Drop de fichiers depuis l'explorateur (si le navigateur supporte la norme HTML 5). Pour plus de détails, consultez Manipuler un champ Upload par programmation.
Remarques :
  • Versions 22 et supérieures
    Dans les versions précédentes (avant la version 22), WEBDEV proposait deux champs prédéfinis de type Upload (champ permettant d'uploader un seul fichier et champ permettant d'uploader plusieurs fichiers).
    • Ces champs sont toujours fonctionnels en version 22 et supérieures. La seule différence avec le champ proposé en version 22 est la composition du champ (une zone répétée en version 22 et supérieures) et son interface.
    • Ces champs proposent la génération en mode HTML 5 en version 22 (nouveauté de la version 22, voir Caractéristiques du champ).
    Nouveauté 22
    Dans les versions précédentes (avant la version 22), WEBDEV proposait deux champs prédéfinis de type Upload (champ permettant d'uploader un seul fichier et champ permettant d'uploader plusieurs fichiers).
    • Ces champs sont toujours fonctionnels en version 22 et supérieures. La seule différence avec le champ proposé en version 22 est la composition du champ (une zone répétée en version 22 et supérieures) et son interface.
    • Ces champs proposent la génération en mode HTML 5 en version 22 (nouveauté de la version 22, voir Caractéristiques du champ).
    Dans les versions précédentes (avant la version 22), WEBDEV proposait deux champs prédéfinis de type Upload (champ permettant d'uploader un seul fichier et champ permettant d'uploader plusieurs fichiers).
    • Ces champs sont toujours fonctionnels en version 22 et supérieures. La seule différence avec le champ proposé en version 22 est la composition du champ (une zone répétée en version 22 et supérieures) et son interface.
    • Ces champs proposent la génération en mode HTML 5 en version 22 (nouveauté de la version 22, voir Caractéristiques du champ).
  • Le champ de saisie de type Upload est conservé pour compatibilité. Pour plus de détails, consultez Upload de fichiers.
  • Versions 22 et supérieures
    Le champ pré-défini proposé pour l'upload est asynchrone : il est possible de continuer à utiliser le site en cours sans être bloqué par l'upload.
    Nouveauté 22
    Le champ pré-défini proposé pour l'upload est asynchrone : il est possible de continuer à utiliser le site en cours sans être bloqué par l'upload.
    Le champ pré-défini proposé pour l'upload est asynchrone : il est possible de continuer à utiliser le site en cours sans être bloqué par l'upload.

Créer un champ de type Upload

Pour créer un champ de type Upload :
  1. Sous l'éditeur de pages, cliquez sur la flèche à droite de l'icône Icône (ou sélectionnez l'option "Insertion .. Champ .. Champ Upload").
  2. Dans la liste qui s'ouvre, sélectionnez le type de champ Upload à créer.
  3. Cliquez dans la page à la position où le champ doit être créé. Le champ apparaît dans la page.
Pour créer un champ de type Upload :
  1. Sous l'éditeur de pages, sous le volet "Création", dans le groupe "Champs usuels", déroulez "Bouton".
  2. Dans la liste qui s'ouvre, sélectionnez le type de champ Upload à créer :
    • Envoi d'un seul fichier.
    • Envoi de plusieurs fichiers.
    Dans la liste qui s'ouvre, sélectionnez le type de champ "Envoi de fichiers".
  3. Cliquez dans la page à la position où le champ doit être créé. Le champ apparaît dans la page.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ de type Upload (bouton "Envoyer" ou "Ajouter").
Le code WLangage de gestion de l'upload est présent dans les traitements associés au champ Upload. Ce code peut être modifié à votre convenance.
Important : Le traitement "Réception des fichiers uploadés" doit être modifié avant de déployer le site. Ce traitement contient un appel à la fonction dbgAssertion. Il doit être remplacé par le code permettant par exemple :
  • de copier les fichiers uploadés dans un répertoire spécifique du site,
  • d'insérer les fichiers uploadés dans un mémo binaire, ...
Pour plus de détails, consultez Traitements associés à un champ Upload.

Caractéristiques du champ

Plusieurs options spécifiques sont disponibles dans l'onglet "Détail" de la description du champ Upload (accessible par la description du bouton "Ajouter") :
  • Versions 22 et supérieures
    Utiliser l'upload natif HTML5 : Le code généré pour gérer l'upload utilise HTML5. Ce mode de génération du champ permet d'utiliser le champ Upload dans des sites disponibles sur toutes les plateformes (y compris sur les plateformes mobiles ne gérant pas le flash).
    Nouveauté 22
    Utiliser l'upload natif HTML5 : Le code généré pour gérer l'upload utilise HTML5. Ce mode de génération du champ permet d'utiliser le champ Upload dans des sites disponibles sur toutes les plateformes (y compris sur les plateformes mobiles ne gérant pas le flash).
    Utiliser l'upload natif HTML5 : Le code généré pour gérer l'upload utilise HTML5. Ce mode de génération du champ permet d'utiliser le champ Upload dans des sites disponibles sur toutes les plateformes (y compris sur les plateformes mobiles ne gérant pas le flash).
  • Versions 22 et supérieures
    Utiliser un upload basé sur Flash : Le code généré pour gérer l'upload utilise Flash. Dans ce cas, l'upload ne sera pas disponible sur les plateformes ne gérant pas le flash.
    Nouveauté 22
    Utiliser un upload basé sur Flash : Le code généré pour gérer l'upload utilise Flash. Dans ce cas, l'upload ne sera pas disponible sur les plateformes ne gérant pas le flash.
    Utiliser un upload basé sur Flash : Le code généré pour gérer l'upload utilise Flash. Dans ce cas, l'upload ne sera pas disponible sur les plateformes ne gérant pas le flash.
  • Sélection multi-fichier : autorise la multisélection dans le champ. Si cette option n'est pas cochée, seul l'upload d'un unique fichier sera possible.
  • Incruster le libellé dans l'image : permet d'insérer le libellé du bouton dans l'image associée au bouton.
  • Versions 17 et supérieures
    Gestion du Glisser/Déplacer : Permet d'autoriser le Drag and Drop depuis l'explorateur de Windows. Pour plus de détails, consultez Gérer le Drag and Drop des fichiers vers un champ Upload (HTML 5).
    Nouveauté 17
    Gestion du Glisser/Déplacer : Permet d'autoriser le Drag and Drop depuis l'explorateur de Windows. Pour plus de détails, consultez Gérer le Drag and Drop des fichiers vers un champ Upload (HTML 5).
    Gestion du Glisser/Déplacer : Permet d'autoriser le Drag and Drop depuis l'explorateur de Windows. Pour plus de détails, consultez Gérer le Drag and Drop des fichiers vers un champ Upload (HTML 5).
Versions 22 et supérieures
Remarques sur le type de génération de l'upload :
  • Si le champ Upload est créé en version 22, dans une page HTML5, l'option "Utiliser l'upload natif HTML5" sera automatiquement sélectionnée.
  • Si le champ Upload a été créé avec une version précédente (champ Upload pré-défini mono ou multifichier), il est également possible d'utiliser la génération au format HTML 5.
Nouveauté 22
Remarques sur le type de génération de l'upload :
  • Si le champ Upload est créé en version 22, dans une page HTML5, l'option "Utiliser l'upload natif HTML5" sera automatiquement sélectionnée.
  • Si le champ Upload a été créé avec une version précédente (champ Upload pré-défini mono ou multifichier), il est également possible d'utiliser la génération au format HTML 5.
Remarques sur le type de génération de l'upload :
  • Si le champ Upload est créé en version 22, dans une page HTML5, l'option "Utiliser l'upload natif HTML5" sera automatiquement sélectionnée.
  • Si le champ Upload a été créé avec une version précédente (champ Upload pré-défini mono ou multifichier), il est également possible d'utiliser la génération au format HTML 5.
Remarques

Champ upload multi-fichiers en AWP

Un champ Upload multi-fichiers en AWP crée implicitement un contexte AWP sur disque. Ce type de champ est incompatible avec la gestion des contextes à l'aide de cookies. Pour plus de détails sur les contextes AWP, consultez Gestion des contextes AWP.

Divers

  • L'utilisation du champ Upload nécessite que le lecteur Flash (version 7 ou supérieure) soit installé sur le poste de l'internaute.L'utilisation du champ Upload nécessite que le lecteur Flash (version 9 ou supérieure) soit installé sur le poste de l'internaute.
    Versions 22 et supérieures
    Si le champ Upload est basé sur Flash (option "Utiliser un upload basé sur Flash" cochée dans l'onglet "Détail"), l'utilisation du champ Upload nécessite que le lecteur Flash (version 9 ou supérieure) soit installé sur le poste de l'internaute.
    Nouveauté 22
    Si le champ Upload est basé sur Flash (option "Utiliser un upload basé sur Flash" cochée dans l'onglet "Détail"), l'utilisation du champ Upload nécessite que le lecteur Flash (version 9 ou supérieure) soit installé sur le poste de l'internaute.
    Si le champ Upload est basé sur Flash (option "Utiliser un upload basé sur Flash" cochée dans l'onglet "Détail"), l'utilisation du champ Upload nécessite que le lecteur Flash (version 9 ou supérieure) soit installé sur le poste de l'internaute.
  • Le champ Upload ne peut pas être utilisé dans une zone répétée Ajax.

Taille maximale des fichiers à uploader

Par défaut, la taille des fichiers à uploader est illimitée dans le moteur WEBDEV. Cette taille peut être limitée :
  • par le serveur Web utilisé. Pour plus de détails, consultez la documentation du serveur Web utilisé.
  • par le serveur d'application WEBDEV.
Si le fichier à uploader dépasse la taille limite, le fichier n'est pas uploadé.
Pour modifier la taille maximale des fichiers à uploader dans le serveur d'application WEBDEV, il est nécessaire de modifier la base de registre sur le serveur. Cette modification peut être réalisée pour toutes les applications WEBDEV.
Pour modifier la taille des fichiers uploadés pour toutes les applications WEBDEV :
  1. Sélectionnez la clé : HKEY_LOCAL_MACHINE\SOFTWARE\PC SOFT\WEBDEV\23.0
  2. Ajoutez la chaîne MAX_UPLOAD. La valeur de cette clé correspond à la taille maximale des fichiers à uploader (en Ko).
PHP Limites en PHP :
  • La taille des fichiers uploadés est limitée par les directives "upload_max_filesize" et "post_max_size" dans le fichier de configuration de PHP (fichier php.ini).
  • L'upload de fichiers doit être autorisé par le serveur PHP. Pour cela, la directive "file_uploads" doit être à "on" dans le fichier de configuration de PHP (fichier php.ini).
  • La directive upload_tmp_dir du fichier de configuration doit être renseignée vers un répertoire qui possède les droits en lecture/écriture.
Version minimum requise
  • Version 15
Commentaires
Attention dgbassertion n'est plus présent en V22
Le code de réception des fichiers uploadés se trouve dans le bouton ajouter

// Insérer ici le code de traitement des fichiers uploadés
// Exemple de code :
// Copie le fichier uploadé dans un répertoire spécifique
//POUR i = 1 _A_ MoiMême..Occurrence
// UploadCopieFichier(MoiMême, sRépertoireDestination, "", i)
//FIN

dbgassertion n'est plus présent


Important : Le traitement "Réception des fichiers uploadés" doit être modifié avant de déployer le site. Ce traitement contient un appel à la fonction dbgAssertion. Il doit être remplacé par le code permettant par exemple :
Hervé Franco
05 oct. 2017