Scaninstellingen

Scancodes, regex-patronen, JSON-veldmapping, hybride modus en scanmodi

Scaninstellingen bepalen hoe Beam gescande barcodes, QR-codes en tekstreeksen interpreteert. Je kunt aangepaste scancodes definiëren met regex-patronen of JSON-veldmapping, de scanmodus configureren en het scangedrag voor de hele organisatie instellen.

📝
Scancodeconfiguratie vereist de Admin-rol en geldt voor de hele organisatie.

Algemene scaninstellingen

InstellingOptiesBeschrijving
Scan ingeschakeldAan / UitHoofdschakelaar voor scannen. Zet uit om barcode zoeken en scan-to-pick uit te schakelen.
ScanmodusTG / EPCTG-modus leest standaard barcodes en QR-codes. EPC-modus leest RFID EPC-tags. Stel dit in op je primaire scanhardware.
Forceer hoofdlettersAan / UitConverteert alle gescande tekst naar hoofdletters vóór verwerking. Handig als je barcodes of identificatoren niet hoofdlettergevoelig zijn.

Scancodes

Scancodes definiëren regels voor hoe Beam specifieke barcodeformaten parseert. Elke scancode heeft een naam en een regex-patroon of een JSON-veldmapping. Wanneer een gebruiker een barcode scant, vergelijkt de app deze met alle geconfigureerde scancodes op volgorde. De eerste overeenkomende code bepaalt hoe de gescande waarde wordt geïnterpreteerd.

💡
Gebruik scancodes wanneer je barcodes gestructureerde gegevens bevatten. Bijvoorbeeld een Code 128-barcode die zowel een item-ID als een serienummer in één string codeert.

Een scancode toevoegen

  1. Ga naar Instellingen → Scaninstellingen → Scancodes.
  2. Tik op Scancode toevoegen.
  3. Voer een Listenernaam in. Een beschrijvende identificator voor deze code (bijv. "EAN13", "InternBarcode").
  4. Kies de overeenkomstmethode: Regex of JSON Map.
  5. Configureer de overeenkomstregel (zie hieronder).
  6. Schakel optioneel Slechts één keer scannen in.
  7. Sla op.

Regex-matching

Een regex-patroon stelt je in staat om delen van een gescande string te matchen en te extraheren met behulp van een reguliere expressie.

Hoe het werkt

  • Wanneer een barcode wordt gescand, wordt de regex toegepast op de gescande string.
  • Als het patroon overeenkomt, wordt de scancode geactiveerd.
  • Je kunt vastleggroepen (haakjes) gebruiken om een specifiek deel van de string te extraheren. Bijvoorbeeld het item-ID-gedeelte van een langere barcode.
  • Als er geen vastleggroep is gedefinieerd, wordt de volledige gematchte string gebruikt.

Voorbeelden

PatroonMatchtGeëxtraheerde waarde
^[0-9]{13}$Precies 13 cijfers (EAN-13)Volledige 13-cijferige string
^ITM([A-Z0-9]{8})Strings die beginnen met "ITM" gevolgd door 8 alfanumerieke tekensHet 8-teken gedeelte na "ITM"
\d{6}-([A-Z]{3})Een 6-cijferige code, een streepje en 3 lettersHet 3-letterige gedeelte
💡
Test je regex op een tool als regex101.com voordat je opslaat. Voer een voorbeeld van een gescande string in en verifieer of de match en vastleggroep de juiste waarde extraheren.

JSON-map matching

JSON-map modus wordt gebruikt wanneer je barcode gestructureerde JSON-gegevens bevat. In plaats van een regex definieer je een mapping van JSON-sleutels in de gescande payload naar Beam-itemvelden.

Hoe het werkt

  • De gescande string wordt geparsed als JSON.
  • Elke vermelding in de JSON-map specificeert een JSON-sleutel en het Beam-veld waaraan het wordt gekoppeld.
  • Beam-veldpaden gebruiken puntnotatie, bijvoorbeeld item.itemId of item.quantity.
  • Als er een Masker is geconfigureerd voor een veld, wordt de geëxtraheerde waarde verder gefilterd door dat patroon. Handig voor het extraheren van een serienummer uit een langere string.

Voorbeeld JSON-map

Gescande JSON: {"sku": "ABC123", "qty": 5}

JSON-sleutelVeldpadResultaat
skuitem.itemIdItem met ID "ABC123" wordt opgezocht
qtyitem.quantityHoeveelheid wordt ingesteld op 5

Slechts één keer scannen

Wanneer Slechts één keer scannen is ingeschakeld op een scancode, kan elke unieke waarde die door die code wordt gematcht slechts één keer per sessie worden gescand. Het opnieuw scannen van dezelfde waarde wordt genegeerd. Dit voorkomt dubbele registraties bij bulkscannen.


Hybride modus

Hybride modus wordt gebruikt in omgevingen waar zowel barcodes als RFID-tags aanwezig zijn op dezelfde items. Het gebruikt één regex-patroon dat RFID-achtige gegevens identificeert binnen een gemengde scanstroom.

  • Wanneer er een scan binnenkomt die overeenkomt met het hybride moduspatroon, wordt deze behandeld als een RFID EPC.
  • Scans die niet overeenkomen, worden behandeld als standaard barcodes.
  • Hierdoor kan één scansessie beide tagtypen verwerken zonder van modus te wisselen.
💡
Hybride modus is het meest nuttig bij gecombineerde barcode/RFID-hardwarereaders of wanneer items zowel een barcodelabel als een RFID-tag dragen en je wilt scannen wat beschikbaar is.