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