Format de fichier CSV SDS V1
Importante
CLIENTS DE TRANSITION SDS (classique) : tous les champs ne sont pas pris en charge pour intégrer des données dans la nouvelle expérience SDS basée sur le format v1. Vous les trouverez notés dans le format de fichier CSV SDS v1 sous la colonne Obligatoire ? en tant que données non prises en charge.
Importante
En outre, les valeurs de note et de sujet de cours passées doivent être alignées sur leurs codes de liste de valeurs (ENUM) correspondants. Si nécessaire, utilisez Managing List of Values pour développer Les valeurs De note et Objet du cours pour prendre en charge les valeurs de code non prises en charge par défaut.
Vous pouvez utiliser des fichiers CSV (valeurs séparées par des virgules) au format SDS V1 pour synchroniser votre système d’information scolaire (SIS) avec Office 365. L’utilisation du format de fichier CSV SDS V1 pour ingérer les catégories de données ci-dessous vous permet d’activer les fonctionnalités principales de SDS pour l’approvisionnement. Il vous permet également d’améliorer les expériences des produits et fonctionnalités Microsoft 365.
Si vous utilisez le format SDS V1, les fichiers doivent être correctement mis en forme. Chargez les fichiers, nommés exactement comme indiqué ci-dessous. Les en-têtes de colonne respectent la casse. Les fichiers CSV doivent être au format UTF-8 et conformes RFC. De plus, nous n’acceptons pas les sauts de ligne dans les données entrantes. Pour passer en revue et télécharger l’exemple d’ensemble de fichiers CSV SDS V1, consultez le référentiel GitHub SDS.
Importante
Après le chargement initial lors de la création de votre flux entrant, vous devez toujours fournir le même ensemble de fichiers pour les chargements suivants, indépendamment des modifications apportées aux données dans les fichiers facultatifs ou non. Si ce n’est pas le cas, le système détermine que les enregistrements ne sont plus actifs et les marque comme tels.
Obligatoire : les trois fichiers répertoriés ci-dessous doivent être sélectionnés pour que vous puissiez progresser. Si vous gérez uniquement les utilisateurs et non les classes, vous devez uniquement fournir ces fichiers.
school.csv
student.csv
teacher.csv
Facultatif / Obligatoire : non obligatoire si vous gérez uniquement les utilisateurs. Si vous gérez également des classes et des inscriptions de classes, vous devez fournir les trois fichiers répertoriés ci-dessous, ainsi que les trois fichiers ci-dessus. Si ce n’est pas le cas, ne sélectionnez aucun fichier portant ces noms.
section.csv
studentenrollment.csv
teacherroster.csv
Facultatif : ceux-ci ne sont pas obligatoires pour continuer, mais peuvent améliorer les expériences. Si l’un des fichiers ci-dessous est sélectionné, l’autre doit également être sélectionné pour continuer.
user.csv
guardianrelationship.csv (Nécessite l’enregistrement utilisateur et étudiant pour créer l’association de contacts.)
Chaque fichier CSV doit contenir des données pour les champs indiqués « Oui » sous « Obligatoire », les champs notés « Non » sont des données « Facultatifs ». Les en-têtes de champ marqués comme « Obligatoire » doivent exister dans les fichiers fournis, sinon ils ne seront pas acceptés. Les en-têtes de champ marqués comme « Facultatif » ne doivent pas nécessairement être présents dans les fichiers si les données facultatives correspondantes ne sont pas passées.
Les champs avec des valeurs énumérées définies comme marquées dans la colonne « Types de données » ont un ensemble spécifique de valeurs qu’ils prennent en charge. L’ensemble de valeurs par défaut pris en charge pour les champs Enum consultez Liste de valeurs par défaut.
school.csv
| Field | Obligatoire ? | Exemple | Type de données |
|---|---|---|---|
| SIS ID | Oui | 456789 | Unique ID |
| Nom | Oui | Contoso High School | String |
| School NCES_ID | Non | 456789 | String |
| School Number | données non prises en charge | ||
| Grade Low | données non prises en charge | ||
| Grade High | données non prises en charge | ||
| State ID | données non prises en charge | ||
| Principal SIS ID | données non prises en charge | ||
| Nom principal | données non prises en charge | ||
| Principal Secondary Email | données non prises en charge | ||
| Address | données non prises en charge | ||
| Ville | données non prises en charge | ||
| État | données non prises en charge | ||
| ZIP | données non prises en charge | ||
| Pays | données non prises en charge | ||
| Phone | données non prises en charge | ||
| Zone | données non prises en charge |
- Toutes les organisations répertoriées seront définies sur le organization type « school ».
student.csv
| Field | Obligatoire ? | Exemple | Type de données |
|---|---|---|---|
| SIS ID | Oui | 123456 | Unique ID |
| ID SIS de l’établissement scolaire | Oui | 456789 | Unique ID |
| Nom d’utilisateur | Oui | jsmith@contoso.edu | String |
| Prénom | Oui (uniquement si vous créez des utilisateurs) | Noël | String |
| Nom | Oui (uniquement si vous créez des utilisateurs) | Lopez | String |
| Deuxième prénom | Non | William | String |
| Secondary Email | Non | jsmith@contoso.edu | |
| Student Number | Non | 123456 | String |
| Grade | Non | 8 | Énum |
| Birthdate | Non | 2009-12-19 | Date |
| Statut | données non prises en charge | ||
| Mot de passe | données non prises en charge | ||
| Graduation Year | données non prises en charge | ||
| State ID | données non prises en charge |
- Nécessite une référence à l’établissement scolaire associé à l’aide du champ « School SIS ID ». Cela produit une dépendance sur le fichier school.csv.
- Tous les utilisateurs répertoriés seront définis sur le type de rôle « student ».
- Attendez-vous à ce que les valeurs de date soient fournies au format ISO8601.
- Les zéros « 0 » non significatifs manquants sur la valeur entrante pour l’ENUM de niveau de grade, par exemple « 1 », correspondent à la liste de valeurs définie (ENUM) « 01 » et sont stockés sous la forme « 01 ».
teacher.csv
| Field | Obligatoire ? | Exemple | Type de données |
|---|---|---|---|
| SIS ID | Oui | 654321 | Unique ID |
| ID SIS de l’établissement scolaire | Oui | 456789 | Unique ID |
| Nom d’utilisateur | Oui | jcook@contoso.edu | String |
| Prénom | Oui (uniquement si vous créez des utilisateurs) | Jane | String |
| Nom | Oui (uniquement si vous créez des utilisateurs) | Cuire | String |
| Deuxième prénom | Non | Meredith | String |
| Teacher Number | Non | 654321 | String |
| Grade | Non | 8 | Énum |
| Secondary Email | Non | jcook@contoso.edu | |
| Statut | données non prises en charge | ||
| Mot de passe | données non prises en charge | ||
| Titre | données non prises en charge | ||
| State ID | données non prises en charge | ||
| Qualification | données non prises en charge |
- Nécessite une référence à l’établissement scolaire associé à l’aide du champ « School SIS ID ». Cela produit une dépendance sur le fichier school.csv.
- Tous les utilisateurs répertoriés seront définis sur le type de rôle « enseignant ».
- Les zéros « 0 » non significatifs manquants sur la valeur entrante pour l’ENUM de niveau de grade, par exemple « 1 », correspondent à la liste de valeurs définie (ENUM) « 01 » et sont stockés sous la forme « 01 ».
section.csv
| Field | Obligatoire ? | Exemple | Type de données |
|---|---|---|---|
| SIS ID | Oui | 334455 | Unique ID |
| ID SIS de l’établissement scolaire | Oui | 456789 | Unique ID |
| Nom de la section | Oui | Période 1 - Histoire du monde | String |
| Section Number | Non | 334466 | String |
| Course SIS ID | Non | 123456789 | Unique ID |
| Course Name | Non | Histoire du monde 10 | String |
| Course Number | Non | 123456789 | String |
| Course Description | Non | Histoire du monde | String |
| Course Subject | Non | 54999 | Énum |
| Term SIS ID | données non prises en charge | ||
| Term Name | données non prises en charge | ||
| Term StartDate | données non prises en charge | ||
| Term EndDate | données non prises en charge | ||
| Statut | données non prises en charge | ||
| Periods | données non prises en charge |
- Nécessite une référence à l’établissement scolaire associé à l’aide du champ « School SIS ID ». Cela produit une dépendance sur le fichier school.csv.
- Si des informations sur le terme sont nécessaires, vous devez passer au format CSV SDS v2.1 et fournir également academicSessions.csv fichier.
studentenrollment.csv
| Field | Obligatoire ? | Exemple | Type de données |
|---|---|---|---|
| Section SIS ID | Oui | 334455 | Unique ID |
| SIS ID | Oui | 123456 | Unique ID |
- Cela nécessite une référence à la section associée à l’aide du champ « ID SIS de section ». Cela produit une dépendance sur le fichier section.csv.
- Cela nécessite une référence à l’utilisateur associé à l’aide du champ « ID SIS ». Cela produit une dépendance sur le fichier student.csv.
teacherroster.csv
| Field | Obligatoire ? | Exemple | Type de données |
|---|---|---|---|
| Section SIS ID | Oui | 334455 | Unique ID |
| SIS ID | Oui | 654321 | Unique ID |
- Cela nécessite une référence à la section associée à l’aide du champ « ID SIS de section ». Cela produit une dépendance sur le fichier section.csv.
- Cela nécessite une référence à l’utilisateur associé à l’aide du champ « ID SIS ». Cela produit une dépendance sur le fichier teacher.csv.
user.csv
| Field | Obligatoire ? | Exemple | Type de données |
|---|---|---|---|
| Oui | jsmith@outlook.com | ||
| Prénom | Oui | Noël | String |
| Nom | Oui | Lopez | String |
| Phone | Non | +1234567890 | Phone |
| SIS ID | Non | P_123456 | Unique ID |
- Si vous synchronisez également les relations de contact (tuteurs), vous devez inclure un enregistrement pour celles-ci dans le user.csv.
- Attendez-vous à ce que le champ téléphone soit mis en forme en fonction de la norme E.164 où le caractère plus est utilisé et réussi par le numéro de téléphone, ou plutôt par le caractère plus suivi de l’indicatif du pays, de l’indicatif régional, du préfixe téléphonique et du numéro de ligne.
guardianrelationship.csv
| Field | Obligatoire ? | Exemple | Type de données |
|---|---|---|---|
| SIS ID | Oui | 123456 | Unique ID |
| Oui | jsmith@outlook.com | ||
| Role | Non | Parent | Énum |
- Si vous synchronisez également les relations de contact (tuteurs), vous devez inclure un enregistrement pour celles-ci dans le user.csv.
- Cela nécessite une référence à l’utilisateur associé à l’aide du champ « Email ». Cela produit une dépendance sur le fichier user.csv.
- Cela nécessite une référence à l’utilisateur associé à l’aide du champ « ID SIS ». Cela produit une dépendance sur le fichier student.csv.
- Si la valeur de rôle n’est pas fournie, la valeur par défaut de la relation est « userContact ».