Szablon:Lw kwerenda istniejące/opis: Różnice pomiędzy wersjami
(utworzenie strony dokumentacji) |
(→Lista cech pojazdu wyszukiwanych przez kwerendę: dokumentacja) |
||
| (Nie pokazano 3 wersji utworzonych przez 2 użytkowników) | |||
| Linia 31: | Linia 31: | ||
| − | <nowiki>{{Lw kwerenda istniejące|typ=</nowiki>''typ pojazdu''<nowiki> | + | <nowiki>{{Lw kwerenda istniejące|typ=</nowiki>''typ pojazdu''<nowiki>|kolej=</nowiki>''nazwa kolei''<nowiki>}}</nowiki> |
| Linia 56: | Linia 56: | ||
== Szczegółowy opis działania szablonu == | == 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 | ||
| + | |- | ||
| + | | 11 || brak || Lw strona<ref>Właściwość umożliwia wygenerowanie linku do metryki danego pojazdu</ref> | ||
| + | |} | ||
| + | |||
| + | ==== 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}} | ||
Aktualna wersja na dzień 14:36, 5 mar 2018
Funkcja szablonu[edytuj]
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[edytuj]
Generowanie listy wszystkich pojazdów trakcyjnych stacjonujących na wybranej kolei[edytuj]
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:
{{Lw kwerenda istniejące|kolej=nazwa kolei}}
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:
{{Lw kwerenda istniejące|kolej=Koszalińska Kolej Dojazdowa}}
Efekt:
| Oznaczenie | Typ fabryczny | Numer fabryczny | Rok produkcji | Stan | Rozstaw | Typ silnika | Stacjonowanie | Uwagi |
|---|---|---|---|---|---|---|---|---|
| MBxd2-307 | A20D-P | 25075 | 1985 | Sprawna | 1000 mm | Nieznany | Koszalin Wąskotorowy | |
| MBxd2-225 | A20D-P | ?(225) | 1986 | Odstawiona | 1000 mm | D2516HMU | Koszalin Wąskotorowy | Charakterystyczne biało-niebieskie barwy. |
| CEM.ODRA-Lyd2-05 | L30H | 24365 | 1981 | Sprawna | 1000 mm | Nieznany | Koszalin Wąskotorowy | |
| Lxd2-468 | L45H | 24341 | 1981 | Odstawiona | 1000 mm | Wola H12A | Koszalin Wąskotorowy | |
| Lxd2-475 | L45H | 24844 | 1983 | Sprawna | 1000 mm | Wola H12A | Koszalin Wąskotorowy | |
| Lxd2-476 | L45H | 24845 | 1983 | Sprawna | 1000 mm | Wola H12A | Koszalin Wąskotorowy | |
| Lxd2-476 | L45H | 24855 | 1983 | Odstawiona | 1000 mm | Wola H12A | Koszalin Wąskotorowy | |
| Px48-3901 | Px48 | 3901 (fab. 2117) | 1951 | Sprawna | 1000 mm | - | Koszalin Wąskotorowy | Lokomotywa posiada zbieralnik pary bliżej komina od pozostałych. |
Generowanie listy pojazdów trakcyjnych wybranego typu pojazdów trakcyjnych stacjonujących na wybranej kolei[edytuj]
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:
{{Lw kwerenda istniejące|typ=typ pojazdu|kolej=nazwa kolei}}
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:
{{Lw kwerenda istniejące|typ=L45H|kolej=Koszalińska Kolej Dojazdowa}}
Efekt:
| Oznaczenie | Typ fabryczny | Numer fabryczny | Rok produkcji | Stan | Rozstaw | Typ silnika | Stacjonowanie | Uwagi |
|---|---|---|---|---|---|---|---|---|
| Lxd2-468 | L45H | 24341 | 1981 | Odstawiona | 1000 mm | Wola H12A | Koszalin Wąskotorowy | |
| Lxd2-475 | L45H | 24844 | 1983 | Sprawna | 1000 mm | Wola H12A | Koszalin Wąskotorowy | |
| Lxd2-476 | L45H | 24845 | 1983 | Sprawna | 1000 mm | Wola H12A | Koszalin Wąskotorowy | |
| Lxd2-476 | L45H | 24855 | 1983 | Odstawiona | 1000 mm | Wola H12A | Koszalin Wąskotorowy |
Ogracznienia[edytuj]
- 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[edytuj]
Zauważone błędy należy zgłaszać w dziale "Zgłoś bląd" Forum społeczności Enkolu.
Szczegółowy opis działania szablonu[edytuj]
Opis parametrów[edytuj]
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[edytuj]
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ę[edytuj]
| Numer parametru | Kolumna w tabeli | Powiązana wartość semantyczna (atrybut) |
|---|---|---|
| 1 | brak[1] | brak |
| 2 | Numer fabryczny | Lw numer seryjny |
| 3 | Rok produkcji | Lw rok produkcji |
| 4 | Stan[2] | 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 |
| 11 | brak | Lw strona[3] |
Lista szablonów powiązanych[edytuj]
Bezpośrednio[edytuj]
- szablon:Lw kwerenda istniejące tabela
- szablon:Lw kwerenda istniejące nagłówek tabeli
- szablon:Lw tabela stop
Pośrednio[edytuj]
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