Exemples d'utilisateurs de Snapshot Flat File

Les exemples suivants illustrent la composition des flux de données utilisateur (PERSON) et correspondent à un grand nombre de cas d'utilisation. Ces exemples utilisent le flux de données le plus simple possible. Dans certains cas, des informations supplémentaires peuvent être exigées par votre établissement : l'ajout des en-têtes et des données requis au flux de données permet de satisfaire à ces besoins. L'analyse des exigences et de la planification du système d'information et des bureaux d'enregistrement de votre établissement vous aidera à déterminer la profondeur des données nécessaires pour remplir correctement Blackboard et atteindre vos objectifs en matière de données et de cycle de vie.

Utilisateurs

Les données utilisateur constituent le principal ensemble d'informations qui décrit les personnes ayant accès à Blackboard, leur rôle au sein de votre établissement et leur rôle au sein du système Blackboard. Dans le contexte des objets USER de données SIS, on parle souvent de « PERSON », ce qui se répercute dans les normes existantes. Avant la plupart de ces normes, Blackboard utilisait les termes « PERSONNE » et « UTILISATEUR » pour désigner les enregistrements relatifs aux utilisateurs en fonction du contexte. Les exemples suivants utilisent « PERSON » pour faire référence à l'enregistrement et « USER » pour faire référence à la personne.

Gestion des données Snapshot Flat File

Le système d'informations pour les étudiants Framework prend en charge le téléchargement de flux de données Snapshot Flat File via une interface utilisateur et via un ensemble d'URL fournies par le système Blackboard.

Accédez aux informations HTTP et téléchargez le fichier de flux à l'aide du menu d'intégration de l'interface utilisateur d'intégration des systèmes d'informations sur les étudiants de l'intégration de données d'administrateur système.

Dans les deux cas, le comportement de l'opération de données est piloté par la configuration de l'intégration et le type d'opération sélectionné. Le type d'opération de données sélectionné contrôle la façon dont les données du flux sont « interprétées » et chaque URL fournira des résultats différents pour répondre aux objectifs de votre intégration.

Les données peuvent être fournies à Blackboard, puis mises à jour, supprimées ou modifiées par la suite. Par conséquent, vous pouvez commencer avec l'ensemble de données le plus simple et l'enrichir à mesure que les exigences en matière de données de votre établissement évoluent.

Les opérations suivantes sont disponibles via l'interface utilisateur et HTTP.

Les objets associés aux opérations PERSON sont les suivants :

Les exemples fournis sont illustrés à l'aide de la fonctionnalité de chargement du fichier de source de données de l'interface utilisateur du cadre d'instantané. Pour automatiser ou utiliser les opérations de ligne de commande ou de programmation, voir Snapshot Flat File Automation.

Rappel concernant les clés de source de données

Tous les objets de données permettent de modifier la clé de source de données pour le regroupement de cet ensemble de données et peuvent être utilisés pour modifier la source de données associée. Remarque : ce champ n'est pas obligatoire dans les flux de données basés sur Framework et, sauf indication contraire, les exemples ci-dessous supposent que l'intégration est configurée pour utiliser une source de données unique.

Pour en savoir plus, consultez la section Gestion des clés des sources de données.

Remarque sur le mappage des champs

Le mappage des champs permet de modifier les données entrantes avant qu'elles ne soient stockées dans Blackboard. Cela vous permet d'avoir un contrôle total sur les données stockées et de respecter les règles spécifiques de Blackboard lorsque les données système d'informations pour les étudiants qui vous sont fournies sont insuffisantes, telles que la création de mots de passe utilisateur. Lorsqu'il est appliqué à un champ d'objet Utilisateur, le script associé est exécuté par utilisateur, modifiant ou fournissant les données avant qu'elles ne soient stockées dans Blackboard. Une explication complète du mappage de champs pour Snapshot Flat File est fournie dans Snapshot Flat File Field Mapping.

Remarque sur les mots de passe

Les mots de passe sont obligatoires pour se connecter à Blackboard, mais ce n'est pas un champ obligatoire dans les flux de données PERSON. Si aucun mot de passe n'est fourni dans la source de données, un mot de passe SHA512 aléatoire est généré et stocké dans la base de données Blackboard. Cela ne pose aucun problème si vous utilisez une authentification externe (telle que LDAP), mais que se passe-t-il si vous utilisez la base de données Blackboard pour stocker les mots de passe de connexion des utilisateurs ? Vous devez fournir le mot de passe lors de la création de l'utilisateur, car sinon il ne pourra pas se connecter.

Si vous exécutez un flux et définissez le mot de passe d'un utilisateur qui change de mot de passe par la suite, la connexion est rompue. Lors d'une opération de mise à jour, vous pouvez choisir de ne pas mettre à jour le champ du mot de passe. Cela permettra à Blackboard de retenir le mot de passe actuel lors de la mise à jour. Si vous ne sélectionnez pas cette option, le mot de passe sera modifié et l'utilisateur devra être averti de la modification.

Exemples d'opération de personne

À un niveau avancé, vous pouvez appliquez les trois modèles de flux de données d'intégration SIS à toutes les opérations de données User et la sélection du modèle dépend des données que vous pouvez fournir.

Enfin, et il ne s'agit pas d'un modèle de flux système d'informations pour les étudiants, mais il convient de le mentionner, vous pouvez également désactiver et supprimer en fonction de DSK uniquement à l'aide de l'outil de gestion des sources de données disponible dans l'interface utilisateur. Vous devez être très prudent lorsque vous gérez vos données SIS fournies de cette manière. Ceci est extrêmement utile lors de la suppression de données qui n'ont jamais été ou ne sont plus fournies via le système d'informations pour les étudiants, telles que les données résultant d'opérations de test.

Juste l'essentiel : les personnes

Tous les comptes utilisateur nécessitent un ensemble d'informations de base pour établir un compte. Cet ensemble d'informations est détaillé dans Snapshot Flat File Data Format et Snapshot Flat File Header.

Données en bref

L'ensemble de données ou les en-têtes minimaux requis pour créer un compte utilisateur dans Blackboard sont les suivants :

Le cadre SIS, selon la configuration d'intégration, fournit des valeurs par défaut pour les champs non obligatoires ou les ignore. Les champs EMAIL et SYSTEM_ROLE ne sont pas obligatoires, mais utiles pour les flux de PERSON. L'adresse e-mail est requise pour correspondre et envoyer des notifications par e-mail aux utilisateurs de Blackboard par e-mail Blackboard. Vous devriez donc envisager de fournir ces données dans votre flux. SYSTEM_ROLE est par défaut configuré sur NONE (aucun).

Ajout d'informations de personne

Il existe deux cas d'ajout d'informations sur la personne. La première consiste à stocker (STORE) des informations de personne (PERSON) de manière additive, ce qui entraîne l'ajout ou la mise à jour d'enregistrements, comme indiqué dans le flux de données. La seconde consiste à actualiser les informations relatives aux personnes déjà présentes dans Blackboard, ce qui entraîne l'ajout de nouveaux enregistrements ou la mise à jour d'enregistrements existants tels qu'ils sont présentés dans le fichier de données, tout en désactivant les enregistrements existants qui ne sont pas présents dans le fichier de données.

Exemples d'opération de stockage

Exemple #1 : Création de comptes personnels

Vous souhaitez ajouter des utilisateurs à Blackboard sans affecter les comptes existants. Votre intégration est configurée pour utiliser la même source de données pour toutes les données entrantes.

Prérequis

aucun.

Exigences minimales en matière de flux de données

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME

Solution

Créez un fichier de données PERSONS.txt contenant les en-têtes requis et les données associées par personne que vous souhaitez ajouter au système. Par exemple :

Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données PERSON à l'aide de l'opération STORE. Le compte utilisateur sera créé et vous pourrez vous connecter en tant qu'utilisateur.

État postérieur

Les enregistrements PERSON pour aanderson_test, bbrown_test, e gcarlin_test sont créés.

Exemple #2 : Mettre à jour les comptes utilisateurs

Vous avez créé des comptes d'utilisateur et devez les modifier. Par exemple, l'exemple précédent n'incluait aucune adresse e-mail d'utilisateur. Vous avez l'adresse e-mail de aanderson_test.

Prérequis

Aucune : les mises à jour seront effectuées sur les enregistrements créés précédemment, les données incluses lorsqu'un enregistrement n'existe pas dans Blackboard entraîneront la création de l'enregistrement.

Solution

Créez un fichier de données PERSONS.txt contenant les en-têtes requis et les données associées par personne que vous souhaitez ajouter au système. Par exemple :

Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données PERSON à l'aide de l'opération STORE. Le compte utilisateur sera mis à jour.

État postérieur

L'enregistrement PERSON pour aanderson_test est mis à jour pour inclure l'adresse e-mail fournie.

Les enregistrements PERSON pour bbrown_test and gcarlin_test ne sont pas affectés.

Personne : opération de rafraîchissement complète

COMPLETE REFRESH ne fonctionne pas de la même manière que STORE. COMPLETE REFRESH effectue deux opérations qui équivalent à une comparaison entre les données du fichier de flux et les enregistrements de Blackboard appartenant à l'intégration : le stockage de nouveaux enregistrements, la mise à jour des enregistrements existants ou la désactivation des enregistrements dans Blackboard qui ne figurent pas dans le fichier de données.

Exemple : actualisation complète

Les données fournies par votre système d'informations pour les étudiants contiennent un aperçu complet des personnes qui devraient avoir accès à Blackboard. Ces données contiennent des dossiers personnels à ajouter, des dossiers personnels à mettre à jour et des enregistrements qui ont été supprimés depuis les précédentes opérations COMPLETE REFRESH qui doivent être gérés de manière appropriée par configuration (désactiver ou supprimer).

Prérequis

aucun.

Exigences minimales en matière de flux de données

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME

Solution

Utilisation des données de notre dernière opération de stockage et suppression de gcarlin_test du flux de données :

État postérieur

L'enregistrement PERSON pour aanderson_test est conservé et n'est pas affecté.

L'enregistrement PERSON pour bbrown_test est conservé et mis à jour pour inclure l'adresse e-mail fournie.

L'enregistrement PERSON pour gcarlin_test est marqué comme étant désactivé ou prêt pour la purge selon la configuration d'intégration.

Personne : actualisation complète par opération de la source de données

L'opération d'actualisation complète par source de données (COMPLETE REFRESH BY DATA SOURCE) effectue une opération COMPLETE REFRESH mais restreint les données affectées uniquement à ce qui est associé à la source de données de l'intégration.

Exemple : actualisation complète par source de données

Les données fournies par votre système d'informations pour les étudiants contiennent un aperçu complet des personnes qui devraient avoir accès à Blackboard. Ces données contiennent des dossiers personnels à ajouter, des dossiers personnels à mettre à jour et des enregistrements qui ont été supprimés depuis les opérations REFRESH précédentes qui doivent être gérés de manière appropriée par configuration (désactiver ou supprimer). En outre, toutes les données de cette actualisation sont ciblées à l'aide de la même source de données que celle définie dans l'intégration et SEULES les données liées à cette clé de source de données seront affectées.

Prérequis

aucun.

Exigences minimales en matière de flux de données

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME

Solution

Utilisation des données de notre dernière opération de stockage et suppression de gcarlin_test du flux de données :

État postérieur

L'enregistrement PERSON pour aanderson_test est conservé et n'est pas affecté.

L'enregistrement PERSON pour bbrown_test est conservé et mis à jour pour inclure l'adresse e-mail fournie.

L'enregistrement PERSON précédemment créé pour gcarlin_test est marqué comme étant désactivé ou prêt pour la purge selon la configuration d'intégration.

Si d'autres dossiers personnels sont gérés par cette intégration, ils ne seront PAS désactivés ou supprimés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration.

disponibilité du compte de personne

Le paramètre de disponibilité du compte PERSON permet à un compte Blackboard de se connecter (disponible) ou non (indisponible). Notez que ce n'est pas la même chose que de désactiver un compte, ce qui rend non seulement le compte invisible, mais le rend également indisponible pour d'autres opérations telles que la gestion des adhésions. L'ajout de cet en-tête de flux des données n'a pas d'impact sur l'utilisation des opérations STORE, COMPLETE REFRESH, COMPLETE REFRESH BY DATA SOURCE décrite ci-dessus pour la création des enregistrements PERSON.

Exemple : disponibilité du compte personnel

Votre système d'informations pour les étudiants contrôle la disponibilité d'accès à Blackboard pour les utilisateurs, et votre flux de données indique si les utilisateurs ont accès individuellement à Blackboard. L'accès de chaque utilisateur peut être modifié à l'aide du paramètre de création/mise à jour de l'objet PERSON.

Prérequis

aucun.

Exigences minimales en matière de flux de données

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
AVAILABILE_IND

Solution

Ajouter l'en-tête AVAILABLE_IND à votre flux de données et spécifier le caractère unique Y pour disponible et N pour non disponible.

État postérieur

STORE (STOCKER)

Seuls les enregistrements PERSON pour aanderson_test, bbrown_test, e gcarlin_test sont mis à jour (ils avaient été créés précédemment) tandis que ddarling_test est créé.

COMPLETE REFRESH (actualisation complète)

Les enregistrements PERSON pour aanderson_test, bbrown_test, e gcarlin_test sont mis à jour (ils avaient été créés précédemment) tandis que ddarling_test est créé. Tous les autres enregistrements seront désactivés ou marqués pour suppression en raison de leur absence dans le flux de données ci-dessus.

COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)

Les enregistrements PERSON pour aanderson_test, bbrown_test, e gcarlin_test sont mis à jour (ils avaient été créés précédemment) tandis que ddarling_test est créé.

Si d'autres dossiers personnels sont gérés par cette intégration, ils ne seront PAS désactivés ou supprimés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration. L'opération d'actualisation complète par source de données (COMPLETE REFRESH BY DATA SOURCE) ne s'applique que sur les enregistrements de la source de données d'intégration.

désactivation des enregistrements de personne

La désactivation d'un dossier personnel dans Blackboard le rend inaccessible à des fins de connexion (l'état désactivé remplace le paramètre de disponibilité) et rend également le dossier personnel inaccessible pour les opérations de l'interface utilisateur. Par exemple, vous ne pouvez pas ajouter un enregistrement PERSON désactivé à un cours via l'interface utilisateur. En outre, pour supprimer un enregistrement de Blackboard, cet enregistrement doit d'abord être désactivé.

La désactivation des enregistrements peut suivre deux modèles : la désactivation via l'exclusion des données de flux lors des opérations REFRESH, et la désactivation via l'en-tête de flux ROW_STATUS.

Les opérations PERSON ci-dessus, qui utilisent des opérations REFRESH, démontrent la désactivation par exclusion, le cas et l'exemple ci-après illustrent l'utilisation de ROW_STATUS.

Exemple : Désactivation des dossiers personnels

Les étudiants obtiennent leur diplôme ou ne sont plus tenus d'avoir accès à Blackboard. Vous devez supprimer complètement leur accès et leur présence dans Blackboard (au lieu de rendre l'enregistrement indisponible qui restreint uniquement la connexion). Si vous utilisez des opérations STORE, vous devez désactiver explicitement les utilisateurs à l'aide de l'en-tête ROW_STATUS. Cela est également utile dans les opérations manuelles excédant la portée des flux SIS.

Prérequis

Les enregistrements ciblés existent dans le système Blackboard.

Exigences minimales en matière de flux de données

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
ROW_STATUS

Solution

Ajoutez l'en-tête ROW_STATUS à votre flux de données et spécifiez ENABLED pour activé et DISABLED pour désactivé.

État postérieur

STORE (STOCKER)

Seuls les enregistrements PERSON pour aanderson_test, bbrown_test, gcarlin_test, e ddarling_test sont créés ou mis à jour lorsque le ROW_STATUS est explicitement mis à jour.

COMPLETE REFRESH (actualisation complète)

Les enregistrements PERSON pour aanderson_test, bbrown_test, gcarlin_testet ddarling_test sont créés ou mis à jour ; tous les autres enregistrements seront désactivés ou marqués pour suppression en raison de leur absence dans le flux de données ci-dessus.

COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)

Seuls les enregistrements PERSON pour aanderson_test, bbrown_test, gcarlin_test, e ddarling_test sont créés ou mis à jour lorsque le ROW_STATUS est explicitement mis à jour.

Si d'autres dossiers personnels sont gérés par cette intégration, ils ne seront PAS désactivés ou supprimés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration. L'opération d'actualisation complète par source de données (COMPLETE REFRESH BY DATA SOURCE) ne s'applique que sur les enregistrements de la source de données d'intégration.

Gestion des rôles secondaires d'utilisateur dans l'établissement

Comme vous disposez d'une licence Community, vous avez accès à des rôles supplémentaires que vous pouvez attribuer aux utilisateurs. Ils sont utiles pour gérer l'accès aux supports et aux onglets du portail Community.

La gestion des rôles secondaires est une activité distincte de la création ou de la mise à jour des utilisateurs, elle n'entre donc pas dans le cadre de la création/mise à jour du flux de données PERSON.

Exemple : ajout de rôles d'utilisateur et d'établissement secondaire

Vous devez fournir un contenu de portail spécifique aux étudiants et au corps enseignant de l'école d'ingénierie.

Prérequis

Vous avez créé un nouveau rôle institutionnel à l'aide de l'interface utilisateur de l'administrateur système (voir...) nommé « ENGINEERING_STUDENT ».

Exigences minimales en matière de flux de données

EXTERNAL_PERSON_KEY
ROLE_ID

Solution

Créez un flux de rôle d'établissement Institutional_Role contenant les enregistrements à créer/mettre à jour.

Comme pour les autres objets de données, vous pouvez également fournir le ROW_STATUS pour activer ou désactiver l'accès d'une personne au contenu associé au rôle secondaire. Par exemple :

État postérieur

STORE (STOCKER)

Seuls les enregistrements du rôle de l'établissement secondaire pour aanderson_test, bbrown_test, gcarlin_test et d sont créés ou mis à jour avec le rôle de l'établissement secondaire.

COMPLETE REFRESH (actualisation complète)

Les enregistrements du rôle de l'établissement secondaire pour aanderson_test, bbrown_test, gcarlin_test et d sont créés ou mis à jour ; tous les autres enregistrements seront désactivés ou marqués pour suppression en raison de leur absence dans le flux de données ci-dessus.

COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)

Les enregistrements de rôle dans l'établissement secondaire pour aanderson_test, bbrown_test, gcarlin_test et d sont créés ou mis à jour.

Si d'autres dossiers personnels sont gérés par cette intégration, ils ne seront PAS désactivés ou supprimés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration. L'opération d'actualisation complète par source de données (COMPLETE REFRESH BY DATA SOURCE) ne s'applique que sur les enregistrements de la source de données d'intégration.

Observateurs

Les observateurs sont des utilisateurs particuliers dont le compte est lié à un autre compte utilisateur remplissant un rôle de supervision ou d'observation. L'observateur peut se connecter et voir l'activité et les cours de l'utilisateur associé.

Un compte observateur nécessite les mêmes informations qu'un utilisateur pour créer un compte et possède une couche supplémentaire de « gestion des associations d'utilisateurs » dans laquelle l'observateur est associé à un compte utilisateur en liant les external_person_keys des deux comptes.

Le compte de l'observateur est créé exactement comme vous créeriez un compte utilisateur conformément aux exigences de traitement des données de votre établissement.

Exemple #1 : Création d'une association d'observateurs

Vous souhaitez associer un étudiant au compte de son parent (ou d'un autre utilisateur approprié) afin que son activité puisse être contrôlée.

Prérequis

Vous avez créé un étudiant identifié par external_person_key (test_student_100 dans cet exemple) et un observateur identifié par external_person_key (test_student_100_observer et test_student_200_observer dans cet exemple).

Exigences minimales en matière de données

La clé_personnelle externe de l'observateur : EXTERNAL_OBSERVER_KEY

Clé personnelle externe de l'étudiant observé : EXTERNAL_USER_KEY

Solution

Créer un fichier de données contenant l'external_person_key de l'observateur et la clé de personne externe de l'étudiant.

Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données d'association d'observateur (Observer Association Data Type) à l'aide de l'opération Store. L'association sera créée et vous pourrez vous connecter en tant qu'observateur et afficher l'activité de cours de l'étudiant.

Exemple #2 : Mise à jour d'un enregistrement d'association d'observateurs

Vous devez modifier une association.

Prérequis

Vous avez créé une association entre test_student_200_observer et test_student_100, mais le compte étudiant associé doit être test_student_200.

Solution

Créer un fichier contenant la révision.

Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données Observateur Association à l'aide de l'opération Store

État postérieur

L'association sera mise à jour et vous pourrez vous connecter en tant qu'observateur et afficher l'activité de cours du bon étudiant.

Exemple #3 : Désactiver les enregistrements d'association d'observateurs

Une association d'observateur n'est plus nécessaire et vous souhaitez la désactiver.

Prérequis

Vous avez créé des associations entre des étudiants et des observateurs.

Solution

(En utilisant les données utilisées dans ce thème d'exemple)

Vous avez déjà créé des associations à l'aide de la méthode Stocker et du fichier suivant :

Il existe deux modèles liés au flux de données qui permettent de désactiver une association d'observateur à sélectionner selon vos besoins :

Désactivation d'un sous-ensemble d'associations d'observateurs

Pour désactiver un sous-ensemble de données, vous devez créer un flux d'association et le charger via l'opération de suppression Delete. Par exemple :

pour supprimer l'association entre test_student_100_observer|test_student_100 dans l'ensemble de données de travail, vous devez créer un fichier de flux contenant les éléments suivants et le télécharger à l'aide de l'opération Delete :

Désactivation d'un sous-ensemble d'associations d'observateurs lors du stockage d'associations nouvelles/existantes

Pour désactiver un sous-ensemble de données qui autorise également la mise à jour des associations existantes ou le stockage de nouvelles associations, vous devez créer un fichier d'association qui contient des associations existantes et nouvelles, et supprimer celles que vous souhaitez désactiver et télécharger à l'aide de l'opération d'actualisation complète Complete Refresh. Par exemple, en utilisant l'ensemble de travail composé de :

Nous voulons désactiver l'association test_student_200_observer|test_student_200 de sorte que le fichier ne contienne que l'association test_student_100_observer|test_student_100. Si nous souhaitions également ajouter deux nouvelles associations (à la condition préalable que les comptes utilisateur ait été précédemment créés), nous aurions téléchargé le contenu suivant :

État postérieur

L'enregistrement pour test_étudiant_200_observer|test_étudiant_200 est désactivé.

En savoir plus