Μετάβαση στο περιεχόμενο

Barcode Scanner Emulator

Πώς να δοκιμάσετε σαρωτές γραμμωτού κώδικα σε εφαρμογές ιστού

Πολλοί σαρωτές γραμμωτού κώδικα USB και Bluetooth στέλνουν τα αποκωδικοποιημένα δεδομένα ως εισαγωγή πληκτρολογίου, ώστε ένα εστιασμένο πεδίο σε εφαρμογή ιστού να λαμβάνει μια σάρωση χωρίς API προγράμματος περιήγησης ειδικό για σαρωτή. Οι σειριακές θύρες και τα SDK κατασκευαστών είναι ξεχωριστές ενοποιήσεις. Μπορείτε να δοκιμάσετε τη διαδρομή πληκτρολογίου με φυσικό σαρωτή ή με προσομοιωμένα πατήματα πλήκτρων.

Μια εφαρμογή ιστού βλέπει συνήθως έναν σαρωτή γραμμωτού κώδικα ως πληκτρολόγιο. Η δοκιμή είναι αν το εστιασμένο στοιχείο ελέγχου λαμβάνει το φορτίο που περιμένει η εφαρμογή σας και αν η σελίδα χειρίζεται τον τερματιστή που ο σαρωτής είναι ρυθμισμένος να στέλνει. Ο τερματιστής μπορεί να είναι Enter, Tab ή να λείπει εντελώς.

Χρησιμοποιήστε μια συνεδρία στον ελεγκτή εισαγωγής γραμμωτού κώδικα όταν είναι συνδεδεμένος φυσικός σαρωτής. Χρησιμοποιήστε το Barcode Scanner Emulator όταν χρειάζεστε την ίδια διαδρομή πληκτρολογίου κατά την ανάπτυξη και το υλικό δεν βρίσκεται στο γραφείο. Μια ευρύτερη ματιά στην εστίαση, στη διάταξη και στις ροές POS βρίσκεται στο Πώς να δοκιμάσετε την εισαγωγή σαρωτή γραμμωτού κώδικα. Αυτός ο οδηγός μένει στην εφαρμογή του προγράμματος περιήγησης: καταγραφή, καταλήξεις, επικύρωση και τα συμβάντα που μπορείτε πράγματι να παρατηρήσετε.

Πώς επικοινωνούν οι σαρωτές γραμμωτού κώδικα με τις εφαρμογές ιστού

Η λειτουργία διασύνδεσης αποφασίζει τι μπορεί να λάβει η σελίδα. Επιβεβαιώστε την πριν αλλάξετε τον κώδικα της φόρμας. Ένας σαρωτής μπορεί συχνά να αλλάξει λειτουργία σαρώνοντας έναν γραμμωτό κώδικα ρύθμισης από το εγχειρίδιο του κατασκευαστή.

Σφήνα πληκτρολογίου USB HID

Στη λειτουργία πληκτρολογίου USB HID ο σαρωτής απαριθμείται ως πληκτρολόγιο. Το λειτουργικό σύστημα φορτώνει το συνηθισμένο πρόγραμμα οδήγησης πληκτρολογίου. Αφού ο σαρωτής αποκωδικοποιήσει ένα σύμβολο, στέλνει τους χαρακτήρες ως πατήματα πλήκτρων στο στοιχείο ελέγχου που έχει εστίαση πληκτρολογίου. Η σελίδα ακούει αυτά τα πατήματα ή διαβάζει το κείμενο που εισάγουν. Δεν ανοίγει σύνδεση με τη συσκευή.

Αυτή η διαδρομή είναι ο λόγος που ένα πεδίο ταμείου, ένα πλαίσιο αναζήτησης ή οποιαδήποτε άλλη εισαγωγή κειμένου μπορεί να δεχτεί σάρωση με συνηθισμένη HTML. Ο οδηγός HID σφήνα πληκτρολογίου καλύπτει την ακολουθία πατημάτων, τα προθέματα και τις καταλήξεις με περισσότερη λεπτομέρεια.

Bluetooth HID

Ένας σαρωτής Bluetooth συζευγμένος ως πληκτρολόγιο χρησιμοποιεί την ίδια διαδρομή εφαρμογής. Ο υπολογιστής τον αντιμετωπίζει ως πληκτρολόγιο HID και το εστιασμένο πεδίο λαμβάνει πατήματα πλήκτρων. Η σύζευξη, η μπαταρία και το ασύρματο σήμα αφορούν τη συσκευή. Μόλις οι χαρακτήρες φτάσουν στο πρόγραμμα περιήγησης, η σελίδα τους χειρίζεται όπως την εισαγωγή σφήνας USB.

Σειριακή θύρα και εικονική θύρα COM

Ένας σειριακός σαρωτής, συμπεριλαμβανομένων πολλών λειτουργιών εικονικής θύρας COM μέσω USB, στέλνει το αποκωδικοποιημένο κείμενο ως byte σε μια θύρα. Η εστίαση δεν επιλέγει τον προορισμό. Τον επιλέγει η διεργασία που ανοίγει τη θύρα. Ένα πεδίο κειμένου που ακούει μόνο πατήματα πλήκτρων δεν βλέπει αυτή τη ροή.

Τα προγράμματα περιήγησης που βασίζονται στο Chromium μπορούν να ανοίξουν σειριακή θύρα μέσω του Web Serial API αφού ο χρήστης επιλέξει τη θύρα και δώσει άδεια. Τα Firefox και Safari δεν παρέχουν αυτό το API. Μια δοκιμή σφήνας δεν ασκεί μια σειριακή ενοποίηση, και μια σειριακή δοκιμή δεν λέει τι θα πληκτρολογήσει ένας σαρωτής σφήνας.

Διασυνδέσεις ειδικές για τον κατασκευαστή

Ορισμένες συσκευές χρησιμοποιούν SDK κατασκευαστή, OPOS, JPOS ή μια διασύνδεση HID που δεν είναι πληκτρολόγιο, όπως το USB HID POS. Αυτές οι διασυνδέσεις δεν πληκτρολογούν στο εστιασμένο πεδίο. Μια συνηθισμένη ιστοσελίδα δεν μπορεί να φορτώσει εγγενές SDK. Το Chromium μπορεί να ζητήσει ορισμένες συσκευές HID που δεν είναι πληκτρολόγια μέσω WebHID μετά από χειρονομία του χρήστη. Οι συσκευές HID της κλάσης πληκτρολογίου παραμένουν αποκλεισμένες, οπότε ένας σαρωτής σφήνας μένει δυσδιάκριτος από πληκτρολόγιο. Αντιμετωπίστε μια διασύνδεση κατασκευαστή ως δική της ενοποίηση και δοκιμάστε την με το λογισμικό που ανοίγει πράγματι τη διασύνδεση.

Τι μπορεί να δει το πρόγραμμα περιήγησης

Μια σάρωση σφήνας φτάνει ως συμβάντα keydown και keyup, και οι εκτυπώσιμοι χαρακτήρες ενημερώνουν το εστιασμένο πεδίο. Το πρόγραμμα περιήγησης δεν λαμβάνει όνομα συσκευής, σειριακό αριθμό USB ούτε σημαία που να λέει ότι η πηγή είναι σαρωτής. Τα προγράμματα περιήγησης που υλοποιούν το WebHID εξακολουθούν να αρνούνται τις διασυνδέσεις πληκτρολογίου, οπότε το σενάριο της σελίδας δεν μπορεί να διαβάσει ούτε τις ακατέργαστες αναφορές HID ενός σαρωτή σφήνας.

Το event.key είναι ο χαρακτήρας ή το όνομα πλήκτρου αφού το λειτουργικό σύστημα εφαρμόσει την ενεργή διάταξη πληκτρολογίου. Το event.code ονομάζει το φυσικό πλήκτρο, όπως Digit1 ή Numpad1, και μπορεί να μείνει το ίδιο όταν μια ασυμφωνία διάταξης αλλάζει το event.key. Καμία ιδιότητα δεν αναγνωρίζει το υλικό.

Πώς να δοκιμάσετε έναν φυσικό σαρωτή γραμμωτού κώδικα σε πρόγραμμα περιήγησης

Εκτελέστε αυτό πριν αποσφαλματώσετε τον κώδικα της εφαρμογής. Δείχνει την ακριβή συμβολοσειρά και τον τερματιστή που έλαβε το πρόγραμμα περιήγησης.

  1. Συνδέστε τον σαρωτή και περιμένετε μέχρι να δείξει ότι έχει τροφοδοσία. Για Bluetooth, ολοκληρώστε τη σύζευξη και επιβεβαιώστε ότι ο υπολογιστής χρησιμοποιεί προφίλ πληκτρολογίου.
  2. Επιβεβαιώστε τη λειτουργία εισαγωγής. Η σφήνα πληκτρολογίου, το πληκτρολόγιο USB HID ή το πληκτρολόγιο Bluetooth HID μπορούν να πληκτρολογήσουν σε πεδίο. Η σειριακή λειτουργία, το SPP και το SDK κατασκευαστή δεν μπορούν.
  3. Ανοίξτε τον ελεγκτή εισαγωγής γραμμωτού κώδικα.
  4. Κάντε κλικ στο Έναρξη δοκιμής ή κάντε κλικ στην περιοχή σάρωσης. Γίνεται μπλε όταν είναι έτοιμη. Η σελίδα δεν παίρνει εστίαση μόνη της.
  5. Σαρώστε έναν γραμμωτό κώδικα του οποίου το φορτίο ήδη γνωρίζετε. Ξεκινήστε με μια σύντομη αριθμητική τιμή και έπειτα σαρώστε μια τιμή που περιλαμβάνει τα σημεία στίξης που αποθηκεύει η εφαρμογή σας.
  6. Διαβάστε την καταγεγραμμένη τιμή και τον αριθμό χαρακτήρων. Συγκρίνετε και τα δύο με το φορτίο που περιμένετε, μαζί με οποιοδήποτε πρόθεμα εισάγει ο σαρωτής πριν από τα δεδομένα.
  7. Ελέγξτε την κατάληξη. Ο ελεγκτής αναφέρει ENTER, TAB ή Καμία. Με ενεργή την Αυτόματη καταγραφή, το αποτέλεσμα εμφανίζεται μετά από Enter, Tab ή μια σύντομη παύση μόλις σταματήσουν τα πλήκτρα. Απενεργοποιήστε την Αυτόματη καταγραφή όταν θέλετε η καταγραφή να κρατηθεί μέχρι να πατήσετε Διακοπή.
  8. Συγκρίνετε αυτό το αποτέλεσμα με τη συμβολοσειρά που πρέπει να αποθηκεύσει η εφαρμογή σας. Ένα πρόθεμα, ένας αντικατεστημένος χαρακτήρας ή ένας τερματιστής που λείπει πρέπει να διορθωθεί στη ρύθμιση του σαρωτή ή να αντιμετωπιστεί σκόπιμα στη σελίδα. Μην το αντιμετωπίζετε ως αποτυχία αποκωδικοποίησης πριν ολοκληρωθεί αυτή η σύγκριση.

Ο ελεγκτής καταγράφει συμβάντα πληκτρολογίου που μπορεί να δει το πρόγραμμα περιήγησης. Δεν μπορεί να αναγνωρίσει τη συσκευή USB ούτε να διαβάσει μια σειριακή θύρα. Όταν ένας επεξεργαστής κειμένου λαμβάνει τη σάρωση και το πρόγραμμα περιήγησης όχι, συνεχίστε με Ο σαρωτής λειτουργεί στο Notepad αλλά όχι στο POS.

Καταγραφή εισαγωγής σαρωτή γραμμωτού κώδικα με JavaScript

Ο σαρωτής πληκτρολογεί στο στοιχείο που έχει εστίαση. Δώστε στο πεδίο μια ορατή ετικέτα, αφήστε το ως συνηθισμένη εισαγωγή κειμένου ώστε οι χρήστες πληκτρολογίου να μπορούν να πληκτρολογήσουν έναν κωδικό, και διαβάστε την τιμή όταν η ροή λέει ότι η καταχώριση ολοκληρώθηκε. Η σελίδα παρακάτω το κάνει αυτό. Το Enter υποβάλλει τη φόρμα μία φορά. Το Tab ολοκληρώνει μια μη κενή τιμή και έπειτα αφήνει το πρόγραμμα περιήγησης να μετακινήσει την εστίαση. Μια σάρωση χωρίς τερματιστή μένει στο πεδίο μέχρι κάποιος να ενεργοποιήσει το Look up.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Barcode input example</title>
</head>
<body>
  <form id="barcode-form">
    <label for="barcode">Barcode</label>
    <input id="barcode" name="barcode" type="text" autocomplete="off" spellcheck="false">
    <button type="submit">Look up</button>
  </form>
  <p id="message" role="status"></p>
  <ul id="accepted"></ul>
  <script>
    const form = document.querySelector('#barcode-form')
    const field = document.querySelector('#barcode')
    const message = document.querySelector('#message')
    const list = document.querySelector('#accepted')

    if (
      !(form instanceof HTMLFormElement) ||
      !(field instanceof HTMLInputElement) ||
      !(message instanceof HTMLElement) ||
      !(list instanceof HTMLUListElement)
    ) {
      throw new Error('Barcode form markup is missing.')
    }

    function payload(raw) {
      return raw.replace(/[\r\n]/g, '').trim()
    }

    function classify(raw) {
      const value = payload(raw)
      if (!value) {
        return { status: 'empty' }
      }
      if (/[\u0000-\u001F\u007F]/.test(value)) {
        return {
          status: 'invalid',
          message: 'Control character in the barcode. Check the prefix, suffix, and symbology identifier.',
        }
      }
      return { status: 'ok', value }
    }

    function accept(value) {
      const item = document.createElement('li')
      item.textContent = value
      list.append(item)
      message.textContent = 'Accepted ' + value
      field.value = ''
    }

    function reject(text) {
      message.textContent = text
    }

    form.addEventListener('submit', (event) => {
      event.preventDefault()
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        reject('No barcode received.')
        field.focus()
        return
      }
      if (outcome.status === 'invalid') {
        reject(outcome.message)
        field.focus()
        return
      }
      accept(outcome.value)
      field.focus()
    })

    field.addEventListener('keydown', (event) => {
      if (event.key !== 'Tab' || event.shiftKey) {
        return
      }
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        return
      }
      if (outcome.status === 'invalid') {
        event.preventDefault()
        reject(outcome.message)
        return
      }
      accept(outcome.value)
    })

    field.focus()
  </script>
</body>
</html>

Αποθηκεύστε το αρχείο και ανοίξτε το σε πρόγραμμα περιήγησης επιτραπέζιου υπολογιστή. Κάντε κλικ στο πεδίο αν η εστίαση έχει μετακινηθεί. Ένας σαρωτής σφήνας, ή ο εξομοιωτής στην επόμενη ενότητα, πληκτρολογεί έπειτα στο #barcode.

Η εστίαση είναι απαραίτητη. Αν το document.activeElement είναι το σώμα του εγγράφου, ένα κουμπί ή μια άλλη εισαγωγή, οι ακροατές αυτού του πεδίου δεν βλέπουν τη σάρωση. Οι χαρακτήρες καταλήγουν στο εστιασμένο στοιχείο ελέγχου ή χάνονται. Καλέστε το field.focus() όταν η ροή είναι έτοιμη για σάρωση, και μετά το κλείσιμο ενός διαλόγου.

Η κενή εισαγωγή αγνοείται. Η φόρμα μένει στη θέση της και το κείμενο κατάστασης λέει ότι δεν ελήφθη τίποτα. Μόνο το κενό διάστημα είναι κενό μετά το trim().

Το παράδειγμα δεν προσθέτει Enter ή Tab. Αν ο σαρωτής δεν είναι ρυθμισμένος να τα στέλνει, η τιμή μένει στο πεδίο και το Look up είναι η διαδρομή ολοκλήρωσης. Το autocomplete="off" μειώνει την πιθανότητα μια αποθηκευμένη τιμή να αντικαταστήσει τη σάρωση. Η ετικέτα, το κουμπί και το Shift+Tab παραμένουν διαθέσιμα, ώστε ένα άτομο να μπορεί να εισαγάγει κωδικό χωρίς σαρωτή.

Χειριστείτε το Enter σε ένα σημείο. Το παράδειγμα χρησιμοποιεί το συμβάν submit της φόρμας, που καλύπτει και το κουμπί Look up και το Enter του πληκτρολογίου. Ένας δεύτερος ακροατής keydown για το Enter θα κατέγραφε την ίδια σάρωση δύο φορές. Αν η εισαγωγή δεν βρίσκεται μέσα σε φόρμα, ακούστε το Enter στο keydown και καλέστε το preventDefault() ώστε μια γονική φόρμα να μην υποβληθεί επίσης:

field.addEventListener('keydown', (event) => {
  if (event.key !== 'Enter') {
    return
  }

  event.preventDefault()
  const value = field.value.trim()
  if (!value) {
    return
  }

  console.log(value)
  field.value = ''
})

Καθαρίστε το πεδίο μετά από επιτυχή αποδοχή, ώστε η επόμενη σάρωση να μην προστεθεί στο προηγούμενο φορτίο. Μετά το Enter, το παράδειγμα εστιάζει ξανά το ίδιο πεδίο, επειδή αυτή η ροή περιμένει άλλη μία σάρωση στο ίδιο πλαίσιο. Μετά το Tab αφήνει την εστίαση, ώστε το πρόγραμμα περιήγησης να μπορεί να προχωρήσει στο επόμενο στοιχείο ελέγχου.

Χειρισμός των καταλήξεων ENTER και TAB

Μια κατάληξη είναι ένα πλήκτρο που ο σαρωτής μπορεί να στείλει μετά το φορτίο. Είναι ρύθμιση της συσκευής. Το Enter είναι συνηθισμένο και προαιρετικό. Ο οδηγός Καταλήξεις ENTER και TAB σε σαρωτές γραμμωτού κώδικα περιγράφει πώς να ξεχωρίζετε τους τερματιστές. Επιβεβαιώστε τη ρύθμιση στον σαρωτή που δοκιμάζετε και έπειτα κάντε τη σελίδα να ταιριάζει με αυτή τη ροή.

ENTER

Το Enter μέσα σε πεδίο κειμένου μίας γραμμής υποβάλλει την περιβάλλουσα φόρμα στα τρέχοντα προγράμματα περιήγησης. Χρησιμοποιήστε το όταν μία σάρωση πρέπει να καταχωρίσει την τιμή, όπως σε ένα πλαίσιο αναζήτησης. Το preventDefault() στο συμβάν submit σταματά το πρόγραμμα περιήγησης από το να απομακρυνθεί. Παραλείψτε το όταν η πλήρης πλοήγηση σελίδας είναι η συμπεριφορά που θέλετε.

Αν εμφανίζεται ο γραμμωτός κώδικας και η φόρμα δεν κάνει τίποτα, ο σαρωτής μπορεί να μην στέλνει κατάληξη. Το Λείπει το ENTER από τον σαρωτή γραμμωτού κώδικα εξετάζει αυτή τη ρύθμιση. Ορισμένες συσκευές στέλνουν NumPad Enter. Το event.key παραμένει "Enter". Ελέγξτε το event.key, όχι μόνο το event.code === "Enter", αλλιώς ο σαρωτής θα φαίνεται χαλασμένος.

TAB

Το Tab μετακινεί την εστίαση στο επόμενο στοιχείο ελέγχου που μπορεί να εστιαστεί. Ταιριάζει σε ακολουθία όπως κωδικός προϊόντος και έπειτα ποσότητα. Ξαφνιάζει μια φόρμα που περίμενε το Enter να την υποβάλει.

Διαβάστε την τιμή στο keydown ενώ το πεδίο έχει ακόμη εστίαση. Το πρόγραμμα περιήγησης μετακινεί την εστίαση μετά από αυτό το συμβάν. Αφήστε την προεπιλεγμένη ενέργεια όταν το επόμενο στοιχείο ελέγχου πρέπει να λάβει εστίαση. Το preventDefault() κρατά την εστίαση εκεί που είναι, κάτι χρήσιμο όταν η τιμή είναι άκυρη και θέλετε να τη δει ο χειριστής. Αγνοήστε το Shift+Tab ώστε ένας χρήστης πληκτρολογίου να μπορεί να κινηθεί προς τα πίσω στη φόρμα. Μια κατάληξη Tab από τον σαρωτή είναι Tab χωρίς Shift.

Μια κατάληξη Tab μπορεί επίσης να μετακινήσει την εστίαση πριν ο κώδικάς σας διαβάσει το πεδίο, αν ο ακροατής είναι στο blur ή στο change και κάτι άλλο καθαρίζει το στοιχείο ελέγχου. Διαβάστε την τιμή από τον στόχο του συμβάντος keydown.

Χωρίς κατάληξη

Χωρίς κατάληξη, το φορτίο κάθεται στο πεδίο. Η εφαρμογή πρέπει να αποφασίσει πότε τελείωσε η σάρωση. Ένα ρητό κουμπί, ένα μεταγενέστερο Enter από τον χειριστή ή η μετάβαση σε άλλο βήμα είναι αξιόπιστα σημεία ολοκλήρωσης. Ένας χρονομετρητής αδράνειας μπορεί να θεωρήσει μια παύση στην πληκτρολόγηση ως τέλος σάρωσης. Ο χρονομετρητής είναι ευρετικός. Ένας αργός σαρωτής, μια καθυστέρηση Bluetooth ή ένα άτομο που πληκτρολογεί γρήγορα μπορεί να πέσει στη λάθος πλευρά του κατωφλίου. Προτιμήστε μια ρυθμισμένη κατάληξη όταν η ροή χρειάζεται σαφές σήμα τέλους σάρωσης.

Διαφορές ρύθμισης

Σαρωτές της ίδιας μάρκας μπορεί να αποστέλλονται με διαφορετικές καταλήξεις, και ένας γραμμωτός κώδικας ρύθμισης μπορεί να αλλάξει την κατάληξη χωρίς καμία αλλαγή στη JavaScript σας. Ορισμένες συσκευές στέλνουν πρόθεμα, αναγνωριστικό συμβολολογίας όπως ]C1, ή CR και LF. Δοκιμάστε τις τρεις ρυθμίσεις τερματιστή που μπορούν πράγματι να επιλέξουν οι χρήστες σας: Enter, Tab και καμία. Σημειώστε ποια χρησιμοποιούν οι σαρωτές που έχουν αναπτυχθεί και δοκιμάστε τη σελίδα έναντι αυτής της ρύθμισης.

Επικύρωση εισαγωγής σαρωτή γραμμωτού κώδικα

Επικυρώστε τη συμβολοσειρά που έλαβε το πεδίο. Μην υποθέτετε ότι κάθε γραμμωτός κώδικας έχει το ίδιο μήκος, το ίδιο σύνολο χαρακτήρων ή το ίδιο ψηφίο ελέγχου. Τα φορτία Code 128 και QR ποικίλλουν. Το EAN-13 είναι 13 ψηφία. Μια εφαρμογή που αποθηκεύει και τα δύο χρειάζεται κανόνες και για τα δύο.

Κενή εισαγωγή. Απορρίψτε την ή αγνοήστε την. Μια κατάληξη χωρίς φορτίο, ή ένα κλικ στο Look up σε κενό πεδίο, δεν πρέπει να δημιουργεί εγγραφή.

Απροσδόκητοι χαρακτήρες. Συγκρίνετε τη συμβολοσειρά που ελήφθη με μια γνωστή ετικέτα. Μια ασυμφωνία διάταξης εμφανίζεται συχνά ως αλλαγμένο σύμβολο, όπως μετατοπισμένο ψηφίο ή στίξη, ενώ το μήκος μένει το ίδιο. Χαρακτήρες ελέγχου μπορούν να προέρχονται από πρόθεμα ή από διαχωριστή ομάδας GS1. Επιτρέψτε τους χαρακτήρες που ορίζει η μορφή σας. Το παραπάνω παράδειγμα απορρίπτει χαρακτήρες ελέγχου ASCII ώστε να μείνουν ορατοί στο κείμενο κατάστασης. Ένας αναλυτής GS1 που περιμένει διαχωριστή ομάδας πρέπει να επιτρέπει αυτόν τον χαρακτήρα και να απορρίπτει τους υπόλοιπους.

Μήκος. Επιβάλετε τα μήκη που δέχεται η εφαρμογή σας. Ένα συνολικό ελάχιστο και μέγιστο είναι ασφαλέστερο από ένα απαιτούμενο μήκος όταν η φόρμα λαμβάνει περισσότερες από μία συμβολολογίες. Το maxlength στην εισαγωγή περικόπτει σιωπηλά ένα μακρύτερο φορτίο, οπότε ορίστε το μόνο όταν κάθε αποδεκτός κωδικός χωρά.

Πρόθεμα. Αφαιρέστε ένα πρόθεμα μόνο όταν ρυθμίσατε τον σαρωτή να στέλνει ακριβώς αυτό το πρόθεμα και η εφαρμογή δεν το αποθηκεύει.

function withoutConfiguredPrefix(value, prefix) {
  if (prefix && value.startsWith(prefix)) {
    return value.slice(prefix.length)
  }
  return value
}

Ένα αναγνωριστικό συμβολολογίας AIM είναι δεδομένα αν ο σαρωτής είναι ρυθμισμένος να το μεταδίδει. Αφήστε το στη θέση του μέχρι να αποφασίσετε αν η εφαρμογή το αποθηκεύει.

Κατάληξη. Κρατήστε τον τερματιστή έξω από την αποθηκευμένη τιμή. Τα Enter και Tab είναι πλήκτρα. Δεν εισάγονται σε συνηθισμένη εισαγωγή κειμένου. Ένα σειριακό φορτίο μπορεί ακόμη να περιλαμβάνει byte CR ή LF. Αφαιρέστε τα στο όριο όπου αναλύετε τη σειριακή ροή και δοκιμάστε ότι δεν τα αφαιρείτε από τη μέση ενός φορτίου που τα περιέχει νόμιμα.

Διπλές υποβολές. Μία σάρωση μπορεί να αντιμετωπιστεί δύο φορές αν και το keydown και το submit εκτελεστούν για το ίδιο Enter. Χρησιμοποιήστε μία διαδρομή ολοκλήρωσης. Μια δεύτερη σάρωση του ίδιου κωδικού είναι διαφορετικό ζήτημα. Μια φόρμα αποθήκης μπορεί να αυξήσει την ποσότητα. Μια φόρμα εισιτηρίου μπορεί να απορρίψει έναν κωδικό που έχει ήδη εξαργυρωθεί. Βάλτε αυτόν τον κανόνα στην εφαρμογή και δοκιμάστε τον επίτηδες. Το πρόγραμμα περιήγησης δεν μπορεί να ξεχωρίσει ένα δεύτερο τράβηγμα σκανδάλης από έναν δεύτερο ακροατή.

Κανόνες εφαρμογής. Τα ψηφία ελέγχου ανήκουν σε συγκεκριμένες συμβολολογίες. Το EAN-13 χρησιμοποιεί το τελευταίο ψηφίο ως ψηφίο ελέγχου. Αυτή η συνάρτηση δέχεται μόνο αυτή τη μορφή:

function isEan13(value) {
  if (!/^\d{13}$/.test(value)) {
    return false
  }

  let sum = 0
  for (let index = 0; index < 12; index += 1) {
    const digit = Number(value[index])
    sum += index % 2 === 0 ? digit : digit * 3
  }

  const check = (10 - (sum % 10)) % 10
  return check === Number(value[12])
}

Τα Code 128, Code 39 και QR δεν χρησιμοποιούν αυτόν τον υπολογισμό. Ο σαρωτής μπορεί ήδη να έχει ελέγξει τη δική του συμβολολογία και να έχει μεταδώσει τα αναγνώσιμα δεδομένα. Επικυρώστε τις μορφές που αποθηκεύετε και επαναλάβετε τον έλεγχο στον διακομιστή. Η συμβολοσειρά που αποστέλλεται είναι συνηθισμένη εισαγωγή χρήστη. Το πρόγραμμα περιήγησης δεν μπορεί να αποδείξει ότι την παρήγαγε σαρωτής.

Δοκιμή εισαγωγής σαρωτή γραμμωτού κώδικα χωρίς φυσικό υλικό

Το Barcode Scanner Emulator είναι εφαρμογή επιτραπέζιου υπολογιστή για Windows, macOS και Linux. Εισάγετε το κείμενο προς αποστολή, επιλέγετε καθυστέρηση πληκτρολόγησης και επιλέγετε κατάληξη καμία, ENTER ή TAB. Μια καθολική συντόμευση πληκτρολογεί αυτό το κείμενο στην εστιασμένη εφαρμογή. Αναπαράγει τη διαδρομή πληκτρολογίου που χρησιμοποιεί ένας σαρωτής σφήνας. Δεν φωτίζει ετικέτα, δεν διαβάζει σύμβολο και δεν αποκωδικοποιεί συμβολολογία.

Χρησιμοποιήστε την παραπάνω σελίδα παραδείγματος ή τη σελίδα που χτίζετε:

  1. Ανοίξτε τη σελίδα σε πρόγραμμα περιήγησης επιτραπέζιου υπολογιστή και κάντε κλικ στο πεδίο γραμμωτού κώδικα.
  2. Στον εξομοιωτή εισαγάγετε μια γνωστή τιμή, όπως 123456789012.
  3. Ορίστε την κατάληξη σε ENTER. Ορίστε την καθυστέρηση πληκτρολόγησης αν θέλετε η ριπή να μοιάζει με σαρωτή που έχετε ήδη μετρήσει.
  4. Πατήστε την καθολική συντόμευση σάρωσης του εξομοιωτή ενώ το πεδίο του προγράμματος περιήγησης έχει ακόμη εστίαση.
  5. Επιβεβαιώστε το κείμενο κατάστασης και ότι η τιμή έγινε αποδεκτή μία φορά.
  6. Επαναλάβετε με TAB. Η εστίαση πρέπει να μετακινηθεί και η τιμή πρέπει να γίνει αποδεκτή μία φορά.
  7. Επαναλάβετε χωρίς κατάληξη. Το κείμενο πρέπει να μείνει στο πεδίο μέχρι να ενεργοποιήσετε το Look up.
  8. Εστιάστε τον ελεγκτή εισαγωγής γραμμωτού κώδικα και στείλτε ξανά την ίδια τιμή. Συγκρίνετε την καταγεγραμμένη συμβολοσειρά, το πρόθεμα και την κατάληξη με ό,τι αποθήκευσε η εφαρμογή.

Η εγκατάσταση και η πρώτη συντόμευση καλύπτονται στο Ξεκινώντας. Μετά από αλλαγή ρυθμίσεων, στείλτε μία σάρωση στον ελεγκτή εισαγωγής πριν εμπιστευτείτε το αποτέλεσμα στην εφαρμογή.

Το υλικό εξακολουθεί να απαιτείται για τα οπτικά και τα ειδικά για τη συσκευή μέρη της δοκιμής:

  • Αν ο συγκεκριμένος σαρωτής μπορεί να αποκωδικοποιήσει το τυπωμένο ή προβεβλημένο σύμβολο, συμπεριλαμβανομένων κατεστραμμένων ετικετών, μεγέθους, αντίθεσης και απόστασης.
  • Υποστήριξη συμβολολογίας. Ένας σαρωτής λέιζερ 1D δεν μπορεί να διαβάσει κωδικό QR. Δείτε Δοκιμή κωδίκων QR: πώς να δοκιμάσετε σαρωτές κωδίκων QR.
  • Απαρίθμηση USB, σύζευξη Bluetooth και η διάταξη πληκτρολογίου και η ρύθμιση κατάληξης του ίδιου του σαρωτή.
  • Ενοποιήσεις σειριακές, HID POS και SDK κατασκευαστή.

Ο εξομοιωτής είναι το σωστό εργαλείο για τη λογική της εφαρμογής κατά μήκος της διαδρομής πληκτρολογίου. Είναι το λάθος εργαλείο για να αποδείξετε ότι ένας συγκεκριμένος σαρωτής διαβάζει μια συγκεκριμένη ετικέτα.

Αποσφαλμάτωση συμβάντων πληκτρολογίου σαρωτή γραμμωτού κώδικα

Παρακολουθήστε τα συμβάντα με αυτή τη σειρά όταν η αποθηκευμένη τιμή είναι λάθος.

keydown. Ενεργοποιείται για κάθε πλήκτρο, συμπεριλαμβανομένων των Enter και Tab, πριν το πρόγραμμα περιήγησης εισαγάγει χαρακτήρα ή μετακινήσει την εστίαση. Διαβάστε τον τερματιστή εδώ. Το event.repeat είναι true όταν ένα πλήκτρο κρατιέται πατημένο. Ένας σαρωτής σφήνας στέλνει συνήθως ξεχωριστό πάτημα για κάθε χαρακτήρα.

input. Ενεργοποιείται στο πεδίο αφού ένας εκτυπώσιμος χαρακτήρας αλλάξει την τιμή του. Είναι το σωστό συμβάν να παρακολουθείτε αν χρειάζεστε το κείμενο καθώς μεγαλώνει. Δεν ενεργοποιείται για Enter ή Tab, επειδή αυτά τα πλήκτρα δεν εισάγουν χαρακτήρα σε εισαγωγή κειμένου.

change. Ενεργοποιείται αφού καταχωριστεί η τιμή, συνήθως όταν το πεδίο χάνει την εστίαση. Ένας σαρωτής που αφήνει την εστίαση στο ίδιο πεδίο δεν παράγει change στο τέλος της σάρωσης. Μην χρησιμοποιείτε το change ως το μοναδικό σήμα ολοκλήρωσης.

event.key και event.code. Καταγράψτε και τα δύο όταν ένας χαρακτήρας είναι λάθος. Μια ασυμφωνία ανάμεσα στη διάταξη του σαρωτή και στη διάταξη του λειτουργικού συστήματος αλλάζει το event.key και αφήνει το event.code να μοιάζει με το πλήκτρο που σκόπευε ο σαρωτής. Τα ψηφία από το αριθμητικό πληκτρολόγιο χρησιμοποιούν Numpad1 και παρόμοιους κωδικούς. Ορισμένες μάσκες εισαγωγής τα αντιμετωπίζουν διαφορετικά από το Digit1. Το Λανθασμένη διάταξη πληκτρολογίου στον σαρωτή γραμμωτού κώδικα εξηγεί την ασυμφωνία διάταξης.

Εστίαση. Καταγράψτε το document.activeElement αμέσως πριν από μια σάρωση. Αν δεν είναι το πεδίο γραμμωτού κώδικα, το υπόλοιπο ίχνος εξηγεί λάθος στοιχείο ελέγχου. Τα iframe έχουν δική τους εστίαση. Μια σάρωση μέσα σε ενσωματωμένο πλαίσιο είναι ορατή στο σενάριο μέσα σε αυτό το πλαίσιο.

Χρονισμός. Οι σαρωτές συχνά τελειώνουν ένα σύντομο φορτίο σε πολύ λιγότερο από ένα δευτερόλεπτο. Ο ελεγκτής εισαγωγής συγκρίνει το μέσο κενό ανάμεσα σε χαρακτήρες με ένα κατώφλι 100 ms και χαρακτηρίζει το αποτέλεσμα ως χρονισμό, όχι ως αναγνώριση υλικού. Ένα κατώφλι κενού μπορεί να θεωρήσει γρήγορο δακτυλογράφο, αυτόματη συμπλήρωση ή τον εξομοιωτή ως σαρωτή. Ένας σαρωτής με καθυστέρηση ανάμεσα σε χαρακτήρες, σύνδεσμο Bluetooth ή μακρύ φορτίο μπορεί να μοιάζει με πληκτρολόγηση. Χρησιμοποιήστε την καταγεγραμμένη τιμή και την κατάληξη. Χρησιμοποιήστε τον χρονισμό ως ένδειξη.

Χρησιμοποιήστε τον ελεγκτή συμβάντων πληκτρολογίου, που παραθέτει κάθε keydown και keyup με key, code, τροποποιητές και χρονικές σημάνσεις. Χρησιμοποιήστε τον όταν η συναρμολογημένη συμβολοσειρά κρύβει ένα πλήκτρο προθέματος ή έναν κωδικό αριθμητικού πληκτρολογίου. Το αρχείο καταγραφής είναι συμβάντα προγράμματος περιήγησης. Δεν είναι ακατέργαστη κίνηση USB.

Συχνά προβλήματα σε εφαρμογές ιστού

Η σάρωση πηγαίνει σε λάθος πεδίο. Η εισαγωγή σφήνας ακολουθεί την εστίαση. Κάντε κλικ στο πεδίο στόχο μετά από κάθε πλοήγηση, διάλογο ή μήνυμα επικύρωσης που μετακινεί την εστίαση. Ένα αποκλειστικό παράθυρο χωρίς πεδίο κειμένου μπορεί να καταπιεί τη σάρωση ως πλήκτρα συντόμευσης.

Ο σαρωτής λειτουργεί σε επεξεργαστή κειμένου και όχι στο πρόγραμμα περιήγησης. Η συσκευή πληκτρολογεί. Η σελίδα δεν δέχεται αυτά τα πλήκτρα. Ελέγξτε την εστίαση, μια απενεργοποιημένη ή μόνο για ανάγνωση εισαγωγή και έναν ακροατή keydown που καλεί preventDefault() σε εκτυπώσιμα πλήκτρα. Ένας ακροατής που χειρίζεται μόνο το paste δεν βλέπει ποτέ εισαγωγή σφήνας. Ξεκινήστε με Ο σαρωτής γραμμωτού κώδικα δεν λειτουργεί αν καμία εφαρμογή δεν λαμβάνει χαρακτήρες.

Το Enter υποβάλλει τη φόρμα δύο φορές ή απομακρύνεται. Το πρόγραμμα περιήγησης υποβάλλει τη φόρμα και ο ακροατής σας χειρίζεται επίσης το Enter. Καλέστε το preventDefault() σε μία από αυτές τις διαδρομές και επεξεργαστείτε την τιμή μία φορά. Μια φόρμα πολλών πεδίων μπορεί να υποβληθεί πριν συμπληρωθούν μεταγενέστερα πεδία όταν ο σαρωτής στέλνει Enter. Χρησιμοποιήστε Tab για αυτή τη ροή ή αποτρέψτε την υποβολή μέχρι η φόρμα να είναι πλήρης.

Το Tab αλλάζει την εστίαση. Αυτό είναι το πλήκτρο Tab. Είτε ρυθμίστε Enter στον σαρωτή είτε διαβάστε την τιμή στο keydown και επιτρέψτε τη μετακίνηση της εστίασης. Δείτε την ενότητα κατάληξης παραπάνω.

Η διάταξη πληκτρολογίου είναι λάθος. Τα ψηφία μπορεί να επιβιώσουν από μια ασυμφωνία που αλλάζει τη στίξη. Σαρώστε μια γνωστή τιμή που περιέχει τα σύμβολα που αποθηκεύετε, στη διάταξη που χρησιμοποιεί πράγματι ο σταθμός εργασίας.

Η ίδια σάρωση δημιουργεί δύο εγγραφές. Αναζητήστε δύο ακροατές σε ένα Enter πριν αναζητήσετε δύο φυσικές σαρώσεις. Έπειτα δοκιμάστε μια σκόπιμη δεύτερη σάρωση και επιβεβαιώστε τον κανόνα ποσότητας ή διπλότυπου που τεκμηριώνει η εφαρμογή σας.

Η τιμή λείπει ή είναι κομμένη. Ένα χαρακτηριστικό maxlength, μια μάσκα εισαγωγής ή το preventDefault() σε πλήκτρα χαρακτήρων μπορεί να ρίξει ή να κόψει το φορτίο. Συγκρίνετε τον αριθμό χαρακτήρων στον ελεγκτή εισαγωγής με την τιμή στο πεδίο σας. Ένα πρόθεμα μπορεί επίσης να κάνει ένα σωστό φορτίο να φαίνεται πολύ μακρύ.

Οι κωδικοί QR δεν εμφανίζονται ποτέ. Ο σαρωτής μπορεί να είναι μόνο 1D ή η συμβολολογία QR μπορεί να είναι απενεργοποιημένη. Η εφαρμογή δεν μπορεί να το διορθώσει. Επιβεβαιώστε το υλικό με Δοκιμή κωδίκων QR: πώς να δοκιμάσετε σαρωτές κωδίκων QR και έπειτα επιστρέψτε στη δοκιμή πεδίου.

Λίστα ελέγχου δοκιμής εφαρμογής ιστού

Χρησιμοποιήστε την στο build που σκοπεύετε να διαθέσετε, σε κάθε πρόγραμμα περιήγησης που υποστηρίζετε. Ελέγξτε και ένα νέο προφίλ και ένα προφίλ με επεκτάσεις διαχείρισης κωδικών και αυτόματης συμπλήρωσης, επειδή αυτές οι επεκτάσεις μετακινούν την εστίαση.

  • Ο σαρωτής είναι συνδεδεμένος ή συζευγμένος και ο υπολογιστής τον δείχνει έτοιμο.
  • Ο σαρωτής είναι σε λειτουργία σφήνας πληκτρολογίου, όχι σε σειριακή λειτουργία ή σε λειτουργία SDK κατασκευαστή.
  • Το πεδίο γραμμωτού κώδικα είναι εστιασμένο αμέσως πριν από τη σάρωση. Το document.activeElement είναι αυτό το πεδίο.
  • Ένας γνωστός γραμμωτός κώδικας φτάνει χαρακτήρα προς χαρακτήρα, μαζί με το μήκος.
  • Μια κατάληξη ENTER υποβάλλει ή αποδέχεται την τιμή μία φορά και δεν αφήνει τον τερματιστή στην αποθηκευμένη συμβολοσειρά.
  • Μια κατάληξη TAB μετακινεί την εστίαση στο στοιχείο ελέγχου που σκοπεύετε και η τιμή διαβάζεται πριν από τη μετακίνηση.
  • Μια ρύθμιση χωρίς κατάληξη αφήνει την τιμή διαθέσιμη μέχρι η εφαρμογή να την ολοκληρώσει.
  • Μια κενή υποβολή απορρίπτεται ή αγνοείται.
  • Μία σάρωση δεν δημιουργεί δύο εγγραφές. Μια δεύτερη πραγματική σάρωση ακολουθεί τον κανόνα διπλότυπου της εφαρμογής.
  • Η στίξη, τα σύμβολα και οποιοσδήποτε διαχωριστής GS1 χρησιμοποιούν οι μορφές σας επιβιώνουν τη διαδρομή μετ' επιστροφής.
  • Η διάταξη πληκτρολογίου του σαρωτή και η διάταξη του λειτουργικού συστήματος παράγουν τους χαρακτήρες που είναι τυπωμένοι στην ετικέτα.
  • Μετά την αποσύνδεση και την επανασύνδεση, ή αφού πέσει ο σύνδεσμος Bluetooth, η επόμενη σάρωση εξακολουθεί να φτάνει στο πεδίο.
  • Πολλές σαρώσεις στη σειρά παραμένουν ξεχωριστές τιμές. Το πεδίο δεν τις συνενώνει.
  • Οι ίδιοι έλεγχοι περνούν στα προγράμματα περιήγησης που υποστηρίζετε, με και χωρίς συνηθισμένες επεκτάσεις αυτόματης συμπλήρωσης.

Για διαλόγους, σειρά στηλοθέτη σε ολόκληρη την ολοκλήρωση αγοράς και ροές ποσότητας POS, συνεχίστε με το Πώς να δοκιμάσετε την εισαγωγή σαρωτή γραμμωτού κώδικα.

Μήτρα περιπτώσεων δοκιμής

Η στήλη του σαρωτή είναι αυτό που κάνουν η συσκευή και το πρόγραμμα περιήγησης. Η στήλη αναμενόμενης συμπεριφοράς είναι αυτό που πρέπει να κάνει η εφαρμογή ως απόκριση. Οι επιχειρηματικοί κανόνες, όπως αν ένας επαναλαμβανόμενος κωδικός προϊόντος αυξάνει την ποσότητα, ανήκουν στην εφαρμογή. Δηλώστε τους στη δοκιμή αντί να υποθέτετε έναν κανόνα για κάθε προϊόν.

Σενάριο Αναμενόμενη συμπεριφορά
Έγκυρος γραμμωτός κώδικας Η εφαρμογή αποδέχεται την τιμή και αποθηκεύει το φορτίο χωρίς τον τερματιστή.
Κενή εισαγωγή Η εφαρμογή την απορρίπτει ή την αγνοεί και δεν δημιουργεί εγγραφή.
Κατάληξη ENTER Η εφαρμογή υποβάλλει ή αποδέχεται την τιμή μία φορά.
Κατάληξη TAB Η εστίαση μετακινείται στο προβλεπόμενο επόμενο στοιχείο ελέγχου και η τιμή διατηρείται.
Χωρίς κατάληξη Η εισαγωγή παραμένει διαθέσιμη μέχρι η εφαρμογή να την επεξεργαστεί.
Γρήγορες διαδοχικές σαρώσεις Κάθε τιμή επεξεργάζεται χωριστά και δεν συνενώνεται με την προηγούμενη.
Λανθασμένη διάταξη πληκτρολογίου Απροσδόκητοι χαρακτήρες είναι ορατοί στην καταγεγραμμένη τιμή και η επικύρωση αποτυγχάνει.
Διπλή σάρωση Η εφαρμογή ακολουθεί τον δικό της κανόνα διπλότυπου, όπως αύξηση ποσότητας ή απόρριψη επανάληψης.
Άκυρη μορφή γραμμωτού κώδικα Η εφαρμογή δείχνει το σφάλμα επικύρωσης για αυτή τη μορφή και δεν αποθηκεύει την τιμή.
Χαμένη εστίαση εισαγωγής Η εφαρμογή δεν επινοεί γραμμωτό κώδικα. Η σάρωση απουσιάζει ή καταλήγει στο εστιασμένο στοιχείο ελέγχου και η σελίδα μένει σε ασφαλή κατάσταση.

Εκτελέστε τις γραμμές έγκυρου, κενού, ENTER, TAB και χωρίς κατάληξη με τον φυσικό σαρωτή και ξανά με τον εξομοιωτή. Εκτελέστε τις γραμμές διάταξης πληκτρολογίου, QR και επανασύνδεσης στο υλικό. Αυτές οι γραμμές εξαρτώνται από τη συσκευή, την ετικέτα ή τη διάταξη του λειτουργικού συστήματος, που τα προσομοιωμένα πατήματα πλήκτρων δεν αναπαράγουν.