Les exemples suivants illustrent la composition des flux de données MEMBERSHIP 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 d'autres en-têtes de flux MEMBERSHIP à utiliser lors de la création d'enregistrements d'adhésion. 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 d'atteindre vos objectifs de données et de cycle de vie d'adhésion.

Les exemples sont basés sur les paramètres par défaut de Learn 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.

Remarques sur les adhésions dans les cours fusionnés

Lors de la création d'adhésions sur des cours fusionnés, les critères suivants garantissent la réussite :

  • Respectez l'exemple du SIS. Les adhésions doivent respecter un mappage 1:1, conformément au SIS. Ne forcez pas toutes les adhésions au cours parent.
  • Une adhésion ne peut pas exister dans plus d'un cours enfant dans les cours fusionnés. Le SP 12 a introduit un nouveau mappage de champ des adhésions aux cours afin de faciliter la gestion des inscriptions sur les cours fusionnés (Déplacement d'inscription de listes croisées, « Move Cross-listed Enrollment »). Lorsqu'il est appliqué, l'adhésion et les données/contenus associés sont déplacés du cours actuel vers le nouveau cours enfant (voir l'exemple d'utilisation suivant).
  • Avec le mappage « Move Cross-listed Enrollment », vous devez désactiver l'adhésion à un cours enfant avant de créer une adhésion dans un autre. Si votre établissement dispose d'une politique d'inscription aux cours à grande échelle selon laquelle les étudiants peuvent s'inscrire à plusieurs instances de cours, vous rencontrerez des erreurs d'intégration sur les demandes d'adhésion supplémentaires. Par exemple, Math100 dispose de trois cours enfants : Math 100.1, Math 100.2 et Math 100.3, et un étudiant sélectionne Math100.2 et Math100.3 comme des options au cours de la période d'inscription. L'une ou l'autre instance produira une erreur de traitement dans Learn, en fonction de l'adhésion enfant qui est traitée en premier.

À propos des données d'adhésion

Les données d'adhésion sont l'ensemble d'informations principal qui détermine l'accès à un cours ou à une communauté par un utilisateur disposant d'un rôle non-administrateur.

Opérations

Les données peuvent être fournies à Learn avant d'être ensuite mises à jour, supprimées ou modifiées. 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.

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 source à 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érationDescription
StockerLors 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. (voir la présentation du cadre SIS pour la « propriété » et la source de données)
Actualisation complèteCette 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.
SupprimerCette 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éesIntroduite 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 MEMBERSHIP sont les suivants :

ObjetOpérations
membershipStore, Complete Refresh, Delete, Complete Refresh by Data Source

Les communautés et les cours partagent les mêmes modèles de gestion des adhésions (MEMBERSHIP). Ils requièrent toutefois des en-têtes différents, et ils seront signalés le cas échéant, mais les exemples se concentreront plus particulièrement sur la gestion des adhésions aux cours.

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.

Ce champ n'est pas obligatoire dans les sources de données basées sur le cadre et sauf indication contraire dans les exemples fournis, 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 d'adhésion.

Remarques 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 pour la création d'une entrée de nom d'adhésion. Lorsqu'il est appliqué à un champ d'objet MEMBERSHIP, le script associé est exécuté par enregistrement d'adhésion, en modifiant ou en fournissant les données avant qu'elles ne soient stockées dans Learn. Une explication complète du mappage des champs est fournie dans Mappage de champs du fichier plat d'instantané.

Exemples d'opération d'adhésion

À 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 MEMBERSHIP 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 : Adhésions

Tous les objets MEMBERSHIP nécessitent un ensemble d'informations de base. Cet ensemble d'informations est détaillé dans Format de données de fichier plat d'instantané et En-têtes de fichier plat d'instantané.

Si vous utilisez actuellement les outils batch de l'interface utilisateur, passer au cadre SIS et à l'utilisation des données d'adhésion 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 d'adhésion dans Learn comprennent les éléments suivants :

  • EXTERNAL_COURSE_KEY : identificateur unique pour l'enregistrement d'adhésion. Pour les communautés, il s'agit d'EXTERNAL_ORGANIZATION_KEY.
  • NEW_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.
  • EXTERNAL_PERSON_KEY : identificateur de l'utilisateur pour lequel l'adhésion s'applique.

La structure SIS par configuration d'intégration fournit des valeurs par défaut pour les champs non obligatoires ou les ignore. Les champs AVAILABLE_IND, ROW_STATUS et ROLE. ne sont pas obligatoires, mais utiles pour les flux MEMBERSHIP. 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 d'adhésion

Il existe deux cas d'utilisation impliquant l'ajout d'informations d'adhésion. Le premier consiste à stocker STORE les informations d'adhésion de manière additive, ce qui entraîne l'ajout ou la mise à jour d'enregistrements, comme indiqué dans le flux de données. Le second consiste à actualiser REFRESH les informations d'adhésion 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 MEMBERSHIP.

Exemples d'opération de stockage

Exemple 1 : créer des adhésions

Vous souhaitez ajouter des adhésions à 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

Le cours et l'utilisateur doivent exister pour que l'opération d'adhésion réussisse.

Exigences minimales de flux de données

EXTERNAL_COURSE_KEY

EXTERNAL_PERSON_KEY

Solution

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

EXTERNAL_COURSE_KEY|EXTERNAL_PERSON_KEY
testcourse1|testPerson1
testcourse1|testPerson2
testcourse2|testPerson3

Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données MEMBERSHIP à l'aide de l'opération STORE. Les comptes d'adhésion seront créés et vous pourrez les découvrir via les outils de cours de l'administrateur système.

Postcondition

Les adhésions à testcourse1 ont été créées pour les personnes avec testPerson1, testPerson2 comme EXTERNAL_PERSON_KEY et une adhésion à testcourse2 a été créée pour testperson3.

Exemple 2 : mettre à jour des adhésions

Vous avez créé des comptes d'adhésion et devez les modifier. Par exemple, pour l'exemple ci-dessus testPerson3 a été ajouté à testcourse2 lorsqu'il aurait dû l'être à testcourse1.

Notez que, même si nous pouvons apporter la modification correcte au flux de données : testcourse1|testPerson3, la précédente adhésion à testcourse2 restera effective tant qu'elle ne sera pas désactivée. Cette opération peut être effectuée dans un seul flux en ajoutant l'élément d'en-tête ROW_STATUS.

Pré-requis

Les enregistrements COURSE et PERSON doivent exister dans Learn.

L'enregistrement à désactiver doit préexister dans Learn.

Solution

Créez un fichier de données membership.txt contenant les en-têtes requis et les données associées par adhésion que vous souhaitez ajouter/mettre à jour ou désactiver. Par exemple :

EXTERNAL_COURSE_KEY|EXTERNAL_PERSON_KEY|ROW_STATUS
testcourse2|testPerson3|disabled
testcourse1|testPerson3|enabled

STORE fonctionnant uniquement sur les données contenues dans le fichier, les données d'enregistrements d'adhésion précédemment soumis ne sont pas affectées. L'opération STORE nécessite une manipulation explicite des données si vous souhaitez désactiver des enregistrements.

Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données MEMBERSHIP à l'aide de l'opération STORE. Les enregistrements d'adhésion du fichier seront mis à jour.

Postcondition

Les enregistrements d'adhésion pour testPerson3 sont mis à jour pour désactiver explicitement l'adhésion à testcourse2 de testPerson3 lors de la création et de l'activation d'une adhésion dans testcourse1.

Les enregistrements d'adhésion précédemment créés ne sont pas affectés.

Adhésion : opération d'actualisation complète

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

Exemple : actualisation complète

Les données que votre SIS fournit contiennent un instantané complet des adhésions aux cours qui doivent exister dans Learn. Ces données contiennent les enregistrements MEMBERSHIP à ajouter, les enregistrements MEMBERSHIP à 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 purgés).

Pré-requis

Les enregistrements COURSE et PERSON doivent exister dans Learn.

Exigences minimales de flux de données

EXTERNAL_COURSE_KEY

EXTERNAL_PERSON_KEY

Solution

À partir des données de notre première opération de stockage d'adhésion, ajouter l'adhésion correcte pour testPerson3 dans testcourse1 et supprimer l'adhésion incorrecte pour testPerson3 dans testcourse2. Cela fournit des résultats similaires à ceux des multiples opérations STORE décrites ci-dessus, comme COMPLETE REFRESH désactive implicitement tous les enregistrements qui ne sont pas dans le fichier.

EXTERNAL_COURSE_KEY|EXTERNAL_PERSON_KEY
testcourse1|testPerson1
testcourse1|testPerson2
testcourse1|testPerson3

Notez que si d'autres enregistrements MEMBERSHIP 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

Les enregistrements MEMBERSHIP pour testcourse1|testPerson1 et testcourse1|testPerson2 sont conservés et ne sont pas affectés.

L'enregistrement MEMBERSHIP pour testcourse1|testPerson3 est ajouté à Learn

L'enregistrement MEMBERSHIP pour testcourse2|testPerson3, 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.

Adhésion : actualisation complète par source de données

COMPLETE REFRESH BY DATA SOURCE effectue une opération COMPLETE REFRESH, mais limite les données affectées à celles qui sont associées à 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 PERSON qui doivent exister dans Learn. Ces données contiennent les enregistrements PERSON à ajouter, les enregistrements PERSON à mettre à jour et les enregistrements qui ont été supprimés depuis les opérations REFRESH précédentes, qui sont traités conformément à la configuration (désactivés ou purgé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

Les enregistrements COURSE et PERSON doivent exister dans Learn.

Exigences minimales de flux de données

EXTERNAL_COURSE_KEY

EXTERNAL_PERSON_KEY

Solution

Utilisation des données de notre dernière opération de stockage pour ajouter une adhésion pour testPerson3 dans testcourse1 et supprimer testcourse2|testPerson3 du flux de données :

EXTERNAL_COURSE_KEY|EXTERNAL_PERSON_KEY
testcourse1|testPerson1
testcourse1|testPerson2
testcourse1|testPerson3

Postcondition

Les enregistrements MEMBERSHIP pour testcourse1|testPerson1 et testcourse1|testPerson2 sont conservés et mis à jour.

L'enregistrement MEMBERSHIP pour testcourse1 | testPerson3 est mis à jour/ajouté à Learn

L'enregistrement MEMBERSHIP pour testcourse2|testPerson3, 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.

Si d'autres enregistrements MEMBERSHIP 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é d'adhésion

Le paramètre disponibilité des adhésions 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 une adhésion, ce qui rend non seulement l'adhésion indisponible pour tous, mais la rend également indisponible pour d'autres opérations telles que la gestion des adhésions via l'interface utilisateur. L'ajout de cet en-tête de flux de données n'a aucun impact sur l'utilisation illustrée plus haut des opérations STORE, COMPLETE REFRESH ou COMPLETE REFRESH BY DATA SOURCE pour la création d'enregistrements d'adhésion.

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 d'adhésion

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

Les enregistrements COURSE et PERSON doivent exister dans Learn.

Exigences minimales de flux de données

EXTERNAL_COURSE_KEY

EXTERNAL_PERSON_KEY

AVAILABILITY_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.

EXTERNAL_COURSE_KEY|EXTERNAL_PERSON_KEY|AVAILABLE_IND
testcourse1|testPerson1|Y
testcourse1|testPerson2|Y
testcourse1|testPerson3|Y
testcourse2|testPerson3|N

Postcondition

STORE

Seuls les enregistrements MEMBERSHIP pour testcourse1 et testcourse2 sont créés ou mis à jour avec le statut de disponibilité actuel.

Complete refresh operation

Les enregistrements MEMBERSHIP pour testcourse1 et testcourse2 sont créés ou mis à jour avec le statut de disponibilité actuel. 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

Les enregistrements MEMBERSHIP pour testcourse1 et testcourse2 sont créés ou mis à jour avec le statut de disponibilité actuel. Si d'autres enregistrements MEMBERSHIP sont gérés par une autre intégration, ils ne sont pas désactivés ou purgés en raison de leur absence du flux de données, à 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 MEMBERSHIP

La désactivation d'un enregistrement MEMBERSHIP dans Learn le rend inaccessible à tous les utilisateurs (le statut 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 une adhésion désactivée 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 suppriment toutes les références à cet enregistrement de Learn. Blackboard recommande 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 MEMBERSHIP 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 enregistrements MEMBERSHIP

La politique stipule que vous devez supprimer 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

Les enregistrements COURSE et PERSON doivent exister dans Learn.

Exigences minimales de flux de données

EXTERNAL_COURSE_KEY

EXTERNAL_PERSON_KEY

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|EXTERNAL_PERSON_KEY|ROW_STATUS
testcourse1|testPerson1|enabled
testcourse1|testPerson2|enabled
testcourse1|testPerson3|enabled
testcourse2|testPerson3|disabled

Postcondition

STORE

Seuls les enregistrements MEMBERSHIP contenus dans le flux de données sont créés ou mis à jour avec le paramètre ROW_STATUS mis à jour explicitement.

COMPLETE REFRESH

Les enregistrements MEMBERSHIP contenus dans le flux de données sont créés ou mis à jour avec le paramètre ROW_STATUS mis à jour explicitement. 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

Les enregistrements MEMBERSHIP contenus dans le flux de données sont créés ou mis à jour avec le paramètre ROW_STATUS mis à jour explicitement. Si d'autres enregistrements MEMBERSHIP sont gérés par une autre 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. COMPLETE REFRESH BY DATA SOURCE fonctionne uniquement sur les enregistrements de la source de données d'intégration.

Nouveauté du SP 12

Exemple : déplacement d'inscription de listes croisées (Move cross-listed enrollment)

L'utilisation des cours fusionnés présente certaines contraintes pour le traitement des adhésions (inscription). En particulier, un utilisateur ne peut pas activer simultanément des adhésions dans plus d'un cours fusionné.

Dans certains scénarios de listes croisées, le SIS devrait normalement empêcher l'exécution de l'inscription d'un utilisateur dans course_child2 si l'utilisateur est déjà inscrit à course_child1 dans un ensemble de listes croisées (fusionnées). Le champ Move Cross-Listed Enrollment définit le contrôle sur l'intégration de sorte que l'intégration SIS doit supposer que toute inscription valide ne doit pas être empêchée en raison des seules restrictions de listes croisées. Dans l'exemple course_child2/course_child1 décrit ci-dessus, cela aurait pour conséquence le déplacement de l'inscription à course_child1 de course_child1 vers course_child2.

Le mappage de champ pour la gestion des inscriptions à listes croisées est disponible par le biais de la configuration avancée « Advance Configuration » de chaque instance d'intégration. Il fait partie des mappages de champ d'objet d'inscription « enrollment » et est appelé « Move Cross-listed Enrollment ».

Move Cross-listed Enrollment utilise un appel de script interne par défaut qui renvoie toujours la valeur « true » (vrai). Pour modifier ce comportement, vous devez fournir un script qui retourne une valeur autre que true dans certaines ou dans toutes les circonstances. Par exemple, vous pouvez avoir un script qui renvoie simplement false (faux) ou un script qui ne renvoie false que si le code de cours de l'adhésion répond de façon conditionnelle à un certain modèle, etc. Pour en savoir plus, consultez la section Exemples de mappage de champ personnalisé.

Par défaut, ce mappage ne s'attend pas à être défini « directement » dans le cadre du flux pour n'importe quel type d'intégration. Par exemple, il n'y a pas de colonne dans le fichier plat d'instantané, ni de nœud XML correspondant pour les IMS/Vista, etc. Par conséquent, il n'y a pas d'exemple de « données » pour ce champ.

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, testmembership8 ne doit pas avoir été créé précédemment.

EXTERNAL_COURSE_KEY|EXTERNAL_PERSON_KEY|AVAILABLE_IND|ROW_STATUS
testcourse1|testPerson1|Y|enabled
testcourse1|testPerson2|Y|enabled
testcourse1|testPerson3|Y|enabled
testcourse2|testPerson3|N|disabled

Postcondition

STORE

Seuls les enregistrements MEMBERSHIP contenus dans le flux de données sont créés ou mis à jour avec les paramètres AVAILABILITY et ROW_STATUS mis à jour explicitement avec les résultats suivants :

La disponibilité de toutes les adhésions est définie sur Oui (Y), sauf celle de testcourse2|testPerson3 qui elle est définie sur non (N).

Les adhésions à testcourse1 sont définies sur activées, alors que l'adhésion à testcourse2|testPerson3 est désactivée.

COMPLETE REFRESH

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 dans le flux de données.

COMPLETE REFRESH BY DATA SOURCE

Mêmes résultats que l'opération de stockage, mais si d'autres enregistrements MEMBERSHIP 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

Présentation du framework SIS

Descriptions de l'en-tête du fichier plat d'instantané

Format de données du fichier plat d'instantané

Automatisation du fichier plat d'instantané