Description de l Automate de Transfert

Transcription

1 Descriptin de l Autmate de Transfert Généralités... 2 Paramétrage général... 3 Définitin des tâches... 4 L activité en curs... 6 Mise en rute... 7 Piltage par SQL... 8 Gestin table de traitement... 9 Serveur DDE (Echange dynamique de dnnées) Lien e-cmmerce Annexes Stckage des infrmatins Objets pur l autmate Présentatin Pré-requis Mise en place du service Créatin du service Paramétrage du service Démarrage du service : Suppressin du service Versin Date Descriptin Versin lgiciel Versin WaveSft 8 14/11/2014 Impressin pièces à l imprt /11/2013 Serveur DDE /09/2012 Lien e-cmmerce /12/2011 Piltage via SQL /01/2010 Fréquence par tache /11/2005 Reprt des mdificatins /03/2005 Ajut des exprts via le requêteur WaveSft 1 01/03/2005 Original Cpyright WaveSft 1/19

2 Généralités L Autmate de Transfert permet d autmatiser des pératins d imprt & d exprt. Ces pératins de transferts peuvent s effectuer d une base WaveSft vers une autre, u vers une applicatin tierce u par exemple un site Internet marchand spécifique. Principales caractéristiques : - Pssibilité de paramétrer des échanges entre N Serveurs SQL et N Dssiers WaveSft - Les frmats d échanges utilisent les prfils définis dans le menu «Transferts». - Les frmats d exprt peuvent utiliser une requête SQL définie dans le requêteur WaveSft du mdule d administratin. - Les exprts peuvent être cmplets u différentiels. - 3 mdes de lancement pssibles : - En mde Paramétrage [-M] : Permet d exécuter le Serveur de Transfert sans qu aucune tâche autmatisée ne sit exécutée. Ce mde permet le paramétrage du serveur sans interférence avec le dérulement des transferts. - En mde Autmatique [-A] (défaut) : Le serveur exécute les tâches définies cycliquement en fnctin de la fréquence d activatin exprimée en minutes. - En mde Planificatin [-P] : Ce mde permet d exécuter une seule fis tutes les tâches définies (par exemple via le planificateur des tâches Windws) puis l Autmate se ferme. Le mde est défini cmme paramètre de cmmande lrs du lancement de l exécutable. Exemple :.wavetrans.exe» M (lancement en mde paramétrage). Cpyright WaveSft 2/19

3 Paramétrage général L écran «Paramétrage général» permet de définir les caractéristiques principales de l autmate : Paramètres : - Répertire des fichiers de traces : Emplacement des fichiers de traces retraçant l histrique des actins effectuées par l Autmate. Un fichier est généré par jurnée d activité, si aucun emplacement n est indiqué les fichiers de traces ne snt pas générés. - Fréquence d activatin : Définie la péridicité d activatin (en minutes) dans le cas de l utilisatin de l Autmate en mde autmatique. Mettre 0 uniquement en mde P. - Tujurs actif : Si cché en mde autmatique l Autmate est tujurs actif, sinn n peut définir une péride d inactivité durant laquelle aucune tâche n est effectuée. Cela permet d effectuer par exemple des pératins de maintenance sur le Serveur physique (Sauvegarde, ) sans risque d interactin. Cnnexin par défaut : - Permet la définitin d une cnnexin principale. Serveur : Nm du Serveur de base WaveSft Dssier : Nm du dssier Utilisateur : Nm de cnnexin utilisateur utilisé dans les lgiciels WaveSft. Mt de passe : Mt de passe de cnnexin utilisé dans les lgiciels WaveSft. Cpyright WaveSft 3/19

4 Définitin des tâches L écran «Définitin des tâches» permet de paramétrer pur chaque Serveur WaveSft et dssiers les différentes tâches à accmplir, le nmbre de Serveur et de tâches n est pas limité. Les tâches s exécutent dans l rdre défini dans les deux listes, les flèches vertes sur la drite des listes permettent de mdifier cet rdre. Définitin d un dssier : Nm du serveur WaveSft, Nm du dssier, Utilisateur et mt de passe, Répertire des imprts et des exprts. Tuche d aide : F2 Définitin d une tâche : - Nature : Imprt u Exprt u ecmmerce - Entité : Définitin des bjets sélectinnables : Actins : Imprt u Exprt en créatin u mdificatin Adresses livraisns clients : Imprt (annule & remplace) u Exprt Adresses livraisns prspects : Imprt (annule & remplace) u Exprt Articles : Imprt u Exprt en créatin u mdificatin Articles valrisatin : Exclusivement réservé pur la «Gestin Prductin» Clients : Imprt u Exprt en créatin u mdificatin Cmmerciaux : Imprt u Exprt en créatin u mdificatin Cmptes : Imprt u Exprt en créatin u mdificatin Cntacts clients : Imprt (annule & remplace) u Exprt Cpyright WaveSft 4/19

5 Cntacts furnisseurs : Imprt (annule & remplace) u Exprt Cntacts prspects : Imprt (annule & remplace) u Exprt Ecritures : Imprt u Exprt en créatin Familles articles : Imprt u Exprt en créatin u mdificatin Familles prduits : Imprt u Exprt en créatin u mdificatin Furnisseurs : Imprt u Exprt en créatin u mdificatin Nmenclatures : Imprt u Exprt en remplacement Pièces d achats: Imprt u Exprt en créatin Pièces de ventes : Imprt u Exprt en créatin Pièces divers : Imprt u Exprt en créatin En imprt de pièces, impressin autmatique en fnctin du paramétrage de la nature de pièce (Onglet «Suche» ) Prduits : Imprt u Exprt en créatin u mdificatin Prspects : Imprt u Exprt en créatin u mdificatin Requêtes : Exprt en créatin u mdificatin Tarifs : Imprt u Exprt en créatin u mdificatin Tarifs particuliers : Imprt u Exprt en créatin u mdificatin Tarifs prduits : Imprt u Exprt en créatin u mdificatin WEB : Imprt cmmandes E-Cmmerce u MAJ site pur stck article u MAJ état des cmmandes. Vir Guide E-Cmmerce pur tut cmplément d infrmatin. Pur l état d avancement des cmmandes, n met à disp sur le site la facture en PDF. Il faudra dnc que le driver PDF utilisé par WaveSft sit installé sur la machine ù est exécuté l autmate. - Prfil : Nm du prfil d I/E utilisé par l Autmate pur l bjet cncerné. Prfil défini dans le dssier dans la partie Administratin «Transferts». Pas de Prfil pur un I/E de pièces. On s appuie là sur les Fiches Techniques crrespndantes. Cf I/E manuel. Adresse web du site. - - Préfixe du fichier : le préfixe est cmplété par la date de façn à être unique en Exprt. Obslète pur les natures ecmmerce - - Séparateur : Tabulatin u Pint-virgule. Ce dit être le séparateur des décimales paramétré sur le système du pste. Obslète pur les natures ecmmerce. - - Types : Cmplet u Mise à Jur (par rapprt à la date du dernier exprt) Un mde «Créatin» permet pur les exprts, de n exprter que les bjets cncernés créés depuis le dernier exprt. Obslète pur les natures ecmmerce. - Dernière date : date du dernier exprt - - Fréquence : permet de définir la fréquence d une tâche Valeur 0 u 1 : la tâche est exécutée à chaque fis Valeur 2 : la tâche est exécutée 1 fis sur 2 Valeur 3 : la tâche est exécutée 1 fis sur 3 etc. Dans l exemple, la fréquence d activatin générale est de 15 minutes. Les tâches 2, 3 et 5 (Fréquence 0) snt exécutées tutes les 15 minutes. Les tâches 1 et 4 (Fréquence 4) snt exécutées 1 fis sur 4, sit tutes les 60 minutes. Cpyright WaveSft 5/19

6 L activité en curs L écran «Activité en curs» affiche tute l activité de l autmate de transfert ainsi que les anmalies éventuelles. Si vus avez indiqué dans l nglet «Paramétrage général» un répertire pur les fichiers de trace, cette activité sera enregistrée de façn jurnalière dans un fichier de trace. Cpyright WaveSft 6/19

7 Mise en rute Lrs de la première utilisatin de l autmate, démarche à suivre : Pur un bn fnctinnement, veillez à saisir la licence de l autmate dans un premier temps. Si l autmate de transferts n apparait pas dans la liste des applicatins pur lesquels vus demandez un enregistrement, il faut l exécuter au mins une fis en ayant paramétré une cnnectin à une base de dnnées WaveSft. Vir écran «Paramétrage général» 1 Lancer l applicatin «WaveTrans.exe», l applicatin s icnifie autmatique dans le «System Tray» à drite de la barre des tâches. 2 Pur uvrir l applicatin cliquer sur l icône à l aide du butn drit de la suris. 3 Pur initialiser l applicatin, veuillez remplir l écran «Paramétrage général». Puis relancer l applicatin de façn à enregistrer la nuvelle applicatin. 4 Vus puvez maintenant définir les différentes tâches que vus suhaitez réaliser et utiliser l autmate de transfert cmme vus le suhaitez. 5 Pur masquer l écran : cliquer sur la crix de fermeture de la fenêtre Pur arrêter l applicatin : cliquer sur le butn : Cpyright WaveSft 7/19

8 Piltage par SQL Ce mde permet de pilter les actins à entreprendre par l autmate via une table dans la base de dnnées. Le fnctinnement de l autmate peut être en mde mixte c'est-à-dire qu il peut cntinuer à traiter les tâches cycliques en parallèles des tâches que vus puvez lui affecter via la table de piltage. Le piltage par table de l autmate est pssible sur l ensemble des servers SQL définis dans la liste. Ce piltage ne fnctinne qu en mde imprt et pur un seul bjet par demande (enregistrement) de façn à puvir gérer plus précisément les infrmatins de retur. 4 articles à imprter, 4 enregistrements dans la table, 2 cmmandes à imprter, 2 enregistrements La fréquence de lecture de la table est la fréquence de base de l autmate. La table de piltage de l autmate : «WSAUTOMATE» COLONNE TYPE SENS DESCRIPTION TRSID Big-Integer Autmatique Identifiant autmatique TRSENTITE Integer Entrée Identifiant de l bjet à imprter, pièce, article (vir tableau en annexe) TRSPROFIL Varchar(25) Entrée Cde du prfil d imprt TRSSEPARATEUR Char(1) Entrée Séparateur du fichier (Tab = C u Pint-virgule = V ) TRSETAT Char(1) Entrée/Srtie Etat de l imprt (I : à faire, C : en curs, T : terminé, E : en erreur) TRSDELETE Char(1) Entrée Suppressin autmatique de la demande (O, N) TRSIDOBJET Big-Integer Srtie Retur de l identifiant de l bjet créé TRSCODEOBJET Varchar(50) Srtie Retur du cde de l bjet créé TRSERREUR Varchar(255) Srtie Message d erreur TRSFILE Text Entrée fichier de l bjet à imprter (le cntenu du fichier pas un lien sur un fichier) TRSETAT : Flag indiquant l état de la demande, le demandeur dit mettre «I» dans cette clnne l autmate gérant les autres états. Ne snt traité que les demandes en état «I», vus puvez si vus le suhaitez laisser les anciennes demande dans la table. TRSDELETE : Flag indiquant si c est le demandeur u l autmate qui dit supprimer la demande dans la table, en cas d erreur la demande n est pas supprimée. TRSFILE : Cette zne dit cntenir le cntenu de l équivalent fichier, avec exactement la même structure qui est fnctin du prfil indiqué dans la clnne TRSPROFIL. Dans le cas de frmat fixe, cmme les pièces la clnne TRSPROFIL n a pas besin d être renseignée. On peut cnsulter le cntenu de la table de traitement de l autmate, depuis le mdule administratin dans le menu «Administratin-Outils» de la Gestin Cmmerciale. On peut, mdifier les clnnes : ETAT et DELETE et supprimer un enregistrement Cpyright WaveSft 8/19

9 Gestin table de traitement Un util permet de cnsulter le cntenu de la table de traitement de l autmate. Cet util est accessible depuis le mdule administratin du P.G.I. dans le sus-menu «Outils». On peut : - Mdifier les clnnes : ETAT et DELETE - Supprimer un enregistrement L enregistrement des mdificatins et effectués par le butn «OK», le butn «Fermer» permet de quitter la fenêtre sans enregistrer de mdificatin. Le butn «Rafraichir» permet de réafficher la liste Cpyright WaveSft 9/19

10 Serveur DDE (Echange dynamique de dnnées) L autmate peut être pilté via un client DDE, pur déclencher le traitement à la demande, en remplacement du déclenchement séquentiel. Le traitement déclenché cncerne uniquement le piltage par la table SQL. Le nm du server DDE est : 'WSTRS' La chaine de cmmande est cmpsée de la cmmande du server SQL et du dssier. Une seule cmmande est dispnible pur l instant : 'READTABLESQL' Exemple : Handle = OpenChannel("WSTRS", 'System') ExecRemte('READTABLESQL;NmServer;NmDssier', Handle) Cpyright WaveSft 10/19

11 Lien e-cmmerce Gestin autmatique d'échange de dnnées entre vtre back ffice de gestin et vtre site marchand e- cmmerce Oxatis. Wavesft Autmate de Transferts est fait pur vus simplifier ces tâches en les autmatisant : - L'imprt des cmmandes Web Oxatis dans WaveSft. - La mise à jur des états des cmmandes Web sur Oxatis. - La mise à jur sur Oxatis des stcks qui nt évlués depuis la dernière MAJ des stcks, qu elle ait été effectuée manuellement u autmatiquement. Pur que la MAJ des stcks sit chérente, il cnvient de la paramétrer après l imprt des cmmandes. Sur l nglet «Définitin des tâches», paramétrez, pur chaque cuple (Serveur WaveSft, Dssier) les différentes tâches à accmplir par site. Le nmbre de sites géré est fnctin de l éditin de la Gestin : Standard : 1 site, Prfessinnelle : 2 sites, Entreprise : nmbre de sites illimité. Les tâches s exécutent autmatiquement par rapprt à la date/heure/minute/secnde de dernière mdificatin des dnnées dans la base de dnnées du PGI WaveSft et dans l rdre défini dans les deux listes. Les flèches vertes sur la drite des listes permettent de mdifier cet rdre. Pur plus de détails sur le fnctinnement e-cmmerce Oxatis, veuillez cnsulter le guide : "GUIDE e- Cmmerce Oxatis" Cpyright WaveSft 11/19

12 Annexes Autmate en tâche planifiée : Cmmencer dans (facultatif) : il s agit du répertire cntenant le fichier Data Il ne faut pas mettre de guillemet!!! Stckage des infrmatins L autmate de transfert étant multi-serveurs et multi-dssiers, les dnnées de paramétrage de cette applicatin snt stckées au frmat XML dans le répertire «data» au niveau de l applicatin. e stckage des paramètres est réalisé dans ces 3 fichiers : - wst_detailtaches.xml : Stckage du détail des tâches. - wst_listetaches.xml : Stckage de la liste des tâches. - wst_parametre.xml : Stckage du paramétrage général de l applicatin. Cpyright WaveSft 12/19

13 Objets pur l autmate Liste des valeurs pur la clnne TRSENTITE. OBJET IDENTIFIANT ECRITURE 1 COMPTE 2 CLIENT 4 FOURNISSEUR 5 COMMERCIAL 6 FAMILLE ARTICLE 7 ARTICLE 8 PRODUIT 9 NOMENCLATURE 11 PIECE DE VENTE 99 PIECE ACHAT 199 PROSPECT 13 PIECE DE STOCK 299 ACTION 14 FAMILLE PRODUIT 16 CONTACT CLIENT 121 CONTACT FOURNISSEUR 122 CONTACT PROSPECT 123 Cpyright WaveSft 13/19

14 Exemple de mise en Service de l Autmate sur Win 2008 Cette partie nécessite de bnnes cnnaissances en systèmes d explitatin. Cette partie est dnnée à titre d exemple. WaveSft ne supprte pas techniquement le paramétrage des OS. Présentatin 115 Pré-requis 115 Mise en place du service Créatin du service Paramétrage du service Démarrage du service : 118 Suppressin du service 119 Cpyright WaveSft 14/19

15 Présentatin Ce dcument présente les différentes étapes pur la mise en place de l exécutin de l autmate de transfert en tant que service Windws. Le Kit de ressurces Windws NT intègre deux utilitaires permettant de créer un service Windws NT défini par l'utilisateur pur les applicatins Windws. Instrsrv.exe permet d'installer et de supprimer les services système de Windws NT et Srvany.exe permet d'exécuter tute applicatin Windws NT en tant que service. Il faut bien sur, avant de cnfigurer ce service s être assuré que l autmate de transfert est crrectement paramétré. Pré-requis If vus faut dnc déjà installer ce kit de ressurces si ce n est déjà fait. Lien de téléchargement du kit cmplet sur le site Micrsft pur un 32 bits : Cnseil : ne pas installer dans le répertire par défaut, mais plutôt par exemple dans C:\RESKIT, plus simple pur la suite. Vus puvez aussi télécharger sur l Espace revendeur dans «Utilitaires» le répertire «RESKIT» cntenant les 2 exe nécessaires. Unique prcédure valable pur un 64 bits, aussi valable pur un 32 bits, si vus ne suhaitez pas installer le kit cmplet. RQ ; Lrs du lancement des exe sur une machine 64 bits, un message vus indique que cet exe n est pas cmpatible avec vtre machine, passez utre. Cpyright WaveSft 15/19

16 Mise en place du service 1 Créatin du service A l'invite de cmmande MS-DOS (en exécutant CMD.EXE), entrez la cmmande suivante : chemin\instsrv.exe MnService chemin\srvany.exe Où chemin représente le lecteur et le répertire du Kit de ressurces Windws NT (p. ex., C:\RESKIT) et «MnService» est le nm du service créé. Exemple : C:\RESKIT\Instsrv.exe WSTRS C:\RESKIT\Srvany.exe 2 - Paramétrage du service Exécuter l éditeur de registre (regedt32.exe), puis rechercher la clé suivante HKEY_LOCAL_MACHINE\SYSTEM\CurrentCntrlSet\Services\WSTRS A - Dans le menu Editin, cliquez sur Ajuter une clé. Nm de la clé : Parameters Classe : <laisser le champ vierge> B - Sélectinnez la clé des paramètres. Cpyright WaveSft 16/19

17 C - Dans le menu Editin, cliquez sur Ajuter une valeur. Nm de la valeur : Applicatin Type de dnnées : REG_SZ Chaîne : <chemin>\<applicatin.ext> Où <chemin>\<applicatin.ext> représente le lecteur et le chemin cmplet de l'applicatin exécutable, ntamment sn extensin Pur l autmate dans une installatin standard cela dnne : C:\Prgram Files\WaveSft\PGI\WaveTrans\wavetrans.exe C - Dans le menu Editin, cliquez sur Ajuter une valeur. Nm de la valeur : AppDirectry Type de dnnées : REG_SZ Chaîne : <chemin> Où <chemin> représente le lecteur et le chemin cmplet du répertire de travail de l'applicatin. Pur l autmate dans une installatin standard cela dnne : C:\Prgram Files\WaveSft\PGI\WaveTrans Pur un Serveur 2008, mettre " A " dans la valeur de chaine AppParameters Cpyright WaveSft 17/19

18 3 - Démarrage du service : Par défaut, un nuveau service est cnfiguré pur s'exécuter autmatiquement lrs du redémarrage du système. Pur cnfigurer une exécutin manuelle, cliquez sur l'icône Services dans le Panneau de cnfiguratin et mdifiez la valeur affectée au démarrage en cnséquence. D une manière générale, un service dit être exécuté en tant qu Administrateur. Cpyright WaveSft 18/19

19 Suppressin du service Pur supprimer le service ainsi créé il suffit d exécuter la cmmande suivante : INSTSRV <SERVICENAME> REMOVE Exemple : C:\RESKIT\Instsrv.exe WSTRS REMOVE Cpyright WaveSft 19/19