Azioni della Traylet

Introduzione

Le azioni della traylet specificano cosa deve succedere quando l'utente usa il menù contestuale, clicca sul fumetto o sull'icona oppure semplicemente quando la traylet interroga il server.
Le azioni vengono listate in una serie di nodi contenuti nel nodo "actions" figlio diretto del nodo "traylet". Il nome del nodo rappresenta il nome dell'azione, mentre l'attributo "type" rappresenta il tipo di azione. I tipi oggi conosciuti sono i seguenti:

• tlexit: chiude la Traylet, dopo aver segnalato al server l'evento di Stop.
• tlcancel: interrompe eventuali trasferimenti di file in corso.
• tlrefresh: esegue un refresh, interrogando il server.
• tlproperty: mostra all'utente la videata delle proprietà della Traylet.
• tlrestart: riavvia la Traylet.
• tlmessage: mostra un messagebox all'utente.
• tlbrowser: apre una finestra browser.
• tlwidget: apre la widget, per maggiori informazioni vedi anche l'articolo Componenti di una Traylet.
• tlcommand: invia un comando URL ad un server web.
• tldir: legge il contenuto di una directory e lo invia al server.
• tlcontacts: invia i contatti di Outlook al server.
• tlcalendar: invia gli appuntamenti di Outlook al server.
• tltasks: invia i compiti di Outlook al server.
• tlnotes: invia le note di Outlook al server.
• tlmail: invia le mail di Outlook al server.

Tutti le azioni inoltre possono avere l'attributo "notify"; se impostato a vero, allora dopo l'esecuzione dell'azione il server web viene informato tramite un 'opportuna chiamata di refresh e notifica.
Vediamo adesso quali parametri sono ammessi per ognuna delle azioni precedenti.

tlrefresh

Questa azione esegue un refresh sul server web, passando però anche i parametri specificati nell'attributo "url".

tlrestart

Questa azione riavvia la Traylet. Se l'attributo "fullscreen" è impostato a vero, allora viene mostrata la finestra di avvio della Traylet; impostando anche l'attributo "text" sarà possibile visualizzare un messaggio all'interno della finestra di avvio. Questo comando può essere utile, ad esempio, per mostrare un messaggio all'utente se lo username e password non sono stati riconosciuti.

tlmessage

Questa azione mostra un messagebox all'utente, utilizzando i seguenti attributi:

• text: testo del messaggio.
• title: titolo della messagebox.
• icon: icona della messagebox. Può valere error, warning o info.

tlbrowser

Apre una nuova finestra browser, utilizzando i seguenti attributi:

• url: indirizzo web da aprire nella finestra browser, compreso di query string.
• fullscreen: apre il browser a tutto schermo.

tlcommand

Esegue una chiamata GET ad un server web, anche diverso dal server a cui la Traylet è collegata. L'attributo "url" specifica l'indirizzo web da chiamare.

tldir

Legge la struttura di una directory sul PC dell'utente e la invia al server in formato XML. Gli attributi utilizzati sono i seguenti:

• srcdir: la directory da leggere. Se vale "desktop" oppure "documents" vengono lette le relative directory speciali dell'utente.
• ext: lista delle estesioni di file che interessano, separate da punto e virgola. Se non specificato, allora verranno letti tutti i tipi di files, se uguale a punto, allora verranno lette solo le directories.
• max: numero massimo di files da leggere. Se non viene specificato verranno letti tutti i files trovati.
• from: se si vuole sapere solo i files modificati dopo una certa data, è sufficente indicarla nell'attributo from, compresa di ore e minuti. Il formato della data è "yyyy-MM-dd HH:mm:ss".

Il file XML viene inviato al server tramite una chiamata POST, e può essere recuperato dal campo "result" tramite la funzione GetSettings di Instant Developer. Ha la seguente struttura:

Per ogni directory viene creato un nodo "directory" con i seguenti attributi:

• name: nome della directory.
• attributes: attributi.

Un nodo "directory" può contenere altri nodi "directory", oppure nodi "file".

Per ogni file che soddisfa i criteri viene creato un nodo "file" con i seguenti attributi:

• name: nome del file.
• attributes: attributi.
• size: dimensione in bytes.
• modified: data di ultima modifica.

tlcontacts

Legge l'elenco dei contatti di Outlook sulla macchina locale. Utilizza l'attributo "restrict" come stringa di filtro sui contatti da leggere; in questo modo è possibile, ad esempio, leggere solo i contatti pubblici e saltare quelli privati, oppure ricevere solo i contatti modificati a partire da una certa data. Il formato di questa stringa è specifico di Outlook, rimandiamo quindi alla documentazione di Outlook per maggiori informazioni.

I contatti letti vengono formattati in un file XML che viene inviato al server tramite una chiamata POST e che può essere recuperato dal campo "result" tramite la funzione GetSettings di Instant Developer. Questo file ha la seguente struttura: il nodo radice si chiama "contacts"; per ogni contatto viene inserito un nodo figlio chiamato "contact" che include come attributi tutte le informazioni non vuote del contatto. Per conoscere i nomi delle proprietà del contatto vi rimandiamo alla documentazione di Outlook.

tlcalendar

Legge l'elenco degli appuntamenti di Outlook sulla macchina locale. Utilizza l'attributo "restrict" come stringa di filtro sugli appuntamenti da leggere; in questo modo è possibile, ad esempio, leggere solo quelli pubblici e saltare quelli privati, oppure ricevere solo gli appuntamenti modificati a partire da una certa data. Il formato di questa stringa è specifico di Outlook, rimandiamo quindi alla documentazione di Outlook per maggiori informazioni.

Gli appuntamenti letti vengono formattati in un file XML che viene inviato al server tramite una chiamata POST e che può essere recuperato dal campo "result" tramite la funzione GetSettings di Instant Developer. Questo file ha la seguente struttura: il nodo radice si chiama "calendar"; per ogni appuntamento viene inserito un nodo figlio chiamato "appointment" che include come attributi tutte le informazioni non vuote dell'appuntamento. Per conoscere i nomi delle proprietà dell'appuntamento vi rimandiamo alla documentazione di Outlook.

tltasks

Legge l'elenco dei task di Outlook sulla macchina locale. Utilizza l'attributo "restrict" come stringa di filtro sui task da leggere; in questo modo è possibile, ad esempio, leggere solo quelli pubblici e saltare quelli privati, oppure ricevere solo i task modificati a partire da una certa data. Il formato di questa stringa è specifico di Outlook, rimandiamo quindi alla documentazione di Outlook per maggiori informazioni.

I compiti letti vengono formattati in un file XML che viene inviato al server tramite una chiamata POST e che può essere recuperato dal campo "result" tramite la funzione GetSettings di Instant Developer. Questo file ha la seguente struttura: il nodo radice si chiama "tasks"; per ogni task viene inserito un nodo figlio chiamato "task" che include come attributi tutte le informazioni non vuote del compito. Per conoscere i nomi delle proprietà dell'appuntamento vi rimandiamo alla documentazione di Outlook.

tlnotes

Legge l'elenco delle note di Outlook sulla macchina locale. Utilizza l'attributo "restrict" come stringa di filtro sulle note da leggere; in questo modo è possibile, ad esempio, leggere solo quelle pubbliche e saltare quelle private, oppure ricevere solo le note modificate a partire da una certa data. Il formato di questa stringa è specifico di Outlook, rimandiamo quindi alla documentazione di Outlook per maggiori informazioni.

Le note lette vengono formattate in un file XML che viene inviato al server tramite una chiamata POST e che può essere recuperato dal campo "result" tramite la funzione GetSettings di Instant Developer. Questo file ha la seguente struttura: il nodo radice si chiama "notes"; per ogni nota viene inserito un nodo figlio chiamato "note" che include come attributi tutte le informazioni non vuote della nota. Per conoscere i nomi delle proprietà di una nota vi rimandiamo alla documentazione di Outlook.

tlmail

Legge l'elenco delle mail di Outlook sulla macchina locale. Utilizza l'attributo "restrict" come stringa di filtro sulle mail da leggere; in questo modo è possibile, ad esempio, leggere solo quelle pubbliche e saltare quelle private, oppure ricevere solo le mail inviate o ricevute a partire da una certa data. Il formato di questa stringa è specifico di Outlook, rimandiamo quindi alla documentazione di Outlook per maggiori informazioni. Inoltre viene utilizzato anche l'attributo "srcdir": se vale "inbox" allora vengono lette le mail in ingresso, altrimenti quelle in uscita.

Nota: si consiglia di utilizzare l'attributo restrict per essere certi di leggere solo poche mail, in quanto ogni mail può essere anche molto corposa ed il file complessivo molto grande.

Le mail lette vengono formattate in un file XML che viene inviato al server tramite una chiamata POST e che può essere recuperato dal campo "result" tramite la funzione GetSettings di Instant Developer. Questo file ha la seguente struttura: il nodo radice si chiama "mailfolder"; per ogni mail viene inserito un nodo figlio chiamato "mailmessage" che include come attributi tutte le informazioni non vuote della mail. Per conoscere i nomi delle proprietà di una mail vi rimandiamo alla documentazione di Outlook.