Administration des pièces jointes

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture

    • Les administrateurs peuvent configurer les propriétés système pour la façon dont les fichiers sont téléchargés et joints aux enregistrements. Le chargement, l’affichage et la suppression des pièces jointes déclenchent un événement unique qui peut être utilisé pour les notifications ou dans les scripts.

    Tables des pièces jointes

    Lorsque vous stockez une pièce jointe dans une table, un enregistrement contenant les métadonnées de la pièce jointe est créé dans la table Pièce jointe [sys_attachment]. Les données du fichier sont stockées dans la table Document en pièce jointe [sys_attachment_doc], en blocs de 4 000. Par exemple, si vous joignez un fichier de 12 Ko appelé My_attachment.pdf, il y a une entrée de pièce jointe avec trois entrées de document en pièce jointe connexes.

    Pour savoir comment charger des pièces jointes dans des enregistrements, voir Ajouter et gérer des pièces jointes.

    Mise à l’échelle de la miniature du flux d’activité

    La glide.ui.activity_stream.scale_images propriété réduit les grandes images et crée des miniatures pour la vue du flux d’activité des images. Cette propriété est active par défaut. Elle s’applique aux images rétroactivement, de sorte que toutes les pièces jointes incluses dans un flux d’activité dans le passé voient également les effets.
    • Les dimensions maximales des miniatures utilisant cette propriété sont de 525 pixels de largeur par 350 pixels de hauteur. Le système privilégie d’abord la hauteur des pixels, de sorte que vous pouvez vous retrouver avec des images de plus de 525 pixels.
    • L’attachement de fichiers image de plus de 5 Mo peut créer une erreur de mémoire insuffisante et entraîner le redémarrage de l’instance. Une erreur de mémoire insuffisante et un redémarrage se produisent lorsque le système génère la miniature lorsque vous joignez une nouvelle image. L’erreur et le redémarrage peuvent également se produire la première fois que vous chargez des images existantes sur un enregistrement.
    • L’administrateur peut ajouter la com.glide.attachment.max_get_size propriété système pour contrôler les dimensions maximales de mise à l’échelle de l’image.
    Saisissez les informations suivantes dans la table [sys_properties.list] :
    Champ Description
    Nom com.glide.attachment.max_get_size
    Type entier
    Valeur 5242880
    Le champ de valeur représente la taille en octets.
    • La valeur système de base est 5242880 octets (5 Mo). Vous pouvez modifier la valeur si nécessaire.
    • Avec cette propriété définie, les images de plus de 5 Mo ne sont pas mises à l’échelle et le système crée un lien à la place. Les images de moins de 5 Mo sont réduites.

    Configurer la propriété de taille d’image maximale pour les flux d’activité

    Lors de l’attachement d’une image dans un flux d’activité, le système contrôle la taille maximale de l’image. Utilisez cette com.glide.attachment.max_get_size propriété pour contrôler les dimensions maximales de mise à l’échelle de l’image.

    Événements de pièce jointe et journalisation

    Une action de script ou une notification peut traiter les événements de pièce jointe. Un seul événement est créé lorsqu’une action est effectuée sur un enregistrement avec des pièces jointes, même si l’enregistrement comporte plusieurs pièces jointes. Les événements suivants sont fournis.

    Un seul événement est créé lorsqu’une action est effectuée sur un enregistrement avec des pièces jointes, même si l’enregistrement comporte plusieurs pièces jointes. Les événements suivants sont fournis.

    Tableau 1. Événements de pièces jointes
    Événement Description
    Pièce jointe.Lecture Une pièce jointe a été lue ou téléchargée.
    Pièce jointe.Téléchargée Une pièce jointe a été téléchargée. Si plusieurs pièces jointes sont téléchargées simultanément dans un enregistrement, un seul événement est créé.
    pièce jointe.supprimée Une pièce jointe a été supprimée. Cet événement est également déclenché lorsque l’enregistrement contenant la pièce jointe est supprimé. Si un enregistrement contenant plusieurs pièces jointes est supprimé, un événement distinct est déclenché pour chaque pièce jointe de l’enregistrement supprimé.
    pièce jointe.renommée Une pièce jointe a été renommée.

    Journalisation des pièces jointes

    Lorsqu’une pièce jointe est téléchargée, l’enregistrement de l’événement attachment.read est écrit et vous pouvez faire quelque chose avec cet événement. Par exemple, vous pouvez enregistrer quand et par qui certaines pièces jointes sont téléchargées. Pour cette fonctionnalité, l’enregistrement actuel est un enregistrement sys_attachment et l’enregistrement d’événement utilise les paramètres suivants :
    • parm1 : Nom de fichier
    • parm2 : Nom de la table

    Déboguer l’indexation des pièces jointes

    Pour modifier les options de débogage pour l’indexation des pièces jointes, ajoutez ces propriétés système.

    • glide.ts.index.attachment.debug: lorsque la valeur est définie sur vrai, active les messages de journal pour les exceptions qui se produisent lors de l’indexation des pièces jointes ( faux par défaut).

      Vous pouvez laisser cette propriété activée pendant les opérations normales pour capturer des informations de trace de pile sur les exceptions.

    • glide.ts.index.attachment.list_terms.debug: lorsque la valeur est définie sur vrai, consigne tous les termes indexés lorsqu’une pièce jointe est indexée ( faux par défaut).

      [Recommandé] Pour des performances optimales, définissez cette propriété sur faux pendant les opérations normales. Activez cette propriété uniquement lorsque vous déboguez activement un problème.

    Remarque :
    Pour en savoir plus sur les propriétés qui affectent le traitement des pièces jointes, consultez Pièces jointes (renforcement de la sécurité de l’instance) dans Paramètres de renforcement de la sécurité de l’instance.