Ensembles de données Brightspace pour Discussions

Les ensembles de données Brightspace pour Discussions comprennent :

Ces jeux de données dépendent de Discussions. Si vous activez puis désactivez cet outil lors de la période d'interrogation de l'ensemble de données, vos ensembles de données pourraient afficher du contenu inattendu ou présenter des lacunes.

Diagramme des relations entre entités

Pour afficher les relations entre les entités utilisées pour créer les ensembles de données Brightspace pour l'outil Discussions, cliquez sur la vignette suivante :

Diagramme des relations entre entités pour l’outil Discussions

Ensembles de données Brightspace : Articles de discussion

À propos de l'ensemble

Renvoie les articles de discussion publiés au cours des trois dernières années civiles. Les résultats apparaissent en ordre décroissant de date. L'ensemble de données Publications de discussion est limité à 3 ans de données, soit toutes les données des deux années civiles précédentes et celle du calendrier actuel à ce jour.

Disponibilité des ensembles de données

Cet ensemble de données est disponible comme :

  • CSV complet produit sur une base hebdomadaire, contenant toutes les données.
  • CSV différentiel, produit sur une base quotidienne ou une base horaire en tant qu'outil complémentaire payant, contenant les différences dans les données qui ont été mises à jour ou ajoutées depuis la génération réussie du dernier rapport différentiel, soit généralement au cours du dernier jour ou de la dernière heure, selon le cas.

Remarque : Vous pouvez extraire le corps de la discussion publié dans l'API.

Champs renvoyés

Historique de version

Champ

Description

Type

Taille de colonne

Clé

1.0

OrgUnitId

Identifiant unique de l'unité organisationnelle

int

4

FK

2.5/3.0 – Ajout de FK

TopicId

Identifiant unique du sujet

bigint

8

FK

1.0

UserId

Identifiant unique de l'utilisateur

int

4

FK

1.0

PostId

Identifiant unique de l'article

bigint

8

PK

1.0

ThreadId

Identifiant unique du fil

bigint

8

 

1.0

IsReply

Indique si le message est une réponse

bit

1

 

1.0

ParentPostId

ID du message primaire.

La valeur de ce champ peut être nulle.

bigint

8

FK

1.0

NumReplies

Nombre de réponses à un message

int

4

 

1.0

DatePosted

Date de diffusion du message (UTC).

datetime2

8

 

1.0

IsDeleted

Indique si le message est supprimé

bit

1

 

1.0

RatingSum

Somme de toutes les cotes pour le message

bigint

8

 

1.0

NumRatings

Nombre de cotes pour le message

bigint

8

 

4.8/5.2 – Taille de la colonne mise à jour

Score

Notes des utilisateurs pour le message (s'il est noté).

La valeur de ce champ peut être nulle.

décimal

19, 9

 

2.2 LastEditDate

Indique la date à laquelle la publication de la discussion a été modifiée (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
2.2 SortOrder Affiche l'ordre de tri utilisé pour les objets de contenu int 4  
2.5/3.0 Depth Indique le nombre de niveaux hiérarchiques imbriqués dans l'article de discussion. int 4  
3.7/4.2 Thread

Nom du fil de discussion.

La valeur de ce champ peut être nulle.

nvarchar 400  
5.6 WordCount

Indique le nombre de mots que contient l'article de discussion.

La valeur de ce champ peut être nulle.

int 4  
5.6 AttachmentCount

Indique le nombre de pièces jointes associées à l'article de discussion.

La valeur de ce champ peut être nulle.

int 4  

 

Ensembles de données Brightspace : État des articles de discussion lus

À propos de l'ensemble

Renvoie les détails des articles de discussion créés par les utilisateurs pour vos unités organisationnelles. L'ensemble de données État de lecture des articles de discussion est limité à 3 ans de données, soit toutes les données des deux années civiles précédentes et celle du calendrier actuel à ce jour.

Disponibilité des ensembles de données

Cet ensemble de données est disponible comme :

  • CSV complet produit sur une base hebdomadaire, contenant toutes les données.
  • CSV différentiel, produit sur une base quotidienne ou une base horaire en tant qu'outil complémentaire payant, contenant les différences dans les données qui ont été mises à jour ou ajoutées depuis la génération réussie du dernier rapport différentiel, soit généralement au cours du dernier jour ou de la dernière heure, selon le cas.

Champs renvoyés

Historique de version

Champ

Description

Type

Taille de colonne

Clé

1.0

TopicId

Identifiant unique du sujet

bigint

8

FK

1.0

UserId

Identifiant unique de l'utilisateur

int

4

PK, FK

1.0

PostId

Identifiant unique de l'article

bigint

8

PK, FK

1.0

IsRead

Indique si l'article a été lu

bit

1

 

1.0

FirstReadDate

Date de la première lecture de l'article (UTC).

La valeur de ce champ peut être nulle.

datetime2

8

 

1.0

LastReadDate

Date de la plus récente lecture de l'article (UTC).

La valeur de ce champ peut être nulle.

datetime2

8

 

6,7 Version Indique la version de la rangée. Ces informations servent à déterminer quelle rangée de la table est survenue en premier, de façon similaire à la fonction d'horodatage des autres ensembles de données. bigint 8  

 

Ensembles de données Brightspace : Notes d'utilisateur aux sujets de discussion

À propos de l'ensemble

Renvoie les notes reçues par un utilisateur pour un sujet de discussion.

Disponibilité des ensembles de données

Cet ensemble de données est disponible comme :

  • CSV complet produit sur une base hebdomadaire, contenant toutes les données.
  • CSV différentiel, produit sur une base quotidienne ou une base horaire en tant qu'outil complémentaire payant, contenant les différences dans les données qui ont été mises à jour ou ajoutées depuis la génération réussie du dernier rapport différentiel, soit généralement au cours du dernier jour ou de la dernière heure, selon le cas.

Champs renvoyés

Historique de version

Champ

Description

Type

Taille de colonne

Clé

1.0

UserId

Identifiant unique de l'utilisateur

int

4

PK, FK

1.0

TopicId

Identifiant unique du sujet

bigint

8

PK,

FK

4.8/5.2 – Taille de la colonne mise à jour

Score

Note du sujet.

La valeur de ce champ peut être nulle.

décimal

19, 9

 

1.0

IsGraded

Indique si le sujet a été noté

bit

1

 

4.6/5.0 Version Indique la version de la rangée. Ces informations servent à déterminer quelle rangée de la table est survenue en premier, de façon similaire à la fonction d'horodatage des autres ensembles de données. bigint 8  

 

Ensembles de données Brightspace : Forums de discussions

À propos de l'ensemble

Renvoie les forums. Les résultats apparaissent en ordre décroissant de date.

Disponibilité des ensembles de données

Cet ensemble de données est disponible comme :

  • CSV complet produit sur une base hebdomadaire, contenant toutes les données.
  • CSV différentiel, produit sur une base quotidienne ou une base horaire en tant qu'outil complémentaire payant, contenant les différences dans les données qui ont été mises à jour ou ajoutées depuis la génération réussie du dernier rapport différentiel, soit généralement au cours du dernier jour ou de la dernière heure, selon le cas.

Champs renvoyés

Historique de version

Champ

Description

Type

Taille de colonne

Clé

2.3

OrgUnitId

Identifiant unique de l'unité organisationnelle.

int

4

FK

2.3

ForumId

Identifiant unique du forum.

bigint

8

PK
5.7/6.0 – Taille de colonne mise à jour Name Nom du sujet de discussion. nvarchar 400  
2.4 – Mise à jour Description

Description du forum.

La valeur de ce champ peut être nulle.

nvarchar 1000  
7.0 – Retrait VisibleStartDate

Première date de visibilité du forum pour les élèves (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
7.0 – Retrait VisibleEndDate

Dernière date de visibilité du forum pour les élèves (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
7.0 – Retrait PostingStartDate

Première date de publication possible par les élèves sur le forum (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
7.0 – Retrait PostingEndDate

Dernière date de publication possible par les élèves sur le forum (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
2.3 MustPostToParticipate Indique qu'un utilisateur doit publier sur le forum pour pouvoir participer à un fil de discussion. bit

1

 
2.3 AllowAnon Indique si la publication anonyme est autorisée pour le forum. bit

1

 
2.3 IsHidden Indique si le forum est masqué. bit

1

 
2.3 RequiresApproval Indique que le forum nécessite l'approbation d'un modérateur avant que les contributions ne soient publiées. bit

1

 
2.3 SortOrder Affiche l'ordre de tri utilisé pour les objets de contenu int 4  
2.3

IsDeleted

Indique si le sujet de discussion est supprimé.

La valeur de ce champ peut être nulle.

bit

1

 

2.3

DeletedDate

Date de suppression du forum (UTC).

La valeur de ce champ peut être nulle.

datetime2

8

 

2.3

DeletedByUserId

Utilisateur responsable de la suppression du forum.

La valeur de ce champ peut être nulle.

int

4

FK

4.9/5.3 ResultId

Identifiant unique de résultat de condition de diffusion.

La valeur de ce champ peut être nulle.

int 4 FK
6.12/7.0 − Ajout StartDate

Première date de publication possible par les élèves sur le forum (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
6.12/7.0 − Ajout StartDateAvailabilityType Avant la date de début, ce type détermine si les élèves peuvent visualiser les sujets de discussion du forum ou y avoir accès. smallint 2  
6.12/7.0 − Ajout EndDate Dernière date de publication possible par les élèves sur le forum (UTC). datetime2 8  
6.12/7.0 − Ajout EndDateAvailabilityType Après la date de fin, ce type détermine si les élèves peuvent visualiser les sujets de discussion du forum ou y avoir accès. smallint 2  

 

Ensembles de données Brightspace : Sujets de discussion

À propos de l'ensemble

Renvoie les sujets de discussion. Les résultats apparaissent en ordre décroissant de date.

Disponibilité des ensembles de données

Cet ensemble de données est disponible comme :

  • CSV complet produit sur une base hebdomadaire, contenant toutes les données.
  • CSV différentiel, produit sur une base quotidienne ou une base horaire en tant qu'outil complémentaire payant, contenant les différences dans les données qui ont été mises à jour ou ajoutées depuis la génération réussie du dernier rapport différentiel, soit généralement au cours du dernier jour ou de la dernière heure, selon le cas.

Champs renvoyés

Historique de version

Champ

Description

Type

Taille de colonne

Clé

2.3

OrgUnitId

Identifiant unique de l'unité organisationnelle.

int

4

FK

2.3

TopicId

Identifiant unique du sujet.

bigint

8

PK
2.3 ForumId Identifiant unique du forum.

bigint

8

FK
2.4 Name Nom du sujet de discussion. nvarchar 1000  
2.4 Description

Description du sujet de discussion.

La valeur de ce champ peut être nulle.

nvarchar 1000  
7.0 – Retrait VisibleStartDate

Première date de visibilité du sujet de discussion pour les élèves (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
7.0 – Retrait VisibleEndDate

Dernière date de visibilité du sujet de discussion pour les élèves (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
7.0 – Retrait PostingStartDate

Première date de publication possible par les élèves dans le sujet de discussion (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
7.0 – Retrait PostingEndDate

Dernière date de publication possible par les élèves dans le sujet de discussion (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
2.3 MustPostToParticipate Indique qu'un utilisateur doit publier dans le sujet de discussion pour pouvoir participer à un fil de discussion. bit

1

 
2.3 AllowAnon Indique si la publication anonyme est autorisée pour le sujet de discussion. bit

1

 
2.3 IsHidden Indique si le sujet de discussion est masqué. bit

1

 
2.3 RequiresApproval Indique que le sujet de discussion nécessite l'approbation d'un modérateur avant que les contributions au forum ne soient publiées. bit

1

 
2.3 LastPostDate

Indique le moment de la dernière publication dans le sujet de discussion (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
2.3 LastPostUserId

Indique le dernier utilisateur ayant publié dans le sujet de discussion.

La valeur de ce champ peut être nulle.

bigint 8  
2.3

NumViews

Indique le nombre de vues du sujet de discussion.

bigint

8

 

2.3 SortOrder Affiche l'ordre de tri utilisé pour les objets de contenu. int 4  
2.3

IsDeleted

Indique si le sujet de discussion est supprimé.

La valeur de ce champ peut être nulle.

bit

1

 

2.3

DeletedDate

Date de suppression du sujet (UTC).

La valeur de ce champ peut être nulle.

datetime2

8

 

2.3

DeletedByUserId

Utilisateur responsable de la suppression du sujet de discussion.

La valeur de ce champ peut être nulle.

int

4

FK

3.8/4.3 GradeItemId

Identifiant unique de la note.

La valeur de ce champ peut être nulle.

int 4 FK
5.7/6.0 – Taille de colonne mise à jour ScoreOutOf

Note du sujet utilisée pour évaluer le fil de discussion.

La valeur de ce champ peut être nulle.

Remarque : La note peut dépasser la valeur de ScoreOutOf.

Flottant 53  
3.8/4.3 ScoreCalculationMethod Méthode de calcul de note utilisée. Les chaînes sont prédéfinies avec les valeurs suivantes :
Moyenne : Détermine la note en calculant la note moyenne de tous les messages publiés par un utilisateur pour le sujet concerné.
Maximum : Détermine la note en prenant la note la plus élevée attribuée à un message d’un utilisateur parmi tous les messages que ce dernier a publiés pour le sujet concerné.
Minimum : Détermine la note en prenant la note la plus basse attribuée à un message d’un utilisateur parmi tous les messages que ce dernier a publiés pour le sujet concerné.
Note dominante (maximum) : Détermine la note en prenant celle qui revient le plus souvent en fonction du nombre de messages. En cas d'égalité, la note la plus élevée est retenue.
Note dominante (minimum) : Détermine la note en prenant celle qui revient le plus souvent en fonction du nombre de messages. En cas d'égalité, la note la plus basse est retenue.
Somme : Détermine la note en faisant la somme des notes de tous les messages publiés par un utilisateur pour le sujet concerné.
Valeur nulle : La note n’est pas déterminée à partir des notes de chaque message (mises à jour manuelles).
varchar 19  
3.8/4.3 IncludeNonScoredValues Indique s'il faut inclure ou non les messages sans note. Les messages véritables qui n'ont pas reçu de note prennent la valeur zéro (0). Autrement, les messages sans note ne sont pas inclus dans la note globale (option définie par ScoreCalculationType). bit 1  
3.8/4.3 Version Indique la version de la rangée. Ces informations servent à déterminer quelle rangée de la table est survenue en premier, de façon similaire à la fonction d'horodatage des autres ensembles de données. bigint 8  
4.9/5.3 ResultId

Identifiant unique de résultat de condition de diffusion.

La valeur de ce champ peut être nulle.

int 4 FK
6.12/7.0 − Ajout StartDate

Première date de publication possible par les apprenants dans le sujet (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
6.12/7.0 − Ajout StartDateAvailabilityType Avant la date de début, ce type détermine si les élèves peuvent visualiser les sujets de discussion ou y avoir accès. smallint 2  
6.12/7.0 − Ajout EndDate

Dernière date de publication possible par les apprenants dans le sujet (UTC).

La valeur de ce champ peut être nulle.

datetime2 8  
6.12/7.0 − Ajout EndDateAvailabilityType Après la date de fin, ce type détermine si les élèves peuvent visualiser les sujets de discussion ou y avoir accès. smallint 2