Renseignements sur les modèles pour l’importation de données dans Apple School Manager
Pour ajouter des données à Apple School Manager, vous pouvez utiliser des fichiers au format Apple ou OneRoster.
Noms des modèles .csv d’Apple : Étudiants, Personnel, Cours, Classes, Listes, Sites
Noms des modèles .csv de OneRoster : Utilisateurs, Cours, Classes, Inscriptions, Organisations
Nom de fichier Apple | Nom de fichier OneRoster | Contenu | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple : contient les renseignements des comptes des étudiants. OneRoster : contient les renseignements des comptes des étudiants, des enseignants et du personnel. | |||||||||||
S.O. | Contient les renseignements des comptes du personnel, comme les enseignants. | ||||||||||
Contient les renseignements sur les cours. | |||||||||||
Contient les renseignements sur les classes et l’enseignant (personnel). | |||||||||||
Contient les renseignements sur la classe, l’étudiant et le site (liste). | |||||||||||
Contient les renseignements sur le site (école et département). | |||||||||||
Modèles et comptes Apple gérés
Si un champ facultatif, tel que person_number ou sis_username, fait partie de votre format de compte Apple géré, il devient un champ obligatoire. Si vous laissez ce champ vide, le téléversement SFTP échoue et l’erreur MANAGED_ID_GENERATION_FAILED s’affiche.
Préparer des modèles
Lorsque vous préparez un modèle, il est important de respecter les critères suivants :
Structure
Les noms des fichiers .csv doivent correspondre exactement au nom du fichier original.
Ne modifiez pas le contenu des en-têtes de rangées des fichiers.
Ne supprimez pas une colonne, même si elle est vide.
Vous pouvez ajouter des colonnes aux modèles d’étudiants, d’employés, et de classes.
Dans les modèles, chaque rangée doit correspondre à une valeur unique. Par exemple, dans le modèle de fichier étudiants.csv, chaque rangée doit correspondre à un seul étudiant.
Pour les modèles CSV Étudiants et Employés, la valeur person_id (identifiant personnel), unique à chaque utilisateur, ne doit pas changer d’un site à l’autre.
Important : Si vous utilisez le protocole SFTP pour téléverser un nouvel utilisateur, et que le paramètre person_id associé est déjà attribué à un autre utilisateur, le nouvel utilisateur remplace l’utilisateur existant dans Apple School Manager. Une fois le remplacement effectué, vous pouvez mettre à jour l’utilisateur que par protocole SFTP.
Certaines valeurs peuvent être vides. Par exemple, dans le fichier étudiants.csv, le deuxième prénom peut être vide.
Remplacez les données de l’exemple par les vôtres.
Formater
Les valeurs littérales, par exemple un saut de ligne ou un guillemet anglais à l’intérieur d’un nom, doivent être marquées par une barre oblique inverse (\). En voici un exemple : \". Les identifiants entrés doivent être alphanumériques et peuvent inclure un trait d’union (-).
Si la valeur entrée contient une espace ( ) ou une virgule (,), entourez-la par des guillemets anglais droits ("). Si la valeur ne contient pas ces caractères spéciaux, n’utilisez pas de guillemets. Si vous n’utilisez pas de guillemets là où ils sont nécessaires, ou si vous utilisez des guillemets courbés, vous recevrez des messages d’erreur durant le processus de téléversement.
Dans vos fichiers, les valeurs doivent être séparées par des virgules (,) ou des points-virgules (;), indépendamment de la manière dont vous avez créé le fichier. N’utilisez pas d’espaces ou de tabulations entre une virgule ou un point-virgule et la valeur suivante. Chaque fichier doit être encodé en UTF-8. Pour représenter la fin d’une ligne, utilisez l’encodage de nouvelle ligne UNIX \n.
Toutes les références aux clés étrangères d’autres fichiers CSV doivent être définies dans le fichier référencé.
Transfert du fichier
Si une entrée d’un téléversement précédent est manquante, le compte utilisateur est désactivé et supprimé automatiquement après 120 jours, sauf si :
L’utilisateur a un rôle qui a acheté des applications ou des livres en grande quantité
L’utilisateur est supprimé manuellement avant la limite de 120 jours
Tous les fichiers doivent être compressés dans un fichier d’archives (fichier ZIP) pour être téléversés.
Aucun fichier ne peut être placé à l’intérieur d’un dossier dans le fichier d’archives compressé.
Limites de caractères dans les modèles CSV
Certains champs des modèles CSV comportent une limite de caractères.
Nom de l’attribut | Modèle | 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 : courriel | 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 |