IoT Quality
by Viindoo
| Lines of Code | 1468 |
| Technical name | viin_iot_quality |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/17.0/viin_iot_quality |
| Required Apps | Discuss (mail) |
| Included Dependencies | Quality Internet Of Things |
| Extensions | Quality Control IoT for Manufacturing |
IoT Quality
Read a quality check’s measurement straight off the instrument, and record which instrument produced it.
The Reading Nobody Typed.
Take a quality check’s measurement straight from the registered instrument - and know exactly which device produced it, and when. IoT Quality turns a quality check’s measurement into evidence: attributable to an instrument, timestamped, and never confused with a number someone typed in from memory.
Extends viin_iot -
see its documentation.
Key Features
Name the instrument on the control point
Point a control point straight at the registered instrument that should supply its reading, filtered to the kind of device the test needs and to the point’s own company, so nobody hunts through instruments that don’t apply.
One button, a reading you can watch happen
An operator presses "Read from instrument" and watches the request live: waiting, then received once the value lands, or a plain error if the instrument never answers - never a silent gap dressed up as a passed check.
Every measurement carries its source
Each quality check keeps a permanent record of whether its number was entered by hand or read from an instrument, which instrument produced it, and exactly when that instrument took the reading - a different moment from the check’s own sign-off date.
The operator doesn’t need a separate login to use it
Registering an instrument stays an administrator’s job. Taking a measurement doesn’t: a quality operator reads an instrument with the exact access they already hold for quality checks, nothing extra to request or be granted.
How It Works
An instrument is registered in your IoT setup, then someone names it on the control point it should serve.
When a quality check runs against that point, the operator opens the measurement dialog and presses "Read from instrument."
The operator watches the request resolve - a reading lands, or the instrument says plainly that it didn’t. Confirming stages the value onto the check together with the instrument and the moment it measured.
Pass or fail doesn’t change: the control point’s own tolerance rule still makes that call. This module supplies the number - never the verdict.
Name the Instrument on the Control Point
Point a control point straight at the registered instrument that should supply its reading, filtered to the kind of device the test needs and to the point’s own company, so nobody hunts through instruments that don’t apply. Leave it unset and the point stays exactly as fillable by hand as it always was.
One Button, a Reading You Can Watch Happen
An operator presses "Read from instrument" and watches the request live: waiting, then received once the value lands, or a plain error if the instrument never answers - never a silent gap dressed up as a passed check. The value stages in the dialog and reaches the check only once the operator confirms it.
Every Measurement Carries Its Source
Each quality check keeps a permanent record of whether its number was entered by hand or read from an instrument, which instrument produced it, and exactly when that instrument took the reading - a different moment from the check’s own sign-off date. Swap in a replacement instrument later, and earlier checks keep exactly what they always recorded.
The Operator Doesn’t Need a Separate Login to Use It
Registering an instrument stays an administrator’s job. Taking a measurement doesn’t: a quality operator reads an instrument with the exact access they already hold for quality checks, nothing extra to request or be granted.
Need help with IoT Quality?
Pre-Sales & Partnership
Talk to Viindoo before you buy.
viindoo.com/apps/modules/17.0/viin_iot_qualityTechnical Requirement
- Odoo version: 17.0
- Editions: Community, Enterprise
-
Required apps: IoT (
viin_iot), Quality (to_quality) - License: OPL-1
Give Every Measurement a Source.
See where the value came from, and when, on every quality check you run.
Start a Free Trial Book a Guided TourIoT Quality
Note
Extends viin_iot - see its documentation.
A quality control point defines a target value and a tolerance band, but normally the number that goes into a quality check is whatever an operator typed in from an instrument's display. This module lets a control point name the registered measuring instrument that supplies its reading, so an operator can pull that reading straight into the check with one click - and every measurement this module records keeps a note of which instrument produced it and when.
The pass/fail verdict does not change: it stays the control point's own tolerance rule. This module only supplies the number, and only when an instrument is named on the control point - a control point with no instrument named is filled in by hand exactly as before this module was installed.
Installation
This module bridges two applications and installs itself automatically the moment both are present, so you rarely need to install it by hand.
- Open Apps.
- Search for and install IoT (skip if already installed).
- Search for and install Quality (skip if already installed).
- IoT Quality installs itself once both are active.
It has no menu and no app icon of its own - it only adds fields and a button inside the Quality application - so it will not show up in Apps unless the Apps-only search filter is removed first. The more direct way to check whether it is active, or to turn it on or off, is the IoT application's own settings:
- Open Settings ‣ IoT.
- Under IoT Integrations, find IoT Quality.
- Switch the toggle on to install the module, or off to remove it.
Configuration
Two roles play a part here, and they do not have to be the same person.
Registering the physical instrument itself - pairing an IoT box and adding a device to it - is done in the IoT application, and normally needs Administrator (or IoT Box Creator) access there; see the viin_iot documentation for that step.
Naming an already-registered instrument on a control point is done in the Quality application, and needs Administrator access to Quality Control:
- Open Quality ‣ Quality Control ‣ Control Points and open the control point to configure (or create a new one).
- Set Type to Measure or Take a Picture - the Measuring Instrument field only appears for these two types.
- In Measuring Instrument, pick the instrument that should supply this control point's reading. The list only offers instruments of the matching kind - a scale for Measure, a camera for Take a Picture - that belong to this control point's own company.
- Leave Measuring Instrument empty to keep filling this control point's checks by hand, exactly as before this module was installed.
Once an instrument is named, Answers On Demand shows, read-only, whether the operator has to press a button to get a reading from it, or the instrument sends its values on its own - this comes from how the instrument itself is registered in the IoT application.
No extra permission is needed after that to actually use the instrument: any ordinary Quality user can already see its name and press the button that reads from it, because this module extends the Quality user's own access rather than asking for a separate IoT permission.
Usage
Take a measurement from the instrument
- Open the quality check for a control point that names an instrument (Quality ‣ Quality Control ‣ Quality Checks), and click Measure.
- In the dialog, click Read from instrument.
- Wait for the reading. An instrument that answers on demand is asked once; an instrument that streams its own values is asked to start streaming. Either way, the Measure field fills in with the value the instrument reports, and the dialog shows where the request stands.
- Click Validate. The measurement, the instrument, and the time the instrument took the reading are all recorded on the check.
If you type a value into Measure yourself, instead of pressing the button - or type over a value the instrument already supplied - that value is recorded as entered manually, not as read from the instrument. Only a value that arrived from the instrument and was never overwritten is recorded as coming from it.
When the instrument does not answer
A request to an instrument can fail as well as succeed, and this module is careful never to present a failed request as a successful measurement.
If the instrument cannot be reached at all - for example, its box is offline - Read from instrument reports that immediately: the dialog shows No reading, with a message naming the instrument and saying it is not connected.
If the instrument is reachable but simply never sends a value, the dialog waits for roughly a minute before giving up: it moves from Waiting for instrument to No response yet - which is late, not yet a failure - and finally to the same No reading outcome if nothing arrives. In no case does the dialog show a measurement that was never actually taken, and in no case is a stale value left standing on the check.
See where a measurement came from
Every quality check keeps a record of whether its measurement was entered manually or read from an instrument, and - when an instrument was involved - which one, and when it took the reading. On the check's own form, this shows only once an instrument has actually supplied a value; a hand-filled check looks exactly as it always has.
The same information is available, column by column, on the Quality Checks list: open the column options (the icon at the right of the column headers) and add Measurement Source and Measuring Instrument. Both are hidden by default, so an existing list looks unchanged until you choose to show them.
Capture a picture from a camera instrument
A control point whose Type is Take a Picture can, in the same way, name a registered camera instrument, and the check dialog then offers a Capture from camera button beside the attachment area. No camera driver was available to exercise this path while writing this guide, so it is described here as a specified capability rather than a demonstrated one - confirm it works against your own camera hardware before relying on it.
Troubleshooting
- Measuring Instrument does not appear on the control point.
- It only shows for control points whose Type is Measure or Take a Picture. Change the type first.
- The instrument list is empty.
- The list only offers instruments of the kind this control point's type needs - a scale for Measure, a camera for Take a Picture - and only ones that belong to this control point's own company. Register a matching instrument in the IoT application first, or check its company.
- Read from instrument always shows No reading.
- Confirm the instrument's box is online and the instrument itself shows as connected in the IoT application. A pre-flight check refuses the request immediately when the instrument is not connected, rather than waiting out the full timeout.
- The check shows a warning about the unit the instrument reported.
- The control point's unit is free text, so this module cannot convert between units on its own. It warns rather than guessing - check the value yourself before validating.
- A note about a reading that never arrived shows up on a check I already closed.
- A late timeout can be reported after you close the dialog. The check itself keeps the note so you still find out; nothing was recorded as measured.
FAQ
- Does this module decide whether a check passes or fails?
- No. The tolerance rule stays the control point's own. This module only supplies the number that rule is checked against.
- What happens if I type over the value the instrument gave me?
- The check is recorded as entered manually, not as read from the instrument. Only the instrument's own, un-overwritten value counts as an instrument reading.
- Does removing or replacing a control point's instrument change past checks?
- No. Provenance already recorded on a check never changes; only which instrument the NEXT check reads from changes.
- Can I use this module without any instrument at all?
- Yes. Leave Measuring Instrument empty on a control point and it is filled in by hand exactly as before this module was installed.
- Do I need any special permission to press Read from instrument?
- No, beyond ordinary Quality user access. This module already extends that access to cover reading the instrument's name.
This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file).
You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software.
The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
