Téléversement de fichier

Aperçu

Le composant Avonni File Upload fournit une interface conviviale permettant aux utilisateurs de sélectionner et de téléverser un ou plusieurs fichiers directement depuis leur appareil local au sein de votre composant dynamique. Ces fichiers téléversés sont généralement enregistrés en tant que fichiers Salesforce (enregistrements ContentDocument). Ils peuvent être automatiquement liés à un enregistrement parent spécifié, simplifiant des processus tels que l'ajout de documents ou la soumission de preuves sans avoir à naviguer vers des zones de téléversement de fichiers distinctes.

Principales caractéristiques

• Téléversement direct de fichiers : Permet aux utilisateurs de téléverser des fichiers depuis le composant.

• Prise en charge de plusieurs fichiers : Option permettant d'autoriser le téléversement d'un seul fichier ou de plusieurs fichiers simultanément.

• Restriction de format : Définir les formats de fichiers acceptables (par ex. PDF, JPG, DOCX).

• Intégration Salesforce : Enregistre les fichiers téléversés en tant que fichiers Salesforce et les lie à un enregistrement spécifié.

• Interface personnalisable : Contrôlez les libellés, le texte d'aide, l'affichage des fichiers et la mise en page du composant.

• Options de nommage des fichiers : Ajouter des préfixes ou suffixes aux noms de fichiers téléversés pour une meilleure organisation.

Cas d'utilisation

• Joindre des propositions ou des contrats aux enregistrements Opportunity.

• Téléverser des documents justificatifs pour les enregistrements Case.

• Ajouter des images ou des fiches techniques aux enregistrements Produit.

• Soumettre des devoirs ou des formulaires complétés avec pièces jointes dans un flux de travail personnalisé.

• Permettre aux utilisateurs de téléverser des photos de profil ou des documents d'identification.

Ajout du composant File Upload

Glisser-déposer : Dans la bibliothèque de composants (panneau de gauche), trouvez le composant "File Upload" et faites-le glisser sur votre canevas dans le Générateur de Composants.

Configuration

Sélectionnez le composant File Upload sur le canevas pour accéder à ses propriétés dans le panneau Propriétés.

Propriétés de base

Ces propriétés contrôlent l'étiquetage fondamental et l'identification.

• Nom API : (Texte) Un identifiant unique pour cette instance de composant (par ex., ProposalUploader, CaseAttachmentUpload).

• Étiquette : (Texte) Le libellé principal affiché pour le téléverseur de fichiers. Exemple : "Upload Proposal Document :", "Attach Supporting Files :".

• Aide au niveau du champ : (Texte, optionnel) Texte d'aide affiché à côté du libellé (souvent sous forme d'icône point d'interrogation), fournissant des instructions ou un contexte supplémentaires sur les types de fichiers à téléverser ou les limites de taille.

Comportement du téléversement de fichiers

Ces paramètres définissent le fonctionnement du processus de téléversement de fichiers.

• Formats acceptés : (Texte) Spécifiez une liste d'extensions de fichiers séparées par des virgules autorisées pour le téléversement (par ex., .pdf,.jpg,.png,.docx). Inclure le point initial. Laisser vide pour autoriser tous les types de fichiers (généralement non recommandé pour le contrôle).

• Autoriser plusieurs fichiers : (Booléen - Case à cocher)

  • Coché : Les utilisateurs peuvent sélectionner et téléverser plusieurs fichiers simultanément.

  • Décoché (par défaut) : Les utilisateurs ne peuvent téléverser qu'un seul fichier par interaction.

• Afficher le(s) fichier(s) téléversé(s) : (Booléen - Case à cocher) Si activé, le composant affichera une liste ou un aperçu des fichiers qui ont été téléversés avec succès dans la session ou le contexte courant.

• Requis : (Booléen - Case à cocher) Si activé, l'utilisateur doit téléversez au moins un fichier. Ceci est souvent utilisé avec la validation des formulaires.

Association et nommage des fichiers

Ceux-ci sont des paramètres critiques pour garantir que les fichiers téléversés sont correctement liés et nommés dans Salesforce.

• ID d'enregistrement lié : (Texte - Essentiel pour le lien) L'ID Salesforce de 15 ou 18 caractères de l'enregistrement auquel le(s) fichier(s) téléversé(s) doit(ent) être associé(s).

  • Comment le définir : Typiquement, vous lierez ceci à une valeur dynamique en utilisant l'option mappée :

    • $Component.recordId: Utilisez ceci si le composant dynamique a son Objet de page cible défini et est placé sur une page d'enregistrement. Ceci lie automatiquement le fichier à l'enregistrement courant consulté.

    • Une ressource Variable: Sélectionnez une variable qui contient l'ID de l'enregistrement auquel vous souhaitez lier (par ex., un ID passé à un composant modal).

• Préfixe du nom de fichier : (Texte, optionnel) Saisissez un texte qui sera automatiquement ajouté au début du nom de fichier d'origine lorsqu'il est enregistré dans Salesforce. Exemple : Si le préfixe est Contract_ et l'utilisateur téléverse Details.pdf, il pourrait être enregistré sous Contract_Details.pdf.

• Suffixe du nom de fichier : (Texte, optionnel) Saisissez un texte qui sera automatiquement ajouté au fin du nom de fichier d'origine (avant l'extension) lorsqu'il est enregistré. Exemple : Si le suffixe est _Final et l'utilisateur téléverse Report.docx, il pourrait être enregistré sous Report_Final.docx.

Affichage et mise en page

Ces propriétés contrôlent la présentation visuelle du composant.

• Variante : (Sélection) Contrôle le style visuel et le positionnement du composant principal Étiquette:

  • standard: Libellé au-dessus du composant.

  • label-inline: Libellé à gauche.

  • label-stacked: Libellé au-dessus (peut avoir un style différent de standard).

  • label-hidden: Masque le libellé principal.

• Étirement : (Booléen - Case à cocher) Si activé, l'interface du téléverseur de fichiers tentera d'occuper toute la largeur disponible de son conteneur.

État et visibilité

• Désactivé : (Booléen - Case à cocher) Si activé, le composant File Upload est complètement désactivé et l'utilisateur ne peut pas interagir avec lui.

• Visible : (Booléen) Contrôle si l'ensemble du composant File Upload est visible sur la page. Liez ceci à une variable booléenne ou une formule pour une visibilité dynamique.

Répondre aux événements de téléversement

Le composant Avonni File Upload est conçu pour gérer automatiquement le téléversement du fichier vers Salesforce et le lier à l'enregistrement spécifié dans le ID d'enregistrement lié propriété lorsque l'utilisateur sélectionne des fichiers.

Exemple : Joindre une proposition à une Opportunity

1. Configuration du composant dynamique : Assurez-vous que votre composant dynamique a Nom API de l'objet cible défini sur Opportunité.

2. Ajouter le composant File Upload :

   • Nom API : ProposalUpload

   • Libellé : "Upload Proposal Document"

   • Formats acceptés : .pdf,.docx

   • ID d'enregistrement lié : Lier à $Component.recordId (pour le lier à l'Opportunity courante).

   • Afficher le(s) fichier(s) téléversé(s) : Cochée

Résultat : Sur une page Opportunity, les utilisateurs peuvent utiliser ce composant pour téléverser un fichier PDF ou DOCX. Le fichier sera automatiquement lié à cette Opportunity et un message de réussite apparaîtra.

Considérations clés

• Limites de stockage de fichiers Salesforce : Soyez attentif aux limites globales de stockage de fichiers de votre organisation.

• Permissions utilisateur : Les utilisateurs ont besoin des permissions appropriées pour créer objet ContentDocument (Fichiers) et ContentDocumentLink enregistrements pour associer les fichiers aux enregistrements.

• Limites de taille des fichiers : Salesforce impose des limites sur la taille des fichiers individuels. Le composant peut également avoir ses propres limites configurables.

• Sécurité : Assurez-vous que la possibilité de téléverser et de lier des fichiers est appropriée pour les utilisateurs et le contexte de la page.

• Conventions de nommage : Utilisez les préfixes/suffixes de manière réfléchie si vous avez besoin d'un nommage standardisé des fichiers.

En résumé

Le composant Avonni File Upload offre un moyen simplifié et sans code d'intégrer le téléversement de fichiers et l'association d'enregistrements directement dans vos expériences de pages Lightning personnalisées, améliorant l'exhaustivité des données et l'efficacité des utilisateurs.