Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Interface

Gérer les pièces jointes

Afficher, ajouter et supprimer les pièces jointes d'un document avec un champ « Galerie des pièces jointes », et filtrer les fichiers qu'il montre.

Gérer les pièces jointes

Un champ de type Galerie des pièces jointes (Attachment Gallery) affiche les fichiers joints au document sous forme de vignettes, dans le formulaire. Il complète la liste des pièces jointes de la barre latérale.

Prérequis

  • Le type de document a un champ Galerie des pièces jointes. Un administrateur l'ajoute (voir plus bas).
  • Le document est enregistré. Sur un nouveau document, la galerie affiche « Enregistrez le document pour joindre des fichiers. ».
  • Pour ajouter ou supprimer : avoir le droit d'écriture sur le document.

Utiliser la galerie

ÉlémentAction
Vignette d'imageUn clic ouvre la visionneuse. Vous passez d'une image à l'autre de la galerie.
Vignette d'un autre fichierUne icône et le nom du fichier. Un clic ouvre le fichier dans un nouvel onglet.
Bouton Ajouter une pièce jointe (icône d'envoi)Ouvre la fenêtre d'envoi de fichier. Le fichier est joint au document et rattaché à ce champ.
Icône de corbeilleSupprimer la pièce jointe, après confirmation.

Les fichiers sont triés par nom. Le bouton d'ajout disparaît quand le nombre maximal de pièces jointes du type de document est atteint. Sans fichier ni droit d'ajout, la galerie affiche « Aucune pièce jointe ».

Supprimer une pièce jointe supprime le fichier.

Ajouter une galerie à un formulaire

  1. Ouvrez Personnaliser un formulaire, puis choisissez le type de document.
  2. Ajoutez un champ de type Attachment Gallery.
  3. Facultatif : renseignez son champ Filtres pour n'afficher qu'une partie des fichiers.
  4. Cliquez sur Mettre à jour.

Sans filtre, la galerie montre toutes les pièces jointes du document.

Filtrer les fichiers affichés

Les filtres portent sur le type File. Chaque ligne a quatre valeurs : ["File", champ, opérateur, valeur]. Dodock refuse un filtre sur un autre type de document. Une valeur qui commence par eval: est calculée avec doc (le document ouvert).

ButFiltre
Seulement les PDF[["File", "file_type", "=", "PDF"]]
Seulement les fichiers ajoutés depuis cette galerie[["File", "attached_to_field", "=", "galerie_contrats"]]
Seulement les fichiers privés[["File", "is_private", "=", 1]]

Exemple

Exemple fictif : vous voulez une galerie des contrats signés sur la fiche Client.

  1. Dans Personnaliser un formulaire pour Client, ajoutez un champ Attachment Gallery nommé galerie_contrats, libellé « Contrats ».
  2. Dans son champ Filtres, saisissez [["File", "attached_to_field", "=", "galerie_contrats"]].
  3. Cliquez sur Mettre à jour.

Un fichier envoyé avec le bouton de la galerie « Contrats » y apparaît. Un fichier joint depuis la barre latérale reste dans la liste des pièces jointes, mais pas dans cette galerie.