Szablon:Lw kwerenda istniejące/opis: Różnice pomiędzy wersjami

Z Enkol
Przejdź do nawigacji Przejdź do wyszukiwania
(utworzenie strony dokumentacji)
 
 
(Nie pokazano 3 wersji utworzonych przez 2 użytkowników)
Linia 31: Linia 31:
  
  
<nowiki>{{Lw kwerenda istniejące|typ=</nowiki>''typ pojazdu''<nowiki>}}|kolej=</nowiki>''nazwa kolei''<nowiki>}}</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]

  1. Szablon generuje jedynie listę fizycznie istniejących pojazdów niezależnie od ich stanu
  2. 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"
  3. 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.

  1. 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)
  2. 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.
  3. 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
  4. 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]
  1. szablon:Lw kwerenda istniejące tabela
  2. szablon:Lw kwerenda istniejące nagłówek tabeli
  3. 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.

  1. szablon:Lw tabela sprawna
  2. szablon:Lw tabela złom
  3. szablon:Lw tabela odstawiona
  4. szablon:Lw tabela pomnik
  5. szablon:Lw tabela eksponat
  6. szablon:Lw tabela remont
  7. szablon:Lw tabela wrak
  8. szablon:Lw tabela nieznany

Przypisy

  1. Parametr wykorzystywany dalej przez szablon "Lw kwerenda istniejące tabela"
  2. Kolorowanie tła komórki zapewnia powiązany szablon "Lw kwerenda istniejące tabela"
  3. Właściwość umożliwia wygenerowanie linku do metryki danego pojazdu