📥 Champs de téléchargement

Les champs de téléchargement vous permettent de mettre directement à la disposition de l'utilisateur du formulaire des fichiers provenant d'onOffice à télécharger — par exemple, un contrat de location, la fiche descriptive actuelle, des procès-verbaux de remise des clés ou des documents regroupés relatifs au propriétaire. Ce type de champ est le pendant du champ de téléchargement de fichiers et peut également être combiné avec celui-ci.

Contenu

• Cas d'utilisation
• Configurer le champ
• Sources de fichiers
• Sélecteurs : quel fichier ?
• Fichiers multiples → Regroupement en ZIP
• Hybride : téléchargement + chargement dans le même champ
• Activité lors du téléchargement
• Limites

---

Cas d'utilisation

• Documents du locataire : le bailleur clique sur le lien → le formulaire affiche tous les documents du locataire (carte d'identité, bulletins de salaire) à télécharger
• Page de statut du propriétaire : le propriétaire ouvre le lien → consulte le PDF de l'annonce actuelle + le rapport d'activité
• Confirmation de réservation : l'acheteur ouvre le lien → peut télécharger le contrat de réservation signé au format PDF
• Téléchargement du projet de contrat : le notaire/vendeur ouvre le formulaire → reçoit le projet de contrat de vente actuel
• Téléchargement groupé : plusieurs fichiers d'un onglet sont proposés sous forme de fichier ZIP

Configurer le champ

1. Éditeur de formulaire → Ajouter un champ → Type spécial « Télécharger le fichier »
2. Attribuer un nom au champ (par ex. « Télécharger le projet de contrat »)
3. Sélectionner la source du fichier (voir section suivante)
4. Facultatif : configurer le sélecteur (le plus récent / le plus ancien / tous / filtré)
5. Facultatif : activer « Masquer le champ si aucun fichier n'est trouvé » — évite les boutons vides

---

Sources de fichiers

Pour chaque champ de téléchargement, tu choisis d'où le fichier doit provenir :

> 💡 Combiner plusieurs sources : « Caractéristique du document ET nom de fichier contenant 2024 » → ne renvoie que la variante 2024 du document sélectionné.

Sélecteurs : quel fichier ?

Si plusieurs fichiers correspondent à la source (par exemple, trois versions d'un contrat), le sélecteur décide :

En outre : Filtre « Le nom du fichier contient la chaîne de caractères » — par exemple, uniquement les fichiers dont le nom contient « contrat ».

## Fichiers multiples → Regroupement en ZIP

Si le sélecteur renvoie plusieurs fichiers :

• propform les compresse automatiquement dans un fichier ZIP
• Le nom du fichier ZIP peut être configuré (à l'aide de macros, par exemple Unterlagen_<Vorname>_<Nachname>.zip)
• Sur les navigateurs mobiles, le fichier ZIP est téléchargé comme n'importe quel autre fichier (comportement par défaut)

Hybride : téléchargement et chargement dans le même champ

Un champ de chargement de fichiers peut être doté d'une fonction de téléchargement supplémentaire — pratique pour les workflows de type « télécharger le document contractuel, le signer, puis le recharger ».

Configuration :

1. Champ de téléchargement de fichier existant → Paramètres du champ
2. Régler le mode sur « Modifier + Télécharger » (au lieu de « Téléchargement uniquement » ou « Téléchargement uniquement »)
3. Les deux configurations de source sont disponibles (destination de téléchargement + source de téléchargement)

Dans le formulaire, l'utilisateur voit :

• Bouton de téléchargement pour le fichier existant
• Zone de téléchargement pour un nouveau fichier ou un fichier de remplacement

Activité lors du téléchargement

En option, vous pouvez enregistrer une activité dans onOffice à chaque téléchargement — pour la piste d'audit et le reporting :

• Configurable comme les autres activités (type d'action, catégorie d'action, texte personnalisé)
• Facultatif : enregistrer le hachage du fichier — prouve que c'est bien cette version du fichier qui a été téléchargée
• Combinable avec « Activité lors de l'ouverture du formulaire » (voir Paramètres du formulaire) — tu auras alors à la fois « L'utilisateur a ouvert le document » et « L'utilisateur a téléchargé le document » dans l'historique

Limitations

Champs de fichiers du masque onOffice

Les fichiers qui se trouvent dans les champs de fichiers du masque Adresse/Immobilier (c'est-à-dire directement dans l'enregistrement, et non dans l'onglet « Fichiers ») ne sont pas accessibles via l'API onOffice — voir FAQ : Échec du téléchargement de fichiers.

Conséquence :

• Pour le module Immobilier : seuls les fichiers initialement téléchargés via propform sont accessibles (avec référence d'ID de fichier)
• Pour le module Adresses : tous les fichiers de l'onglet « Fichiers » sont accessibles (l'API est ici complète)

Limite de taille des fichiers

• Par fichier : 128 Mo (correspond à la limite de téléchargement côté nginx)
• Archifs ZIP : pas de limite stricte, mais performances ralenties en cas de très grand nombre de fichiers (>100)

Sécurité

Les champs de téléchargement doivent toujours être associés à d'autres mécanismes de protection :

• Exigence d'UUID (voir Protection des formulaires) — empêche la falsification d'URL
• Filtre par formulaire (voir FAQ : Filtre par formulaire) — limité à certains enregistrements
• En option, liste blanche d'adresses IP ou clé de formulaire

Connexes

• 📖 Champs — tous les types et options — aperçu complet de tous les types de champs
• 📖 Protection des formulaires — exigence d'UUID, liste blanche d'adresses IP, clé de formulaire
• 📖 Relier plusieurs enregistrements — Boucles d'adresses pour les workflows locataire-propriétaire
• 📖 FAQ : échec du téléchargement de fichier — Problème iPhone et limitations de l'API