GFI Product Manual. Manuale per le API

Transcript

1 GFI Product Manual Manuale per le API

2 Le informazioni e il contenuto del presente documento vengono forniti esclusivamente a scopi informativi e come sono, senza garanzia di alcuni tipo, sia espressa che implicita, ivi incluse, in via esemplificativa, tutte le garanzie implicite di commerciabilità, idoneità a soddisfare uno scopo particolare e di non violazione dei diritti di altri. GFI Software non sarà ritenuta responsabile di nessun danno, inclusi danni consequenziali, che possano derivare dall uso del presente documento. Le informazioni sono state ottenute da fonti pubblicamente disponibili. Nonostante siano stati compiuti sforzi ragionevoli al fine di garantire la precisione dei dati forniti, GFI non garantisce, promette né tantomeno assicura la completezza, precisione, l aggiornamento o l adeguatezza di tali dati e non sarà ritenuta responsabile di errori di stampa. GFI non fornisce garanzie, né espresse né implicite e non si assume la responsabilità legale o della precisione o completezza delle informazioni contenute nel presente documento. Se si ritiene che vi siano errori effettivi nel presente documento, contattarci. Provvederemo a risolvere la cosa quanto prima. Tutti i nomi di prodotti e società riportati possono essere marchi registrati dei rispettivi proprietari. GFI FaxMaker è copyright di GFI SOFTWARE Ltd GFI Software Ltd. Tutti i diritti riservati. Versione documento: FM-API-IT Ultimo aggiornamento: 8 agosto 2011

3 Sommario 1 API di GFI FaxMaker Introduzione alle API di GFI FaxMaker NetPrintQueue2FAX API di testo API XML Specifica *.XML Esempio di file XMLAPI Specifica *.STATUS Risoluzione dei problemi Introduzione Knowledge Base Forum Web Richiesta di supporto tecnico Notifiche sulle build Indice 19

4

5 1 API di GFI FaxMaker 1.1 Introduzione alle API di GFI FaxMaker GFI FaxMaker consente di inviare automaticamente i fax dall'applicazione tramite i seguenti metodi: 1. La caratteristica Netprintqueue2FAX 2. L'API di testo 3. L'API XML 1.2 NetPrintQueue2FAX La caratteristica Netprintqueue2FAX consente di integrare il numero di fax nel documento da inviare. In questo modo, è possibile stampare sul dispositivo fax da pressoché tutte le applicazioni, da qualsiasi punto della rete, senza dover inserire separatamente il numero di fax nel modulo fax di GFI FaxMaker o di Outlook. Questa caratteristica risulta particolarmente utile per le applicazioni contabili in quanto il fax può essere inviato con la semplice integrazione del numero di fax nel documento, quale ad esempio una fattura. Non è richiesta alcuna operazione di integrazione o sviluppo dell'applicazione. Per ulteriori informazioni, consultare i capitolo NetPrintQueue2FAX nel manuale dell'utente di GFI FaxMaker. 1.3 API di testo L'API di testo consente di inviare automaticamente i file di testo tramite il salvataggio del file con le opzioni fax in una directory. Prima di iniziare ad utilizzare l'api di testo, è necessario impostarla nel programma di configurazione del server fax. A tale scopo, procedere come segue: 1. Aprire il nodo Configurazione di GFI FaxMaker Impostazioni avanzate API di testo, fare clic con il pulsante destro del mouse e selezionare. Viene visualizzata la finestra di dialogo delle proprietà dell'api di testo. API di GFI FaxMaker GFI FaxMaker 1

6 Figura 1 - dell'api di testo 2. Selezionare la casella di controllo Esegui scansione dei file di testo nella cartella e immettere il nome della cartella in cui verranno salvati tutti i file da inviare tramite fax. 3. Specificare il frontespizio in cui il testo del fax verrà formattato, selezionando nella casella di riepilogo ilfrontespizio appropriato. Per inviare automaticamente un file di testo 1. Creare un file di testo contenente il testo del messaggio. 2. All'inizio del testo aggiungere una riga che comincia con un doppio simbolo di due punti (::), specificando nome, azienda, cognome, ufficio, indirizzo di posta elettronica (tutti elementi facoltativi) e il numero di fax del destinatario. Ad 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 numero di fax è , si dovrà inserire: ::Joe, GFI, Johnson, Sales, sales@gfi.com, Il numero di fax può essere inserito in qualsiasi punto nella sintassi. È possibile anche specificare il numero di fax da solo. Ad esempio: :: La sintassi completa di questa riga è la seguente: ::<nome>, <azienda>, <cognome>, <ufficio>, <indirizzo di posta elettronica>, <numero di fax> 3. È possibile inserire ulteriori opzioni di invio aggiungendo una seconda riga preceduta dal doppio simbolo di due punti contenente opzioni di fax valide, come descritto nel seguente paragrafo "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 a elaborare il file e lo rinomina con l'estensione.tmp. 2 GFI FaxMaker API di GFI FaxMaker

7 6. Se la trasmissione del fax ha esito positivo, l'estensione del nome del file del fax viene modificata in *.ok. Se l'invio del fax non ha esito positivo, 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 (vedere in seguito), all'utente viene inviato un report di trasmissione. NOTA: le estensioni *.ok e *.err non vengono utilizzate se si specifica il mittente del messaggio, come indicato nella sezione "Per specificare il mittente del messaggio" più avanti in questo manuale. Frontespizio dell'api di testo I file di testo vengono formattati utilizzando come modello un file HTML. In questo modo è possibile aggiungere al file di testo il logo dell'azienda, i dati relativi all'indirizzo e così via. Per impostazione predefinita, il modello di testo utilizza il frontespizio standard predefinito, impostato nella scheda Frontespizio della configurazione del server fax. Tuttavia, è possibile utilizzare il frontespizio che si desidera specificando un file di frontespizio diverso, come descritto di seguito nella sezione delle opzioni fax. Opzioni fax Quando si invia un fax utilizzando l'api di testo, si possono inserire opzioni di invio, quali la risoluzione alta o normale, e si può programmare l'ora di invio. Queste opzioni devono essere immesse nella seconda riga del file di testo precedute da un doppio simbolo di due punti (::). Queste specifiche non saranno visibili ai destinatari del fax nel testo ricevuto. È possibile utilizzare le seguenti opzioni: Per specificare un frontespizio ::C=nome frontespizio oppure ::Coverpage= nome frontespizio Ad esempio: ::C=cover1 "nome frontespizio" indica il nome del frontespizio specifico. Se non si desidera inviare un frontespizio, ma per impostazione predefinita viene aggiunto un frontespizio, è possibile ignorare questa opzione specificando "none" al posto del nome del frontespizio. In questo modo non viene aggiunto alcun frontespizio. NOTA: il frontespizio deve essere prima archiviato e configurato nel server. Per specificare un frontespizio iniziale ::F=nome frontespizio iniziale oppure ::frontcover=nome frontespizio Ad esempio: ::F=frontcoverpage2 "nome frontespizio iniziale" indica il nome dello specifico frontespizio iniziale. NOTA: il frontespizio deve essere prima archiviato e configurato nel server. Per specificare l'intestazione di un fax ::fh=intestazione oppure ::faxheader=intestazione Ad esempio: ::fh=john Doe oppure ::faxheader=john Doe Con questa opzione si può impostare un'intestazione personalizzata da aggiungere a quella predefinita all'inizio del fax. Per specificare la risoluzione alta o normale ::H oppure ::high o ::N oppure ::normal Ad esempio: ::H "H" indica alta risoluzione (200 * 200 dpi) e "N" indica risoluzione normale (200 * 100 dpi). Per programmare la trasmissione di un fax ::AAAA-MM-GG-hh:mm:ss Ad esempio: :: :05:00 API di GFI FaxMaker GFI FaxMaker 3

8 Specificare l'anno a 4 cifre per AAAA e 2 cifre per gli altri indicatori. MM indica il mese, GG indica il giorno, hh indica l'ora, mm indica i minuti e ss indica i secondi. Per specificare un valore composto da una cifra, ossia un numero compreso tra 1 e 9, per un valore costituito da 2 cifre, assicurarsi di aggiungere uno zero (0) come prefisso, in modo che 3, ad esempio, diventi 03. In alternativa, è possibile utilizzare il seguente metodo sostitutivo: ::hh:mm Ad esempio: ::23:15 hh equivale alle ore e mm equivale ai minuti. Se si desidera inviare un fax ad un'ora stabilita, si può utilizzare questa opzione. Per specificare un codice di fatturazione ::B=nnnn oppure ::billingcode=nnnn Ad esempio: ::B=5 nnnn può essere sostituito da qualsiasi stringa. Tale stringa viene aggiunta nel file di registro e può quindi essere utilizzata per la ripartizione dei costi. Per specificare l'oggetto ::S=oggetto oppure ::subject=oggetto Ad esempio: ::S=pricelist Sostituire "oggetto" con il testo che deve essere inserito nel campo <oggetto> del frontespizio. Per specificare la priorità ::p=low/high/l/h oppure priority=low/high/l/h Ad esempio: ::p=low "p" indica la priorità. È possibile immettere low (bassa), high (alta) oppure l o h. Questa opzione è utile quando è stato inviato un fax a una lista di distribuzione con tanti destinatari e si desidera inviare immediatamente il fax. Per richiedere la linea fax da utilizzare ::line=numerolinea oppure l=numerolinea Ad esempio: ::line=1 Il fax viene inviato utilizzando la linea specificata. Tuttavia, se la linea è occupata o non è disponibile, il fax viene inviato usando un'altra linea. Per impostare la linea fax da utilizzare ::dl=numerolinea Ad esempio: ::dl=1 Il fax viene inviato soltanto tramite la linea specificata. Se la linea specificata è occupata, il fax non viene inviato finché la linea non risulta disponibile. In alternativa, è possibile utilizzare anche il seguente metodo: ::line=numerolinea, demandline oppure ::l=numerolinea,dl Ad esempio, ::line=1,dl Per specificare il mittente del messaggio ::fr=nome oppure ::from=nome Ad esempio: ::fr=john Smith Sostituire "nome" con il nome del mittente. Questa opzione è necessaria solo quando si utilizza l'api di testo poiché in GFI FaxMaker non sono disponibili le informazioni sul 4 GFI FaxMaker API di GFI FaxMaker

9 mittente. Se si utilizza questa opzione, il nome del mittente viene incluso sul frontespizio e un report di trasmissione viene inviato al mittente. Per allegare un file al fax ::A=nome file Ad esempio: ::A=brochure.fax oppure ::A=disclaimer.txt "nome file" indica il nome del file da allegare al fax. È possibile allegare più file al fax, specificando ogni allegato come nell'esempio. NOTA: il file da allegare viene prima cercato nella directory dei frontespizi del server fax e poi nella directory delle API di testo. Per specificare più opzioni Quando si specificano più opzioni in un messaggio, è necessario inserirle sulla stessa riga, utilizzando una virgola come separatore. Ad esempio: ::c=cover1,23:15,b=5 In questo esempio viene inviato un fax con "cover1" come frontespizio, programmato per le ore 23:15 e con il codice di fatturazione 5. Figura 2 - Invio di un fax utilizzando più opzioni NOTA 1: prima di utilizzare le opzioni fax, è necessario assicurarsi di aver effettivamente archiviato gli allegati e i frontespizi che si utilizzano. NOTA 2: la differenza tra maiuscole e minuscole non viene tenuta in considerazione. Di conseguenza, è indifferente se il testo viene scritto in lettere maiuscole o minuscole. 1.4 API XML L'API XML si utilizza per impostare in modo esplicito tutti i dati necessari al server fax GFI FaxMaker o all'agente di trasferimento messaggi di GFI FaxMaker per inviare fax e/o messaggi SMS rispettivamente. Come si evince dal nome, l'api XML si basa sull'xml. Un file contenente tutti i dati necessari per la trasmissione del fax e/o del messaggio SMS viene inviato al server fax in un formato di file XML standard. API di GFI FaxMaker GFI FaxMaker 5

10 Utilizzo dell'api XML Figura 1 - Invio di un fax o SMS tramite l'api XML L'invio di un fax a GFI FaxMaker viene eseguito tramite la memorizzazione di un file XML in una cartella. Il percorso della cartella è configurato nel Registro di sistema del computer in cui è installato GFI FaxMaker, sotto la voce "XMLAPI" che si trova sotto la chiave del Registro di sistema "HKLM\Software\GFI FAX & VOICE\FaxMaker\Config". Questa cartella viene periodicamente sottoposta al polling dei file *.xml da FaxMaker e qualsiasi file XML viene utilizzato per la trasmissione di fax o SMS. L'applicazione di terze parti genera un file XML contenente tutte le informazioni richieste per il fax o l'sms. Il file XML è memorizzato nella cartella designata. Viene eseguito il polling della cartella preconfigurata designata e vengono recuperate le informazioni del file XML per l'elaborazione. Le informazioni XML vengono elaborate e il fax o l'sms viene inviato. Figura 2 - Ricezione delle risposte da FaxMaker tramite l'api XML Viene generata una risposta. Il file XML è memorizzato nella cartella designata. 6 GFI FaxMaker API di GFI FaxMaker

11 L'applicazione di terze parti esegue il polling della cartella preconfigurata designata e recupera le informazioni del file XML per l'elaborazione. È necessario che l'applicazione di terze parti esegua il polling della cartella per i file delle risposte. Tali file vengono automaticamente cancellati da GFI FaxMaker trascorsi 10 minuti dall'ultima operazione di scrittura eseguita nel file delle risposte. L'intervallo di tempo è configurabile tramite il valore del Registro di sistema "XMLAPIExpiry" presente sotto la chiave del Registro di sistema "HKLM\Software\GFI FAX & VOICE\Faxmaker\Config". Il valore del campo è espresso in minuti. I messaggi delle risposte vengono salvati con l'estensione.status. NOTA: i nomi file (*.xml e *.status) possono contenere 16 caratteri al massimo e verranno troncati qualora il limite venga superato. 1.5 Specifica *.XML Campi dei messaggi Esempio \faxmakerdata\fields Nodo [una volta] Blocco contenente i dati del fax o del messaggio SMS. NOTA: specificare questo blocco solo una volta nel file XMLAPI. <?xml version="1.0" encoding="utf-8"?> <faxmakerdata> <fields> <subject>this is the subject</subject> <schedule> :15:00</schedule> <priority>high</priority> <billingcode>25</billingcode> <resolution>high</resolution> <coverpage>corporate</coverpage> <frontcovernote>letterhead</frontcovernote> <faxline demandline="true">3</faxline> <faxheader>j. L. Smith</faxheader> <bodyfile type="text/plain">c:\temp\bodyfile.txt</bodyfile> <attachment>c:\temp\document.doc</attachment> <uid>3a5a90s7de3g20k9y4d5e7e6fse28se5e097</uid> </fields> </faxmakerdata> \faxmakerdata\fields\subject Imposta l'oggetto del messaggio. \faxmakerdata\fields\schedule Imposta l'ora di invio del messaggio. La stringa della data deve essere specificata nel formato fisso AAAA-MM-GG-hh:mm:ss. API di GFI FaxMaker GFI FaxMaker 7

12 \faxmakerdata\fields\priority Imposta la priorità del messaggio. I valori validi sono "low", "normal", "high", "veryhigh". \faxmakerdata\fields\billingcode Imposta il codice di fatturazione del mittente del messaggio. \faxmakerdata\fields\resolution Imposta la risoluzione del fax. I valori validi sono "normal", "high". \faxmakerdata\fields\coverpage Imposta il frontespizio da utilizzare per inviare il fax. Può essere un nome di frontespizio specificato nella configurazione dei frontespizi di FaxMaker oppure il nome di un file presente nella cartella FaxMaker\Coverpge. \faxmakerdata\fields\frontcovernote Imposta il frontespizio iniziale da utilizzare per inviare il fax. Può essere un nome di frontespizio iniziale specificato nella configurazione dei frontespizi iniziali di FaxMaker oppure il nome di un file presente nella cartella FaxMaker\Coverpge. \faxmakerdata\fields\faxline Numero Imposta il numero di linea desiderato da utilizzare per inviare il fax. Attributi demandline= true Specificare questo attributo quando si desidera inviare il fax utilizzando esclusivamente la linea specificata. \faxmakerdata\fields\faxheader Imposta le informazioni personali dell'intestazione del fax da utilizzare nel fax. Tali informazioni vengono visualizzate nel testo dell'intestazione o del piè di pagina del fax se è stato selezionato il campo dell'intestazione o del piè di pagina corretto. 8 GFI FaxMaker API di GFI FaxMaker

13 \faxmakerdata\fields\bodyfile Imposta il file da utilizzare come corpo del messaggio. È possibile specificare il file con un percorso completo o semplicemente con un nome file. Nel qual caso il file viene cercato nella stessa cartella o nella cartella FaxMaker\coverpge. NOTA: se il file viene specificato con un percorso completo, viene eliminato con il file XML stesso una volta elaborato. Attributi type= text/html Specificare questo attributo quando si desidera indicare che il testo del corpo del messaggio è in formato XML. type= text/rtf type= text/plain Specificare questo attributo quando si desidera indicare che il testo del corpo del messaggio è in formato RTF. Specificare questo attributo quando si desidera indicare che il testo del corpo del messaggio è in formato testo normale. NOTA: questo attributo costituisce l'impostazione predefinita e quindi non è necessario specificarlo se si è certi che il file del corpo del messaggio è nel formato testo normale. \faxmakerdata\fields\attachment [60 allegati al massimo] Allega il file specificato al messaggio. È possibile specificare il file con un percorso completo o semplicemente con un nome file. Nel qual caso il file viene cercato nella stessa cartella o nella cartella FaxMaker\Coverpge. NOTA 1: se il file viene specificato con un percorso completo, viene eliminato con il file XML stesso una volta elaborato. Tale operazione viene eseguita anche quando il file viene specificato con un nome file e il file è presente nella stessa cartella. NOTA 2: è possibile specificare al massimo 60 allegati. NOTA: \faxmakerdata\fields\attachment o \faxmakerdata\fields\bodyfile è richiesto. \faxmakerdata\fields\uid [255 caratteri al massimo] Specificare un identificatore che viene utilizzato per contrassegnare il messaggio. L'univocità dell'identificatore è stabilita dall'autore del messaggio. Il numero massimo di caratteri è 255. Campi del mittente \faxmakerdata\fields\textapi [più volte] Utilizzato per specificare una singola riga di comandi TextAPI (compreso il prefisso ::). Questo campo può essere specificato più volte. \faxmakerdata\sender Nodo API di GFI FaxMaker GFI FaxMaker 9

14 Esempio Obbligatorio [una volta] Blocco contenente i dettagli personali del mittente. Non specifica il mittente effettivo. NOTA: specificare questo blocco solo una volta nel file XMLAPI. <?xml version="1.0" encoding="utf-8"?> <faxmakerdata> <sender> <firstname>john</firstname> <lastname>smith</lastname> <company>j.s. Holdings</company> <department>sales</department> <faxnumber>+123 (456) 7890</faxnumber> <voicenumber>+123 (456) 0987</voicenumber> < address>jsmith@jsholdings.com</ address> </sender> </faxmakerdata> \faxmakerdata\sender\firstname Imposta il nome del mittente. \faxmakerdata\sender\lastname Imposta il cognome del mittente. \faxmakerdata\sender\company Imposta il nome dell'azienda del mittente. \faxmakerdata\sender\department Imposta l'ufficio del mittente. \faxmakerdata\sender\faxnumber Imposta il numero di fax del mittente. \faxmakerdata\sender\voicenumber 10 GFI FaxMaker API di GFI FaxMaker

15 Imposta il numero di telefono del mittente. Destinatari del fax Esempio \faxmakerdata\sender\ address Obbligatorio Imposta l'indirizzo di posta elettronica del mittente. \faxmakerdata\recipients\fax Nodo [una volta] Blocco contenente i destinatari a cui inviare il fax. NOTA: specificare questo blocco solo una volta nel file XMLAPI. <?xml version="1.0" encoding="utf-8"?> <faxmakerdata> <recipients> <fax> <recipient> <firstname>joe</firstname> <lastname>bloggs</lastname> <company>j.b. Ltd.</company> <department>marketing</department> <faxnumber> </faxnumber> <voicenumber> </voicenumber> < address>jb@jb.com</ address> </recipient> </fax> </recipients> </faxmakerdata> \faxmakerdata\recipients\fax\recipient Nodo Obbligatorio [più volte] Blocco contenente i dettagli personali di un singolo destinatario del fax. \faxmakerdata\recipients\fax\recipient\firstname Imposta il nome del destinatario. \faxmakerdata\recipients\fax\recipient\lastname Imposta il cognome del destinatario. \faxmakerdata\recipients\fax\recipient\company API di GFI FaxMaker GFI FaxMaker 11

16 Imposta il nome dell'azienda del destinatario. \faxmakerdata\recipients\fax\recipient\department Imposta l'ufficio del destinatario. \faxmakerdata\recipients\fax\recipient\faxnumber Obbligatorio Imposta il numero di fax del destinatario. \faxmakerdata\recipients\fax\recipient\voicenumber Imposta il numero di telefono del destinatario. \faxmakerdata\recipients\fax\recipient\ address Imposta l'indirizzo di posta elettronica del destinatario. Destinatari dell'sms Esempio \faxmakerdata\recipients\sms Nodo [una volta] Blocco contenente i destinatari a cui inviare il messaggio SMS. NOTA: specificare questo blocco solo una volta nel file XMLAPI. <?xml version="1.0" encoding="utf-8"?> <faxmakerdata> <recipients> <sms> <recipient> <firstname>joe</firstname> <lastname>bloggs</lastname> <company>j.b. Ltd.</company> <department>marketing</department> <smsnumber> </smsnumber> <voicenumber> </voicenumber> < address>jb@jb.com</ address> </recipient> </sms> </recipients> </faxmakerdata> 12 GFI FaxMaker API di GFI FaxMaker

17 \faxmakerdata\recipients\sms\recipient Nodo Obbligatorio [più volte] Blocco contenente i dettagli personali di un singolo destinatario dell'sms. \faxmakerdata\recipients\sms\recipient\firstname Imposta il nome del destinatario. \faxmakerdata\recipients\sms\recipient\lastname Imposta il cognome del destinatario. \faxmakerdata\recipients\sms\recipient\company Imposta il nome dell'azienda del destinatario. \faxmakerdata\recipients\sms\recipient\department Imposta l'ufficio del destinatario. \faxmakerdata\recipients\sms\recipient\smsnumber Obbligatorio Imposta il numero di SMS del destinatario. \faxmakerdata\recipients\sms\recipient\voicenumber Imposta il numero di telefono del destinatario. \faxmakerdata\recipients\sms\recipient\ address Imposta l'indirizzo di posta elettronica del destinatario. API di GFI FaxMaker GFI FaxMaker 13

18 1.6 Esempio di file XMLAPI Esempio <?xml version="1.0" encoding="utf-8"?> <faxmakerdata> <fields> <subject>this is the subject</subject> <schedule> :15:00</schedule> <priority>high</priority> <billingcode>25</billingcode> <resolution>high</resolution> <coverpage>corporate</coverpage> <frontcovernote>letterhead</frontcovernote> <faxline demandline="true">3</faxline> <faxheader>j. L. Smith</faxheader> <bodyfile type="text/plain">c:\temp\bodyfile.txt</bodyfile> <attachment>c:\temp\document.doc</attachment> <uid>3a5a90s7de3g20k9y4d5e7e6fse28se5e097</uid> </fields> <sender> <firstname>john</firstname> <lastname>smith</lastname> <company>j.s. Holdings</company> <department>sales</department> <faxnumber>+123 (456) 7890</faxnumber> <voicenumber>+123 (456) 0987</voicenumber> </sender> <recipients> <fax> <recipient> <firstname>joe</firstname> <lastname>bloggs</lastname> <company>j.b. Ltd.</company> <department>marketing</department> <faxnumber> </faxnumber> <voicenumber> </voicenumber> </recipient> </fax> <sms> <recipient> <smsnumber> </smsnumber> </recipient> </sms> </recipients> </faxmakerdata> 14 GFI FaxMaker API di GFI FaxMaker

19 1.7 Specifica *.STATUS Campi dei messaggi Esempio <?xml version="1.0" encoding="utf-8"?> <faxmakerdata> <fax> <errorcode>3</errorcode> <description>cannot find attachment</description> <uid>123132</uid> <faxfile>c:\folder\image1.fax</faxfile> <recipient> </recipient> </fax> <fax> <errorcode>0</errorcode> <description>success</description> <uid>123132</uid> <faxfile>c:\folder\image2.fax</faxfile> <recipient> </recipient> </fax> </faxmakerstatus> NOTA: per ogni fax trasmesso viene creato un nodo fax. Se nel file di input era specificato un solo destinatario, un solo nodo fax è presente nel file.status risultante. Se invece sono specificati più destinatari, sarà presente un nodo fax per ciascun destinatario. Campo errorcode numerico obbligatorio Se la trasmissione è stata completata regolarmente il campo contiene il valore zero, in caso contrario contiene un codice di errore. Utilizzare questo campo insieme al campo della descrizione per determinare la causa del problema. Campo description stringa obbligatorio Contiene il report di trasmissione per le trasmissioni con esito positivo o negativo. Campo Uid stringa facoltativo Se il file di input XMLAPI conteneva il campo uid, in questo campo viene specificato lo stesso valore. Fare riferimento a [1] per ulteriori informazioni sul campo uid. Campo Faxfile stringa facoltativo Contiene il percorso completo del file immagine del fax. API di GFI FaxMaker GFI FaxMaker 15

20 Campo recipient stringa facoltativo Contiene il numero di fax a cui è stato inviato il fax. 16 GFI FaxMaker API di GFI FaxMaker

21 2 Risoluzione dei problemi 2.1 Introduzione In questo capitolo viene illustrato come risolvere i problemi che si potrebbero verificare utilizzando il software. Le principali fonti di informazioni disponibili per gli utenti sono:» Il presente manuale. La maggior parte dei problemi può essere risolta leggendo il manuale.» Articoli della Knowledge Base di GFI.» Forum Web.» Supporto tecnico GFI. 2.2 Knowledge Base GFI gestisce una Knowledge Base in cui sono incluse le risposte ai problemi più comuni. Se si verifica un problema è opportuno consultare prima la Knowledge Base. La Knowledge Base contiene sempre l'elenco più aggiornato delle domande e delle correzioni fornite dal supporto tecnico. Per accedere alla Knowledge Base, visitare il sito (in inglese). 2.3 Forum Web Nel forum Web è disponibile il supporto tecnico da utente a utente. Il forum è disponibile all'indirizzo Richiesta di supporto tecnico Se dopo aver letto il presente manuale e consultato gli articoli della Knowledge Base ancora non sono stati risolti i problemi relativi al software, è possibile contattare il team del supporto tecnico di GFI compilando un modulo di richiesta di supporto in linea o per telefono. In linea: compilare il modulo di richiesta supporto disponibile all'indirizzo Seguire rigorosamente le istruzioni indicate nella pagina per inviare la richiesta di supporto. Telefono: per trovare il numero di telefono del supporto tecnico corretto per il proprio paese, visitare il sito NOTA: per contattare il team del supporto tecnico è necessario disporre dell'id cliente. L'ID cliente è il numero di account in linea che è stato assegnato quando i codici di licenza sono stati registrati per la prima volta nell'area clienti all'indirizzo Il team risponderà alla richiesta entro 24 ore al massimo, a seconda del fuso orario. 2.5 Notifiche sulle build Si raccomanda vivamente di sottoscrivere l'elenco delle notifiche sulle build. In tal modo si riceverà prontamente una notifica sulle nuove build di prodotto. Per sottoscrivere le notifiche sulle build, visitare il sito Risoluzione dei problemi GFI FaxMaker 17

22

23 Indice A API, 1, 4, 5 D Destinatari del fax, 11 Destinatari dell'sms, 12 E Esempio di file XMLAPI, 14 R Risoluzione dei problemi, 17 S Specifica *.STATUS, 15 Specifica *.XML, 7 T Text API, 1, 5 F Frontespizio iniziale, 3 GFI FaxMaker Indice 19

24

25 USA, CANADA, CENTRAL AND SOUTH AMERICA Weston Parkway, Suite 104, Cary, NC 27513, USA Telephone: +1 (888) Fax: +1 (919) UK AND REPUBLIC OF IRELAND Magna House, London Road, Staines, Middlesex, TW18 4BP, UK Telephone: +44 (0) Fax: +44 (0) EUROPE, MIDDLE EAST AND AFRICA GFI House, San Andrea Street, San Gwann, SGN 1612, Malta Telephone: Fax: AUSTRALIA AND NEW ZEALAND 83 King William Road, Unley 5061, South Australia Telephone: Fax: sales@gfiap.com