Nastavení terminálové aplikace

Terminálová aplikace se na čtečky a mobilní zařízení dostává z administrace: tady zjistíte nabízenou verzi, stáhnete instalační soubor a zařízení přihlásíte QR kódem. Vedlejší obrazovka Nastavení aplikace pak určuje, jak se aplikace chová na všech zařízeních provozu.

O funkci

Skladníci nepracují v administraci, ale v terminálové aplikaci na čtečce. Tu je potřeba na zařízení dostat a přihlásit — a právě k tomu slouží obrazovka Aplikace pro Terminál. Sama o sobě neřeší chování aplikace, ale její distribuci; jak se aplikace na zařízeních chová, se nastavuje na samostatné obrazovce Nastavení aplikace — viz Nastavení chování aplikace níže.

Obrazovka má tři části:

• Informace o verzi — jaká verze se zařízením nabízí, komu a v jakém režimu se vydává (podrobně níže).
• QR kód pro přihlášení — kód, kterým se do aplikace přihlásí aktuálně přihlášený uživatel, aniž by musel na malé klávesnici psát e-mail a heslo.
• QR kód pro stažení — kód vedoucí k instalačnímu souboru; tlačítkem Stáhnout lze soubor získat i přímo, Přenačíst kód obnoví.

QR kód pro přihlášení je přihlašovací údaj

Kód v části QR kód pro přihlášení přihlásí kohokoli, kdo si ho vyfotí, jako vás. Zachází se s ním proto jako s heslem:

• nesdílejte snímky této obrazovky,
• nepromítejte ji na školeních ani ji neposílejte v e-mailu,
• zařízení přihlašujte kódem přímo u obrazovky.

Ze stejného důvodu jsou kódy v obrázku níže zakryté.

Obrazovka pro rozdávání terminálové aplikace v ručním režimu vydávání. QR kód je ve snímku záměrně skrytý a e-mail testera je smyšlený — viz upozornění výše.

Cesta v administraci

Nastavení > Hardware > Aplikace pro Terminál

Informace o verzi a vydávání

Karta Informace o verzi ukazuje, co se zařízením nabízí:

• Verze a Sestavení — označení verze aplikace a jejího buildu. Podle nich se pozná, jestli čtečka běží na tom, co administrace vydává.
• Vydávat — režim vydávání, Automaticky nebo Ručně.
• Testeři — pracovníci, kteří novou verzi dostanou jako první. Řádek se ukazuje jen v ručním režimu.

Tlačítkem Upravit v horní liště se nastavuje Automatické vydávání (Automaticky / Ručně) a v ručním režimu i seznam testerů.

Proč se verze vydává ve dvou krocích

Nová verze se nejdřív zpřístupní jen testerům. Ti si ji nainstalují a vyzkoušejí v běžném provozu; ostatní pracovníci o ní zatím nevědí. Teprve když je verze potvrzená, uvolní se všem — v ručním režimu tlačítkem Vydat verzi, v automatickém bez potvrzování. Vydání lze vzít zpět tlačítkem Zrušit vydání. Obě tlačítka jsou v horní liště jen v ručním režimu; v automatickém se každá verze vydává sama.

Totéž uvolnění jde udělat přímo ze čtečky: tester, který verzi právě zkouší, ji vydá všem na obrazovce informací o zařízení, aniž by musel do administrace. Popisuje to Aktualizace aplikace.

Tím se předejde tomu, aby celá směna ráno naběhla na verzi, kterou nikdo nevyzkoušel.

Prázdná karta neznamená chybu nastavení

Údaje o verzi nepocházejí z databáze administrace, ale ze služby, která aplikaci distribuuje. Když se karta nenačte nebo hlásí, že v projektu nebyla nalezena žádná aplikace, není propojená distribuce — ne že by chybělo nastavení na této obrazovce.

Jak přihlásit nové zařízení

1. Na zařízení nainstalujte aplikaci — buď oskenováním QR kódu pro stažení, nebo z instalačního souboru získaného tlačítkem Stáhnout.
2. Přihlaste se v administraci pod účtem, který má na zařízení pracovat. Účet musí mít zapnutý API přístup — bez něj se kód pro přihlášení nevytvoří (viz FAQ).
3. V aplikaci vyberte přihlášení QR kódem a oskenujte QR kód pro přihlášení.

Přihlašuje se účet, který je právě v administraci

QR kód pro přihlášení patří tomu, kdo je v administraci přihlášený — ne zařízení. Když kód ukážete ze svého účtu, zařízení bude pracovat jako vy a všechny skladové operace se zapíšou na vaše jméno. Pro každého pracovníka proto použijte jeho vlastní přihlášení.

Nastavení chování aplikace

Vedle rozdávání aplikace má sekce Hardware ještě obrazovku Nastavení aplikace. Zatímco obrazovka Aplikace pro Terminál rozhoduje, která verze se na zařízení dostane, obrazovka Nastavení aplikace říká, jak se aplikace chová — a to na všech zařízeních v provozu zároveň. Nenastavuje se tedy jedna čtečka, ale celý terminálový provoz: které moduly jsou zapnuté, co se tiskne na účtenky, jaké záložky obsluha na obrazovce převodů vidí, co se má nad položkami dokladu dít automaticky, jaká upozornění pracovník na dokladu uvidí a jak terminál čte etikety dodavatelů.

Cesta v administraci

Nastavení > Hardware > Nastavení aplikace

Obrazovku vidí jen tým Elasticr

Položka Nastavení aplikace se v administraci projektu běžnému správci nezobrazí — ani tomu s nejvyššími právy; v záhlaví obrazovky je proto štítek CORE. Důvod je provozní: chybná hodnota se na zařízení projeví tiše. Záložka zmizí z nabídky, seznam přestane filtrovat nebo terminál přestane číst etiketu a v administraci se nic nenahlásí. Změnu chování aplikace si proto vyžádejte přes podporu; tato část stránky slouží k tomu, abyste věděli, o co požádat a co se tím změní.

U nově zaváděného provozu obrazovka hlásí, že nastavení zatím neexistuje — vznikne prvním uložením tlačítkem Uložit nastavení a od té chvíle se jen upravuje. Nastavení s chybou administrace neuloží a chybná pole zvýrazní.

Kdy se změna projeví na zařízení

Uložení nastavení samo o sobě běžící terminál nezmění:

• Zařízení si nastavení vyzvedne při nejbližším spuštění aplikace nebo přihlášení. Terminál, který zůstává přihlášený, převezme změnu až po restartu aplikace.
• Volby Bluetooth tiskárna a Pracovní výkazy potřebují dva restarty — hodnota se načte při jednom spuštění a použije až při dalším. Zařízení mezitím samo zobrazuje výzvu k restartu.

Nesouhlasí-li chování čtečky s tím, co je v administraci uložené, jde téměř vždy o tohle, a ne o neuložené nastavení.

Moduly

Zapínají a vypínají celé části aplikace: Retail (prodejní režim a pokladní funkce), Vozíky (dávky objednávek a přiřazení vozíků), KPI (záložka s ukazateli u produktu), Bluetooth tiskárna a Pracovní výkazy.

Značka a jazyky

• Název značky — text, který se tiskne na účtenky s číslem ve frontě. Delší než přibližně 20 znaků se ořízne.
• Povolené jazyky — jazyky, které si obsluha může na zařízení vybrat. Aspoň jeden zůstat musí; prázdný seznam administrace uložit nedovolí, protože výběr jazyka na zařízení by zůstal bez jediné položky.

Doklady

• Doklady s kontejnery — typy dokladů, které na terminálu pracují s přepravními kontejnery.
• Vždy zobrazovat výchozí akci — kombinace typu dokladu a kontextu (třeba Vyskladnění nebo Naskladnění), u kterých má obsluha výchozí akci vždy na jedno klepnutí, bez proklikávání nabídky. Každý typ dokladu smí být v seznamu jen jednou.

Skupiny parametrů

Parametry produktů se na terminál nepřenášejí všechny — vybírá se, které skupiny obsluha vidí a smí měnit:

• Editovatelné skupiny parametrů — skupiny, které lze u produktu upravovat přímo ze čtečky.
• Parametry v detailu dokladu a Parametry v rozbaleném výpisu — které skupiny se zobrazí a kde přesně. Pozice se vybírá podle sousedního údaje na obrazovce (například Nad číslem dokladu nebo Nad dopravou), pořadí v rámci jedné pozice se dává tažením řádků. Obě obrazovky mají vlastní sadu pozic, protože každá prokládá parametry jinými řádky. Do jedné pozice se vejde nejvýše 100 skupin.

Vlastní záložky dokladů

Vlastní záložka je seznam dokladů, který se přidá do jedné z položek nabídky převodů — Převod v lokaci, Výdej pro převoz nebo Příjem z převozu. Jinde v aplikaci se vlastní záložky nezobrazují. Typické využití: dát směně připravený seznam právě těch dokladů, které má odpracovat, místo hledání ve společném výpisu.

Každá záložka se popisuje ve třech skupinách:

• Umístění a název — do které položky nabídky záložka patří a jak se jmenuje. Název lze zadat pro každý jazyk zvlášť; bez názvu se záložka uložit nedá, protože by na zařízení zůstala bez popisku.
• Zdroj dokladů — odkud se doklady načítají (Server (API), Firestore (živá data), nebo Bez zdroje — prázdná záložka), jaký typ dokladu záložka ukazuje, kolik položek načte a jakým filtrem se seznam zúží. Nabídku filtrů určuje zvolený zdroj a typ dokladu, takže nelze nastavit filtr, který by se neuplatnil; živý zdroj umí zúžit seznam mimo jiné podle Štítků a Dopravy. Bez zadaného Počtu položek načte server prvních 30 dokladů a živý zdroj sleduje celou kolekci — u velkých seznamů zbytečná zátěž zařízení. U živého zdroje navíc jeden filtr unese nejvýše 30 vybraných hodnot — s víc vybranými hodnotami administrace uložení odmítne, protože takový seznam by se na zařízení nenačetl vůbec.
• Chování záložky — co se stane, když obsluha na doklad klepne: Otevřít nabídku akcí a přechodů, nebo Otevřít doklad na obrazovce. Doklad na obrazovce umí otevřít jen zdroj s živými daty, u ostatních zdrojů volba zůstává vidět, ale je nedostupná. Má-li typ dokladu víc obrazovek — objednávka a pokladní doklad — vybírá se ještě která z nich se otevře; volí se ta, která odpovídá kroku, kvůli kterému záložka existuje.

Filtr, který se přestal nabízet

Nabídka filtrů se odvozuje z toho, co daný typ dokladu umí dnes. Když se dřív uložený filtr mezitím přestal nabízet, administrace to při otevření a uložení ohlásí jako upozornění: nastavení uložit lze, ale takový filtr se na zařízení ignoruje — a seznam pak ukáže víc dokladů, než bylo zamýšleno. Stejně se hlásí filtr ponechaný prázdný: uložením se ze záložky odstraní.

Automatické akce

Automatická akce spojuje spouštěč a efekt: spustí se nad položkou dokladu, když odpovídá Typ dokladu, Kontext i Produkty (maska). Efekt se vybírá v poli Akce — zatím je k dispozici Tisk štítku položky, takže typické použití je automatický tisk štítku u vybraného zboží, aniž by na něj obsluha musela myslet.

Každá akce má:

• Název — pod jakým se akce ukazuje v seznamu.
• Kód — jednoznačný identifikátor akce, jen malá písmena, číslice, - a _ (například stitek). Dvě akce nesmí mít stejný kód: sdílely by frontu tisku a tiskla by jen první z nich.
• Aktivní — zapnutí a vypnutí akce bez jejího mazání.
• Produkty — maska, která vybírá zboží, na které akce platí. Bez masky se akce neuloží, protože na terminálu by se nikdy neuplatnila. Nabídka podmínek je zúžená na to, co zařízení umí vyhodnotit: typy produktů a jejich vyjmenované parametry — podmínky závislé na skladu nebo na slevě zde nejsou. Masky popisuje Masky produktů.

Upozornění na detailu dokladu

Upozornění je krátká zpráva, kterou pracovník uvidí na otevřeném dokladu — například „přiložte k zásilce dodací list" u objednávek s určitým štítkem. Podmínku vyhodnocuje zařízení nad právě otevřeným dokladem. Panel Nové upozornění má tři záložky:

• Základ — Název (jen pro rozlišení upozornění mezi sebou, pracovník ho nevidí; musí být jedinečný), Zapnuto (nové upozornění je zapnuté), Pořadí, Zobrazení (Pruh nad seznamem, nebo Samostatná záložka) a Závažnost (Upozornění, nebo Varování).
• Kdy se zobrazí — Proces, ve kterém je doklad otevřený (například Balení), a Podmínka: typ dokladu a vlastnosti, jako jsou Štítky, Doprava, číslo dokladu nebo stav vychystání. Vlastnosti se musí shodovat všechny, z hodnot jedné vlastnosti stačí jedna. Upozornění bez podmínky platí pro každý doklad — administrace na to při uložení upozorní.
• Text — Text a Doplňující text pro každý jazyk; nevyplněný jazyk se nahradí češtinou a aspoň jeden text je povinný. Do doplňujícího textu lze vložit zápisy {{shippingCondition.title}}, {{shippingCondition.code}} a {{document.number}}, které se nahradí názvem a kódem dopravy a číslem dokladu. U samostatné záložky přibude Název záložky — povinný a jedinečný, protože podle něj se záložky od sebe liší.

Nad seznamem položek se vejdou nejvýše dva pruhy; další pruhová upozornění se v tu chvíli nezobrazí. Upozornění, které zařízení nedokáže vyhodnotit, vynechá.

Skener: pravidla čárových kódů

Etikety dodavatelů často nesou v jednom čárovém kódu víc údajů najednou — kód zboží, počet kusů, šarži a datum expirace. Pravidlo čárového kódu říká terminálu, jak takový kód rozložit, takže obsluha nemusí údaje z etikety opisovat. Nový formát etikety se tak přidá v nastavení, bez vydání nové verze aplikace.

Spodní část obrazovky Nastavení aplikace: upozornění na detailu dokladu a sekce Skener, zatím bez vlastních pravidel — terminál pak používá jen zabudované formáty.

Jak terminál naskenovaný kód zpracuje

1. Zabudované formáty běží vždy první — kódy s předponou typu SKU|, které aplikace sama tiskne na karty zboží, pozic, kontejnerů a dokladů, interní QR kód se zbožím a množstvím, etikety GLS a staré kontejnery C000. Na obrazovce nejsou, nejde je vypnout a vlastní pravidlo nesmí nést jejich název. Pravidlo tedy může čtení kódů přidat, nikdy ubrat.
2. Vlastní pravidla následují podle Pořadí — nižší číslo dřív, při shodném pořadí podle názvu. Vypnuté pravidlo se přeskočí.
3. Každé pravidlo nejdřív zjistí, jestli se ho kód týká: podle Typů kódů, Délky kódu nebo vzoru v prvním kroku. Pak projde své kroky. Když kterýkoli krok selže, pravidlo kód nezmění a na řadu přijde další — údaje se zapíšou, až když uspějí všechny kroky, takže kód nikdy nezůstane rozebraný napůl.
4. Kód upravený jedním pravidlem vidí další pravidla už upravený. Ukončit po shodě další vlastní pravidla po úspěšném zpracování zastaví.

Pravidlo musí kód něčím omezit — vzorem, typem kódu nebo přesnou délkou. Pravidlo bez omezení by se uplatnilo na každý kód a přepsalo výsledek zabudovaných formátů, proto ho administrace neuloží.

Založení pravidla

Tlačítko Přidat pravidlo otevře panel Nové pravidlo čárového kódu se dvěma záložkami:

Záložka Identifikace nového pravidla.

• Název — povinný a jedinečný; terminál ho ukazuje u zpracovaného kódu, takže podle něj poznáte, které pravidlo kód přečetlo.
• Zapnuto — nové pravidlo je zapnuté; vypnuté zůstane uložené, ale neběží.
• Pořadí — povinné, nižší číslo běží dřív.
• Ukončit po shodě — po úspěchu tohoto pravidla se další vlastní pravidla nespustí.

Kroky pracují s pojmenovanými hodnotami: na začátku je k dispozici naskenovaný kód (code), původní kód (originalCode) a jeho typ (type), každý krok může přidat další. Závěrečný krok set zapíše výsledek do polí code (kód, podle kterého se hledá zboží), quantity (počet, musí být kladný), batchCode (šarže), batchExpiration (expirace), objectType (co kód označuje, třeba pozici) a documentType (typ dokladu).

Krok	Co udělá
match	ověří kód vzorem (regulární výraz) a pojmenované části vzoru uloží jako hodnoty
split	rozdělí hodnotu podle oddělovače na pojmenované části
slice	vezme úsek hodnoty od–do znaku
jsonGet	přečte položku z kódu ve formátu JSON
number	převede text na číslo (například počet kusů)
dateFormat	převede datum pevného tvaru (yyyy, yy, MM, dd) na datum
map	nahradí hodnotu podle převodní tabulky
padLeft, padRight	doplní hodnotu zleva či zprava znakem na zadanou délku
trim, upper	odstraní okrajové mezery, převede na velká písmena
set	zapíše výsledek do polí čteného kódu

Krok s "optional": true pravidlo při neúspěchu neukončí, jen se přeskočí.

Příklad: kód zboží, počet, expirace a šarže v jednom kódu

Dodavatel tiskne na krabice kód 48213+24+0527+L2405A — kód zboží, počet kusů, expiraci ve tvaru měsíc a rok a šarži, oddělené znakem +. Pravidlo s těmito kroky z něj udělá čtení se zbožím 48213, počtem 24, expirací 1. 5. 2027 a šarží L2405A:

[
  { "op": "match", "params": { "in": "code", "pattern": "^[0-9]{5}\\+[0-9]+\\+[0-9]{4}\\+" } },
  { "op": "split", "params": { "in": "code", "by": "+", "into": ["sku", "qty", "exp", "batch"] } },
  { "op": "number", "params": { "in": "qty", "out": "qty" } },
  { "op": "dateFormat", "params": { "in": "exp", "format": "MMyy", "out": "exp" } },
  { "op": "set", "fields": {
      "code": { "var": "sku" }, "quantity": { "var": "qty" },
      "batchExpiration": { "var": "exp" }, "batchCode": { "var": "batch" } } }
]

Datum bez dne se převede na první den měsíce. Kód jiného tvaru první krok nepropustí a pravidlo ho nechá beze změny.

Administrace při uložení zkontroluje, že pravidlo dává smysl: jedinečný název, platný zápis JSON, známé kroky s povinnými údaji, přípustný vzor a přítomnost kroku set. Vzory, které by zařízení mohly zahltit (například opakování celé skupiny), odmítne. U vypnutého pravidla kontroluje jen název a zápis JSON. Co administrací projde, ale zařízení to přesto nedokáže sestavit, terminál tiše vynechá — obsluha žádnou chybu neuvidí, kód se prostě nepřečte podle pravidla.

Vyzkoušejte pravidlo na čtečce

V postranní nabídce terminálové aplikace je obrazovka Test skeneru. Po naskenování ukáže typ kódu, výsledný kód, počet, šarži, expiraci, typ objektu, původní kód a v řádku Procesory názvy pravidel, která kód zpracovala. Hodí se i ke zjištění typu kódu pro pole Typy kódů. Nezapomeňte, že nové pravidlo zařízení převezme až po restartu aplikace nebo přihlášení.

Časté dotazy (FAQ)

Změnili jsme nastavení aplikace a na čtečce se nic nezměnilo. Co s tím?

Nastavení se do zařízení dostane při nejbližším spuštění aplikace nebo přihlášení. Terminál, který zůstal přihlášený, aplikaci restartujte; u Bluetooth tiskárny a Pracovních výkazů čekejte restarty dva.

Kdo může nastavení chování aplikace měnit?

Pracovníci Elasticr. Položka Nastavení aplikace se v administraci projektu nezobrazuje ani správci s nejvyššími právy — požadavek zadejte přes podporu.

Proč je u QR kódu pro přihlášení napsáno „Uživatel není autorizován"?

Kód se nevygeneroval. Nejčastější příčina: přihlášený účet nemá zapnutý API přístup. Bez něj účet nemá přihlašovací klíč, ze kterého se kód skládá, a do terminálu se přihlásit nemůže. Přístup zapnete v detailu účtu v Uživatelích a obrazovku obnovíte.

Pravidlo čárového kódu je uložené, ale čtečka kód nerozloží. Proč?

Nejčastěji z těchto důvodů: zařízení ještě nebylo restartováno, pravidlo je omezené Typy kódů a kód přišel z klávesnice nebo přes Bluetooth (typ unknown), dřívější pravidlo s volbou Ukončit po shodě zpracování zastavilo, nebo některý krok na daném kódu selže. Na obrazovce Test skeneru uvidíte, která pravidla kód zpracovala.

Jak se na zařízení dostane nová verze aplikace?

Přes obrazovku Aplikace pro Terminál — nabízená verze se nastavuje v části Informace o verzi a zařízení si aplikaci stáhne přiloženým kódem nebo souborem.

Můžeme jeden QR kód pro přihlášení použít pro celou směnu?

Neměli byste. Kód přihlašuje konkrétní účet, takže by se veškerá práce zapsala na jednoho člověka. Ztratila by se tím dohledatelnost v záznamech práce i v audit logu.

Související dokumentace

• Uživatelé — API přístup, bez kterého se QR kód pro přihlášení nevytvoří
• Uživatelské skupiny
• Záznamy práce
• Tiskárny
• Masky produktů — čím se vybírá zboží pro automatické akce
• Produkty — kódy a EANy, podle kterých terminál zboží po přečtení kódu hledá
• Stažení a instalace aplikace — co se děje na straně čtečky
• Aktualizace aplikace