Mechanizm działania funkcji jqs_sql_select.js
Plik jqs_sql_select.js realizuje dynamiczne pobieranie danych SQL poprzez interfejs użytkownika. W pierwszej kolejności inicjalizuje niezbędne skrypty eksportu danych i kompresji, co umożliwia późniejsze operacje na wynikach zapytań. Następnie generuje dynamicznie elementy formularza HTML, które służą do wprowadzania parametrów wyszukiwania. Konfiguracja kontrolek wprowadzania wartości liczbowych i list rozwijanych odbywa się automatycznie po załadowaniu strony, co zapewnia spójność interfejsu.
Proces walidacji i konstrukcji zapytania
Funkcja jqs_sql_run_select rozpoczyna działanie od sprawdzenia poprawności wypełnienia pól wymaganych, wykorzystując mechanizm walidacji JqxTestWypelnienia. Po pozytywnej weryfikacji zbiera parametry z formularza, łącząc je w specjalny ciąg separatorami pionowymi. Warto zauważyć, że specjalne znaki w warunkach wyszukiwania są zastępowane bezpiecznymi sekwencjami, co zapobiega potencjalnym problemom z parsowaniem. Ostatecznie wysyła zapytanie do serwera poprzez funkcję ssDataSQL z unikalnym identyfikatorem GUID transakcji.
Obsługa wyników i komunikacja błędów
Po otrzymaniu odpowiedzi serwera skrypt analizuje długość zwróconych danych. W przypadku braku wyników wyświetla komunikat o nieznalezieniu rekordów, korzystając z dynamicznego wstrzykiwania HTML. Gdy dane są dostępne, przetwarza je w formacie XML, przygotowując strukturę tabeli HTML z nagłówkami kolumn. Każde pole rekordu jest następnie formatowane z uwzględnieniem typu danych, co zapewnia prawidłowe wyświetlanie wartości liczbowych i tekstowych.
Transakcja oznaczona identyfikatorem jqs_sql_select.js realizuje cały cykl przetwarzania zapytania - od inicjalizacji interfejsu po prezentację wyników. Mechanizm obsługi błędów działa dwutorowo, sprawdzając zarówno poprawność wprowadzonych danych, jak i zawartość odpowiedzi serwera. Rozwiązanie wykorzystuje kombinację technologii klienckich i serwerowych, zapewniając elastyczność w konstruowaniu dynamicznych zapytań SQL. Optymalizacja procesu polega na minimalizacji liczby żądań poprzez zbiorcze przetwarzanie parametrów.
Podsumowanie
Funkcjonalność pliku jqs_sql_select.js koncentruje się na integracji interfejsu użytkownika z systemem bazodanowym. Proces obejmuje etapy konfiguracji formularza, walidacji danych oraz bezpiecznej komunikacji z serwerem. Implementacja wykorzystuje mechanizmy dynamicznego generowania kodu HTML i XML, zapewniając skalowalność rozwiązania.
Plik: jqs_sql_select.js - System Zapytania SQL SELECT
Plik jqs_sql_select.js to skrypt JavaScript obsługujący interfejs użytkownika do wykonywania zapytań SQL SELECT na bazie danych. Umożliwia on użytkownikom dynamiczne pobieranie danych z określonej tabeli, filtrowanie ich oraz wyświetlanie w postaci siatki danych (grid).
Funkcja MojaOnLoad()
Główna funkcja inicjalizująca formularz do wykonania zapytań SELECT. W jej ramach:
- Ładowane są dodatkowe skrypty JavaScript do eksportu danych oraz obsługi plików ZIP.
- Tworzony jest interfejs użytkownika z polami do wpisania nazwy tabeli, kolumn oraz warunku WHERE.
- Dodawana jest kontrolka do określenia maksymalnej liczby zwracanych rekordów.
- Tworzony jest przycisk WYKONAJ SELECT, który uruchamia funkcję wykonującą zapytanie.
Po załadowaniu formularza:
- Konfigurowane są kontrolki typu jqxNumber i jqxCombo.
- Ustawiany jest domyślny wygląd strony.
- Automatycznie ustawiane jest skupienie na polu nazwy tabeli.
Funkcja jqs_sql_run_select()
Jest to funkcja odpowiedzialna za wykonanie zapytania SQL SELECT i wyświetlenie wyników w tabeli. Proces składa się z kilku kroków:
- Sprawdzana jest poprawność wypełnienia wymaganych pól.
- Pobierana jest nazwa tabeli oraz inne parametry:
- Liczba rekordów do pobrania.
- Lista kolumn do zwrócenia.
- Warunek WHERE (zastępując apostrofy unikalnym symbolem).
- Dane są pobierane za pomocą funkcji ssDataSQL(), która wykonuje zapytanie SQL na serwerze.
- Jeśli nie zwrócono żadnych wyników, wyświetlany jest komunikat Brak danych dla zapytania.
- Jeśli dane są dostępne, tworzona jest struktura tabeli dynamicznej, w której:
- Generowane są pola kolumn.
- Tworzony jest adapter danych do obsługi interakcji.
- Dane są wyświetlane w jqxGrid z opcją filtrowania, sortowania i eksportu.
Formatowanie tabeli wynikowej
Po pobraniu danych skrypt konfiguruje tabelę jqxGrid, dodając:
- Automatyczne dopasowanie wysokości i szerokości.
- Opcję filtrowania i sortowania.
- Eksport do Excela (obsługa przycisków eksportu została zakomentowana).
- Dynamiczne dostosowanie szerokości kolumn do treści.
Podsumowanie
Plik jqs_sql_select.js jest elementem systemu umożliwiającego wykonywanie dynamicznych zapytań SQL SELECT przez użytkownika. Pozwala na interaktywne pobieranie i filtrowanie danych z bazy, zapewniając prosty, ale efektywny interfejs. Zapewnia walidację danych wejściowych i dynamiczną konfigurację wyświetlania wyników, co pozwala na szybkie analizowanie danych bez konieczności bezpośredniego wpisywania zapytań SQL.