DataWedge - konfiguracja skanera w terminalach Zebra krok po kroku
Skaner skanuje ale dane nie trafiają do aplikacji? Kompletny poradnik konfiguracji DataWedge: profile, Keystroke Output, Intent, rozwiązywanie problemów.
Zespół Serwis Zebra
Certyfikowani technicy Zebra
Czym jest DataWedge?
DataWedge to preinstalowana usługa Zebra, która umożliwia dowolnej aplikacji odbieranie danych z kodów kreskowych - bez pisania ani jednej linijki kodu. Działa w tle i obsługuje wszystkie skanery wbudowane w terminal.
Jak to działa? DataWedge przechwytuje zeskanowany kod, przetwarza go według Twoich reguł, a następnie wysyła do aktywnej aplikacji - jakbyś wpisał dane na klawiaturze.
Kluczowe komponenty DataWedge:
| Komponent | Funkcja |
|---|---|
| Wtyczki wejścia | Skaner kodów, kamera, Bluetooth scanner |
| Wtyczki przetwarzania | Formatowanie danych, prefiksy, sufiksy |
| Wtyczki wyjścia | Keystroke (klawiatura), Intent, IP (sieć) |
Szybka diagnostyka - dlaczego dane nie trafiają do aplikacji?
| Problem | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|
| Skaner skanuje, ale nic się nie pojawia | Keystroke Output wyłączony | Włącz Keystroke |
| Działa w jednej apce, w innej nie | Brak profilu dla aplikacji | Utwórz profil |
| Błąd SCANNER_IN_USE | Inna aplikacja blokuje skaner | Zamknij konflikt |
| Nie czyta niektórych kodów | Symbologia wyłączona | Włącz dekoder |
| Dane są zniekształcone | Złe opóźnienie między znakami | Dostosuj timing |
Jak włączyć DataWedge?
DataWedge jest domyślnie włączony na wszystkich terminalach Zebra. Jeśli nie działa:
- Otwórz szufladę aplikacji (przesuń palcem w górę)
- Znajdź i uruchom aplikację DataWedge
- Dotknij ⋮ (menu) → Ustawienia
- Upewnij się, że opcja DataWedge enabled jest zaznaczona ✓
Uwaga: Jeśli DataWedge jest wyłączony, żadna aplikacja nie będzie mogła skanować kodów (chyba że ma własny moduł EMDK).
Tworzenie profilu DataWedge
Profile pozwalają różnie konfigurować skaner dla różnych aplikacji. Na przykład: aplikacja magazynowa może potrzebować innych symbologii niż aplikacja sprzedażowa.
Krok 1: Utwórz nowy profil
- Otwórz aplikację DataWedge
- Dotknij ⋮ (menu hamburger) → Nowy profil
- Wpisz nazwę profilu (np. "Moja_Aplikacja_WMS")
- Dotknij OK
Krok 2: Powiąż profil z aplikacją
- W nowym profilu dotknij Powiązane aplikacje
- Dotknij ⋮ → Nowa aplikacja/aktywność
- Wybierz pakiet swojej aplikacji z listy
- Wybierz * (wszystkie aktywności) lub konkretną aktywność
Krok 3: Włącz profil
- Upewnij się, że opcja Profil włączony jest zaznaczona ✓
- Skonfiguruj wejście i wyjście (poniżej)
Co to Profile0? To domyślny profil, który działa dla wszystkich aplikacji, które nie mają własnego dedykowanego profilu.
Włącz Keystroke Output
Keystroke Output to najważniejsze ustawienie - bez niego dane nie trafią do pola tekstowego!
Jak włączyć:
- W profilu DataWedge przewiń do sekcji Keystroke output
- Włącz opcję Enabled ✓
- Upewnij się, że Send data jest ustawione na Send via Key Event
Ustawienia Keystroke Output:
| Opcja | Zalecana wartość | Opis |
|---|---|---|
| Enabled | ✓ ON | Włącza wysyłanie danych jako klawiatura |
| Send TAB/ENTER | ENTER (0x0D) | Automatycznie naciska Enter po skanowaniu |
| Inter-character delay | 0 ms | Opóźnienie między znakami (zwiększ dla wolnych apek) |
Częsty błąd: Jeśli aplikacja nie odbiera wszystkich znaków, zwiększ Inter-character delay do 10-20 ms.
Intent Output - dla zaawansowanych aplikacji
Jeśli Twoja aplikacja programowo odbiera dane skanowania (bez pola tekstowego), użyj Intent Output.
Konfiguracja Intent:
- W profilu włącz Intent output → Enabled ✓
- Ustaw Intent action: np. com.myapp.ACTION_BARCODE
- Ustaw Intent category: np. android.intent.category.DEFAULT
- Wybierz Intent delivery: Broadcast intent lub Start activity
Kiedy używać Intent? Gdy tworzysz własną aplikację i chcesz programowo przetwarzać dane skanowania w tle, bez interakcji użytkownika.
Symbologie - włączanie/wyłączanie dekoderów
Symbologie to typy kodów kreskowych, które skaner może odczytywać.
Jak włączyć konkretną symbologię:
- W profilu DataWedge przejdź do Barcode input → Decoders
- Znajdź pożądaną symbologię (np. QR Code, Data Matrix)
- Włącz przełącznik ✓
Popularne symbologie:
| Symbologia | Typ | Gdzie używane |
|---|---|---|
| Code 128 | 1D | Logistyka, magazyny |
| Code 39 | 1D | Przemysł, motoryzacja |
| EAN-13 | 1D | Handel detaliczny (produkty) |
| QR Code | 2D | Marketing, płatności |
| Data Matrix | 2D | Elektronika, farmacja |
| PDF417 | 2D | Dokumenty tożsamości |
Wskazówka: Wyłącz nieużywane symbologie - skaner będzie działał szybciej, bo nie musi sprawdzać wszystkich formatów.
Rozwiązywanie problemów DataWedge
Błąd SCANNER_IN_USE
Przyczyna: Inna aplikacja (np. DWDemo) blokuje dostęp do skanera.
Rozwiązanie:
- Zamknij wszystkie aplikacje skanujące
- Sprawdź profil DWDemo - wyłącz go jeśli niepotrzebny
- Zrestartuj terminal
DataWedge nie wysyła danych
Lista kontrolna:
- ✓ DataWedge jest włączony globalnie?
- ✓ Profil jest włączony?
- ✓ Profil jest powiązany z aplikacją?
- ✓ Keystroke output jest włączony?
- ✓ Pole tekstowe jest w fokusie (kursor miga)?
Nie czyta kodów 2D (QR, Data Matrix)
Sprawdź:
- Czy masz skaner 2D (imager)? Skanery laserowe (SE965) czytają tylko 1D!
- Czy symbologia jest włączona w dekoderach?
- Czy kod jest wyraźny i niepokrzywiony?
Kody błędów DataWedge
| Kod błędu | Znaczenie | Rozwiązanie |
|---|---|---|
| APP_ALREADY_ASSOCIATED | Aplikacja powiązana z innym profilem | Usuń z poprzedniego profilu |
| DATAWEDGE_DISABLED | DataWedge wyłączony | Włącz w ustawieniach |
| INPUT_NOT_ENABLED | Skaner wyłączony w profilu | Włącz Barcode input |
| PROFILE_NOT_FOUND | Profil nie istnieje | Utwórz profil |
| SCANNER_ALREADY_DISABLED | Skaner już wyłączony | Zignoruj |
| SCANNER_ENABLE_FAILED | Błąd włączania skanera | Restartuj DataWedge lub terminal |
| SCANNER_IN_USE | Skaner zajęty | Zamknij konfliktującą aplikację |
Import i eksport konfiguracji DataWedge
Eksport (backup):
- DataWedge → ⋮ → Ustawienia
- Dotknij Eksport
- Plik datawedge.db zostanie zapisany w:
/storage/sdcard0/Android/data/com.symbol.datawedge/files/
Import (przywracanie):
- Skopiuj plik datawedge.db na terminal
- DataWedge → Ustawienia → Import
- Wskaż plik - konfiguracja zostanie natychmiast wczytana
Wdrażanie na flotę: Wyeksportuj konfigurację z jednego urządzenia, a następnie zaimportuj na pozostałe przez MDM (StageNow, SOTI, Workspace ONE).
Przydatne poradniki
- Skaner terminala nie działa - diagnostyka - problemy sprzętowe skanera
- Kody błędów terminala Zebra - diagnostyka LED
- Reset terminala Zebra - gdy DataWedge przestaje działać
FAQ - Najczęściej zadawane pytania
Czy mogę używać terminala bez DataWedge?
Tak, jeśli aplikacja ma własny moduł skanowania oparty na EMDK. Ale większość aplikacji biznesowych (WMS, ERP) używa DataWedge.
Dlaczego skaner działa w jednej aplikacji, a w innej nie?
Każda aplikacja może mieć osobny profil DataWedge. Sprawdź czy profil jest powiązany z tą konkretną aplikacją.
Jak przywrócić DataWedge do ustawień domyślnych?
DataWedge → ⋮ → Ustawienia → Przywróć domyślne. Uwaga: usuwa wszystkie profile!
Czy DataWedge zużywa baterię?
Minimalnie. DataWedge działa pasywnie i aktywuje się tylko podczas skanowania.
Skaner skanuje z opóźnieniem - co robić?
- Zmniejsz liczbę aktywnych dekoderów
- Wyłącz tryb Picklist jeśli niepotrzebny
- Sprawdź czy aplikacja nie ma własnego przetwarzania spowalniającego
