Linking the BoQ: distribution and matching
On this page
| Where | Construction schedule → Schedule structure (Структура на графика): the distribution control on each linked row and Total BOQ coverage (Общо покритие на BOQ). Matching: the BORO chat panel. URL: /projects/{project}/schedule-structure?…. |
|---|---|
| Who can | Permission Schedule (График) at Edit (Редакция) to link and distribute; View to see coverage. BORO matching runs under the same permission and uses BORO credits. Paid plan or trial. |
| Related | Structure: categories, groups, tasks, milestones, Creating a schedule, What BORO can do, Working in the BoQ editor |
How BoQ positions get into the schedule
- Copy BOQ Structure. Every BoQ position is placed automatically under the copied categories. You only add dates.
- New Structure. You drag positions or whole BoQ categories from the BOQ Structure (preview) panel into your own categories and group tasks. A dropped position arrives with distribution Quantity = 0 — it carries nothing until you set the distribution.
- Import from MS Project. Activities arrive unlinked. You assign positions to them by hand with Assign BOQ tasks, or let BORO propose the matches.
- Carry-over. Links of the previous BoQ version are kept for positions that still exist.
The same BoQ position may be placed in several rows, for example split over two stages or two floors, as long as the rows together do not carry more than the BoQ quantity.
The five distribution types
| Type | Planned quantity of the row | Use it when |
|---|---|---|
| Full (Пълно) | 100 % of the BoQ quantity. Follows the BoQ quantity when it changes. | The row carries the whole position. |
| Quantity (Количество) | A fixed amount you enter, in the position's unit. | The position is split by measured amounts, e.g. 120 m² on floor 1. |
| Left quantity (Оставащо количество) | Whatever was not yet covered by other rows, calculated and stored when you save ("Quantity assigned to this task"). | The last part of a split position. |
| Percent (Процент) | A percentage (0–100) of the BoQ quantity. | The position is split by share, e.g. 50 % in each stage. |
| Manual (Ръчно) | None — the row is linked but carries no quantity or value. | The row stands for the work but not for a share of its quantity. |
How to set the distribution of a row
- Open Schedule structure (Структура на графика) and expand the linked row in the left tree.
- Choose the type in the Distribution type control: Full, Quantity, Left quantity, Percent or Manual.
- For Quantity or Percent, set the value with the slider or type it. The hint "{value} remaining" shows how much is still free.
- The change saves automatically: "Distribution updated successfully" (Разпределението беше обновено успешно).
You cannot distribute more than the BoQ quantity. A value that would exceed it is refused with "Distribution exceeds available quantity: {details}". Reduce another row of the same position first.
- The linked task row in the schedule tree.
- The Distribution type control, here Percent (Процент).
- The slider and the number field for the value.
Distribution of a group task
A group task has no quantity of its own, but you can set the type for all its tasks at once:
- Click Set distribution (Задай разпределение) next to the group's name.
- Choose the type. Percent applies one value to every task. Quantity only sets the type — "Enter each child's quantity below". Full, Left quantity and Manual apply directly.
- The message "Group distribution applied to its tasks" confirms it.
A task whose distribution you changed in its own row gets the badge Manual (Ръчно, "Set manually — a group distribution change will not overwrite it"). The group skips it from then on. Click Switch to automatic (Превключи на автоматично) to make it follow the group again.
BoQ coverage
The summary Total BOQ coverage (Общо покритие на BOQ) at the top of the structure editor shows the share of the BoQ quantity already placed in the schedule and how many positions are in each state. Each position in the BOQ Structure (preview) panel also shows a colored bar with "Covered:" (Покрито:) and its state.
| State | Color | Meaning |
|---|---|---|
| Full (Пълно) | Green | The whole quantity is distributed. |
| Partial (Частично) | Amber | Part of the quantity is distributed. |
| No coverage (Без покритие) | Red | The position is not in the schedule, or is placed with quantity 0. |
| Manual only (Само ръчни) | Gray | The position is placed only in rows with Manual distribution. |
- Total BOQ coverage (Общо покритие на BOQ) with the overall percentage.
- The counts of positions per state: Full, Partial, No coverage, Manual only.
- The coverage bar under a BoQ position with "Covered:" and its state.
What happens when the BoQ changes
Schedules follow their BoQ. When you edit the BoQ, the message "Syncing schedule with BOQ…" (Синхронизиране на графика с КСС…) may appear, and afterwards a short notice such as "Schedule updated: {count} task(s) removed".
| BoQ change | Effect on the schedule |
|---|---|
| Position deleted | Its schedule rows are removed. |
| Category added, renamed or moved (schedule copied from the BoQ) | The schedule's categories follow. |
| Quantity changed, row distribution Full | The row follows the new quantity. Reported progress is rescaled so the executed amount stays the same (50 % of 15 becomes 25 % of 30). |
| Quantity changed, row distribution Percent or Quantity | Nothing changes automatically. You see "Some schedule tasks must be redistributed manually after the quantity change." Check those rows in the structure editor. |
| Quantity changed, row distribution Manual | Nothing changes and no notice is shown. |
| Quantity decreased below what the schedule already distributes | The BoQ change is held and the window Schedule over-coverage (Прекомерно покритие в графика) opens. |
How to resolve "Schedule over-coverage"
- The window explains: "The new quantity is lower than what is already distributed in the schedule. Reduce the distributions to fit within the new quantity before continuing."
- For each affected position it shows "Covered: … / Target: …" and the schedule rows that carry it. Lower the Percent or Quantity rows until the covered amount fits the target. Rows with Full or Left quantity cannot be edited here.
- Click Apply and continue (Приложи и продължи). The distributions are saved and your BoQ quantity change is applied. Cancel drops the BoQ change.
Linking an imported MS Project schedule
After an MS Project import, activities have dates but no BoQ positions. Activities without sub-tasks become empty group tasks with the badge Needs BOQ tasks (За попълване).
By hand
- In the structure editor, click Assign BOQ tasks (Добави позиции от КСС) on the empty group.
- In Assign BOQ tasks to group (Добавяне на позиции от КСС към групата), search with "Search BOQ tasks…" (Търсене на позиции от КСС…) and pick the positions. "No matching BOQ tasks" means the search found nothing.
- Choose the Distribution (Разпределение) and click Assign (Добави).
You can also drag positions from the BoQ panel onto any activity, as in a new structure.
With BORO (matching)
For a large schedule, ask BORO to match the BoQ to the schedule, for example: "Match the budget BoQ to the imported schedule." There is no separate matching screen; it works through the BORO chat:
- BORO starts a matching run in the background. It proposes which BoQ positions belong to which activity, with a confidence tier (high, medium, low). It can also split a position over repeated stages (for example ЕТАП 1 / ЕТАП 2) in proportion to their duration. Nothing is written to the schedule yet.
- BORO shows you the draft: a summary, the proposals per tier, the proposed splits, ambiguous positions that need your decision, and what stayed unmatched on both sides.
- Ask for the Excel report of the draft if you want to review it in a spreadsheet. BORO returns a download link; the file is not saved to the file manager.
- Tell BORO what to apply, for example "apply all high-confidence matches", or give explicit pairs. In the BORO panel you approve on an approval card by default before anything is written. You can apply in several rounds.
- For leftovers, ask BORO to link specific positions to specific activities, or to remove a wrong link. Ask for the coverage check to see what is still uncovered.
Common questions
Why is the planned value of a row 0?
The row was dropped in with quantity 0, or its distribution is Manual, or its BoQ position has no price. Set the distribution to Full or to the right share.
What is the difference between Quantity and Left quantity?
Quantity is an amount you type. Left quantity takes whatever is still free when you save, so you do not have to calculate it.
Why do I get "Distribution exceeds available quantity"?
Other rows of the same BoQ position already carry part of its quantity. Lower one of them or use Left quantity.
I reduced a BoQ quantity and a "Schedule over-coverage" window appeared. What now?
The schedule distributes more than the new quantity. Lower the Percent or Quantity rows shown in the window, then click Apply and continue. Your BoQ change is applied afterwards.
Why does a task in a group show the badge "Manual"?
You changed its distribution in its own row, so group changes no longer overwrite it. Click Switch to automatic to make it follow the group again.