Gestion des Télécommunications Note Technique N° : Sujet : GT002 Mise à jour : 19/09/2007 Interroger les bases de données du logiciel par des requêtes SQL Objectif Il peut être nécessaire d’accéder aux données du logiciel par des requêtes SQL. Cette note technique explique le mode de fonctionnement. Quel est le format des bases de données ? Les données du logiciel sont stockées au sein de bases de données Microsoft SQL-SERVER. Que contiennent les bases ? 3 bases de données sont utilisées : • La base VTPAR contient : o le paramétrage du logiciel (sources d’acquisition, interactivité annuaire, comptes utilisateurs, tables de tarification des opérateurs, etc …), o les journaux de bord, o les tickets bruts. • La base VTPRO contient : o l’annuaire, o les communications, o la programmation des tableaux de bord. • La base VTCHA contient les données de la gestion des chambres Au sein de cette note technique il ne sera traité que de la manipulation des données de la base VTPRO. Comment se connecter au serveur SQL ? Par défaut, la connexion s’effectue par une authentification SQL. Un login et un mot de passe sont nécessaires, pour les connaître, contactez le Support Technique de COGIS. COGIS NETWORKS Page 1/6 Gestion des Télécommunications Note Technique N° : Sujet : GT002 Mise à jour : 19/09/2007 Interroger les bases de données du logiciel par des requêtes SQL Dictionnaire des données La description des champs et leur type est disponible au sein des spécifications techniques du logiciel. Comment manipuler les communications détaillées ? Les communications téléphoniques sont stockées au sein de la table « ticket ». Selon le modèle et la version du ou des PBX qui fournissent les tickets, le contenu des champs peuvent changer. Aussi, seuls les principaux champs seront ici fournis, pour les PBX MATRA 65xx & NEXSPAN. Nom du champ Date (1) Travail Sonnerie Garde Ligne SourceAcq Mode appel NumSite NumSiteES Libération (2) ES Tous types d’appels Signification Date et heure de début de l’appel Durée de conversation en secondes Durée de sonnerie en secondes Durée de garde en secondes Equipement PBX par lequel l’appel à transité Numéro de la source d’acquisition Selon PBX (3) Numéro du site utilisé pour la connexion avec le réseau public Numéro du site de l’abonné Selon PBX (4) Ce champ permet de distinguer les communications selon leur type, à savoir : • la valeur 0 indique que la communication est un appel sortant, • la valeur 1 indique que la communication est un appel entrant, • la valeur 2 indique que la communication est un appel interne. (1) pour PBX MATRA 65xx et NEXSPAN, si ticket V1 ou inférieur, prenez en compte que l’indication des secondes dans l’heure de début n’est pas fiable (cela ne concerne pas les autres champs de durée) (2) pour PBX MATRA 65xx et NEXSPAN, seulement si tickets V2 ou supérieur (3) pour PBX MATRA 65xx et NEXSPAN, mode selon lequel l’appel a été signalisé, à savoir D : direct ou intercepté R : renvoyé A : transféré par un poste O : transféré par un PO S : appel renvoyé vers l’extérieur (4) pour PBX MATRA 65xx et NEXSPAN, mode selon lequel l’appel s’est terminé, à savoir : CO : congestion, EC : échec manque de ressource, EF : événement faute, HS : hors service LF : libération forcée : en cas de blocage ou de mise HS, NA : numéro non attribué NU : numéro non utilisé, OC : occupation, RD : raccroché distant, RE : restriction RL : raccroché local, SA : saturation, TR : transfert, TP : fin de temporisation COGIS NETWORKS Page 2/6 Gestion des Télécommunications Note Technique N° : Sujet : GT002 Mise à jour : 19/09/2007 Interroger les bases de données du logiciel par des requêtes SQL Nom du champ PosteTic Ncomp Cout Operateur Destination Taxes Privee Code affaire Appels sortants Signification Poste ayant émis l’appel Numéro appelé Coût en €HT Numéro de l’opérateur par lequel l’appel a été facturé (1) Nom du tarif par lequel l’appel a été facturé Retour de taxes de l’opérateur Différenciation des communications privées et professionnelles. Code affaire sans le préfixe (1) La liste des opérateurs est disponible au sein du module CONFIGURATEUR, dans OPERATEURS puis ACTIVATION. Appels entrants Signification Nom du champ PosteTic Ncomp Pobtenu Pappele Poste sonné Numéro de l’appelant Numéro de poste ayant répondu à l’appel Numéro SDA appelé par l’extérieur Nom du champ PosteTic Pobtenu Appels internes Signification Poste ayant émis l’appel Numéro de poste ayant répondu à l’appel COGIS NETWORKS Page 3/6 Gestion des Télécommunications Note Technique N° : Sujet : GT002 Mise à jour : 19/09/2007 Interroger les bases de données du logiciel par des requêtes SQL Comment manipuler les cumuls mensuels des communications ? Les cumuls mensuels des communications téléphoniques sont stockées au sein de la table « GlobalTic ». Les cumuls sont créés/mis à jour à chaque nouvelle communication détaillée arrivée. Les cumuls sont conservés sur 12 mois glissants (le mois en cours et les 12 derniers mois). Nom du champ PosteTic Dur Ncom Date Cout Sonnerie SourceAcqTic ES Repondus Tous types d’appels Signification Numéro de poste auquel est affecté l’appel Somme de la durée de conversation Nombre d’appels Au format MM/AA, correspond au mois et à l’année du cumul, soit 01/05 au janvier 2005. Coût Durée de sonnerie Numéro de la source d’acquisition Ce champ permet de distinguer les communications selon leur type, à savoir : • la valeur 0 indique que la communication est un appel sortant, • la valeur 1 indique que la communication est un appel entrant, • la valeur 2 indique que la communication est un appel interne. Nombre d’appels avec une durée de conversation non nulle Comment manipuler l’annuaire ? Convention d’écriture : Les noms des tables sont mis entre crochet. Donc [Abonnés]Nom décrit le champs Nom de la table Abonnés. Les communications sont liés à l’annuaire par la relation entre le champs IDCle des communications et IDCle de l’annuaire, à savoir : [Ticket]IDCle = [Abonnés]IDCle. Lors de requêtes sur la table Abonnés, vous devrez systématiquement indiquer les filtres suivants : • [Abonnés]Apurger <> 1 Ceci vous permet de ne pas prendre en compte les fiches abonnés ayant été supprimées mais encore au sein de la base de données. • [Abonnés]SourceAcq = X Si votre installation possède plusieurs sources d’acquisition (fils de l’eau), un même numéro de poste peut être présent sur différentes sources d’acquisition. Avec ce filtre, en remplaçant le X par le numéro de la source d’acquisition vous obtiendrez le poste désiré. Pour connaître les numéros de sources d’acquisition et leur correspondance, vous pouvez vous rendre au sein de l’interface du module CONFIGURATEUR et aller dans COLLECTEUR. Les sources d’acquisitions sont présentes dans SOURCE PRINCIPALE et SOURCES DISTANTES. COGIS NETWORKS Page 4/6 Gestion des Télécommunications Note Technique N° : Sujet : GT002 Mise à jour : 19/09/2007 Interroger les bases de données du logiciel par des requêtes SQL Rechercher une fiche au sein de la table Abonnés à partir du numéro de poste : [Abonnés]Poste = poste à rechercher Rechercher le GENRE correspondant à une fiche de la table Abonnés : [Abonnés]SourceAcq = [Genre]SourceAcq AND [Abonnés]IDGenre = [Genre]IDCle Rechercher le FONCTION correspondant à une fiche de la table Abonnés : [Abonnés]SourceAcq = [Fonction]SourceAcq AND [Abonnés]IDFonction = [Fonction]IDCle Rechercher le SITE correspondant à une fiche de la table Abonnés : [Abonnés]SourceAcq = [Site]SourceAcq AND [Abonnés]IDSite [Site]IDCle Rechercher le CENTRE DE FRAIS correspondant à une fiche de la table Abonnés : [Abonnés]SourceAcq = [Frais]SourceAcq AND Abonnés]IDFrais = [Frais]IDCle AND [Abonnés]IDNiv1= [Frais]IDNiv1 Rechercher le NIVEAU1 correspondant à une fiche de la table Abonnés : Abonnés]SourceAcq = [Niveau1]SourceAcq AND [Abonnés]IDNiv1= [Niveau1]IDNiv1 Rechercher le NIVEAU2 correspondant à une fiche de la table Abonnés : [Abonnés]SourceAcq = [Niveau2]SourceAcq AND [Abonnés]IDNiv1= [Niveau2]IDNiv1 AND [Abonnés]IDNiv2= [Niveau2]IDNiv2 Rechercher le NIVEAU3 correspondant à une fiche de la table Abonnés : [Abonnés]SourceACq = [Niveau3]SourceAcq AND Abonnés]IDNiv1= [Niveau3]IDNiv1 AND [Abonnés]IDNiv2= [Niveau3]IDNiv2 AND [Abonnés]IDNiv3 = [Niveau3]IDNiv3 Rechercher le NIVEAU4 correspondant à une fiche de la table Abonnés : [Abonnés]SourceACq = [Niveau4]SourceAcq AND [Abonnés]IDNiv1 = [Niveau4]IDNiv1 AND [Abonnés]IDNiv2= [Niveau4]IDNiv2 AND [Abonnés]IDNiv3 = [Niveau4]IDNiv3 AND [Abonnés]IDNiv4= [Niveau4]IDNiv4 COGIS NETWORKS Page 5/6 Gestion des Télécommunications Note Technique N° : Sujet : GT002 Mise à jour : 19/09/2007 Interroger les bases de données du logiciel par des requêtes SQL Rechercher le NIVEAU5 correspondant à une fiche de la table Abonnés : [Abonnés]SourceACq = [Niveau5]SourceAcq AND [Abonnés]IDNiv1 = [Niveau5]IDNiv1 AND [Abonnés]IDNiv2= [Niveau5]IDNiv2 AND [Abonnés]IDNiv3 = [Niveau5]IDNiv3 AND [Abonnés]IDNiv4= [Niveau5]IDNiv4 AND [Abonnés]IDNiv5= [Niveau5]IDNiv5 Rechercher le NIVEAU6 correspondant à une fiche de la table Abonnés : [Abonnés]SourceACq = [Niveau6]SourceAcq AND [Abonnés]IDNiv1 = [Niveau6]IDNiv1 AND [Abonnés]IDNiv2 = [Niveau6]IDNiv2 AND [Abonnés]IDNiv3 = [Niveau6]IDNiv3 AND [Abonnés]IDNiv4= [Niveau6]IDNiv4 AND [Abonnés]IDNiv5= [Niveau6]IDNiv5 AND [Abonnés]IDNiv6= [Niveau6]IDNiv6 COGIS NETWORKS Page 6/6