Note Technique - Cogis Networks

Transcription

Note Technique - Cogis Networks
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
1. OBJECTIF
Dans le cas d’un fonctionnement avec un PBX SWYX, la présente note technique a pour
objectif de vous fournir les éléments à paramétrer sur le PBX et sur le logiciel COGIS.
Cette note technique ne comprend pas la partie installation du logiciel COGIS.
2. PREREQUIS
Les éléments de cette note technique ne peuvent être appliqués que si :
, Le PBX est fonctionnel
, Le logiciel COGIS est installé et sa licence activée
Pour procéder aux éléments de cette note technique, assurez,vous que vous êtes en
mesure d’ouvrir une session Windows de type « administrateur local » sur les serveurs où
sont installés le PBX et le logiciel de COGIS.
Au sein de l’administration du PBX, dans les enregistrements des usagers, le champ Nom
ou Name des usagers doit être renseigné dans le sens « NOM espace PRENOM », par
exemple « DUPONT Franck » et non « Frank DUPONT ».
Si le nom est composé, ne mettez pas d’espace entre les parties du nom mais des tirets,
par exemple pour « DUPONT GRANAN Eric », mettez « DUPONT,GRANAN Eric ».
COGIS NETWORKS
Page 1/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
3. ARCHITECTURE & FONCTIONNEMENT
Vous avez la possibilité d’installer le PBX et le logiciel COGIS soit sur le même serveur soit
sur 2 serveurs séparés.
Selon l’architecture retenue, le fonctionnement diffère.
Dans le cas où le logiciel est situé sur le même serveur que le PBX, le fonctionnement de la
collecte des tickets et de l’annuaire est le suivant :
, Le PBX généré les fichiers de tickets dans un répertoire.
, L’utilitaire de COGIS effectue un export de l’annuaire du
PBX et déplace les fichiers de tickets et l’annuaire dans un
répertoire spécifique.
, Le logiciel COGIS importe l’annuaire et collecte les fichiers
de tickets déplacés.
Dans le cas où le logiciel est situé sur un autre serveur que le serveur hébergeant le PBX,
le fonctionnement de la collecte des tickets et de l’annuaire est le suivant :
Sur le serveur où est situé SWYX :
, Le PBX généré les fichiers de tickets
dans un répertoire
, L’utilitaire de COGIS effectue un
export de l’annuaire du PBX
, L’utilitaire de COGIS envoie en FTP les
données (tickets et annuaire) au
serveur où est situé le logiciel
COGIS NETWORKS
Sur le serveur où est situé le logicel :
, Le logiciel collecte les fichiers de tickets et
les intègre
, Le logiciel importe l’annuaire
Page 2/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
4. ORDRE DES ACTIONS A EFFECTUER
Action
Créer le répertoire de stockage des cdr
Créer le répertoire de déplacement des fichiers
Paramétrage du PBX
Installer l’utilitaire de collecte
Paramétrer l’utilitaire de collecte
Créer la tâche Windows d’exécution de l’utilitaire
Installation et paramétrage du serveur FTP
Tests
Paramétrage logiciel COGIS , Import de l’annuaire
Paramétrage logiciel COGIS , Acquisition tickets
Suivant l’architecture suivez dans
l’ordre les paragraphes indiqués
1 serveur
2 serveurs
5
5
6
,
7
7
8
8
9
9
10
10
,
11
12
12
13
13
14
14
5. PARAMETRAGE DU REPERTOIRE DE STOCKAGE DES TICKETS
Sur le serveur où est installé le pbx SWYX, vous devez créer le répertoire où seront stockés
les tickets émis par SWYX.
Pour cela, sous la racine du disque C, créez un répertoire nommé « cdr,swyx ».
Au sein de l’antivirus et de Windows Defender, il est impératif de définir que ce répertoire
doit être exclu des analyses et de la surveillance.
6. PARAMETRAGE DU REPERTOIRE DE DEPLACEMENT DES FICHIERS
Sur le serveur où est installé le pbx SWYX, vous devez créer le répertoire où seront
déplacés les tickets.
Pour cela, sous la racine du disque C, créez un répertoire nommé « cogis,swyx ».
Au sein de l’antivirus et de Windows Defender, il est impératif de définir que ce répertoire
doit être exclu des analyses et de la surveillance.
COGIS NETWORKS
Page 3/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
7. PARAMETRAGE DU PBX
Connectez,vous à la console
d’administration du PBX.
A gauche, sélectionnez le serveur, puis
clic droit et cliquez sur propriétés.
Cliquez sur l’onglet Call Detail Records.
Sélectionnez Call Detail Records into
Text File.
Dans Save To Folder, saisissez le chemin
et le nom du répertoire créé
précédemment pour le stockage des cdr,
si vous avez suivi ce qui est indiqué,
saisissez « c:\cdr,swyx ».
Dans File Name, saisissez « cdr.txt ».
Cochez Limit File Size To et indiquez la
valeur de 100 Kilobytes.
Dans External Numbers, sélectionnez
Store complete Numbers.
Cliquez sur le bouton Appliquer puis sur
le bouton OK.
Depuis un poste effectuez un appel sortant abouti et raccrochez.
Patientez 15 secondes, puis dans le répertoire spécifié pour le stockage des tickets, vous
devez voir un fichier cdr.txt contenant le ticket correspondant à l’appel passé.
COGIS NETWORKS
Page 4/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
8. INSTALLATION DE L’UTILITAIRE DE COLLECTE TICKETS/ANNUAIRE
Sur le serveur où est installé le PBX SWYX, vous devez installer l’utilitaire d’export annuaire
et de gestion des tickets.
Cet utilitaire est disponible :
, Soit sur http://www.cogis.com/telecharger au sein de la section utilitaires
, Soit sur le dvd logithèque de COGIS
Puis vous devez paramétrez les droits d’exécution de l’utilitaire.
Pour cela, rendez,vous dans le chemin d’installation, qui par défaut est :
C:\Program Files (x86)\CogisSwyx
Faîtes un clic droit sur le fichier TransfertCdrSwyx ou sur TransfertCdrSwyx.exe, puis
cliquez sur propriétés.
Une fenêtre apparaît, cliquez sur l’onglet Compatibilité, puis en bas cochez Exécuter ce
programme en tant qu’Administrateur, puis cliquez sur le bouton OK.
Enfin, au sein de l’antivirus et de Windows Defender, il est impératif de définir que le
répertoire où est installé l’utilitaire doit être exclu des analyses et de la surveillance.
9. PARAMETRAGE DE L’UTILITAIRE
Afin de paramétrer l’utilitaire, rendez,vous dans le chemin d’installation, par défaut
C:\Program Files (x86)\CogisSwyx, et ouvrez le fichier config.ini (avec le bloc,notes
par exemple) et paramétrez,le ainsi :
Section SWYX
repertoire,cdr
Indiquez le chemin où sont stockés les cdr, par exemple « c:\cdr,
swyx ». C’est le chemin définit au sein du PBX.
debut,nom
Indiquez le début du nom des fichiers, par exemple « cdr ». C’est le
nom indiqué dans le PBX, ne mettez surtout pas l’extension du fichier.
Section PROTOCOLE
protocole,cible
Si le logiciel et le PBX sont sur le même serveur, indiquez le chiffre
« 1 », sinon indiquez le chiffre « 0 ».
Section PROTOCOLEEREPERTOIRE
Cette section est à renseigner que si dans « protocole,cible »vous avez indiqué « 1 ».
repertoire
Indiquez le chemin complet du répertoire et son nom, qui a été créé
pour le déplacement des fichiers. Par exemple « c:\cogis,swyx »
COGIS NETWORKS
Page 5/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
Section PROTOCOLEEFTP
Cette section est à renseigner que si dans « protocole,cible »vous avez indiqué « 0 ».
serveur,ftp
Indiquez l’adresse IP du serveur où installé le logiciel COGIS.
login,ftp
Indiquez le login du compte FTP créé.
password,ftp
Indiquez le mot de passe du compte FTP.
chemin,ftp
Indiquez « / ».
Section DIVERS
sauvegarde,active
Indiquez le chiffre« 0 »
sauvegarde,nbjours
Indiquez le chiffre« 90 »
debut,nom,cogis
Lorsque l’utilitaire va traiter un fichier, il va le renommer. Devant
le nom original du fichier il va ajouter des caractères. Préciser ici
les caractères à ajouter.
Il est conseillé de mettre « cogisswyx ».
Il est déconseillé de mettre « cdr ».
Section ANNUAIRE
annuaire,sql,actif
Indiquez le chiffre « 1 ».
serveur,sql
Indiquez « localhost » suivi de « \ » suivi du nom de l’instance
SQL,SERVER, par défaut « localhost\SQLEXPRESS ».
mode,sql
Indiquez le chiffre « 0 ».
login,sql
Ne rien saisir.
password,sql
Ne rien saisir.
fichier,annuaire
Indiquez le nom du fichier (sans le chemin) au sein duquel
l’annuaire du PBX sera exporté. Par défaut indiquez
« annuaire.csv ».
champ,nom
Conservez la valeur par défaut.
sens,nomprenom
Mettre le chiffre « 1 ».
nom,niveau1
Indiquez le nom de la société qui sera créé dans l’annuaire du
logiciel COGIS au sein de laquelle les fiches seront importées (20
caractères max).
Enregistrez et quittez le fichier.
COGIS NETWORKS
Page 6/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
10. CREATION DE LA TACHE WINDOWS
Une fois l’utilitaire installé, vous devez automatiser son exécution en créant une tâche
planifiée sous Windows.
Soit vous accédez au gestionnaire d’ordinateur, soit vous pouvez aussi lancer la commande
Taskschd.msc (dans la partie exécuter du menu démarrer).
A gauche, ouvrez la partie planificateur de tâches, cliquez sur bibliothèque du
planificateur de tâches, puis clic droit dessus, puis cliquez sur Créer une tâche
(attention, ne cliquez pas sur créer une tâche de base).
Au sein de l’onglet Général :
, Dans Nom, saisissez cogisEcdr.
, Cochez Exécuter même si l’ordinateur
n’est pas connecté.
, Cochez Exécuter avec les
autorisations maximales.
, Cliquez sur le bouton Utilisateur ou
groupe, une fenêtre apparaît, saisissez
le nom de l’utilisateur (sur un système en
Français saisissez « système », sur un
Windows en Anglais, saisissez
« system ») puis cliquez sur le bouton
OK.
En haut, cliquez sur l’onglet Déclencheur,
puis en bas sur le bouton Nouveau.
Au sein de la nouvelle fenêtre :
, Dans Lancer la tâche, sélectionnez A
l’heure programmée.
, En dessous, à gauche, sélectionnez
Chaque jour, puis à droite dans
Répéter tous les saisissez la valeur 1.
, En dessous, cochez Répéter la tâche
toutes les, et indiquez la valeur de 10
minutes, à droite dans pour une durée,
indiquez la valeur de 1 jour.
, En dessous, assurez,vous que Activée
est bien cochée.
, Cliquez sur le bouton OK.
COGIS NETWORKS
Page 7/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
En haut, cliquez sur l’onglet Action, puis en bas sur
le bouton Nouveau.
Au sein de la nouvelle fenêtre :
, Dans Action, sélectionnez Démarrer un
programme.
, Cliquez sur le bouton parcourir, une fenêtre
apparaît, sélectionnez alors le programme
TransfertCdrSwyx situé dans le répertoire
« c:\program files (x86)
\CogisSwyxTransefrtCdr ».
, Cliquez sur le bouton OK.
En haut, cliquez sur l’onglet
Paramètres :
, Cochez Autoriser l’exécution de
la tâche à la demande.
, Décochez Arrêter la tâche si elle
s’exécute ….
Cliquez sur le bouton OK.
COGIS NETWORKS
Page 8/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
11. INSTALLATION ET PARAMETRAGE DU SERVEUR FTP
Sur le serveur où est installé le logiciel COGIS, vous devez créer le répertoire où seront
stockés les tickets et l’annuaire rapatriés du serveur SWYX.
Pour cela, sous la racine du disque C, créez un répertoire nommé « cogis,swyx ».
Au sein de l’antivirus et de Windows Defender, il est impératif de définir que ce répertoire
doit être exclu des analyses et de la surveillance.
Puis installez et paramétrez le serveur FTP FileZilla Server.
Pour cela, suivez la note technique GT111.
Au sein de cette note technique, il vous sera demandé de créer un compte utilisateur, dans
ce cas vous devrez paramétrer :
, Nom du compte (login) : saisissez alors le même login que celui définit dans le
fichier config.ini de l’utilitaire à la section PROTOCOLE,FTP.
, Mot de passe du compte (password) : saisissez alors le même login que celui définit
dans le fichier config.ini de l’utilitaire à la section PROTOCOLE,FTP.
, Répertoire (shared folder) : le répertoire précédemment créé, soit par défaut
« c:\cogis,swyx ».
12. TEST DE TRANSFERT DES FICHIERS
A cet étape, vous pouvez tester que la chaîne de traitement des fichiers de tickets et de
l’annuaire est bien fonctionnelle.
Depuis un poste effectuez un appel sortant abouti et raccrochez.
Patientez 15 secondes, puis dans le répertoire spécifié pour le stockage des tickets, vous
devez voir un fichier cdr.txt contenant le ticket correspondant à l’appel passé.
Lancez l’utilitaire de COGIS, au bout de 3 minutes maximum les fichiers de tickets présents
dans le répertoire de stockage (c:\cdr,swyx) doivent disparaître.
Puis :
, Si vous avez 1 seul serveur : les fichiers et l’annuaire doivent apparaître dans le
répertoire de déplacement (par défaut « c:\cogis,swyx »).
, Si vous avez 2 serveurs : les fichiers et l’annuaire ont été envoyés en FTP et doivent
être disponible sur le serveur où est situé le logiciel de COGIS dans le répertoire créé
(par défaut « c:\cogis,swyx »).
Si vous rencontrez des problèmes, vous pouvez accéder au journal de l’utilitaire sur le
serveur SWYX, dans le répertoire d’installation, c’est le fichier journal.log.
COGIS NETWORKS
Page 9/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
13. PARAMETRAGE DE L’IMPORT ANNUAIRE DANS LE LOGICIEL COGIS
Seuls les principaux paramètres sont décrits, pour les autres paramètres reportez,vous au
manuel de configuration.
Le paramétrage s’effectue dans l’interface de configuration de Visual Taxe, au sein de
« collecte de données » puis « interactivité annuaire ».
En haut à côté de la flèche orange, sélectionnez la source d’acquisition pour laquelle vous
effectuer le paramétrage de l’import annuaire.
Cliquez sur le bouton
.
Vous obtenez l’écran ci,contre.
En haut à gauche, sélectionnez annuaire interne.
Puis paramétrez ainsi :
, Décochez nom des champs sur la 1ère ligne.
, Mettez à 0 le Nbre de ligne à exclure.
, Indiquez « ; » dans séparateur de champs.
, Indiquez « " » dans délimiteur de texte.
, Indiquez « ISO,8859,1 » dans Encodage.
En dessous, dans « sélection », supprimer toutes les lignes.
COGIS NETWORKS
Page 10/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
Puis, ajoutez de la zone « champs de la base » vers la zone « sélection » les lignes
suivantes dans l’ordre indiqué :
, Niveau1
, Nom
, Prénom
, Niveau2
, E,mail
, Poste
, GSM1
Puis cliquez sur le bouton
.
Une nouvelle fenêtre apparaît, dans la zone de texte saisissez « annuaire interne swyx »
puis cliquez sur le bouton
.
Fermez les 2 fenêtres de paramétrage du format d’import.
De retour sur la fenêtre principale :
, Cliquez sur « suppr abo non présent » et cochez,le.
, Dans « annuaire interne », sélectionnez « annuaire interne swyx ».
, Dans « annuaire externe », sélectionnez « aucun ».
, Dans « annuaire frais », sélectionnez « aucun ».
, Dans « Seuil », indiquez 0.
, « Purge annuaire » doit être à « false » (décoché)
, Dans « regroupement niveau1 », sélectionnez « aucun ».
Puis cliquez sur le bouton
.
Puis cliquez sur le bouton de protocole, une fenêtre apparaît.
Dans « annuaire interne », saisissez le chemin et le nom du fichier au sein duquel
l’annuaire exporté de Swyx sera présent :
, Le chemin est le même que pour les tickets.
, Le nom du fichier est celui définit dans le fichier config.ini de l’utilitaire dans
« fichier,annuaire » de la section « annuaire »
(par défaut « c:\cogis,swyx \annuaire.csv»).
Puis cliquez sur le bouton
COGIS NETWORKS
.
Page 11/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
14. PARAMETRAGE DE LA COLLECTE DES TICKETS DANS LE LOGICIEL COGIS
Seuls les principaux paramètres sont décrits, pour les autres paramètres reportez,vous au
manuel de configuration.
Le paramétrage s’effectue dans l’interface de configuration de Visual Taxe, au sein de
« collecte de données » puis « source d’acquisition ».
Si besoin, vous pouvez créer une nouvelle source d’acquisition en cliquant sur le bouton
Ajouter.
Dans format de ticket, sélectionnez le format « SWYX » correspondant à votre PBX.
A droite dans préfixe PBX, sélectionnez « 1 ».
Puis cliquez sur le bouton
.
Après avoir cliqué sur le bouton de
protocole, la fenêtre ci,contre apparaît.
Cliquez sur l’onglet LAN(Répertoire).
COGIS NETWORKS
Page 12/13
Note Technique
N° :
Sujet :
GT160
Mise à jour : 11/12/2013
Paramétrage pour les PBX SWYX
Champ d’application :
Visual Taxe 4.3.0B04 et supérieurs, Windows uniquement
Paramétrez ainsi :
• Pour DEBUT FICHIER, saisissez la chaîne de caractère indiquée dans le fichier
config.ini de l’utilitaire dans « debut,nom,cogis » de la section « divers ».
• Ne pas cocher EXP REG
• Dans CHEMIN FICHIER, :
o Si vous avez 1 seul serveur : saisissez le chemin où les fichiers sont déplacés,
c’est le chemin défini dans le fichier config.ini de l’utilitaire dans « repertoire »
de la section « protocole,repertoire » (par défaut « c:\cogis,swyx »).
o Si vous avez 2 serveurs : saisissez le chemin complet du répertoire où le
serveur ftp va stocker les fichiers sur le serveur où est le logiciel COGIS (par
défaut « c:\cogis,swyx »).
•
Ne pas renseigner de valeur pour DERNIER FICHIER TRAITE
Puis cliquez sur le bouton
COGIS NETWORKS
.
Page 13/13