# Automation Overview

https://docs.wisecp.com/fr/automation-overview

The Overview tab answers two questions at a glance: is scheduled work running at all, and is any single task in trouble.

## Opening the Screen

Panel menu: **Settings** then **Automation**: `{admin}/automation`

The screen opens on the **Overview** tab. To land on it directly: `{admin}/automation?tab=dashboard`

Staff without the automation right see an access message, and the menu entry is missing for them.

## What Is on the Screen

A status bar and a warning line sit above the tab strip and stay in place on all three tabs. The tab itself holds the task list.

- **Status bar**: Whether automation is running, when it last ran, and the main on/off switch.
- **Warning line**: One line, and only when something needs your decision.
- **Tasks**: Every scheduled task, grouped by how often it runs.

The numbers refresh by themselves every few seconds while the tab is open.

### The status bar

The headline names the current state: **Automation is running** when the last round was under three minutes ago, **Automation is falling behind** up to ten minutes, **Automation is critically behind** up to an hour, and **Automation is not responding** beyond that. On a new installation it says **Automation has never run**.

**Last Run** is the moment the server last called WISECP. **Upcoming Job** counts down to the next scheduled task, skipping the ones that run every minute. Both appear only while automation is on and the system has run at least once. A clock chip appears while you are outside the processing time range.

On the right sit **Run Self-Test** and the main switch. While the switch is off, the bar names who turned it off and when, how many jobs are waiting, and offers **Re-enable Now**.

### The warning line

It stays hidden until one of three things is true, and the first match wins.

- Automation has never run: **Open Setup** takes you to the crontab command.
- It ran before but has been silent over an hour: **Check Setup** goes to the same place.
- Failed jobs are piling up: **Inspect** narrows the task list to the failing tasks.

### The task list

The toolbar carries the task count, a search box and four filters: **All**, **Issues**, **Queued** and **Disabled**.

Rows are grouped by rhythm: **Every minute**, **Hourly**, **Daily**, **Monthly** and **Manual**. Each group header counts what it holds, plus how many are failing or switched off. Tasks with nothing to look at fold away behind a **Show** line, so only the rows that want attention stay open.

### A task row

The name is followed by **Last run** or **Never ran**. A clock icon marks a task bound to the processing time range, and an information icon holds its description.

A healthy task carries no badge. **Has Errors**, **Running**, a pending count, **Disabled** or **Unregistered** appear only when they apply. **Unregistered** means the task is defined but nothing runs it.

Then come two numbers, **Today** (finished today) and **Queued**, and **Next**, which reads **Due now**, **Overdue** or a countdown. When automation has been quiet for over ten minutes, **Next** reads **—** on every row. The system cannot work out the next moment.

Clicking the task name opens that task's job list in its own window, and so do the **Today** and **Queued** numbers. The window carries a search box, stage and status filters, multi-select and a **Delete Selected** button.

## Fields

- **Search tasks**: Filters by task name, technical name and description. It also opens the folded groups so a match inside one is visible.
- **All / Issues / Queued / Disabled**: Narrows the list. **All** is selected when you arrive.
- **Main switch**: On by default. Switching it takes effect at once, with no confirmation step.

## Tasks

### Find the task behind a failure

1. Click **Inspect** on the warning line, or the **Issues** filter in the task toolbar.
2. The list keeps only the tasks with failed jobs. Most carry a **Has Errors** badge; a task you switched off shows **Disabled** instead, even when it has failed jobs.
3. Click **Has Errors** to open that task's failed jobs, where you can read the error and retry a job. For a task that is switched off, click its name instead.

### Run a task now

1. Find the row and click the play button at its right end.
2. The task is queued immediately, without waiting for its schedule.
3. Watch **Queued** and **Today** on the row: the job is picked up within about a minute.

### Switch one task off or back on

1. Click the pause button at the right end of the row.
2. The row turns **Disabled** at once. No new work is planned, but jobs already queued are still picked up. To stop those too, delete them or switch the main switch off.
3. The same button, now a play icon, brings the task back from its next round on.

### Stop or restart all automation

1. Switch off the toggle at the right of the status bar.
2. The bar turns to **Cron System Disabled** and names you as the person who did it.
3. Click **Re-enable Now** to start again. Waiting jobs are processed from the next round.

### Check that the server reaches WISECP

1. Click **Run Self-Test** in the status bar.
2. Your browser calls the cron address and a result window opens.
3. **Cron system is healthy** means the call arrived. The window also shows jobs processed, how long the round took and the worker identity.

## Things to Watch

> **The main switch stops the whole product, not only this screen**
> 
> With it off, no invoice is created, no overdue service is suspended and no notification leaves. Waiting jobs are not lost, but nothing moves until you switch it back on.

> **Run and pause act at once, with no confirmation**
> 
> Nothing catches up on the missed rounds when you switch a task back on. It resumes from the next round.

> **Bulk delete in the job list is permanent**
> 
> The jobs you tick in the task window are removed from the queue by **Delete Selected**. There is no confirmation window, only a second click on the same button.

> **Self-Test really runs a round**
> 
> It is not a dry check. The call processes whatever is waiting in the queue, so the numbers you see afterwards are real work that has been done.

## Required Privileges

The whole screen, including every action on it, needs `AUTOMATION_SETTINGS`.

## Related Articles

- [Automation Activity](https://docs.wisecp.com/en/automation-activity)
- [Automation Settings](https://docs.wisecp.com/en/automation-settings)
- [Module Queue](https://docs.wisecp.com/en/module-action-queue)
- [Notification Queue](https://docs.wisecp.com/en/notification-delivery-queue)
