Placing a good annotation in EDIT
What it is for
An EDIT annotation is not just a comment: it is a request to update your portfolio. Placed well, it can be applied automatically in a few seconds. Too vague, too broad, or placed next to the equipment it is about, it has to be reread, interpreted, sometimes sent back to you: processing takes longer and the risk of error goes up.
This page gathers the good practices to pass on to your field teams and to the people who validate annotations. For how the application itself works, see Running a field survey with EDIT.
Who does what
| Who | What they do |
|---|---|
| People in the field (agents, technicians, caretakers, survey contractors) | Place annotations on the plan, with a photo when useful |
| The people who validate annotations in your organisation | Reread annotations, complete or send back the imprecise ones, then launch the automatic processing |
| Stonal | Takes care of what the automatic processing cannot do ("To be handled by Stonal" status) |
The 5 golden rules
- One annotation = one piece of equipment (or one finish). No broad annotation such as "replace every bathtub in the building": place one for each element concerned.
- Click on the original element. For a modification, a replacement or a deletion, the annotation goes on the existing equipment: not next to it, not on the wall that carries it. If several pieces of equipment overlap, EDIT asks you which one you mean.
- For a creation, click in the room, where the equipment actually is.
- Choose the type and characteristics of the new element from the list (for instance Radiator, then Steel…). A free-text description does not replace this choice: it is what makes automatic processing possible.
- Choose the right annotation type (table below). The Information type is for anything that is not an equipment update.
Which annotation type should you choose?
| In the field | What to do | What to fill in | Processing |
|---|---|---|---|
| A piece of equipment exists but is not on the plan (a missing radiator, for instance) | Creation annotation (green) | The room (click where it is), the equipment type and characteristics, a photo if possible | Automatic. Depending on your platform, the equipment may be drawn on the plan at a later stage |
| A piece of equipment is on the plan but no longer exists | Deletion annotation (red) | A click on the equipment concerned | Automatic |
| A piece of equipment has been replaced by another (a replaced boiler, for instance) | Modification annotation | A click on the original equipment, the type and characteristics of the new equipment | Automatic |
| A characteristic of a piece of equipment is wrong (condition, last renewal date…) | No annotation: the sheet of the equipment, Information panel (or Attributes) | The new value | Immediate, depending on your permissions |
| The plan itself is wrong (moved partition, missing room, wrong area) | Information annotation (purple), describing the correction precisely | The room concerned, a description, a photo or a sketch | By Stonal (plan rework) |
| A remark that does not concern the portfolio (damage, cleanliness, work request) | Do not use EDIT: go through your usual request tool | — | — |
Good and bad examples
| Hard to process | Can be processed automatically |
|---|---|
| Information annotation placed in the middle of the home: "radiator missing in living room" | Creation annotation placed in the living room, Radiator type, characteristics filled in, photo attached |
| A single annotation: "all the windows are PVC" | One Modification annotation per window, placed on each window, PVC material. If many elements are concerned, talk to your Stonal contact |
| Annotation placed on the wall: "tiles instead of paint" | Annotation placed on the wall finish, new Tiles finish selected |
| "To check" | A description that says what to correct, and to what |
Before launching the automatic processing
For the people who validate annotations, a 30-second check is enough:
- the annotation is placed on the right element, or in the right room for a creation;
- the equipment type is chosen from the list, not just described in text;
- it concerns a single element;
- it does not duplicate another annotation in the same place.
If something is missing, complete the annotation yourself or send it back to its author. An incomplete annotation passed on to Stonal will come back to you with the "Waiting for customer" status, and the question asked in the annotation.
The "Start auto processing" button only becomes active when the conditions are met, and a summary window shows you, before you confirm, what will and will not be processed automatically. The full procedure is in Launch the automatic processing.
It is being rolled out gradually: get in touch with your Stonal contact to have it enabled.
Tracking your annotations
| Status | What it means |
|---|---|
| New | The annotation has just been placed and is waiting to be checked |
| To be handled automatically | It has been checked and is ready for automatic processing |
| Processing in progress | The automatic processing is applying it |
| Auto-processed | The automatic processing has applied it to your portfolio |
| Error | The automatic processing failed; the reason is shown and our teams take it over |
| To be handled by Stonal | It has been handed over to the Stonal teams |
| In Progress | Our teams are working on it |
| Waiting for customer | A piece of information is missing: the question is asked in the annotation |
| Done | The update has been made |
The "Annotation tracking" report, refreshed every night, lets you follow these volumes by property, by author and by status.
During a survey campaign: 3 tips
- Start small. Try it on one property and have the first annotations reread before sending the whole team out.
- Offline, sync before you sign out. Download the floors you need before leaving, and sync before you sign out of the application: otherwise the annotations stored on the device are lost.
- Filter by equipment family to show only one type of equipment once the plan is loaded.
See also
- Running a field survey with EDIT — how the application works
- Launch the automatic processing — the step-by-step procedure