![](https://help.apple.com/assets/661DA8E484CAC7D29D0A29D4/661DA8E74EAB261820082179/fr_CA/027012655ffa60501a6b40df04cf18a2.png)
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). |
![Mappage de zone des noms de champs et renseignements requis.](https://help.apple.com/assets/661DA8E484CAC7D29D0A29D4/661DA8E74EAB261820082179/fr_CA/0b691a33224ebbc082e8ce78301f1bea.png)
Modèles et identifiants Apple gérés
Si un champ facultatif, tel que person_number ou sis_username, fait partie de votre format d’identifiant 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 :
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 uniquement mettre à jour l’utilisateur par protocole SFTP.
Si vous modifiez les modèles, remplacez les exemples de données par les vôtres. Ne modifiez pas le contenu des en-têtes de rangées des fichiers. Ne dupliquez pas les colonnes des fichiers. Vous pouvez ajouter des colonnes à des modèles spécifiques.
Dans les modèles, chaque rangée doit correspondre à une valeur unique. Par exemple, dans le modèle de fichier CSV pour étudiants, chaque rangée doit correspondre à un seul étudiant. Certains champs peuvent être vides. 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.
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.
Les noms des fichiers CSV doivent correspondre exactement au nom du fichier original.
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é.
Toutes les références aux clés étrangères 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 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 |