Home

sM-Client Projekt - sM-Client Releases

1. 80 TABLEAU DES ILLUSTRATIONS STRACCI A EA 54 Figure 2 cran d information anna lau 55 Figure 3 Choix du dossier d metallaton nn 56 Figure 4 Choix de l identifiant Sedex i 57 Figure 5 cran du jeu Complet eet 58 Figure 6 Proc dure d installation 59 Figure 7 Configuration siistii ain aaa He abi geek 60 Figure 8 Menu de d marrage et raccourci sisi 61 Figure 9 Fin de l installation ette ee hine ee ee 62 Historique GESTION DES DOCUMENTS Description Valide Version Modifi 01 Martin Liebrich Cr ation et chapitrage 30 03 2009 SM 02 Martin Liebrich Chapitre 3 6 06 04 2009 SM 03 Sergey Abagyan Suggestions suppl mentaires 08 04 2009 ML 04 Martin Liebrich Passage en revue pour la version 1 beta 09 04 2009 SM 05 Sergey Abagyan Passage en revue pour la version 1 beta 17 04 2009 SM 06 Stefan Malar Restructuration et compl ments 22 05 2009 ML Mise a jour pour la version 2 beta 07 Martin Liebrich Description de l installation avec le wizard 27 05 2009 SM 08 Martin Liebrich Mises a jour version 1 0 RC1 08 06 2009 SM ML Stefan Malar 09 Martin Liebrich Mises a jour installation du banc d essai 15 06 2009 SM ML Stefan Malar Markus Vitalini 10 Martin Liebrich Mises a jour version 1 0 RC2 06 07 2009 SM ML Stefan Malar 11 Martin Liebrich Mises a jour version 1 0 RC3 27 07 2009 SM ML Stefan M
2. nn 11 3 1 5 Installation de MySQL iii 11 INSTALLATION ET CONFIGURATION DU CLIENT SM 12 INSTALLATION MANUELLE ne EET 12 4 1 1 Installation de la base de donn es client SM 12 4 1 2 Installation client SM sur UBOSS nn 15 4 1 3 Installation client SM sur Apache Tomcat nn 16 CONFIGURATION DU CLIENT SM ennt nr iarnnr nisi sisi saca dasi sisi ss sitae dass sss sss saga da sis s n 17 4 2 1 Configuration des dossiers des interfaces 17 4 2 2 Configuration technique sise 18 4 2 3 Configuration on 33 4 2 4 Configurations en Option Hedi 33 4 2 5 Configuration RE 38 INSTALLATION D UNE MISE AJOUR ann Eeer 41 NOUVELLE INSTALLATION AVEC BACKUP COMPLET ener enne nennen enne nennen ener nnns 42 CR ATION D UN NOUVEAU MANDANT i 42 4 5 1 Activation de mandant multiple nennen En 43 CONFIGURATION DU DOMAIN ESCHKG ii iiiiierieierrrieeneeeeiereeniieeneeeeennens 44 CONFIGURATION DU DOMAINE ECH0058V4 ii 45 CONFIGURATION DU DOMAINELM ieieni ee reesessennenereeseseseennen 47 4 8 1 Configuration principale iii 47 4 8 2 Configuration du cantonal repository i 50 4 8 3 R gles de triage pouf ELM aset rt ee edic ecu a etat 51 INSTALLATION ET CONFIGURATION DU CLIENT SM L AIDE DU WIZARD 53 CONDITIONS PREALABLES iaia iaia 53 INSTALLATION RE 53 5 2 1 ERA
3. 4 2 4 1 6 Modification du dossier temporaire Si on souhaite avoir un autre dossier temporaire que le dossier System Temp on peut configurer ceci dans les fichiers run sh Linux resp run bat Windows dans JBoss Home bin p ex C smclientbase jboss 4 2 3 GA bin run bat set JAVA OPTS JAVA OPTS Djava io tmpdir C smclientbase temp 4 2 4 1 7 Installation de plusieurs clients sur un adaptateur Pour installer plusieurs clients sM ou plusieurs mandants sur le m me serveur il faut proc der comme suit Apr s installation de MySQL il est n cssaire de configurer une banque de donn es pour chaque client comme d crit sous 4 1 1 Toutes les tapes de 4 1 1 doivent tre effectu es Les noms des banques de donn es doivent tre diff rents Un serveur JBoss doit tre install pour chaque client comme d crit sous 3 1 3 Chaque serveur JBoss doit tre connect sur un port different La modification des ports est d crite sous 4 2 4 4 Le client sM doit tre install sur chaque serveur JBoss comme d crit sous 4 1 2 Les configurations d crites sous 4 2 doivent tre r alis es pour chaque client Il faut s assurer que tous les clients se r f rent aux m mes r pertoires d adaptateur Le triage est configur de mani re a ce que chaque client ne recoive du r pertoire adaptateur que les messages qui lui sont destin s Ceci est d crit dans le chapitre 4 2 2 5 et dans Conception technique chapitre 4
4. Failed to transmit FA message handler elm properties failed tosend location Message dont l envoi est impossible Ce diagamme d crit les dossiers servant d interface dans le domaine ELM exept le transfert aux communes via Sedex sM Client Projekt Version finale Installations Handbuch Installation et configuration du client sM In ELM adapter inbox location Fach Applikation Sent ELM adapter sent location Meldung Ausgang FA outbox location Out ELM adapter outbox location Failed to transmit ELM adapter failed transmit location _ E gt Failed to receive ELM adapter failed tosend location Failed to send FA iled transmit location 1 m gt Standard Verschiebung a IRINA Verzeichnis wird 4 1 Verzeichnis wird GEES q 1 normal dargestellt Verschiebung im Fehlerfall LL e e PES 4 MAL LS x Verschiebung von FA Verzeichnis wird Verzeichnis wird Verschiebung von SMC nicht dargestellt gepollt Verschiebung von sdA 4 8 2 Configuration du cantonal repository Le cantonal repository est utilis uniquement pour transf rer les messages Taxes a la source du canton a une commune via Sedex 1 D abord il faut modifier le fichier repository properties comme suit FOR ELM domain only ablage cantonal base dir C smclien
5. I mr E cr Eat ory for documentation tation documentation oryn GyoKcakoyaell Stoen eene Ee ele 2 Lee EE EE directory of participants message lists pan iri pall ibe pompa ie bue 1 location of participants Polen location of messages list BSE e message list participants_list message list xml location of message participants list Messages part rei pants bist per list message participants ligsten version properties version part iesipantsrlist version properties 4 2 2 5 Installation d imprimantes Pour pouvoir imprimer plusieurs messages il est n cessaire d installer une ou plusieurs imprimantes sur le serveur L installation d pend du syst me d exploitation du serveur Les imprimantes existantes dans le syst me d exploitation ET UNIQUEMENT celles compatibles Postscript sont utilis es automatiquement par le client sM Il faut toutefois contr ler si l imprimante directe fonctionne suivant le format d impression Installation de la librairie Ghostscript Windows 32 bits La derni re version peut tre t l charg depuis http mirror cs wisc edu pub mirrors ghost GPL current Il faut employer au minimum la version 8 71 gs871w32 exe Ex cuter le programme d installation et mettez le chemin d installation du r pertoire bin dans votre variable d environnement PATH 1 Ouvrez Gestion de l ordinateur 2 Dans l arborescence de la console cliquez avec le
6. 2 JBoss sur un serveur Server Si 2 JBoss sont install s sur un serveur la question se pose o mettre le JBOSS_HOME JBOSS HOME est seulement n cessaire si l on veut d marrer JBoss directement de la ligne de commande sans aller pr alablement dans le bon r pertoire Snon il est possible de simpler laisser JBOSS HOME Il faut alors d abord navigueur vers Jboss1 bin et l appeler run bat la m me chose pour JBoss2 JBOSS HOME ne doit pas tre utilis dans ce cas Si l on doit utiliser JBOSS HOME1 et JBOSS HOME2 il faut adapter la procedure de d marrage et configurer JBOSS HOME1 JBOSS HOME2 Por un service cela fonctionne de mani re quivalente soit on n utilise pas JBOSS HOME et on d marre directement Jboss Services soit on adapte les proc dures correspondantes 4 2 4 1 8 Ecriture du journal sur une banque de donn es Au lieu d crire le journal dans un dossier du Filesystem il est possible de l crire dans une banque de donn es La configuration n cessaire est d crite ci dessous Etablir un tableau banque de donn es LOG ENTRY dans la banque de donn es client sM CREATE TABLE LOG ENTRY id BIGINT NOT NULL AUTO INCREMENT PRIMARY KEY log date DATETIME og level varchar 5 location varchar 255 message VARCHAR 255 Il faut ensuite ajouter un nouveau Appender dans jBoss log4j dossier configuration JBOSS_HOME server default conf jboss log4j xml lt appender name MySQLAppender class org apache log4j jdbc
7. 4 2 2 7 rules xml Le fichier rules xml contient les r gles concernant le triage Il est cr sous la forme d un fichier XML du fait de sa complexit Exemple de configuration sab version 0 Smeoching UNS lt triage xmlns xsi http www w3 0rg 2001 XMLSchema instance xsi noNamespaceSchemaLocation rules xsd gt lt rule gt lt criteria gt lt messageType gt 2003 lt messageType gt lt messageSubType gt 000101 lt messageSubType gt lt messageAction gt 1 lt messageAction gt Rc use qd lt dest inat ionkolder gt C smelientbase interfa ce inbox applieati on lt destinationFolder gt lt PDFGeneration boolean false pdfSplitting false gt lt useCase gt receive lt useCase gt lt rule gt lt rule gt series lt messageType gt 2015 lt messageType gt lt messageSubType gt 000101 lt messageSubType gt CETT lt destincbionbolger Ca ismelicnibasc ntertoce nbox sppliesti on_1 lt destinationFolder gt lt PDFGeneration boolean true pdfSplitting true gt lt useCase gt receive lt useCase gt lt rule gt lt Rules with TestMessage Applied from top to bottom so the less specific one should be at the bottom gt lt rule gt lt a E CE abel lt messageAction gt 2 lt messageAction gt lt testMessage gt lt criteria gt lt destinationFolder gt inbox test multiple messages location lt destinationFolder gt lt useCase gt receive lt useCase gt lt rule gt lt rule g
8. galement accessible qu au client sM participants Contient des documents qui d crivent les participants les messages et les droits participants list Contient la liste des participants actuels message list Contient la liste des messages actuels d crit les messages qui sont actifs message participants list Contient le dossier des participants d crit les messages que les participants peuvent changer version Contient le chemin relatif depuis ablage base dir vers le fichier version properties Cette propri t est optionnelle et a comme valeur par d faut participants list version properties Cette valeur ne doit pas tre chang e lors de l utilisation du stockage de base Exemple de configuration Stockage is file repository used to store xsd xslts and documentation stockage base dir C smclientbase interface repository directory for all xsds and xsls za ax sex dere directory for documentation documentation documentation directory for optional integrity check files tee eal EES directory of participants message lists perpe eee location Of participants list Portiere location of messages list message list participants_list message list xml location of message participants list message participants list participants_list message participants list ozm 6 3 1 3 config properties Le config properties est le m me que que celui qui
9. working directory of swissdec adapter all directories below are relative to base directory base dir adapter C smclientbase adapterSwissdec base dir adapter VBOXSVR Temp directory for incoming messages adapter inbox location inbox directory for outgoing messages adapter outbox location outbox specific for swissdecadapter and ELM domain adapter failed receive failed adapter sent location sent adapter ritocco dee onere ia sii configuration of sedex adapter base directory is taken from base dir adapter message handler properties smclient domain used for forwarding to commune directory for outgoing messages sedex adapter outbox location outbox zip elm message when forwarding to commune Ilo MEETS TS Cels forward message zipped true Ou Ele deals Iit Tuoi Sec de WOME La table suivante d crit la correspondance entre la configuration du sM Client et du sdA sM Client Message handler elm properties Swissdec Adapter swissdecAdapter properties Dans le sM Client les r pertoires ci dessous sont relatifs relativ zu base dir adapter sdA requiert des chemins absolus dans sa configuration adapter inbox location PATH ELM IN released filesystem parent xml adapter outbox location PATH ELM OUT result filesystem parent xml adapter failed receive PATH_ELM_FAILED_TO_RX failed filesystem parent xml adapter sent location PATH_ELM_SENT
10. Installations Handbuch Installation et Configuration du Client 5 3 cran d information d IzPack Installation of sM Client Please read the following information The following wizard will guide you through the installation of the sM Clien In case of problems please contact support sm client ctp consulting com lt Made with IzPack http izpack org Figure 2 Ecran d information L cran d information contient d autres informations Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 4 Januar 2012 von Cambridge Technology Partners O 2011 55 84 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 1 Choix du dossier d installation d IzPack Installation of sM Client B Select the installation path C smclientbase Browse Made with IzPack http izpack org Figure 3 Choix du dossier d installation On peut s lectionner sur cet cran le dossier d installation pour le client sM L ensemble des donn es JBoss mysql client sM dossiers d interfaces etc sont install s en dessous de ce dossier Le dossier peut tre choisi librement et est cr au besoin Il faut tenir compte du fait qu il ne doit pas y avoir d espace dans le chemin du dossier d installation Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 4 Januar 2012 v
11. Laros Contig args gt Serbe serpore pek Splitting Leise spere por pliteino lt message gt lt processes gt Le script peut tre configur pour tous les messages 1 ou alors pour un type de message particulier 2 Seul un script par message est appliqu le sM Client recherche le script dans l ordre suivant jusqu a trouver une correspondance 1 Pour le type et le sous type comme au point 2 ci dessus Dans cet exemple la validation est d sactiv pour les messages 2003 000101 2 Pour le type 3 Pour tout les messages comme au point 1 ci dessus 4 Pour le processus de r ception ou d envoi 3 Balise message La balise message comprend les attributs suivants Nom Description type Type de message sedex par example 2003 subT ype ptionne ous type de message selon le bT Opti S t d standard du sM Client par example 000101 Balise message validation Cette balise permet de changer la valeur d fini dans config properties pour la validation pour un type de message particulier true false Balise script La balise script comprent les attributs suivants Nom Description path Chemin absolu du script ex cuter noPdfGeneration Optionnel false par d faut indique si le script n a pas besoin du fichier PDF Par d faut le fichier PDF est g n r process Optionnel receive par d faut indique si le script doit tre ex cut durant l
12. assurer un fonctionnement sans incidents il faut r gler le MaxPermSize sur 512Mo et la m moire principale maximale sur 1024Mo Cela peut se faire soit dans JAVA_OPTS par l interm diaire de la ligne de commande ou des variables de syst me ou dans les fichiers run sh Linux resp run bat Windows dans JBoss Home bin p ex C smclientbase jboss 4 2 3 GA bin run bat Il faut pour cela modifier la ligne par Xms512m Xmx1024m XX MaxPermSize 512m set JAVA OPTS JAVA OPTS Xms512m Xmx1024m XX MaxPermSize 512m Lors l utilisation de plusieurs mandants il faut allouer plus de m moire de mani re correspondante Voir aussi le manuel d expoitation chapitre 2 2 Installation de smclient war On peut t l charger la derni re version du client sM ici http sm client ctp consulting com Veuillez tenir compte du fait que lors d un t l chargement au moyen d Internet Explorer l extension de fichier peut tre modifi e de war zip Dans ce cas il faut nouveau changer le suffixe en war une fois le t l chargement effectu Le fichier t l charg ne doit pas tre d comprim l aide de Win Zip ni d autres programmes similaires Le fichier WAR doit tre ensuite copi dans le dossier JBOSS HOME Server default deploy Le serveur JBoss proc de automatiquement un d ploiement de l application l option Autodeploy doit tre activ e c est le cas de fa on standard 4 1 3 Installation client sM sur Apache Tomc
13. failed location failed failed to send it could not be send by the smclient failed tosend location failed failed_to_send failed to transmit means that in the send the sedex client could not transmit our message faorearte mem loro teilec to ia ito configration of simulated sedex adapter working directory of sedex adapter all directories below are relative to base directory base dir adapter C smclientbase adapter directory for incoming messages adapter Inbox location inbox directory for technical receipts adapter receipt location receipts directory for outgoing messages adapter outbox location outbox mus custom error text for specialist reply testbed errortext Example Error Text 6 3 1 2 repository properties Le repository properties estle m me que que celui qui a d j t d crit pour le client sM Stockage stockage base dir Stockage pour le repository du client sM Les autres chemins sont relatifs par rapport a ce dossier xsd_xslt Ensemble des formats de message XSD Instructions de conversion correspondantes XSLT documentation Contient la documentation concernant le client sM p ex manuel utilisateur peut contenir des sous dossiers si envoy ainsi integrity Contient a la rigueur des documents qui ne sont utilis s pour le contr le d int grit que par le client SM ce dossier n est pour cette raison
14. rules location C smclientbase config rules xml yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES timeout time 30 yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES keep deleted time 10 yourSedexId select id from domain where name like smclient Les valeurs doivent correspondre l installation client sM respective 6 Cr er le tableau smRole selon proc dure ci dessous EATE TABLE smRole id NUMBER 37 NOT NULL name VARCHAR 255 description VARCHAR 255 PRIMARY KEY id 7 Saisie des valeurs dans tableau smRole selon proc dure ci dessous ERT INTO smRole id name description values 1 Admin ministrator ERT INTO smRole id name description values 2 ActiveUser ive User Sender ERT INTO smRole id name description ues 3 PassiveUser Passive User Receiver ERT INTO smRole id name description values 3 SuperUser Super User 8 Cr er le tableau smUser et ajouter les valeurs selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex E TABLE smUser id NUMBER 37 NOT NULL username VARCHAR2 255 NOT NULL password VARCHAR2 255 firstname VARCHAR2 255 lastname VARCHAR2
15. sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 4 Proc dure d installation d IzPack Installation of sM Client 88 Pack installation progress C smclientbase jboss 4 2 3 GA4 server all deployjmx console war WEB INFiclasses org jboss jmx adaptor html HtmlAdapt JBoss AS 4 2 3 G 1 Overall installation progress 1 4 Made with IzPack http izpack org Figure 6 Proc dure d installation Cet cran montre le progr s de l installation Une fois l installation achev e on peut continuer vers le prochain cran par l interm diaire du bouton Next Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 59 84 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 5 Configuration n d IzPack Installation of sM Client Processing start database C workspace sm client installer cd C smclientbase mysql 5 1 34 win32 bin C smclientbase mysql 5 1 34 win32 bin gt start mysqld console C smelientbase mysql 5 1 34 win32 bin gt cd C smclientbase scripts C smclientbase scripts gt wait 10 lt Made with IzPack http izpack org Figure 7 Configuration L cran montre le progr s de la configuration Des fen tres DOS sont ouvertes a cette occasion mais qui sont a nouveau ferm es a la fin Une fois la configuration achev e on peut continuer v
16. 255 defaultLanguage VARCHAR2 255 NOT sedexId VARCHAR2 255 PRIMARY KEY id insert into smUser id username password firstname lastname defaultLanguage sedexId values 1 Admin 46 tAEewgFnQ toQ9ADB5Q administrator administrator fr yourSedexId insert into smUser id username password firstname lastname defaultLanguage sedexId values 2 SuperUser 2atHgjIcy5hGeeRwzY mh0 Super User tfr null 9 Cr er le tableau smUser_smRole et ajouter les valeurs selon proc dure ci dessous EATE TABLE smUser smRole smUser id NUMBER 37 NOT NULL Role id NUMBER 27 NOT NULL Js ERT INTO smUser smRole smUser id Role id VALUES select id from smUser wher username Admin select id from smRole where name Admin INSERT INTO smUser smRole smUser id Role id VALUES select id from smUser wher username SuperUser select id from smRole where name SuperUser Sequences et Contraintes sont seulement apliqu es apr s le d marrage du client sM 10 Installer Oracle JDBC Driver pour JBoss 11 File ojdbc6 jar de ORACLE HOME product version db 1 jdbc lib classes12 zip vers JBOSS HOME server default lib directory Configuration de Oracle Server Data Source Le dossier suivant sert diter JBOSS HOME server default deploy smclient ds xml sM Client Projekt Version finale Installations
17. 54 CRAN D INFORMATION cullare 55 5 3 1 Choix du dossier d installation usine 56 5 3 2 Choix de l identifiant Sedex sienne 57 533 cran du jeu EE 58 5 3 4 Proc dure d installation ren aoo t din Co ee ene tex lalla 59 5 4 5 5 5 6 5 7 5 8 6 1 6 2 6 3 7 1 7 2 7 3 8 1 8 2 5 3 5 Configuration ETPEH 60 5 3 6 Menu de d marrage et raccourci sie 60 5 3 7 Finde Minstallation T 62 ADAPTATIONS MANUELLE S snui 58e iii 62 D MARRAGE DU CLIENT SM rtr hier a Bde ER ira iaia 63 DEINSTALLIEREN DES SM CLIENTS esses enne nennen nennen nennt nr sit nr sn nenr erri drin tr nr en nennt 63 INSTALLATION COMME SERVIC Ersson iiien rre ide ede iii 63 WIZARD D INSTALLATION POUR LINUX ie 64 INSTALLATION ET CONFIGURATION DU BANC D ESSAI 65 INSTALLATION DE LA BANQUE DE DONN ES DES BANCS D ESSAI iii 65 INSTALLATION DU BANC D ESSAI SUR JBOSS iii 66 CONFIGURATION DU BANC D ESSAI iii 68 6 3 1 Configuration des dossiers des interfaces 68 V RIFICATION DE L INSTALLATION mmrmrenenenenereneeenenerenennnee 73 APPEL DE LA PAGE DE VERSION een Eee 73 V RIFICATION DANS LE LOG TT 74 ENVOI ET RECEPTION D UN MESSAGE DE TEST iii 74 INSTALLATION SUR D AUTRES BANQUES DE DONNEES 76 Mace 76 El
18. a d j t d crit pour le client sM sedexld Ihre Sedex ID update message types Types de message pour les mises jour de syst me Autoupdate Ex cuter les mises jour automatiquement time of day for update Heure de la journ e laquelle les mises jour sont effectu es default locale Langue standard p ex pour l exportation filechange listener interval Intervalle d interrogation du client sM en secondes should message be validated Les messages doivent amp tre valid s selon le sch ma XML should attachments be validated Les annexes de type mime doivent tre valid es backup enabled D finit si la sauvegarde est active backupDirectory Dossiers dans lequel les sauvegardes sont stock es en m moire time of day for backup Heure de la journ e a laquelle les sauvegardes doivent tre ex cut es backup fullDB enabled D finit s il faut faire un vidage complet de la banque de donn es lors de la sauvegarde On peut employer celui ci pour une restauration manuelle complete backupBatch Lieu o le fichier MySQLSmClientBackup bat pour Windows resp MySQLSmClientBackup sh pour Linux Dans le cas d une installation manuelle le fichier doit amp tre copi ici par l installateur inbox enabled D finit si l Inbox est active formservice enabled Definit si le service formulaires est actif LDAP enabled Definit si LDAP doit tre utilis pour
19. ainsi integrity Contient a la rigueur des documents qui ne sont utilis s pour le contr le d int grit que par le client sM ce dossier n est pour cette raison galement accessible qu au client sM participants Contient des documents qui d crivent les participants les messages et les droits participants list Contient la liste des participants actuels message list Contient la liste des messages actuels d crit les messages qui sont actifs message participants list Contient le dossier des participants decrit les messages que les participants peuvent amp changer version Optionnel Contient le chemin relatif depuis ablage base dir vers le fichier version properties Cette propri t est optionnelle et a comme valeur par d faut participants list version properties Cette valeur ne doit pas tre chang e lors de l utilisation du stockage de base plugins dir Optionnel Peut contenir un chemin relatif par rapport au chemin de base ablage base dir ou un chemin absolu Ce chemin doit pointer vers un repertoire existant contentant les Plug ins fichiers JAR La valeur par d fault de ce repertoire est plugins Exemple de configuration Stockage is file repository used to store xsd xslts and documentation stockage base dir C smclientbase interface repository directory for all xsds and xsls Say xs direc docume direc integr qood cct
20. bouton droit sur Gestion de l ordinateur local puis cliquez sur Propri t s Sous l onglet Avanc sous Variables d environnement cliquez sur Parametres S lectionnez un utilisateur dans la liste Variables utilisateur pour Cliquez sur le nom Path de la variable utilisateur ou syst me que vous souhaitez modifier ou supprimer Cliquez sur Modifier pour modifier la valeur de la variable avec le nom Path Ajoutez la fin du champ valeur Variable value un point virgule puis le chemin du r pertoire bin de Ghostscript Par exemple C Program Files gs gs8 71 bin 8 Pour v rifier ouvrez une fen tre de commande D marrer gt Ex cuter cmd puis entrez la commande gswin32 Une fen tre de commande ghostscript doit s ouvrir 9 Red marrer le sM Client Windows 64 bits La derni re version peut tre t l charg depuis hitp mirror cs wisc edu pub mirrors ghost GPL current Il faut employer au minimum la version 9 04 gs904w64 exe Ex cuter le programme d installation Il faut ensuite copier le fichier gsdll64 dll sous le nom gsdll32 dll 7 Depuis l explorateur Windows allez dans le r pertoire d installation de Ghostscript Par exemple C Program Files gs gs9 04 bin 2 Copiez le fichier gsdll64 dll ou gsdll64 3 Collez le fichier dans le m me r pertoire puis renommez le nouveau fichier en gsdll32 dll ou gsdll32 Puis mettez le chemin d installation du r pertoire bin dans votre variable d environne
21. directory for documentation documentation documentation directory for optional integrity check files ntegrity integrity check directory of participants message lists marticipants participants list location of participants list participants list participants list participants list xml location of messages list message list participants_list message list xml location of message participants list message participants list participants_list message participants list xml i H for the testplatform message packages message packages ENEE config properties a a aaa reegen 1 sedex identificator H D isedexId 6 900014 2 i i i type of message used to update the system xml files documentation tupdate messaqe types 2999 3999 Lors de la premi re connection vous pouvez utiliser l utilisateur par d faut Admin le mot de passe Admin Le nom d utilisateur ainsi que le mot de passe sont sensible la casse 7 2 Verification dans le log Au cas ou la page de version n est pas affich e on peut v rifier dans le log JBoss ou Tomcat si des erreurs quelconques apparaissent 7 3 Envoi et r ception d un message de test Un message de test peut tre copi dans un des dossiers de sortie valide afin de v rifier si l envoi et la r ception fonctionnent correctement Ce message doit tre cette occasion adress l exp diteur Le message doit ensuite tre envoy par le client sM et aussi tre recu par
22. gt lt DOCTYPE datasources PUBLIC JBoss DTD JBOSS JCA Config 1 5 EN http www jboss org j2ee dtd jboss ds 1 5 dtd gt lt datasources gt lt local tx datasource gt lt jndi name gt smclient lt jndi name gt lt connection url gt jdbc mysql localhost 3306 smclient lt connection url gt lt driver class gt com mysql jdbc Driver lt driver class gt lt user name gt smclientUser lt user name gt lt password gt password lt password gt lt local tx datasource gt lt datasources gt Les champs user name et password correspondent aux valeurs qui ont t d finies au 4 1 1 On peut trouver ici http jboss org community docs DOC 9328 de la documentation suppl mentaire sur la configuration Ajouter JDBC Driver On a galement besoin d un pilote JDBC afin que la banque de donn es fonctionne p ex mySQL Driver http dev mysql com downloads connector j 5 1 html Le fichier Zip t l charg doit d abord tre d comprim La biblioth que des pilotes dans le cas de mySQL mysql connector java 5 1 7 bin jar doit tre copi e dans le dossier JBoss Home server default lib Autres bibliotheques Il faut en outre encore ajouter le xml resolver 1 2 jar on peut le t l charger ici http repo1 maven org maven2 xml resolver xml resolver 1 2 xml resolver 1 2 jar Il faut ensuite m moriser le fichier dans le dossier JBoss Home lib endorsed Configuration de la m moire vive Afin d
23. jdbc index html ojdbc6 jar pilote JDBC pour Oracle http commons apache org downloads download logging cgi http logging apache org log4j 1 2 download html Il faut ensuite d poser le fichier dans le dossier CATALINA HOME lib Configuration de la m moire vive Afin d assurer un fonctionnement sans incidents il faut r gler le MaxPermSize 512Mo et la m moire principale maximale sur 1024Mo Cela peut se faire soit dans JAVA_OPTS par l interm diaire de la ligne de commande ou des variables de systeme ou dans les fichiers startup sh Linux resp startup bat Windows dans CATALINA HOME bin Il faut pour cela modifier la ligne par Xms512m Xmx1024m XX MaxPermSize 512m set JAVA OPTS JAVA OPTS Xms512m Xmx1024m XX MaxPermSize 512m Lors l utilisation de plusieurs mandants il faut allouer plus de m moire de mani re correspondante Voir aussi le manuel d expoitation chapitre 2 2 Installation de smclient war On peut t l charger la derni re version du client sM ici http sm client ctp consulting com Veuillez tenir compte du fait que lors d un t l chargement au moyen d Internet Explorer l extension de fichier peut tre modifi e de war zip Dans ce cas il faut nouveau changer le suffixe en war une fois le t l chargement effectu Le fichier t l charg ne doit pas tre d comprim l aide de Win Zip ou autres programmes similaires Il faut t l charger le fichier correct
24. la gestion des utilisateurs Si ceci est r gl sur true les configurations d crites au chapitre 4 2 5 doivent tre en outre faites Exemple de configuration your sedex id sedexId 6 900014 1 type of message used to update the system repository xml files documentation update message types 2990 3999 allow automatic updates autoupdate true time of update hour of day time of day for update 18 default application language default locale de finterval for checking files in seconds filechange listener interval 60 should messages xml files be validated with the schema should message be validated true should attachment mime types be validated sM Client Projekt Version finale Installations Handbuch Installation et configuration du banc should attachments be validated false defines if backup is enabled backup enabled true folder used for backup and restore folder must exist backupDirectory D smclient backup time of backup hour of day time of day for backup 12 is full backup DB dump enabled Backup fullDB enabled false path to backup script backupBatch C smclientbase scripts windows MySQLSmClientBackup ba E defines if inbox is enabled inbox enabled true defines if formservice is enabled formservice enabled true defines if formservice is enabled formservice enabled false defines if LDAP should be used LDAP enabled false
25. les processus La restauration de la sauvegarde peut se faire par l administrateur correspondant au mandant Pour une utilisation du sM Client avec un seul mandant aucun changement n est donc signaler e Si plusieurs mandants sont configur s il faut tenir compte des points suivants o La sauvegarde compl te fonctionne pour la base de donn e dans son ensemble soit pour tout les mandants g r s par le sM Client C est pourquoi il ne faut activer la sauvegarde compl te que pour un seul mandant ET ce mandant ne doit pas ex cuter la sauvegarde au m me moment que les autres il faut une valeur diff rente pour time of day for backup ni dans le m me r pertoire Apr s une restauration complete de la base de donn e qui a lieu en dehors de l application sM client tous les administrateurs doivent restaurer les fichiers depuis l interface Cela pour autant que ces mandant aient activ s la sauvegarde simple sinon aucun fichier ne peut tre restaur s Le sM Client ne fait aucune v rification ce sujet La sauvegarde simple peut tre configur par mandant et restaur par l administrateur du mandant Exemple de configuration your sedex id sedexId 6 900014 1 type of message used to update the system repository documenta tion update message types 2990 3999 allow au Loma tic updates autoupdate true time of upda te hour of day time of day for update 18 default
26. lui L ensemble du traitement du message peut ainsi tre suivi l aide de l Audit Trail et le cas ch ant des logs On peut en outre v rifier si l envoi et la r ception de tous les messages et quittances se trouvent dans les bons dossiers Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 74 84 sM Client Projekt Version finale Installations Handbuch V rification de l Installation Erstellt 4 Januar 2012 von Cambridge Technology Partners O 2011 75 84 8 INSTALLATION SUR D AUTRES BANQUES DE DONNEES Dans le cas d une installation sur une autre banque de donn es que MySQL le chapitre suivant d crit les tapes n cessaires et remplace ainsi le chapitre 4 1 8 1 MS SQL 1 Cr er une banque de donn es smclient 2 Cr er le login smclientUser attribution du r le db owner pour banque de donn es smolient 3 Cr er le tableau smMandant et ajouter les valeurs selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex smMandant sedexId varchar 255 NOT NULL name varchar 255 1 active tinyint DEFAULT 0 PRIMARY KEY sedexId smMandant VALUES yourSedexId mandantName 1 domain id BIGINT NOT NULL IDENTITY 1 1 name VARCHAR 255 NOT NULL PRIMARY KEY id UNIQUE NAME 4 Cr er le tableau configuration analogue la p
27. messages qui n ont pas pu tre envoy s o Sous dossier pour les les messages qui n ont pas pu tre transmis Les noms des dossiers peuvent tre librement choisis mais doivent tre d finis par l interm diaire d un fichier property On trouvera des d tails au chapitre 4 2 et 4 3 du document de design technique Les dossiers suivants doivent tre configur s en tant que stockage Les dossiers doivent tre ventuellement cr s et tre pourvus des droits de lecture et d criture correspondants pour le client sM e Stockage o Documentation o Contr le d int grit o Liste des participants o XSD XSLT Les noms des dossiers peuvent tre choisis librement mais doivent tre d finis par l interm diaire d un fichier property Vous trouverez des d tails aux chapitres 4 2 et 4 3 du document de design technique Le stockage est est mis disposition sur notre site web http sm client ctp consulting com Produktive Ablage ou Test Ablage pour les instances de test sedexID commen ant par T et doit tre copi l endroit correspondant d fini dans repository properties p ex C smclientbase interface repository 4 2 2 Configuration technique Vous trouverez la liste des configurations techniques au chapitre 3 5 3 du document de design technique La configuration est entreprise manuellement dans les fichiers de configuration correspondants Important assure vous que tous les dossiers indiqu s existent bien Il faut gal
28. mysql CREATE DATABASE smclient Query OK 1 row affected 0 05 sec Il faut ensuite cr er une banque de donn es utilisateur afin de pouvoir acc der la banque de donn es Nom smclientUser Mot de passe password mysql GRANT ALL PRIVILEGES ON smclient TO smclientUser localhost IDENTIFIED BY password Query OK 0 rows affected 0 06 sec Tableau de configuration On cr e ensuite le tableau de configuration et on le remplit avec les valeurs correspondantes Il faut pour cela adapter et ex cuter le script ci apres mysql gt use smclient mysql CREATE TABLE smclient smMandant sedexId varchar 255 NOT NULL name varchar 255 DEFAULT NULL active bit DEFAULT false PRIMARY KEY sedexId mysql gt CREATE TABLE domain id bigint 20 NOT NULL AUTO INCREMENT name varchar 255 NOT NULL PRIMARY KEY ad UNIQUE KEY name name insert into domain name values smclient mysql CREATE TABLE smclient configuration keycolumn VARCHAR 255 NOT NULL confValue VARCHAR 255 sedexId VARCHAR 255 NOT NULL domain id BIGINT 20 NOT NULL DEFAULT 0 PRIMARY key sedexId keycolumn domaan ad INSERT INTO smclient smMandant sedexId name active values yourSedexId default true INSERT INTO configuration VALUES Mecon ron location e lsmellenthase config contig properties yourSedexId select id from domain where name like smell INSERT INTO config
29. pour Tomcat et il faut change le nom du fichier en smclient war Ensuit le fichier WAR doit tre copi dans le dossier CATALINA HOME webapps Finalement on doit d marrer l application MySQL puis le serveur Tomcat 4 2 Configuration du client sM 4 2 4 Configuration des dossiers des interfaces Les interfaces sont d finies dans le Property File nessage handler properties Il faut configurer les dossiers des interfaces e Vers l adaptateur sedex e Vers les applications m tiers le triage externe e Stockage e Interfaces internes Les dossiers suivants doivent tre consid r s en tant qu interface par rapport l adaptateur sedex Les dossiers ont d j t cr s lors de l installation de l adaptateur e Message d entr e e Entr e quittance sedex e Message sortie Vous pourrez trouver des d tails au chapitre 4 1 du document de design technique Il faut configurer les dossiers suivants en tant qu interface vers les applications m tiers le triage externe resp en tant qu interfaces internes Il faut ventuellement cr er les dossiers et les pourvoir des droits d criture et de lecture pour le client sM e Entr e message o Sous dossier pour chaque application m tier triage o Sous dossier pour la case postale e Sortie message o Sous dossiers pour chaque application m tier triage e Messages envoy s o Sous dossiers pour chaque application m tier triage e Messages ayant chou o Sous dossier pour les
30. t install avec le wizard d installation il faut adapter le script de d marrage dans SINSTALL DIR scripts windows start smclient bat resp INSTALL DIR scripts linux start smclient sh eta savoir comme suit La ligne start mysqld console doit tre compl t par port your port Dans les deux cas il faut en outre adapter la ligne suivante dans le fichier smclient ds xml dans le dossier JBoss Home server default deploy lt connection url gt jdbc mysql localhost your port smclient connection url 4 2 4 1 5 Red marrage automatique Au cas o le client sM a t install avec l aide du Wizard il existe un script de d marrage qui permet le simple d marrage red marrage du client sM On d marre cete occasion MySQL DB et JBoss AS et galement ainsi le client sM Au cas o le client sM resp MySQL DB et JBoss AS ont t install manuellement et en tant que services un red marrage a lieu automatiquement lors du red marrage du serveur Les services peuvent tre galement red marr s manuellement par l interm diaire des outils d environnement correspondants L installation en tant que service de MySQL est faite automatiquement si cela a t indiqu ainsi Il faut ex cuter les tapes suivantes pour installer JBoss en tant que service sous Windows 1 T l chargement de JBoss Native pour la plate forme souhait de http www jboss org jbossweb downloads jboss native 2 Copier jb
31. 4 mais les possibilit s de configuration de la part de l utilisateur sont cette occasion un peu restreintes Mais des configurations peuvent tre adapt es manuellement apr s l ex cution du wizard 5 1 Conditions pr alables Le wizard d installations est livr en tant qu Executable JAR et peut ainsi tre directement ex cut La condition pr alable cela est qu une JAVA SDK soit install comme cela a t d fini sous 3 1 1 Au cas o l adaptateur sedex n est pas encore install il est recommand de ne le faire qu apr s l installation du client sM 5 2 Installation Le sous chapitre suivant conduit cran apr s cran travers l installation a l aide du wizard sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 2 1 Ecran d accueil d IzPack Installation of sM Client Welcome to the installation of sM Client 1 0 0 Q This software is developed by Cambridge Technology Partners lt info ctp consulting com gt H The homepage is at http www ctp consulting com Made with IzPack http izpack org Figure 1 cran d accueil L cran d accueil contient certaines informations g n rales comme p ex le num ro de version du client sM devant tre install Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 54 84 sM Client Projekt Version finale
32. E TABLE domain ad NUMBER 19 0 NOT NULL PRIMARY K name VARCHAR2 255 CHAR NOT NULL UNIQUE name insert into domain id name values 1 smclient 4 Cr er le tableau configuration selon proc dure ci dessous EATE TABLE configuration keycolumn varchar2 255 NOT NULI confvalue varchar2 255 NOT NULI sedexId varchar2 255 NOT NULL domain id NUMBER 19 0 NOT NULL PRIMARY KEY sedexId keycolumn domain id 5 Saisie des valeur dans le tableau configuration selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex INSERT INTO configuration VALUES config location C smclientbase config config properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES message handler location C smclientbase config message handler properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES repository location C smclientbase config repository properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES formservice location C smclientbase config formservice properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES
33. Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 72 84 7 VERIFICATION DE L INSTALLATION Il faut proc der aux 3 tests suivants une fois l installation du client sM effectu e e Appel d une page de version dans le navigateur e V rification dans le log JBoss e Envoi et r ception d un message de test 7 1 Appel de la page de version On peut appeler la page de version du client sM l aide d un navigateur Vous atteignez cette derni re avec la configuration standard http localhost 8080 smclient version seam Si l adresse et le port du client sM devaient avoir t configur s diff remment on trouvera la page de version au lieu adapt en cons quence La page doit afficher la version actuelle du client sM install e de facon analogue a l illustration suivante suivi par une liste des fichiers de configuration d s la version 3 0 sM Client Projekt Version finale Installations Handbuch Verification de l Installation Se connecter 7 IV TAHV IV SSK leet EN Pes Aide Version Page Current version of sM Client Release 3 0 0RC1 DATABASE PROPERTIES T6 900014 3 ctp mandant 1 Database properties OK CONFIGURATION FILES Property version is missing in var opt smclient1 conf repository properties There are errors in configuration please check you configuration files repository properties iablage base dir var opt smclientl repository directory for all xsds and xsls xsd xslt xsd xslt
34. Handbuch Installation sur d autres banques de lt xml version 1 0 encoding UTF 8 gt g lt DOCTYPE datasources PUBLIC JBoss DTD JBOSS JCA Config 1 5 EN http www jboss org j2ee dtd jboss ds 1 5 dtd gt datasources lt local tx datasource gt lt jndi name gt smclient lt jndi name gt lt connection url gt jdbc oracle thin localhost 1521 smclient lt connection url gt lt driver class gt oracle jdbc driver OracleDriver lt driver class gt lt user name gt smclientUser lt user name gt lt password gt password lt password gt lt local tx datasource gt lt datasources gt N lt connection url gt doit correspondre a la configuration DB respective Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 83 84 Cambridge Technology Partners Switzerland S A Nyon 27 Ch de Pr cossy CH 1260 Nyon Tel 41 0 22 306 4646 Fax 41 0 22 306 4647 Zurich Imperial 4th floor Leutschenbachstrasse 41 8050 Z rich Tel 41 0 43 456 2300 Fax 41 0 43 456 2301 Basel Barf sserplatz 3 CH 4051 Basel Tel 441 0 61 271 9140
35. JDBCAppender gt lt connection URL gt lt param name URL value jdbc mysql localhost 3306 smclient lt driver in this case mysql gt lt param name driver value com mysql jdbc Driver gt lt username and password used to connect to DB gt lt param name user value smclientUser gt lt param name password value password gt lt SQL statement that will be used to store data in DB gt layout class org apache log4j PatternLayout param name ConversionPattern value INSERT INTO LOG ENTRY log date Log level location message VALUES d yyyy MM dd HH MM SS 5p C L m lt layout gt lt appender gt Pour finir l Appender doit tre ajout la cat gorie Root root lt appender ref ref MySQLAppender lt appender ref ref CONSOLE appender ref ref FILE root Adaptations 4 2 4 1 9 Adaptations n cessaires pour Full Backup sous Windows Au cas o le Full Backup est activ il faut lors d une installation manuelle adapter le dossier SINSTALL PATHNscripts windows MMySQLSmClientBackup bat L entr e set path path SINSTALL PATH mysql 5 1 34 win32 bin doit tre adapt e de mani re ce qu elle indique le r pertoire bin du MySQL Lors d une installation avec Wizard le chemin est configur automatiquement 4 2 4 2 Configuration LDAP Si pour l administration des utilisateurs on utilise un LDAP au lieu d une adminis
36. Path true protocol HTTP 1 1 enableLookups false redirectPort 8443 acceptCount 100 connectionTimeout 20000 disableUploadTimeout true gt Si une autre Bind Address devait tre souhait e en tant que localhost elle peut tre r gl e dans les fichiers run sh Linux bzw run bat Windows dans JBoss Home bin p ex d smclient jboss 4 2 3 GA bin run bat set JAVA OPTS JAVA OPTS Djboss bind address 127 0 0 1 Port JBoss RMI JBoss AS emploie en standard le port 1098 pour les liaisons RMI Si ce port devait tre d j occup on peut adapter le port JBoss comme suit Dans JBoss Home server default conf jboss service xml Vous pouvez adapter la ligne attribute name RmiPort gt 1098 lt attribute gt sur un port qui n est pas d j occup L autre port est utilis apr s un red marrage Autres Ports Une liste de tous les ports employ s par JBoss est disponible dans le document suivant http manoharviswanathan com blog tech running multiple jboss instances on the same machine dans la 2e partie Many of you requested steps for current release of JBoss 4 2 2 GA Port MySQL En fonction de la mani re dont MySQL est install le port peut tre adapt A En cas d installation manuelle le port peut tre modifi dans le fichier my cnf dans le dossier mysql home bin Le port doit tre modifi sous client et serveur la ligne est la m me aux deux endroits port 3306 B Sile client sM a
37. S Schweizerische Steuerkonferenz CSI Conf rence suisse des imp ts K Conferenza svizzera delle Imposte AHV IV AVS AI sM Client Manuel d installation Version finale CSI OFAS eAVS AI Version 2 9 Publication Date 26 Juillet 2012 COPYRIGHT Copyright 2012 Cambridge Technology Partners All Rights Reserved No part of this publication may be reproduced transmitted transcribed stored in a retrieval system or translated into any language in any form by any means without the written permission of Cambridge Technology Partners SA While every precaution has been taken in the preparation of this document Cambridge Technology Partners assumes no responsibility for errors omissions or for damages resulting from the use of the information herein Products or corporate names may be trademarks or registered trademarks of other companies and are used only for the explanation and to the owner s benefit without intent to infringe 4 2 4 3 4 4 4 5 4 6 4 7 4 8 5 1 5 2 5 3 SOMMAIRE OBJET DU DOCUMENT anna aaa 8 APEHCU GENERAL 9 INSTALLATION ET CONFIGURATION DU LOGICIEL D INFRASTRUCTURE 10 INSTALLATION MANUELLE ET CONFIGURATION iii 10 3 1 1 EE wiele UE KEE 10 3 1 2 Installation et configuration de l adaptateur sedex 10 3 1 3 Installation et configuration de JBoss AS nen 10 3 1 4 Installation et configuration de Apache ToMCat
38. VARCHAR 255 NOT NULL sedexId VARCHAR 255 PRIMARY KEY id insert into smUser username password firstname lastname defaultLanguage sedexId values Admin 46 tAEewgFnQ toQ9ADB5Q administrator administrator de yourSedexId insert into smUser username password firstname lastname defaultLanguage sedexId values SuperUser ZatHgjIcy5hGeeRwzY mho Super User Pet Quil 9 Cr er le tableau smUser_smRole et ajouter les valeurs selon proc dure ci dessous sM Client Projekt Version finale Installations Handbuch Installation sur d autres banques de EATE TABLE smUser smRole smUser id BIGINT NOT NULL Role id BIGINT NOT NULL INSERT INTO smUser smRole smUser id Role id SELECT select id from smUser where username Admin select id from smRole where name Admin INSERT INTO smUser smRole smUser id Role id SELECT select id from smUser wher username SuperUser select id from smRole where name SuperUser 10 Installer MSSQL JDBC Driver pour JBoss T l charger MS Microsoft SQL Server JDBC Driver 2 0 sqljdbc4 jar du site Web Microsoft http www microsoft com downloads details aspx displaylang en amp FamilyID 99b21b65 e98f 4a61 5811 19912601fdc9 Copier dans JBOSS HOME server default lib directory 11 Configuration de MS SQL Server Data Source Editer le fichier suivant JBOSS HOME
39. aine eCH0058v4 dans la base de donn es insert into domain name values ech0058v4 2 D finition de l emplacement des fichiers de configuration Modifier d abord la requ te avec votre sedexld et l emplacement correct du fichier INSERT INTO configuration VALUES message handlers lecation C smelientbase contig message nandler ech0058v4 properties yourSedexId select id from domain where name like ech0058v4 3 Un nouveau domaine peut aussi besoin de ses propres r pertoires c est pourquoi il ya un message handler properties par domaine ainsi le sM Client sait a quel domaine un message appartient Ces r pertoires doivent tre cr s avant le d marrage du sM Client Ici seule la propri t outbox location diff re du message handler properties standard 4 Message handler ech0058v4 configuration 4 base directory for messages all directories below are relative to base directory base dir smclient interface C smclientbase interface location for sent files sent location sent location form messages to be send outbox location outbox location for incoming messages inbox location inbox location for deleted messages deleted location deleted location for exported messages a exported location exported location of failed messages failed location failed failed to send it could not be send by the smclient failed tosend location failed failed_to_s
40. alar 12 Martin Liebrich Mises a jour version 1 0 RC4 17 08 2009 SM ML Stefan Malar 13 Martin Liebrich Mises a jour version 1 0 RC5 24 08 2009 SM ML Stefan Malar 1 0 Stefan Malar Version finale 04 09 2009 ML 1 1 Sylvain Information sur l utilisateur par d faut au chap 11 09 2009 Berthouzoz 5 5 7 nouvel version MS SQL JDBC Driver mises a jour selon email regu sm client support ctp consulting com 1 2 Sylvain Correction de l exemple LDAP 15 12 09 Berthouzoz 1 3 Sylvain Mises a jour version 1 1 0 19 01 09 Berthouzoz 1 4 Sylvain Updates Release 2 1 03 03 2010 Berthouzoz 1 5 Christian Updates for Tomcat Installation 11 03 2010 Wattinger 1 6 Sylvain Updates for Tomcat with Oracle or MySQL 23 03 2010 Berthouzoz Version sM Client I Modifie Installations Handbuch Description Nil ern data Version finale Valide 1 7 Sylvain Update page 21 Chapter 4 3 8 11 2010 Berthouzoz 1 8 Sylvain Updates Release 3 0 05 01 2011 SM Berthouzoz 1 9 Sylvain Updates Release 3 0 after feedback from test 11 02 2011 Berthouzoz 2 0 Sylvain Updates Release 3 0 after feedback from test 07 03 2011 SM Berthouzoz 2 1 Sylvain Updates Release 4 0 chapter 4 7 chapitre 04 01 2012 Berthouzoz 4 2 2 6 2 2 A Rapanaro Updates Release 4 0 rajout le repertoire 18 01 2012 plugins dir au chapitre 4 2 2 4 2 3 S B
41. ard d installation pour Windows est galement livr en une deuxi me version qui permet l installation comme service JBoss et MySQL sont alors install s sous le nom de service suivant MySQL MySQL JBoss JBoss Application Server 4 2 SMClient MySQL est d s le d part configur sur Startup Type Automatic Il est donc d marr automatiquement lors du d marage du syst me JBoss est sur manuel et doit donc tre d marr manuellement ou le Startup Type doit tre mis sur Automatic Attention que MySQL soit toujours d marr avant JBoss afin de garantir le bon fonctionnement du client sM Il est possible de determiner cette fonction via Registry et garantir ainsi une proc dure de d marrage correcte Dans la cl HKEY LOCAL MACHINE SYSTEM CurrentControlSet Services JBOSS4JAVA6 il faut changer DependOnService avec Modifiy Dans le Data Dialog la nouvelle valeur doit tre MySQL Vous trouverez des informations supp mentairessur http support microsoft com kb 193888 5 8 Wizard d installation pour Linux Il existe galement un Wizard d installation pour Liux Celui ci est d marr cmme suit sudo java jar smclient linux jar L installation est analogue Windows il faut toutefois observer les points suivants est recommand de ne pas utiliser d espaces dans le r pertoire d installation S assurer qu aucune instance MySQL soit d j install e ou soit m me en cours Ne pas mettre de mot de pass
42. at Configuration de la source de donn es pour le client sM Il faut configurer une source de donn es afin de pouvoir acc der aux donn es depuis le serveur d application et donc depuis l application Pour la configuration il faut ajouter p ex dans le dossier CATALINA HOME config CATALINA localhost un fichier smclient xml Voici une configuration pour MySQL titre d exemple Pour les autre bases de donn es il faut changer les champs driverClassName et url Reportez vous aux chapitres correspondant pour les valeurs exactes Context path smclient gt Resource name jdbc smclient auth Container type javax sql DataSource maxActive 100 maxIdle 30 maxWait 10000 username smclientUser password password driverClassName com mysql jdbc Driver url jdbc mysql localhost smclient Context Les champs username et password correspondent aux valeurs qui ont t d finies la section 4 1 1 Autres biblioth ques Il faut en outre encore ajouter le commons logging 1 1 1 jar le pilote JDBC correspondant votre base de donn es et la librairie log4j on peut les t l charger ici http dev mysql com downloads connector j pilote JDBC pour MySQL http www microsoft com downloads details aspx displaylang en amp FamilyID 99b21b65 e98f 4a61 b811 19912601fdc9 sqljdbc4 jar pilote JDBC pour Mircosoft SQL Server 2000 2008 http www oracle com technology software tech java sglj
43. ator Ray voursedexTan insert into smUser username password firstname lastname defaultLanguage sedexId values SuperUser 2atHgjIcy5hGeeRwzYt tmhQ Super User Ure mett CREATE TABLE smUser smRole smUserimiad BIGINT NOT NULL role ie BIGINT NOT NULL ingert into enlsersemkole smliser icd role ic values select ic from smUser where username Admin select id from smRole where name Admin Sa Na Else Gul ibs eme acl Balz acl EURE EM eebe el from smUser where username SuperUser select id from smRole where name SuperUser Ce script cr e un utilisateur standard auquel d autres utilisateurs peuvent tre ensuite ajout s Cet utilisateur a le nom d utilisateur Admin et aussi le mot de passe Admin Il faut faire attention aux majuscules et aux minuscules au moment de la saisie 4 1 2 Installation client sM sur JBoss Configuration de la source de donn es pour le client sM Il faut configurer une source de donn es afin de pouvoir acc der aux donn es depuis le serveur d application et donc depuis l application Il faut pour cela configurer dans JNDI une entr e smclient montrant la banque de donn es et le sch ma correspondants Pour la configuration il faut ajouter p ex dans le dossier JBoss Home server default deploy un fichier smclient ds xml Voici une configuration pour MySQL titre d exemple lt xml version 1 0 encoding UTF 8
44. charger Apache Tomcat 6 x depuis Internet http tomcat apache org download 60 cgi Il faut utiliser la version Core Par example pour Windows apache tomcat 6 0 24 windows x86 zip Il faut tenir compte du fait que les variables d environement JRE HOME et CATALINA HOME doivent tre configur es correctement Par example JRE HOME C Program Files Java jdk1 6 0_06 et CATALINA HOME C Program Files TomcatNapache tomcat 6 0 24 3 1 5 Installation de MySQL On peut t l charger MySQL 5 1 GA depuis Internet http dev mysgl com downloads mysql 5 1 html L installation s effectue conform ment aux instructions d installation de MySQL http dev mysql com doc refman 5 1 en installing html 4 INSTALLATION ET CONFIGURATION DU CLIENT sM Une fois que l infrastructure a t install e on peut installer le client sM et le banc d essai Il faut installer les composants suivants et proc der aux configurations correspondantes e Fichier WAR client sM e Banque de donn es client sM e Configuration des dossiers des interfaces e Configuration technique e Configuration m tier apr s le d marrage du systeme Une configuration par d faut est livr e avec l ensemble 4 1 Installation manuelle 4 1 1 Installation de la base de donn es client sM On montre ici titre d exemple comment la banque de donn es client sM est install e sous mySQL Une banque de donn es portant le nom de smclient doit tre cr e sous mySQL
45. chkg properties pour tous les types de messages du domaine Dans la version 4 0 seuls les messages eschkg utilisent cette propri t fuse ech standard for eschkg message should message be converted true Ou configuer la conversion dans le fichier optionel message process xml uniquement pour un type de message particulier Les valeurs dans ce fichier sont prioraires sur celles du message handler eschkg properties lt convert eschkg message in eCH format gt message type 10301 gt lt conversion gt true lt conversion gt lt message gt 5 Les fichiers eschkg doivent tre trait s par une application externe il faut donc d finir les r gles suivantes dans le fichier rules xml lt triage gt lt rule gt lt criteria gt lt messageType gt 10301 lt messageType gt lt eritenie gt lt destinationrolder C smelientbase interraee eschkg nbox desti nationFolder gt lt PDFGeneration boolean false gt lt useCase gt receive lt useCase gt lt rule gt lt rule gt lt criteria gt lt messageType gt 10301 lt messageType gt lt criteria gt lt destinationFolder gt C smclientbase interface eschkg sent lt destin ationFolder gt lt PDFGeneration boolean false gt lt useCase gt send lt useCase gt lt rule gt lt trlage gt 4 7 Configuration du domaine eCH0058v4 Cette configuration est n cessaire uniquement pour recevoir ou envoyer les messages eCH0058v4 1 Ins rer le dom
46. ckage est est mis disposition sur notre site web http sm client ctp consulting com Produktive Ablage ou Test Ablage pour les instances de test sedexID commengant par T et doit tre copi l endroit correspondant d fini dans repository properties p ex C smclientbase interface repository D autres configurations peuvent tre adapt es vos besoins au besoin et de fa on analogue l installation manuelle chapitre 4 Il est aussi recommand d utiliser un mot de passe pour l utilisateur root pour la banque de donn es MySQL 5 5 D marrage du client sM La derni re tape du wizard installe une entr e de client sM dans le menu de d marrage et ou une ic ne de raccourci sur le desktop Le client sM peut tre d marr On d marre d abord la banque de donn es mysql une fen tre DOS propre est ouverte pour cela ensuite le serveur JBoss D s que le serveur JBoss l application est disponible 5 6 Deinstallieren des sM Clients Lors de l installation du client sM avec le Wizard une proc dure de d sinstallation est g n r e Elle se trouve sous INSTALL_DIR Uninstaller Il s agit d un Executable JAR qui peut tre utilis pour supprimer tous les r pertoires et banques de donn es de tout le client sM L utilisateur par d faut est Admin dont le mot de passe est aussi Admin Le nom d utilisateur ainsi que le mot de passe sont sensible la casse 5 7 Installation comme service Der Le Wiz
47. dans le syst me il faut en cr er un comme expliqu au chapitre 4 5 1 Activation de mandant multiple En tant que SuperUser les op rations suivantes sont possibles pour les mandants e Creation de mandant e Activation de mandants e D activation de mandants 1 En tant que SuperUser l utilisateur par d faut est SuperUser avec mot de passe SuperUser dans l interface utilisateur il est possible de cr er un nouveau mandant avec un administrateur Pour cela il faut remplir le formulaire ajouter un mandant 2 Ensuite il faut indiquer dans la base de donn e l emplacement des fichiers de configuration du nouveau mandant Il faut ici changer le chemin des diff rents fichiers et indiquer a la place de newMandantSedexld le m me idendifiant Sedex que dans l tape 1 INSERT INTO configuration VAETUE Veontig loeatien l smelientbase eont ig NewMandant contig properties newMandantSedexId select id from domain where name like smclient INSERT INTO configuration VALUES message handler location C smclientbase config_ newMandant message handler properties newMandantSedexId select id from domain where name like smclient INSERT INTO configuration uATUESNEEGposUbtohylocutron NN et EE EE e pository properties newMandantSedexId select id from domain where name like smclient INSERT INTO configuration VALUES formservice location C smclientbase config_newMandant f ormservice p
48. default appl ocal ication language e de finterval for checking files in seconds filechange listener interval 60 should messages xml files be validated with the schema should message be validated true should a LESC hment mime types be validated tachments be validated false folders displayed under the inbox default is unread important filterfolders read unread important max size for generating pdf from message in KB bigger messages won t be printed default is 2048 print message smaller 2048 xml files defines if backup is enabled backup enabled true folder used for backup and restore folder must exist backupDirectory D smclient backup time of backup hour of day time of day for backup 12 is full backup DB dump enabled Backup fullDB enabled false path to backup script backupBatch C smclientbase scripts windows MySQLSmClientBackup ba de defines if inbox is enabled inbox enabled true derines if formservice is enabled formservice enabled true desines if formservace is enabled formservice enabled false defines if LDAP should be used LDAP enabled false 4 2 2 2 message handler properties Parametres pour les processus protocol receipt timeout days Les Messsage n cessitant une quittance de protocoles sont copies dans le dossier Failed to transmit si la quittance de protocole n arrive pa
49. e affich e Failed location Contient les messages ne pouvant pas tre trait s failed tosend location Contient les messages qui chouent avant leur envoi failed transmit location Contient les messages qui chouent pendant leur envoi deleted location Contient les messages qui ont t d plac s dans la corbeille papiers exported location Contient les messages export s Interface vers l adaptateur sedex base dir adapter Chemins de dossier de l interface de l adaptateur sedex adapter inbox location Entr e message adapter receipt location Entr e quittance adapter outbox location Sortie de message since base direct base directory base dir smclient interface D smclient interface location for sent files Exemple de configuration tt message handler properties for the standard domain 4 Timeout for protocol receipt in send process Must be a positive finteger Default is 3 protocol receipt timeout days 3 4 0 0 Add the Sedex Receipt to the zip of the message default is false should sedex receipt be added false tory for messages all directories below are relative to sent location sent location form messages to be send outbox location outbox location for incoming messages inbox location inbox post box location for deleted messages deleted location deleted location for exported messag
50. e l utilisateur est sauvegard e ll est possible de choisir entre de fr et it rolesCtxDN Directory Node utilis par le client sM comme base pour les demandes de r les roleFilter Filtre selon quel r le il faut chercher Exemple member cn username OU ZUR OU Accounts DC ctp DC com roleAttributelD Attribut dans lequel sont enregistre les r les Exemple nom AdminRoleMapper optionnel Nom de groupe qui doit tre d fini avec le r le Admin du client sM Exemple smClinetAdministrator Si non appliqu on utilise de mani re standard Admin ActiveUserRoleMapper optionnel Nom de groupe qui doit tre d fini avec le r le ActiveUser du client sM Exemple smClinetActiveUser Si non appliqu on utilise de mani re standard ActivUser PassiveUserRoleMapper optionnel Nom de groupe qui doit tre d fini avec le r le PassiveUser du client sM Exemple smClinetPassiveUser Si non appliqu on utilise de mani re standard PassiveUser SuperUserRoleMapper optionnel Nom de groupe qui doit tre d fini avec le r le SuperUser du client sM Exemple smClientSuperUser Si non appliqu on utilise de mani re standard SuperUser Exemple d une configuration LDAP Hypoth se la structure LDAP suivante LDIF Utilisateur DN CN John Frei OU ZUR OU Accounts DC ctp DC com ObjectClass OrganizationalPerson CN Joh
51. e pour MySQL Root Aucun raccourci n est g n r 6 INSTALLATION ET CONFIGURATION DU BANC D ESSAI L installation et la configuration du Banc d essai sont semblables celles du client sM et suppose galement que l installation de l infrastructure a t faite Le banc d essai peut tre utilis dans une installation existante du client sM il n est pas besoin d ajouter une banque de donn es JBoss ou MySQL s par e Si le client sM a d j t compl tement install les tapes marqu es seulement pour installation individuelle ne doivent plus tre effectu es Elles ont t faites lors de l installation du client sM Remarque Le banc d essai ne peut simuler qu un seul adaptateur sedex Il n y a pas de fonctionnalit de mandants multiples Les tapes suivantes doivent tre effectu es pour utiliser le banc d essai e Bancd essai banque de donn es e Banc d essai fichier WAR e Configuration des dossiers des interfaces 6 1 Installation de la banque de donn es des bancs d essai On montre ici a titre d exemple la mani re dont la banque de donn es peut tre install amp e sous mySQL Il faut cr er sous mySQL une banque de donn es portant le nom de smclient testbed ie ICN ENEE ned Query OK 1 row affected 0 09 sec Il faut ensuite cr er un utilisateur de la banque de donn es pour pouvoir acc der a la banque de donn es Nom testbedUser Mot de passe password myse e VCR NIE T TARRE CERON me
52. e processus de r ception d envoi ou les deux receive send both La balise script comprend ensuite 0 n l ments args les valeurs de tous ces l ments sont transmises au script Balise args Correspond un argument du script Pour plus de d tails concernant les arguments du script reportez vous la documentation fournie avec celui ci Balise export pdf splitting Red finit la valeur de message handler properties La balise export pdf splitting d finit si l exportation d un message group doit cr er plusieurs fichiers PDF un par message interne du message group ou un seul fichier PDF True L exportation du message group cr e un fichier PDF par message interne False L exportation du message group cr e un seul fichier PDF Groovy Script Le script doit impl menter l interface ch admin smclient service script GroovyScriptController Cette interface ne d finit qu une m thode String process ch admin smclient model Message msg File xml File pdf String args Ci dessous un exemple d impl mentation class HelloGroovy implements ch admin smclient service script GroovyScriptController String process ch admin smclient model Message msg File xml Hole pat Ed eM CS println Hello groovy args for message msg messageId Success Pour plus d informations au sujet de Groovy reportez vous au site http groovy codehaus org Le sM Client emploie la version 1 7 5 de Groovy
53. e r gle pour les messages de monitoring SSK rules xml Priere de modifier le destinationFolder selon votre installation locale et de cr er le r pertoire correspondant lt Siehe Kapitel 4 2 2 7 f r die komplette Konfiguration gt lt rule gt lt criteria gt lt messageType gt 3991 lt messageType gt EE EE lt destinationFolder gt C smclientbase interface inbox monitorin g lt destinationFolder gt lt useCase gt receive lt useCase gt lt rule gt 4 2 3 2 BSV Exemple de r gle pour les messages de monitoring BSV rules xml Priere de modifier le destinationFolder selon votre installation locale et de cr er le r pertoire correspondant lt Siehe Kapitel 4 2 2 7 f r die komplette Konfiguration gt lt rule gt lt criteria gt lt messageType gt 2991 lt messageType gt lt her teris gt lt destinationFolder gt C smclientbase interface inbox monitorin g lt destinationFolder gt lt useCase gt receive lt useCase gt lt rule gt 4 2 4 Configuration metier On trouvera la liste des configurations m tiers au chapitre 3 5 1 du document de design technique On proc de la configuration par l interm diaire d une interface web On en trouvera la description dans le manuel utilisateur 02 4 2 4 1 Configurations en option Certaines autres configurations du client sM sont en option et il ne faut y proc der qu en cas de besoin 4 2 4 1 1 Log On peut configurer le log co
54. ement d finir les droits d acc s sur les r pertoires en fonction des crit res de s curit de l entreprise L application n cessite dans tous les cas les droits de lecture et d criture Les valeurs contenues dans tous les fichiers de type properties ne doivent pas avoir d espace au d but et la fin 4 2 2 1 config properties sedexld Ihre Sedex ID plus utilis depuis la version 2 0 0 remplac par une valeur dans la base de donn e update message types Types de message pour les mises jour de syst me autoupdate Ex cuter les mises a jour automatiquement true false time of day for update Heure de la journ e laquelle les mises jour sont effectu es default locale Langue standard p ex pour l exportation filechange listener interval Intervalle d interrogation du client sM en secondes message batch pickup size Optionnel Nombre de message que le client sM traite en une fois Par d faut 50 should message be validated Les messages doivent tre valid s selon le sch ma XML Voir aussi 4 2 2 6 balise message validation should attachments be validated Les annexes de type mime doivent tre valid es backup enabled D finit si la sauvegarde est active backupDirectory Dossiers dans lequel les sauvegardes sont stock amp es en m moire time of day for backup Heure de la journ e a laquelle les sauvegardes doivent tre ex c
55. end failed to transmit means that in the send the sedex client could not transmit the message famled transmit locatton ta1 Ved tailed EIS configuration of sedex adapter working directory of sedex adapter all directories below are relative to base directory base dir adapter C smclientbase adapter directory for incoming messages adapter inbox location inbox directory for technical receipts adapter receipt location receipts directory for outgoing messages re adapter outbox location outbox 4 8 Configuration du domain ELM 4 8 1 Configuration principale Important Ce domaine a besoin de l adaptateur Swissdec sdA Le sdA doit tre pr alablement install Voir pour cela le manuel de l utilisateur de l adaptateur Swissdec Cette configuration est uniquement n cessaire pour l envoi et la r ception des messages ELM Swissdec certificats de salaire et Taxes la source 1 Ins rer le domaine ELM dans la base de donn es insert into domain name values elm 2 D finition de l emplacement des fichiers de configuration Modifier d abord la requ te avec votre sedexld et l emplacement correct du fichier INSERT INTO configuration VALUES message handler location C smclientbase config message handler elm properties yourSedexId select id from domain where name Like eimi 3 Un nouveau domaine peut aussi besoin de ses propres r pertoires c est pourquoi
56. ene Bed no tesbedUser localhost IDENTIFIED BY mot de passe Query OK 0 rows affected 0 06 sec Tableau de configuration On cr e ensuite un tableau de configuration que lon remplit des valeurs correspondantes Le script ci apr s doit tre adapt et ex cut mysa suse tenente bed mysql gt CREATE TABLE smclient_ testbed smMandant sedexId varchar 255 NOT NULL name varchar 255 DEFAULT NULL active bit DEFAULT false PRIMARY KEY sedexId mus CANTAN MASHI melmentste the Coni rgurer Lon keycelimm VARCHAR 255 NOT NULL confValue VARCHAR 255 sedexId VARCHAR 255 NOT NULL PRIMARY key sedexId keycolumn INSEE INTO Vsmelvent testbeds mMandant ieedexzrgd name acrive NOESIS DEC DECO INSEE SOO smelxe meats cdeb CORTO oura TONAT mese handlers location Cs smelientbase config messagc nandler tb properties testbed NSH Ear INIO iui ene eee ee VATUESI rac ee Ee eegener o smelientbase contig proper iee testbed INSEE INIO E gtest bed cielo Deere VALTIS Geon ron bocar oni 7 ncc neken ba econo comtigeproperries testbed e message handler location d finit l endroit o se trouve le fichier Properties avec les configurations pour le banc d essai e repository location d finit l endroit o se trouve le fichier Properties avec les configurations pour le stockage Si le client sM est aussi simultan ment install on peut emplo
57. ers le prochain cran par l interm diaire du bouton Next 5 3 6 Menu de d marrage et raccourci Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 60 84 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client d IzPack Installation of sM Client Setup Shortcuts Create shortcuts in the Start Menu Select a Program Group for the Shortcuts Accessories create shortcut for Administrative Tools Games IzPack4 3 0 all users Mozilla Firefox Startup Windows Resource Kit Tools current user sM Client Made with IzPack http izpack org Figure 8 Menu de d marrage et raccourci Sur cet cran l utilisateur peut g n rer une inscription dans le menu de d part et ou un raccourci de desktop On peut continuer vers le prochain cran l aide du bouton Next Remarque Sous Windows 64bits les raccourcis ne peuvent tre cr e le programme montre une page vierge et il faut cliquer sur Quit L installation est malgr tout compl te Le raccourcit vers INSTALL PATHNcriptswindows start smclient bat peut tre cr manuellement Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 61 84 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 7 Fin de l installation d IzPack Installation of sM Client 8 Installation has completed successfully An
58. erthouzoz Update chapitre 4 7 ech0058v4 message 08 02 2012 handler outbox 2 4 S Berthouzoz Update durant les tests 4 2 2 Limitations pour les 22 02 2012 backups 2 5 S Berthouzoz SMCTESTING 37 Beim Versenden von 29 02 2012 ech0058v4 Meldungen wird die Sedex Quittung nicht abgelegt 4 2 2 message handler properties 2 6 Andrea PDF Splitting von Sammelmeldungen 4 2 2 15 06 2012 CW Rapanaro 2 7 Sylvain ELM Konfiguration 4 8 27 06 2012 CW Berthouzoz 2 8 Christian ELM Konfiguration 4 8 Rules 10 07 2012 SB Wattinger O 26 07 2012 ee Monitoring triage rule 24 09 2012 References ID Nom Version Document 01 Design technique V2 8 Technisches_Design_sM Client_v2 8 pdf 02 Manuel utilisateur V1 3 CHM sM Client Manuel de l utilisateur v1 3 pdf 03 04 05 06 07 Erstellt Januar 2012 von Cambridge Technology Partners 2011 7 84 sM Client Projekt Version finale Installations Handbuch Objet du document 1 OBJET DU DOCUMENT Le document suivant d crit l ensemble des tapes d installation et des configurations n cessaires afin d installer et de mettre en service le client sM et le banc d essai correspondant Erstellt 4 Januar 2012 von Cambridge Technology Partners O 2011 8 84 2 APERGU GENERAL La mise en service du client sM et du banc d essai exige diff rentes tapes d installation et de configuration On peut a cette occasion proc der a l installation manuellement ou en ayant recours a un wizard Les sy
59. es exported location exported location of failed messages failed location failed failed to send it could not be send by the smclient failed tosend location failed failed_to_send failed to transmit means that in the send the sedex client could not transmit the message told nente damit configuration of sedex adapter working directory of sedex adapter all directories below are relative to base directory base dir adapter C smclientbase adapter directory for incoming messages adapter inbox location inbox directory for technical receipts adapter receipt location receipts directory for outgoing messages adapter outbox location outbox 4 2 2 3 formservice properties Stockage messageld prefix number Chiffre 4 num ros plac devant le ID message des messages g n r s par le service formulaire Exemple de configuration file contains settings formservice of sM Client perfix for messagelds messageld prefix number 4444 4 2 2 4 repository properties Stockage ablage base dir Stockage du repository du client sM Les autres chemins sont relatifs par rapport a ce dossier xsd_xslt Ensemble des formats de message XSD Instructions de conversion correspondantes XSLT documentation Contient la documentation concernant le client sM p ex manuel utilisateur peut contenir des sous dossiers si envoy
60. essages ne pouvant pas tre trait s failed tosend location Contient les messages qui chouent au moment de leur envoi failed transmit location Contient les messages qui chouent d s avant leur envoi receipt location Contient les quittances envoy es par le banc d essai pour v rification apr s l envoi Interface de l adaptateur sedex simul base dir adapter Chemin du dossier de l interface de l adptateur sedex doit correspondre ceux du client sM tester adapter inbox location Entr e message doit correspondre celle du client sM tester adapter receipt location Entr e quittance doit correspondre celle du client sM tester adapter outbox location Sortie message doit correspondre celle du client tester testbed errortext Texte qui doit tre crit dans la confirmation de r ception m tier Exemple de configuration base directory for messages all directories below are relative to base directory base dir smclient interface C smclientbase testbed location for sent files sent location sent location for messages received outbox location received location for messages to send inbox location tosend location for deleted messages deleted location deleted location of exported messages exported location exported location of receipts receipt location receeipts location of failed messages
61. il y a un message handler properties par domaine ainsi le sM Client sait quel domaine un message appartient Ces r pertoires doivent tre cr s avant le d marrage du sM Client Les r pertoires de l adaptateur doivent correspondre ceux d fini lors de la configuration du sdA Important Les r pertoires mentionn s dans ce fichier doivent tre disponible avant le d marrage du sM Client Veuillez les cr er si n cessaire Reportez vous la table ci dessous pour la correspondance entre la configuration du sM Client et du sdA ttt Message handler ELM configuration HAE elm timeout days 60 base directory for messages all directories below are relative to base directory base dir smclient interface C smclientbase interface Hloeat on tor sent files sent location elm sent location form messages to be send outbox location elm outbox location for incoming messages inbox location inbox post box location for deleted messages deleted location elm deleted location for exported messages exported location elm exported location of failed messages failed location failed failed to send it could not be send by the smclient failed tosend location ralled ralled to send failed to transmit means that in the send the sedex client could not transmit the message tated ezio lee tion ce tal led geo era olii configuration of swissdec adapter
62. it correspondre une valeur de la table Mandant INSERT INTO configuration VALUES message process location C smclientbase config message process xml yourSedexId select id from domain where name like UST Le fichier message process xml permet de d finir certains param tres du processus par type de message ceux ci ont priorit sur la configuration standard ainsi que de d finir un script ex cuter lors de la r ception d un message Exemple de configuration vss version il ON deux lier Vins We cl Document o ewe s recite Conan October Qi 2010 Author 3 Sylyain BErThouzoz Description Test Example message process xml file to define scripts that the sM Client can perfom before the triage gt lt processes gt lo only tae most peciric ome le exsecta gt lt script for every message gt 1 Script path ytarget test celassesjtest groovy gt lt args gt default lt args gt lt args gt config lt args gt v Serpe cript only tor one message UR lt message type 2003 subType 000101 gt lt message validation gt false lt message validation gt lt script path src test resources test exception groovy noPdfGeneration true process receive gt 3 lt args gt EXCEPTION lt args gt lt args gt arg2 lt args gt aa lt script path src test resources test send groovy noPdfGeneration true process send gt 3 lt args gt default lt args gt
63. jaunes doivent tre modifi es lt P werslon 1 0 Geet oe Unive lt participants xmlns xsi http www w3 0rg 2001 XMLSchema instance xsi noNamespaceSchemaLocation participants list xsd gt lt participant sedexId 99 ZH 99 municipalityId 1234 gt lt shortName gt Musterdorf lt shortName gt lt longName gt Gemeinde Musterdorf lt longName gt lt participant gt participant sedexId 99 ZH 98 municipalityld 4321 gt lt shortName gt Musterdorf 2 lt shortName gt lt longName gt Gemeinde Musterdorf 2 lt longName gt lt participanta lt partieipenes 4 Dans le fichier message paritcipants list xml du cantonal repository est d finis quels participants ont droit de recevoir les messages Ici votre sedexld ainsi que ceux des communes d finis au point 3 doivent tre pr sent Le type et sous type de message doit correspondre aux valeurs du fichier message list xml d fini au point 2 lt P weicsilon 1 0 encoding MUC groups xmlns xsi http www w3 org 2001 XMLSchema instance xsi noNamespaceSchemaLocation message participants list xsd gt lt group name elm 1 gt participant sedexId 99 ZH 98 gt lt participant sedexId 99 ZH 99 gt participant sedexzid 75 300074 qu lt participant sedexId T6 900014 2 gt lt message type 9999 subtype 000909 gt lt group gt lt groups gt 4 8 3 R gles de triage pour ELM Les r gles de triage pour ELM suivent la configuration standard voir Err
64. le SuperUser dans la base de don e 1 Cr ation du r le SuperUser INSERT INTO smRole name description values SuperUser USujoeie Ule 2 Cr ation d un super utilisateur insert into smUser username password firstname lastname defaultLanguage sedexId values SuperUser 2atHgjIcy5hGeeRwzY mh0 Super User rfe n ll ENEE RE from smUser where username SuperUser select id from smRole where name SuperUser 3 Maintenant l identification en tant que SuperUser est possible mot de passe SuperUser aucun mandant selectionne 4 6 Configuration du domain eSchKG Cette configuration est n cessaire uniquement pour recevoir ou envoyer les messages eSchKG 1 Ins rer le domaine eschkg dans la base de donn es insert into domain name values eschkg 2 D finition de l emplacement des fichiers de configuration Modifier d abord la requ te avec votre sedexld et l emplacement correct du fichier INSERT INTO configuration VALUES message handler location C smclientbase config message handler eschkg properties yourSedexId select id from domain where name like eschkg 3 Un nouveau domaine a aussi besoin de ses propres r pertoires c est pourquoi il y a un message handler properties par domaine ainsi le sM Client sait quel domaine un message appartient Ces r pertoires doivent tre cr s avant le d marrage du sM Client HHHH message handler propertie
65. ment PATH 10 Ouvrez Gestion de l ordinateur 11 Dans l arborescence de la console cliquez avec le bouton droit sur Gestion de l ordinateur local puis cliquez sur Propri t s 12 Sous l onglet Avanc sous Variables d environnement cliquez sur Param tres 13 S lectionnez un utilisateur dans la liste Variables utilisateur pour 14 Cliquez sur le nom Path de la variable utilisateur ou syst me que vous souhaitez modifier ou supprimer 15 Cliquez sur Modifier pour modifier la valeur de la variable avec le nom Path 16 Ajoutez la fin du champ valeur Variable value un point virgule puis le chemin du r pertoire bin de Ghostscript Par exemple C Program Files gs gs9 04 bin 17 Pour v rifier ouvrez une fen tre de commande D marrer gt Ex cuter cmd puis entrez la commande gswin32 dll Une fen tre de commande ghostscript doit s ouvrir 1 Red marrer le sM Client Starten Sie den sM Client neu Linux Installer le paquet ghostscript par exemple apt get install ghostscipt ou regardet les instructions d installations sur http pages cs wisc edu ghost doc svn Install htm 4 2 2 6 message process xml Optionnel D claration du fichier dans la base de donn es du sM Client Le fichier message process xml doit tre d clar dans la table configuration du sM Client Ajouter le fichier de configuration suivant pour chaque Mandant qui va utiliser un script Dans la requ te suivante la valeur de yourSedexld do
66. mme suit JAVA OPTS Dlog4j configuration file C smclientbase config log config On peut r gler la JAVA OPTS soit dans la ligne de commandement ou dans les variables d environnement La connexion peut tre configur e comme suit dans log config log4j rootCategory INFO console R log4j log4j log4j log4j log4j appender appender appender appender appender Roll file per day log4j log4j log4j appender appender appender console org apache log4j ConsoleAppender console layout org apache log4j PatternLayout console layout ConversionPattern X sedexId m n R org apache log4j DailyRollingFileAppender R File C smclientbase log smclient log R DatePattern yyyy MM ad R layout org apache log4j PatternLayout R layout ConversionPattern d 5p C 1 5X sedexId m n Dans le fichier log config on peut aussi configurer le niveau de log souhait Il est ici regl sur INFO Les valeurs possibles sont TRACE DEBUG INFO WARN ERROR Le niveau TRACE produit une norme quantit de log et ne devrait pas tre utilis en production Le sM Client utilise le log du niveau DEBUR au niveau ERROR Il est possible de configurer le log au niveau DEBUG uniquement pour le sM Client Pour cela il faut ajouter la ligne suivante au fichier log comfig log4j logger ch admin smclient DEBUG 4 2 4 1 2 Certificat SSL Si l utilisation d un certificat est souhait e pour l e
67. n Frei Groupe DN CN SmClientAdmin OU Groups DC ctp DC com Member CN John Frei OU ZUR OU Accounts DC ctp DC com Name smClientAdministrator Dans ce cas il faut utiliser la configuration suivante LDAP configuration optional Idap provider ur 1dsp hostname 389 fauthentication type used to obtain user s roles should be simple authentication type simple bind credentials optional if not set than baseFilter userName baseCtxDN will be used bindDN CN Manager OU ZUR OU Accounts DC ctp DC com bindCredential secret from where to start search users baseCtxDN 0U ZUR OU Accounts DC ctp DC com base filter to search user in ldap baseFilter cn optional attribute containing user s language if not set default locale will be used languageAttributeID msExchUserCulture from where to start search roles rolesCtxDN 0U ZUR OU Groups DC ctp DC com tmatehing filter for searching roles username will be substitute with login name roleFilter member cn username OU ZUR OU Accounts DC ctp DC com roleAttributeID name AdminRoleMapper smClientAdministrator ActiveUserRoleMapper smClientActiveUser PassiveUserRoleMapper smClientPassiveUser 4 2 4 2 1 Configuration LDAP avec SSL Pour utiliser la connexion Idaps il faut installer le certifacat du serveur dap dans l environnement Java employe par JBoss de la mani re suivante 1 T l charger http blogs s
68. nir compte du fait qu en cas de t l chargement l aide d Internet Explorer l extension de fichier peut tre modifi e de war zip Dans ce cas il faut nouveau changer le suffixe en war une fois le t l chargement effectu Le fichier t l charg ne doit pas tre d comprim l aide de Win Zip ou de programmes similaires Le fichier WAR doit tre ensuite copi dans le dossier JBOSS HOME Server default deploy Le serveur JBoss proc de automatiquement un d ploiement de l application l option Autodeploy doit tre activ e c est le cas de fa on standard 6 3 Configuration du banc d essai 6 3 1 Configuration des dossiers des interfaces Les interfaces sont d finies dans le fichier Property message handler tb properties L exemple de configuration peut tre utilis avec l exemple de configuration client sM indiqu plus haut Veuillez vous assurer que les dossiers indiqu s existent bien 6 3 1 1 message handler tb properties Interface vers les applications m tieres base dir smclient interface Le dossier de base pour le client sM les autres chemins sont relatifs par rapport ce dossier sent location Dossier pour les messages qui ont t envoy s outbox location Dossier dans lequel sont sauvegard les messages recus par le banc d essai inbox location Dossier o sont stock s les messages que le banc d essai doit envoyer failed location Contient les m
69. nt doit correspondre avec sent location dans messagehandler properties affich dans la case postale Tous les messages sont saisis dans l adaptateur Il existe les Use Cases send receive et adapter les Use Cases d finissent les cas o les r gles doivent tre appliqu es send est utilis pour l envoi des messages receive pour la r ception des messages et adapter d finit quel message doit tre saisi dans le Inbox p ex si plusieurs clients sM utilisent un adaptateur rule contient criteria Crit res de r gles qui sont valu es n existent pas pour les r gles par d faut lt destinationFolder gt dossier dans lequel le message est m moris au cas o une r gle s applique seulement pour send uet receive lt PDFGeneration gt true false un PDF est g n r ou non dans ce cas en fonction de la valeur seulement pour send et receive lt PDFGeneration gt pdfSplitting true false d s 4 1 g n re un seul Zip pour tout le message group false ou un fichier pdf par messages internes true Valable uniquement pour les messages group s lt useCase gt comme d crit ci dessus criteria peut avec send et receive v rifier les valeurs suivantes lt messageType gt lt messageSubType gt lt messageAction gt lt testMessage gt Toutes ces valeurs font r f rence aux valeurs correspodantes dans le message Les combinaisons de vale
70. on Cambridge Technology Partners 2011 56 84 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 2 Choix de l identifiant Sedex sa pu IzPack Installation of sM Client EE x Specify your sedexld Sedexld Figure 4 Choix de l identifiant Sedex Made with IzPack http izpack org Sur cet cran doit tre entre l identifiant Sedex du sM Client Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 4 Januar 2012 von Cambridge Technology Partners O 2011 57 84 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 3 Ecran du jeu complet d IzPack Installation of sM Client 18 Select the packs you want to install Q Note Grayed packs are required M Boss 45 4 2 3 GA 109 09 MB mysql 5 1 GA 414 93 MB sM Client 0 1 2 28 87 MB scripts 16 94 KB Description JBoss Application Server Total space Required 552 91 MB Available space 2 22 GB Figure 5 Ecran du jeu complet Made with IzPack http izpack org Cet cran montre l ensemble des fichiers devant tre install s Tous les fichiers doivent tre imp rativement install s si bien qu il n existe pas de possibilit de s lection Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 58 84
71. onfigurations pour le service formulaire e rules location d finit l endroit o se trouve le fichier avec les r gles de triage e timeout time d finit en minutes le temps pendant lequel un utilisateur reste connect sans activit e keep deleted time d finit en jour le temps pendant lequel des messages restent conserv es dans la corbeille papiers avant d tre effac s e messsage Tables d utilisateurs Les tables d utilisateurs doivent tre galement cr s et remplis avec les valeurs correspondantes Il faut pour cela ex cuter le script ci apr s Mysql CREATE TABLE smRole id BIGINT NOT NULL AUTO INCREMENT name VARCHAR 255 description VARCHAR 255 PRIMARY KEY id insert into smRole name description values Admin amimi EAOn insert into smRole name description values ActiveUser Active User Sender insert into smRole name description values PassiveUser Passive User Receiver INSERT INTO smRole name description values SuperUser Super USE CREATE TABLE smUser id BIGINT NOT NULL AUTO INCREMENT username VARCHAR 255 password VARCHAR 255 firstname VARCHAR 255 lastname VARCHAR 255 defaultLanguage VARCHAR 255 sedexId VARCHAR 255 PRIMARY KEY id insert into smUser username password firstname lastname defaultLanguage sedexId values Admin 46 tAEewgFnQ toQ9ADB5Q administrator administr
72. or Reference source not found Error Reference source not found avec les particularit s suivantes e La g n ration automatique du fichier PDF ou CSV n est pas possible pour le domaine ELM e L lement lt messageAction gt dans lt criteria gt n est pas autoris sM Client Projekt Version finale Installations Handbuch Installation et configuration du client sM e Le type et sous type de message ne sont pas des types Sedex mais d fini dans le fichier message list xml du repository o Type de message elm o Sous type qst oder la Example de r gle pour ELM lt xml version 1 0 encoding UTF 8 gt lt triage xmlns xsi http www w3 0rg 2001 XMLSchema instance xsi noNamespaceSchemaLocation rules xsd gt lt Siehe Kapitel 4 2 2 5 f r die komplette Konfiguration gt lt rule gt lt criteria gt lt messageType gt elm lt messageType gt lt messageSubType gt qst lt messageSubType gt lt Criteria gt lt destinationFolder gt C smclientbase interface inbox elm lt dest inationFolder gt lt useCase gt receive lt useCase gt lt rule gt lt triage gt Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 52 84 5 INSTALLATION ET CONFIGURATION DU CLIENT SM L AIDE DU WIZARD Un wizard simplifiant l installation est livr pour des installations standard On proc de cette occasion une installation et une configuration analogue la description du chapitre
73. osssvc exe et service bat partir du fichier zip vers le dossier JBOSS HOME bin 3 Le fichier JBOSS HOME bin service bat doit tre adapt dans le fichier et un nom doit tre d fini pour le service set SVCNAME JBoss4java6 set SVCDISP JBoss Application Server 4 2 SMClient set SVCDESC JBoss Application Server 4 2 GA Platform Windows x86 4 On peut adapter en option le chemin pour les fichiers Log jbosssvc exe p 1 Starting SVCDISP gt run log call run bat lt r lock gt gt run log 2 gt amp 1 jbosssvc exe p 1 Shutdown SVCDISP service gt gt run log jbosssvc exe p 1 Shutting down SVCDISP gt shutdown log call shutdown S lt s lock gt gt shutdown log 2 gt amp 1 jbosssvc exe p 1 Shutdown SVCDISP service gt gt shutdown log La sortie de la console Jboss la console est sorte dans ce cas vers run log et shutdown log Pour intaller Joss en tant que service Windows il faut ex amp cuter la commande suivante JBOSS HOME bin service bat install Pour d sinstaller le service JBOSS HOME bin service bat uninstall On peut maintenant faire passer le Start mode dans Start Control Panel Administrative Services de manuel en automatique afin de faire d marrer le JBoss lors du d marrage du systeme On trouvera une description exhaustive en anglais sous http something about tech blogspot com 2009 0 1 running jboss as windows service html
74. roc dure ci dessous sM Client Projekt Version finale Installations Handbuch Installation sur d autres banques de EATE TABLE dbo configuration keycolumn varchar 255 NOT NULL confValue varchar 255 NULL sedexId varchar 255 NOT NULL domain id BIGINT NOT NULL PRIMARY KEY keycolumn ASC sedexId ASC domain id ASC ON PRIMARY 5 Saisie des valeurs dans le tableau configuration analogue a la proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex INSERT INTO configuration VALUES config location C smclientbase config config properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES message handler location C smclientbase config message handler properties yourSedexId 7 select id from domain where name like smclient INSERT INTO configuration VALUES repository location C smclientbase config repository properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES formservice location C smclientbase config formservice properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES rules location C smclientbase config rules xml yourSedexId selec
75. roperties newMandantSedexId select id from domain where name like smclient INSERT INTO configuration VALUES rules location C smclientbase config_newMandant rules x ml newMandantSedexId select id from domain where name like gmclient INSERT INTO configuration VALUES timeout time 30 newMandantSedexId select id from domain where name like smclient INSERT INTO configuration VALUES keep deleted time 10 newMandantSedexId select id from domain where name like smclient 3 Le nouveau mandant doit ensuite tre configur comme d crit au chapitre 4 2 Configuration du client sM 4 Dans l interface utilisateur le SuperUser peut maintenant activer le nouveau mandant Pour cela il faut s lectionner le nouveau mandant l aide de la case cocher correspondante et cliquer sur le lien activer d sactiver les mandants 5 L administrateur cr lors de l tape 1 peut maintenant s identifier et cr er de nouveaux utilisateurs 6 Important Pour activer la v rification des messages pour le nouveau mandant le server JBoss doit tre red marr 4 5 1 Activation de mandant multiple Pour pouvoir utiliser plusieurs mandants un utilisateur avec le r le SuperUser doit tre cr Si l authentification LDAP est utilis e il faut configur un r le en tant que SuperUser du client sM comme d crit au chapitre 4 2 4 2 Configuration LDAP Sinon il faut ajouter le r
76. s 1 x 2 X Aktualisieren von 1 0 0 auf 2 x fr pdf ER 3 0 Aktualisierung von 2 x auf 3 0_fr pdf 4 4 Nouvelle installation avec Backup complet Si le client sM est configur pour le Full Backup le client sM peut faire une r installation la suite de gros probl mes arr t du syst me disque d fectueux et remettre le syst me l tat initial Les tapes suivantes sont n cessaires Si les processus client sM serveur d application et ou banque de donn es sont encore en cours ceux ci doivent tre pr alablement termin s Ensuite le client sM doit effectuer un r installation compl te comme d crit Les r pertoires ventuellement encore pr sents doivent tre compl tement d sinstall s supprim s Configuration du client sM comme d crit La banque de donn es doit tre d marr e en premier Ex cution de la proc dure MySQLSmClientBackup bat sur Windows resp MySQLSmClientBackup sh sur Linux Unix La banque de donn es est ainsi restaur e MySQLSmClientBackup bat restore MySQLSmClientBackup sh restore D marrage du client sM Connexion comme Admin Sur la page Configuration gt Backup avec le bouton Restore Files il est possible de restaurer les r pertoires des messages y compris temp avec le bouton Restore Files 4 5 Cr ation d un nouveau mandant Pour la cr ation d un nouveau mandant il faut avoir le r le SuperUser Dans le cas o aucun SuperUser n est encore present
77. s apres X jours La valeur par d faut est de 3 jours La valeur doit amp tre comprise entre 3 et 28 jours should message be converted Optionnel D fini si les messages d autres domaine tel que eschkg doivent tre converti au format eCH Par d faut aucune conversion n est effectu e should sedex receipt be added Optionnel depuis R4 0 0 D fini si la quittance Sedex doit tre ajout au fichier zip du message durant le processus d envoi Ceci ne fonctionne que pour les messages au format zip Tout les messages sauf eschkg sans conversions La valeur par d faut est false export pdf splitting Optionnel depuis R4 1 D finit si il faut g n rer un seul fichier PDF pour tout le message group false ou un fichier PDF par message interne true Cette configuration est valable pour tout les types de messages La valeur par d faut est false Cela peut aussi tre configur pour un type de message particulier voir 4 2 2 6 message process xml Interface vers les applications m tiers base dir smclient interface Dossier de base du client sM les autres chemins sont relatifs par rapport ce dossier sent location Dossier des messages qui ont t envoy s outbox location Sortie message pour les messages m tiers devant tre exp di s inbox location Entr e message pour les messages qui ont t recus et pour lesquels la case postale doit tr
78. s for the eSchKG domain THERE fuse ech standard for eschkg message should message be converted true base directory for messages all directories below are relative to base directory base dir smclient interface C smclientbase interface eschkg tleeat on for sent files sent location sent location form messages to be send outbox location outbox location for incoming messages inbox location inbox location for deleted messages deleted location deleted location for exported messages dus exported location exported location of failed messages failed location failed failed to send it could not be send by the smclient failed tosend location failed failed_to_send failed to transmit means that in the send the sedex client could not transmit the message failed transmit locarion fatlled tal led sro transmit 4 Les messages eschkg peuvent tre recus et envoy s depuis l application m tier au format eCH ou au format eSchKG Par d faut le format eSchKG est utilis Pour employer le format eCH il faut configurer le sM Client de mani re appropri e La configuration s effectue soit pour tous les messages dans le message handler eschkg properties ou par type de message dans le fichier message process xml Les propri t s sp cifiques configur es dans ce fichier ont priorit sur la configuration g n rale On peut configurer la conversion dans le fichier message handler es
79. s r gles adaptateur si plusieurs clients sM ou applications sont connect s un adaptaeur Cette r gle permet de saisir tous les messages de type 3001 envoy s au destinataire T6 90001 4 2 rule criteria lt recipientId gt T6 900014 2 lt recipientId gt lt messageType gt 3001 lt messageType gt lt criteria gt lt useCase gt adapter lt useCase gt lt rule gt Cette r gle permet de saisir tous les messages de type 3002 lt rule gt lt criteria gt lt messageType gt 3002 lt messageType gt lt criteria gt lt useCase gt adapter lt useCase gt lt rule gt Cette regle permet de saisir tous les messages envoy s au destinataire T6 900014 1 lt rule gt lt criteria gt lt recipientId gt T6 900014 1 lt recipientId gt lt criteria gt lt useCase gt adapter lt useCase gt lt rule gt 4 2 3 Regle de triage Monitoring Les messages de monitoring seront envoy s chaque jour par smc monitoring ctp consulting com Pour que ces messages ne perturbent pas les applications m tiers il faut d finir une r gle de triage pour placer ces messages dans un dossier s par voir aussi le chapitre 4 2 2 7 du manuel d installation Cette regle travaille sur le type de message lors de la r ception e type de message 2991 pour BSV e type de message 3991 pour SSK Priere de modifier le destinationFolder selon votre installation locale et de cr er le r pertoire correspondant 4 2 3 1 SSK Exemple d
80. sent filesystem parent xml adapter failed transmit location PATH_ELM_FAILED_TO_TX undeliverable filesystem parent xml Nom du dossier dans le iun Nom de la propri t Description design 9 techniqu message handler Contient les messages recus par le IM ELM elm properties EE Ion sdA pour traitement au sM Client Out ELM message handler adapter outbox location Le sM Client place ici les elm properties messages de r ponse pour le traitement au sdA message handler Sent ELM adapter sent location Messages envoy s avec succ s elm properties Failed to message handler adapter failed transmit Messages de r ponse que le sdA transmit ELM elm properties n a pas pu transmettre Failed to receive ELM message handler elm properties adapter failed receive Messages pour lesqels le sdA a d tect une erreur m tier Melaung message handler E EE E Messages recus et affiches dans la Eingang FA elm properties boite aux lettres Meldung message handler Boite d envoi pour les messages Ausgang FA elm properties Seon m tiers a envoyer Sent FA message handler nt location Messages envoy s elm properties Failed EA message handler filed iGeation Messages qui n ont pas pu tre elm properties trait s Failed to send FA message handler elm properties failed transmit location Messages qui n ont pas pu tre transmis
81. server default deploy smclient ds xml lt xml version 1 0 encoding UTF 8 gt lt DOCTYPE datasources PUBLIC JBoss DID JBOSS JCA Config 1 5 EN http www jboss org j2ee dtd jboss ds_ 1 5 dtd gt lt datasources gt lt local tx datasource gt lt jndi name gt smclient lt jndi name gt lt connection url gt jdbc sqlserver hostname SQLEXPRESS 1433 databaseName smclient SelectMethod cur sor lt connection url gt lt driver class gt com microsoft sqlserver jdbc SQLServerDriver lt driver class gt lt user name gt smclientUser lt user name gt lt password gt password lt password gt lt local tx datasource gt lt datasources gt lt connection url gt doit correspondre a la configuration DB respective Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 79 84 8 2 Oracle 1 Cr er une banque de donn es smclient 2 Cr er le login smclientUser attribution du r le db owner pour banque de donn es smolient 3 Cr er le tableau smMandant et ajouter les valeurs selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex EATE TABLE smMandant sedexId varchar2 255 char NOT NULL PRIMARY K name varchar2 255 char NOT NULL active number 1 DEFAULT 0 INSERT INTO smMandant VALUES yourSedexId mandantName 1 EAT
82. st mes d exploitation Windows Linux ou Unix sont pris en charge Il faut installer les composants suivants JDK 6 0 adaptateur sedex ne fait pas partie int grante de la livraison du client sM JBoss 4 2 3 GA ou Apache Tomcat MySQL 5 1 GA Fichier WAR client sM Banque de donn es client sM Banc d essai fichier WAR Banc d essai banque de donn es Il faut ensuite proc der aux configurations suivantes sur l installation Configuration de l adaptateur ne fait pas partie int grante de la livraison du client sM Configuration des dossiers des interfaces client sM et banc d essai Configuration technique client sM et banc d essai Configuration m tier apr s le d marrage du syst me client sM et banc d essai Une configuration par d faut est fournie avec l ensemble 3 INSTALLATION ET CONFIGURATION DU LOGICIEL D INFRASTRUCTURE Le logiciel d infrastructure correspondant doit d abord tre install resp tre d j l en tant que base permettant de faire fonctionner le client sM et le banc d essai Les composants suivants doivent tre en principe installes e JDK6 0 e adaptateur sedex ne fait pas partie int grante de la livraison du client sM e JBoss 4 2 3 GA ou Apache Tomacat e MySQL 5 1 GA Il faut ensuite proc der aux configurations suivantes sur l installation e Configuration de l adaptateur ne fait pas partie int grante de la livraison du client sM e Configuration de JBoss e
83. t lt criteria gt lt testMessage gt isa ica lt destinationFolder gt inbox test messages location lt destinationFolder gt lt useCase gt receive lt useCase gt lt rule gt lt default rule has no criteria gt lt rule gt dest mortonbalder Cs smelientbhbase EE EE bora destinationFolder gt lt PDFGeneration boolean false pdfSplitting false gt lt useCase gt receive lt useCase gt same rule lt destinationFolder gt C smclientbase interface sent lt destinati onFolder gt lt PDFGeneration boolean false pdfSplitting false gt lt useCase gt send lt useCase gt lt rule gt lt default rule for adapter so all messages are picked up gt lt rule gt lt useCase gt adapter lt useCase gt lt rule gt lt triage gt Explication de l utilisation de r gles L l ment triage contient un nombre illimit d l ments rule Les r gles sont appliqu es dans t te de liste Pour les Use Cases useCase send et receive il est absolument n cessaire d avoir une r gle par d faut Une r gle par d faut n a pas de crit res lt criteria gt La configuration standard la r ception est telle que le message pour lequel il n existe pas de r gles sp cifiques est d plac l entr e de la case postale doit correspondre avec inbox location dans messagehandler properties Pour l envoi ces messages sont d pos s dans le dossier Se
84. t MySQL 3 1 Installation manuelle et configuration 3 1 1 Installation du JDK On peut t l charger un environnement Java correspondant JDK version 6 0u4 ou plus depuis Internet http java sun com javase downloads index jsp L installation de JDK s effectue conform ment aux instructions d installation de SUN http java sun com javase 6 webnotes install index html 3 1 2 Installation et configuration de l adaptateur sedex L adaptateur sedex version actuelle 2 0 8 peut tre t l charg depuis Internet http www media stat admin ch software sedex sedex_adapter_installer_v2_0_8 exe L installation et la configuration s effectue conform ment aux instructions d installation de l OFAS http www bfs admin ch bfs portal de index news 00 00 12 01 html 3 1 3 Installation et configuration de JBoss AS On peut t l charger JBoss AS 4 2 3 GA depuis Internet http www jboss org jbossas downloads Il faut utiliser la version pour JDK 6 0 L installation s effectue conform ment aux instructions d installation de JBoss http www jboss org file access default members jbossas freezone docs Installation Guide 4 html index html Il faut tenir compte du fait que JBOSS HOME montre le dossier root correspondant de JBoss et non bin ou lib Il faut tenir compte du fait qu il ne doit pas y avoir d espace dans le chemin du dossier d installation 3 1 4 Installation et configuration de Apache Tomcat On peut t l
85. t id from domain where name like smclient INSERT INTO configuration VALUES timeout time 30 yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES keep deleted time 10 yourSedexId select id from domain where name like smclient Les valeurs doivent correspondre l installation client sM respective 6 Creer le tableau smRole selon proc dure ci dessous Erstellt 4 Januar 2012 von Cambridge Technology Partners O 2011 77184 FATE TABLE smRole id BIGINT NOT NULL ENTITY 0 1 name VARCHAR 255 description VARCHAR 255 PRIMARY KEY id 7 Ajouter les valeurs dans smRole selon proc dure ci dessous ERE INTO smRole name description values Admin inistrator ERT INTO smRole name description values ActiveUser ive User Sender ERT INTO smRole name description values PassiveUser Sive User Receiver ERT INTO smRole name description values SuperUser Super User 8 Cr er le tableau smUser et ajouter les valeurs selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex EATE TABLE smUser id BIGINT NOT NULL IDENTITY 0 1 username VARCHAR 255 NOT NULL password VARCHAR 255 firstname VARCHAR 255 lastname VARCHAR 255 defaultLanguage
86. tbase interface cantonal_reposi tory cantonal cantonal ISLE Seal list message message list participants_list message me ger Sale e pp miksi pompe IESEL eet Le art Cantona par open Ost EE panes epici Cantonal xsd xsle xsd xslt 2 Dans le fichier message list xml du cantonal repository est d fini quel type de message est emplpy dans Sedex Le type de message doit auparavant avoir t enregistr aupr s de Sedex voir Sedex handbuch et manuel d exploitation Sedex Il faut modifier les valeurs en jaunes pour qu elles correspondent votre environnement xen version OM csincoching Ur 2S lt messages xmlns xsi http www w3 org 2001 XMLSchema instance xSi noNamespaceSchemaLocation message list xsd gt lt message type 9999 subtype 000909 inFormService false sendWithoutProtocolReceipt false domain elm gt Erstellt 4 Januar 2012 von Cambridge Technology Partners 2011 50 84 lt redirectFrom type elm subtype qst gt lt name gt elm 9999 000909 lt name gt lt version number http www elm ch xmlns elm 9999 00090917 valide om 01 01 2010 velrartrom gt voltate HE lt version gt lt message gt lt messages gt 3 Dans le fichier participants list xml du cantonal repository sont d finies les communes Pour d sactiver la transmission a une commune particuli re il faut lui supprimer l attribut municipalityld Les valeurs en
87. tration interne les valeurs suivantes doivent tre configur es dans le dossier configuration config properties d crits sous 4 2 2 1 Pour que le LDAP soit utilis il est n cessaire de mettre la valeur LDAP enabled sur true NOTE La valeur username sera substitu e au login user name Idap provider url URL sous lequel LDAP ou AD sont joignables authentication type Doit toujours amp tre sur simple bindDN optional Directory Node defini par le client sM comme base pour la communication Le bind DN est l utilisateur qui a le droit de chercher dans le LDAP dans les limites de la base de recherche d finie En cas normal le bind DN a le droit de chercher dans tout le LDAP Exemple Active Directory bind DN cn administrator cn Users dc domain dc com OpenLDAP bind DN cn root dc domain dc com Remarque Si bindDN bindCredential ne sont pas utilis s c est bindDN baserFiler username baseCtxDN qui le sera bindCredential Mot de passe pour que le client sM puisse se connecter au LDAP baseCtxDN Directory Node utilis par le client sM comme base pour les demandes utilisateurs Exemple OU ZUR OU Accounts DC ctp DC com baseFilter Filtre selon quel utilisateur il faut chercher Remarque n est pas un filtre LDAP Pour la recherche on utilise le filtre suivant baseFiler username baseCtxDN Exemple cn languageAttributelD Montre le champ sur lequel la langue standard d
88. ulement pour installations individuelles On a galement besoin d un pilote JDBC pour que la banque de donn es fonctionne p ex mySQL Driver http dev mysql com downloads connector j 5 1 html Le fichier Zip t l charg doit d abord tre d comprim La biblioth que des pilotes dans le cas de mySQL mysql connector java 5 1 7 bin jar doit tre m moris e dans le dossier JBoss Home server default lib Autres bibliotheques seulement pour installations individuelles Il faut en outre encore ajouter le xml resolver 1 2 jar ce dernier peut tre t l charg ici http repo1 maven org maven2 xml resolver xml resolver 1 2 xml resolver 1 2 jar Il faut ensuite m moriser le fichier dans le dossier JBoss Home lib endorsed Configuration de la m moire vive seulement pour installations individuelles Afin d assurer un fonctionnement sans incidents il faut r gler le MaxPermSize 128MO Cela peut se faire soit dans les JAVA OPTS par l interm diaire de la ligne de commande ou des variables de syst me ou dans les fichiers run sh Linux resp run bat Windows dans JBoss Home bin p ex C smclientbase jboss 4 2 3 GA bin run bat La ligne suivante doit tre pour cela compl t e par XX MaxPermSize 128m set JAVA OPTS JAVA OPTS Xms128m Xmx512m XX MaxPermSize 128m Installation von testbed war La derni re version du banc d essai peut tre t l charg e ici http sm client ctp consulting com Veuillez te
89. un com andreas resource InstallCert java et compiler le programme InstallCert en ex cutant dans une fen tre de commande l endroit o se trouve le fichier InstallCert java javac InstallCert java 2 ex cuter le programme InstallCert java InstallCert IdapServerUrl 636 choisissez le certificat installer 3 R p ter l op ration 1 pour chaque serveur dap que le sM Client doit utiliser Cela va cr er un fichier jssecacerts dans le r pertoire courant 4 copier ce fichier dans votre environnement java JAVA HOME jire lib security 5 changer l url du serveur Idap dans config properties par exemple Idap provider url Idaps IdapServerUrl 636 Pour plus d informations reportez vous cette adresse http blogs sun com andreas entry no more unable to find 4 3 Installation d une mise jour Au cas ou ce n est pas le client sM qui est r install mais une mise jour cette derni re peut tre install e manuellement Il faut en principe pour la nouvelle version copier seulement le nouveau smclient war dans le dossier JBOSS HOME Server default deploy Au cas o il faut proc der des mises jour de la banque de donn es ou des fichiers de configuration ce point est communiqu dans les notes de la version et des scripts de mise jour sont galement mises disposition pour la banque de donn es Cela est souvent le cas lors d une mise jour vers une version majeure De A Instruction
90. uninstaller program has been created in C smclientbase Uninstaller 2 Generate an automatic installation script Made with IzPack http Vizpack org Figure 9 Fin de l installation Ceci est le dernier cran de l installation Generate an automatic installation script permet de g n rer un script d installation qui contient exactement la m me configuration comme effectu e Le wizard d installation cr e en outre un wizard de d sinstallation Ce dernier peut tre utilis pour une d sinstallation complete Il se trouve sous SINSTALL_DIR Uninstaller 5 4 Adaptations manuelles Au cas ou l adaptateur sedex n a pas encore t install il doit tre install comme d crit sous 3 1 2 Il faut cette occasion veiller ce que le client sM a cr les interfaces de l adaptateur sedex sous l adresse suivante INSTALL DIR adapter A cas o l adaptateur sedex a d j t pr c demment install et qu il y a d j des interfaces d adaptateur sedex la configuration du client sM doit tre adapt e manuellement en cons quence Sous SINSTALL DIR configuration le fichier message handler properties doit tre adapt en r glant la valeur base dir adapter au dossier correspondant Erstellt 4 Januar 2012 von Cambridge Technology Partners O 2011 62 84 On n a dans ce cas plus besoin des dossiers cr s par le wizard INSTALL DIR adapter et ils peuvent tre effac s Installation du stockage Le sto
91. uration VALUES message handler location C smclientbase config message handler properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUBSKrepesitory location 56 smcluentbose coutug peposltom pr operties yourSedexId select id from domain where name like Une mos Iy INSERT INTO configuration VALUES formservice location C smclientbase config formservice properties yourSedexId select id from domain where name like I Smeslsisesmiss ET INSERT INTO configuration VALUES rules locationt C smelientbase contig riles Een See dexId select id from domain where name like smclient INSERT INTO configuration VALUES A Een Cime NUES Ere S e cie oc c select ic fron GO Tr UTER where name like smclient INSERT INTO configuration VALUES keep deleted time 10 yourSedexId select id from domain where name like smclient e config location d finit l endroit o se trouve le fichier properties avec les configurations qui valent g n ralement pour le client sM e message handler location d finit l endroit o se trouve le fichier properties avec les configurations du MessageHandler gestionnaire de messages e repository location d finit l endroit o se trouve le fichier properties avec les configurations du stockage e formservice location D fini l emplacement du fichier Properties avec les c
92. urs suivantes sont possibles pour lt criteria gt pas de gt r gle par d faut lt messageType gt lt messageAction gt lt messageType gt et lt messageAction gt lt messageType gt et lt messageSubType gt lt messageType gt lt messageSubType gt et lt messageAction gt lt testMessage gt doit toujours tre une balise vide lorsqu elle est pr sente Ce crit re v rifie s il s agit d un message de test Le message est marqu avec le champ TestDeliveryFlag sur vrai Cette balise peut tre combin e avec les autres combinaisons indiqu es ci dessus Les r gles contenant testMessage sont appliqu es dans le m me ordre que dans le fichier rules xml La premi re r gle rencontr e correspondant au message sera appliqu e Il faut donc que les r gles de test les moins sp cifiques soit plac es apr s les autres criteria peut v rifier les valeurs suivantes dans adapter lt messageType gt lt recipientId gt Toutes ces valeurs se r f rent la valeur correspondante dans le message Les combinaisons de valeurs suivantes sont possibles pour lt criteria gt Aucune gt r gle par d faut lt messageType gt lt recipientId gt lt messageType gt und lt recipientId gt Si aucune r gle par d faut n est utilis e il faut s assurer que les messages de mise jour soient d finis de mani re ce qu ils soient recus Exemple r gles adaptateur Voici quelques exemples d application de
93. ut es backup fullDB enabled D finit s il faut faire un vidage complet de la banque de donn es lors de la sauvegarde On peut employer celui ci pour une restauration manuelle complete Remarque Lors de la sauvegarde avec plusieurs mandants il faut prendre en compte les limitations list es ci dessous backupBatch Lieu o le fichier MySQLSmClientBackup bat pour Windows resp MySQLSmClientBackup sh pour Linux Dans le cas d une installation manuelle le fichier doit tre copi ici par l installateur inbox enabled D finit si l Inbox est active formservice enabled D finit si le service formulaires est actif LDAP enabled D finit si LDAP doit tre utilis pour la gestion des utilisateurs Si ceci est r gl sur true les configurations d crites au chapitre 4 2 5 doivent tre en outre faites filterfolders Optionnel Liste de filtres appliqu e l Inbox s par s par des virgules Par d faut unread important Exemple filterfolders read unread important print message smaller Optionnel Les messages qui au format XML sont plus grand que cette valeur en Ko ne seront pas imprim s Valeur par d faut 2048 Limitations lors de la sauvegarde avec plusieurs mandants e Il est possible de faire une sauvegarde simple de la base de donn e BD sans les processus avec les fichiers ainsi qu une sauvegarde complete de la base BD avec
94. xploitation le JBoss peut tre configur en cons quence On trouvera ici http www jboss org community wiki SSL Setup une description fouill e de la mani re dont ceci pe t tre fait conform ment aux exigences 4 2 4 1 3 Permettre l acc s Jboss en dehors de la machine locale Pour ce faire l adresse Bind doit tre modifi e Cela peut se faire de deux mani res Si vous d marrez le serveur manuellement run sh Linux resp run bat Windows peut tre d marr avec l argument b 0 0 0 0 p ex run bat b 0 0 0 0 S vous souhaitez toujours d marrer le serveur de cette mani re vous pouvez adapter l adresse dans JBoss Homey server default deploy jboss web deployer server xml Connector port 8080 address 0 0 0 0 maxThreads 250 maxHttpHeaderSize 8192 emptySessionPath true protocol HTTP 1 1 enableLookups false redirectPort 8443 acceptCount 100 connectionTimeout 20000 disableUploadTimeout true gt Si l adresse Bind est sur 0 0 0 0 le serveur saisit tous les IP par lesquels la machine est appel e S il ne doit saisir qu un IP sp cifique celui ci peut tre configur 4 2 4 1 4 Changement de ports Port web connection JBoss Pour changer le port de web connection on peut adapter l entr e dans le fichier JBoss Home server default deploy jboss web deployer server xml Connector port 8080 address jboss bind address maxThreads 250 maxHttpHeaderSize 8192 emptySession
95. yer le m me stockage e config location d finit l endroit o se trouve le fichier Properties avec les configurations pour le banc d essai Si le client sM est aussi simultan ment install on peut employer le m me fichier 6 2 Installation du banc d essai sur JBoss Configuration de la source de donn es pour le banc d essai Il configurer une source de donn es afin de pouvoir acc der aux donn es depuis le serveur d application et donc de l application Il faut pour cela configurer dans JNDI une entr e testbed montrant la banque de donn es correspondante et le sch ma Pour la configuration on peut p ex ajouter dans le dossier JBoss Home server default deploy un fichier testbed ds xml Voici ici un exemple de configuration pour MySQL lt xml version 1 0 encoding UTF 8 gt lt DOCTYPE datasources PUBLIC JBoss DTD JBOSS JCA Config 1 5 EN http www jboss org j2ee dtd jboss ds 1 5 dtd gt lt datasources gt lt local tx datasource gt lt jndi name gt testbed lt jndi name gt lt connection url gt jdbc mysql localhost 3306 smclient testbed lt connection url gt lt driver class gt com mysql jdbc Driver lt driver class gt lt user name gt testbedUser lt user name gt lt password gt password lt password gt lt local tx datasource gt lt datasources gt Les champs user name et password correspondent aux valeurs qui ont t indiqu es au 6 1 Ajouter JDBC Driver se

sM-Client Projekt - sM-Client Releases

Contents

Download Pdf Manuals

Related Search

Related Contents