android_maw_szukaj

Autor: Adam Siemiątkowski, SoftwareStudio Group Sp. z o.o.

Funkcja android_maw_szukaj.js realizuje mechanizm wyszukiwania oraz wyświetlania wyników na urządzeniach mobilnych. Oto jak działa:

Funkcja w pliku android_maw_szukaj.js

Plik `android_maw_szukaj.js` definiuje funkcjonalność związaną z obsługą parametrów wywołania transakcji oraz ich konfiguracją. W kodzie zdefiniowano zmienne takie jak `cUID`, `cUID2` oraz `cKod2`, które są pobierane za pomocą funkcji `getParameterFromUrl`. Te parametry są istotne dla działania aplikacji, ponieważ odpowiadają za identyfikację użytkownika i konfigurację transakcji. Dodatkowo zmienna `cKodKonfiguracja` pozwala na dynamiczne przypisanie ustawień konfiguracyjnych.

Funkcja `MojaOnLoad` pełni rolę inicjalizacyjną, ustawiając podstawowe parametry aplikacji. W jej ramach sprawdzane jest, czy kod konfiguracji został poprawnie podany, a następnie wykonywane jest zapytanie SQL za pomocą funkcji `ssDataSQL`. Wynik tego zapytania przypisywany jest do zmiennej `cZrdoloKonfiguracja`, co pozwala na dalsze operacje związane z konfiguracją. W przypadku braku określonych parametrów, takich jak `cUID2`, generowane są odpowiednie komunikaty informacyjne.

Ważnym elementem jest również obsługa skanowania kodów QR oraz EAN, która jest kontrolowana przez parametry `AllowScanQr` i `AllowScanEAN`. Te ustawienia umożliwiają dynamiczne dostosowanie interfejsu użytkownika w zależności od potrzeb danej transakcji. Dzięki temu aplikacja może być bardziej elastyczna i dostosowana do różnych scenariuszy użycia.

Kod zawiera także odniesienia do tabel w bazie danych, takich jak `_code_sql` oraz `x_skorowidze`. Tabela `_code_sql` służy do przechowywania kodów identyfikacyjnych z kolumnami `id` i `label`, które są wykorzystywane do wyświetlania list pozycji. Natomiast tabela `x_skorowidze` zawiera dodatkowe informacje opisowe i uwagi, które mogą być użyte w procesie transakcji.

Podsumowanie działania funkcji

Plik android_maw_szukaj.js odpowiada za obsługę parametrów transakcji oraz ich dynamiczną konfigurację. Funkcja MojaOnLoad inicjalizuje podstawowe ustawienia i umożliwia elastyczne dostosowanie aplikacji. Kod integruje się z bazą danych, co pozwala na efektywne zarządzanie danymi użytkownika i konfiguracją. Dzięki temu aplikacja może spełniać różnorodne wymagania biznesowe.

Wyszukiwanie awizacji na Androidzie

Plik android_maw_szukaj.js to skrypt JavaScript obsługujący wyszukiwanie awizacji w aplikacji mobilnej na Androida. Skrypt pobiera dane z bazy SQL, wyświetla listę wyników i umożliwia filtrowanie według wprowadzonych kryteriów.

Definicja zmiennych globalnych

Skrypt definiuje kilka zmiennych globalnych:

• cUID - identyfikator zapytania SQL dla wyników wyszukiwania.
• cUID2 - identyfikator zapytania dla tabeli skorowidzów.
• cKod2 - parametr wyszukiwania w skorowidzu.
• isProcessing - flaga kontrolująca przetwarzanie zapytań.
• cZrdoloKonfiguracja - konfiguracja ustawień wyszukiwania.

Funkcja MojaOnLoad()

Główna funkcja inicjalizująca interfejs wyszukiwania. Odpowiada za:

1. Sprawdzenie, czy wymagane parametry zostały przekazane.
2. Pobranie konfiguracji zapytania.
3. Wyświetlenie pola wyszukiwania oraz dynamicznego formularza z wynikami.
4. Obsługę skanera kodów QR (jeśli jest włączony w konfiguracji).

Obsługa interfejsu użytkownika

Skrypt generuje dynamiczny interfejs zawierający:

• Pole tekstowe do wpisania frazy wyszukiwania.
• Przycisk do uruchomienia skanowania kodów QR.
• Listę wyników wyszukiwania (początkowo ukrytą).
• Przyciski Wyszukaj i Zakończ.

Obsługa zdarzeń użytkownika

Skrypt reaguje na:

• Wciśnięcie klawisza Enter - jeśli wpisane są minimum 2 znaki, wyszukiwanie zostaje uruchomione.
• Kliknięcie przycisku Wyszukaj - uruchamia funkcję searchFunc(), pobierając dane z bazy.
• Kliknięcie przycisku Zakończ - wyświetla okno potwierdzenia przed zamknięciem wyszukiwarki.

Funkcja searchFunc()

Odpowiada za wyszukiwanie awizacji:

1. Sprawdza, czy użytkownik wprowadził minimum 2 znaki.
2. Pobiera wyniki z bazy SQL.
3. Jeśli dane są dostępne, dynamicznie generuje listę wyników.
4. W przypadku braku wyników wyświetla komunikat Brak danych.

Funkcja HideList()

Ukrywa listę wyników wyszukiwania.

Funkcja ChangeSearch()

Wyświetla komunikat potwierdzający chęć zakończenia wyszukiwania i zamyka okno.

Podsumowanie mechanizmu wyszukiwania

Na początku skrypt pobiera parametry z adresu URL takie jak uid3, uid2 oraz kod2. Następnie tworzy zmienną kontrolującą stan przetwarzania isProcessing.

Główna funkcja MojaOnLoad najpierw sprawdza poprawność wszystkich wymaganych parametrów. W przypadku ich braku wyświetla komunikat o błędzie.

Po pozytywnej weryfikacji parametrów funkcja generuje interfejs składający się z pola wyszukiwania, przycisku do skanowania kodów QR oraz miejsca na wyświetlenie wyników. Dodatkowo dodaje przyciski „Szukaj” oraz „Zakończ” w dolnej części ekranu.

Funkcja searchFunc obsługuje proces wyszukiwania. Wymaga wprowadzenia minimum 2 znaków w polu wyszukiwania. Po spełnieniu tego warunku pobiera dane poprzez ssDataSQL wykorzystując wprowadzoną frazę. Wyniki wyświetlane są w formie listy pod polem wyszukiwania.

Skrypt zawiera także obsługę skanera kodów QR poprzez bibliotekę html5-qrcode.min.js. Możliwość skanowania można włączyć lub wyłączyć poprzez parametr konfiguracyjny.

Funkcja HideList ukrywa listę wyników, natomiast ChangeSearch odpowiada za bezpieczne wyjście z aplikacji poprzez wyświetlenie okna potwierdzenia.

Całość jest zoptymalizowana pod kątem urządzeń mobilnych, co widać po zastosowanych klasach CSS oraz responsywnym układzie elementów.

Działanie skryptu

Plik JavaScript android_maw_szukaj.js zawiera kod odpowiedzialny za obsługę formularza wyszukiwania oraz powiązanych funkcjonalności. Poniżej znajduje się szczegółowy opis jego działania:

Główne funkcje

1. Inicjalizacja i sprawdzenie parametrów
   Na początku kodu deklarowane są zmienne cUID, cUID2 i cKod2, które pobierają wartości z parametrów URL. Następnie sprawdzane jest, czy te parametry są zdefiniowane. Jeśli którykolwiek z nich brakuje, wyświetlany jest komunikat o błędzie.
2. Pobieranie danych
   Funkcja ssDataSQL jest wykorzystywana do pobierania danych z bazy na podstawie podanych parametrów. Jeśli dane nie zostaną odnalezione, wyświetlany jest komunikat informujący o braku danych.
3. Konstruowanie interfejsu
   W ramce formularz tworzony jest interfejs użytkownika. Składa się on z:

• Pola do wyszukiwania z możliwością skanowania kodu QR.
• Listy wyników wyszukiwania.
• Przycisków do wyszukiwania i zakończenia operacji.

1. Obsługa zdarzeń

• Przycisk wyszukiwania jest aktywowany po wciśnięciu klawisza Enter lub kliknięciu przycisku.
• W trakcie wyszukiwania sprawdzana jest długość wpisanego tekstu. Jeśli jest on za krótki, wyświetlany jest odpowiedni komunikat.
• Wyniki wyszukiwania są wyświetlane w postaci listy.

1. Dodatkowe funkcje

• Skanowanie kodu QR jest obsługiwane przez bibliotekę html5-qrcode.min.js.
• Możliwość ukrycia listy wyników.
• Funkcja do zmiany wyszukiwania lub zakończenia operacji.

Szczegółowe opisy funkcji

• MojaOnLoad()
  Jest to główna funkcja inicjalizująca formularz. Sprawdza parametry, pobiera dane i buduje interfejs.
• searchFunc()
  Obsługuje proces wyszukiwania. Pobiera wartość z pola wyszukiwania, sprawdza jej długość, a następnie wyszukuje dane w bazie. Wyniki są wyświetlane na liście.
• HideList()
  Ukrywa listę wyników wyszukiwania.
• ChangeSearch()
  Wyświetla potwierdzenie przed zakończeniem wyszukiwania.
• closeWindow()
  Przeładowuje stronę, co skutkuje wyjściem z formularza.

Podsumowanie funkcji skryptu

Kod zawarty w android_maw_szukaj.js realizuje funkcjonalność formularza wyszukiwania z obsługą skanowania QR, walidacją danych wejściowych oraz wyświetlaniem wyników. Całość działa w sposób interaktywny, zapewniając użytkownikowi wygodne korzystanie z systemu.