Administration des pièces jointes

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • Les administrateurs peuvent configurer les propriétés système pour la façon dont les fichiers sont 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 n’importe quelle table, un enregistrement contenant les métadonnées de 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 de pièce jointe [sys_attachment_doc], par blocs 4k. Par exemple, si vous joignez un fichier de 12 Ko appelé My_attachment.pdf, il existe une entrée de pièce jointe avec trois entrées de document en pièce jointe associées.

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

    Mise à l’échelle des miniatures du flux d’activité

    La glide.ui.activity_stream.scale_images propriété réduit la taille des images de grande taille et crée des miniatures pour la vue du flux d’activité des images. Cette propriété est activée par défaut. Il 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 plus larges que 525 pixels.
    • Joindre des fichiers image de plus de 5 Mo peut entraîner 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 taille supérieure à 5 Mo ne sont pas mises à l’échelle et le système crée un lien à la place. Les images de taille inférieure à 5 Mo sont réduites.

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

    Lorsque vous joignez une image à 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 comportant plusieurs 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 comportant plusieurs 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
    attachment.read Une pièce jointe a été lue ou téléchargée.
    pièce jointe.téléchargé Une pièce jointe a été téléchargée. Si plusieurs pièces jointes sont chargées dans un enregistrement en même temps, 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é.
    attachment.renommé 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 utiliser cet événement. Par exemple, vous pouvez indiquer quand et par qui certaines pièces jointes sont téléchargées. Pour cette fonctionnalité, actuel est un enregistrement sys_attachment et l’enregistrement d’événement utilise les paramètres suivants :
    • parm1 : Nom de fichier
    • parm2 : Nom de table

    Déboguer l’indexation des pièces jointes

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

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

      Vous pouvez laisser cette propriété activée pendant les opérations normales pour capturer les informations de trace de la pile concernant 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 (la valeur par défaut est faux).

      [Recommandé] Pour des performances optimales, définissez cette propriété sur false pendant les opérations normales. N’activez cette propriété que 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 les paramètres de renforcement de la sécurité de l’instance.