Przejdź do głównej zawartości

Importowanie Punktów Agendy z pliku

Małgorzata Dombrowska avatar
Napisane przez Małgorzata Dombrowska
Zaktualizowano w tym tygodniu

Funkcja importu Agendy pozwala na szybkie i masowe dodawanie oraz aktualizowanie punktów programu za pomocą pliku CSV lub Excel. To idealne rozwiązanie, jeśli zarządzasz rozbudowanym harmonogramem i chcesz zaoszczędzić czas na ręcznym wprowadzaniu danych.

Z tego artykułu dowiesz się:

  • Jak przygotować plik do importu Agendy.

  • Które pola można importować i w jakim formacie.

  • Jak krok po kroku zaimportować pliki z harmonogramem.

  • Jak zaktualizować istniejące punkty programu za pomocą importu.

Podobne artykuły:


Krok 1: Przygotowanie pliku do importu

Zanim rozpoczniesz, musisz pobrać plik szablonu, który zapewni prawidłową strukturę danych.

  1. W panelu administratora przejdź do Program → Agenda.

  2. W prawym górnym rogu kliknij przycisk "Eksportuj".

  3. Z listy opcji wybierz format "XLSX dla importera".

System wygeneruje plik .xlsx, który zawiera nie tylko prawidłowe nagłówki kolumn, ale również tzw. słowniki. Są to dodatkowe arkusze z listą wszystkich prelegentów, tagów, ról czy przestrzeni wraz z ich unikalnymi identyfikatorami (UUID), które będą potrzebne w kolejnych krokach.

Podstawowe pola, które warto uwzględnić w pliku:

Nazwa Kolumny (sugestia)

Opis

Format

Wymagane?

name

Tytuł punktu programu.

Tekst

Tak

startingAt

Data i godzina rozpoczęcia.

RRRR-MM-DD GG:MM:SS

Tak

endingAt

Data i godzina zakończenia.

RRRR-MM-DD GG:MM:SS

Tak

type

Typ punktu programu (np. Wykład, Warsztat).

Tekst (musi odpowiadać nazwom typów zdefiniowanym w panelu)

Tak

description

Pełny opis punktu programu.

Tekst (może zawierać HTML)

Nie

shortDescription

Krótki, zajawkowy opis.

Tekst

Nie

venueName

Nazwa miejsca/przestrzeni, jeśli nie jest zarządzana jako osobny obiekt w systemie.

Tekst

Nie

💡Wskazówka - Formatowanie dat:
Aby uniknąć problemów z rozpoznawaniem daty i godziny przez programy arkuszy kalkulacyjnych (np. Excel), upewnij się, że kolumny startingAt i endingAt mają ustawiony format tekstowy. W przeciwnym razie data może zostać błędnie zinterpretowana jako długa liczba, co spowoduje błąd podczas importu.

💡Zaawansowane pola (dla powiązanych danych):

Aby połączyć punkty agendy z prelegentami, tagami, rolami czy przestrzeniami, musisz użyć ich unikalnych identyfikatorów (UUID).

Nazwa Kolumny (sugestia)

Opis

Format

uuid

Unikalny identyfikator punktu programu. Użyj go, jeśli chcesz zaktualizować istniejący wpis.

UUID (np. 9a6b1e6a-1b4d-4c3e-9ee1-3f1a2b8c8d32)

venue

Przestrzeń / miejsce, w którym odbywa się punkt programu.

Identyfikator UUID przestrzeni.

speakers

Prelegenci przypisani do punktu programu.

Lista identyfikatorów UUID uczestników oddzielona przecinkami.

leaders

Prowadzący przypisani do punktu programu.

Lista identyfikatorów UUID uczestników oddzielona przecinkami.

tags

Tagi przypisane do punktu programu.

Lista identyfikatorów UUID tagów oddzielona przecinkami.

roles

Role uczestników, dla których widoczny jest punkt programu.

Lista identyfikatorów UUID ról oddzielona przecinkami.

Ważne!
Skąd wziąć UUID dla prelegentów, tagów, ról czy przestrzeni? Plik szablonu pobrany z systemu zawiera dodatkowe arkusze (tzw. "słowniki"). Znajdziesz w nich listę wszystkich dostępnych w Twoim wydarzeniu prelegentów, tagów, ról, przestrzeni itp. wraz z ich identyfikatorami UUID. Wystarczy skopiować odpowiednie UUID z tych słowników i wkleić je w głównym arkuszu importu.


Krok 2: Import pliku w panelu

Gdy Twój plik jest gotowy, możesz przejść do importu.

  1. W panelu administratora, w menu po lewej stronie, przejdź do Program → Agenda.

  2. W prawym górnym rogu znajdź i kliknij przycisk "Importuj".

    [screen: Widok Agendy z zaznaczonym przyciskiem Importuj]

  3. Na ekranie importu kliknij "Wybierz plik" i wskaż przygotowany wcześniej plik z Twojego komputera, a następnie kliknij "Wyślij".

  4. System przeniesie Cię do ekranu mapowania kolumn. Tutaj musisz dopasować kolumny z Twojego pliku do odpowiednich pól systemowych. Jeśli korzystasz z pliku szablonu, mapowanie powinno odbyć się automatycznie.

    [screen: Ekran mapowania kolumn importera]

  5. Po upewnieniu się, że wszystkie pola są poprawnie zmapowane, kliknij "Zapisz i kontynuuj".

  6. System rozpocznie przetwarzanie pliku w tle. Na stronie importu możesz na bieżąco śledzić jego status. Po zakończeniu zobaczysz podsumowanie z informacją o liczbie pomyślnie zaimportowanych wierszy. Jeśli wystąpiły błędy, będziesz mógł pobrać plik z listą problematycznych wierszy, aby je poprawić.

Do wgrania templatu agendy system potrzebuje następujące kolumny:

  • Name

  • Type

  • StartingAt

  • EndingAt

Aktualizacja istniejących punktów agendy

Jeśli chcesz masowo zaktualizować istniejące punkty programu (np. zmienić ich godziny lub opisy), w swoim pliku do importu musisz umieścić kolumnę UUID.

  1. Najpierw wyeksportuj istniejącą agendę (opcja "XLSX dla importera"), aby pobrać UUID wszystkich punktów programu.

  2. W pliku eksportu zmodyfikuj dane, które chcesz zaktualizować, nie usuwając kolumny uuid.

  3. Zaimportuj plik z powrotem do systemu. System rozpozna istniejące UUID i zaktualizuje odpowiednie wpisy, zamiast tworzyć nowe.


FAQ - Najczęściej zadawane pytania

Mój import się nie powiódł. Co mogę zrobić?

Po zakończeniu importu system wyświetli raport z listą ewentualnych błędów. Możesz również pobrać plik z wierszami, które nie zostały zaimportowane, aby łatwiej zidentyfikować i poprawić problem. Najczęstsze problemy to zły format daty lub próba przypisania nieistniejącego UUID prelegenta lub tagu.

Czy muszę importować wszystkie kolumny?

Nie, możesz zaimportować plik zawierający tylko te kolumny, które chcesz uzupełnić lub zaktualizować. Pamiętaj jednak, że name, startingAt, endingAt i type są wymagane do utworzenia nowego punktu programu.

Jak dodać kilku prelegentów do jednego punktu programu w pliku?

W kolumnie speakers wklej identyfikatory UUID kolejnych prelegentów, oddzielając je od siebie przecinkiem (bez spacji), np. uuid1,uuid2,uuid3.

Czy to odpowiedziało na twoje pytanie?