Transaction MultiPLeXeur (TMPLX)

Manuel de l'utilisateur

Rvision 1.0

Utilisation des produits
________________________

Ce produit a t test selon des normes de contrle de qualit.  ROBERT LAFLAMME n'est pas responsable d'une mauvaise utilisation du produit.  L'utilisateur doit respecter les rgles dfinies dans ce manuel.  Si certains problmes techniques sont rencontrs, l'utilisateur peut contacter le soutien technique de ROBERT LAFLAMME par eMail  l'adresse suivante: rlafla@excite.com.

Introduction
____________

Le produit TMPLX se compose de deux applications dveloppes en Visual Basic (STMPLX, MTMPLX) et un OCX (CTLTMPLX) pouvant facilement tre intgr dans des outils de dveloppement comme Visual C++, Delphi ou Visual Basic.  L'OCX de TMPLX interpelle l'application STMPLX (Serveur TMPLX).  L'application MTMPLX gre la base de donnes d'exploitation de TMPLX.

Principe de fonctionnement
__________________________

Le serveur et le gestionnaire TMPLX (STMPLX et MTMPLX) sont le noyau autour duquel graviterons les applications clients dveloppes par l'utilisateur.  Les applications clientes de TMPLX sont conues en intgrant l'OCX CTLTMPLX dans leur code.  Grce  l'OCX de TMPLX, celles-ci peuvent se connecter au serveur STMPLX, transmettre et recevoir des transactions du serveur TMPLX.  La tche du serveur STMPLX est d'analyser une  transactions reue d'un client et l'expdier aux clients auxquels elle est destine.  Les clients destinataires sont slectionns en fonction des paramtres contenus dans la base de donnes d'exploitation de TMPLX.

Installation de TMPLX
_____________________

Logiciel requis :



L'ordinateur sur lequel vous installez TMPLX doit avoir le " RUN TIME " de Visual Basic 5.0 install au pralable

Installation du logiciel TMPLX.

0. " Unzip " le fichier compress dans un rpertoire de travail.  Vous obtiendrez des sous-rpertoires des lments constituant TMPLX.


TMPLX s'installe en trois phases bien distinctes.

1. L'installation du serveur STMPLX

Sur l'ordinateur cible, excuter le programme StmplxSetup.exe (sous-rpertoire Stmplx\Disque1) et suivre les instructions de l'interface d'installation. 

2. L'installation du gestionnaire MTMPLX

Sur le mme ordinateur que l'ordinateur o est install STMPLX, excuter le programme MtmplxSetup.exe (sous-rpertoire Mtmplx\Disque1) et suivre les instructions de l'interface d'installation. 

3. L'installation de l'OCX CTLTMPLX dans l'environnement de dveloppement.

Sur l'ordinateur de dveloppement dsir, excuter le programme CtltmplxSetup.exe (sous-rpertoire Ctltmplx\Disque1) et suivre les instructions de l'interface d'installation.

Paramtrisation de la base de donnes d'exploitation
____________________________________________________

La base de donnes de TMPLX est gre par l'application MTMPLX.  Pour changer des donnes entre des clients de TMPLX, l'utilisateur doit dfinir les clients, les units d'un client aptes  recevoir des transactions et les enregistrements qu'un client peut recevoir.

L'interface usager MTMPLX permet de raliser les activits de gestion de la base de donnes.  La section "Exemple d'utilisation de MTMPLX" dmontre la faon de crer un environnement d'exploitation de TMPLX.


Utilisation de CTLTMPLX
_______________________


Se connecter et se dconnecter
______________________________

Pour fonctionner, une application dveloppe  l'aide de CTLTMPLX doit communiquer avec le serveur STMPLX.  Pour tablir cette communication, il faut avant tout que l'adresse IP et le port de connexion au serveur STMPLX soient bien initialises.  Ces valeurs sont contenues dans des entres de registre de WINDOWS pour l'OCX de TMPLX (nous verrons plus loin les entres de registre WINDOWS de l'OCX et les valeurs de dfaut).  Les entres de registres sont dfinies  la premire excution de l'OCX CTLTMPLX.  Le programmeur de l'application intgrant l'OCX peut aller modifier ces entres de registre par les appels de fonction standard de Visual Basic pour les entres de registre (fonctions GetSettings, SaveSettings, etc...) ou par le programme " Regedit " de Windows.

Par la suite, les proprits ClientIdent et ClientPassword doivent tre initialises par des valeurs conformes au contenu de la base de donnes oprationnelle TMPLX (un enregistrement de client valide et son mot de passe associ).  Ensuite, le dveloppeur doit appeler la mthode ConnectToServer.  L'OCX retourne un vnement ConnectionEnd avec la proprit Error_Code initialise en fonction de l'tat de la connexion.

L'OCX aprs une connexion valide retourne dans les collections UnitsIdRef, RecordsIdRef, RecordsPositionRef et RecordsValueRef tous les liens aux units et aux enregistrements du client connect.  Ainsi l'application qui intgre l'OCX TMPLX offre au programmeur un moyen de valider les transactions en fonction des units et des enregistrements dfinis.  C'est de la responsabilit du programmeur de l'application client de raliser cette validation et de prendre les actions requises.


Connatre les units du client connect
_______________________________________

La collection UnitIdRef est rendue disponible au dveloppeur par l'OCX de TMPLX.  Cette collection permet de savoir qu'elles sont les units de la base de donnes TMPLX qui sont lies au client connect par la mthode ConnectToServer.  Le programmeur obtient l'identifiant des units par la proprit Item de la collection.

*** Attention ***    la modification de cette collection par le programme n'a aucun impact sur le fonctionnement de l'OCX.


Connatre les enregistrements du client connect
________________________________________________

Les collections RecordsIdRef, RecordsPositionValue et RecordsValueref sont rendues disponibles au dveloppeur par l'OCX de TMPLX.  Ces collections permettent au programmeur de connatre qu'elles sont les enregistrements et leurs dfinitions qui sont lies au client connect par la mthode ConnectToServer.  Le programmeur obtient les informations relatives  un enregistrement li par la proprit Item des collections.

*** Attention ***    la modification de cette collection par le programme n'a aucun impact sur le fonctionnement de l'OCX.


L'envoie d'une transaction au serveur STMPLX
____________________________________________

Le dveloppeur est responsable de formater les transactions qu'il dsire transmettre au serveur pour aiguillage aux autres clients connects au serveur STMPLX.

La mthode Send_To_Server permet de transmettre au serveur une transaction formate par l'application client mettrice.  Cette mthode requiert l'initialisation des valeurs suivantes:


More_Transaction_For_This_Send
------------------------------

Variable de type boolenne, elle peut prendre la valeur "True" ou "False".  

C'est un indicateur qui permet le dclenchement du processus de transmission vers le serveur.  Si la valeur est "False", la transmission est initie immdiatement.

Si la valeur est "True", l'OCX accumule les transactions dans son processus interne et les transmettra en squence lorsque l'application lui spcifiera d'initier le processus de transmission.

Cet indicateur a t labor pour faciliter la gestion des transactions multiples par le dveloppeur.  Celui-ci n'a pas  se proccuper des dlais entre chaque transaction.  C'est l'OCX qui en est responsable.

Par exemple,  toutes les dix (10) minutes, une unit transmet 20 transactions.  Le programme client reoit les 20 transactions de l'unit et les formate selon ses besoins avant de les transmettre au serveur via une boucle en utilisant l'indicateur More_Transaction_To_Send  "True" pour les 19 premires transactions et  "False pour la transaction numro 20.


Ident_Of_Destination
--------------------

C'est l'identifiant de l'unit  qui la transaction doit parvenir.


Data_To_Send
--------------------

C'est la transaction qui doit tre achemine  l'unit spcifie par Ident_Of_Destination.


L'vnement ConnectionEnd
_________________________


C'est l'vnement qui est dclench par l'OCX pour indiquer  l'application client le statut de la connexion au serveur STMPLX.  Le fichier d'extension "lng" du rpertoire hbergeant l'OCX de TMPLX (CTLTMPLX.ocx) donne la signification des codes de retour.  Ce sont les valeurs que peuvent prendre les proprites Error_Code et Error_Message de l'OCX TMPLX.


L'vnement NewDataFromServer
_____________________________


C'est l'vnement qui indique que le client a reu une transaction du serveur STMPLX.  Cet vnement retourne l'identifiant de l'unit mettrice de la transaction et la transaction elle-mme.  Les variables Id_Unit et Data_Unit contiennent respectivement l'identifiant et la transaction.

Le dveloppeur est responsable de programmer les traitements pertinents des donnes reues.


La cration d'entres de registre pour les applications clients
_______________________________________________________________


Pour l'OCX de TMPLX, les entres de registre se crent sous le nom d'application TMPLXocx par dfaut.

Il est possible que ces entres de registre soient cres sous un autre nom d'application.  Le programmeur doit alors inclure dans le rpertoire de l'application un fichier appel IdAppl.txt contenant une seule ligne sur laquelle est inscrit le nom d'application dsir.

Cette fonction supplmentaire permet d'avoir pour chacune des applications clients hberges par le mme ordinateur des entres de registre diffrentes pour chacune des applications.  Ceci offre la possibilit de modifier les paramtres de fonctionnement d'une des applications sans modifier ceux de l'autre.

Exemple d'utilisation de MTMPLX
_______________________________

 l'initialisation de MTMPLX, l'utilisateur reoit un panorama demandant de donner le code d'autorisation pour utiliser l'application MTMPLX.  Par dfaut, ce code d'autorisation est " tmplxLogON ".

Aprs la soumission du bon code d'autorisation, le panorama de gestion de MTMPLX est affich.

Posons comme hypothse que nous dsirons que le client No1 puisse recevoir des donnes de l'unit ZC6 et que les transactions recevables soient les enregistrements Un et Deux lesquels sont des enregistrements avec le code GO1 en position quatre de l'enregistrement et le code GO2 en position 7 de l'enregistrement.  

Alors avec l'application MTMPLX, on ajoute un client.  Ceci ouvre une fentre dans le panorama.  Inscrire la valeur No1 dans la zone " Clients ", la description du client dans la zone " Description ", le mot de passe pour ce client dans la zone " Mot de passe " et le mot de passe de vrification pour ce client dans la zone " Vrification du mot de passe ".  Ensuite, appuyer sur le bouton " Traitement ".  Vous venez d'inscrire le client No1 dans la base de donnes d'exploitation de TMPLX.

Faire le mme type de traitement pour ajouter une unit.  Toutefois, il n'y aura que la zone Units et Description  complter.

Faire deux fois le mme type de traitement pour ajouter les enregistrements  dfinir. Spcifier pour l'enregistrement " Un ", la valeur 71;79;49 et la position 4 et pour l'enregistrement " Deux ", la valeur sera 71;79;50 et la position 7.

Note : si vous dsirez qu'un client reoive tous les enregistrements des units qui lui sont lies, vous devez lier ce client  un enregistrement sans code d'enregistrement.  Dans ce cas, vous devriez avoir dans la base de donnes oprationnelle de TMPLX un enregistrement par exemple, appel " SansCode " avec une position  zro (0).  Un client qui sera li  cet enregistrement recevra tous les enregistrements des units qui lui sont lies.

Un dernire tape permet de lier les units et les enregistrements  un client.  Ouvrir le menu droulant pour la zone " Clients ".

Vous obtenez la liste des clients dj inscrits  la base de donnes oprationnelle de TMPLX.  Slectionner le client No1.  Vous obtenez la fentre de modification ou de suppression de client.  Celle-ci offre deux boutons de liaison, celui pour les units et celui pour les enregistrements.  Cliquer sur le bouton " Liaison units " et vous obtenez une autre fentre  droite.  Dans la partie non-li de la nouvelle fentre, slectionner ZC6 et cliquer sur la flche vers la droite.  Vous venez de lier l'unit ZC6 au client No1.

Le mme processus doit tre suivi pour les enregistrements  lier au client.

***   Attention   ***   il est recommand de prendre rgulirement des copies de scurit de la base de donnes TMPLX.mdb.
