Barcode-Scanner
Überblick
Die Avonni Barcode Scanner-Komponente ermöglicht es Benutzern, Barcodes mit der Kamera eines Geräts innerhalb von Avonni Dynamic Components zu scannen. Sie eignet sich ideal für Bestandsverfolgung, Asset-Management oder schnelles Erfassen von Daten und bietet flexible Scan-Modi und visuelles Feedback.
Die Barcode Scanner-Komponente ist nur funktionsfähig, wenn sie innerhalb der Salesforce-Mobile-App verwendet wird. Obwohl Sie sie im Dynamic Components Builder App konfigurieren können, verwenden Sie sie ausschließlich in der Mobile-App.
Wesentliche Merkmale sind:
Automatischer oder manueller Start: Scanner beim Laden oder über einen Button öffnen.
Unterstützte Barcode-Typen: Bestimmte oder alle unterstützten Barcode-Formate scannen.
Anpassbare Benutzeroberfläche: Anweisungen, Erfolgsmeldungen, Größe und Animationen festlegen.
Multi-Scan-Optionen: Unterstützung für Stapel- oder gleichzeitige Scans.
Interaktionen: Aktionen bei erfolgreichen Scans auslösen (z. B. Datensätze aktualisieren).
Kamerasteuerung: Vorder- oder Rückkamera wählen und Datenvorschau anzeigen.
Tipp: In Flows für mobiles Scannen verwenden; mit Interaktionen koppeln, um gescannte Daten sofort zu verarbeiten.
Anwendungsfälle
Inventarverwaltung (z. B. Produktbarcodes scannen, um den Lagerbestand zu aktualisieren).
Asset-Tracking (z. B. Gerätekennungen in Salesforce protokollieren).
Event-Check-ins (z. B. Tickets von Teilnehmern scannen).
Point-of-Sale-Systeme (z. B. mehrere Artikel im Stapel erfassen).
Field Service (z. B. Seriennummern scannen, um Wartungen zu protokollieren).
Konfiguration
Wählen Sie den Barcode Scanner auf der Leinwand aus, um Eigenschaften im rechten Eigenschaftenbereich zuzugreifen.
Grundlegende Eigenschaften
Diese steuern das Verhalten des Scanners und die Datenverarbeitung.
API-Name
Text
Eindeutiger Bezeichner für die Instanz.
BarcodeScanner
Beim Laden öffnen
Boolesch
Wenn eingeschaltet, öffnet sich der Scanner automatisch beim Laden der Komponente.
Aus.
Barcode-Typen
Auswahl/Liste
Zu scannende Typen (z. B. QR, UPC); standardmäßig alle unterstützten Formate.
QR, Code128.
Anweisungstext
Text
Anleitung, die in der Scanner-Benutzeroberfläche angezeigt wird.
"Kamera auf den Barcode richten."
Erfolgstext
Text
Nach einem erfolgreichen Scan angezeigte Nachricht.
"Scan erfolgreich!"
Stapel-Scan aktivieren
Boolesch
Ermöglicht mehrere Scans, bis der Benutzer abbricht oder verlässt.
Ein.
Multi-Scan aktivieren
Boolesch
Scannt mehrere Barcodes gleichzeitig (aktiviert automatisch Stapel-Scan).
Aus.
Erfolgs-Häkchen anzeigen
Boolesch
Zeigt bei erfolgreichem Scan ein Häkchen an.
Ein.
Scanner-Größe
Auswählen
Kameraview-Größe als Prozentsatz des Gerätebildschirms.
Mittel (50%).
Kameraausrichtung
Auswählen
Kamera: vorne oder hinten.
hinten.
Mit Animation präsentieren
Boolesch
Animiert den Scanner beim Öffnen/Schließen ein/aus.
Ein.
Manuelle Bestätigung
Boolesch
Erfordert, dass der Benutzer jeden Scan bestätigt.
Aus.
Barcode-Datenvorschau
Boolesch
Zeigt Barcode-Daten während des Scannens an.
Ein.
Beste Praxis: Verwenden Sie den Anweisungstext, um Benutzer klar zu leiten; aktivieren Sie den Stapel-Scan für Aufgaben mit hohem Volumen.
Button-Einstellungen
Passen Sie den Button an, der den Scanner auslöst (wenn nicht Beim Laden öffnen).
Beschriftung
Text
Button-Text.
"Scan starten"
Variante
Auswählen
Stil: z. B. brand, neutral, destructive.
brand.
Icon-Name
Text (optional)
Icon (SLDS/Avonni).
utility:scan
Typ
Auswählen
Button-Typ (z. B. standard, icon).
standard.
Strecken
Boolesch
Dehnt den Button auf die Containerbreite aus.
Aus.
Deaktiviert
Boolesch
Deaktiviert den Button.
Aus.
Tipp: Verwenden Sie eine auffällige Variante wie 'brand' und ein Symbol wie 'utility:scan' für ein klares Nutzererlebnis.
Interaktionen-Tab
Definieren Sie Aktionen bei erfolgreichen Scans.
Bei erfolgreichem Scan
Einstellungen
Auslösen bei Scan: Greifen Sie auf Daten über $Component.BarcodeScanner.Value zu (z. B. Datensatz aktualisieren, Flow öffnen).
Beispiele
Beispiel 1: Einzelner Barcode-Inventarscan
Dieses Beispiel scannt einen einzelnen Produktbarcode, um das Inventar zu aktualisieren.
Scanner konfigurieren:
API-Name: InventoryScanner
Beim Laden öffnen: Aus
Barcode-Typen: UPC
Anweisungstext: "Produktbarcode scannen"
Erfolgstext: "Produkt hinzugefügt!"
Erfolgs-Häkchen anzeigen: Ein
Scanner-Größe: Mittel
Kameraausrichtung: hinten
Button-Einstellungen:
Beschriftung: "Artikel scannen"
Variante: brand
Icon-Name: utility:scan
Interaktion hinzufügen:
Bei erfolgreichem Scan: Datensatz aktualisieren (z. B. setzen des Feldes Product Inventory__c mit $Component.InventoryScanner.Value).
Ergebnis: Durch Klicken auf den Button öffnet sich der Scanner; ein erfolgreicher Scan aktualisiert den Datensatz und zeigt ein Häkchen an.
Beispiel 2: Stapel-Asset-Scan
Dieses Beispiel scannt mehrere Asset-Barcodes mit einem Seitenbereich für Ergebnisse.
Scanner konfigurieren:
API-Name: AssetScanner
Stapel-Scan aktivieren: Ein
Multi-Scan aktivieren: Ein
Anweisungstext: "Mehrere Assets scannen"
Scanner-Größe: Groß
Barcode-Datenvorschau: Ein
Button-Einstellungen:
Beschriftung: "Stapel-Scan starten"
Variante: neutral
Interaktion hinzufügen:
Bei erfolgreichem Scan: Ergebnisse hinzufügen.
Ergebnis: Benutzer scannen mehrere Barcodes, eine Liste.
Wichtige Überlegungen
Datenverarbeitung: Gescannten Daten sind als $Component.API_Name.Value verfügbar; für Aktualisierungen oder Flows verwenden.
Barcode-Typen: Typen einschränken, um Fehler zu reduzieren (z. B. nur QR für Tickets).
Stapel- vs. Multi-Scan: Stapel erlaubt sequenzielle Scans; Multi-Scan erfasst mehrere in einem Bildrahmen.
Mobile Optimierung: Testen Sie Scanner-Größe/Kameraausrichtung auf Geräten; Rückkameras haben oft höhere Qualität.
Interaktionen: Binden Sie Scandaten an Variablen oder Flows zur Verarbeitung (z. B. Bestandsaktualisierungen).
Barrierefreiheit: Stellen Sie sicher, dass Anweisungs- und Erfolgstexte klar sind; Animationen unterstützen visuelles Feedback.
Fehlerbehebung bei häufigen Problemen
Scanner öffnet sich nicht: Überprüfen Sie Beim Laden öffnen oder ob der Button deaktiviert ist; stellen Sie sicher, dass die Kamera des Geräts zugänglich ist.
Kein Scan erkannt: Überprüfen Sie, ob die Barcode-Typen mit den gescannten Codes übereinstimmen; testen Sie die Lichtverhältnisse.
Daten nicht erfasst: Bestätigen Sie, dass die Interaktion $Component.API_Name.Value korrekt bindet.
UI-Probleme: Passen Sie die Scanner-Größe für die Bildschirmansicht an; schalten Sie Animationen aus, wenn es zu Verzögerungen kommt.
Multi-Scan schlägt fehl: Stellen Sie sicher, dass das Gerät gleichzeitige Erkennung unterstützt; alternativ auf Stapel-Scan zurückgreifen.
Button wird nicht angezeigt: Überprüfen Sie Variante/Typ; stellen Sie sicher, dass er nicht deaktiviert ist.
Zusammenfassung
Die Avonni Barcode Scanner-Komponente vereinfacht die Barcode-Erfassung mit flexiblen Modi und Integrationen für Salesforce-Workflows. Sie ist ideal für Inventar, Assets oder Events.
Zuletzt aktualisiert
War das hilfreich?