Gestion des Télécommunications Objectif Quel est

publicité
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
Téléchargement