Scanner d'étiquettes NFC

Aperçu

Le composant NFC Tag Scanner comble le fossé entre les actifs physiques et vos données Salesforce. Il permet à votre application de lire des informations depuis et d'écrire des données sur des tags NFC (Near Field Communication) directement depuis un appareil mobile.

En tirant parti du matériel NFC natif de la plupart des smartphones modernes, ce composant élimine les erreurs de saisie manuelle et accélère considérablement les opérations sur le terrain. Que vous suiviez des stocks, vérifiiez des badges de sécurité ou consigniez la maintenance d'équipements, le NFC Tag Scanner offre à vos utilisateurs une expérience fluide de « tap-and-go ».

Cas d'utilisation

• Suivi des actifs : Lire les tags NFC sur les équipements pour enregistrer des détails dans Salesforce.

• Gestion des stocks : Scanner les tags pour mettre à jour le stock ou vérifier des articles.

• Authentification : Lire les tags NFC pour la vérification d'un utilisateur ou d'un appareil.

• Enregistrement d'événements : Scanner les badges des participants pour un enregistrement rapide.

---

Configuration

Sélectionnez le composant NFC Tag Scanner sur le canevas pour accéder aux propriétés dans le panneau 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 API	Texte	Identifiant unique pour l'instance.	NFCTagScanner
Type	Sélectionner	Mode : lecture (scanner les données du tag) ou écriture (écrire des données sur le tag).	lecture
Ouverture au chargement	Booléen	Si activé, le scanner s'ouvre automatiquement lorsque le composant se charge.	Désactivé
Texte d'instruction	Texte	Indication affichée dans l'interface du scanner.	"Maintenez l'appareil près du tag NFC."
Texte de réussite	Texte	Message affiché après une lecture ou une écriture réussie.	"Tag scanné avec succès !"

Bonne pratique : Utilisez un texte d'instruction clair pour guider les utilisateurs (par exemple, le positionnement de l'appareil) ; choisissez lecture pour la plupart des cas d'utilisation sauf si vous devez écrire des données spécifiques sur les tags.

Paramètres du bouton

Personnalisez le bouton qui déclenche le scanner (si l'ouverture au chargement n'est pas activée).

Propriété	Type	Description	Options/Exemples
Libellé	Texte	Texte du bouton.	"Scanner le tag NFC"
Variante	Sélectionner	Style : par ex., brand, neutral, destructive.	brand
Nom de l'icône	Texte (optionnel)	Nom d'icône du Salesforce Lightning Design System (SLDS).	utility:rfid
Type	Sélectionner	Type de bouton : par ex., standard, icon.	standard
Étirement	Booléen	Étire le bouton à la largeur du conteneur.	Désactivé
Désactivé	Booléen	Désactive le bouton, empêchant l'interaction.	Désactivé

Astuce : Utilisez une icône comme utility:rfid pour plus de clarté ; testez Étirement pour les mises en page mobiles. (Espace réservé pour capture d'écran : UI du bouton du scanner NFC.)

Onglet Interactions

Définissez les actions en cas de lecture ou d'écriture réussie.

Propriété	Type	Description
Lors d'une lecture réussie	Paramètres	Déclencher à la fin de la lecture/écriture : accédez aux données via $Component.NFCTagScanner.Value (par ex., Mettre à jour un enregistrement, Afficher un toast, Naviguer).

Exemple 1 : Lecture de tags NFC pour le suivi des actifs

Cet exemple lit un tag NFC pour mettre à jour un enregistrement Asset.

1. Configurer le scanner :

   • Nom API : AssetTagScanner

   • Type : lecture

   • Ouverture au chargement : Désactivé

   • Texte d'instruction : "Placez l'appareil près du tag NFC de l'actif."

   • Texte de réussite : "Tag d'actif lu avec succès !"

2. Paramètres du bouton :

   • Libellé : "Scanner le tag de l'actif"

   • Variante : brand

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

3. Ajouter une interaction :

   • Lors d'une lecture réussie : Mettre à jour l'enregistrement (par ex., définir Asset SerialNumber__c sur $Component.AssetTagScanner.Value) ; afficher un toast "Actif mis à jour."

Résultat : Les utilisateurs appuient sur le bouton, scannent un tag NFC et mettent à jour l'enregistrement Asset avec les données du tag, avec un toast de confirmation.

Exemple 2 : Écriture de données sur des tags NFC

Cet exemple écrit un ID d'enregistrement sur un tag NFC pour une utilisation sur le terrain.

1. Configurer le scanner :

   • Nom API : TagWriter

   • Type : écriture

   • Ouverture au chargement : Désactivé

   • Texte d'instruction : "Maintenez le tag près de l'appareil pour écrire l'ID."

   • Texte de réussite : "ID écrit sur le tag !"

2. Paramètres du bouton :

   • Libellé : "Écrire sur le tag"

   • Variante : neutral

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

3. Ajouter une interaction :

   • Lors d'une lecture réussie : Écrire {!Record.Id} sur le tag ; afficher un toast "Tag mis à jour avec l'ID de l'enregistrement."

---

Considérations clés

• Compatibilité NFC : Assurez-vous que les appareils des utilisateurs prennent en charge le NFC ; testez sur mobile pour de meilleurs résultats.

• Lecture vs Écriture : Utilisez la lecture pour la capture de données ; l'écriture pour marquer des éléments avec des IDs ou des URL.

• Sortie des données : Les données scannées sont disponibles sous $Component.API_Name.Value ; utilisez-les pour des mises à jour ou des flux.

• Clarté des instructions : Fournissez des indications spécifiques (par ex., « Tenez à 2–3 cm ») pour réduire les erreurs de scan.

• Interactions : Liez les données de scan à des Variables ou des Flux pour le traitement (par ex., mises à jour d'enregistrements).

---

Résolution des problèmes courants

• Le scanner ne s'ouvre pas : Vérifiez la prise en charge du NFC par l'appareil ; contrôlez l'option Ouverture au chargement ou si le bouton est désactivé.

• Échec du scan : Assurez-vous que le Type correspond au tag (lecture/écriture) ; testez la proximité du tag et l'orientation de l'appareil.

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

• Erreurs d'écriture : Vérifiez que le tag est inscriptible ; assurez-vous que le format des données correspond à la capacité du tag.

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

---

Résumé

Le composant Avonni NFC Tag Scanner permet la lecture et l'écriture transparentes de tags NFC dans Salesforce, ce qui le rend idéal pour le suivi des actifs, l'authentification et les opérations sur le terrain. Avec une interface et des interactions personnalisables, il améliore les flux de travail mobiles.