Comment intégrer des données dans TOLTECH
Comment intégrer des données dans TOLTECH1
2. Enregistrement d'une macro2
3. Le fichier contenant les données à intégrer3
3.2. Enregistrement "classique"4
3.4. Si vous chargez directement vos données dans la table INTERFACE_IN5
5. Suivi des traitements batch7
6. Comment exécuter une macro ?8
1.Introduction
Qu'est-ce qu'une macro ?
C'est une suite d'instructions Toltech du style : je saisis un code article, je mets à jour le code responsable, j'appuie sur le bouton de mise à jour.
Dans quels buts l'utiliser ?
- Importer des données d'un autre logiciel
- Exécuter une tâche Toltech sur une série de données
Pourquoi utiliser une macro ?
Pour que les données traitées soient vérifiées exactement comme si elles étaient manuellement saisies
Note : Toutes les transactions exécutées habituellement dans TOLTECH en temps réel peuvent l'être automatiquement sans intervention de l'utilisateur.
2.Enregistrement d'une macro
La macro va donc contenir le modèle des enregistrements que vous allez soumettre ensuite.
Pour démarrer l'enregistrement d'une macro, il faut se placer sur la transaction que vous voulez simuler, ouvrir le menu Gestion et choisir l'option 'Démarrer enregistrement'.
 |
Une fois activé, ce drapeau permet de traquer toutes les manipulations faites sur une transaction et d'enregistrer alors dans les tables TOLTECH les actions effectuées à la mise à jour de la transaction.
Chaque champ saisi doit obligatoirement être validé par la touche Tabulation.
Si vous devez saisir des éléments d'un tableau préférez la touche Inser de votre clavier plutôt que clic droit + Insérer ligne (cette dernière fonction n'est pas détectée dans ce module)
Après avoir saisi tous les champs, faire votre mise à jour (création, modification ou suppression) puis repasser dans le menu Gestion pour choisir 'Arrêter enregistrement'. L'écran suivant est affiché. Il récapitule la liste des champs que vous allez renseigner.
Ce tableau montre toutes les actions qui seront effectuées par l'automate. Toutes les colonnes sont modifiables et les actions peuvent être supprimées ou de nouvelles ajoutées.
- La colonne 'Action No' indique la séquence dans laquelle les actions seront exécutées, ceci par ordre croissant.
- La colonne 'Transaction' indique le nom interne de l'écran TOLTECH qui est concerné.
- La colonne 'Objet' indique le nom interne de l'objet de cet écran qui sera alimenté ou invoqué.
- La colonne 'Libellé' correspond au libellé de la zone dans l'écran TOLTECH correspondant.
- La colonne 'Numéro de colonne ' indique la position où se trouve la donnée dans le fichier en entrée.
- La zone 'batch' (qui contient ici 'ARTICLES') est le nom de votre macro et devra toujours être la 1ère colonne de votre fichier en entrée.
- Si la boîte de dialogue contient les informations que vous souhaitez alimenter dans TOLTECH, appuyez sur le bouton 'Sauvegarder'. Le bouton 'Continuer' permet d'ajouter des actions à la macro en cours d'enregistrement.
3. Le fichier contenant les données à intégrer
L'automate accepte des fichiers textes en ASCII ou bien le chargement d'une table de la base de données Oracle (INTERFACE_IN).
Comme vous êtes libres de simuler toute transaction, le format du fichier dépend donc de l'ordre dans lequel vous avez enregistré votre macro. Le nom que vous donnez à votre macro occupe toujours la 1ère colonne du fichier en entrée, c'est la colonne '0' que vous ne verrez pas dans le tableau de la boîte de dialogue.
Les guillemets sont facultatifs, cela permettra de charger des données contenant votre séparateur.
Le séparateur de champ est paramétrable sur l'écran de lancement de l'automate.
Toute macro doit correspondre à 1 et un seul enregistrement dans le fichier en entrée quel que soit le nombre de boîtes de dialogues qui composent votre transaction. Ainsi pour la fiche article, la désignation, le mode d'appro ou le numéro de compte devront être sur le même enregistrement de votre fichier en entrée bien que ces données soient sur des boîtes de dialogue différentes. Il n'y a pas de limitation sur la taille d'un enregistrement du fichier en entrée.
Le nom du fichier ainsi que son emplacement sur votre ordinateur sont libres, ils vous sont demandés lors du lancement de L'automate. Plusieurs commandes peuvent se trouver dans un fichier en entrée, toutefois, la vitesse d'exécution est meilleure lorsque des transactions identiques se suivent.
Pour ajouter un nouveau client, l'enregistrement pourrait être de la forme
ADDCUSTOMER;Dummy;SAT01;Satellite Inc;Satellite;25 Mars Avenue;Universal Park;78440;Buchelay;F;CL ;
ADDCUSTOMER;Dummy;SAT02;Satellite Corp;SatelliteC;25 Jupiter Avenue;Universal Park;78440;Buchelay;F;CL ;
Ici, le séparateur ' ;' est utilisé pour séparer les champs. Chaque champ se trouve à la position qui lui est assignée dans la petite boîte de dialogue en partant de 0. Ainsi, la zone 'SAT02' qui se trouve en colonne 2 du fichier en entrée sera chargée dans la zone 'dfTiers' de la transaction 'CLIENT' car sa valeur dans 'Column No' est 2.
La zone '78440' se trouve dans la colonne 7 du fichier en entrée, elle correspond donc sur l'exemple à la zone 'Code postal' comme l'indique la colonne 'Column No'.
Ce type d'enregistrement va être utilisé pour enregistrer une commande par exemple. Les données d'en-tête et de ligne sont sur le même enregistrement.
Attention : les données d'en-tête doivent toujours composer les premières colonnes de votre enregistrement.
Si vous devez saisir des éléments d'un tableau préférez la touche Inser de votre clavier plutôt que clic droit + Insérer ligne (cette dernière fonction n'est pas détectée dans ce module)
Dans le cas d'une trame de création de commande par exemple, nous aurons les enregistrements suivants :
ADDORDER;SAT01;Satellite Fir-st order
;01/01/99;BIKE1;1;
ADDORDER;SAT01;Satellite Fir-st order ;01/01/99;BIKE2;3;
ADDORDER;SAT02;Satellite Corp first order ;02/02/99;SPORTCAR1;2;
ADDORDER;SAT02;Satellite Corp first order ;02/02/99;SPORTCAR2;4;
Les manipulations sont faites directement en Sql
BEGIN
charge_interface('ADDORDER','SAT01;Satellite Fir-st order
;01/01/99;BIKE1;1',sysdate);
charge_interface('ADDORDER','SAT01;Satellite Fir-st order
;01/01/99;BIKE2;3',sysdate);
.....
commit;
END;
Note : Pour que ces enregistrements soient pris en compte, le service Toltech doit être démarré.
4.Mise en route
C’est par l’intermédiaire de l’écran suivant que vous pouvez intégrer des données extérieures dans TOLTECH.
 |
§ Notez dans ce cadre, le nom du fichier à importer en précisant le séparateur de champs ou bien copiez les enregistrements à intégrer dans le champ ‘Enregistrement’.
§ Si vous cochez, ‘par position’ ; vous devrez, dans la macro d’importation, avoir précisé la position de chacun des champs.
§ Recycler les anomalies : n’est pas actif dans cette version
§ Boucler : Permet de scruter un répertoire à chaque cycle, il faut donc le cocher pour que Automate tourne en permanence (cas normal), sinon, il va fonctionner une fois, au moment du OK et puis compter les secondes qui s’écoulent.
§ Ne pas exécuter :A utiliser si on veut juste intégrer le fichier dans les tâches de l’Automate (dans la base) mais ne pas l’exécuter par le processus qui a soumis les données. Utile pour des gros fichiers soumis par des utilisateurs s’il existe un serveur qui traitera effectivement les données.
§ Générer les trames :Si cette case est cochée, l'automate peut s’occuper de générer les fichiers en sortie, dans le cas contraire, il ne le fait pas, et c’est BATCHMGR qui doit alors le faire (si le paramètre TRAME_SUR_BATCHMGR est à ‘O')
Fichier log
5.Suivi des traitements batch
Ecran de visualisation des enregistrements en cours de traitement, des fichiers traités et de l'état du service automate
Le premier tableau vous donne la liste des fichiers en cours de traitement
Le premier cadre donne la liste des fichiers fournis à l'automate.
L'état vous indique si le fichier a été traité ou non. A=en attente de traitement; B=bloqué par une ou plusieurs anomalies (voir la colonne 'Anomalies') ou bien en cours de traitement
Si vous sélectionnez une ligne dans ce tableau, les enregistrements en erreur correspondants à ce fichier vont être affichés dans le 3ème tableau
Le second tableau montre la liste des automates en cours. Dans la version actuelle, un seul automate peut être soumis.
Le troisième tableau vous indique la liste des enregistrements en erreur. Faites un double clic sur la ligne pour retrouver le message en temps réel.
6.Comment exécuter une macro ?
Principe : Prendre une série de données dans Toltech et leur appliquer immédiatement, les mêmes modifications.
Exemples : Valider une série de factures clients
Annuler le lancement d'une série d'OF
Contrainte : il faut que la sélection des enregistrements soit simple : qu'elle puisse facilement être faite à partir d'une picking
Mode opératoire :
- Sélectionnez à partir d'une picking une série d'enregistrements à mettre à jour
 |
Conseils pour la sélection
- Pour sélectionner une série de numéros, cliquez sur le premier, enfoncez la touche Shift, puis cliquez sur le dernier.
- Pour sélectionner un numéro non consécutif à ce qui est déjà sélectionné, maintenez la touche Ctrl enfoncée.
- Pour DéSélectionner un numéro dans une série, maintenez la touche Ctrl en même temps que vous sélectionnez la ligne.
- Faites
la manipulation (modification de champs, validation de boutons, etc. cette
manipulation se termine obligatoirement par l'un des trois boutons de mise
à jour
)
sur le premier enregistrement.
Lorsque vous allez valider la mise à jour du premier enregistrement, le message suivant apparaît
Si vous répondez Oui à cette question, le système fera exactement les mêmes opérations sur les autres éléments sélectionnés dans la picking.
Contrainte : il faut que le service Toltech soit démarré
Si nous prenons l'exemple d'annuler une série d'OF lancés par erreur, la macro que vous devez avoir doit ressembler à celle-ci :
Vous allez alors devoir générer un enregistrement qui sera du format : ANNULLCT;monof;