Configuration technique. Cambridge Technology Partners Client sM, Banc d’essai
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM
Message sortie
Vous pourrez trouver des détails au chapitre 4.1 du document de design technique.
Il faut configurer les dossier s 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:
Entrée message o Sous-dossier pour chaque application métier/triage o Sous-dossier pour la case postale
Sortie message o Sous-dossiers pour chaque application métier/triage
Messages envoyés o Sous-dossiers pour chaque application métier/triage
Messages ayant échoué o Sous-dossier pour les 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:
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 également 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.
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 18 / 84
sM-Client Projekt
Installations-Handbuch
4.2.2.1 config.properties
sedexId update.message.types autoupdate time.of.day.for.update default.locale filechange.listener.interval message.batch.pickup.size should.message.be.validated should.attachments.be.validated backup.enabled backupDirectory time.of.day.for.backup backup.fullDB.enabled backupBatch inbox.enabled formservice.enabled
LDAP.enabled filterfolders print.message.smaller
Erstellt:
4. Januar 2012
Version finale
Installation et configuration du client sM
Ihre Sedex ID (plus utilisé depuis la version 2.0.0, remplacé par une valeur dans la base de donnée)
Types de message pour les mises à jour de système
Exécuter les mises à jour automatiquement
(true/false)
Heure de la journée à laquelle les mises à jour sont effectuées
Langue standard (p. ex. pour l’exportation)
Intervall e d’interrogation du client sM (en secondes)
[Optionnel] Nombre de message que le client sM traite en une fois. Par défaut 50
Les messages doivent être validés selon le schéma
XML. Voir aussi 4.2.2.6 balise message-validation
Les annexes de type mime doivent être validées
Définit si la sauvegarde est active
Dossiers dans lequel les sauvegardes sont stockées en mémoire
Heure de la journée à laquelle les sauvegardes doivent être exécutées
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 complète.
Remarque : Lors de la sauvegarde avec plusieurs mandants, il faut prendre en compte les limitations listées ci-dessous.
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).
Définit si l’Inbox est active
Définit si le service formulaires est actif
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.
[Optionnel] Liste de filtres appliquée à l’Inbox, séparés par des virgules. Par défaut: unread,important. Exemple : filterfolders
=read,unread,important
[Optionnel] Les messages, qui au format XML sont plus grand que cette valeur (en Ko), ne seront pas
19 / 84 von Cambridge Technology Partners © 2011
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM imprimés.
Valeur par défaut: 2048
Limitations lors de la sauvegarde avec plusieurs mandants
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 complète de la base (BD avec les processus). La restauration de la sauvegar de 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
Si plusieurs mandants sont configurés, il faut tenir compte des points suivants : o La sauvegarde s imple peut être configuré par mandant et restauré par l’administrateur du mandant
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 complète 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.
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
#interval 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 should.attachments.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
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 20 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM
#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
t
#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
4.2.2.2 message-handler.properties
Paramètres pour les processus
protocol.receipt.timeout.days should.message.be.converted should.sedex.receipt.be.added export.pdf.splitting
Les Messsage nécessitant une quittance de protocoles sont copiés dans le dossier « Failed to transmit
» si la quittance de protocole n’arrive pas après X jours.
La valeur par défaut est de 3 jours.
La valeur doit être comprise entre 3 et 28 jours
[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.
[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
[Optionnel] depuis R4.1 Définit si il faut générer un seul fichier PDF pour tout le message groupé
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 21 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM
(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 messageprocess.xml
Interface vers les applications métiers
base.dir.smclient.interface sent.location outbox.location inbox.location
Failed.location failed.tosend.location failed.transmit.location deleted.location
Dossier de base du client sM; les autres chemins sont relatifs par rapport à ce dossier
Dossier des messages qui ont été envoyés
Sortie message, pour les messages métiers devant être expédiés
Entrée message, pour les messages qui ont été reçus et pour lesquels la case postale doit être affichée
Contient les messages ne pouvant pas être traités.
Contient les messages qui échouent avant leur envoi.
Contient les messages qui échouent pendant leur envoi.
Contient les messages qui ont été déplacés dans la corbeille à papiers.
Contient les messages exportés. exported.location
Interface vers l’adaptateur sedex
base.dir.adapter adapter.inbox.location adapter.receipt.location adapter.outbox.location
Chemins de dossier de l’interface de l’adaptateur sedex
Entrée message
Entrée quittance
Sortie de message
Exemple de configuration:
####
#message-handler.properties for the standard domain
####
#Timeout for protocol receipt in send process. Must be a positive
#integer. Default is 3 protocol.receipt.timeout.days=3
# since 4.0.0. Add the Sedex Receipt to the zip of the message,
# default is false should.sedex.receipt.be.added=false
#base directory for messages all directories below are relative to
#base directory base.dir.smclient.interface=D:/smclient/interface/
#location for sent files
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 22 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM 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 messages 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.location=failed/failed_to_transmit/
#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
messageId.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 messageIds messageId.prefix.number=4444
4.2.2.4 repository.properties
Stockage
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 23 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM ablage.base.dir xsd_xslt documentation integrity participants participants.list message.list message.participants.list version plugins.dir
Stockage du repository du client sM. Les autres chemins sont relatifs par rapport à ce dossier
Ensemble des formats de message (XSD)
Instructions de conversion correspondantes
(XSLT)
Contient la documentation concernant le client sM
(p. ex. manuel utilisateur); peut contenir des sousdossiers (si envoyé ainsi)
Contient à 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
Contient des documents qui décrivent les participants, les messages et les droits
Contient la liste des participants actuels
Contient la liste des messages actuels; décrit les messages qui sont actifs
Contient le dossier des participants; décrit les messages que les participants peuvent échanger
[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
[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 xsd_xslt=xsd_xslt
#directory for documentation documentation=documentation
#directory for optional integrity check files integrity=integrity_check
#directory of participants/message lists participants=participants_list
#location of participants list participants.list=participants_list/participants-list.xml
#location of messages list
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 24 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM message.list=participants_list/message-list.xml
#location of message-participants list message.participants.list=participants_list/message-participantslist.xml
#version properties version=participants_list/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 toutef ois 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 bouton droit sur Gestion de l'ordinateur (local), puis cliquez sur Propriétés.
3. Sous l'onglet Avancé, sous Variables d'environnement, cliquez sur Paramètres.
4. Sélectionnez un utilisateur dans la liste Variables utilisateur pour.
5. Cliquez sur le nom ( Path ) de la variable utilisateur ou système que vous souhaitez modifier ou supprimer.
6. Cliquez sur Modifier pour modifier la valeur de la variable avec le nom Path.
7. 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 -> 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 http://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:
1.
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
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 25 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM
Puis mettez le chemin d’installation du répertoire bin dans votre variable d’environnement 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 -> 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 yourSedexId doit correspondre à une valeur de la table Mandant.
INSERT INTO configuration VALUES('messageprocess.location','C:/smclientbase/config/messageprocess.xml',' yourSedexId ', (select id from domain where name like
'smclient'));
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:
<?xml version="1.0" encoding="UTF-8"?>
<!--
Document : rules.xml
Created on : October 04, 2010,
Author : Sylvain Berthouzoz
Description:
Test/Example message-process.xml file to define scripts that the sM-Client can perfom
before the triage.
-->
<processes>
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 26 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM
<!-- only the most specific one is executed -->
<!-- script for every message --> {1}
<script path="./target/test-classes/test.groovy">
<args>default</args>
<args>config</args>
</script>
<!-- script only for one message type/subtype --> {2}
<message type="2003" subType="000101">
<message-validation>false</message-validation>
<script path="./src/test/resources/test-exception.groovy" noPdfGeneration="true" process="receive"> {3}
<args>EXCEPTION</args>
<args>arg2</args>
</script>
<script path="./src/test/resources/test-send.groovy" noPdfGeneration="true" process="send"> {3}
<args>default</args>
<args>config</args>
</script>
<export-pdf-splitting>false</export-pdf-splitting>
</message>
</processes>
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’à 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
type subType
Description
Type de message sedex, par example 2003
(Optionnel) Sous-type de message selon le 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).
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 27 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM
Balise script
La balise script comprent les attributs suivants :
Nom
path noPdfGeneration
Description
Chemin absolu du script à exécuter
(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 le 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-pdfsplitting 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 do it 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)
Cidessous un exemple d‘implémentation class HelloGroovy implements ch.admin.smclient.service.script.GroovyScriptController {
String process(ch.admin.smclient.model.Message msg, File xml,
File pdf, String[] args) {
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.
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é.
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 28 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM
Exemple de configuration:
<?xml version="1.0" encoding="UTF-8"?>
<triage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="rules.xsd">
<rule>
<criteria>
<messageType>2003</messageType>
<messageSubType>000101</messageSubType>
<messageAction>1</messageAction>
</criteria>
<destinationFolder>C:/smclientbase/interface/inbox/applicati on</destinationFolder>
<PDFGeneration boolean="false" pdfSplitting="false"/>
<useCase>receive</useCase>
</rule>
<rule>
<criteria>
<messageType>2015</messageType>
<messageSubType>000101</messageSubType>
</criteria>
<destinationFolder>C:/smclientbase/interface/inbox/applicati on_1</destinationFolder>
<PDFGeneration boolean="true" pdfSplitting="true"/>
<useCase>receive</useCase>
</rule>
<!-- Rules with TestMessage. Applied from top to bottom, so the less specific one should be at the bottom -->
<rule>
<criteria>
<messageAction>2</messageAction>
<testMessage />
</criteria>
<destinationFolder>/inbox/test-multiplemessages-location</destinationFolder>
<useCase>receive</useCase>
</rule>
<rule>
<criteria> location</destinationFolder>
<useCase>receive</useCase>
</rule>
<testMessage />
</criteria>
<destinationFolder>/inbox/test-messages-
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 29 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM
<!-- default rule has no criteria -->
<rule>
<destinationFolder>C:\smclientbase\interface\inbox\post_box<
/destinationFolder>
<PDFGeneration boolean="false" pdfSplitting="false"/>
<useCase>receive</useCase>
</rule>
<rule>
<destinationFolder>C:\smclientbase\interface\sent</destinati onFolder>
<PDFGeneration boolean="false" pdfSplitting="false"/>
<useCase>send</useCase>
</rule>
<!-- default rule for adapter so all messages are picked up
-->
<rule>
<useCase>adapter</useCase>
</rule>
</triage>
E xplication 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 (<criteria>).
La configuration standard à la réception est telle, que le messag e 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 Sent (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
<destinationFolder> - dossier dans lequel le message est mémorisé au cas où une règle s’applique (seulement pour „send“ uet „receive“)
<PDFGeneration> - true/false; un PDF est généré ou non dans ce cas en fonction de la valeur
(seulement pour „send“ et „receive“)
<PDFGeneration> - 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
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 30 / 84
sM-Client Projekt
Installations-Handbuch
Version finale
Installation et configuration du client sM
<useCase> - comme décrit ci-dessus
<criteria> peut avec „send“ et „receive“ vérifier les valeurs suivantes
<messageType>
<messageSubType>
<messageAction>
<testMessage/>
Toutes ces valeurs font référence aux valeurs correspodantes dans le message.
Les combinaisons de valeurs suivantes sont possibles pour <criteria> pas de -> règle par défaut
<messageType>
<messageAction>
<messageType> et <messageAction>
<messageType> et <messageSubType>
<messageType>, <messageSubType> et <messageAction>
<testMessage/> 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“
<messageType>
<recipientId>
Toutes ces valeurs se réfèrent à la valeur correspondante dans le message
Les combinaisons de valeurs suivantes sont possibles pour <criteria>
Aucune -> règle par défaut
<messageType>
<recipientId>
<messageType> und <recipientId>
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 reçus.
Exemple règles adaptateur
Voici quelques exemples d’application des 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-900014-2:
<rule>
<criteria>
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 31 / 84
sM-Client Projekt
Installations-Handbuch
</criteria>
<recipientId>T6-900014-2</recipientId>
<messageType>3001</messageType>
<useCase>adapter</useCase>
</rule>
Version finale
Installation et configuration du client sM
Cette règle permet de saisir tous les messages de type 3002 :
<rule>
<criteria>
<messageType>3002</messageType>
</criteria>
<useCase>adapter</useCase>
</rule>
Cette règle permet de saisir tous les messages envoyés au destinataire T6-900014-1:
<rule>
<criteria>
<recipientId>T6-900014-1</recipientId>
</criteria>
<useCase>adapter</useCase>
</rule>
4.2.3 Règle 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 règle travaille sur le type de message lors de la réception:
type de message 2991 pour BSV
type de message 3991 pour SSK
Prière de modifier le destinationFolder selon votre installation locale et de créer le répertoire correspondant
4.2.3.1 SSK:
Exemple de règle pour les messages de monitoring SSK, rules.xml
Prière de modifier le destinationFolder selon votre installation locale et de créer le répertoire correspondant
…
<!-- Siehe Kapitel 4.2.2.7 für die komplette Konfiguration -->
<rule>
<criteria>
<messageType>3991</messageType>
Erstellt:
4. Januar 2012 von Cambridge Technology Partners © 2011 32 / 84

Link público atualizado
O link público para o seu chat foi atualizado.