Kolumny wykorzystujące znaczniki i zapytania SQL

Oprócz zwykłych pól i dowolnego tekstu zestawienie może pokazywać wartości dostarczane przez znacznik lub zapytanie SQL. W konfiguracji kolumn są to dwa odrębne rodzaje: znacznik szablonów i Dowolny SQL.

1. Kiedy wybrać dany rodzaj? #

Jeżeli potrzebna informacja jest zwykłym polem bieżącego lub powiązanego obiektu, najpierw rozważ pole – podgląd oraz ścieżkę między klasami. Konfiguracja będzie wtedy prostsza.

2. Kolumna „znacznik szablonów” #

1. Przygotuj i sprawdź znacznik zgodny z klasą wierszy zestawienia.
2. Otwórz konfigurację kolumn i dodaj nową definicję.
3. W polu Rodzaj wybierz znacznik szablonów.
4. Uzupełnij Nazwa i Klasa.
5. W polu znacznik wskaż definicję znacznika.
6. Ustaw szerokość i sposób prezentacji, zapisz kolumnę oraz przypisz ją do strony.

znacznik powinien zwracać treść właściwą dla konkretnego wiersza. Sprawdź co najmniej dwa obiekty z różnymi danymi, aby upewnić się, że wynik pochodzi z odpowiedniego kontekstu.

Przykład użycia znacznika #

Istniejący znacznik „Pole” pobiera nazwę opiekuna przez powiązanie klienta z użytkownikiem. Możesz wykorzystać go w kolumnie znacznik szablonów. Jeżeli potrzebna jest wyłącznie ta jedna wartość, porównaj rozwiązanie ze zwykłą kolumną pola przechodzącą do klasy opiekuna.

3. Kolumna „Dowolny SQL” #

1. Dodaj kolumnę i wybierz Rodzaj: Dowolny SQL.
2. Uzupełnij Nazwa i Klasa.
3. Wskaż właściwy Konektor, jeżeli dane mają pochodzić z takiego połączenia.
4. W polu Treść query wprowadź zapytanie odczytujące dane.
5. Przypisz kolumnę do zestawienia i porównaj wyniki ze źródłem.

Ten rodzaj kolumny wymaga znajomości SQL i struktury źródła danych. Nie jest tym samym co wybór gotowej definicji „Dane z query” dostępny w innych częściach programu.

4. Wymagany wynik zapytania #

Zapytanie powinno zwracać kolumny o nazwach id i value:

• id — identyfikator obiektu będącego wierszem bieżącego zestawienia;
• value — wartość przeznaczona do wyświetlenia w kolumnie.

znacznik {selected_ids} jest w tym mechanizmie zastępowany identyfikatorami wierszy aktualnie pobieranych do budowy danych. Nie oznacza tutaj wyłącznie wierszy zaznaczonych checkboxami przez użytkownika.

Przykład: suma pozycji dla zlecenia #

SELECT id_zlecenia AS id, SUM(wartosc_netto) AS value
FROM przykladowe_pozycje
WHERE id_zlecenia IN ({selected_ids})
GROUP BY id_zlecenia

Nazwy tabeli i pól w przykładzie są umowne. Trzeba zastąpić je nazwami z rzeczywistej bazy. Identyfikator zwracany jako id musi odpowiadać zleceniu z zestawienia, a nie pojedynczej pozycji zlecenia. Zapytanie powinno zwracać jeden wynik dla danego obiektu.

5. Weryfikacja i typowe problemy #

Jeżeli komórki są puste, sprawdź zgodność identyfikatorów, nazwy id i value oraz dostępność połączenia. Brak rekordu w wyniku zapytania może oznaczać pustą komórkę, a nie liczbowe zero. Sprawdź też czas wczytywania większego zestawienia i zachowanie sortowania. Ustawienia ogólne opisuje instrukcja kolumn.