BxCommands - Kommando etiketter
Med kommando etiketter kan man trigge utskrift av forskjellige etiketter og trigge forskjellige rutiner fra terminal
I BxMobile har vi støtte for å skanne kommando koder. Dette vil som regel være en QR kode, med et kommando-innhold. Innholdet i denne QR koden avhenger litt av hva man ønsker skal skje. Det mest normale er å bruke disse kommandoene til å trigge utskrift av etiketter når QR koden skannes.
Denne QR koden kan man enten generere og printe ut via BxSmartPrintPro og/eller Label Designer i BxAdmin, eller generere på f.eks. en QR kode generator-side. Vi har også støtte for å generere QR koder direkte i BxAdmin under bxadmin.bxsoftware.no/<companyCodehere>/labels/bxcommands
Innhold
- 1. Kommandoer
- 2. Eksempel på oppsett
- 3. Utskrift av det som ikke er printet (#BxPrintUnprinted)
- 4. Styre antall etiketter fra et felt på linja
1. Kommandoer
Kommandoer vi har implementert hittil:
| Kommando | Forklaring |
| #BxPrintLine | Printer linja du står på. |
| #BxPrintLine(2) | Printer 2 etiketter av linja du står på. |
| #BxPrintLine(quantity, TestLayout, TestPrinter) | Printer x antall etiketter der x = antall på linja, med etikettmal = TestLayout og printer = TestPrinter. |
| #BxPrintLine(erpquantity, TestLayout, TestPrinter) | Printer x antall etiketter der x = receivingquantity/pickingquantity på linja, med etikettmal = TestLayout og printer = TestPrinter. |
| #BxPrintAll(quantity, TestLayout, TestPrinter) | Printer x antall etiketter for alle linjer der x = antall på hver linje, med etikettmal = TestLayout og printer = TestPrinter. |
| #BxPrintAll;#BxSend | To kommandoer i kjede, både printe vareetiketter og sende f.eks. ordre/plukk avhengig av modul. |
| #BxPrintUnprinted | Printer etiketter for alt som er registrert, men ikke printet ennå, på alle linjer i ordren. Linjer med batch/serienr. printes per batch. Brukes i Mottak og Plukk. Mer om det her. |
| #BxPrintUnprinted(1, TestLayout, TestPrinter) | Som over, med etikettmal = TestLayout og printer = TestPrinter. Tallet er antall etiketter per enhet. |
| #BxLogOut | Logger ut av BxMobile - benyttes stort sett kun av oss og forhandlere som en hurtigfunksjon hos de kundene hvor logg ut-knappen er deaktivert. Sluttbrukere har ikke og bør ikke ha behov for å bruke denne. Da logges de ut av BxMobile og må pares på nytt i BxAdmin. |
| #BxGoBack | Naviger tilbake. |
| #BxFillPackage(Høyde, Lengde, Bredde, Vekt) | Fyller ut kollistørrelse i fraktbildet - mer om det her. |
Obs! Det er viktig at kommando ikke inneholder flere parantes enn de som er i selve kommandoen, man må med andre ord bytte navn på printkøen på server dersom den f.eks. inneholder (203 dpi).
2. Eksempel på oppsett
Eksempelvis setter man opp en #BxPrintAll kommando slik: #BxPrintAll(quantity,Varemottak etikett,Honeywell PC42d)
Bruker man denne funksjonen inne i Mottak modulen på terminal, vil antall mottatte linjer (quantity) på terminal, printes til definert etikettmal (Varemottak etikett) til definert printer (Honeywell PC42d).
Gjør man dette oppsettet i f.eks. BxSmartPrintPro ser oppsettet ca. slik ut: 

3. Utskrift av det som ikke er printet (#BxPrintUnprinted)
#BxPrintUnprinted printer etiketter for det som er registrert på ordren, men som ikke er printet ennå. Den passer godt når man vil ta mottak eller plukk først og printe alle etikettene samlet til slutt, f.eks. rett før man sender.
3.1 Slik fungerer #BxPrintUnprinted
- Kommandoen virker i Mottak og Plukk, både i ordrebildet og i batch-bildet. Den tar alltid med alle linjer i ordren, uansett hvilken linje du står på.
- For hver linje printes registrert antall minus det som allerede er printet. Eksempel: 5 mottatt og 2 allerede printet gir 3 etiketter. Linjer med 0 i antall hoppes over.
- Det som printes via kommando-etiketter (#BxPrintLine, #BxPrintAll, #BxPrintUnprinted) og automatisk utskrift telles som printet. Utskrift fra printbildet (printknappen) telles ikke. Skanner man #BxPrintUnprinted to ganger, printes altså bare det som er registrert siden forrige gang.
- Tallet i kommandoen er antall etiketter per enhet: #BxPrintUnprinted(2, TestLayout, TestPrinter) gir 2 etiketter per enhet som ikke er printet. quantity og erpquantity brukes ikke i denne kommandoen.
- Uten etikettmal og printer i kommandoen brukes DefaultLayout og DefaultPrinter for modulen (Configuration → User, routine receivelist for Mottak og pickinglist for Plukk).
3.2 Batch-utskrift ved varemottak
Har en linje registrerte batcher eller serienumre, printer #BxPrintUnprinted én etikett-rad per batch i stedet for én for hele linja. Antall etiketter per batch er registrert antall på batchen minus det som allerede er printet for den batchen. Etiketten får da med seg disse feltene fra batchen:
| Felt | Forklaring |
| batchno | Batchnummer/serienummer. |
| batchquantity og quantity | Antall registrert på batchen. |
| batchlocation og location | Lokasjon registrert på batchen. |
| batchexpirydate og expirydate | Utløpsdato, hvis den er registrert på batchen. |
Etikettmalen må inneholde feltet batchno (og ev. expirydate) for at batchen skal vises på etiketten.
Til sammenligning gjelder dette for de andre print-kommandoene ved varemottak:
| Kommando | Forklaring |
| #BxPrintLine / #BxPrintAll i ordrebildet | Printer linja/linjene uten batch-informasjon. |
| #BxPrintLine i batch-bildet | Printer batchen du står på, med batchnummer og antall for batchen. |
| #BxPrintAll i batch-bildet | Printer alle batcher på linja du er inne på. Med quantity som første parameter blir antall etiketter lik antallet på hver batch. |
| #BxPrintUnprinted | Printer det som ikke er printet på alle linjer i ordren, per batch der linja har batcher. |
Eksempel: #BxPrintUnprinted(1,Varemottak etikett,Honeywell PC42d) skannet etter at mottaket er registrert, printer én etikett per mottatt enhet som ikke er printet ennå, med batchnummer på linjer som har batch.
4. Styre antall etiketter fra et felt på linja
Noen ganger skal antall etiketter ikke være likt antall mottatt/plukket, men styres av et eget felt fra ERP (f.eks. et felt på innkjøpsordrelinja). Det gjøres ved å legge til en kolonne som heter copies i linje-spørringen. Antall på linja (quantity) blir da ikke påvirket.
4.1 Slik fungerer copies
- Har linja en kolonne copies med en verdi større enn 0, printes det så mange etiketter av linja.
- Er copies 0 eller tom, brukes antallet fra kommandoen (f.eks. 1 i #BxPrintLine(1, ...)). Uten antall i kommandoen er standard 1.
- copies gjelder også når man printer fra printknappen på linja: da overstyrer copies antallet i Antall-feltet i printbildet.
- copies er bare et antall etiketter. Antall mottatt/plukket (quantity) på terminalen endres ikke.
4.2 Eksempel: antall etiketter fra innkjøpsordre
Eksempelet under er fra Visma Business NXT, der antall etiketter eksempelvis ligger i feltet payrollInformation1 på innkjøpsordrelinja. Ønsket er at Mottak printer så mange etiketter som står i feltet, og 1 etikett hvis feltet er 0 eller tomt.
- Hent feltet inn på mottakslinja: Import from ERP → receivelists → Import Mapping. Legg til en linje med sourcefield order.items.joindown_OrderLine_via_Order.items.payrollInformation1 og destination BxReceivelistLine.Inf1 f.eks.
- Legg til kolonnen copies i spørringen for mottakslinjer: SQL Integration → ReceiveListLines. Legg til denne linja i select-delen (ved siden av de andre kolonnene):
case when coalesce(ol.inf1, '') ~ '^[0-9]+$' then ol.inf1::int else 0 end copies,
Sjekken gjør at tomt felt eller tekst gir 0 i stedet for feil i spørringen. 0 gir standardantallet fra kommandoen. - La kolonnen 0 quantity stå som den er. Den styrer antall mottatt på terminalen og skal ikke brukes til antall etiketter.
- Hent ordren på nytt fra ERP (ny import), og åpne den på nytt på terminalen, slik at linjene får den nye kolonnen.
4.3 Kommando-etikett for copies
Lag en kommando-etikett uten quantity/erpquantity, slik at copies fra linja bestemmer antallet:
| Kommando | Forklaring |
| #BxPrintLine(1,Varemottak etikett,Honeywell PC42d) | Printer linja du står på. Antall = copies på linja, eller 1 hvis copies er 0. |
| #BxPrintAll(1,Varemottak etikett,Honeywell PC42d) | Printer alle linjer. Hver linje får sitt eget antall fra copies, eller 1 hvis copies er 0. |
Etikettmal og printer kan utelates (#BxPrintLine). Da brukes standard etikettmal og printer for modulen.
4.4 Viktig å vite
- Bruk ikke quantity eller erpquantity som første parameter når antallet skal styres av copies. Da settes antallet til henholdsvis antall mottatt/plukket eller receivingquantity/pickingquantity, og copies fra spørringen overstyres.
- Kolonnen må hete copies. Andre navn (f.eks. labelquantity eller NoLabel) blir ikke brukt som antall etiketter.
- Det trengs ikke ClientUI-oppsett i printbildet for dette.
- Samme kolonne kan brukes i linje-spørringene for andre moduler (f.eks. plukk), siden etikettutskrifter fra terminalen leser copies på linja.
- Unntaket er #BxPrintUnprinted. Den regner alltid antall ut fra registrert antall og bruker ikke copies (se 3. Utskrift av det som ikke er printet).