Stomra · Guide
The review flow
From Stomra to the people who check the drawings: publish an issue, share it with clients, run a review round, and keep what was decided.
Four rules
The model is the truth
Everything reviewed points at a version of the model, or at a drawing made from one.
A drawing is reviewed as it was issued
Publishing draws each sheet once, from one version, and keeps it. That revision is what everyone opens: you, your clients and EikHub.
A print is paper
A PDF or an IFC is made from the issue when someone asks. It is a copy, never the record.
A decision has a name
A link with no sign-in can look and print. To mark up, answer or decide, a person signs in.
The same flow, in the same words, runs on EikHub and is written down in OpenEik's Part XVIII, Review and issue, so a closed review and its people are plain files in the building that any OpenEik tool can read.
1. Publish an issue
Press Client portal in the project's top bar. It opens Portal, where issues are published and clients invited. Publish… opens Publish an issue:
- Sheets: which to issue. The dialog says which have changed since their last issue.
- The issue: its status and purpose, and each sheet's revision mark. A sheet's first issue has no mark, "–", and its revisions are then A, B, C, leaving out I and O.
- Revision clouds: as the purpose says, round what changed, no clouds, or Revised throughout, a note in the revision row instead of clouds.
- For the client portal: the 3D, to turn and walk through, and IFCs by discipline (the whole model, A, K, System, or K and System). Tick any mix.
Publishing keeps the model as a version and writes each sheet as an issued drawing in OpenEik's form: an SVG whose lines name the elements that drew them, with a record of what it was drawn from. No PDFs or IFC files are kept; they are made from the issue when someone opens or prints them. A published issue is never changed afterwards. The format is explained in Issued drawings.
The dialog's check, Check which sheets are issued in OpenEik's form, issues the chosen sheets on a copy and keeps nothing. It says which sheets would stay live, drawn from the model when opened, and why.
2. Invite clients
Invite client… in Portal's bar opens a dialog: the client's name, email and a message, and what the link allows:
| Choice | What it decides |
|---|---|
| Earlier issues | Shown, with a list of issues and a revision menu, or hidden: the current set only. |
| Downloads | Whether the client can take prints and files. |
| Markups | Whether the client can mark up the sheets. You see what they draw in Markups. |
| Link works for | How long the link opens. |
With an address the dialog says Send invitation and the link is mailed at once; without one it says Create link and gives you the link to send yourself. The Clients list shows each client with what they opened, downloaded and marked up, and when they signed in. Its ⋯ menu copies a link, sends it again, renews it, chooses whether earlier issues show, or cancels it. A later issue emails the clients.
Clients are people who look at the issues. People who work in the model are shared with Share, a separate button.
3. What a client sees and does
Each issue on the portal shows its Changes since the one before: drawings revised, new and withdrawn, and the model level by level, as a PDF and in Download everything. The whole client side is in The client portal.
The client portal draws each drawing as the issue sent it, from its issued file: sharp at any zoom, and measurable at each view's scale. A client compares a revision with an earlier one as you do in Review:
- Show changes (X): the drawing fades and only what changed glows.
- Before | After (B): both revisions whole, with a divider between them.
Where the issue carries them, the client also turns the 3D model, walks through it and opens each IFC, to turn or to download as IFC4 or IFC2X3. Print prints a drawing; Download everything takes the set.
Signing in to take part
The link alone is for looking, printing and downloading. To draw, answer or decide, the client signs in with a free Stomra account: Google, Microsoft or an email link or code. What they then do is theirs, by name. A markup asks What should change here? and holds a conversation with your replies.
A signed-in client hears what you did: a mail when you answer their note, change its state or ask them to review a drawing, at most twice a day. They can turn it off on the portal.
4. Run a review round
A review round asks named people for a decision on one issued revision of one drawing. It is never held on the live model or on a print.
- Open Review ▸ History on the sheet, and pick the issue whose revision is to be reviewed.
- Start a review. Choose the reviewers among the project's people and the clients with an open link, give a due date, and the revision before it to compare with. Press Open the review.
- Mark up. While the review is open, every markup on the revision is a note of the review: clouds, callouts, text, notes, pen and highlight, lines and arrows, shapes and measurements. Notes get replies.
- Set each note's state. By default the states are BEAst's: New, To act on, Needs new review, Acted on, Rejected and Handled elsewhere. Each change is kept with who made it and when.
- Each reviewer gives a decision under Your decision: by default Approved, Approved with comments or Not approved. A client gives theirs on the portal, where the sheet shows its review.
5. Close it, and keep it
Close the review freezes it: its notes, replies, states and decisions no longer change. Its file, as OpenEik keeps it, can be saved from History with The review file.
The next time you publish, every closed round is kept in the building with the people it names, once. A round still open waits for a later issue. So the building holds, beside its drawings, what was asked, by whom, and what each reviewer decided.
Projects kept on EikHub
A project connected to EikHub has one place for its reviews: EikHub. Its rounds are run there, and Stomra's History points to the building on EikHub instead of opening a round of its own. When you publish, Stomra takes from EikHub and keeps in the building:
- the closed review rounds;
- the passkey sign-offs made on EikHub, with the keys of the people who signed, so each can be checked without EikHub;
- EikHub's signed receipts of the issues it sent, for the issues you asked it to save.
If EikHub cannot give them, the publish goes on and says so. EikHub's side is in Drawing review on EikHub and Signed receipts on EikHub; connecting a project is in Sharing through EikHub.
Prints
An issued drawing prints on demand as a PDF: Print on the client portal, Print as issued in Review ▸ History. Each page says in its margin which drawing, revision and version it prints, and that a print is a copy, like paper. The same revision prints to the same file every time.
The QR code on a print opens a check that says whether that revision is still current, or which one replaced it. It needs no sign-in and names no project, so a print on site can be checked with a phone.
Preparing the next issue
Work through the notes in the model. Then, in Review ▸ History, Cloud what changed since … draws on the live sheet the very clouds its next issue will print: round what changed to the eye since the last issue. They are a guide on the screen only, dashed blue, never in a print. Where the change covers most of a sheet, it draws none and suggests publishing that sheet Revised throughout. Then publish, and the closed rounds go into the building with it.
Words
Stomra, EikHub and OpenEik use the same words for the same things.
| Word | Means |
|---|---|
| Issue | Sending revisions of drawings, for a status and a purpose. Made by Publish. |
| Revision | One drawing as one issue sent it, by its mark: –, A, B … |
| Review round | Named reviewers, their notes and decisions, on one revision. |
| Note | A markup in a review round, with its state and replies. |
| Reviewer | A signed-in person asked for a decision. |
| Client | A person with a portal link; signed in, they can mark up and be a reviewer. |
| Sign-off | A signed statement by a named person about an exact revision, given on EikHub. |
| A PDF or IFC made from an issue: a copy, like paper. |