DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Gestion des fax
  • Présentation
  • Comment envoyer des fax ?
  • Programmer l'envoi de fax
  • Envoyer un fax depuis une application WINDEV ou un site WEBDEV
  • Envoyer un fax créé avec l'éditeur d'états
  • Configurer le serveur de fax par programmation
  • Options du serveur de fax
  • Astuces
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Pour envoyer des fax directement depuis une application ou un site, WINDEV et WEBDEV mettent à votre disposition des fonctions permettant d'envoyer des fax, par l'intermédiaire du serveur de fax système disponible sous Windows XP et Windows 2000.
Remarque : Sous Windows Vista, la gestion des fax est disponible uniquement avec Windows Vista Professionnel et Windows Vista Edition Intégrale.
Comment envoyer des fax ?
Pour envoyer des fax depuis une application WINDEV ou un site WEBDEV, il faut :
Programmer l'envoi de fax

Envoyer un fax depuis une application WINDEV ou un site WEBDEV

Pour envoyer un fax depuis une application WINDEV ou un site WEBDEV, il faut :
  1. Préparer le fax, c'est-à-dire le fichier que va être envoyé. Il est possible également d'associer une première page spécifique au fax (appelée "Couverture"). Cette première page est un fichier de type ".Cov" et peut être créée à partir du serveur de fax.
  2. Utiliser la fonction FaxConnecte. Cette fonction permet de connecter l'application WINDEV au serveur de fax installé sur le poste en cours.
  3. Envoyer le fax :
    • soit avec la fonction FaxEnvoie. Lors de cet envoi, il est possible de préciser le nom d'une procédure WLangage. Cette procédure sera appelée à chaque modification de l'état du fax dans le serveur de fax. L'état du fax peut être connu par la fonction FaxEtat. Cette fonction permet de remplir la structure FaxEtatComplet contenant toutes les caractéristiques du fax.
    • soit avec la fonction iDestination et les fonctions d'impression. Cette solution permet d'imprimer directement un état réalisé avec l'éditeur d'états. Dans ce cas, il est possible de donner un nom au fax envoyé. L'état du fax pourra ensuite être connu avec la fonction FaxEtat. Cette fonction permet de remplir la structure FaxEtatComplet contenant toutes les caractéristiques du fax.
      Remarque : Il n'est possible d'envoyer qu'un seul fax à la fois. Il est cependant possible d'exécuter plusieurs fonctions FaxEnvoie à la suite : les différents fax seront mis dans la chaîne d'attente d'envoi des fax. La procédure WLangage combinée à la fonction FaxEtat permettra de connaître le fax en cours de traitement. Cette fonction permet de remplir la structure FaxEtatComplet contenant toutes les caractéristiques du fax.
  4. Lorsque le ou les différents fax sont envoyés, il suffit de déconnecter l'application WINDEV du serveur de fax avec la fonction FaxDéconnecte.

Envoyer un fax créé avec l'éditeur d'états

Pour envoyer un fax créé avec l'éditeur d'états, il est possible :
  • soit d'utiliser uniquement la fonction iDestination. L'état imprimé par la fonction iImprimeEtat sera directement envoyé au numéro de fax spécifié. Dans ce cas, aucune gestion de suivi du fax n'est possible.
    // Envoie l'état "ETAT_FactureCli" par fax
    iDestination(iFax, "0006050402")
    iImprimeEtat(ETAT_FactureCli)
  • soit d'utiliser les fonctions Fax et la fonction iDestination. La fonction iDestination effectue si nécessaire une connexion au serveur de fax et renvoie l'identifiant de cette connexion. Cet identifiant peut être utilisé avec les fonctions Fax pour suivre l'évolution de l'envoi du fax.
    // Envoie l'état "ETAT_FactureCli" par fax
    IDConnect est un entier
    IDConnect = iDestination(iFax, "0006050402", "MonFax","\\monFax\ImprimanteFax")
    // "\\monFax\ImprimanteFax" est le nom de partage de l'imprimante fax
    iImprimeEtat(ETAT_FactureCli)
Configurer le serveur de fax par programmation

Options du serveur de fax

Le serveur de fax standard de Windows propose plusieurs options, configurables directement depuis l'interface dus serveur de fax. Ces différentes options peuvent être configurées directement par programmation, en manipulant la base de registre. Il est possible de paramétrer et d'obtenir :
  • des informations concernant l'envoi de fax (Windows 2000) :
    La clé de registre correspondante est HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax :
    Archiver les télécopies sortantesArchiveOutgoingFax
    Heure de début de la période de tarif réduitStartCheapTime
    Heure de FIN de la période de tarif réduitStopCheapTime
    Impression de la bannière du hautBranding
    Interdire les pages de garde personnelServerCoverPageOnly
    Nombre de jours avant suppression des télécopies Non envoyéesDirty Days
    Nombre de minutes entre deux tentativesRetry Delay
    Nombre d'essaisRetries
    Répertoire des télécopies sortantesArchiveDirectory
  • des informations concernant l'expéditeur du fax (Windows 2000) :
    La clé de registre correspondante est HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax\UserInfo :
    Adresse MessagerieMailbox
    Adresse professionnelleOffice
    Affiche le moniteur d'état en envoi ET réceptionVisualNotification
    Avertissement sonoreSoundNotification
    Code de facturationBillingCode
    Moniteur d'état toujours DessusAlwaysOnTop
    Nom completFullName
    Numéro de fax expéditeurFaxNumber
    ServiceDepartment
    SociétéCompany
    Téléphone personnelHomePhone
    Téléphone professionnelOfficePhone
    TitreTitle

Astuces

Pour réaliser un serveur de fax et gérer les re-expéditions de fax, il est préférable d'indiquer au niveau du gestionnaire de fax les options suivantes:
  • Pas de re-tentative d'expédition des fax :
    RegistreEcrit("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax","Retries",0)
  • Delai de 0 mn entre deux tentatives :
    RegistreEcrit("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax","Retry Delay",0)
  • 0 jour de conservation des fax non envoyés :
    RegistreEcrit("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax","Dirty Days",0)
Il est possible de considérer qu'un fax passé par l'état FaxEtatInit OU FaxEtatAppel et qui revient dans l'état FaxEtatInactif est un fax qui a tenté d'être expédié une fois. Ce fax va ensuite être ré-expédié (il ne sera pas ré-expédié automatiquement car l'option "Pas de re-tentative d'expédition des fax" est à vrai).
Liste des exemples associés :
Envoi d'un fax Exemples unitaires (WINDEV) : Envoi d'un fax
[ + ] Envoi d'un fax avec WINDEV. Le fax peut être envoyé grâce à un serveur de fax mais aussi par un modem correctement installé et configuré sur le poste de l'utilisateur.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale