Informations sur les modèles pour l’importation de données dans Apple School Manager
Pour ajouter des données dans Apple School Manager, vous pouvez utiliser les modèles de fichiers .csv formatés par Apple ou par OneRoster.
Noms des modèles .csv Apple : Étudiants, Personnel, Cours, Classes, Sites
Noms des modèles .csv OneRoster : Utilisateurs, Cours, Classes, Inscriptions, Organisations
Nom de fichier Apple | Nom de fichier OneRoster | Contenu | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple : contient des informations sur les comptes des étudiants. OneRoster : contient des informations sur les comptes des étudiants, des enseignants et des membres du personnel. | |||||||||||
N/D | Contient des informations sur les comptes des membres du personnel, comme les enseignants. | ||||||||||
Contient des informations sur les cours. | |||||||||||
Contient des informations sur les classes et les enseignants (membres du personnel). | |||||||||||
Contient des informations sur les classes, les étudiants et les sites (listes). | |||||||||||
Contient des informations sur les sites (écoles ou services) | |||||||||||
Modèles et identifiants Apple gérés
Si votre identifiant Apple géré contient un champ facultatif dans son format, comme person_number ou sis_username, alors celui-ci deviendra obligatoire. Si vous le laissez vierge, le chargement de SFTP ne sera pas effectué et affichera l’erreur MANAGED_ID_GENERATION_FAILED.
Préparer les modèles
Pour préparer un modèle, les critères suivants doivent être respectés :
Pour les modèles students.csv et staff.csv, la valeur person_id doit être unique pour tous les sites.
Important : Si vous utilisez SFTP pour charger un nouvel utilisateur et si vous lui attribuez une valeur person_id déjà utilisée, le nouvel utilisateur remplace l’ancien dans Apple School Manager. Une fois l’opération terminée, seul le nouvel utilisateur pourra être mis à jour via SFTP.
Si vous modifiez les modèles, remplacez les données fournies en exemple par vos propres données. Ne modifiez pas le contenu de la ligne d’en-tête dans les fichiers. Ne dupliquez pas les colonnes des fichiers. Vous pouvez ajouter des colonnes aux modèles que vous voulez.
Dans chaque modèle, les lignes doivent représenter une valeur unique. Par exemple, dans le fichier students.csv, chaque ligne doit représenter un étudiant unique. Pour cet étudiant, certains champs de renseignements peuvent rester vides. Les valeurs littérales (par exemple, un saut de ligne ou un guillemet dans un nom) doivent être signalées par une barre oblique inversée (\). Voici un exemple : \". Les identifiants saisis doivent être alphanumériques et peuvent contenir un tiret (-).
Si votre valeur contient un espace ( ) ou une virgule (,), entourez-la de guillemets droits ("). Si votre valeur ne contient aucun de ces caractères spéciaux, il est inutile d’utiliser les guillemets. Si vous oubliez d’insérer des guillemets ou si vous utilisez des guillemets courbes au lieu des guillemets droits, vous obtiendrez des erreurs lors du processus de chargement.
Les valeurs de votre fichier doivent être séparées par des virgules (,) ou des points-virgules (;), quelle que soit la façon dont vous avez créé le fichier. N’utilisez pas d’espace ni de tabulation entre une virgule ou un point-virgule et la valeur suivante. Chaque fichier doit être encodé en UTF-8. Pour représenter la fin de ligne, utilisez le code UNIX \n.
S’il manque une entrée présente dans un précédent chargement, le compte utilisateur sera désactivé et automatiquement supprimé au bout de 120 jours, sauf dans les cas suivants :
L’utilisateur a un rôle qui a acheté des apps ou des livres en volume.
L’utilisateur est supprimé manuellement avant l’échéance des 120 jours.
Les noms des fichiers .csv doivent correspondre exactement au nom du fichier d’origine.
Tous les fichiers doivent être compressés en fichier d’archive zippé (.zip) pour leur téléchargement.
Aucun fichier ne doit être placé à l’intérieur d’un dossier dans le fichier d’archive zippé.
Toutes les références de clé étrangère à d’autres fichiers .csv doivent être définies dans le fichier référencé.
Limites de caractères dans les modèles .csv
Certains champs des modèles .csv comportent une limite de caractères.
Nom d’attribut | Modèles | Limite de caractères |
|---|---|---|
Apple : first_name OneRoster : givenName | Apple : Étudiants, Personnel OneRoster : Utilisateurs | 32 |
Apple : middle_name OneRoster : middleName | Apple : Étudiants, Personnel OneRoster : Utilisateurs | 32 |
Apple : last_name OneRoster : familyName | Apple : Étudiants, Personnel OneRoster : Utilisateurs | 64 |
Apple : grade_level OneRoster : grades | Apple : Étudiants OneRoster : Utilisateurs | 64 |
Apple : email_address OneRoster : email | Apple : Étudiants OneRoster : Utilisateurs | 256 |
Apple : person_number OneRoster : identifier | Apple : Étudiants, Personnel OneRoster : Utilisateurs | 64 |
Apple : person_id OneRoster : sourcedId | Apple : Étudiants, Personnel, Classes, Listes OneRoster : Utilisateurs, Classes, Inscriptions | 256 |
Apple : sis_username OneRoster : username | Apple : Étudiants, Personnel OneRoster : Utilisateurs | 256 |
Apple : class_id OneRoster : sourcedID | Apple : Classes, Listes OneRoster : Classes, Inscriptions | 256 |
Apple : class_number OneRoster : classCode | Apple : Étudiants, Classes OneRoster : Classes | 64 |
Apple : course_id OneRoster : sourcedID | Apple : Cours, Classes OneRoster : Cours, Classes | 256 |
Apple : course_name OneRoster : title | Apple : Cours OneRoster : Cours | 128 |
Apple : course_number OneRoster : courseCode | Apple : Cours OneRoster : Cours | 64 |
Apple : location_name OneRoster : name | Apple : Sites OneRoster : Organisations | 256 |
Apple : location_id OneRoster : sourcedID | Apple : Étudiants, Personnel, Cours, Classes, Sites OneRoster : Utilisateurs, Cours, Classes, Organisations | 256 |