Scanner de documents

Aperçu

Le composant Avonni Document Scanner permet aux utilisateurs de numériser des documents à l'aide de la caméra d'un appareil dans les composants dynamiques Salesforce ou les flux. Il est conçu pour le suivi des dépenses, la mise à jour des enregistrements ou la gestion des documents.

Cas d'utilisation

• Capturer des reçus de dépenses pour les formulaires de remboursement.

• Scanner des pièces d'identité ou des contrats pour l'intégration des clients.

• Numériser des formulaires papier pour les pièces jointes de dossiers ou d'enregistrements.

• Enregistrer les documents de livraison dans les flux logistiques.

• Archiver des documents physiques dans Salesforce Files.

---

Configuration

Sélectionnez le Document Scanner sur le canevas pour accéder aux propriétés dans le panneau de propriétés à droite.

Propriétés de base

Celles-ci contrôlent le comportement du scanner et la gestion des données.

Propriété	Type	Description	Exemple
Nom de l'API	Texte	Identifiant unique pour l'instance.	DocScanner
Ouverture au chargement	Booléen	Si activé, le scanner s'ouvre automatiquement lorsque le composant se charge.	Désactivé.
Source de l'image	Sélectionner	Source du document : caméra (numérisation en direct) ou téléversement (fichier de l'appareil).	caméra.
Afficher l'aperçu	Booléen	Affiche un aperçu du document numérisé pour vérification par l'utilisateur.	Activé.

Meilleure pratique : Activez l'option Afficher l'aperçu pour que les utilisateurs confirment la qualité du document avant le traitement ; utilisez la caméra pour la numérisation en temps réel dans les applications mobiles.

Paramètres du bouton

Personnalisez le bouton qui déclenche le scanner (si non Ouverture au chargement).

Astuce : Utilisez un libellé descriptif et une icône comme utility:camera pour plus de clarté ; testez l'option Étirement sur les mises en page mobiles. (Espace réservé pour capture d'écran : interface du bouton du scanner.)

Onglet Interactions

Définir des actions en cas de numérisations réussies.

Propriété	Type	Description
Lors d'un scan réussi	Paramètres	Déclencheur à la fin de la numérisation : Accédez aux données via $Component.DocScanner.Value (par ex. : Enregistrer dans Files, Mettre à jour un enregistrement, Ouvrir un flux).

---

Exemples

Exemple 1 : Numérisation d'un seul document pour le suivi des dépenses

Cet exemple numérise un reçu et l'enregistre dans un fichier Salesforce.

1. Configurer le scanner :

   • Nom API : ReceiptScanner

   • Ouverture au chargement : Désactivé

   • Source de l'image : caméra

   • Afficher l'aperçu : Activé

2. Paramètres du bouton :

   • Libellé : "Numériser le reçu"

   • Variante : marque

   • Nom de l'icône : utility:camera

3. Ajouter une interaction :

   • En cas de numérisation réussie : Créer un enregistrement de fichier en utilisant $Component.ReceiptScanner.Value (données de l'image numérisée) pour remplir le ContentVersion.

Résultat : Cliquer sur le bouton ouvre la caméra ; après la numérisation, les utilisateurs prévisualisent le reçu et l'enregistrent dans Salesforce lors de la confirmation.

---

Exemple 2 : Document téléversé pour pièce jointe de dossier

Cet exemple un image de document pour un dossier.

1. Configurer le scanner :

   • Nom API : CaseDocScanner

   • Ouverture au chargement : Désactivé

   • Source de l'image : téléversement

   • Afficher l'aperçu : Activé

2. Paramètres du bouton :

   • Libellé : "Téléverser le document"

   • Variante : neutre

   • Nom de l'icône : utility:upload

3. Ajouter une interaction :

   • En cas de numérisation réussie : Mettre à jour un enregistrement de dossier (Case), en joignant $Component.CaseDocScanner.Value en tant que fichier.

Résultat : Les utilisateurs téléversent un document, le prévisualisent et l'attachent à un enregistrement de dossier via l'interaction.

---

Considérations clés

• Sortie de données : Les données numérisées sont disponibles sous $Component.API_Name.Value (données d'image) ; utilisez-les pour les téléversements de fichiers ou le traitement dans les flux.

• Choix de la source d'image : Utilisez la caméra pour la numérisation en direct ; le téléversement pour des images préexistantes.

• Utilisation de l'aperçu : Activez Afficher l'aperçu pour réduire les erreurs en permettant aux utilisateurs de vérifier les numérisations.

• Optimisation mobile : Testez l'accès à la caméra et la taille du scanner (via le panneau Style si pris en charge) sur les appareils.

• Interactions : Mappez les données numérisées aux objets File ou ContentVersion ; testez les intégrations de flux.

• Accessibilité : Assurez-vous que les libellés des boutons sont clairs ; le texte de l'aperçu doit aider les lecteurs d'écran.

---

Dépannage des problèmes courants

• Le scanner ne s'ouvre pas : Vérifiez Open Onload ou le bouton Désactivé ; confirmez les permissions caméra/fichier de l'appareil.

• Aucun aperçu affiché : Activez Afficher l'aperçu ; assurez-vous que la numérisation/le téléversement s'est terminé avec succès.

• Données non capturées : Confirmez le lien $Component.API_Name.Value dans les interactions ; testez avec des données statiques.

• Problèmes de caméra : Vérifiez l'orientation de la caméra (si prise en charge) ou les permissions ; essayez le téléversement en solution de secours.

• Bouton non réactif : Assurez-vous qu'il n'est pas Désactivé ; vérifiez les paramètres Variante/Type.

• Qualité de l'image : Ajustez l'éclairage pour la caméra ; vérifiez la compatibilité du format de fichier téléversé.

---

Résumé

Le composant Avonni Document Scanner simplifie la capture de documents dans Salesforce, avec des options flexibles caméra/téléversement et une intégration fluide pour la mise à jour des enregistrements. Il est idéal pour le suivi des dépenses, les pièces jointes de dossiers, et plus encore.