Envois en mode macro

Notre logiciel vous permet d'envoyer vos documents en mode macro, c'est à dire que vous pouvez commander notre logiciel de façon automatique (depuis votre outil de développement). Ce mode est commandé à travers la base de registre de Windows qui est accéssible depuis n'importe quel environnement de développement (Visual Basic, Visual C++, Macro Microsoft Word ou Excel, etc...).
Vous pouvez utiliser le mode macro pour envoyer une télécopie à un destinataire unique ou pour envoyer un mailing.

Si vous avez besoin d'automatiser vos envois de télécopie de façon automatique et que vos serveurs fonctionnent sous d'autres systèmes d'exploitation que Windows, nous avons une solution vous permettant d'utiliser le protocole FTP pour vous connecter à notre réseau. Veuillez contacter notre service technique pour de plus amples informations au : 0826 00 36 10

Préparation du logiciel

Pour utiliser le mode macro vous devez renoncer au logiciel de suivi temps réel qui est lancé par défaut lors de l'impression d'un document. Pour ce fairen vous devez aller dans le répertoire d'installation du logiciel, supprimer SafeF32.exe, puis renommer mailing.exe en SafeF32.exe. Une fois cette opération effectuée, le mode macro est actif.

Envoi à un destinataire unique

Pour envoyer une télécopie à un destinataire unique avec le mode macro de notre logiciel, vous devez aller dans la base de registre de Windows dans le répertoire :
HKEY_CURRENT_USER\Software\Alliance MCA\SafeFax où vous modifirez les clefs suivantes:

LastFax doit contenir le numéro du fax destinataire
AutoSend doit contenir 1

Une fois ces modifications effectuées dans la base de registres, il suffit d'imprimmer le documment ave l'imprimante Internet Fax, le logiciel enverra automatiquement le document sur le serveur de fax. ATTENTION, vous devez attendre que la clef AutoSend soit revenu à 0 avant de pouvoir réutiliser l'imprimante.

Une fois le registre AutoSend revenu à 0, vous pouvez savoir si le fax est bien parti sur le serveur en regardant le registre AutoSendReturn qui sera une valeur négative en cas d'echec.

A partir de la version 2.2.12.14 un registre WSAerror a été ajouté contenant le code d'erreur de la fonction socket qui a arrêté l'envoi (ces codes peuvent être trouvés sur le site de Microsoft MSDN).

Envoi à une liste de destinataire

Notre logiciel permet aussi l'envoi automatique à une liste de destinataires. La procédure est identique à l'envoi automatique à un destinataire unique, seule une clef à été rajoutée.

AutoMailingFile doit contenir le nom complet du fichier texte contenant la liste des destinataire de l'envoi.

L'envoi de mailing personnalisé en mode macro est possible, on utilise toujours la base de registres de Windows en utilisant le modèle de document de notre logiciel. Le modèle de document de notre logiciel est sauvegardé dans le répertoire "HKEY_CURRENT_USER\Software\Alliance MCA\SafeFax\template" où l'on trouve un répertoire par page (de la forme "page.X"), puis dans chaque répertoire de page on trouve un répertoire par cadre de personnalisation (de la forme "cadre.X"), puis on trouve un ensemble de clef définissant le cadre.

top, bottom, left, right définissent les coordonnées du cadre dans l'image de la page de fax (une image faisant 1728 pixels de large sur 2256 pixels de haut en mode fin et 1128 pixels de haut en mode normal).
font-align fixe l'alignement du texte dans le cadre center, left ou right
font-name fixe le nom de la fonte de caractères utilisée (Arial, etc..)
page doit contenir le numéro de la page du document
type doit contenir 0x20
text doit contenir le texte du cadre avec les variables de la forme $VAR, chaque variable devant se retrouver dans le fichier de destinataires en première ligne (CSV).

Attention

Le mode macro n'ouvre pas de fenêtre d'aide à l'import de votre fichier texte, celui-ci doit donc être parfaitement formaté. La première ligne doit contenir le nom des colones (avec la colone FAX) correspondant aux noms des variables utilisées dans les cadres de personnalisation.

Récupération des statistiques

La première possibilité est de demander au logiciel de vous renvoyer l'accusés de l'envoi à une adresseEmail. Si vous ne désirez pas utiliser l'Email, la récupération des statistiques se fait via un accès sur le serveur web du serveur de fax. Vous retrouverez dans la clef
"HKEY_CURRENT_USER\Software\Alliance MCA\SafeFax\LastUnique"
la clef unique de l'envoi sur le serveur. Cette clef permet de retrouver les statistiques de l'envoi sur le serveur web à travers des CGI.

Cas des envois simples

Pour connaître l'état de votre télécopie vous devez aller sur votre page de statistique de la journée d'envoi du document. Les statistique de la journée se trouve à l'URL suivante:
"http://serveurfax/cgi-bin/stat.cgi?PSEUDO=xxxxx&GFA=xxxxx&UNIQUE=AAAAMMJJ"
Vous devez bien entendu utiliser votre identifiant utilisateur pour la variable PSEUDO et le groupe d'utilisateur pour la variable GFA. La variable UNIQUE de l'URL doit contenir les huits premiers caractères de la chaîne fournit par le registre LastUnique.

Vous trouverez dans la page du jour un commentaire HTML par envoi simple avec la variable UNIQUE contenant la chaîne récupérée avec le registre LastUnique (par exemple : <!-- UNIQUE="20030108103201-16544.0" ETAT="2" COMMENT="no_comment" ). Les autres variables du commentaire HTML sont COMMENT contenant le commentaire de l'envoi (le registre LastCommentaire) ainsi que l'état de l'envoi.

0 : arrivé sur le serveur
1 : arrivé dans les spools d'envois (perssonalisé)
2 : arrivé chez le destinataire (c'est l'état indiquant que tout c'est déroulé parfaitement
3 : une erreur est survenue lors de la personnalisation
4 : le numéro de destinataire semble érroné.
5 : l'appel a aboutis à un décrochage mais sans connexion à un télécopieur (ATTENTION cet appel sera facturé).
6 : le numéro est occupé.
7 : le numéro semble correct mais il n'y a pas de déccrochage de la ligne.
8 : l'appel a aboutis a une connection à un télécopieur, mais l'accusé de réception du document n'a pas été reçus (le document est peut-être arrivé, peut-être partiellement).
9 : erreur lors de la numérotation (peut-être problème matériel, ou problème de ligne chez notre opérateur).
10 : plus utilisé
11 : plus utilisé
12 : numéro brûlé (le numéro se touve parmis notre liste de numéros auquels il ne faut pas envoyer de télécopies).
13 : numéro refusé (le numéro ne se trouve pas dans nos liste de routage).
14 : envoi effacé par le cockpit de surveillance des serveurs.
15 : envoi annulé (le serveur n'est pas arrivé a envoyer cette télécopie et il l'a annulé automatiquement après 3 essais).
16 : l'envoi a été annulé en cours pour administration du serveur.

Cas des envois multiples

Pour les envois multiples, c'est plus simple, vous allez à l'URL suivante :
"http://serveurfax/cgi-bin/detail.cgi?PSEUDO=xxxxx&GFA=xxxxx&UNIQUE=xxxxx-xxx" Ou la variable UNIQUE contient exactement la chaîne renvoyée par le registre LastUnique.

Vous obtenez un fichier texte avec des champs séparés par des points-virgules du type suivant :


PAYS;RETOUR;DUREE;COUT;FAX;NUM

FRAIDF;OK;52;0.030000;+33..134292250;3

FRAIDF;OK;51;0.030000;+33..134292252;2

FRAIDF;BURNED;0;0.000000;+33..134043615;1

FRAIDF;BURNED;0;0.000000;+33..134043611;0

Les différents champs du fichiers sont :

PAYS : indique le code pays avec eventuellement le code région (les trois premiers caractères représentent toujours le code pays).
RETOUR : indique la valeur de retour du serveur (ou état) et peut prendre les valeurs WAIT SPOOL OK BAD BUSY PARTIEL ERROR etc.
DUREE : indique la durée de l'émission de la télécopie.
COUT : indique le coût réel de la télécopie.
FAX : indique le numéro du destinataire (le .. sert a obliger Excel à considérer le champs en texte à la place d'un nombre).
NUM : contient le numéro de la télécopie dans le mailing.