Edytujesz Szablon:Lw kwerenda istniejące/opis

== Funkcja szablonu ==

Szablon generuje listę pojazdów trakcyjnych znajdujących się obecnie na ternie wybranej kolei wąskotorowej. Możliwe jest wygenerowanie zestawienia wszystkich pojazdów trakcyjnych wszystkich typów albo wybranego jednego typu. Szablon eliminuje konieczność ręcznego tworzenia tabel z zestawieniem pojazdów trakcyjnych znajdujących się na terenie danej kolei oraz eliminuje konieczność zmieniania danych na wielu stronach w przypadku zmiany statusu (stanu, oznaczenia, miejsca stacjonowania itp.) pojazdu trakcyjnego. 

== Sposób użycia ==

=== Generowanie listy wszystkich pojazdów trakcyjnych stacjonujących na wybranej kolei ===

W celu wygenerowania listy wszystkich pojazdów trakcyjnych znajdujących się na terenie danej kolei należy w treści hasła zamieścić następujący kod:


<nowiki>{{Lw kwerenda istniejące|kolej=</nowiki>''nazwa kolei''<nowiki>}}</nowiki>


gdzie w miejsce ''nazwa kolei'' należy wpisać rzeczywistą nazwę interesującej nas kolei. Przyjęto zasadę, że w opisie pojazdu trakcyjnego jako nazwę kolei, na terenie której się znajduję stosuje się jej nazwę używana w roku 2001, czyli ostatnim roku funkcjonowania Dyrekcji Kolei Dojazdowych PKP. 


'''Przykład''': W celu wygenerowania listy wszystkich pojazdów trakcyjnych stacjonujących na terenie Koszalińskiej Kolei Dojazdowej:


<nowiki>{{Lw kwerenda istniejące|kolej=Koszalińska Kolej Dojazdowa}}</nowiki>


'''Efekt:'''

{{Lw kwerenda istniejące|kolej=Koszalińska Kolej Dojazdowa}}

=== Generowanie listy pojazdów trakcyjnych wybranego typu pojazdów trakcyjnych stacjonujących na wybranej kolei ===

W celu wygenerowania listy pojazdów trakcyjnych wybranego typu pojazdów trakcyjnych stacjonujących na wybranej kolei wąskotorowej należy kodzie hasła umieścić następujący kod:


<nowiki>{{Lw kwerenda istniejące|typ=</nowiki>''typ pojazdu''<nowiki>|kolej=</nowiki>''nazwa kolei''<nowiki>}}</nowiki>


W miejsce ''typ pojazdu'' należy wpisać oznaczenie poszukiwanego typu pojazdu, a w miejsce ''kolej'' nazwę interesującej nas kolei (z zastrzeżeniem, jak powyżej):


'''Przykład''': W celu wygenerowania listy lokomotyw typu L45H stacjonujących na terenie Koszalińskiej Kolei Dojazdowej należy w treści hasła umieścić następujący kod:


<nowiki>{{Lw kwerenda istniejące|typ=L45H|kolej=Koszalińska Kolej Dojazdowa}}</nowiki>


'''Efekt:'''

{{Lw kwerenda istniejące|typ=L45H|kolej=Koszalińska Kolej Dojazdowa}}

== Ogracznienia ==
# Szablon generuje jedynie listę fizycznie istniejących pojazdów niezależnie od ich stanu
# W generowanej z użyciem szablonu liście uwzględniane są wyłącznie pojazdy posiadające swoją podstronę stworzoną z wykorzystaniem szablonu"Lw metryka pojazdu"
# Konieczne jest wpisanie nazwy kolei zgodnie z przyjętym standardem. Wpisanie np. "Pleszewska Kolej Lokalna" wygeneruje pustą listę ponieważ pojazdy figurują pod "Pleszewska Kolej Dojazdowa"

== Błędy ==
Zauważone błędy należy zgłaszać w dziale "Zgłoś bląd" [[Specjalna:WikiForum|Forum społeczności Enkolu]].

== Szczegółowy opis działania szablonu ==
=== Opis parametrów ===
Działanie szablonu (a w zasadzie "zaszytej" w nim kwerendy) polega na wyszukaniu egzemplarzy pojazdów trakcyjnych według kryteriów zadanych w jego parametrach ''typ'' oraz ''kolej''. 
# Jeśli zostaną podane wartości obu parametrów , to zostaną wyszukane wszystkie pojazdy trakcyjne podanego typu znajdujące się na terenie danej kolei (warunek logiczny '''i''' / '''AND''' - koniunkcja)
# Jeśli zostanie podana wartość tylko parametru ''kolej'' to zostaną wyszukane wszystkie pojazdy trakcyjne znajdujące się na terenie wybranej kolei. Warunek wyszukiwania ''typ'' zostanie zastąpiony wieloznacznikiem.
# Jeśli zostanie podana wartość tylko parametru ''typ'', to zostaną wyszukane wszystkie fizycznie istniejące pojazdy trakcyjne danego typu niezależnie od kolei, na której terenie się znajdują. Parametr ''kolej'' zostanie zastąpiony wieloznacznikiem
# W przypadku pominięcia obu parametrów zostanie wygenerowana lista wszystkich fizycznie istniejących pojazdów trakcyjnych znajdujących się na wszystkich kolejach (oba parametry zostaną zastąpione wieloznacznikiem)

=== Opis sposobu formatowania danych wynikowych ===

Kwerenda zwraca zestawienie wyszukanych pojazdów trakcyjnych oraz ich cech w postaci listy parametrów anonimowych (numerowanych), a następnie przekazuje je do szablonu "Lw kwerenda istniejące tabela", który nadaje wygenerowanym danym postać tabeli oraz zapewnia kolorowanie tła komórek znajdujących się w kolumnie "stan". Szablon "Lw kwerenda istniejące nagłówek tabeli" generuje nagłówek tabeli, szablon "Lw tabela stop" generuje stopkę tabeli. 

=== Lista cech pojazdu wyszukiwanych przez kwerendę ===

{|class="wikitable"
! Numer parametru !! Kolumna w tabeli !! Powiązana wartość semantyczna (atrybut)
|-
| 1 || brak<ref>Parametr wykorzystywany dalej przez szablon "Lw kwerenda istniejące tabela"</ref> || brak
|-
| 2 || Numer fabryczny || Lw numer seryjny
|-
| 3 || Rok produkcji || Lw rok produkcji
|-
| 4 || Stan<ref>Kolorowanie tła komórki zapewnia powiązany szablon "Lw kwerenda istniejące tabela"</ref>|| Lw stan
|-
| 5 || Rozstaw || Lw ostatni rozstaw
|-
| 6 || Typ silnika || Lw ostatni typ silnika
|-
| 7 || Oznaczenie || Lw ostatnie oznaczenie
|-
| 8 || Stacjonowanie || Lw ostatnie stacjonowanie
|-
| 9 || Uwagi || Lw uwagi
|-
| 10 || Typ fabryczny || Lw typ fabryczny
|}

==== Lista szablonów powiązanych ====
===== Bezpośrednio =====
#[[:szablon:Lw kwerenda istniejące tabela]]
#[[:szablon:Lw kwerenda istniejące nagłówek tabeli]]
#[[:szablon:Lw tabela stop]]
===== Pośrednio =====
Szablon "Lw kwerenda istniejące tabela" odwołuje się do szablonów zapewniających kolorowanie komórek w kolumnie "Stan" wygenerowanej przez niego tabeli.

#[[:szablon:Lw tabela sprawna]]
#[[:szablon:Lw tabela złom]]
#[[:szablon:Lw tabela odstawiona]]
#[[:szablon:Lw tabela pomnik]]
#[[:szablon:Lw tabela eksponat]]
#[[:szablon:Lw tabela remont]]
#[[:szablon:Lw tabela wrak]]
#[[:szablon:Lw tabela nieznany]]

{{Przypisy}}
@@ Linia 91: / Linia 91: @@
 |-
 | 10 || Typ fabryczny || Lw typ fabryczny
-|-
-| 11 || brak || Lw strona<ref>Właściwość umożliwia wygenerowanie linku do metryki danego pojazdu</ref>
 |}