Atos, Atos et le poisson, Atos Origin et le poisson, Atos Consulting ainsi que le poisson seul sont des marques déposées d'Atos Origin SA. © 2006 Atos Origin. Usage Interne exclusivement. MD SM-10 rév. B1 Formation GINGER4

2 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Historique des révisions RévisionDateModificationOrigineAuteur 1.005/05/2009CréationSCL NomFonctionDate AuteurSophie CHERITELResponsable Fonctionnelle05/05/2009 Vérificateur(s) Approbateur(s)

3 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Ordre du jour Changements Ginger 3 / Ginger 4 Actions / Configuration sur l’IHM MMG Présentation des changements sur l’IHM GDM Contrôles de cohérence entre les configurations GDM et MMG Paramétrage Supervision Ginger Documentations utiles Présentation des changements sur la gestion des messages

4 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Changements Ginger 3 / Ginger 4 Ginger 3Ginger 4 1 IHM de paramétrage (hors connecteurs)2 IHM de paramétrage (hors connecteurs) : - 1 IHM GDM (« l’existante » Ginger 3) communiquant avec la MMG en temps réel (Account API) - 1 IHM MMG 1 serveur (GDM + MMG) 1 serveur de base de données (GDM + MMG) 1 serveur GDM 1 serveur MMG 1 serveur de base de données (GDM + MMG) Mapping d’objets : 1 Template = 1 Compte MMG V3 1 SI = 1 Compte Admin MMG V3 1 Service SI = pas de correspondance MMG V3 Mapping d’objets : 1 Template = pas de correspondance MMG V4 1 SI = 1 Compte Utilisateur MMG V4 1 Service SI = 1 Application MMG V4 Mode de récupération des messages MO et ACK : La MMG V3 envoyait ces messages Mode de récupération des messages MO et ACK : Le GDM va chercher ces messages (via une API)

5 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Rappel architecture interne Ginger

6 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Ordre du jour Changements Ginger 3 / Ginger 4 Cinématique Ecrans Mapping modèle GDM / modèle MMG Actions / Configuration sur l’IHM MMG Présentation des changements sur l’IHM GDM 8 8 Contrôles de cohérence entre les configurations GDM et MMG Paramétrage Supervision Ginger Documentations utiles Présentation des changements sur la gestion des messages

7 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur l’IHM GDM »Module SI : »Plus de définition des médias sur le SI »Association d’un Compte Utilisateur MMG à un SI »Cohérence GDM/MMG (cf chapitre 4) »Module SSI : »Plus de lien vers l’application de routage Messages Entrants sur le SSI »Association d’une Application MMG à un SSI »Données provenant de l’Application MMG : Média, Messages Entrants, Acquittements, plage horaire, adresse d’origine, priorités »Annulation de messages en 2 temps : GDM puis MMG »Cohérence GDM/MMG (cf chapitre 4) »Module Paramètres : »Plus de définition des plages horaires »Lot2.1, Lot1

8 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur l’IHM GDM »Module Templates : »Plus de définition des plages horaires et des débits sur le Template »Test de template : lien vers l’IHM MMG de détail du message »Ajout de l’export multiple de templates »Le nom du template exporté sera de la forme : Exp_ _.tpl. »Ajout de l’export de template fictif »Enrichissement de l’export avec les données suivantes : -Nom du template -Média du template -Description -Sujet pour le média -Priorité d'affichage de l' -indicateur "paramètre utilisé ou pas dans le template". -dépendance d'une partie fixe par rapport à un paramètre / objet composé. Ces nouvelles données du template sont optionnelles à l'import du template. Les fichiers.tpl au format GINGER3 pourront donc toujours être injectés sans modification du fichier nécessaire sur GINGER4 Les fichiers.tpl exportés de GINGER4 fourniront l'ensemble de ces infos. »Lot2.1, Lot1

9 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur l’IHM GDM »Exemple de nouveau format de fichier TPL Bonjour du du !! à la date du votre solde est de €. Dépendance info Si vous voulez augmenter votre crédit, appelez notre service client SFR. D&& &&C AEM_ _NOTIFICATION Template de la notification de l’AEM Votre nouveau solde 2 C&&

10 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur l’IHM GDM »Exemple de format de fichier TPL fictif &&C AEM_ _NOTIFICATION_FICTIF Template de la notification de l’AEM Votre nouveau solde 2 &&C

11 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur l’IHM GDM »Module Message : »Suivi de messages uniquement par Template »Détail du message : lien vers l’IHM MMG de détail du message »Plus de modules MMG : Maintenance, Routage, Connexion, Statistiques MMG »Plus de module Import / Export »Module Statistiques Ginger : »Plus de statistiques par SI »Plus d’écrans de synthèse des statistiques par Template et par Service SI. »Intervalle de stats disponibles : stats J-1 jusqu’à maximum J-1-1 an »Revue des compteurs affichés : plus de compteurs d’ACKU non demandés, du détail par cause d’erreur pour les compteurs d’ACKN, ajout du nombre de MO reçus »Total des compteurs par ligne »Lot2.2, Lot1

12 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur l’IHM GDM »Nouvelles IHM de stats par Template

13 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur l’IHM GDM »Nouvelle IHM de stats par Template (détail par cause d’erreur)

14 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur l’IHM GDM »Nouvelle IHM de stats par Service SI »NB : IHM de détail par cause d’erreur très similaire à l’écran du détail par causes d’erreur d’un template. Il contient en plus le compteur « Nombre total de messages émis par les clients vers Ginger » en dernière ligne. Libellé « Valider détail par Template » : sur clic sur ce lien, tous les compteurs par template demandés par la sélection des « boutons détail » sont affichés. Une ligne par template du média sélectionné pour les stats SSI si le « bouton détail » du compteur est coché.

15 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Ordre du jour Changements Ginger 3 / Ginger 4 Cinématique Ecrans Mapping modèle GDM / modèle MMG Actions / Configuration sur l’IHM MMG Présentation des changements sur l’IHM GDM Contrôles de cohérence entre les configurations GDM et MMG Paramétrage Supervision Ginger Documentations utiles Présentation des changements sur la gestion des messages

16 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Actions / Configuration sur l’IHM MMG »Configuration des plages horaires d’envoi de messages sortants »Définition d’un compte utilisateur (ie SI) »Configuration d’une application (ie SSI) »Configuration des règles de routage des messages entrants et sortants »Configuration des instances de connecteur »Annulation de messages parvenus à la MMG »Suivi de messages par identifiant de message, par application (ie SSI) »Recyclage des messages »Purge des messages »Basculement de messages d’un connecteur à l’autre (cf chapitre 6) »Monitoring temps réel de la MMG (cf chapitre 6)

17 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Ordre du jour Changements Ginger 3 / Ginger 4 Présentation des écrans Cinématique Ecrans Mapping modèle GDM / modèle MMG Administration, Reporting, Purge Contrôles de cohérence entre les configurations GDM et MMG Actions / Configuration sur l’IHM MMG Présentation des changements sur l’IHM GDM Paramétrage Supervision Ginger Documentations utiles Présentation des changements sur la gestion des messages

18 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Contrôles de cohérence entre les configurations GDM et MMG »Sur la liste des SI, sur action de l’utilisateur (lien « contrôle de cohérence GDM/MMG) : contrôle de présence de tous les Comptes Utilisateur associés à des SI existants »Sur la liste des Services SI d’un SI, sur action de l’utilisateur (lien « contrôle de cohérence GDM/MMG) : »contrôle de présence de toutes les Applications associées à des SSI existants ; »contrôle de présence de nouvelles Applications sur le Compte Utilisateur du SI non associées à un SSI ; »contrôle de présence de libellés d’Applications du Compte Utilisateur du SI identiques »Sur la liste des Services SI, sur action de l’utilisateur (lien « contrôle de cohérence GDM/MMG) : »contrôle de présence de toutes les Applications associées à des SSI existants ; »contrôle de présence de libellés d’Applications identiques

19 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Contrôles de cohérence entre les configurations GDM et MMG »Contrôle automatique à la consultation d’un Service SI avec messages pop-up d’erreurs affichés tant que la configuration du SSI ou de l’Application MMG n’a pas été modifiée : »contrôle de présence de tous les médias sélectionnés sur le Service SI sur l’Application MMG associée »contrôle de présence du routage MO sur tous les médias sélectionnés sur le Service SI sur l’Application MMG associée »contrôle de la configuration de la remontée des acquittements réseau et utilisateur sur tous les médias sélectionnés sur le Service SI sur l’Application MMG associée »Contrôle de présence du routage MT par défaut pour chacun des médias sélectionnés sur le Service SI sur l’Application MMG associée »Contrôle automatique à la consultation d’un Service SI avec un message pop- up d’information visible sur action de l’utilisateur (lien « contrôle de cohérence GDM/MMG) : »Info si nouveau média disponible en MT ou/et en MO »Info si nouvelle plage horaire, nouvelle OA, nouvelle priorité disponible pour les médias sélectionnés sur le Service SI sur l’Application MMG associée »Info si routage MO nouvellement disponible »Info si remontée des acquittements réseau et utilisateur nouvellement disponible

20 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Ordre du jour Changements Ginger 3 / Ginger 4 Contrôles de cohérence entre les configurations GDM et MMG Actions / Configuration sur l’IHM MMG Présentation des changements sur l’IHM GDM Paramétrage Supervision Ginger Documentations utiles Présentation des changements sur la gestion des messages

21 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Paramétrage FWK-MONITORING-ADMIN-GUIDE.pdf »TP n°1 : création d’un nouveau SI et d’un nouveau Service SI »TP n°2 : modification du Service SI créé : »ajout d’un nouveau média »suppression d’un média »ajout d’une règle de routage MT »modification d’une règle de routage MT »ajout de la réception de MO »TP n°3 : configuration et utilisation d’une nouvelle instance de connecteur »TP n°4 : suppression d’un Service SI et d’un SI.

22 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Ordre du jour Supervision Ginger Documentations utiles 8 8 Changements Ginger 3 / Ginger 4 Présentation des changements sur la gestion des messages Contrôles de cohérence entre les configurations GDM et MMG Actions / Configuration sur l’IHM MMG Présentation des changements sur l’IHM GDM Paramétrage

23 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur la gestion des messages »Traitement des messages sortants (MT) »Refus des messages à l’entrée de la MMG si aucun routage trouvé pour le MT -Le GDM trace ce refus en générant un ACKG KO spécifique : 1090 et en inscrivant ce refus dans le fichier de log du moteur pour qu’il soit entre autres comptabilisé dans l’indicateur WAZUP « ACKG_BATR_ENR_GLOBAL_1060 » (Nombre de messages refusés par la MMG) »Plage horaire d’envoi du message : -par défaut, c’est celle configurée pour le média sur le Service SI associé au template d’envoi du message. -si la date/heure d’envoi est surchargée par le SSA et qu’elle appartient à la plage horaire par défaut du média du Service SI alors le message est transmis à la MMG avec cette date/heure d’envoi qui le traitera à partir de cette date/heure. -si la date/heure d’envoi est surchargée par le SSA et n’appartient pas à la plage horaire par défaut du média du Service SI alors le message est transmis à la MMG sans cette date/heure mais avec la date/heure de prise en compte du message par Ginger. La MMG le traitera à l’ouverture de la plage horaire du média du Service SI associé au template d’envoi du message. »DSI MT inchangé

24 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur la gestion des messages »Traitement des messages sortants (MT) »Annulation de messages : -en 2 actions de l’utilisateur (1 sur l’IHM GDM, 1 sur l’IHM MMG), plus d’envoi d’ordre d’annulation de messages par le GDM à la MMG. -historisation des messages annulés côté GDM : pour le reporting Bambi, pour le suivi de messages par template côté GDM -suppression du statut d'annulation ACKG 1070 (Demande d'annulation du message effectuée) : il existe toujours les statuts d'ACKG 1003 (cas d'annulation d'un message correct) et 1080 (cas d'annulation d'un message invalide) »Contrôle de débit des messages sur le GDM : -inchangé. Contrôle de débits de messages Batch en sortie de GDM en fonction du paramétrage du débit autorisé sur le média du Service SI sur l’IHM GDM »Contrôle de débit des messages sur la MMG : -contrôle de débit sur les files d’attente (sur les règles de routage MT) en X msg/seconde -contrôle de débit en émission sur les instances de connecteur vers les plates-formes de service en X msg/seconde »Basculement de messages d’une instance de connecteur à une autre : -Automatique en utilisant les Connector Mapping de backup -Manuel en configurant d’autres Connector Mapping sur une file d’attente (sur une règle de routage MT)

25 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur la gestion des messages »Traitement des acquittements (ACKN et ACKU) »Mode de réception des messages changé : GDM va chercher les messages ACK dans la MMG (via une API). »Expiration des messages ACK : possibilité de récupérer les messages ACK par le GDM tant qu’ils ne sont pas expirés. La durée de vie d’un message ACK est positionnée par la MMG et paramétrable dans un fichier de configuration : /scc/domains/messagingserver/conf – paramètre « queues.storeDefaultTTL » (en MS) »DSI ACK changé uniquement sur le contenu du champ « MsgApplicationRef » transmis aux SSAs : : -ajout du nom du template à la fin du champ -utilisation d’un identifiant de file MQ ayant transmis le message MT correspondant à l’ACK plutôt que le nom de la file décrit dans le DSI. »Transcodage des statuts reçus de la MMG V4 pour être iso-statuts Ginger 3 : -Remonter du statut unifié MMG V3 s’il existe (en fonction du couple média/statut protocolaire ou du triplet média/statut protocolaire/statut unifié MMG V4 ou du couple média/statut unifié MMG V4) -Sinon remonter du statut unifié MMG V4 A noter : cas où le statut protocolaire ou le statut unifié MMG V4 ne sont pas référencés dans la table de transcodage, remonter d’un statut particulier(dit « poubelle ») et écriture en mode « APPLI » de ces statuts dans les fichiers de log.

26 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur la gestion des messages »Traitement des messages entrants (MO) »Mode de réception des messages changé : GDM va chercher les messages MO dans la MMG (via une API). »Expiration des messages MO : possibilité de récupérer les messages MO par le GDM tant qu’ils ne sont pas expirés. La durée de vie d’un message MO est positionnée par la MMG et paramétrable dans un fichier de configuration : /scc/domains/messagingserver/conf – paramètre « queues.storeDefaultTTL » (en MS) »DSI MO inchangé »Contrôle de débit des messages sur la MMG : -Contrôle de débit en réception sur les instances de connecteur (impact sur les réceptions d’ACKN et ACKU)

27 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Présentation des changements sur la gestion des messages FWK-MONITORING-ADMIN-GUIDE.pdf »TP n°1 : envoi d’un message MT OK, envoi d’un message MT refusé par la MMG »TP n°2 : réception d’un messages MO OK, réception d’un message MO KO (recyclage)

28 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Ordre du jour Supervision Ginger Documentations utiles Changements Ginger 3 / Ginger 4 Présentation des changements sur la gestion des messages Contrôles de cohérence entre les configurations GDM et MMG Actions / Configuration sur l’IHM MMG Présentation des changements sur l’IHM GDM Paramétrage

29 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Supervision Ginger »Supervision Wazup : »indicateurs inchangés, »changement sur les données exploitées par les indicateurs MT_SMS, MT_ , MT_MMS, MT_IVR : nom du template. »noms des fichiers de monitoring exploités changés »Supervision Ginger : »Ajout de la supervision de l’IHM GDM, du frontal ACK/MO, des IHMs MMG (MMG et connecteurs), »Modification des scripts de supervision des débits SMS, , MMS : noms des fichiers de monitoring exploités changés »URL supervisées changées »Indicateurs SAS: »Modification des indicateurs SAS exploitant les fichiers de monitoring pour les adapter au nouveau format de ces fichiers et à leur nouveau nom

30 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Supervision Ginger »Monitoring temps réel de la MMG »IHM de monitoring dédiée sur la MMG : -nombre de messages MO, MT OK (ie ACKN OK définitif), MT KO (ie ACKN KO définitif) global par seconde, -nombre de messages MO, MT OK (ie ACKN OK définitif), MT KO (ie ACKN KO définitif), d’ACKN, d’ACKU par application et/ou par Connector Mapping sur une période de temps donnée. -Status : -« OK » pour les MT : si MT OK >= MT reçus par la MMG et si MT KO =0 ; pour les MO/ACKN/ACKU : si MO/ACKN/ACKU récupérés par GDM >= MO/ACKN/ACKU reçus par la MMG -« Warning » sinon -A noter : ces compteurs sont supprimés à l’arrêt de la MMG »IHM des connecteurs ou sur l’IHM d’administration MMG : -Statut des instances de connecteur : started, stopped, stop pending, start pending. »IHM des consoles de monitoring des connecteurs : -Cumul du nombre de messages sur une application : compteur « TrafficOnPeriodMonitoring. ApplicationMapping » cf diapo suivante -Cumul du nombre de messages sur un Connector Mapping : compteur « TrafficMonitoring.Mapping » cf diapo suivante -Etat connecté/déconnecté des connecteurs : compteur « ConnectorMonitoring » cf diapo suivante -A noter : pour conserver l’état de ces compteurs même après un arrêt/relance de la MMG, il faut configurer les fichiers de conf (un pour chaque connecteur + un pour la MMG) : « scc\monitoring\supervisor\CSVRecorder.properties »

31 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Supervision Ginger Nombre de messages sur une application MMG depuis le démarrage de la MMG Nombre de messages sur un Connector Mapping depuis le démarrage de la MMG

32 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Supervision Ginger Etat connecté/déconnecté des connecteurs : si ConnectionCurrentCount > 0 alors l’instance de connecteur est « connectée »

33 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Ordre du jour Supervision Ginger Documentations utiles Changements Ginger 3 / Ginger 4 Présentation des changements sur la gestion des messages Contrôles de cohérence entre les configurations GDM et MMG Actions / Configuration sur l’IHM MMG Présentation des changements sur l’IHM GDM Paramétrage

34 MD SM-10 rév. B 1 GINGER-PRE-0164-v1.01-FormationGinger4 Documentations utiles »Spécifications Ginger : SPE021, SPE020, MUT001, SPE0062, SPE027, SPE008, SPE019, SPE023, SPE024, SPE038, SPE041, SPE042, tdb SAS »Spécifications MMG : MMGV4.4-Administration_Guide, MMGV4.4- User_Guide, IVRClient_UG, IVR_Protocol_Implementation, CONNECTORSV5-Administration_Guide, SMTPClient_UG, SMTP_Protocol_Implementation, MM7Client_UG, UCPClient_UG