„La plate-forme EAI “ Initiation à WBI

Présentation au sujet: "„La plate-forme EAI “ Initiation à WBI"— Transcription de la présentation:

1 „La plate-forme EAI “ Initiation à WBI
11/01/2019 „La plate-forme EAI “ Initiation à WBI « Tester avec WBI » 9

2 Sommaire Objectif Etre opérationnel Les Domaines Création d ’un flux
11/01/2019 Sommaire Objectif Etre opérationnel Les Domaines Création d ’un flux Mise à jour des composants Préparation Tests unitaires Tests intégrés Debugging Ce document est un support de cours; il n ’est donc pas utilisable seul 11/01/2019

3 L ’objectif Mener les tests des composants WBI développés 11/01/2019

4 L ’environnement opérationnel
Le serveur ICS : un serveur ICS est mutualisé entre plusieurs utilisateurs et applications d’un même environnement (hors DEV) un serveur ICS doit être actif pour que des postes équipés d’un CSM puissent y accéder (un CSM seul ne peut rien faire) un serveur ICS mutualisé doit être lancé par une commande Unix (impossible à faire depuis le CSM) un serveur ICS peut être surveillé, arrêté depuis un CSM deux serveurs ICS peuvent cohabiter sur le même système Unix 11/01/2019

5 L ’environnement opérationnel
Le CSM : chaque utilisateur dispose de son propre CSM sur son poste de travail un seul CSM peut être actif à un moment donné sur un poste de travail (plusieurs instances différentes de CSM peuvent être définies pour accéder à différents environnements) le CSM doit se connecter sur un ICS pour pouvoir accéder aux traitements qui s’y exécutent un CSM peut se connecter à plusieurs ICS 11/01/2019

6 La plate-forme est opérationnelle, rappels
La plate-forme technique est lancée quand : L’ORB a été lancé et est actif L’ICS local a été lancé et est actif Le CSM a été lancé et est actif La connexion du CSM à l’ICS est opérationnelle 11/01/2019

7 Des exercices Réaliser le lancement de la plate-forme en respectant la séquence normale vérifier que les composants e la plate-forme sont bien opérationnels Des questions? 11/01/2019

8 La plate-forme est opérationnelle, rappels
Le comportement normal de l'ORB est d'être lancé une fois et de ne plus être arrêté L'ORB doit être lancé en premier Le comportement normal de l'ICS est d'être lancé une fois et de ne pas être arrêté sauf besoin spécifique L'ORB doit être actif au lancement de l'ICS Le comportement normal du CSM est d'être lancé ou arrêté exactement quand son utilisateur le souhaite 11/01/2019

9 Les composants sont opérationnels
La Collaboration : une Collaboration doit être “ Startée ” pour pouvoir traiter un événement une Collaboration “ Startée ” traite tous les événements la concernant qui se présentent une Collaboration doit être “ Stoppée ” pour éviter qu’elle traite des événements pour qu’une Collaboration puisse s’exécuter, il faut qu’elle-même et tous ses composants soient “ startés ” 11/01/2019

10 Les composants sont opérationnels
Les connecteurs : un Connecteur doit être “ Starté ” pour pouvoir participer au traitement d’un événement un Connecteur est toujours composé de deux parties : le Controler et l’Agent qui doivent tous deux être “ Startés ” l'Agent est installé sur le système avec lequel il réalise l'interface 11/01/2019

11 Les composants sont opérationnels
Les Maps : une Map doit être “ Startée ” pour pouvoir participer au traitement d’un événement 11/01/2019

12 Les composants sont opérationnels
La signalétique: Triangle vert : “ Starté ” Carré rouge : “ Stopé ” Deux barres jaunes : “ Pausé ” … 11/01/2019

13 Des exercices Dans la vue ICS, mettre en Start tous les composants qui doivent être lancés Des questions? 11/01/2019

14 Comment arrêter un flux?
Pour ne pas perdre d ’occurrence de flux, il faut: Arrêter les connecteurs qui pollent (en entrée) Laisser la Collaboration traiter tous les flux candidats Stopper la Collaboration 11/01/2019

15 Les domaines, rappels Le domaine Bibliothèques de composants d'intégration rassemble tous les composants existants Le regroupement de tous les composants dans ce domaine permet le ré-emploi des composants existants Il est matérialisé par un ensemble de répertoires Chaque utilisateur créé ses projets dans le domaine Projets utilisateur et y place les composants nécessaires au support du/des flux sur lesquels il travaille Les composants listés là sont des raccourcis sur les composants apparaissant dans le domaine Composants d'intégration 11/01/2019

16 Les Bibliothèques de composants d ’intégration
Créer: une BBL par ICS identifié pour y regrouper tout ce qui vient de chacun une BBL pour tout ce qui provient d ’ailleurs: démos, exemples, ... 11/01/2019

17 Création d ’un flux Dans Projets utilisateurs:
Clic droit sur Projets Interchange server ou sur Projets utilisateur Sélectionner Nouveau projet ICS Saisir le nom du nouveau flux Sélectionner les composants à "importer", si nécessaire, depuis ceux existants dans les Composants d'intégration 11/01/2019

18 Création d ’un flux Pour tenir compte des dépendances et ne rien oublier: importer la Collaboration afficher ses dépendances faire passer à droite tout ce qui est nécessaire 11/01/2019

19 Des exercices Créer un flux nommé Test1 avec plusieurs composants existants Des questions? 11/01/2019

20 Importation en production
Transférer depuis Projets utilisateurs à ICS le flux visé: par Drag/Drop Il faut que chaque composant déjà existant (pas nouveau) soit arrêté pour pouvoir être mis à jour 11/01/2019

21 Mise à jour des composants en production
Les mises à jour sont d'abord enregistrées dans le référentiel (DB2) Pour que ces mises à jour soient prises en compte par l'ICS, faire: Clic droit sur l'instance d'ICS Sélectionner Régénérer Aussi ... 11/01/2019

22 Mise à jour des composants en production
Une action supplémentaire peut être nécessaire pour réaliser la mise à jour de certains types de composants: Un Business Object: Création d'un BO: arrêt/démarrage de l'ICS Différents changements dans un BO: arrêt/relance de l'Agent Une Collab: Des changements de Propriétés: mise à jour dynamique Des changements de code Java: mise à jour dynamique Un connecteur: Ajout d'un nouveau connecteur: arrêt/relance de l'ICS Suppression d'un connecteur: supprimer d'abord les Collaborations objects dépendants Modification/suppression d'un BO dans un connecteur: arrêt/relance du connecteur ... 11/01/2019

23 Préparation, modifier les Propriétés
Pour les Collab, les Maps, les connecteurs pour modifier: les niveaux de trace (Map) les niveaux de transactionnel, le mode de reprise, … (Collab) 11/01/2019

24 Préparation, compiler Pour les Template, les Maps 11/01/2019

25 Préparation, ICS et ICS ICS de développement: ICS de Prod:
un flux peut être livré sans que tous les composants soient présents ICS de Prod: un flux doit être livré avec tous ses composants (intégrité des références) pour livrer de l ’un à l ’autre, faire: Exporter en tant que fichier de référentiel 11/01/2019

26 Tests unitaires Disponibles pour: connecteur Map Template 11/01/2019

27 Tests unitaires pour un connecteur
Pour ces tests: communiquer en IDL (pas en MQS) faire du Key polling (pas du polling « à l ’horloge ») utiliser la fonction Virtual test connector (VTC) 11/01/2019

28 Tests unitaires pour un connecteur
La VTC: agit comme un Agent (si un Agent existe pour ce connecteur et est démarré, il faut l ’arrêter) lancement: par Démarrer/Programmes/… la 1ere fois: créer un profil (la configuration) Ici, 2 VTC 11/01/2019

29 Des exercices Réaliser des tests du connecteur JDBC avec le VTC
Des questions? 11/01/2019

30 Tests unitaires pour une Map
Dans le Designer sélectionner l ’onglet Test renseigner : Le nom de l’ASBO Le Contexte appelant les valeurs des attributs ... L ’ASBO Le GBO 11/01/2019

31 Tests unitaires pour une Map
Les valeurs apparaissent dans les attributs de l’objet Cible, ce qui permet de vérifier que la Map a réalisé les actions attendues Les valeurs Cible, en grisé Les valeurs Source 11/01/2019

32 Tests unitaires pour une Template
Réaliser avec une version squelettique du/des GBO concernés 11/01/2019

33 Tests intégrés pour un flux
Lancer : Les Agents Les statistiques de la Collaboration Les composants du flux L’outil déclencheur de l ’événement 11/01/2019

34 Tests intégrés pour un flux
Lancer un Agent: clic sur son icône une fenêtre noire s ’ouvre Si ce connecteur "Poll" en attente d'un événement, plusieurs lignes font défiler dans la fenêtre à l'expiration de chaque intervalle de polling; sinon la fenêtre reste stable. Laisser ces fenêtres d'Agent ouvertes autant que nécessaire; elles permettent de voir "passer" les Business Objects traités par chaque connecteur, si les Trace sont activées Une fenêtre DOS par Agent 11/01/2019

35 Tests intégrés pour un flux
L ’état d ’un Agent? (starté?) Dans la vue ICS: clic droit sur le groupe Connectors Aperçu ici 11/01/2019

36 Tests intégrés pour un flux
Lancer les statistiques de la Collab: pour voir passer les occurrences du flux Dans la vue ICS: clic droit sur la Collab Statistiques ici 11/01/2019

37 Tests intégrés pour un flux
Lancer les composants du flux: connecteurs Maps Collab Signalétique vert, rouge, ... 11/01/2019

38 Tests intégrés pour un flux
Lancer l’outil déclencheur de l ’événement pour: écrire dans une table Events (pas obligatoirement avec un Trigger) envoyer un message MQS envoyer un fichier 11/01/2019

39 Des exercices Réaliser un test du flux utilisant le connecteur JDBC
Des questions? 11/01/2019

40 Debugging Conserver les fenêtres DOS des connecteurs ouvertes
Conserver Statistiques ouvert pour vérifier que les Agents sont Active Consulter les fichiers Log Consulter les fichiers Trace 11/01/2019

41 Debugging, le Log Les fichiers Log contiennent les messages envoyés par les composants concernés le Loging est toujours actif Il concerne: L'ICS La Collaboration Le connecteur En Windows 11/01/2019

42 Debugging, le Log Les informations sont envoyés vers:
La console STDOUT, par défaut Un fichier Log, si une spécification en a été faite Le format des fichiers Log est décrit dans le document Problem determination guide 11/01/2019

43 Debugging,le fichier Log de l ’ICS
Nommé InterchangeSystem.log Dans le répertoire de base de l’ICS un « incontournable » Très utilisé 11/01/2019

44 Debugging, la Trace Le Tracing permet de disposer d'informations détaillées concernant les actions prises par les composants concernés Le Tracing n'est actif que s'il a été spécifié Il concerne plusieurs types composants: L'ICS, la Collaboration, le connecteur, la Map, les BO 11/01/2019

45 Debugging, les fichiers
Par défaut, il existe un seul fichier Log et sa dimension est spécifiée Illimitée Pour une bonne exploitation il est utile de: Spécifier une dimension maximum pour le fichier Log De cette manière, quand le fichier Log atteint cette dimension, il est automatiquement archivé et un nouveau fichier est créé Spécifier un nombre >1 pour le fichier Archive De cette manière, quand un nouveau fichier est archivé, les fichiers Archive existants voient leur indice augmenté de 1 et le plus ancien est supprimé 11/01/2019

46 Des exercices Des questions? 11/01/2019

47 Fin du module Vos remarques et commentaires peuvent être notés sur la page concernée ou sur cette page avant de les transmettre à votre interlocuteur Ils aideront à améliorer cette initiation 11/01/2019