Vous pouvez tester une intégration LIS sans connexion à un système SIS. Ceci est un peu plus compliqué qu'avec les autres types d'intégration étant donné la nécessité : a) d'établir une liaison aux services Web, ce qui nécessite une application pour gérer les requêtes SOAP et b) de distinguer les formats des données SOAP générées par le système SIS de celles utilisées pour l'option Télécharger un fichier disponible dans l'interface utilisateur. Ce qui suit explique comment tester une intégration LIS en utilisant à la fois les services Web prenant en charge LIS et l'interface utilisateur.

Format de données LIS 2.0


Test d'intégration LIS

En testant votre intégration LIS en partant d'une perspective fonctionnelle avant de connecter votre SIS à l'intégration, vous pouvez confirmer le bon fonctionnement de la configuration sur la partie Learn de l'intégration. Lorsque vous êtes sûr que Learn traite correctement les requêtes LIS, vous avez résolu la moitié de l'équation en cas de problèmes de connectivité ou de mauvais fonctionnement. Une fois les tests effectués à l'aide des exemples fournis, vous pouvez envisager d'extraire la sortie LIS de votre SIS et de compléter vos tests non connectés avant de poursuivre l'établissement de la connexion de votre SIS à Learn. Ceci réduit le nombre de variables dans votre scénario de test.

Les intégrations LIS sont basées sur des services Web et utilisent SOAP comme moyen de transport des données. SOAP est un protocole basé sur le format de message XML qui permet l'échange d'informations structurées.

Il existe deux façons de placer des données dans Learn à l'aide de données au format LIS : vous pouvez utiliser les points d'arrêt du service Web ou exporter les fichiers au format xml.


Test à l'aide des points d'arrêt du service Web

Après avoir configuré l'intégration LIS, vous devez noter les points d'arrêt du service Web. Ceux-ci seront utilisés pour configurer votre environnement de test. Les points d'arrêt de l'intégration LIS peuvent être découverts en utilisant le lien Informations sur le service Web sur une intégration LIS configurée.

De plus, vous devrez noter le nom d'utilisateur et le mot de passe que vous avez entrés pour l'intégration. Vous pouvez les trouver en sélectionnant l'option Modifier dans le menu de l'intégration.

SoapUI

Le test des services web nécessite l'utilisation d'un outil capable de publier des messages SOAP sur les points d'arrêt des services Web. Les exemples qui suivent présentent un outil nommé SoapUI. Ce dernier est disponible sur la page www.soapui.org. SoapUI est une solution de test fonctionnelle de plate-forme croisée gratuite et Open Source qui vous permet de créer et d'exécuter facilement et rapidement des tests fonctionnels et de charge de services Web.

Bien que la démonstration suivante utilise SoapUI, vous pouvez utiliser un outil similaire de votre choix.

Après avoir terminé le test d'intégration LIS, vous pouvez configurer votre SIS pour qu'il transmette les données aux points d'arrêt par opération requise (consultez des exemples de services).

Configurer SoapUI

Outre les informations de service Web, vous aurez besoin du nom d'utilisateur et du mot de passe d'intégration. Vous pouvez les récupérer via le menu Modifier de l'intégration enregistrée. Il s'agit du nom d'utilisateur et du mot de passe qui sont utilisés pour authentifier l'accès à l'instance d'intégration LIS correspondante et l'identifier.

  1. Ouvrez SoapUI.
  2. Dans le menu File (Fichier), sélectionnez Preferences (Préférences).
  3. Sous HTTP Settings (Paramètres HTTP), sélectionnez Adds authentication information to outgoing requests (Ajoute des informations d'authentification aux requêtes sortantes).
  4. Sélectionnez OK.

Récupérer les URL WSDL

Chaque service testé nécessitera une URL WSDL pour la construction des méthodes prises en charge. L'URL WSDL correspond à la valeur « URL de point d'arrêt » de gestion, située sous « Services Web Learn locaux », concaténée avec « .wsdl ». L'URL WSDL construite ressemblera à ce qui suit :

https://<yourserver>/webapps/bb-data-integration-lis-BBLEARN/services/PersonManagementServiceSyncService .wsdl

Vous devez en construire quatre : une URL pour chaque service à tester :

CourseSectionManagerSyncService

GroupManagementSyncService

MembershipManagementSyncService

PersonManagementSyncService

dataSetStatus n'est pas un service LIS mais plutôt un service Learn fourni pour la surveillance des activités d'intégration.

Résoudre l'erreur SoapUI « Characters larger than 4 bytes are not supported » (Les caractères supérieurs à 4 octets ne sont pas pris en charge)

Certaines installations SoapUI peuvent lever une erreur de type « org.apache.xmlbeans.XmlException: java.io.CharConversionException: Characters larger than 4 bytes are not supported: byte 0x96 implies a length of more than 4 byte » (« Les caractères supérieurs à 4 octets ne sont pas pris en charge : l'octet 0x96 implique une longueur supérieure à 4 octets ») lors d'une tentative de chargement du WSDL.

Pour résoudre cette erreur :

  • Ouvrez le dossier « Corbeille » situé sous l'installation SoapUI, puis accédez au fichier « soapUI-4.6.4.vmoptions ». Ouvrez-le dans un éditeur de texte et ajoutez cette ligne :

    -Dfile.encoding=UTF8

  • Enregistrez le fichier. Fermez, puis rouvrez SoapUI et rechargez WSDL.

Il se peut que le test du Service de gestion des échanges de données groupées ne soit pas complet en utilisant SoapUI de la même manière, car le service doit accéder à un serveur de fichiers pour accéder au fichier de données. Pour en savoir plus, consultez la section « Tester le service groupé en utilisant SoapUI » plus loin dans cette rubrique.


Créer des projets SoapUI pour vos tests

Chaque service à tester doit être ajouté en tant que projet à SoapUI. La procédure suivante explique comment configurer SoapUI pour tester le service PersonManagementServiceSyncService.

  1. Utilisez le menu ou appuyez simultanément sur les touches « Ctrl » et « n » pour créer un nouveau projet SoapUI.
  2. Nommez le projet. Comme cette démonstration est pour le service Personne, nommez-la Personne LIS.
  3. Dans le champ WSDL d'origine, collez l'URL WSDL créée plus haut pour le service PersonManagementServiceSyncService.

    Le WSDL d'origine correspond à l'URL du point d'arrêt Learn du service que vous testez, avec l'extension « .wsdl ».

  4. Sélectionnez OK.
  5. Après la création des modèles de services, sélectionnez l'interface de projet pour ouvrir le visualiseur d'interface du projet. Ici, vous allez mettre à jour le point d'arrêt du service en utilisant l'URL copiée à partir de la page d'informations sur le service Web d'intégration.
  6. Entrez le nom d'utilisateur comme indiqué sur la page de configuration d'intégration.
  7. Entrez le mot de passe que vous avez fourni sur la page de configuration d'intégration.

Ces informations sont utilisées pour tous les services du projet. Le nom d'utilisateur et le mot de passe fournissent les informations d'authentification nécessaires pour identifier l'intégration cible et accéder aux services.

Si vous modifiez les paramètres du point d'arrêt du service, sélectionnez le bouton Assign (Affecter) et sélectionnez l'option « All Requests » (Toutes les requêtes) pour mettre à jour le projet. Le non-respect de cette consigne peut entraîner des erreurs SOAP.

Pour créer des projets pour le cours, l'adhésion et le groupe, vous devrez répéter les étapes 1 à 5. Bien que SoapUI prenne en charge plusieurs WSDL par projet, il est plus facile de séparer les services si quatre projets sont créés.


Tester l'intégration

SoapUI génère des modèles de requête basés sur les WSDL fournis, lesquels, bien qu'utiles pour comprendre le format des objets gérés par LIS, ne doivent pas être soumis à Learn. S'ils sont tout de même soumis, cela ne posera pas de problème, Learn renverra simplement une erreur en guise de résultat.

Pour mener à bien un test concluant, vous devez utiliser un ensemble de données conforme. Vous pouvez utiliser les exemples ci-dessous pour effectuer des essais préliminaires. Après cela, il vous sera possible d'utiliser des extraits réels de votre SIS.

Blackboard Learn 9.1 SP14 et les implémentations LIS antérieures ne prennent en charge que les services de remplacement. Vous pouvez vérifier les services pris en charge en soumettant les modèles de requête générés. Les services non pris en charge répondront par une erreur unsupported.

Tester le service PersonManagementServiceSyncService

  1. Développez l'arborescence de l'interface sous le service que vous testez (cette arborescence doit être visible après la création du nouveau projet). Dans cet exemple, replacePerson est développé.
  2. Créez une requête et nommez-la SampleReplacePerson
  3. Le visualiseur de requête s'ouvre. Il présente un modèle de requête replacePerson. Copiez le texte de SampleReplacePersonRequest.xml et collez-le dans le visualiseur de requête à la place du modèle généré.
  4. Sélectionnez l'icône Soumettre une requête.
  5. Les résultats de la requête sont affichés dans le visualiseur de requête situé à droite du XML SOAP que vous avez fourni.

Répétez les étapes 1 à 5 pour les projets/interfaces restants en utilisant les exemples de fichiers fournis. Vous pourrez ainsi vérifier que votre configuration d'intégration ne présente aucun problème avant d'effectuer des tests avec des données « réelles » ou avant de vous connecter à votre SIS. De plus, vous pouvez utiliser ce processus pour tester des ensembles de données extraits ou créés manuellement.

Le code de référence renvoyé peut être capturé pour surveiller le traitement de la demande.


Tester à l'aide du chargement de fichier d'interface utilisateur

La structure SIS Learn permet le téléchargement de fichiers xml formatés en groupe via l'interface utilisateur. Cette démonstration explique les différences entre les fichiers groupés et le format d'événement fourni par le SIS aux points d'arrêt du LIS.

Le format de fichier pour les fichiers volumineux (ceux utilisés pour le téléchargement via l'interface utilisateur d'intégration) nécessite une version de xml modifiée par rapport à ce qui est transmis aux points d'arrêt par le SIS. Consultez SampleBulkRequest_PersonCourseMemberTerm.xml dans les exemples de téléchargement contenus dans l'ensemble d'exemples téléchargeable ci-dessous.

Format de fichier groupé

Lorsqu'un SIS conforme à LIS communique avec Learn, le SIS envoie un message SOAP complet aux points d'arrêt du service Web. Ce message SOAP contient un wrapper autour des données XML LIS. Ces informations ne sont pas nécessaires pour un téléchargement manuel de données et génèrent une erreur de source si elles sont incluses. Un exemple tronqué d'objet Personne (Utilisateur) est représenté ci-dessous dans « Ensemble de données 1.0 ». Pour consulter une description complète du format de données de chaque objet pris en charge, consultez Format de données LIS 2.0.

<?xml version='1.0' encoding='ISO-8859-1'?>
<bulkDataRecord xmlns="http://www.imsglobal.org/services/li...sDataFile_v1p0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.imsglobal.org/services/li...sDataFile_v1p0 ../schemas/imsbdemsDataFile_v1p0.xsd">
<!-- Consider everything ABOVE this line as the "feed file header" -->
  <!-- start persons here -->
  <transactionRecord>
    <transactionOpIdentifier>identifier</transactionOpIdentifier>
    <serviceName>PersonManagementService</serviceName>
    <interfaceName>PersonManager</interfaceName>
    <operationName>replacePerson</operationName>
    <!-- Consider everything ABOVE this line as the "personRecord header";
         operationName will be replacePerson or deletePerson -->
   <parameterSet>
     <parameterRecord>
       <parameterInvoc>In</parameterInvoc>
       <parameterName>sourcedId</parameterName>
       <parameterType>GUID</parameterType>
       <parameterValue>55555</parameterValue&gt; <!-- ID for logging -->
     </parameterRecord>
     <parameterRecord>
       <parameterInvoc>In</parameterInvoc>
       <parameterName>personRecord</parameterName>
       <parameterType>PersonRecord</parameterType>
       <parameterValue>
         <personRecord>
           <sourcedGUID>
             <refAgentInstanceID>unknown</refAgentInstanceID>
             <sourcedId>55555</sourcedId&gt; <!-- batch_uid (for real) -->
           </sourcedGUID>
           <person&gt; <!-- start person record -->
             <formname>
              <formnameType>
                <instanceIdentifier>
                  <language>en</language>
                  <textString>unknown</textString>
                </instanceIdentifier>
                <instanceVocabulary>
                   http://www.imsglobal.org/lis/pmsv2p0/formatnmetypevocabularyv1p0 
                <instanceVocabulary>
                <instanceValue>
                  <language>en</language>
                  <textString>Full</textString>
                </instanceValue>
              </formnameType>
              <formattedName>
                <language>en</language>
                <textString>Dr. First Middle Last, Jr.</textString&gt; <!-- Full Name IGNORED by Learn-->
              </formattedName>
            </formname>
      ...
      </person> 
      </personRecord><!-- end person record -->
      <!-- could have more <personRecord></personRecord>s here -->
    </parameterValue>
</parameterRecord>
</parameterSet>
</transactionRecord>
<!-- could have additional transactionRecords for Courses, Memberships, or Groups here -->
</bulkDataRecord>
 <!-- Master closing tag -->

Ensemble de données 1.0 : données d'exemple LIS à utiliser dans un fichier de chargement d'interface utilisateur LIS Learn. Le fichier complet est disponible dans l'ensemble d'exemples téléchargeable en cliquant sur le lien ci-dessous.

Modifier le fichier XML LIS SOAP pour le chargement

Pour utiliser les fichiers de données groupées, vous devez remplacer les balises d'ouverture et de fermeture SOAP-ENV:Envelope et SOAP-ENV:Body dans un message généré par LIS par les balises d'ouverture et de fermeture bulkDataRecord . Cette procédure est indiquée dans l'ensemble de données abrégé précédent. Ceci effectue de nombreuses transactions (par exemple : pour les personnes, les cours et les adhésions) dans un fichier unique. Elles doivent être encadrées par des balises transactionRecord supplémentaires (consultez l'exemple complet).

Tester

Lorsque vous avez préparé vos fichiers de données, ouvrez Télécharger un fichier source via le menu d'intégration de LIS.

Vous serez dirigé vers la page de téléchargement où vous sélectionnerez le fichier à télécharger. Pour cette démonstration, sélectionnez le fichier d'exemple fourni : SampleBulkRequest_PersonCourseMemberTerm.xml.

Le fait de soumettre le fichier vous redirige vers la page Intégration. Pour visualiser les résultats du test, vous pouvez utiliser l'interface administrateur pour examiner les objets créés ou mis à jour, ou utiliser la visionneuse de journaux de structure SIS pour afficher le journal d'intégration.

Pour afficher le journal d'intégration, sélectionnez Afficher le journal dans le menu de l'intégration. Vous serez redirigé vers la page Journal de l'intégration.

Pour inspecter plus en détail un message enregistré, sélectionnez l'élément de ligne de message dans la liste. Les détails seront affichés dans la zone Détails du message sous la liste de messages.

Ces détails contiendront des informations utiles pour le débogage. Par exemple :

<feb _x0032_0=""&gt; Invalid data for attribute: role. Skipping entire record. Reason: (<feb _x0032_0=""&gt; Données non valides pour l'attribut: fonction. Ignorer tout l'enregistrement. Motif:) Le rôle au sein du cours n'est pas valide.
InvalidData
Error occurred processing the following XML (Une erreur s'est produite lors du traitement des données XML suivantes) :
In
sourcedId
GUID
test_course.55555
In
membershipRecord
membershipRecord
<membershipRecord><sourcedGUID><refAgentInstanceID>unknown</refAgentInstanceID><sourcedId>test_course.55555</sourcedId></sourcedGUID><membership><collectionSourcedId>test_course</collectionSourcedId><membershipIdType>courseSection</membershipIdType><member><personSourcedId>55555</personSourcedId><role><roleType>Learner</roleType><subRole>Learner</subRole><timeFrame><begin>2014-02-01T15:00:00</begin><end>2014-09-01T15:50:00</end><restrict>false</restrict><adminPeriod><language>en</language><textString>201330</textString></adminPeriod></timeFrame><status>Active</status><dateTime>2011-08-04T15:00:00</dateTime><creditHours>0</creditHours><dataSource>SIS</dataSource><extension><extensionNameVocabulary>unknown</extensionNameVocabulary><extensionTypeVocabulary>unknown</extensionTypeVocabulary><extensionField><fieldName>LIS2.0Role/Gradable</fieldName><fieldType>String</fieldType><fieldValue>Gradable</fieldValue></extensionField><extensionField><fieldName>LIS20DeliverySystem</fieldName><fieldType>String</fieldType><fieldValue>BB</fieldValue></extensionField></extension></role></member><dataSource>SIS</dataSource></membership></membershipRecord></feb>

blackboard.dataintegration.lis.operation.OperationExecutorException: InvalidData

Les détails du message précédent indiquent l'échec d'une opération replaceMembership, en particulier un rôle incorrect au sein du cours (indiquée par le texte en surbrillance jaune). La requête publiée est incluse et nous pouvons voir que le rôle incorrect est cellui de « Learner » (Apprenant). Il suffit de le remplacer par « Student » (Étudiant), puis de soumettre à nouveau la requête replaceMembership pour qu'elle réussisse.


Tester le service groupé en utilisant SoapUI

La configuration de test des requêtes de service groupé est la même que pour les autres services, à une exception : vous devez fournir un serveur de fichier auquel le serveur d'application Learn a accès pour la prise en charge du fichier de données groupées par le service LIS.

L'architecture du service Web d'échanges de données groupées se compose de trois parties : le client (dans ce cas, SoapUI), l'instance LIS dans l'instance Learn de test et un serveur de fichiers. Le client envoie un message SOAP au service Web d'échange de données groupées. La requête du client inclut l'URL du fichier batch à traiter (qui se trouve sur le serveur de fichiers) et l'opération à effectuer.

Les opérations que le service d'échange de données groupées peut effectuer sur un fichier batch sont limitées à l'ensemble des opérations de service web qui peuvent être effectuées par les autres services Web pour l'instance LIS. Dans le cas de la version 9.1 SP 14 et des versions antérieures, celles-ci sont limitées aux opérations de remplacement.

Si vous rencontrez des problèmes avec la somme de contrôle, vous pouvez désactiver la vérification de la somme de contrôle via les paramètres Intégration de données - LIS.

Configuration de LIS

  1. Ouvrez votre intégration de LIS configurée (ou créez-en une) et notez la valeur du champ Nom d'utilisateur partagé.
  2. Sous Propriétés d'intégration, remplissez les champs suivants :
    1. Mot de passe partagé
    2. Batch Service Username (Nom d'utilisateur du service Lot)
    3. Batch Service Password (Mot de passe du service en lot)
    4. Nom d'utilisateur pour le téléchargement en mode batch (dans le cadre de l'exemple, faites de même pour « Nom d'utilisateur du service Batch »)
    5. Mot de passe pour le téléchargement en mode batch (dans le cadre de l'exemple, faites de même pour « Mot de passe du service Batch »)
    6. URL du service Web Batch SIS Learning Information Services : http://localhost:8081/
      Il s'agit de l'adresse du service HTTPD qui fournit le fichier au service LIS groupé et doit représenter votre configuration spécifique.
  3. Définissez État d'intégration sur Actif.
  4. Définissez Verbosité du journal sur Tous les messages de diagnostic et de débogage.
  5. Définissez Source de données Learn sur Utiliser la même source de données Learn pour toutes les nouvelles données entrantes.
  6. Sélectionnez Soumettre.

Configurer le service de fichier HTTPD de prise en charge

Téléchargez le fichier suivant et décompressez-le sur le serveur où vous placerez vos fichiers de test.

Téléchargez le fichier SampleBulkRequest_PersonCourseMemberTerm.xml et placez-le dans le répertoire à partir duquel les fichiers seront livrés.

Tester le service de fichier HTTPD

java -jar SimpleHttpServer.jar

Syntaxe : java SimpleHttpServer <port number> <path to directory to serve files from> <username> <password>

Par exemple :

java -jar SimpleHttpServer.jar 8081 /Users/moneil/Desktop/LISTEST moneil moneil
Server running on port 8081. Hit Ctrl-C to quit.

Accédez au serveur via votre navigateur pour tester la livraison du fichier. Par exemple :

http://10.0.1.16:8081/SampleBulkRequest_PersonCourseMemberTerm.xml

Configurer SoapUI pour le test

La configuration de SoapUI pour tester l'échange de données groupées est la même que pour les autres services LIS.

Obtenir l'URL/WSDL d'échange de données groupées

  1. Accédez à la page Intégrations des SIS (ou « systèmes d'informations étudiants » pour « Student Information System ») dans l'instance de test de Learn.
  2. Dans la section Configuration de LIS, sélectionnez le chevron de contexte pour l'intégration LIS créée.
  3. Sélectionnez l'option Informations sur le service Web.
  4. L'URL WSDL correspond à la valeur URL de point d'arrêt du Service de gestion des échanges de données groupées, situé sous Services Web Learn locaux, concaténée avec « .wsdl ».

Configurer SoapUI

  1. Ouvrez SoapUI.
  2. Dans le menu File (Fichier), sélectionnez Preferences (Préférences).
  3. Sous HTTP Settings (Paramètres HTTP), sélectionnez Adds authentication information to outgoing requests (Ajoute des informations d'authentification aux requêtes sortantes).
  4. Sélectionnez OK.
  5. Appuyez simultanément sur les touches « Ctrl+n ».
  6. Dans le champ Initial WSDL (WSDL d'origine), collez l'URL WSDL.
  7. Sélectionnez OK.
  8. Développez l'arborescence sous announceBulkDataExchange (elle devrait être visible après la création du nouveau projet).
  9. Après la création des modèles de services, sélectionnez l'interface de projet pour ouvrir le visualiseur d'interface du projet. Vous pourrez l'utiliser pour :
    1. mettre à jour le point d'arrêt du service en utilisant l'URL copiée à partir de la page d'information du service Web d'intégration ;
    2. entrer le nom d'utilisateur comme indiqué sur la page de configuration d'intégration ;
    3. entrer le mot de passe que vous avez fourni sur la page de configuration d'intégration.

Exécuter le test

Ouvrez la requête announceBulkDataExchange et copiez/collez le contenu de l'ensemble de données 2 ci-dessous dans le visualiseur de requête.

Attention : vous devez modifier l'élément <ims:url> dans l'exemple pour refléter votre serveur de fichier de test. Veuillez vérifier que l'URL est située sur une seule ligne.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/li.../imsbdems_v1p0">
<soapenv:Header>
<ims:imsx_syncRequestHeaderInfo>
<ims:imsx_version>V1.0</ims:imsx_version>
<ims:imsx_messageIdentifier>123456</ims:imsx_messageIdentifier>
</ims:imsx_syncRequestHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims:announceBulkDataExchangeRequest>
<ims:transactionId>123456</ims:transactionId>
<ims:bulkBlockManifest>
<ims:bulkBlockManifestId>123456</ims:bulkBlockManifestId>
<ims:expiryDate>2020-10-01T12:00:00</ims:expiryDate>
<ims:bulkBlockDataFile>
<ims:url>http://<your_test_file_server>:8081/<file_path>¬                               /SampleBulkRequest_PersonCourseMemberTerm.xml</ims:url>
<ims:checkSum>b3ecf4f05935c687932ce1d8c1af7335</ims:checkSum>
<ims:totalSize>29063</ims:totalSize>
<ims:savePoint>2020-10-01T12:00:00</ims:savePoint>
<ims:serviceSet>
<ims:serviceRecord>
<ims:serviceName>CourseManagementService</ims:serviceName>
<ims:interfaceName>CourseSectionManager</ims:interfaceName>
<ims:operationSet>
<ims:operationName>replaceCourseSection</ims:operationName>
</ims:operationSet>
</ims:serviceRecord>
</ims:serviceSet>
</ims:bulkBlockDataFile>
</ims:bulkBlockManifest>
</ims:announceBulkDataExchangeRequest>
</soapenv:Body>
</soapenv:Envelope>

Ensemble de données 2 : BulkDataRequest

Notes pour la création de votre propre fichier de test

Les éléments ims:imsx_messageIdentifier, ims:transactionId, et ims:bulkBlockManifestId doivent tous avoir la même valeur (dans cet exemple, la valeur est 123456). Les éléments ims:expiryDate et ims:savePoint doivent avoir la même valeur (dans l'exemple suivant, la valeur 2020-10-01T12:00:00 est utilisée).

L'objet ims:bulkBlockDataFile représente un fichier batch à traiter. L'élément ims:url correspond à l'URL de l'emplacement du fichier source de test sur le serveur de fichiers. L'élément ims:totalSize correspond à la taille totale, en octets, du fichier source de test (utilisez « ls -l »dans Linux ou « dir » dans Windows). L'élément ims:checkSum correspond au hachage md5 du fichier de test (utilisez « md5sum » sur Linux ou obtenez un programme comparable ou Cygwin sur Windows).

L'objet ims:serviceRecord représente la façon dont le fichier source sera traité ; plusieursims:serviceRecord peuvent exister dans un élément ims:bulkBlockDataFile. L'élément ims:serviceName représente le service Web LIS dont les opérations seront appelées pour le traitement du fichier source donné. L'élément ims:interfaceName correspond à l'interface du code SIS LIS utilisé en tant qu'index des méthodes disponibles à appeler. L'objet ims:operationSet contient la liste des méthodes (répertoriées en tant qu'élément ims:operationName) devant être appelées pour traiter le fichier source.

Exécuter la requête de test

La requête est exécutée en sélectionnant le bouton vert « Play » (Lecture) situé en haut à gauche du cadre de la requête.

La réponse à la requête précédente est :

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<ims:imsx_syncResponseHeaderInfo xmlns:ims="http://www.imsglobal.org/services/li.../imsbdems_v1p0">
<ims:imsx_version>V1.0</ims:imsx_version>
<ims:imsx_messageIdentifier>4ebf713ae3664f84ab67d961c3f55060</ims:imsx_messageIdentifier>
<ims:imsx_statusInfo>
<ims:imsx_codeMajor>success</ims:imsx_codeMajor>
<ims:imsx_severity>status</ims:imsx_severity>
<ims:imsx_messageRefIdentifier>123456</ims:imsx_messageRefIdentifier>
<ims:imsx_description>Use the reference code 9d4a22b81d4a45d683c2c13e0a0e7a1c to track these records in the logs.</ims:imsx_description>
<ims:imsx_codeMinor>
<ims:imsx_codeMinorField>
<ims:imsx_codeMinorFieldName>TargetEndSystem</ims:imsx_codeMinorFieldName>
<ims:imsx_codeMinorFieldValue>fullsuccess</ims:imsx_codeMinorFieldValue>
</ims:imsx_codeMinorField>
</ims:imsx_codeMinor>
</ims:imsx_statusInfo>
</ims:imsx_syncResponseHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims:announceBulkDataExchangeResponse xmlns:ims="http://www.imsglobal.org/services/li.../imsbdems_v1p0"/>
</soapenv:Body>
</soapenv:Envelope>


Récapitulatif

En testant manuellement l'intégration avant de vous connecter au SIS, vous pouvez vérifier que votre configuration Learn fonctionne correctement. Le test à l'aide de l'interface utilisateur permet de vérifier rapidement les données et le comportement des paramètres. Le test à l'aide du jeu d'outils SoapUI permet non seulement de tester les données et le comportement, mais aussi la connectivité et les paramètres d'autorisation tels qu'ils seraient transmis par le SIS. Ceci permet une séparation des tâches pour établir et trier votre intégration LIS.


Exemple de données

L'ensemble d'exemples de données (bbdn-lis_samples) utilisé dans cette rubrique peut être cloné ou téléchargé en tant que fichier .zip à partir du référentiel GitHub Blackboard.