Guidance on error and warning messages for software used in radiotherapy

IEC TR 63183:2019 provides guidance on the usage and form of error or warning messages written for software used in RADIOTHERAPY. It does not replace any requirements existing in the safety standards but is meant to be used as a supplement to existing standards on usability by providing specific examples in the field of RADIOTHERAPY.
The two main goals of this document are
1) to present in a concise manner the best practices and design guidelines for good message dialogs, and
2) to illustrate these design guidelines with specific examples from the field of radiation oncology.
This document is intended to be read by the following MANUFACTURERS’ employees and representatives:
– engineering department members including: software engineers, RISK managers, quality assurance engineers, technical writers, etc.;
– usability and human factors engineers;
– marketing representatives (product marketing, product managers, business analysts).
Throughout this document, unless specifically called out, these guidelines apply to all categories of messages summarily called error or warning messages (e.g. critical error, warning, system status, informational, routine interlock messages).

General Information

Status
Published
Publication Date
10-Dec-2019
Current Stage
PPUB - Publication issued
Start Date
13-Jan-2020
Completion Date
11-Dec-2019
Ref Project

Buy Standard

Technical report
IEC TR 63183:2019 - Guidance on error and warning messages for software used in radiotherapy
English language
24 pages
sale 15% off
Preview
sale 15% off
Preview

Standards Content (Sample)

IEC TR 63183
®

Edition 1.0 2019-12
TECHNICAL
REPORT

colour
inside


Guidance on error and warning messages for software used in radiotherapy
IEC TR 63183:2019-12(en)

---------------------- Page: 1 ----------------------
THIS PUBLICATION IS COPYRIGHT PROTECTED
Copyright © 2019 IEC, Geneva, Switzerland

All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form
or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from
either IEC or IEC's member National Committee in the country of the requester. If you have any questions about IEC
copyright or have an enquiry about obtaining additional rights to this publication, please contact the address below or
your local IEC member National Committee for further information.


IEC Central Office Tel.: +41 22 919 02 11
3, rue de Varembé info@iec.ch
CH-1211 Geneva 20 www.iec.ch
Switzerland

About the IEC
The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes
International Standards for all electrical, electronic and related technologies.

About IEC publications
The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the
latest edition, a corrigendum or an amendment might have been published.

IEC publications search - webstore.iec.ch/advsearchform Electropedia - www.electropedia.org
The advanced search enables to find IEC publications by a The world's leading online dictionary on electrotechnology,
variety of criteria (reference number, text, technical containing more than 22 000 terminological entries in English
committee,…). It also gives information on projects, replaced and French, with equivalent terms in 16 additional languages.
and withdrawn publications. Also known as the International Electrotechnical Vocabulary

(IEV) online.
IEC Just Published - webstore.iec.ch/justpublished
Stay up to date on all new IEC publications. Just Published IEC Glossary - std.iec.ch/glossary
details all new publications released. Available online and 67 000 electrotechnical terminology entries in English and
once a month by email. French extracted from the Terms and Definitions clause of
IEC publications issued since 2002. Some entries have been
IEC Customer Service Centre - webstore.iec.ch/csc collected from earlier publications of IEC TC 37, 77, 86 and
If you wish to give us your feedback on this publication or CISPR.

need further assistance, please contact the Customer Service

Centre: sales@iec.ch.

---------------------- Page: 2 ----------------------
IEC TR 63183

®


Edition 1.0 2019-12




TECHNICAL



REPORT








colour

inside










Guidance on error and warning messages for software used in radiotherapy




























INTERNATIONAL

ELECTROTECHNICAL


COMMISSION





ICS 11.040.60 ISBN 978-2-8322-7715-7




  Warning! Make sure that you obtained this publication from an authorized distributor.


® Registered trademark of the International Electrotechnical Commission

---------------------- Page: 3 ----------------------
– 2 – IEC TR 63183:2019 © IEC 2019
CONTENTS
FOREWORD . 4
INTRODUCTION . 6
1 Scope . 7
2 Normative references . 7
3 Terms and definitions . 8
4 General guidance . 8
5 Designing error message displays . 8
5.1 Design systems to avoid the errors in the first place . 8
5.2 Categorize messages . 8
5.3 Consolidate reports and displayed error messages . 9
5.4 Summary of main concepts . 9
6 Message content usability guidelines . 10
6.1 Basic structure . 10
6.2 OPERATO
...

Questions, Comments and Discussion

Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.