PDF (adobe.com)

Insertion de champs de fichier ColdFusion

Vous pouvez insérer visuellement dans votre formulaire un champ de fichier ColdFusion, puis définir ses propriétés. Vous pouvez créer un champ de fichier pour permettre aux utilisateurs de sélectionner un fichier sur leur ordinateur (tel qu'un document de traitement de texte ou un fichier graphique) et de le transférer sur le serveur. Un champ de fichier ColdFusion est similaire à un champ de texte, mais contient également un bouton Parcourir. L'utilisateur peut soit saisir manuellement le chemin d'accès au fichier à transférer, soit cliquer sur le bouton Parcourir pour le rechercher et le sélectionner.

Les champs de fichier nécessitent l'utilisation de la méthode POST pour transmettre des fichiers depuis un navigateur vers le serveur. Le fichier est transféré à l'adresse indiquée dans la zone de texte Action du formulaire. Avant d'utiliser le champ de fichier, vérifiez auprès de votre administrateur de serveur que le transfert anonyme de fichiers est autorisé.

Les champs de fichier nécessitent aussi que le codage du formulaire soit défini comme « multipart/form ». Dreamweaver active automatiquement ce paramètre lorsque vous insérez un contrôle de champ de fichier.

Remarque : Cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.
  1. En mode Création, sélectionnez le formulaire ColdFusion pour l’afficher dans l’inspecteur Propriétés.

    Pour sélectionner rapidement le formulaire, cliquez n'importe où dans son cadre, puis cliquez sur la balise <cfform> dans le sélecteur de balises figurant dans le coin inférieur de la fenêtre de document.

  2. Dans l'inspecteur Propriétés, définissez la méthode du formulaire comme « POST ».
  3. Dans le menu déroulant Enctype, sélectionnez multipart/form-data.
  4. Placez le point d'insertion à l'intérieur de la bordure du formulaire, à l’endroit où le champ de fichier doit apparaître.
  5. Choisissez Insertion > Objets ColdFusion > Formulaire > Champ fichier.

    Un champ de fichier apparaît dans le document.

  6. Sélectionnez le champ de fichier sur la page et définissez les propriétés suivantes dans l'inspecteur Propriétés :
    Cffilefield
    (Zone de texte) Permet d’indiquer un nom unique pour le contrôle.

    Long. max.
    Indique le nombre maximum de caractères que peut contenir le chemin d’accès du fichier.

    Valider
    Spécifie le type de validation du champ actuel.

    Valider à
    Spécifie le moment de validation : onSubmit, onBlur ou onServer.

    Etiquette
    Permet d’indiquer un libellé pour le champ.

    Schéma
    Permet d’indiquer un modèle d’expression régulière en JavaScript pour valider la saisie. Les barres obliques de début ou de fin sont ignorées. Pour plus d'informations, consultez la documentation ColdFusion.

    Hauteur
    Permet d’indiquer la hauteur du contrôle, en pixels. A l'exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Largeur
    Permet d’indiquer la largeur du contrôle, en pixels. A l'exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Taille
    Permet d’indiquer la taille du contrôle.

    Obligatoire
    Permet de préciser si le champ de fichier doit contenir des données pour que le formulaire soit transmis au serveur.

    Afficher l'éditeur de balises
    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.