API di testo

Prima di iniziare ad utilizzare l'API di testo, è necessario impostarla nel programma di Configurazione del server Fax. A questo scopo, procedere come segue:

1. Aprire il nodo Configurazione di GFI FAXmaker > Impostazioni avanzate > API di testo, fare clic col pulsante destro del mouse e selezionare Proprietà. Viene visualizzata la finestra di dialogo delle proprietà dell' API di testo.

Proprietà dell'API di testo

2. Selezionare ora la casella di controllo "Esegui la scansione della cartella per i file di testo" e inserire il nome della cartella in cui verranno salvati tutti i file (da inviare a mezzo fax).

3. Specificare la copertina in cui il testo del fax sarà formattato selezionando dall'elenco la copertina appropriata.

Per spedire automaticamente un file di testo, procedere come segue:

1. Creare un file di testo contenente il testo del messaggio.

2. Aggiungere un rigo in cima al testo, che comincia con un doppio simbolo dei due punti (::), specificando nome, azienda, cognome, reparto/ufficio, indirizzo di posta elettronica (tutti facoltativi) e il numero di fax del destinatario.

Per esempio, per inviare un fax a Joe Johnson che lavora nell'ufficio vendite della società GFI, il cui indirizzo di posta elettronica è sales@gfi.com e il cui numero di fax è 382419, la voce da inserire sarà:

::Joe, GFI, Johnson, Vendite, sales@gfi.com, 382419

Il numero di fax può essere inserito in qualsiasi punto nella sintassi. È possibile anche specificare il numero di fax da solo. Per esempio:

:: 382419

La sintassi completa di questo rigo è la seguente:

::<first name>, <company>, <last name>, <department>, <email address>, <fax number> (::<nome>, <azienda>, <cognomen>, <ufficio>, <indirizzo email>, <numero fax>)

3. È possibile aggiungere opzioni supplementari di trasmissione aggiungendo un secondo rigo preceduto da doppio simbolo dei due punti, specificando opzioni di fax valide come descritto nel paragrafo seguente "Opzioni fax".

4. Salvare il file di testo nella directory. Assicurarsi che il file sia salvato con l'estensione ".txt".

5. Il server fax inizia ad elaborare il file e lo rinomina con l'estensione ".tmp".

6. Se la trasmissione del fax ha esito positivo, l'estensione del nome del file del fax viene modificato in "*.ok". Se l'invio del fax non è riuscito, l'estensione viene modificata in "*.err". I file "*.OK" e "*.ERR" possono essere visualizzati con un normale editor di testo. Se si specifica il mittente del fax (si veda più avanti), all'utente viene trasmesso un rapporto di trasmissione.

Copertina dell'API di testo

I file di testo sono formattati utilizzando come modello un file HTML. In questo modo si può aggiungere al file di testo il logo dell'azienda, i dati relativi all'indirizzo, ecc. Per impostazione predefinita, il modello di testo utilizza la copertina predefinita generale, impostata nel programma di configurazione del server fax, alla scheda "Copertina". Tuttavia, è possibile utilizzare la copertina che si desidera specificando un file di copertina diverso, come descritto di seguito nella sezione delle opzioni fax.

Opzioni fax

Quando si trasmette un fax utilizzando l'API di testo, si possono inserire opzioni di trasmissione, quali risoluzione alta o normale e si può programmare l'ora della trasmissione. Queste opzioni devono essere immesse nel secondo rigo del file di testo preceduto da un doppio simbolo dei due punti "::" (i destinatari del fax non vedranno queste specifiche nel testo ricevuto). È possibile utilizzare le seguenti opzioni:

Per specificare una copertina

::C=cover page name or ::Coverpage= cover page name (::C=nome copertina oppure ::Coverpage= nome copertina)

Per esempio: ::C=cover1 (::C=copertina1)

"Nome copertina" sta a indicare il nome della specifica copertina. Se non si desidera inviare una copertina, ma si aggiunge una copertina per impostazione predefinita, è possibile evitare temporaneamente questa opzione specificando "nessuna" invece del nome di una copertina. In questo modo GFI FAXmaker non aggiunge alcuna copertina.

I Va ricordato che la pagina di copertina deve essere prima di tutto memorizzata e configurata sul server.

Per specificare una copertina iniziale

::F=front cover page name or ::frontcover=cover page name (::F=nome copertina iniziale oppure ::frontcover=nome copertina)

Per esempio: ::F=frontcoverpage2 (::F=copertinainiziale2)

"Nome copertina iniziale" sta ad indicare il nome della specifica copertina iniziale.

I Va ricordato che la pagina di copertina deve essere prima di tutto memorizzata e configurata sul server.

Per specificare l'intestazione di un fax

::fh=header or :: (::fh=intestazione oppure :: faxheader=header (faxheader=intestazione)

Per esempio: ::fh=John Doe or ::faxheader=John Doe (::fh=John Doe oppure ::faxheader=John Doe)

Con questa opzione si può impostare un'intestazione personalizzata da aggiungere a quella predefinita in cima al fax.

Per specificare la risoluzione alta o normale

::H or ::high ,or ::N or ::normal (::H oppure ::alta oppure ::N oppure ::normale)

Per esempio: ::H

"H" indica alta risoluzione (200 * 200 dpi) ed "N" indica risoluzione normale (200 * 100 dpi).

Per programmare la trasmissione di un fax

::hh:mm

Per esempio: ::23:15

"hh" equivale a ore e "mm" equivale a minuti. Se si desidera inviare un fax ad un'ora stabilita, si può utilizzare questa opzione.

Per specificare un codice di addebito

::B=nnnn or ::billingcode=nnnn (::B=nnnn oppure ::codiceaddebito=nnnn)

Per esempio: ::B=5

"nnnn" può essere sostituito da qualsiasi numero. Tale numero viene aggiunto nell'archivio storico e può quindi essere utilizzato per la ripartizione dei costi.

Per specificare l'oggetto

::S=subject or ::subject=subject (::S=oggetto oppure ::oggetto=oggetto)

Per esempio: ::S=pricelist (::S=listino prezzi)

Sostituire "oggetto" con l'oggetto che GFI FAXmaker deve inserire nel campo <subject> (<oggetto>) della copertina.

Per specificare la priorità

::p=low/high/l/h or priority= low/high/l/h (::p=bassa/alta/l/h oppure priorità=bassa/alta/l/h)

Per esempio: ::p=low (::p=bassa)

"P" indica la priorità. Si può inserire bassa (low), alta (high) oppure l o h. Questa opzione è utile quando si inviano molti fax mailing e si desidera inviare immediatamente un determinato fax.

Per richiedere la linea fax da utilizzare

::line=linenumber or l=linenumber (::linea=numerolinea oppure l=numerolinea)

Per esempio: ::line=1 (::linea=1)

GFI FAXmaker prova ad inviare il fax sulla linea specificata. Tuttavia, se la linea è occupata o non disponibile, lo trasferisce su un'altra linea.

Per richiedere la linea fax da utilizzare

::line=linenumber, demandline or ::l=linenumber,dl (::linea=numerolinea, linearichiesta oppure ::l=numerolinea,dl)

Per esempio, ::line=1,dl (::linea=1,dl)

GFI FAXmaker invia il fax soltanto sulla linea specificata. Se la linea specificata è occupata, il fax non viene spedito finché la linea non risulta libera.

Per specificare il mittente del messaggio

::f=name or ::from=name (::f=nome oppure ::da=nome)

Per esempio: ::fr=John Smith

Sostituire "nome" con il nome del mittente. Ciò è necessario solo quando si utilizza l'API di testo, perché in questo caso GFI FAXmaker non dispone di informazioni sul mittente. Se si utilizza questa opzione, GFI FAXmaker include il nome del mittente sulla copertina e invia al mittente un rapporto di trasmissione.

Per allegare un file al fax

::A=File name (::A=Nome file)

Per esempio: ::A=brochure.fax or ::A=disclaimer.txt (:: A=opuscolo.fax oppure ::A=disclaimer.txt)

"Nome file" indica il nome del file da allegare al fax. È possibile allegare più file al fax indicando ogni allegato come nell'esempio.

Nota: GFI FAXmaker ricerca il file da allegare prima nella directory Copertina del server fax e poi nella directory TextAPI (API di testo).

Opzioni multiple

Quando si utilizzano più opzioni in un messaggio, è necessario inserirle sullo stesso rigo, separate da una virgola.

Per esempio:

::c=cover1,23:15,B=5 (::c=copertina1,23:15,B=5)

In questo esempio viene inviato un fax con "copertina1" come copertina, programmato per le ore 23:15 e con il codice di addebito 5.

Trasmissione di un fax utilizzando le opzioni multiple

I Va ricordato che prima di utilizzare le opzioni fax, è necessario assicurarsi di aver effettivamente archiviato gli allegati e le copertine che si utilizzano.

I GFI FAXmaker non è sensibile alle lettere maiuscole. Ciò significa che non importa se si scrive il testo con le lettere maiuscole o minuscole.