Roster Athletics

Zamiast dodawać zawodników do listy startowej pojedynczo, możesz dodać kilku lub wszystkich zawodników za jednym razem przy zastosowaniu Import/Export pliku CSV. Znajdziesz tę opcję z lewej strony zakładki Szczegóły.

Poradnik składa się z następujących części:

• Przygotowywanie pliku CSV
• Import pliku CSV
  • Jak dodać sztafetę?
• Kody używane do określenia rundy, konkurencji i kategorii wiekowej
  • Kody konkurencji (EventCode)
  • Kody poszczególnych rund (EventStage)
  • Kody kategorii wiekowych (AgeGroup)
• Jak otworzyć plik CSV w Excelu?

Przygotowywanie pliku CSV

Możesz przygotować plik CSV w arkuszu kalkulacyjnym (np. Microsoft Excel). Aby to zrobić, musisz przygotować następujące kolumny (nazwy kolumn oznaczone kolorem czerwonym są obowiązkowe):

• EntryId - Wszyscy zawodnicy i sztafety są ponumerowani kolejno dla każdych zawodów (zobacz przykład poniżej).
• StartListId - Wszystkie listy startowe mogą być ponumerowane w grupach z unikalnym numerem dla każdej grupy/konkurencji. Ta kolumna dotyczy konkurencji mieszanych (z mężczyznami i kobietami na wspólnej liście startowej), z wieloma kategoriami wiekowymi oraz sztafet.
• RelayTeamName - Nazwa sztafety.
• FullName - Pełna nazwa zawodnika. Uwaga: Jeżeli pole FullName jest wypełnione, wówczas FirstName i LastName nie są obowiązkowe.
• FirstName - Imię zawodnika.
• MiddleName - Drugie imię zawodnika.
• LastName - Nazwisko zawodnika.

UWAGA: Dodając imię, drugie imię oraz nazwisko użyj wielkości liter jak w nazwie własnej, np. Jan Kowalski-Nowak.

• Gender - Płeć zawodnika (jedynymi opcjami są Male dla mężczyzn oraz Female dla kobiet). Jeżeli chcesz dodać konkurencję mieszaną, sprawdź jak to zrobić poniżej.
• CountryCode - Trzyliterowy skrót kraju (np. USA, FRA, CHN, SWE). Wszystkie skróty możesz znaleźć na stronie World Athletics: https://www.worldathletics.org/about-iaaf/structure/member-federations 
• DateOfBirth - Data urodzenia zawodnika w formacie RRRR-MM-DD. Uwaga: Format daty jest bardzo istotny, w tym celu możesz użyć opcji formatowania komórek.
• YearOfBirth - Rok urodzenia zawodnika uwzględniający cztery znaki (np. 1995).
• TilastopajaId - Numer ID zawodnika w bazie danych Tilastopaja.
• RelayId - Jeżeli w polu RelayTeamName dodano nazwę sztafety, wtedy możesz dodać także zawodników do tej sztafety. Każdy zawodnik powinien wówczas mieć w kolumnie RelayId informację z numerem EntryId sztafety, w której startuje.
• EventStart - Data i godzina rozpoczęcia konkurencji. To pole może pozostać puste, po imporcie datę i godzinę rozpoczęcia można ustawić w platformie Roster Athletics. Wymagany format to RRRR-MM-DD HH:MM:SS (np., 2020-02-14 15:55:00)
• EventCode - Kod konkurencji. Listę kodów możesz znaleźć poniżej. Jako kod można użyć także nazwy konkurencji w języku angielskim (np. 100m Hurdles lub High Jump).
• EventStage - Nazwa rundy danej konkurencji. Może to być Qualification (kwalifikacje dla konkurencji technicznych), Preliminary (preeliminacje), Heat (serie eliminacyjne), Semi-Final (półfinał) lub Final (finał). To pole może zostać zmienione w trakcie importu w panelu administracyjnym Roster Athletics.
• AgeGroup - Kategoria wiekowa zawodnika. Lista kodów dla poszczególnych kategorii dostępna jest poniżej (możesz użyć Auto, aby automatycznie przypisać zawodników do kategorii wiekowych na podstawie roku lub daty urodzenia). 
• ClubName - Nazwa klubu/szkoły, który zawodnik reprezentuje na tych zawodach. Można dodać wyłącznie jeden klub.
• TeamName - Nazwa drużyny (jeżeli zawody uwzględniają rywalizację drużynową).
• TeamName2 - Nazwa drugiej drużyny (jeżeli zawody uwzględniają kilka klasyfikacji drużynowych).
• TeamName3 - Nazwa kolejnej drużyny (jeżeli zawody uwzględniają kilka klasyfikacji drużynowych).
• BibNumber - Numer startowy zawodnika.
• PersonalBest - Rekord życiowy zawodnika. W wynikach określających odległość pomiędzy wartością centymetrów i metrów musi znaleźć się kropka ".". Kropka służy także do oddzielenia sekund od części setnych sekundy. Pomiędzy godziną a minutami oraz pomiędzy minutami a sekundami musi znaleźć się ":".
• SeasonBest - Rekord sezonu zawodnika. Formatowanie takie samo jak dla rekordów życiowych (MM.cc lub HH:MM:SS.00)
• Title - specjalna nazwa konkurencji, np. "ORLEN CUP". Należy pamiętać, że w przypadku dodania konkurencji z nazwą do programu minutowego zostanie dodana nowa konkurencja, nawet w przypadku gdy w programie minutowym istnieje ta sama konkurencjia bez nazwy.

Przykładowy pklik CSV dołączony jest to tego poradnika. Znajdziesz go na dole strony.

Jeżeli korzystasz z list startowych PZLA, możesz wygenerować i zaimportować plik CSV ze strony PZLA bez konieczności jego edytowania.

Pamiętaj, żeby w pliku CSV nie używać znaków specjalnych (np. , /przecinek/, ; /średnik/ lub “ /cudzysłów/).

Po dodaniu wszystkich zawodników do arkusza kalkulacyjnego i wypełnieniu wszystkich wymaganych kolumn musisz zapisać listę w formacie CSV.

UWAGA: Bardzo ważne jest, by zapisać plik przy użyciu kodowania UTF-8 CSV.

Import pliku CSV

W systemie możesz dodać przygotowany plik CSV, wybierając Import list startowych i następnie użyć formatu Roster.

Załadowanie pliku sprawi, że w menu po lewej stronie pojawi się nowa opcja - Import list startowych. Dostęp do załadowanego pliku będzie możliwy do momentu zmiany zawodów, importu nowego pliku, zakończenia przycisku Zakończ lub przeładowaniu strony.

Po zaimportowaniu pliku zobaczysz osobne listy dla każdej konkurencji z różnymi grafikami obok nazw zawodników/sztafet.

	= niebieska ikona oznacza, że zawodnik istnieje w bazie danych Roster Athletics i został poprawnie dopasowany lub jest nowym zawodnikiem w bazie danych.
	= żółta ikona oznacza, że system znalazł zawodnika w bazie danych, ale dopasowanie nie jest idealne (warto zweryfikować zawodników z tym statusem).
	= czerwona ikonka oznacza, że istnieje konflikt w dopasowaniu i wymagany jest wybór odpowiedniego zawodnika z listy lub dodanie nowego (zobacz niżej, jak to zrobić).

Pamiętaj o rozwiązaniu wszystkich konfliktów i zapisaniu listy startowej poprzez kliknięcie przycisku Importuj. Nie możesz zapisać listy startowej danej konkurencji, dopóki wszystkie problemy nie zostaną rozwiązane.

Po zaimportowaniu listy możesz przejść do edycji listy startowej, klikając przycisk Lista startowa.

Jeżeli system dopasował błędnego zawodnika lub sztafetę, możesz dodać poprawnego zawodnika, klikając ikonę umieszczoną tuż przed nazwą zawodnika/sztafety.

Przykład: Importujesz plik CSV z dwiema sztafetami o nazwie "Roster Relay", gdzie jedna sztafeta ma numer 1 (Roster Relay 1), a druga 2 (Roster Relay 2). Załóżmy, że w bazie danych Roster Athletics znajduje się tylko jedna sztafeta o nazwie Roster Relay. Wówczas po imporcie obie sztafety będą przypisane do istniejącej sztafety o tej właśnie nazwie "Roster Relay". Do systemu nie można jednak dodać dwóch sztafet o tej samej nazwie, więc aby rozwiązać ten konflikt, musisz stworzyć nowe sztafety o nazwie "Roster Relay 1" i "Roster Relay 2". Zobacz poniższy przykład.

Jak dodać sztafetę?

Chcąc dodać sztafety za pomocą importu pliku CSV, postępuj według poniższcyh zasad:

• Wiersz sztafety: wypełnij odpowiednie komórki w wierszu EntryId: StartListId, RelayTeamName, Gender, CountryCode, EventCode, EventStage, AgeGroup, ClubName (lub nazwa szkoły), TeamName (można przypisać podczas importowania).
• W kolejnych wierszach dodaj zawodników (każdego osobno w nowej linii). Każdy zawodnik w komórce RelayId musi posiadać tę samą wartość EntryId wcześniej dodanej sztafety. Pozwoli to na powiązanie zawodnika ze sztafetą.
• Każdy zawodnik musi posiadać tę samą wartość StartListId co wcześniej dodana sztafeta.
• Każda kolejna sztafeta (oraz członkowie sztafety), która bierze udział w tej samej rywalizacji, musi mieć ten sam numer StartListID.

Jak dodać sztafetę mieszaną (wspólna rywalizacja sztafet męskich i żeńskich)?

W przypadku, gdy w tej samej konkurencji startują sztafety męskie i damskie, użyj tej samej wartości StartListId dla wszystkich sztafet biorących udział w rywalizacji. 

Jak dodać sztafetę mieszaną (z kobietami i mężczyznami w składzie)?

W przypadku, gdy w tej samej konkurencji startują sztafety z kobietami i mężczyznami w składzie, należy wybrać specjalną konkurencję ze skrótem MIX w nazwie, np. 4x400m MIXED TEAM. 

• Wpisz 4x400m MIXED TEAM w kolumnie EventCode (lub inny kod odpowiadający danej konkurencji; lista kodów poniżej),
• W kolumnie Gender w wierszu z nazwą sztafety wpisz Mixed,
• Płeć zawodników pozostaje zgodna z faktyczną płcią członków sztafety (Male lub Female),
• Ustaw tę samą wartość RelayID dla członków danej sztafety.

Jak dodać konkurencję mieszaną (Mixed)?

Jeżeli chcesz dodać konkurencję mieszaną (w której startują kobiety i mężczyźni), w kolumnie Gender musisz dodać Male dla wszystkich mężczyzn oraz Female dla wszystkich kobiet, a następnie w kolumnie Start List ID (StartListId) dodać tę samą wartość dla wszystkich zawodników startujących w tej konkurencji. Zobacz poniższy przykład.

Kody używane do określenia rundy, konkurencji i kategorii wiekowej

Poniżej znajdują się kody konkurencji i kategorii wiekowych, których powinieneś użyć, przygotowując plik CSV.

Kody konkurencji (EventCode)

Nazwa konkurencji = kod, który należy użyć w pliku CSV

Pamiętaj, że jako kodu możesz użyć także nazwy konkurencji w języku angielskim, np. High Jump dla skoku wzwyż.

Kody poszczególnych rund (EventStage)

Możliwe wartości:

Qualification = kwalifikacje (tylko dla konkurencji technicznych)  

Preliminary = preeliminacje (tylko konkurencje biegowe/chodu sportowego)

Heat = kwalifikacje/serie (tylko konkurencje biegowe/chodu sportowego)

Semi-Final = półfinały (tylko konkurencje biegowe/chodu sportowego)

Final = finał

Kody kategorii wiekowych (AgeGroup)

Kategoria wiekowa = kod, który należy użyć w pliku CSV

Kategoria wiekowa = Auto (wybierz ten kod w przypadku, gdy chcesz automatycznie przypisać zawodników do kategorii wiekowych w oparciu o rok lub datę urodzenia).

Jak otworzyć plik CSV w Excelu?

Sprawdź instrukcję Microsoft: https://answers.microsoft.com/en-us/msoffice/forum/all/how-to-open-utf-8-csv-file-in-excel-without-mis/1eb15700-d235-441e-8b99-db10fafff3c2