Konfiguracja Zebra DataWedge: skanowanie do dowolnej aplikacji

DataWedge to usługa Zebra, która steruje wbudowanym skanerem i przekazuje zeskanowane dane do aplikacji. Z odpowiednim profilem wpisuje każdy kod kreskowy do dowolnej aplikacji tak, jakby ktoś wpisał go z klawiatury, więc Twoja aplikacja nie wymaga żadnego programowania pod kątem skanowania. Ten poradnik dotyczy TC22, TC27 i MC3400.

Zanim zaczniesz

Jak działa DataWedge

DataWedge jest preinstalowany na każdym urządzeniu Zebra z Androidem. Korzysta z profili: każdy profil określa wejście skanera, formatowanie danych i sposób ich przekazania. Profil wiążesz z jedną lub kilkoma aplikacjami, a każda aplikacja może należeć tylko do jednego profilu.

• Profile0 to profil domyślny. Działa dla każdej aplikacji, która nie ma własnego profilu, i nie można go powiązać z konkretną aplikacją.
• Launcher działa na ekranie głównym.
• Wyjście to Keystroke (wpisywanie do aktywnego pola), Intent (dla aplikacji napisanych pod DataWedge) lub Internet Protocol (wysyłanie przez sieć).

Sprawdź wersję DataWedge

Otwórz aplikację DataWedge, dotknij ikony menu z trzema kropkami i dotknij About. Nazwy menu w tym poradniku odpowiadają DataWedge 15.0, który jest częścią np. majowej aktualizacji Zebra z 2025 r. do Androida 14 dla TC22 i TC27. Na urządzeniach ze starszą wersją nazwy mogą się nieco różnić.

Którym przyciskiem skanować

Przetestuj skaner w DWDemo

1. Otwórz DWDemo z listy aplikacji.
2. Skieruj skaner na kod kreskowy i naciśnij przycisk skanowania albo dotknij przycisku skanowania na ekranie.
3. Odczytane dane pojawią się w oknie aplikacji, a dioda przechwytywania danych i sygnał dźwiękowy potwierdzą odczyt.

Jeśli nic się nie dzieje, otwórz menu DWDemo, dotknij Settings i sprawdź, czy opcja Profile enabled jest zaznaczona.

Utwórz profil i powiąż go z aplikacją

1. Otwórz aplikację DataWedge. Jeśli otworzy się na innym ekranie, naciskaj Wstecz, aż zobaczysz listę Profiles.
2. Dotknij ikony menu i wybierz New profile.
3. Wpisz krótką, unikalną nazwę bez znaków specjalnych, np. Warehouse, i dotknij OK.
4. Dotknij nowego profilu i sprawdź, czy opcja Profile enabled jest zaznaczona.
5. Dotknij Associated apps, otwórz menu i wybierz New app/activity.
6. Wybierz swoją aplikację. Dotknij gwiazdki *, aby profil działał na każdym ekranie aplikacji, lub dotknij jednej aktywności, aby ograniczyć go do tego ekranu.
7. Naciśnij Wstecz, aby wrócić do profilu.

Utworzenie nowego profilu jest bezpieczniejsze niż zmiana Profile0, ponieważ Profile0 wpływa także na wszystkie inne aplikacje bez własnego profilu.

Wideo: Zebra Technologies

Przesyłaj dane jako naciśnięcia klawiszy

1. W profilu sprawdź, czy Barcode input jest włączone.
2. Przewiń do Keystroke output i zaznacz Enabled.
3. Pozostaw Intent output wyłączone, chyba że dostawca aplikacji zaleci inaczej.
4. Otwórz swoją aplikację, dotknij pola wprowadzania i zeskanuj kod. Kod kreskowy pojawi się w polu.

Jeśli znaki giną lub pojawiają się w złej kolejności, zwiększ Inter-character delay w Keystroke output o 100 ms, maksymalnie do 1000 ms. Zebra zaznacza, że opóźnienie może wpływać na wydajność aplikacji, więc ustaw je jak najniższe. Podczas skanowania klawiatura ekranowa może na chwilę zniknąć, ponieważ DataWedge przesyła dane przez własną klawiaturę.

Dodaj Enter lub Tab po każdym skanie

Wiele aplikacji wymaga Entera, aby zatwierdzić skan, lub Taba, aby przejść do następnego pola. Ustawisz to w Basic data formatting, które znajduje się przy ustawieniach wyjścia w profilu.

1. W profilu, w sekcji Keystroke output, dotknij Basic data formatting i zaznacz Enable u góry ekranu.
2. Zaznacz Send ENTER key, aby dodawać Enter po każdym kodzie kreskowym, lub Send TAB key, aby dodawać Tab.
3. Pozostaw zaznaczone Send data. Opcja jest domyślnie włączona i wysyła sam kod kreskowy.
4. Opcjonalnie: wpisz znaki w Prefix to data lub Suffix to data, aby dodawać tekst przed każdym kodem lub po nim (prefiks lub sufiks).
5. Zeskanuj kod do swojej aplikacji, aby sprawdzić działanie.

Włącz lub wyłącz typy kodów kreskowych

1. W profilu, w sekcji Barcode input, dotknij Configure scanner settings.
2. Dotknij Decoders.
3. Zaznacz typy kodów kreskowych, których używasz, i odznacz pozostałe.

QR Code, Data Matrix, Code 128, EAN-13 i UPC-A są domyślnie włączone. Interleaved 2 of 5, Micro QR i DotCode są domyślnie wyłączone, więc włącz je, jeśli występują na Twoich etykietach. Zebra zaleca wyłączenie każdego dekodera, którego aplikacja nie potrzebuje, ponieważ mniejsza liczba dekoderów może poprawić skuteczność skanowania.

Najczęstsze błędy

• Wyłączony DataWedge: na ekranie Profiles otwórz menu, następnie Settings, i sprawdź DataWedge enabled.
• Niewłączony profil: nowy profil nic nie robi, dopóki nie zaznaczysz Profile enabled.
• Aplikacja powiązana z niewłaściwym profilem: aplikacja może należeć tylko do jednego profilu, więc sprawdź Associated apps w każdym profilu.
• Wyłączony Profile0: aplikacje bez własnego profilu w ogóle nie mogą wtedy skanować. Na urządzeniach zarządzanych może to być celowe.
• Wyłączony typ kodu: brakujący dekoder wygląda jak uszkodzony skaner. Sprawdź listę Decoders.
• Przypadkowo naciśnięte Restore: Restore w ustawieniach DataWedge przywraca ustawienia fabryczne DataWedge i nie da się tego cofnąć. Najpierw wyeksportuj ustawienia.

Aby skopiować gotową konfigurację na kolejne urządzenia, użyj Export Profile w ustawieniach DataWedge i Import Profile na następnym urządzeniu. Konfigurację samego urządzenia opisujemy w poradniku konfiguracji TC22/TC27, poradniku konfiguracji MC3400 i w rozwiązywaniu problemów z TC22/TC27. Pełne listy opcji znajdziesz w dokumentacji DataWedge Zebra.