# Gnome Schedule User Guide V2.2

## Introduktion

Gnome-schemaläggaren är ett grafiskt verktyg som låter dig schemalägga uppgifter på ett enkelt sätt, för att köras utan assistans vid en angiven tid eller periodvis. Dessa uppgifter, även kända som jobb, kan antingen vara ett kommando med dess motsvarande parametrar eller en skriptfil med flera instruktioner.

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.

### Hur fungerar Gnome-schemaläggaren?

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.

### Om cron och at

Cron

Om du skulle konfigurera cron manuellt till att köra ett kommando, till exempel varje tisdag, skulle du använda kommandot `crontab` på det här sättet:

    $ crontab -e
    * * * * 2 <kommando> --parameters  #kommentarer

Se `man cron` och `man crontab` för mer information om cron

At

Om du skulle konfigurera at manuellt till att köra ett kommando, till exempel imorgon vid den här tiden, skulle du använda kommandot `at` på det här sättet:

    $ at tomorrow
    at> <kommando_1> --parameters
    at> <kommando_2> --parameters
    at> Ctrl + D

Se `man at` för mer information om at

## Komma igång

### Starta Gnome-schemaläggaren

You can start Gnome Schedule in the following ways:

Menyn Program

- Välj Systemverktyg Schema.

Kommandorad

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

  `gnome-schedule`

### När du startar Gnome-schemaläggaren

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

#### Main Window

Shows Gnome-schemaläggaren main window. Contains title bar, tool bar, and task list.

Huvudfönstret i Gnome-schemaläggare innehåller följande element:

The tool bar.

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

Uppgiftslista.

- Uppgiftslistan visar information om för närvarande schemalagda uppgifter och väntande jobb. För varje uppgift visas följande information:

  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:

- Visar när uppgiften kommer att köras.

Command preview:

- Visar kommandot som kommer att köras.

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.

## Lägg till en ny schemalagd uppgift

### 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.

Följande dialogruta kommer att visas för att låta dig välja typ av uppgift som du vill schemalägga:

#### Dialogrutan för val av uppgiftstyp

Visar Gnome-schemaläggaren dialogrutan för val av uppgiftstyp.

- 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 myapp-templates.

### Lägg till en schemalagd uppgift med återkommande körningar

Välj det här alternativet och följande dialogruta kommer att visas:

#### "Skapa en ny schemalagd uppgift"-fönstret

Visar Gnome-schemaläggaren "Skapa en ny schemalagd uppgift"-fönstret.

Beskrivning

- Låter dig lägga till en kort beskrivning av uppgiften.

Kommando

- 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.

### Lägg till en schemalagd uppgift som kommer att köras en gång

Välj det här alternativet och följande dialogruta kommer att visas:

#### "Skapa en ny schemalagd uppgift"-fönstret

Visar Gnome-schemaläggaren "Skapa en ny schemalagd uppgift"-fönstret

## Ändra en schemalagd uppgift

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.

## Ta bort en schemalagd uppgift

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!

## Använda Gnome-schemaläggare som root

När du använder Gnome-schemaläggare som superanvändaren, kan du visa, redigera och lägga till andra användares schemalagda uppgifter.

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.

## Använda Gnome-schemaläggare för att starta grafiska program

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

### Om miljövariabeln DISPLAY

När du kör ett grafiskt program från kommandoraden måste du först ställa in miljövariabeln DISPLAY. Den här variabeln används för att berätta för ditt grafiska program vilken X-server som ska användas. Vanligtvis vill du använda den som är installerad på din egna dator. I det fallet behöver du ställa in DISPLAY-variabeln på det här sättet:

`DISPLAY=:0.0`

där :0.0 betyder, använd skärm 0 för X server 0 på den här datorn.

Om du vill visa programmet på en fjärrskärm kan du ange IP-adressen för fjärr-X-servern:

`DISPLAY=192.168.0.25:0.0`

### Ställ in variabeln DISPLAY för uppgifter som kommer att köras en gång

När du skapar eller ändrar en uppgift, kan du definiera variabeln DISPLAY i skriptrutan. Ange definitionen i början av skriptet.

### Ställ in variabeln DISPLAY för uppgifter som kommer att köras återkommande

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.

### Om X-server

X-servern är en del av X Window System. Den är ansvarig för att rita ut fönster på skärmen och behandla användardata från ett tangentbord eller annan kringutrustning.

Om du behöver mer information om X-server eller X Window System kan du läsa på denna sidan hos Wikipedia.

## Om Gnome-schemaläggaren

### Upphovsmän

Gnome-schemaläggare skrevs av Philip Van Hoof (pvanhoof@gnome.org), Kristof Vansant (de_lupus at pandora dot be) och Gaute Hope (eg@gaute.vetsj.com). För att hitta mer information om Gnome-schemaläggare, besök Gnome-schemaläggarens webbsida.

### Rapportera fel

För att rapportera ett fel eller föreslå någonting angående det här programmet eller den här handboken, följ anvisningarna i det här dokumentet.

### Licens

Det här programmet distribueras under villkoren för GNU General Public License som publicerats av Free Software Foundation; antingen version 2 av licensen, eller (upp till dig) någon senare version. En kopia av den här licensen kan hittas på den här länken, eller i filen COPYING som inkluderas med källkoden för det här programmet.