# Gnome Schedule User Guide V2.2

Guida utente per l'applicazione Gnome Schedule

2005-2008
Rodrigo Marcos Fombellida rmarcos@svn.gnome.org
2006
Andrea Zagli (azagli@inwind.it)
Progetto di documentazione di GNOME

Questo documento può essere copiato, distribuito e/o modificato solo in conformità con i termini della GNU Free Documentation License (GFDL) Versione 1.1 o delle versioni successive pubblicate dalla Free Software Foundation senza sezioni invariabili, frontespizi e testi di copertina. Una copia della GFDL è disponibile su questo collegamento o nel file COPYING-DOCS distribuito con questo manuale.

Questo manuale fa parte di una raccolta di manuali GNOME distribuita in conformità con la GFDL. Per poter distribuire questo manuale separatamente, è necessario inserirvi una copia della licenza, come descritto nella sezione 6 della licenza.

Molti dei nomi usati dalle aziende per distinguere i propri prodotti e servizi sono rivendicati come marchi. Quando questi nomicompaiono nella documentazione di GNOME, e i partecipanti al GNOME Documentation Project sono consapevoli del loro utilizzo, essi vengono scritti in lettere maiuscole o con l'iniziale maiuscola.

QUESTO DOCUMENTO E LE SUE VERSIONI MODIFICATE VENGONO FORNITI IN BASE AI TERMINI DELLA GNU FREE DOCUMENTATION LICENSE, CON L'INTESA CHE:

1. IL DOCUMENTO VIENE FORNITO SENZA GARANZIE DI ALCUN TIPO, ESPLICITE O IMPLICITE, INCLUSE, MA SENZA LIMITAZIONE, LE GARANZIE ATTESTANTI CHE IL DOCUMENTO O LE SUE VERSIONI MODIFICATE SIANO PRIVI DI DIFETTI, COMMERCIALIZZABILI, IDONEI A UN DETERMINATO SCOPO O CHE NON VIOLINO DIRITTI DI TERZI. SI DECLINA QUALUNQUE RESPONSABILITÀ RIGUARDO AI RISCHI INERENTI LA QUALITÀ, L'ACCURATEZZA E LE PRESTAZIONI DEL DOCUMENTO O DI UNA SUA VERSIONE MODIFICATA. QUALORA UN DOCUMENTO O UNA SUA VERSIONE MODIFICATA DOVESSERO PRESENTARE QUALUNQUE TIPO DI DIFETTO,IL COSTO DI EVENTUALI INTERVENTI DI ASSISTENZA, RIPARAZIONE O CORREZIONE SARÀ A CARICO DELL'UTENTE (NON DEL REDATTORE INIZIALE, DELL'AUTORE O DI ALTRI COLLABORATORI). QUESTA LIMITAZIONE DELLA GARANZIA COSTITUISCE PARTE ESSENZIALE DELLA LICENZA. L'USO DEL DOCUMENTO O DELLE SUE VERSIONI MODIFICATE È CONSENTITO SOLO ENTRO I TERMINI DI QUESTA LIMITAZIONE DELLA GARANZIA; E

2. IN NESSUNA CIRCOSTANZA E PER NESSUNA RAGIONE LEGALE, INCLUSI I PRINCIPI DI COLPA (INCLUSA LA NEGLIGENZA), ACCORDO CONTRATTUALE O ALTRO, SARÀ POSSIBILE CONSIDERARE L'AUTORE, IL REDATTORE INIZIALE, GLI ALTRI COLLABORATORI, QUALUNQUE DISTRIBUTORE DEL DOCUMENTO O DI UNA SUA VERSIONE MODIFICATA O QUALUNQUE FORNITORE DELLE PERSONE CITATE, RESPONSABILE NEI CONFRONTI DI QUALUNQUE PERSONA PER DANNI DIRETTI, INDIRETTI, SPECIALI, INCIDENTALI O CONSEGUENTI DI QUALUNQUE NATURA, INCLUSI, MA SENZA LIMITAZIONE, I DANNI PER PERDITA DI AVVIAMENTO, INTERRUZIONE DEL LAVORO, GUASTO O MALFUNZIONAMENTO DEL COMPUTER O QUALUNQUE ALTRO DANNO O PERDITA DERIVANTE O CORRELATA ALL'USO DEL DOCUMENTO O DI UNA SUA VERSIONE MODIFICATA, ANCHE QUALORA LE PERSONE CITATE FOSSERO STATE INFORMATE DELLA POSSIBILITÀ DI TALI DANNI.

Rodrigo
Marcos Fombellida
Progetto di documentazione di GNOME

     rmarcos@svn.gnome.org

Guida utente di Gnome Schedule V2.0
Agosto 2005

Rodrigo Marcos Fombellida rmarcos@cvs.gnome.org

Progetto di documentazione di GNOME

Gnome Schedule User Guide V2.1
June 2006

Rodrigo Marcos Fombellida rmarcos@cvs.gnome.org

Progetto di documentazione di GNOME

Gnome Schedule User Guide V2.2
January 2008

Rodrigo Marcos Fombellida rmarcos@svn.gnome.org

Progetto di documentazione di GNOME

This manual describes version 2.0.0 of Gnome Schedule.

## Riscontri

Per segnalare un errore o inviare un suggerimento riguardo l'applicazione Gnome Schedule o questo manuale, seguire le indicazioni nella Pagina dei riscontri GNOME.

## Introduzione

Gnome Schedule è uno strumento grafico che permette con facilità la pianificazione di operazioni, senza l'intervento della persona, a un'ora specificata o periodicamente. Queste operazioni, conosciute anche come lavori, possono essere sia un comando con i relativi parametri che un file script con istruzioni multiple.

You can use Gnome Schedule to program repetitive tasks in your daily work that can be automated. You can also run a heavy task at night while you are sleeping, for example, backing up your documents.

### Come funziona Gnome Schedule?

Gnome Schedule uses cron and at to program job executions. These are two system services commonly used by Linux-like systems. Gnome Schedule provides a single graphical interface to configure both and present jobs in a way easy to understand for everyone.

### Informazioni su cron e at

Cron

If you were to configure cron manually to execute a command, for example every Tuesday, you would have to use the command `crontab` in this way:

    $ crontab -e
    * * * * 2 <command> --parameters  #comments

Vedere `man cron` e `man crontab` per maggiori informazioni su cron

At

If you were to configure at manually to execute a command, for example tomorrow at this time, you would have to use the command `at` in this way:

    $ at tomorrow
    at> <command_1> --parameters
    at> <command_2> --parameters
    at> Ctrl + D

Vedere `man at` per maggiori informazioni su at

## Per iniziare

### Per avviare Gnome Schedule

You can start Gnome Schedule in the following ways:

Menù Applicazioni

  Scegliere Strumenti di sistema Pianifica.

Linea di comando

  To start Gnome Schedule from a command line, type the following command, then press Return:

  `gnome-schedule`

### Quando si avvia Gnome Schedule

When you start Gnome Schedule, the main window is displayed:

#### Main Window

Shows Gnome Schedule main window. Contains title bar, tool bar, and task list.

La finestra principale di Gnome Schedule contiene i seguenti elementi:

The tool bar.

  The tool bar contains buttons that give you access to every function in the application.

Elenco operazioni pianificate.

  L'elenco delle operazioni mostra informazioni sulle operazioni pianificate e sui lavori pendenti. Per ogni operazione sono dettagliate le seguenti informazioni:

  Task:

    Describes the type of the task: "Recurrent", when the task runs repeatedly or "Once", when the task is done only once.

  Description:

    Shows a brief description of the task.

  Date and Time:

    Mostra quando l'operazione pianificata verrà eseguita.

  Command preview:

    Mostra il comando che verrà eseguito.

You can read a brief description of some of the objects and icons on the Gnome Schedule interface, by pointing them with the mouse and waiting for a few seconds.

## Aggiungere una nuova operazione pianificata

### Choosing the type of task to add

You can add a new scheduled task by pressing the New button in the main window tool bar.

Apparirà La seguente finestra di dialogo che permette di scegliere il tipo di operazione che si vuole pianificare:

#### Finestra di dialogo selezione tipo di operazione

Mostra Gnome Schedule la finestra di dialogo per la selezione del tipo di operazione.

- by pressing the first button you will be able to schedule a task that will be executed periodically.

- by pressing the second button you will be able to schedule a task that will only be executed once.

- by pressing the third button you will be able to create a task from a template. Templates usage is explained in .

### Aggiungere una operazione pianificata da eseguire ricorrentemente

Scegliendo questa opzione, verrà mostrata la seguente finestra di dialogo:

#### Finestra «Crea una nuova operazione pianificata»

Mostra Gnome Schedule la finestra «Crea una nuova operazione pianificata».

Descrizione

  Permette di aggiungere una breve descrizione dell'operazione.

Comando

  Enter here the command or script that will be periodically executed by this task.

Time & Date

Basic

  Lets you select the frequency for task execution among a list of common intervals.

Advanced

  Lets you create custom time expressions in case you need more flexibility.

Preview

Lets the user check if the selected frequency is correct.

### Aggiungere un'operazione pianificata che verrà eseguita una volta sola

Scegliendo questa opzione verrà mostrata la seguente finestra di dialogo:

#### Finestra «Crea una nuova operazione pianificata»

Mostra Gnome Schedule la finestra «Crea una nuova operazione pianificata»

## Modificare un'operazione pianificata

You can modify a scheduled task by selecting it from the Task list with one click and by pressing the Edit button from the main window tool bar. Then, the Edit a Scheduled Task window will be opened showing the task properties.

Now, you will be able to modify any field you want. When you have finished you can press Apply button to save the changes or Cancel button to omit them.

You can edit a task faster by simply double-clicking on it in the task list.

## Eliminare un'operazione pianificata

You can delete a scheduled task by selecting it from the Task list with one click and by pressing the Delete button in the main window tool bar. Next, you will be asked for confirmation. By answering Yes, the scheduled task will be removed from the Task list.

Non-recurrent tasks disapear automatically from the list when they are done.

## Manually Running Scheduled Task

You can trigger a scheduled task by selecting it from the Task list with one click and by pressing the Run task button in the main window tool bar.

The task will be executed and its output will be displayed in a terminal window, letting you check if the task is correctly set.

## Using Templates

Gnome Schedule lets you save tasks as templates in order to reuse it later. This way, you will be able to create new scheduled tasks faster.

To manage templates press the Template button on the main window tool bar. A new window will show you a list of available templates. From this window you can create, modify, delete and use templates.

### Template manager window

Shows the "Manage templates" window

You can have common tasks saved as templates. So, you will not have to write the same stuff again and again!

## Utilizzare Gnome Schedule come utente root

Quando si usa Gnome Schedule come superutente, si possono vedere, modificare o aggiungere operazioni pianificate di altri utenti.

You can change the user by pressing the Change User button in the main window tool bar. Then, a dialog window will be shown. Choose the desired user from the drop-down list and press OK button. Now the main window will show the scheduled tasks of the selected user.

Please, keep in mind that this option is only available for system administrators.

## Using Gnome Schedule to launch graphical applications

You can use Gnome Schedule to launch a graphical application automatically, but there are some information you would consider before:

### About DISPLAY environment variable

When you run a graphical application from the command line you must first set the environment variable DISPLAY. This variable is used to tell your graphical application what X server to use. Normally you will want to use the one installed on your own computer. In that case you need to set the DISPLAY variable in this way:

`DISPLAY=:0.0`

where :0.0 means use screen 0 of X server 0 in this computer.

If you want display the application in a remote screen you can specify the IP address of the remote X server:

`DISPLAY=192.168.0.25:0.0`

### Setting DISPLAY variable for tasks that will launch once

When you are creating or modifying a task, you can define the DISPLAY variable in the script text box. Make the definition at the begining of the script.

### Setting DISPLAY variable for tasks that will launch recurrently

Gnome Schedule does not support yet setting environment variables for recurrent tasks, but it will do soon. In the meantime, you can manually create a script that first defines DISPLAY variable and then calls the graphical application. Finally, you can create a recurrent task to launch the script.

### About X server

The X server is part of the X Window System. It is in charge of drawing windows on the screen and processing the user input from a keyboard or any other peripheral.

If you need more information about X server or the X Window System you can read its entry in the Wikipedia.

## Informazioni su Gnome Schedule

### Autori

Gnome Schedule è stato scritto da Philip Van Hoof (pvanhoof@gnome.org), Kristof Vansant (de_lupus at pandora dot be) e Gaute Hope (eg@gaute.vetsj.com). Per trovare maggiori informazioni circa Gnome Schedule, visitare la pagina web di Gnome Schedule.

### Segnalare errori

Per segnalare un errore o inviare un suggerimento riguardo a questa applicazione o questo manuale, seguire le indicazioni in questo documento.

### Licenza

Questo programma è distribuito secondo i termini della GNU General Public license come pubblicata dalla Free Software Foundation; sia la versione 2 di questa licenza, che (secondo la proprio scelta) ogni altre versione successiva. Una copia di questa licenza può essere trovata a questo collegamento, oppure nel file COPYING incluso con il codice sorgente di questo programma.