PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Différences entre la fonction telCompose et telComposeLigne
  • Limitation
  • Configuration nécessaire
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Compose un numéro de téléphone pour une prise de ligne vocale, en choisissant le périphérique.
WINDEV Remarque : Dans le cadre d'une application PABX, chaque ligne apparaît comme un périphérique. Pour numéroter sur une ligne téléphonique, il faut donc à chaque fois :
  1. Choisir la ligne téléphonique en cours (fonction telPériphérique).
  2. Numéroter (fonction telCompose).
C'est ce que fait la fonction telComposeLigne.
Exemple
// Récupère la liste des périphériques TAPI
sListeTAPI est une chaîne = telListePériphérique()
// Affiche la liste dans une combo
ListeAjoute(COMBO_TAPI, sListeTAPI)
...
// Sélectionne le périphérique TAPI
SI telComposeLigne(COMBO_TAPI[COMBO_TAPI], SAI_NuméroTéléphone, "TestEtatLigne") <> 0 ALORS
Info("Cliquez sur OK pour raccrocher")
telRaccroche()
FIN
PROCEDURE EtatLigne(ValeurEtatLigne est un entier)
SELON ValeurEtatLigne
CAS telLigneOccupée: Message("La ligne est occupée")
CAS telLigneDecrochée: Message("OK, connecté")
CAS telLigneNumérote: Message("Numérotation en cours")
CAS telLigneTonalité: Message("Tonalité")
CAS telLigneRaccrochée: Message("Le correspondant a raccroché")
CAS telLigneAttendRéponse: Message("Recherche du correspondant")
CAS telLigneSonnerie: Message("Sonnerie chez le correspondant")
FIN
Syntaxe
<Résultat> = telComposeLigne(<Ligne à utiliser> , <Numéro à composer> [, <Nom de la procédure> [, <Durée> [, <Paramètre personnalisé>]]])
<Résultat> : Entier
  • Identifiant de l'appel numéroté.
  • 0 en cas d'erreur. Le détail de l'erreur peut être connu avec la fonction ErreurInfo.
<Ligne à utiliser> : Chaîne de caractères
Ligne ou périphérique à utiliser.

Rappel : La liste des périphériques de téléphonie est connue avec la fonction telListePériphérique.
<Numéro à composer> : Chaîne de caractères (avec guillemets)
Numéro de téléphone à composer.
<Nom de la procédure> : Chaîne de caractères (avec ou sans guillemets) optionnelle
Nom de la procédure WLangage permettant de gérer la progression de la numérotation. Cette procédure est du type :
PROCÉDURE <Nom de la procédure>(<Etat de la ligne>, <Paramètre>)

Le premier paramètre de la procédure (paramètre <Etat de la ligne>) est un entier qui peut prendre les valeurs suivantes :
telLigneOccupéeLa ligne est actuellement occupée.
telLigneDécrochéeLa ligne est connectée.
telLigneNuméroteNumérotation en cours.
telLigneTonalitéLa ligne reçoit la tonalité.
telLigneRaccrochéeLe correspondant a raccroché.
telLigneAttendRéponseL'appel est composé : recherche du correspondant.
telLigneSonnerieSonnerie en cours chez le correspondant.
Le second paramètre de la procédure (paramètre <Paramètre>) est le paramètre personnalisé passé à la fonction telComposeLigne.
Attention : cette procédure ne doit pas contenir d'appel au débogueur (ni point d'arrêt, ni mot-clé STOP, ni expression auto-stop, ...).
<Durée> : Entier optionnel ou Durée optionnelle
Durée maximale d'attente (en secondes). Au delà de cette durée, la fonction considère qu'il n'y a pas de réponse (personne ne décroche). Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de secondes,
  • une variable de type Durée,
  • Versions 23 et supérieures
    l'indication directe de la durée (par exemple 1 s ou 10 ms).
    Nouveauté 23
    l'indication directe de la durée (par exemple 1 s ou 10 ms).
    l'indication directe de la durée (par exemple 1 s ou 10 ms).
Par défaut, ce paramètre correspond à 15 secondes.
<Paramètre personnalisé> : Tout type, optionnel
Paramètre passé à la procédure WLangage.
Remarques

Différences entre la fonction telCompose et telComposeLigne

  • La fonction telCompose s'utilise dans un contexte d'un seul appel sortant. L'identifiant de cet appel n'est pas disponible.
  • La fonction telComposeLigne s'utilise dans un contexte où il peut y avoir plusieurs appels simultanés. La fonction telComposeLigne renvoie l'identifiant de l'appel. On peut ainsi le manipuler simplement (par exemple, pour effectuer un transfert d'appel).

Limitation

Il n'est pas possible d'appeler la fonction telComposeLigne dans la procédure de détection d'appel (définie grâce à la fonction telDémarreDétectionAppel).
WINDEVCode Utilisateur (MCU)

Configuration nécessaire

Les fonctions de téléphonie utilisent la technologie TAPI 2.0. Cette technologie est utilisable sur tous les systèmes.
Cependant, si le système utilisé est Windows NT4, il est nécessaire d'installer le service pack 4 minimum.
Remarque : La technologie TAPI 3.0 et supérieure n'est pas gérée dans cette version.
Composantes
WINDEVEtats et Requêtes wd230com.dll
Windows Mobile wp230com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire