Champs (DocField)

Joindre/Joindre une image

Fonctionnement des champs Joindre et Joindre une image, et option Private ou Public pour imposer la visibilité du fichier.

Joindre/Joindre une image

Les champs Joindre (Attach) et Joindre une image (Attach Image) stockent l'adresse d'un fichier. Le fichier lui-même est un document Fichier.

La valeur du champ est une adresse, par exemple :

  • /files/logo.png : un fichier public ;
  • /private/files/contrat.pdf : un fichier privé ;
  • https://www.example.com/fichier.pdf : un fichier externe.

Un fichier public est accessible à toute personne qui connaît son adresse. Un fichier privé est accessible seulement aux utilisateurs connectés qui ont le droit de lire le document Fichier.

Joindre une image accepte seulement les images (JPEG, PNG, GIF, WebP, SVG, AVIF, BMP, ICO).

Imposer la visibilité du fichier

Dans la propriété Options du champ, saisissez une de ces valeurs :

OptionsEffet
PrivateLe fichier envoyé est toujours privé.
PublicLe fichier envoyé est toujours public.
(vide)L'utilisateur choisit entre privé et public dans la fenêtre d'envoi.

Avec Private ou Public, la fenêtre d'envoi n'affiche plus le choix entre privé et public.

Utilisez Public pour une image affichée aux visiteurs du site web. Par exemple, les champs du logo dans les Paramètres du site web utilisent Public. Utilisez Private pour un document confidentiel, par exemple une pièce d'identité envoyée depuis un formulaire web.

Cette option agit dans la fenêtre d'envoi de l'interface. Un fichier envoyé par l'API garde la visibilité demandée dans l'appel.

Pour aller plus loin