Informations sur les modèles pour l’importation d’enregistrements dans Apple School Manager
Apple fournit six modèles que vous pouvez utiliser pour ajouter des données à votre site :
Étudiants : contient les informations relatives aux comptes des étudiants.
Personnel : contient les informations relatives aux comptes des membres du personnel, notamment les enseignants.
Cours : définit les cours.
Classes : contient les informations relatives aux cours et aux enseignants (membres du personnel).
Listes : contient les informations relatives aux classes, aux étudiants et aux sites.
Sites : contient les informations relatives aux sites.
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 sera désactivé et automatiquement supprimé au bout de 120 jours, à moins que le compte n’ait acheté du contenu en volume.
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.
Champ | Modèles | Limite de caractères |
|---|---|---|
first_name | Étudiants, Personnel | 32 |
middle_name | Étudiants, Personnel | 32 |
last_name | Étudiants, Personnel | 64 |
grade_level | Étudiants | 64 |
email_address | Étudiants | 256 |
person_number | Étudiants, Personnel | 64 |
person_id | Étudiants, Personnel, Classes, Listes | 256 |
sis_username | Étudiants, Personnel | 256 |
class_id | Classes, Listes | 256 |
class_number | Classes | 64 |
course_id | Cours, Classes | 256 |
course_name | Cours | 128 |
course_number | Cours | 64 |
location_name | Sites | 256 |
location_id | Étudiants, Personnel, Cours, Classes, Sites | 256 |