Skip to content
This page was translated from the Traditional Chinese original and has not yet been reviewed by a person. If anything is unclear, the Chinese version is authoritative.

Viewing: HTML | Download the E-Paper Content Management System manual as PDF

Task List ​

Where: sidebar → Content Management → Task List

Every time an image is sent to one device to display, that is one "task". This page lists the tasks of all devices and their progress, including images sent by hand and images sent automatically by schedules. The list refreshes automatically; you do not need to reload the page.

Only Platform Administrators and System Operators see this page.

Filtering tasks ​

The filter area above the list can combine the conditions below. Click "Search Tasks" to apply them and "Clear Filters" to clear them.

ConditionDescription
"Device"Type part of a device name, or choose one from the drop-down
"State"Choose one task state; see Task states
"Created At"Choose a start and end date to list tasks created in that period (both days included)

List columns ​

The list is sorted by creation time, newest first.

ColumnDescription
"Device Name"The device the task is sent to
"Image"A thumbnail of the image sent; click it to enlarge
"State"The task's current state; see Task states
"Current Stage"A row of icons showing each step the device takes to handle the image; see Current stage
"Created At"When the task was created
"Error Detail"When a task is replaced by new playback content, "preempted_by_playlist" appears; see Superseded
"Actions"A task that has not finished has a red cancel icon; see Cancelling a task

Creating a task ​

Send one image to one device to display right away:

  1. Click "Create Task" at the top right.
  2. Under "Device", choose a device.
  3. Drag the image onto the "Image File" area, or click the area to choose a file. Only image files are accepted.
  4. Click "Confirm".

After you send it, a new task appears in the list, starting in the "Pending" state.

The image is resized automatically to the resolution of this device's panel and to the device's current screen orientation (landscape or portrait). The original aspect ratio is not kept when resizing, so an image with a different ratio is stretched or squashed; prepare images with the same aspect ratio as the panel.

Only one image is sent at a time

The "Image File" area accepts several files, but only the first is sent.

You can do the same from "Create Task" on that device in "Device List"; see Device List.

When a task cannot be sent ​

MessageCause
"already has an active task"This device's previous task has not finished. Wait for it to finish, or cancel it first
"Device is under local control. Take over first."The device is under local control; click "Takeover" in "Device List" first

Task states ​

StateMeaning
"Pending"The task was just created and the device has been notified; waiting for the device to receive it
"Waiting for Device Online"The device is offline. It receives this task automatically when it comes online
"Not Reached"The device was notified more than 5 minutes ago and looks online but has not received the task. If it receives the task later, the task continues
"Updating"The device has received the task and is downloading, processing and refreshing the panel
"Succeeded"The device has shown the image on the panel
"Failed"The device hit an error it could not continue past; the system also creates a notification
"Cancelled"Someone clicked cancel
"Superseded"A schedule started playing new content and this task was stopped; see below

"Succeeded", "Failed", "Cancelled" and "Superseded" mean the task has ended and will not change again.

About once a minute the system re-checks tasks that have not been received, so "Waiting for Device Online" and "Not Reached" may appear about a minute late.

Superseded ​

When a schedule starts playing a playlist (or moves to the next image in it), any task on this device that has not finished is stopped and the new content is shown instead. The stopped task shows "Superseded" and "Error Detail" shows "preempted_by_playlist". This is normal, not a fault, and creates no notification.

When a device is under local control, schedules do not send images to it, and its existing task is not superseded.

Current stage ​

Each icon in "Current Stage" stands for one step the device takes to handle the image, in this order:

"Notified" → "Accepted" → "Preparing" → "Downloading" → "Verifying" → "Caching" → "Applying" → "Health Checking"

Hover over an icon to see "Step / Status", for example "Downloading / Succeeded".

IconStatus
Green check"Succeeded"
Blue play"In Progress"
Yellow exclamation mark"Waiting": this step failed and the device is retrying
Red cross"Failed"
Grey minus"Pending"
Grey prohibited sign"Skipped"

When a step fails, the device retries up to the 3rd attempt, and the hover text gets a count such as "(attempt 2)". If the 3rd attempt still fails, or the device reports that the error cannot be retried, the task becomes "Failed".

Cancelling a task ​

A task that has not finished has a red cancel icon in the "Actions" column:

  1. Click the cancel icon.
  2. The confirmation window says "Are you sure you want to cancel this task?"; click "Confirm".
  3. "Task cancelled" appears and the state becomes "Cancelled".

After cancelling, you can send a new task to this device.

Cancelling only changes the task's state in the system; it does not separately notify the device. If the device has already started handling the image, it may still show it.

Related pages: My Gallery, Schedule Settings, Device List

Green Ideas Technology