> For the complete documentation index, see [llms.txt](https://help.qonic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.qonic.com/documentation/qonic-application/data-and-collaboration/planning-panel.md).

# Planning Panel

Use the Planning module to create construction sequences of the objects in your model. Assign tasks to objects, create relations between these tasks and animate the construction sequence.

Open the Planning panel by clicking the calendar icon on the left side of your screen, or by using the <kbd>Shift</kbd> <kbd>P</kbd> shortcut. This will show a list of all plannings in the project. Here you can manage the different plannings or create a new one.

The Planning panel opens as a floating window over the 3D view. Drag it by its title bar to move it and drag its edges to resize it; drop it near its original position to dock it there again. Close it with the ×.

{% hint style="info" %}
The Planning panel is part of the Planning add-on. Without this add-on, the calendar icon is greyed out, its tooltip shows a bolt icon, and the shortcut does not work. The sample project and your organization's first project include all add-ons, so you can use the Planning panel there without the add-on. See [Plans & Add-ons](https://help.qonic.com/getting-started/plans-and-add-ons.md#add-ons). The Planning panel is not available on mobile devices with small screens, or while editing a component.
{% endhint %}

## Creating a planning

{% hint style="info" %}
Project Editors and Owners can create, edit, rename, delete and export plannings when the model is open for editing; other members can open and play them.
{% endhint %}

Create a new planning by clicking the green <kbd>+</kbd> button at the bottom right of the panel.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2Fpoyx52evtvcNa2eK76DB%2Fimage.png?alt=media&amp;token=83be8891-0302-4aaa-8f99-a059731e2903" alt="" width="563"><figcaption></figcaption></figure></div>

Use the ellipsis next to a planning in the list to *Rename*, *Delete* or *Export as...* it.

### Creating a planning from scratch

Click *From scratch* to create a new empty planning. You can enter a name and a start date (today by default) for this planning.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2F8tIk9qnHs1O23H84kUM2%2Fimage.png?alt=media&amp;token=02144c6d-c062-4e6d-9e99-4fa1d4f2b742" alt="" width="375"><figcaption></figcaption></figure></div>

The planning will contain no tasks, so the timeline will appear empty. Click the green <kbd>+</kbd> button at the bottom right, next to the play controls, and choose *New task*.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2F7274BAOxkpmwVFQSEGJ1%2Fimage.png?alt=media&amp;token=037c7585-b59d-4d16-92a9-26a1275ca56d" alt="" width="563"><figcaption></figcaption></figure></div>

This will open the task details in a floating panel beside the Planning panel. Here you can enter the following details:

* The task name
* Whether this task is part of a group
* The duration of the task
* The type of task: construction, demolition or temporary
* The objects in this task. Use the browse panel to select a relevant group of objects, or select them manually in the model. The products currently selected in the model are added to the new task.
* Links to other tasks. Click *Link Task* to define predecessors and successors, their relation type (Finish-Start, Start-Start, Finish-Finish or Start-Finish; Finish-Start by default) and optionally a lag between the tasks.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FgkIyLQDnyAaDVp2BCiE3%2Fimage.png?alt=media&amp;token=ba757123-8ce5-4113-bc36-7ffb84430207" alt="" width="563"><figcaption></figcaption></figure></div>

Once the task is created, it will appear in the Gantt chart. A new task is placed after the selected task (or at the end of the list) and is automatically linked to follow it with a Finish-Start relation, but this can still be edited.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FwJY0RS56DOXwWwelRuLW%2Fimage.png?alt=media&amp;token=80c470f7-9750-4c9a-8dcc-04ab68fb3ee3" alt="" width="563"><figcaption></figcaption></figure></div>

Clicking the name of the linked task allows you to change it to predecessor or successor. A second dropdown on the link sets the relation type.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2Fztq82sKKQO219dIjlko6%2Fimage.png?alt=media&amp;token=5f4a3466-8666-41b6-8c8f-b46251f47119" alt="" width="293"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FVY7AUCmWwMYJZOIsagjx%2Fimage.png?alt=media&amp;token=db941b49-dd8e-48d9-bc34-73172d40397b" alt="" width="290"><figcaption></figcaption></figure></div>

The setup in the screenshot above means that the Foundation Piles task is a preceding task to the current (Footing) task, with a Finish-Start relation and a lag of 2 days. In other words: the Footing task can only be **started** **2 days after** the Foundation Piles task has **finished**. In the Gantt chart this will look like this:

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FeMo6a2Gyz7fLccn0R9jJ%2Fimage.png?alt=media&amp;token=77a7d6b7-2d93-45d5-8cef-bb95a1e9a82f" alt="" width="563"><figcaption></figcaption></figure>

When you select a task, labels (chips) with the task name appear in the 3D view, for the selected task and for its predecessors and successors. Click a chip to show that task's details in a floating panel beside the Planning panel. Click the ellipsis next to the task name in the side panel or in the corner of this task details panel to find actions such as *Edit*, *Add to Group*, *Split task*, *Delete*, *Select Products* and *Set as Scope*. When products are selected in the model, the menu also lets you assign them to the task (*Assign to …*), replace its products (*Replace all in …*) or remove them (*Remove from …*). If you select several tasks, the ellipsis menu lets you add them to a group, split them (*Split tasks*) or delete them at once.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FlNKxmDGWUs2JWZjZpGUu%2Fimage.png?alt=media&amp;token=79d4ef2f-f85a-4da2-86b5-0adfcddf51b2" alt="" width="187"><figcaption></figcaption></figure></div>

When you assign products that already belong to another task, they are moved to the new task. Click *Keep in both* in the message that appears to keep them in both tasks.

### Splitting a Task into Subtasks

Split a task to turn it into a group of subtasks, one for each value of a property of its products: for example one subtask per level, per material or per IFC class.

Click the ellipsis next to a task and choose *Split task*, or select several tasks and choose *Split tasks* to split them all in the same way. Splitting is available when the model is open for editing, *Group by* is set to *Custom*, and the task is not a group and has products assigned. If you select several tasks, all of them must meet these conditions.

1. **Pick a property.** Choose the property to split by, such as Model, Class, Location, Material, Type, Classification code, Component or another property. Each value of this property becomes a subtask. Properties that would not split anything are greyed out; hover over them to see why, for example because every product of the task has the same value.
2. **Choose the order.** Each row is one subtask. Products without a value for the property are collected in a *Not assigned* row at the end. You can now:

   * Drag a row up or down to change the order of the subtasks.
   * Drop a row onto another row to merge them into one subtask. Expand a merged row to drag its values out again.
   * Click *Reverse order* to reverse the whole list.
   * Double-click a row name to rename the subtask. Clear the name to go back to the original value.
   * Set the duration of each subtask (1 day by default).

   Use the back arrow to choose a different property.
3. Click *Split*.

The original task becomes a group with the same name, containing the subtasks in the order you chose. Each subtask gets the type of the original task (construction, demolition or temporary), and the subtasks are linked one after the other with a Finish-Start relation and no lag. Links to and from the original task move to the first and last subtask. To undo a split, use Undo.

When you split by material, the layers of layered products, such as multilayer walls, are split separately, so each subtask contains the layers with that material.

### Creating a planning from a preset

To avoid having to manually create tasks for each group of products in your model, you can use the [Browse Panel](https://help.qonic.com/documentation/qonic-application/data-and-collaboration/browse-panel.md) presets for a more structured approach. Head to the Browse panel (or the Report panel), create a new Preset and set it up to your requirements. In the example below, we want to create a planning of all **loadbearing** products, and split the tasks per **floor** and **IFC class**.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FoblRA8QbkUGmxt7S9hiY%2Fimage.png?alt=media&amp;token=621a05f1-5093-47b4-bc2f-c023d48c7f63" alt="" width="293"><figcaption></figcaption></figure></div>

Once the preset is created, you can use it to create a new planning. In the Planning Panel, create a new planning and choose *From preset*. Enter a name, select the preset you just created in the *Preset* dropdown, pick a start date and click *Next*.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2F9GcIZlMQyEBXPMXzMR6A%2Fimage.png?alt=media&amp;token=8a433b00-31d4-46b3-8c65-d940d45faf03" alt="" width="375"><figcaption></figcaption></figure></div>

You can now still change the order of the **lowest** grouping level of your preset. In our example case the lowest grouping level is IFC class, so we are given a list of all IFC classes that apply to the chosen preset. In our example, we want to first place piles, then footings, and then per floor: slabs > columns > walls > beams > stairs. Drag the cards so the order is more or less correct, or click *Reverse order* to reverse the whole list. Don't worry, you can still change the order between tasks once they are actually created.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2F0M5nMwnT8QQz8BwIKAI1%2Fimage.png?alt=media&amp;token=3c9fcf92-f8f3-4492-a64f-7e864639340b" alt="" width="375"><figcaption></figcaption></figure></div>

Click *Create*. You have now created a planning that includes all products in the defined preset. In this case, all loadbearing products are included in this planning, and they are grouped per floor. Within each floor, each IFC class is now an individual task, and this task has been automatically assigned to all respective products. By default, a duration of **1 day** per task was assigned, as well as the default **construction** type, and a **Finish-Start** relation with **no lag** between the tasks.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FjhbUQUYTmOFlvdawZctz%2Fimage.png?alt=media&amp;token=d1cd87f1-5371-4ef8-8849-851b6a6de99f" alt=""><figcaption></figcaption></figure></div>

Click the green <kbd>+</kbd> button in the bottom right corner and choose *New task*, *New group* or *Add from Preset* to manually add tasks, groups or continue adding from other presets.

## Visualizing a planning

Use the play controls at the bottom right of the panel to start playing an animation of the construction sequence. The *Playback settings* button contains *Auto zoom* (zoom to the products of the active tasks) and *Speed* (0.5x, 0.75x, Normal, 1.5x, 2x or a custom value).

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FvlqKhcDp6sD5yX92kN41%2Fimage.png?alt=media&amp;token=c9a2fba1-1eb0-430a-939b-c31df6432bb0" alt="" width="126"><figcaption></figcaption></figure></div>

You can also click *Minimize* in the title bar to collapse the entire planning panel to a more compact player, including play controls, an interactive timeline and some information about the currently playing tasks. Click *Maximize* to restore the full panel.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FVpfDtziWWDC2KF7c6EFM%2Fimage.png?alt=media&amp;token=be8d317a-72da-4396-9e86-849c11c26c51" alt="" width="563"><figcaption></figcaption></figure></div>

Alternatively, drag the playhead in the Gantt chart to manually go to a specific time.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FtZs68EguJmJ5EF9KWcqa%2Fimage.png?alt=media&amp;token=1dce9db3-9547-4998-b6ee-a1eb8e9df1e6" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FfjvUjjHpQKebqIYKuQ3E%2Fimage.png?alt=media&amp;token=f16cf29f-37a9-4d5d-89e4-465abc569114" alt="" width="375"><figcaption></figcaption></figure>

When playing the animation or moving the playhead, the associated products will become (in)visible based on their task type:

* Products assigned to **Construction** tasks will start off as invisible, and become visible as soon as that task is started
* Products assigned to **Demolition** tasks will start off as visible, and become invisible as soon as that task is finished
* Products assigned to **Temporary** tasks will start off as invisible, become visible as soon as that task is started but only for the duration of their task, after which they become invisible again.

Selecting a task will outline all products of that task in the model in black. Additionally, products assigned to *predecessing* or *successing* tasks will be highlighted in *orange* and *blue* respectively.

In the image below, the Wall task is selected; the products assigned to this Wall task are highlighted with a black outline, whereas the products assigned to the Slab task (predecessor) and the Column task (successor) are outlined in orange and blue.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FqTwTTN0hxpkjguzJ4E9H%2Fimage.png?alt=media&amp;token=f6646327-ee44-4132-9b54-b777c3a9a107" alt="" width="185"><figcaption></figcaption></figure></div>

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FeuizftzM4MgKyWDtoQZ5%2Fimage.png?alt=media&amp;token=60c51fa0-f26d-4c5d-ada6-f610a198b0d7" alt="" width="563"><figcaption></figcaption></figure>

The toolbar at the top of the planning panel contains some additional options for customizing your view of the planning. Use the arrow next to the planning name to go back to the list of plannings, and the side-panel button (*Hide side panel* / *Show side panel*) to hide or show the task list.

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FbupEf8cTBzzPoTGH563x%2FGroup%20712.png?alt=media&amp;token=45d512a6-d879-409a-89e7-968e2139b765" alt="" width="373"><figcaption></figcaption></figure>

1. Search bar to filter on task names
2. Additional filter/view options:
   1. *Show* *All* tasks or only *Assigned tasks* (tasks that have products assigned). Turn on *In scope only* to show only the tasks of products currently in scope.
   2. *Sort by* *Custom* (default), *Start date* or *End date*. With *Custom*, you can reorder tasks by dragging their handle in the side panel
   3. *Group by* *Custom* groups (default), *None* (flat list) or *Task type* (construction/demolition/temporary)
3. Quickly expand or collapse all groups
4. Automatically hide products which have a task assigned. This can be useful if you are manually assigning products to tasks as it allows you to see which products you haven't linked yet.
5. Zoom in on the timeline
6. Zoom out on the timeline

## Exporting a planning

To export a planning, go back to the planning overview, click the ellipsis next to the planning and choose *Export as...* > *MS Project (.xml)* or *Primavera P6* (.xml). The export is made from the latest saved version of the project.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FeWfD4Y3wwNAY8QFeSv4T%2Fimage.png?alt=media&amp;token=1ac6312b-9fbd-48df-ba82-0d980131803d" alt="" width="563"><figcaption></figcaption></figure></div>
