Używanie protokołu SFTP do przesyłania danych uczniów, personelu i klas do portalu Apple School Manager

Jeśli używany system informacji o uczniach (SIS, student information system) nie jest obecnie obsługiwany przez portal Apple School Manager lub nie posiadasz systemu informacji o uczniach, możesz przesłać dane uczniów, personelu i klas do portalu Apple School Manager za pomocą protokołu SFTP.

Gdy skonfigurujesz protokół SFTP w Asystencie ustawień, portal Apple School Manager udostępni pliki szablonów CSV oraz informacje dostępowe do prywatnego serwera SFTP. Możesz wyeksportować dane z systemu SIS lub utworzyć pliki w aplikacji do obsługi arkuszy kalkulacyjnych, takiej jak Numbers.

Na komputerze z systemem macOS przesyłanie przez SFTP wymaga aplikacji innej firmy. Jeśli na komputerze nie zainstalowano klienta SFTP, pobierz go ze sklepu Mac App Store.

Użyj poniższych przycisków, aby uzyskać pomoc dotyczącą konfiguracji plików SFTP. Jeśli serwer SFTP nie był używany do przesyłania danych do portalu Apple School Manager, zacznij od części Konfigurowanie pierwszego przesyłania przez SFTP.

Konfigurowanie pierwszego przesyłania przez SFTP

  1. Zaloguj się w portalu Apple School Manager jako administrator, kierownik instytucji lub menedżer osób.
  2. Jeśli to Twoje pierwsze logowanie, zostanie wyświetlony Asystent ustawień. Jeśli Asystent ustawień nie zostanie wyświetlony, kliknij swoje imię i nazwisko w prawym górnym rogu. Wybierz opcję Asystent ustawień.
  3. Kliknij opcję Znajdź uczestników, personel i klasy.
  4. Kliknij opcję Konfiguruj SFTP.
  5. Portal Apple School Manager wygeneruje adres URL, nazwę użytkownika i hasło służące do przesyłania plików. Użyj tych informacji do skonfigurowania klienta SFTP.
  6. Kliknij opcję Pobierz szablony.
  7. Przeczytaj instrukcję używania szablonów w części Wypełnianie plików danych.
  8. Po wypełnieniu plików danych utwórz archiwum ZIP ze wszystkich sześciu plików. W Finderze możesz wybrać pliki, a następnie przejść do menu Plik i wybrać opcję Kompresuj 6 rzeczy. Nazwa archiwum ZIP może być dowolna.
  9. Prześlij plik ZIP do portalu Apple School Manager. Za pomocą klienta SFTP połącz się z adresem URL wyświetlonym w Asystencie ustawień. Gdy pojawi się monit o podanie danych logowania, wprowadź nazwę użytkownika i hasło otrzymane po kliknięciu opcji Konfiguruj SFTP. Skopiuj plik ZIP do katalogu dropbox.
  10. Kliknij opcję Dalej w Asystencie ustawień. Jeśli przesyłane dane będą zawierać błędy, możesz zapoznać się z dziennikiem plików i wierszy zawierających błędy. Popraw błędy w plikach danych, a następnie wykonaj ponownie kroki 8 i 9. Nie musisz usuwać poprzedniego pliku z serwera SFTP.
  11. Gdy serwer SFTP zaimportuje pliki, kliknij opcję Sprawdź dane SFTP. Jeśli znajdziesz błędy, kliknij opcję Anuluj. Popraw błędy w plikach danych, a następnie powtórz proces przesyłania. Jeśli dane są poprawne i kompletne, kliknij opcję Dalej.
  12. W sekcji Utwórz konta i klasy wybierz format Zarządzany Apple ID dla uczniów, prowadzących i personelu. Kliknij opcję Podgląd kont i klas. Gdy ID są w prawidłowym formacie, kliknij opcję Utwórz konta i klasy.
  13. Po utworzeniu kont roześlij dane logowania do użytkowników i przydziel role personelowi.

Wypełnianie plików danych

Pobrany szablon obejmuje sześć plików wartości rozdzielanych przecinkami (CSV) dla klas (classes), kursów (courses), lokalizacji (locations), list uczniów (rosters), uczniów (students) i personelu (staff). Jeśli szablony nie są dostępne w portalu Apple School Manager lub kopie oryginalnych szablonów zostały utracone, możesz pobrać je ponownie.

Możesz użyć systemu SIS w celu wyeksportowania danych w formacie opisanym przez szablony i w niniejszym artykule albo wyedytować szablony w aplikacji do obsługi arkuszy kalkulacyjnych, takiej jak Numbers.

Skorzystaj z tabel w tym artykule, aby upewnić się, że wprowadzasz poprawne informacje, a następnie zachowaj każdy plik, nie zmieniając jego nazwy.

Formatowanie wartości

Jeśli edytujesz szablony, zastąp przykładowe dane własnymi. Nie zmieniaj zawartości komórek nagłówka w żadnym z plików. Nie dodawaj kolumn w żadnym z plików, chyba że w sposób opisany poniżej.

Każdy wiersz w każdym szablonie musi zawierać unikatową wartość. Na przykład w pliku students.csv każdy wiersz musi zawierać imię i nazwisko innego ucznia. Niektóre wartości dla tego ucznia mogą być puste. Literały w nazwie, takie jak podział wiersza lub znak zapytania, należy poprzedzić ukośnikiem (\), np. (\”). Wszystkie wprowadzone identyfikatory muszą być alfanumeryczne i mogą zawierać znak „-”.

Jeśli wartość zawiera spację ( ) lub przecinek (,), oddziel ją z obu stron cudzysłowem prostym ("). Jeśli wartość nie zawiera żadnego z wymienionych znaków specjalnych, nie używaj cudzysłowu. Jeśli nie wprowadzisz cudzysłowów w niezbędnych miejscach lub wprowadzisz cudzysłowy drukarskie, podczas przesyłania wystąpią błędy.

Wartości w plikach muszą być rozdzielone przecinkami (,) lub średnikami (;), bez względu na sposób utworzenia pliku. Nie wprowadzaj spacji ani tabulatorów pomiędzy przecinkiem lub średnikiem a kolejną wartością. Każdy plik musi zostać zakodowany w formacie UTF-8 i używać nowych wierszy systemu Unix (\n). 

Jeśli pole opcjonalne person_number lub sis_username jest częścią formatu zarządzanego konta Apple ID, staje się polem wymaganym. Pozostawienie tego pola pustego spowoduje niepowodzenie przesyłania z błędem MANAGED_ID_GENERATION_FAILED.

Plik lokalizacje

location_id Unikalny identyfikator utworzony z cyfr i (lub liter) niezawierający spacji. Wymagany
location_name Nazwa lokalizacji.  Wymagany

Musisz zdefiniować co najmniej jedną lokalizację w pliku lokalizacje (locations.csv). Nie możesz używać SFTP do tworzenia kont uczniów lub personelu w lokalizacji „siedziba główna”.

Plik uczniowie

Jeśli użyjesz protokołu SFTP do przesłania nowej osoby, a przydzielony identyfikator person_id już istnieje w portalu Apple School Manager, nowa osoba zastąpi istniejącego użytkownika w portalu Apple School Manager. Po zastąpieniu możesz uaktualniać dodanego użytkownika wyłącznie za pomocą protokołu SFTP. 

 

person_id

Unikalny identyfikator danego ucznia. Identyfikator person_id tej osoby musi się zgadzać z unikalnym identyfikatorem w systemie SIS, o ile jest dostępny. Identyfikator person_id jest unikalnym identyfikatorem ucznia w portalu Apple School Manager. Użyj tej wartości, aby odnieść się do ucznia w pliku uczniowie (rosters.csv) oraz do prowadzących w pliku klasy (classes.csv). 

Wymagany
person_number Inna wartość, która może identyfikować ucznia w szkole. Może to być numer identyfikacyjny ucznia.  Opcjonalny
first_name Imię ucznia. Wymagany
middle_name Drugie imię ucznia. Opcjonalny
last_name Nazwisko ucznia. Wymagany
grade_level Klasa ucznia. Opcjonalny
email_address* Adres e-mail ucznia. Opcjonalny
sis_username Nazwa użytkownika dla ucznia w systemie SIS.  Opcjonalny
password_policy Pole password_policy umożliwia określenie zasad tworzenia haseł dla każdego konkretnego ucznia. Pole password_policy musi zawierać cyfrę 4, 6 lub 8 albo może zostać puste. Jeśli wybierzesz 8 będą to standardowe zasady tworzenia haseł (co najmniej 8 znaków alfanumerycznych). Ta wartość zastępuje zasady tworzenia haseł dla lokalizacji i wszelkie zasady tworzenia haseł ustawione wcześniej dla tego ucznia. Jeśli pole password_policy pozostanie puste, do nowych uczniów są stosowane domyślne zasady tworzenia haseł dla lokalizacji, a do istniejących uczniów nie są wprowadzane żadne zmiany. Opcjonalny
location_id Identyfikator location_id ucznia. Musi on odpowiadać identyfikatorowi location_id w pliku lokalizacje (locations.csv). Jeśli ten wpis nie zgadza się z wpisem w pliku lokalizacje, wystąpią problemy z przesyłaniem. Wymagany

* Jeśli włączone jest uwierzytelnianie federacyjne, wymagany jest adres e-mail. Jeśli adres e-mail znajduje się w domenie federacyjnej, konto użytkownika będzie federacyjne.

Przypisywanie wielu lokalizacji

Do ucznia można przypisać więcej niż jedną lokalizację, dodając kolumny lokalizacji w pliku uczniowie. Możesz dodać maksymalnie 998 kolumn lokalizacji, o nazwach location_id_2, location_id_3 itd. — aż do location_id_999. W każdej z utworzonych kolumn można opcjonalnie dodać kolejny identyfikator location_id dla dowolnego ucznia. Musi on odpowiadać identyfikatorowi location_id w pliku lokalizacje (locations.csv). Jeśli ten wpis nie zgadza się z wpisem w pliku lokalizacje, wystąpią problemy z przesyłaniem.

Plik personel

Jeśli użyjesz protokołu SFTP do przesłania nowej osoby, a przydzielony identyfikator person_id już istnieje w portalu Apple School Manager, nowa osoba zastąpi istniejącego użytkownika w portalu Apple School Manager. Po zastąpieniu możesz uaktualniać dodanego użytkownika wyłącznie za pomocą protokołu SFTP. Cały personel obowiązują standardowe zasady tworzenia haseł (co najmniej 8 znaków alfanumerycznych).

person_id

Unikalny identyfikator danego członka personelu. Identyfikator person_id tej osoby musi się zgadzać z unikalnym identyfikatorem w systemie SIS, o ile jest dostępny. Identyfikator person_id jest unikalnym identyfikatorem członka personelu w portalu Apple School Manager. Użyj tej wartości, aby odnieść się do prowadzących w pliku klasy (classes.csv). 

Wymagany
person_number Inna wartość, która może identyfikować członka personelu w szkole. Może to być numer karty identyfikacyjnej członka personelu.  Opcjonalny
first_name Imię członka personelu. Wymagany
middle_name Drugie imię członka personelu. Opcjonalny
last_name Nazwisko członka personelu. Wymagany
email_address* Adres e-mail członka personelu.  Opcjonalny
sis_username Nazwa użytkownika dla członka personelu w systemie SIS. Opcjonalny
location_id Identyfikator location_id członka personelu. Powinien odpowiadać identyfikatorowi location_id w pliku lokalizacje (locations.csv). Jeśli ten wpis nie zgadza się z wpisem w pliku lokalizacje, wystąpią problemy z przesyłaniem. Wymagany

* Jeśli włączone jest uwierzytelnianie federacyjne, wymagany jest adres e-mail. Jeśli adres e-mail znajduje się w domenie federacyjnej, konto użytkownika będzie federacyjne.

Przypisywanie wielu lokalizacji

Do pracownika można przypisać więcej niż jedną lokalizację, dodając kolumny lokalizacji w pliku personel. Możesz dodać maksymalnie 14 998 kolumn lokalizacji, o nazwach location_id_2, location_id_3 itd. — aż do location_id_999. W każdej z utworzonych kolumn można opcjonalnie dodać kolejny identyfikator location_id dla dowolnego członka personelu. Musi on odpowiadać identyfikatorowi location_id w pliku lokalizacje (locations.csv). Jeśli ten wpis nie zgadza się z wpisem w pliku lokalizacje, wystąpią problemy z przesyłaniem.

Plik kursy

course_id Unikalny identyfikator kursu. Musi się zgadzać z odpowiadającym mu identyfikatorem course_id używanym w pliku klasy (classes.csv).   Wymagany
course_number Numer kursu. Ten numer może być numerem kursu w systemie SIS lub przewodniku programowym. Opcjonalny
course_name Nazwa kursu. Opcjonalny
location_id Identyfikator location_id kursu. Powinien odpowiadać identyfikatorowi location_id w pliku lokalizacje (locations.csv). Jeśli ten wpis nie zgadza się z wpisem w pliku lokalizacje, wystąpią problemy z przesyłaniem.
Wymagany

Plik klasy

class_id Unikalny identyfikator klasy.    Wymagany
class_number Numer lub kod identyfikujący tę klasę w danej instytucji. W odróżnieniu od identyfikatora class_id, identyfikator class_number nie jest używany do odnoszenia się do tej klasy w pliku CSV lista uczniów (rosters.csv).  Opcjonalny
course_id Identyfikator course_id kursu, który obejmuje tę klasę. Musi się zgadzać z identyfikatorem course_id w pliku kursy (courses.csv). Wymagany
instructor_id Identyfikator person_id prowadzącego. Musi się on zgadzać z identyfikatorem person_id używanym w pliku personel (staff.csv). Opcjonalny
instructor_id_2 Identyfikator person_id prowadzącego. Musi się on zgadzać z identyfikatorem person_id używanym w pliku personel (staff.csv). Opcjonalny
instructor_id_3 Identyfikator person_id prowadzącego. Musi się on zgadzać z identyfikatorem person_id używanym w pliku personel (staff.csv). Opcjonalny
location_id Identyfikator location_id klasy. Powinien odpowiadać identyfikatorowi location_id w pliku lokalizacje (locations.csv). Jeśli ten wpis nie zgadza się z wpisem w pliku lokalizacje, wystąpią problemy z przesyłaniem. Wymagany

Przypisywanie wielu prowadzących

Do klasy można przypisać więcej niż trzech prowadzących, dodając kolejne kolumny w pliku klasy. Możesz dodać maksymalnie 12 kolumn prowadzących, o nazwach instructor_id_4, instructor_id_5 itd. — aż do instructor_id_15. W przypadku każdej klasy można opcjonalnie dodać kolejny identyfikator person_id prowadzącego. Musi się on zgadzać z identyfikatorem person_id używanym w pliku personel (staff.csv).

Plik lista uczniów

roster_id Unikalny identyfikator dla listy uczniów w systemie SIS lub innej bazie danych kursów (jeśli jest dostępna).  Wymagany
class_id Unikalny identyfikator alfanumeryczny klasy. Musi się zgadzać z identyfikatorem class_id w pliku klasa (classes.csv).
Wymagany
student_id Identyfikator student_id dla jednego ucznia.  Wymagany

Plik listy uczniów (rosters.csv) służy do dodawania uczniów do ich klasy. Każdy wiersz w pliku musi mieć unikalny identyfikator roster_id i zawierać wyłącznie jeden identyfikator class_id i jeden identyfikator person_id.

Uaktualnianie plików

Jeśli chcesz dodać lub edytować uczniów, personel i klasy, zmodyfikuj pliki danych i prześlij nowe kopie. Za każdym razem, gdy przesyłasz pliki, musisz przesłać wszystkie sześć plików, a każdy plik musi zawierać kompletną listę z każdej kategorii, a nie tylko elementy, które chcesz dodać. Możesz sprawdzić informacje o koncie SFTP, wybierając kolejno opcje Ustawienia > Źródło danych.

Jeśli przypadkowo rozłączysz połączenie SFTP z portalem Apple School Manager, konta zostaną zmienione na ręczne i dezaktywowane. Aby rozwiązać ten problem, przywróć połączenie SFTP i wykonaj nową przesyłkę, aby ponownie aktywować konta bez tworzenia duplikatów.

Po pierwszym przesłaniu nowe konta i klasy będą tworzone automatycznie przy każdym przesłaniu. Jeśli wystąpią błędy, portal Apple School Manager prześle Ci wiadomość e-mail.

Jeśli brakuje wpisu z poprzedniej przesyłki

Jeśli brakuje wpisu z poprzedniej przesyłki, jego źródło zostanie zmienione na Ręczne w usłudze Apple School Manager. Dodatkowe konsekwencje usunięcia mogą się różnić. Jeśli z przesyłki zostaną usunięci studenci lub personel, ich konta zostaną dezaktywowane i automatycznie usunięte po 30 dniach, chyba że za ich pomocą zostanie kupiona zawartość w Programie zakupów grupowych.

Jeśli usunięto kurs lub klasę

Jeśli z przesyłki usunięto kurs lub klasę, studenci zostaną usunięci z klasy, a źródło zostanie zmienione na Ręczne. Jeśli kursy były używane w usłudze iTunes U albo aplikacji Zadane, lista uczestników zostanie usunięta. W celu ponownej rejestracji należy utworzyć nowy kurs. Jeśli zajęcia były używane przez aplikację Zadane, postępy uczestników zostaną automatycznie usunięte i nie będą już dostępne dla ucznia oraz nauczyciela.

Kursy i klasy ze źródłem ręcznym będą nadal synchronizowane z rozwiązaniem MDM, ale mogą nie wyświetlać się już w aplikacji Klasa. Klasy ręczne można usunąć w usłudze Apple School Manager, jeśli nie chcesz ich synchronizować.

Informacje o produktach niewytworzonych przez Apple lub o niezależnych witrynach internetowych, których Apple nie kontroluje ani nie testuje, są udostępniane bez żadnej rekomendacji ani poparcia. Apple nie ponosi żadnej odpowiedzialności za wybór, działanie lub wykorzystanie takich witryn lub produktów innych firm. Apple nie składa żadnych oświadczeń dotyczących dokładności lub wiarygodności witryn internetowych innych firm. Ryzyko jest wpisane w korzystanie z Internetu. Skontaktuj się z dostawcą, aby uzyskać więcej informacji. Pozostałe nazwy firm i produktów mogą być znakami towarowymi odpowiednich podmiotów.

Data publikacji: