====== Publishing Tasks ======
----

Click **Publish** (in the [[tasks_and_creating_tasks#command_queue|Command Queue]]) to display the Publish Task window.

{{ publishing_tasks:1.png }}

Enter a descriptive name for the Task. This name will appear in the application logs.

If the //Wake-On-Lan// option is enabled and at least one unit in the pool of target devices is powered on, that unit will send a Wake-On-Lan network event to other units in the pool. For further information, please refer to [[advanced:wak-on-lan|Wake On Lan page]] within Advanced section.

===== Scheduling =====
----
The Task can be set to be executed immediately or at a later time. To schedule the task to run later, modify the //Publish Start// field.

An end date can be defined using the //Publish End// field.
  * If left empty, the Task will remain active unit all the agents complete the Task.
  * If a date is defined, the Task will be stopped after the specified date, ensuring no other devices process the Task after the date. //If at least one agent did not complete the Task within the execution period, the Task will be marked as Obsolete.//

|{{:tip.png |}} When managing units that are not in the same time zone, it can be difficult to determine what time the Task is performed by remote devices. The **Expected Execution Date** provides the expected completion date based on the device's time zone. Modify the time zone according to the remote device's time zone.|
===== Recurring Tasks =====
----

To make a Task recurring, tick the Recurring Task check box on the Publish Task window. Once published, the Task is stored in the [[library:recurring_tasks|Recurring Task section]] of the Library. **Xcalibur W** will then automatically create and publish occurrences of the Task according to the defined settings.

===== Choose Target Devices =====
----

**Xcalibur W** offers three different ways to select the devices for the task.
{{ publishing_tasks:1b.png }}

  * **Selected devices**
These are the devices chosen using the tick boxes available within the Device List.

  * **Current View**
These are the devices currently displayed on the first page of the Device List.

  * **Select groups**
These are all the devices within the selected groups.


===== Progress Legend =====
----

^  ^  ^  ^
|Scheduled|{{ publishing_tasks:2.png }}| Task is planned but not yet published; the start date is in the future|
|Published|{{ publishing_tasks:3.png }}| Task is published; the start date has passed but no agent has collected the task yet|
|Processing|{{ publishing_tasks:4.png }}| Task is processing; at least one agent has collected the task|
|Stopped|{{ publishing_tasks:5.png }}| Task has been stopped; no more agents will collect the task|
|Completed|{{ publishing_tasks:6.png }}| Task is over; all agents executed the task without errors|
|Unpersisted|{{ publishing_tasks:7.png }}| Task is over; all agents executed the task without errors but the Write Filter was not deactivated|
|Failed|{{ publishing_tasks:8.png }}| Task has failed; at least one error occurred|
|Partial Failed|{{ publishing_tasks:9.png }}| Task has failed; at least one error occurred but the Write Filter was not deactivated|
|Obsolete|{{ publishing_tasks:10.png }}| Task is over; the End date was reached|