Télécharger

Aperçu

L'interaction de téléchargement offre un moyen simplifié de rendre les fichiers liés à vos enregistrements Salesforce accessibles directement dans une table de données. Cela améliore l'expérience utilisateur et l'efficacité en évitant la nécessité de quitter la table pour trouver et télécharger des fichiers.

Comment cela fonctionne

L'interaction de téléchargement est configurée à l'intérieur un composant Avonni Data Table. Voici le processus :

Configuration de la table de données

• Votre table de données doit être configurée pour afficher des enregistrements d'un objet Salesforce avec des fichiers associés (par ex. : des Cas avec des documents joints, des Comptes avec des contrats, etc.).

• Vous aurez besoin d'un moyen pour identifier le fichier associé à chaque enregistrement. Cela se fait généralement par l'une des méthodes suivantes :

  • Un champ contenant le Content Document ID du fichier associé.

  • Un champ contenant une URL pointant directement vers le fichier.

  • Une relation avec l'objet ContentDocument (cela est moins courant pour des liens de téléchargement directs, mais possible).

Ajouter l'interaction de téléchargement

• Sélectionnez le composant Avonni Data Table dans votre éditeur de page.

• Ajoutez des colonnes « Actions » ou « Bouton » dans le panneau des propriétés du composant.

• Ajoutez une nouvelle interaction et choisissez le type « Télécharger ».

Configurer l'interaction de téléchargement

• Champ URL : (Optionnel) Sélectionnez le champ de la source de données de votre table de données qui contient le URL du fichier. Si vous fournissez une URL, elle prévaut sur l'identifiant Content Document.

• Champ Content Document ID : (Optionnel) Sélectionnez le champ de la source de données de votre table de données qui contient le Content Document ID du fichier.

• Générer automatiquement un lien public : (Optionnel, mais très important)

  • Si coché (activé) : Le composant tentera de générer un lien accessible publiquement pour le fichier. Cela permet aux utilisateurs sans connexion Salesforce de télécharger le fichier.

    • Si un lien public existe déjà pour le Content Document, il sera utilisé.

    • Si aucun lien public n'existe, un lien sera créé automatiquement. Important : Cela rend le fichier accessible publiquement via le lien généré.

  • Si décoché (désactivé) : Le composant générera un lien de téléchargement qui exige l'authentification Salesforce. Seuls les utilisateurs connectés à votre organisation Salesforce avec les autorisations suffisantes pourront télécharger le fichier.

Note importante

Le champ URL prévaut. Si un champ URL et un champ Content Document ID sont fournis, le composant utilisera l'URL. Si vous utilisez Générer automatiquement un lien public, soyez très prudent concernant la sécurité des données.

Interaction utilisateur

• Lorsque la table de données est affichée, une icône de téléchargement apparaîtra dans la colonne configurée ou à côté de chaque ligne.

• Cliquer sur cette icône lancera le téléchargement du fichier associé à cet enregistrement spécifique.

Cas d'utilisation exemple : pièces jointes de Cas

Supposons que vous ayez une table de données affichant une liste de Cas. Chaque Cas peut avoir un fichier joint (par ex. : une capture d'écran, un fichier journal, un rapport PDF).

1. Source de données : La requête de votre table de données récupère les enregistrements de Cas. Elle devrait également inclure :

   • Le ContentDocumentId du fichier joint (c'est la manière standard de lier des fichiers aux enregistrements dans Salesforce). OU

   • Un champ personnalisé sur l'objet Case contenant une URL pointant vers le fichier.

2. Interaction de téléchargement : Vous ajoutez une interaction de téléchargement à la table de données.

   • Vous sélectionneriez soit le ContentDocumentId champ ou le champ URL personnalisé.

   • Vous décideriez d'activer ou non « Générer automatiquement un lien public » en fonction de si les fichiers doivent être accessibles aux utilisateurs en dehors de Salesforce.

3. Résultat : La table de données affichera une icône de téléchargement pour chaque Cas. Cliquer sur l'icône d'un Cas spécifique téléchargera le fichier associé à ce Cas, soit via un lien authentifié par Salesforce, soit via un lien public, selon votre configuration.

Avantages clés

Intégrer l'interaction de téléchargement offre de vrais avantages :

• Moins de clics, plus d'action (flux de travail simplifié) : Les utilisateurs n'ont pas à quitter la table et à chercher des fichiers sur les pages d'enregistrement. Ils téléchargent directement depuis la ligne, ce qui fait gagner du temps et des efforts.

• Utilisateurs plus satisfaits (expérience utilisateur améliorée) : Obtenir les fichiers directement liés aux données qu'ils consultent est tout simplement plus pratique et intuitif.

• Le bon fichier, juste là (accès contextuel) : L'icône de téléchargement se trouve à côté de l'enregistrement auquel elle appartient, supprimant toute incertitude et garantissant que les utilisateurs récupèrent le bon document

Considérations importantes

• Autorisations : Pour télécharger les fichiers, les utilisateurs doivent disposer des autorisations Salesforce nécessaires (par ex. : « Voir le contenu » sur l'objet ContentDocument, ou des paramètres de partage appropriés).

• Disponibilité des champs : Assurez-vous que le champ contenant le Content Document ID ou l'URL est inclus dans la source de données de votre table de données.

• Validité des URL (si vous utilisez des URL) : Si vous utilisez un champ URL, assurez-vous que les URL sont valides et accessibles.

• Sécurité des liens publics (si vous utilisez Générer automatiquement un lien public) : Soyez extrêmement prudent lorsque vous activez « Générer automatiquement un lien public ». Cela rend les fichiers accessibles publiquement, n'utilisez donc cette option que lorsqu'elle est appropriée et en ayant une compréhension complète des implications en matière de sécurité. Envisagez d'utiliser une durée d'expiration courte pour les liens publics.

En résumé

L'interaction de téléchargement offre un moyen puissant d'ajouter des capacités de téléchargement direct de fichiers à vos Avonni Data Tables. Réfléchissez attentivement à l'utilisation des Content Document IDs ou des URL, et soyez attentif aux implications de sécurité de l'option « Générer automatiquement un lien public ».