API Texte
Avant de commencer à utiliser API Texte, vous devez d'abord le configurer au sein de la Configuration du Serveur de Fax. Pour ce faire :
1. Aller au sigle FAXmaker Configuration > Advanced > API Text, cliquez droit et sélectionner les propriétés. La boîte de dialogue des propriétés de API Texte apparaît.
Propriétés du API texte
2. Maintenant cochez l'option Scan folder for text files et entrez le nom du dossier dans lequel tous les fichiers (de fax à envoyer) seront sauvegardés.
3. Indiquez maintenant une page de garde dans laquelle le texte du fichier texte doit être formaté, en choisissant une page de garde appropriée à partir de la liste.
Pour envoyer automatiquement un fichier texte:
1. Créez un fichier texte comprenant le texte du message.
2. Ajoutez une ligne en haut du texte commençant par deux double points (::) et contenant : le nom du destinataire, de la société, le nom de famille, le service, l'adresse e-mail (tout cela est optionnel) ainsi que le numéro de fax.
Par exemple, pour envoyer un fax à Joe Johnson qui fait partie du département ventes chez la société GFI Software Ltd dont l'adresse e-mail est sales@gfsfrance.com et le numéro de fax 382419, l'entrée serait la suivante :
::Joe, GFI Software, Johnson, Sales, sales@gfsfrance.com, 382419
Le numéro de fax peut être placé n'importe où dans cette syntaxe. Vous pouvez aussi l'utiliser seul comme par exemple : Par exemple :
:: 382419
La syntaxe intégrale pour cette ligne est la suivante :
::<Nom>, <société>, <nom de famille>, <service>, <adresse email >, <numéro de fax >
3. Vous pouvez spécifier d'autres options d'envoi, en ajoutant simplement une seconde ligne toujours précédée du signe « :: », qui indique des options valides telles que celles décrites dans le paragraphe « Options de Fax » ci-dessous.
4. Enregistrez le fichier texte dans le répertoire. Assurez-vous que le fichier porte l'extension .txt.
5. Le serveur de fax va commencer à traiter le fichier et le renommer avec l'extension .tmp.
6. Si le fax est transmis avec succès, l'extension du fichier fax sera changée à *.OK . En cas d'échec, le fichier prendra l'extension *.err. Les fichiers *.OK et *.ERR peuvent être ouverts avec un éditeur de texte normal. Si vous spécifiez l'expéditeur du fax (voir ci-dessous), un rapport témoin de transmission lui sera envoyé.
Page de garde en API Texte
Les fichiers texte sont formatés grâce à un fichier HTML modèle. De cette façon, vous pouvez ajouter le logo de votre entreprise et d'autres détails au fichier. Par défaut, le modèle utilise une page de garde générale qui est définie sous l'onglet « Page de garde » au sein de la configuration du serveur de fax. Cependant, vous pouvez la changer et spécifier une autre page de garde en indiquant un différent fichier de pages de garde. Ceci est illustré au sein des options de fax ci-dessous.
Options de fax
Lorsque vous envoyez un fax en utilisant le API Texte vous pouvez entrer des options d'envoi telles que la résolution et l'heure d'envoi. Ces options doivent être insérées dans la seconde ligne du fichier texte, précédées toujours par deux fois deux points :: (Notez que ces options ne seront pas visibles pour le destinataire du fax.) Les options suivantes peuvent être utilisées :
Pour spécifier une page de garde
::C=nom de page de garde ou ::Coverpage= nom de page de garde
Par exemple : ::C=cover1
« Nom de page de garde » indique le nom de votre page de garde. Si vous ne souhaitez pas envoyer de page de garde, mais que par défaut une page de garde est ajoutée, vous pouvez ponctuellement supprimer cette page en spécifiant aucune « none » à la place d'un nom de page de garde. Ainsi GFI FAXmaker n'ajoutera pas de page de garde.
I N'oubliez pas que la page de garde doit d'abord être configurée et enregistrée sur le serveur.
Pour spécifier un bordereau
::F=nom de bordereau ou ::frontcover=nom de bordereau
Par exemple : ::F=frontcoverpage2
« front cover page name » est le nom du bordereau.
I N'oubliez pas que la page de garde doit d'abord être configurée et enregistrée sur le serveur.
Pour spécifier une en-tête de fax
::fh=en-tête ou :: faxheader= en-tête
Par exemple : ::fh=John Doe ou ::faxheader=John Doe
Avec cette option vous pouvez spécifier un texte d'en-tête spécifique qui apparaîtra en haut de chaque page de fax.
Pour spécifier une résolution normale ou haute
::H ou ::haute, ou ::N ou ::normale
Par exemple : ::H
« H » indique haute résolution (200 * 200 dpi) et « N » résolution normale (200 * 100 dpi).
Pour programmer un fax
::hh:mm
Par exemple : ::23:15
« hh » équivaut à l'heure et « mm » aux minutes. Cette option peut être utilisée si vous voulez envoyer un fax à une date et heure déterminée.
Spécifier un code de facturation :
::B=nnnn ou ::billingcode=nnnn
Par exemple : ::B=5
« nnnn » peut être remplacé par n'importe quel nombre. Ce nombre sera ajouté au fichier journal et peut alors être utilisé pour imputer les frais.
Pour spécifier l'objet
::S=objet ou ::subject=objet
Par exemple : ::S= liste des prix
Remplacez « subject » par l'objet que GFI FAXmaker doit insérer dans le champ <objet> de la page de garde.
Pour spécifier la priorité
::p=faible/haute/l/h ou priority= faible/haute/l/h
Par exemple : ::p=faible
« P » indique la priorité du fax. Vous pouvez saisir faible (low) ou haute (high) ou bien « l » ou « h ». Cette option est très utile lorsque vous avez un grand nombre de fax à envoyer et que vous voulez envoyer un fax tout de suite.
Demande de ligne fax à utiliser
::line=numéro de ligne ou l=numéro de ligne
Par exemple : ::line=1
GFI FAXmaker essaiera d'envoyer le fax en utilisant la ligne spécifiée. Si cette ligne n'est pas disponible, il en essaiera une autre.
Pour demande quelle ligne fax utiliser
::line=numéro de ligne, demandline ou ::l=numéro de ligne,dl
Par exemple : ::line=1,dl.
GFI FAXmaker essaiera d'envoyer le fax en utilisant la ligne spécifiée. Si cette ligne est occupée, le fax ne sera pas envoyé avant que celle-ci ne soit disponible.
Pour spécifier l'expéditeur du message
::fr=nom ou ::from=nom
Par exemple : ::fr=John Smith
Ceci remplace « nom » avec le nom de l'expéditeur. Cela n'est nécessaire qu'avec le API Texte, car GFI FAXmaker n'aura aucune information sur l'expéditeur. Si cette option est utilisée, GFI FAXmaker ajoutera le nom de l'expéditeur à la page de garde et lui enverra un rapport de transmission.
Pour joindre un fichier à votre fax
::A=Nom de fichier
Par exemple : ::A=brochure.fax ou ::A=disclaimer.txt
Le « nom de fichier » représente le nom d'une pièce jointe au fax. Des connexions multiples peuvent être ajoutées au fax en indiquant des commandes de pièces jointes multiples comme dans l'exemple.
Remarque : GFI FAXmaker cherche la pièce jointe tout d'abord dans le répertoire « page de garde » dans le serveur fax et ensuite dans le répertoire TextAPI.
Spécifier plusieurs options
Avec l'usage d'options multiples dans un message, vous devez les saisir sur la même ligne, et les séparer d'une virgule.
Par exemple :
::c=cover1,23:15,B=5
Cet exemple envoie un fax avec « cover1 » comme page de garde, programmé pour être envoyé à 23h15 et le coût sera imputé au code de facturation 5.
Utilisation de plusieurs options pour envoyer un fax
I N'oubliez pas d'enregistrer les pièces jointes et les pages de garde que vous utilisez avant d'utiliser les options de fax.
I GFI FAXmaker ne prend pas en compte la frappe. Cela signifie que vous pouvez taper le texte en majuscules ou en minuscules.
