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
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. Tous types d appels Date (1) Date et heure de début de l appel Travail Durée de conversation en secondes Sonnerie Durée de sonnerie en secondes Garde Durée de garde en secondes Ligne Equipement PBX par lequel l appel à transité SourceAcq Numéro de la source d acquisition Mode appel Selon PBX (3) NumSite Numéro du site utilisé pour la connexion avec le réseau public NumSiteES Numéro du site de l abonné Libération (2) Selon PBX (4) ES 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
Appels sortants Poste ayant émis l appel Ncomp Numéro appelé Cout Coût en HT Operateur Numéro de l opérateur par lequel l appel a été facturé (1) Destination Nom du tarif par lequel l appel a été facturé Taxes Retour de taxes de l opérateur Privee Différenciation des communications privées et professionnelles. Code affaire Code affaire sans le préfixe (1) La liste des opérateurs est disponible au sein du module CONFIGURATEUR, dans OPERATEURS puis ACTIVATION. Ncomp Pobtenu Pappele Pobtenu Appels entrants Poste sonné Numéro de l appelant Numéro de poste ayant répondu à l appel Numéro SDA appelé par l extérieur Appels internes Poste ayant émis l appel Numéro de poste ayant répondu à l appel COGIS NETWORKS Page 3/6
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). Tous types d appels Numéro de poste auquel est affecté l appel Dur Somme de la durée de conversation Ncom Nombre d appels Date Au format MM/AA, correspond au mois et à l année du cumul, soit 01/05 au janvier 2005. Cout Coût Sonnerie Durée de sonnerie SourceAcqTic Numéro de la source d acquisition ES 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. Repondus 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
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
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