Les exemples suivants illustrent la composition des flux de données COURSE et correspondent à un grand nombre de cas d'utilisation. Ces exemples utilisent le flux de données le plus simple qui soit requis pour répondre au cas d'utilisation. Il existe de nombreux autres en-têtes de flux COURSE pour la création d'enregistrements de cours : une analyse des exigences de votre établissement en matière de système d'informations et de registres et une planification permettent de déterminer la profondeur des données nécessaires pour alimenter correctement LEARN afin de remplir vos objectifs de données et de cycle de vie des cours.
Les exemples sont basés sur les paramètres par défaut de Learn qui sont visibles dans l'interface utilisateur de configuration de l'intégration. La modification de ces éléments de configuration entraînera la modification des résultats de l'exemple. Les explications de ces paramètres sont disponibles dans la Présentation du cadre SIS. Par ailleurs, il est supposé, sauf indication contraire, que l'intégration est configurée pour utiliser la même source de données pour toutes les données entrantes.
Cours
Les données de cours sont l'ensemble d'informations principal qui décrit un cours dans Learn. Dans le contexte des objets de COURS de données SIS, on parle souvent de « SECTIONS », ce qui se répercute dans les normes existantes. Étant antérieur à ces nombreuses normes, le fichier plat d'instantané Learn utilise « COURSE » pour faire référence aux enregistrements liés au cours en fonction du contexte.
Opérations
Des données peuvent être fournies pour Learn, puis mises à jour, supprimées ou modifiées. Par conséquent, vous pouvez commencer avec un ensemble de données basique et le compléter à mesure que les exigences en matière de données de votre établissement évoluent.
Le champ immuable d'un enregistrement COURSE est le champ COURSE_ID, ce champ ne peut plus être modifié une fois qu'un enregistrement a été créé. L'enregistrement doit être désactivé et purgé si le COURSE_ID doit être modifié. Cela a des répercussions sur les enregistrements d'activité. Par conséquent, il est fortement recommandé d'utiliser un élément de données qui n'est pas susceptible de changer au cours du cycle de vie du cours.
Gestion des données de fichiers plats d'instantané
Le cadre SIS prend en charge les téléchargements de flux de données de fichier plat d'instantané via un téléchargement d'interface utilisateur et via un ensemble d'URL fourni par le système Learn.
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.
| Opération | Description |
|---|---|
| Stocker | Lors de l'utilisation de ce type d'opération, les données contenues dans le fichier source sont stockées ou mises à jour (selon les paramètres de configuration) dans toutes les sources de données qui sont détenues par l'intégration (consultez la présentation du cadre de système d'informations pour les étudiants pour les questions de « propriété » des données et de source des données). |
| Actualisation complète | Cette opération permet de stocker ou de mettre à jour les données contenues dans le flux de données, tout en désactivant les données qui ne figurent pas dans le flux de données associé à l'intégration dans toutes les sources de données. |
| Supprimer | Cette opération désactive, selon les paramètres d'intégration, les enregistrements contenus dans le flux de données associé à l'intégration dans toutes les sources de données. |
| Actualisation complète par source de données | Introduite dans SP12, cette opération effectue une actualisation complète des données associées UNIQUEMENT à la source de données d'intégration configurée. Cette opération émule plus étroitement le processus d'instantané de ligne de commande pour l'actualisation des données. |
Les objets associés aux opérations COURSE sont les suivants :
| Objet | Opérations |
|---|---|
| Cours | Store, Complete Refresh, Delete, Complete Refresh By Data Source |
| Association de cours | Store, Complete Refresh, Delete, Complete Refresh By Data Source |
| Association standard de cours | Store, Complete Refresh, Delete, Complete Refresh By Data Source |
Les exemples d'association de cours peuvent être trouvés dans la section Exemple de hiérarchie.
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 en savoir plus sur l'automatisation ou l'utilisation d'autres opérations de programmation/ligne de commande, reportez-vous à Automatisation de fichier plat d'instantané.
Rappel concernant les clés de source de données
Tous les objets de données prennent en charge la fonctionnalité de modification de la clé de source de données pour le regroupement de l'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 sources de données basées sur le cadre et sauf indication contraire dans les exemples suivants, l'intégration est configurée pour utiliser une source de données unique.
Dans SP 12, a été introduite une fonctionnalité permettant de spécifier la source de données dans le flux de données séparément de la spécification d'une nouvelle source de données.
Reportez-vous à Gestion des clés de source de données et à la section sur la modification de la source de données d'un enregistrement de cours.
Remarque sur le mappage de champ
Le mappage de champ offre la possibilité de modifier les données entrantes avant de les stocker dans Learn. Cela vous permet d'avoir un contrôle total sur les données stockées et de respecter les règles de Learn spécifiques lorsque les données SIS que vous fournissez sont insuffisantes, par exemple : création d'une entrée de nom de cours appropriée. Lorsqu'il est appliqué à un champ d'objet COURSE, le script associé est exécuté par enregistrement de cours, en modifiant ou en fournissant les données avant qu'elles ne soient stockées dans Learn. Pour en savoir plus sur le mappage des champs, reportez-vous à Mappage de champ personnalisé de fichier plat d'instantané.
Exemples d'opération de cours
À un niveau avancé, vous pouvez identifier les modèles de flux de données d'intégration SIS qui peuvent être appliqués à toutes les opérations de données de cours et la sélection du modèle dépend des données que vous pouvez fournir.
- À l'aide d'un fichier source unique, vous pouvez stocker et mettre à jour les enregistrements (Store) en utilisant un processus distinct pour désactiver (Delete) les enregistrements
- À l'aide d'un fichier source unique, vous pouvez stocker, mettre à jour et désactiver (Complete Refresh) des enregistrements
- Vous pouvez utiliser une combinaison de fichiers, l'un pour stocker, l'autre pour désactiver.
Enfin, il ne s'agit pas d'un modèle de flux de données SIS, mais cela doit être mentionné, vous pouvez également désactiver et purger à partir de DSK seul à l'aide de l'outil 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. Cette option est particulièrement utile lors de la purge des données qui n'ont pas été ou ne sont plus fournies via le SIS ou le résultat des opérations de test.
Notions de base : Cours
Tous les comptes de cours nécessitent un ensemble d'informations de base pour établir un compte. Pour en savoir plus, reportez-vous aux sections Format de données du fichier plat d'instantané et Descriptions des en-têtes de fichiers plats d'instantanés.
Si vous utilisez actuellement les outils batch de l'interface utilisateur, passer au cadre SIS et à l'utilisation des données de cours minimales et des fonctionnalités de téléchargement d'interface utilisateur du cadre SIS vous permet de mieux consigner et rendre compte de vos données téléchargées sans modifier vos processus de collecte de données.
Données en bref
Les ensembles de données et en-têtes requis au minimum pour créer un compte de cours dans Learn comprennent les éléments suivants :
EXTERNAL_COURSE_KEY : identificateur unique pour l'enregistrement de cours.
DATA_SOURCE_KEY : identificateur unique des données définies pour l'enregistrement. Remarque : cette valeur est fournie dans le flux ou via la configuration d'intégration.)
COURSE_ID : le code utilisé comme identificateur d'affichage unique pour le cours. COURSE_NAME : le titre du cours.
La structure SIS pour une configuration d'intégration fournit des valeurs par défaut pour les champs non obligatoires ou les ignore. Deux champs utiles qui ne sont pas obligatoires pour un flux de cours sont AVAILABLE_IND et ROW_STATUS. Ceux-ci seront abordés dans le cas d'utilisation suivant.
Chacun de ces en-têtes est décrit complètement dans Descriptions des en-têtes de fichier plat d'instantané.
Ajout d'informations de cours
Il existe deux cas d'ajout d'informations sur le cours (COURSE). La première consiste à stocker (STORE) les informations de cours (COURSE) 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 (REFRESH) les informations de cours (COURSE) déjà présentes dans Learn, ce qui entraîne l'ajout ou la mise à jour d'enregistrements, comme indiqué dans le fichier de données lors de la désactivation des enregistrements Learn existants qui ne sont pas présents dans le fichier de données COURSE.
Exemples d'opération de stockage
Exemple 1 : créer des cours
Vous souhaitez ajouter des cours à LEARN sans que cela ait d'incidence sur 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 de flux de données
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
Solution
Créez un fichier de données COURSES.txt contenant les en-têtes requis et les données associées par cours que vous souhaitez ajouter au système. Par exemple :
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1
testCourse2|Course.2.1.SP2013|Test Course 2
testCourse3|Course.3.1.FA2013|Test Course 3
Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données COURSE à l'aide de l'opération STORE. Les comptes de cours seront créés et vous pourrez les découvrir via les outils de cours de l'administrateur système.
Postcondition
Les enregistrements COURSE pour Course.1.1.SP2013 , Course.2.1.SP2013 et sont Course.3.1.FA2014 créés.
Exemple 2 : mettre à jour des cours
Vous avez créé des comptes de cours et devez les modifier. Par exemple : l'exemple ci-dessus ne contenait pas la période de cours dans le nom du cours.
Pré-requis
Aucun. Les cours existants seront mis à jour, toutes les nouvelles données de cours dans le flux créeront de nouveaux cours.
Solution
Créez un fichier de données COURS.txt contenant les en-têtes requis et les données associées par cours que vous souhaitez mettre à jour dans le système. Par exemple :
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1 (SP2013)
testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)
Étant donné que STORE n'est appliqué que sur les données contenues dans le fichier, l'enregistrement Course.3.1.FA2013 précédemment validé n'est pas affecté.
Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données COURSE à l'aide de l'opération STORE. Les enregistrements de cours du fichier seront mis à jour.
Postcondition
L'enregistrement COURSE pour Course.1.1.SP2013 et Course.2.1.SP2013 est mis à jour pour inclure la période dans le COURSE_NAME.
L'enregistrement COURSE pour Course.3.1.FA2014 n'est pas affecté.
Cours : Opération d'actualisation complète du cours
COMPLETE REFRESH ne fonctionne pas de la même manière que STORE. COMPLETE REFRESH effectue deux opérations qui correspondent à une comparaison des données dans le fichier source et des enregistrements de LEARN détenues par l'intégration : stockage de nouveaux enregistrements, mise à jour d'enregistrements existants ou désactivation d'enregistrements dans LEARN qui ne sont pas dans le fichier de données.
Exemple : actualisation complète
Les données que votre SIS fournit contiennent un instantané complet des enregistrements COURSE qui doivent exister dans Learn. Ces données contiennent les enregistrements COURSE à ajouter, les enregistrements COURSE à mettre à jour et les enregistrements qui ont été supprimés depuis les opérations COMPLETE REFRESH précédentes, qui sont traités conformément à la configuration (désactivés ou supprimés).
Pré-requis
aucun.
Exigences minimales de flux de données
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
Solution
En commençant par les données de notre première opération de stockage d'enregistrements COURSE, ajout de Course.1.2.SP2013 dans le flux de données et suppression de Course.3.1.FA2013 :
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)
testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)
Notez que si d'autres enregistrements COURSE sont gérés par cette intégration, ils seront désactivés ou purgés en raison de leur absence du flux de données ci-dessus.
Postcondition
L'enregistrement COURSE pour Course.1.1.SP2013 est conservé et mis à jour pour inclure la section dans le COURSE_NAME.
L'enregistrement COURSE pour Course.1.2.SP2013 est ajouté à Learn.
L'enregistrement COURSE pour Course.2.1.SP2013 est conservé et n'est pas affecté.
L'enregistrement COURSE pour Course.3.1.FA2013, comme il est absent du flux de données, est marqué comme étant désactivé ou prêt pour la purge selon la configuration d'intégration.
Cours : actualisation complète par 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 que votre SIS fournit contiennent un instantané complet des enregistrements COURSE qui doivent exister dans Learn. Ces données contiennent les enregistrements COURSE à ajouter, les enregistrements COURSE à mettre à jour et les enregistrements qui ont été supprimés depuis les opérations COMPLETE REFRESH précédentes, qui sont traités conformément à la configuration (désactivés ou supprimés). 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 de flux de données
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
Solution
Utilisation des données de notre dernière opération de stockage et suppression de Course.2.1.SP2013 du flux de données :
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)
Postcondition
Les enregistrements COURSE pour Course.1.1.SP2013 et Course.1.2.SP2013 sont conservés et ne sont pas affectés.
L'enregistrement COURSE pour Course.2.1.SP2013 est marqué comme étant désactivé ou prêt pour la purge selon la configuration d'intégration.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés ou purgés en raison de leur absence du flux de données ci-dessus, à moins qu'ils n'aient la même source de données que celle spécifiée par l'intégration.
Disponibilité des cours
Le paramètre disponibilité des enregistrements COURSE permet de paramétrer un compte dans LEARN pour qu'il soit visible (disponible) ou invisible (indisponible) pour les étudiants. Notez que ce n'est pas la même chose que de désactiver un cours, ce qui rend non seulement le cours invisible à la fois pour les étudiants et les professeurs, mais qui 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écrites ci-dessus pour la création des enregistrements COURSE.
Notez que, par défaut, lorsque le paramètre AVAILABILITY (disponibilité) n'est pas configuré, l'intégration met à disposition l'objet lors des opérations de création/mise à jour.
Exemple : disponibilité du compte du cours
Votre SIS contrôle la disponibilité de l'accès à LEARN et le flux de données indique le paramètre de disponibilité pour chaque utilisateur. Vous souhaitez contrôler ce paramètre d'accès lors de la création/mise à jour de l'objet PERSON.
Pré-requis
aucun.
Exigences minimales de flux de données
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
AVAILABILITY_IND
Solution
Ajoutez l'en-tête AVAILABLE_IND à votre flux de données et spécifiez le caractère unique Y pour disponible et N pour non disponible.
Postcondition
STORE
Seuls les enregistrements COURSE pour Course.1.1.SP2013 et Course.1.2.SP2013 sont mis à jour (ils ont été créés précédemment) et Course.5.1.FA2013 est créé.
COMPLETE REFRESH (actualisation complète)
Les enregistrements COURSE pour Course.1.1.SP2013 et Course.1.2.SP2013 sont mis à jour (ils ont été créés précédemment) et Course.5.1.FA2013 est créé. Tous les autres enregistrements seront désactivés ou marqués pour être purgés en raison de leur absence du flux de données ci-dessus.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Les enregistrements COURSE pour Course.1.1.SP2013 et Course.1.2.SP2013 sont mis à jour (ils ont été créés précédemment) et Course.5.1.FA2013 est créé avec la disponibilité définie explicitement sur Y, ce qui rend les cours disponibles.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés ou purgés en raison de leur absence du flux de données ci-dessus, à moins qu'ils n'aient 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 cours
La désactivation d'un enregistrement COURSE dans Learn le rend inaccessible à tous les utilisateurs (l'état désactivé remplace le paramètre de disponibilité) et rend également l'enregistrement inaccessible pour les opérations de l'interface utilisateur, par exemple : vous ne pouvez pas gérer un enregistrement COURSE désactivé via l'interface utilisateur. De plus, pour purger un enregistrement de Learn, vous devez d'abord désactiver cet enregistrement.
La désactivation d'un enregistrement et sa purge ultérieure supprime toutes les références à cet enregistrement de Learn. Il est recommandé de ne procéder à la purge des enregistrements désactivés qu'au bout d'un certain temps, tel que défini par vos pratiques commerciales et juridiques, qui pourraient sinon nécessiter un enregistrement de l'activité.
La désactivation des enregistrements peut suivre deux modèles : Désactivation via l'exclusion du flux de données d'alimentation lors des opérations REFRESH et désactivation par le biais de l'en-tête ROW_STATUS.
Les opérations COURSE ci-dessus, qui utilisent des opérations d'actualisation, 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 enregistrements de cours
La politique stipule que vous supprimez entièrement les cours de Learn après une période de 5 ans (contrairement à l'option qui rend l'enregistrement indisponible et qui restreint uniquement la visibilité). Si vous utilisez des opérations STORE vous devez désactiver explicitement le cours à l'aide de l'en-tête ROW_STATUS pour purger un cours. Cela est également utile dans les opérations manuelles excédant la portée des flux SIS.
Pré-requis
Le cours existe ou le cours sera créé et row_status est défini comme indiqué dans le flux de données.
Exigences minimales de flux de données
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
ROW_STATUS
Solution
Ajouter l'en-tête ROW_STATUS à votre flux de données et spécifier ENABLED pour activé et DISABLED pour désactivé.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|ROW_STATUS
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|enabled
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|enabled
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|disabled
Postcondition
STORE
Seuls les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour avec le ROW_STATUS explicitement mis à jour.
COMPLETE REFRESH (actualisation complète)
Les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour avec le ROW_STATUS explicitement mis à jour. Tous les autres enregistrements seront désactivés ou marqués pour être purgés en raison de leur absence du flux de données ci-dessus.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour avec le ROW_STATUS explicitement mis à jour.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés ou purgés en raison de leur absence du flux de données ci-dessus, à moins qu'ils n'aient 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.
fusion de cours
La fonction de fusion de cours permet de présenter plusieurs sections d'un cours sous la forme d'un seul cours dans Learn. Elle consiste à fusionner des cours ayant des relations parent-enfant. Le parent est présenté aux utilisateurs comme le cours dans lequel ils sont participants et les sections/cours enfants héritent de leurs adhésions, etc. Les professeurs doivent alors fournir du contenu pour un seul cours et le système Learn entretient un appariement avec le SIS en ce qui concerne les identificateurs de cours, facilitant la communication d'informations liées au cours entre Learn et le SIS.
Exemple : fusion de cours
Le département anglais dispose de quatre cours niveau débutant qui nécessitent plusieurs sections pour respecter le ratio étudiant/professeur souhaité. Ce département souhaite fournir un seul cours pour faciliter le travail des professeurs.
Exigences minimales de flux de données
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
MASTER_COURSE_KEY
Solution
Ajouter l'en-tête ROW_STATUS à votre flux de données et spécifier ENABLED pour activé et DISABLED pour désactivé.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|MASTER_COURSE_KEY
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|testCourse1
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|
Si vous laissez MASTER_COURSE_KEY vide, il n'y a pas de « parent » pour le cours, ou, pour le formuler autrement, le cours n'est pas fusionné avec un cours parent.
Postcondition
STORE
Seuls les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour, établissant une relation parent-enfant entre Course.1.1.SP2013 (parent) et Course.1.2.SP2013.
COMPLETE REFRESH (actualisation complète)
Les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour, établissant une relation parent-enfant entre Course.1.1.SP2013 (parent) et Course.1.2.SP2013. Tous les autres enregistrements seront désactivés ou marqués pour être purgés en raison de leur absence du flux de données ci-dessus.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour, établissant une relation parent-enfant entre Course.1.1.SP2013 (parent) et Course.1.2.SP2013.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés ou purgés en raison de leur absence du flux de données ci-dessus, à moins qu'ils n'aient 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.
Modèle de cours
Les modèles de cours sont utilisés au moment de la création d'un cours pour assurer la cohérence de l'apparence, des carnets de notes, de la structure du contenu, etc. Un cours créé à l'aide d'un modèle est un miroir de ce modèle, à l'exception des paramètres de cours spécifiques qui sont présentés dans le flux de données COURSE. Vous pouvez utiliser n'importe quel cours à cette fin.
Les modèles ne sont utilisés que lors de la création d'un cours. Vous ne pouvez donc pas créer de cours, puis fournir un modèle par le biais d'un flux de mise à jour.
Exemple : Modèle de cours
Le département de mathématiques souhaite que tous les cours de mathématiques aient une apparence similaire au niveau de la mise en page et du contenu de base.
Pré-requis
Un squelette de cours a été créé. Il contient le contenu, la mise en page et les paramètres requis.
Exigences minimales de flux de données
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
TEMPLATE_COURSE_KEY
Solution
Ajouter l'en-tête TEMPLATE_COURSE_KEY à votre flux de données et spécifier l'external_course_key du cours modèle.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|TEMPLATE_COURSE_KEY
testCourse1|Course.6.1.SP2013|Test Course 1.1 (SP2013)|testCourseTemplate.SP2013
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|
Laisser TEMPLATE_COURSE_KEY vide revient à indiquer que le cours ne nécessite pas de modèle.
Postcondition
STORE
Seuls les enregistrements COURSE pour Course.6.1.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour, avec la création de Course.6.1.SP2013 à l'aide du modèle testCourseTemplate.SP2013.
COMPLETE REFRESH (actualisation complète)
Seuls les enregistrements COURSE pour Course.6.1.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour, avec la création de Course.6.1.SP2013 à l'aide du modèle testCourseTemplate.SP2013. Tous les autres enregistrements seront désactivés ou marqués pour être purgés en raison de leur absence du flux de données ci-dessus.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Seul l'enregistrement COURSE pour Course.6.1.SP2013 et Course.5.1.FA2013 est créé ou mis à jour, avec la création de Course.6.1.SP2013 à l'aide du modèle testCourseTemplate.SP2013.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés ou purgés en raison de leur absence du flux de données ci-dessus, à moins qu'ils n'aient 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.
Exemple complet
En combinant les en-têtes ci-dessus dans un seul fichier, nous pouvons aborder la plupart des cas d'utilisation à la fois.
Pré-requis
Pour que l'opération de copie du modèle réussisse, testCourse8 ne doit pas avoir été créé précédemment.
Pour ne pas ralentir le serveur et éviter les files d'attente de tâches de base de données inutiles, seuls deux travaux de copie de cours peuvent être exécutés simultanément dans le cluster.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|AVAILABLE_IND|ROW_STATUS|MASTER_COURSE_KEY|TEMPLATE_COURSE_KEY
testCourse8|Course.8.SP2013|Test Course 8 (SP2013)|Y|ENABLED||testCourseTemplate.SP2013
testCourse8.1|Course.8.1.SP2013|Test Course 8.1 (SP2013)|Y|ENABLED|testCourse8|
testCourse8.2|Course.8.2.SP2013|Test Course 8.2 (SP2013)|Y|ENABLED|testCourse8|
testCourse9.1|Course.9.1.FA2013|Test Course 5.2 (FA2013)|Y|DISABLED||
Postcondition
STORE (STOCKER)
Seuls les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour avec les résultats suivants :
Tous les cours ont une disponibilité définie sur Y, indiquant que les cours sont disponibles.
Course.1.1.SP2013 et Course.1.2.SP2013 sont définis sur ENABLED, tandis que Course.5.1.FA2013 est DISABLED.
Établir une relation parent-enfant entre Course.1.1.SP2013 (parent) et Course.8.1.SP2013 et Course.8.2.SP2013.
Lors de la création de Course.8.SP2013, le contenu et les paramètres du modèle testCourseTemplate.SP2013 sont copiés dans Course.8.SP2013.
COMPLETE REFRESH (actualisation complète)
Mêmes résultats que l'opération de stockage, mais tous les autres enregistrements seront désactivés ou marqués pour être purgés en raison de leur absence du flux de données.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Mêmes résultats que l'opération de stockage, mais si d'autres enregistrements de cours sont gérés par cette intégration, ils ne seront pas désactivés ou purgés en raison de leur absence du flux de données ci-dessus, à moins qu'ils n'aient 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.
En savoir plus
Descriptions de l'en-tête du fichier plat d'instantané
