TWP Toolkit Formation 21/10/2009
Votre formateur Gautier SOUESME Ingénieur développement Missions de l’équipe : Développement Installation Support Formation
But de la formation Se familiariser avec l’environnement TWP Comprendre l’architecture TWP Apprendre à intégrer TWP à une application existante
Sommaire Architecture Connexions annuaires TWP Alerter Services web Réception d’événements
Présentation (1/3 : Composants TWP)
Présentation (2/3 : Architecture fonctionnelle)
Présentation (3/3 : Toolkit) TWP Toolkit s’appuie sur TWP Server Fonctionnalités téléphoniques via les Services Web Authentification Windows Réception d’alertes XML via une socket TCP
Connecteurs annuaires (1/3) Connexion aux bases de contacts existantes Synchronisation des données Manuel ou automatique Construction annuaire inversé (normalisation des numéros)
Connecteurs annuaires (2/3) Annuaire préconfigurés : Annuaires PBX, Exchange public et privé, Active Directory, Lotus, TWS Chaine de connexion SQL et ODBC : www.connectionstrings.com Possibilité de mapper des champs privés Ex : n° client ou identifiant d’un contact Permet la remontée de fiche d’une application métier
Connecteurs annuaires (3/3) Exemple de connexion LDAP
Alerter – Fenêtres disponibles (1/2) TWSAlerterBase.swf Fenêtre personnalisable avec boutons d’appel et d’actions TWSAlerterMulti.swf Plusieurs onglets de TWSAlerterBase.swf TWSAlerterHTML.swf Fenêtre contenant une page HTML avec boutons de navigation et d’appel
Alerter – Fenêtres disponibles (2/2) Configuration : Uniquement par l’administrateur Affectée à un utilisateur, un groupe ou un domaine TWP Admin > Applications > Paramètres applicatifs > TWP Alerter > SWFAlerter
Alerter - TWSAlerterBase.swf (1/3) Titre & boutons d’appel Espace personnalisable Boutons d’actions
Alerter - TWSAlerterBase.swf (2/3) Espace personnalisable Fichier XML dans le répertoire : C:\Program Files\TWS3\TWS_Web\TWS_Config\TWS_Alerter Configuration : Uniquement par l’administrateur Affectée à un utilisateur, un groupe ou un domaine TWP Admin > Applications > Paramètres applicatifs > TWP Alerter > XMLAlerter
Alerter - TWSAlerterBase.swf (3/3) Exemple de personnalisation : Attribut « url » sur élément « button » ou « image » -> Ouvrir le navigateur sur l’url Attribut « exe » sur élément « button » ou « image » -> Ouvrir un executable <alerter titleIn="[IncomingCall]" titleOut="[OutgoingCall]"> <text x="10" y="5">[-DisplayName-] ([-PhoneNumber-])</text> <text x="10" y="20">[-CompanyName-]</text> <button x="10" y="35" url="[-Url-]">[ExchangePage]</button> <divertedBy x="10" y="55" size="9" /> <image x="178" y="23" width="70" height="55">[-Url-]/ContactPicture.jpg</image> </alerter>
Alerter – TWSAlerterMulti.swf Fonctionnement et configuration identique à TWSAlerterBase.swf Un onglet par contact correspondant au numéro appelant Nom des annuaires
Alerter – TWSAlerterHTML.swf Ouvre une URL et l’affiche sur appel entrant Configuration : Uniquement par l’administrateur Affectée à un utilisateur, un groupe ou un domaine TWP Admin > Applications > Paramètres applicatifs > TWP Alerter > URLAlerter
Méthodes d’appel SOAP HTTP Depuis les applications Microsoft Depuis les outils WinDev Majorité des langages de programmation (Java, PHP) HTTP Supporte GET et POST Appel d’une URL GET or POST <html> <body> <form action="http://server/tws2/TWS_Toolkit/TWS_Toolkit.asmx/TWS_MakeCallByDefaultDevice" method="GET" target=« _blank"> <!– POST or GET--> <input type="hidden" value="f8e0ce0c-44d4-4d8f-9d20-5e37bd7fe569" name="tokenGuid"> <input type="textbox" value="4040" name="szTo"> <input type="submit" value="OK"> </form> </body> </html> URL http://server/tws2/TWS_Toolkit/TWS_Toolkit.asmx/TWS_MakeCallByDefaultDevice?tokenGuid=f8e0ce0c-44d4-4d8f-9d20-5e37bd7fe569&szTo=4040
Règle de nommage …ByDefaultDevice …CallActive Le poste utilisé sera celui associé au compte utilisateur Windows dans l’administration TWP …CallActive L’opération sera effectué sur l’appel en cours
Fonctions (1/5 : Authentification) /tws2s/TWS_SecurityWebSvc/TWS_AuthenticationWebSvc.asmx Se base sur l’authentification Windows TWS_GetMyToken Récupère le token de l’utilisateur
Fonctions (2/5 : Téléphonie) /tws2/TWS_Toolkit/TWS_Toolkit.asmx Authentification anonyme TWS_NormalizeNumber TWS_MakeCall - TWS_AnswerCall Génère un appel téléphonique Répond à l’appel entrant et décroche le téléphone … CCo = 1 ligne – Connection = 1 appel / comm.
Fonctions (3/5 : Administration) /tws2/TWS_GlobalWebSvc/TWS_AdminWebSvc.asmx Authentification anonyme Quelques fonctions utiles au développement Toolkit TWS_GetUser Obtient un objet Utilisateur par son identifiant TWS_GetDeviceByNumber Obtient un objet Device par le son numéro
Fonctions (4/5 : Paramètres) tokenGuid : identifiant de sécurité szCall : référence d’un appel szDevice : poste de l’utilisateur associé szFrom : poste sur lequel l’action téléphonique est faite szTo : numéro du correspondant
Fonctions (5/5 : Investiguer) Résultat des fonctions 0 : OK -1 : serverException -4 : deviceNotFound Information – Alerte - Erreur Observateur d’évènements
Réception d’événements (1/2 : Application cliente) Abonnement : TWS_WebStartMonitor Token Application : TWS-TLK Numéro du poste de l’utilisateur Connexion à une socket TCP Port 9000 XML en UTF-8 <TWS_WaitForGenericEvent><tokenGuid>{token}</tokenGuid></TWS_WaitForGenericEvent> Séparateur de message : 82E51812-45C9-4733 + 0 Polling (toutes les 30 secondes) <TWS_KeepAliveGenericEvent></TWS_KeepAliveGenericEvent>
Réception d’événements (2/2 : Application serveur) Utilisateur admin : Numéro de poste = 0000 Abonnement : TWS_WebStartMonitor Token Application : TWS-TLK Numéro de poste utilisateur Connexion à une socket TCP Port 9002
Question(s) ?