Book a demo, get a 14-day free trial. →
BuildersAI
Help Centre

Start a project from a folder

This is the same guide SiteBot reads. Inside the app you can ask it any of this in your own words, and it answers from this page.

Step 2 of 4, Check what we found, for a job folder. Three cards: Drawings (12), which go into the drawing register with their numbers, with a line saying 1 is a later revision of another drawing in this folder; Documents (9), which go into Files keeping your folders, with a link to change who can see them; and Left behind (3), which cannot be stored and stay on your computer. Each card has a See them button, and a line under them says We found a programme: Programme rev B.xlsx, which can make the task list in the last step.

If you already keep the job in a folder on your computer (a OneDrive or Dropbox folder on it works too), BuildersAI can bring the whole folder in at once. The drawings go into the drawing register with their numbers, titles and revisions read from the file names, everything else goes into Files in the folders it was already in, and then you can start the task list from a programme spreadsheet in the folder, a draft from SiteBot, or a standard programme. Nothing is sent until you have seen what is in the folder, and no task is added until you press the button.

Where to start (app.buildersai.co.uk):

Who can use it: project administrators, on a project that is not read-only. Only an administrator can add a drawing to the register, so the page is theirs. A member who opens it is told so and offered Open Files, where Import Folder brings documents in without the drawings. Followers are not offered it. It is in the browser only.

Step 1 of 4, Choose your folder: click Choose a folder and pick the folder you keep the job in, or drag the folder onto the box. Nothing is sent yet.

Step 2 of 4, Check what we found: the folder is sorted into cards, each with a count and a See them button that opens its list.

The main button says how many files it will send, for example Bring in 20 files. If it cannot be pressed yet, the line beside it says why: a discipline to choose, a drawing with no number, or a box to tick for a big folder. Choose another folder goes back.

Step 3 of 4, Bringing it in: one progress bar, the name of the file going up, and Stop. Leave the page open until it finishes: if you try to leave while files are going up, the browser asks first. Then one sentence you can check against the register, such as “That is your job filed: 11 drawings in the register and 9 documents in Files.”, with Open the drawing register and Open Files. Next: your task list goes on to step 4, and Finish here goes to the project’s Home.

Step 4 of 4, Your task list: see “Starting the task list” below.

How a drawing is recognised:

Revisions:

“Check this”: a row marked Check this has something worth a look, written underneath in words:

Under the row, Our guess says where the number and the discipline came from. Change anything that is wrong. A check never stops the drawing coming in, except a missing discipline or a number you have cleared.

Choosing a discipline: a new drawing needs one, and none is assumed. It comes from the folder the drawing is in (“Structural”) or its file name, never from the job folder’s own name, so “14 Oakfield Road” does not file everything as civil. Drawings with none are gathered in a Choose a discipline box, one line per folder (“3 drawings in Engineer have no discipline”), with File them all as: so a folder of forty sheets is one choice. You can also set a single row’s Discipline. A drawing filed as a revision takes its drawing’s discipline.

Where the documents go: into Files, keeping your folders. The folder you chose is the job itself, so it is not made again: what was inside it lands at the top of Files, in the folders it was in. A folder already in Files with the same name is used rather than made twice. If you came from Import Folder inside a Files folder, they go into that folder. Change who can see the documents offers Everyone, Members only or Admins only. It applies to the documents; the drawings go into the register as every drawing does.

Photographs go to Files, not the Gallery. The Gallery’s own upload keeps the day and place each photo was taken, so if most of the folder is photographs the Documents card says so. Carry on if you want them in Files, or add them in the Gallery instead (see the “photos” topic).

What is left behind, and why: each file says which:

CAD drawings (DWG, DXF) are not left behind: they go into Files as documents, because the register takes PDF, JPG and PNG.

A big folder: past 500 files or 1 GB, tick “Yes, put … files into …” before the button works. The most in one go is 5,000 files; past that, bring in the folders inside it one at a time.

Stopping and carrying on: Stop lets the file going up finish and stops there. Everything that arrived stays and nothing is removed. The result says what had arrived, and Bring in the remaining sends the rest. Files that failed are listed with the reason, and Try those again sends just those.

Running the same folder again is safe. An unchanged file that is already here is left alone, a document of the same name in the same folder is saved as a new version, a new issue of a drawing is filed as its next revision, and folders already in Files are used again. If nothing has changed it says “Nothing new to bring in: everything in this folder was already here.”

Starting the task list: step 4, Your task list, offers up to three ways. Whichever you choose, you check the list before anything is added, and Not now finishes without one.

What a programme spreadsheet needs:

When SiteBot drafts:

  1. Which documents describe the job? lists the documents in Files that SiteBot can read (PDF, Word, Excel and CSV). The ones that look like a quote, a schedule of works or a specification are ticked already: change them if they are not right. Up to eight
  2. Each says Ready to read, Still being read (SiteBot waits for it) or Could not be read, with why. Documents are read a little while after they arrive, so one brought in a minute ago may still be being read
  3. Set The day work starts (the next working day unless you change it), add Anything SiteBot should know if you like, and click Draft my task list
  4. The screen says “Reading your documents”, then “Drafting your task list”. It usually takes a minute or two, and you can leave the page open. Stop takes you back with your choices kept
  5. If a document has still not been read after two minutes, you can Draft from what is ready, Keep waiting, or start from a standard programme

SiteBot reads only the documents you tick, and only as you can see them: a document above your access level is not offered. It also looks at the drawing register’s numbers and titles and the specification titles, to name the work the way the job does. It can only suggest a task list: it adds nothing, gives work to nobody and changes nothing in the project.

Checking the list: Check your task list shows phases as headings with their tasks under them. Each task has its name (type over it), its working days (the minus and plus buttons, or type a number), what it starts after, its dates, and Remove. A duration SiteBot estimated says SiteBot’s estimate; one from the documents says where it came from. What SiteBot assumed is listed at the top. Remove this phase takes a phase out with its tasks, and Put it back brings back the last removal.

The dates follow your site’s working days, worked out from Work starts on. Change that day and every date moves, except tasks keeping the dates from your programme.

Nothing is added until you click Add … tasks to the programme. The tasks then go under Boards, each phase a task with its own tasks under it, and “starts after” becomes “comes after” (see the “task_dependencies” topic). Open the programme takes you to them on the board’s Gantt view. Undo takes every one of them out again and returns you to the list. No labels, people or costs are put on them.

Ten drafts a day: each person can ask SiteBot for up to ten task lists in any 24 hours. Each draft SiteBot starts counts, whether or not you add it; waiting for documents to be read does not. A programme spreadsheet and a standard programme have no limit. On a very busy day SiteBot may ask you to try again tomorrow.

Questions people ask:

For the drawing register itself, see the “plans” topic. For Files and Import Folder, see “files”. For the five setup jobs, see “project_setup”.