Renseignements sur les modèles pour l’importation d’enregistrements dans Apple School Manager
Apple propose six modèles à utiliser pour ajouter des données à votre site:
Étudiants : contient les renseignements des comptes des étudiants.
Employés : contient les renseignements des comptes des employés, comme les instructeurs.
Cours : définit les cours.
Classes : contient les renseignements sur les cours et les instructeurs (employés).
Listes : contient les renseignements sur la classe, les étudiants et le site.
Sites : contient les renseignements du site.
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 antérieur est absente, le compte sera désactivé et automatiquement supprimé après 120 jours, à moins que le compte n’achète du contenu en grande quantité.
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.
Champ | Modèle | Limite de caractères |
---|---|---|
first_name | Étudiants, Employés | 32 |
middle_name | Étudiants, Employés | 32 |
last_name | Étudiants, Employés | 64 |
grade_level | Étudiants | 64 |
email_address | Étudiants | 256 |
person_number | Étudiants, Employés | 64 |
person_id | Étudiants, Employés, Classes, Listes | 256 |
sis_username | Étudiants, Employés | 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, Employés, Cours, Classes, Sites | 256 |