Administrator Guide 2017
Item Type - Standard/critical contraventions
From Add Item in Template Maintenance select the Standard/critical contraventions button shown here.

From Add Item in Template Maintenance select the Standard/critical contraventions button shown here.

Additional information for situations where a contravention has occured. Standard/critical contraventions and Contravention scores currently only operate on Windows devices.

Unable to show how Standard/critical contraventions might look on a device.

Unable to show how Standard/critical contraventions might look on a device.

Main

Main screen for creating/amending a Standard/critical contraventions prompt
Main screen for setting up a Contravention.

Main screen for setting up a Contravention.

*Question This is the text “label” that is specifying the information that needs to be entered or the question to be answered. Although this is not necessarily a question in all cases, Question is used as the general term to cover the text shown next to an input field. The text should be as short as possible whilst still being self-explanatory. Over-long questions take up a lot of space on PDA screens with their restricted size, so try and make them concise. This text should be an aid to help guide the user through the screen. Any more explanatory text can be made available as “Auditor’s notes” or “Full question text”.
Mandatory

Tick this box if the question is mandatory and leave it blank if it is optional.  This will depend on whether the answer to this question is critical to the data that is being collected, such as signature to confirm customer acceptance.

*Standard contraventions list Drop-down to select list of standard contraventions available.
*Critical contraventions list Drop-down to select list of critical contraventions available.
Allow n/a option? A tick box to allow the user to mark as not applicable.
Allow free text standard contraventions? A tick box to allow the user to enter free text for standard contraventions.

Advanced

Advanced features of a Standard/critical contraventions prompt.
Advanced features of a Conraventions prompt.

Advanced features of a Conraventions prompt.

Auditor's notes

If you wish to offer the end-user guidance and direction on how to answer a question then use the Auditor’s notes field. This allows you to input any necessary text expanding on the basic question. For the end-user, the auditor’s notes are available via the “right click” option on the device – tap and hold the stylus on the question text.

Full question (for report)

The question text mentioned above should be framed in such a way as to indicate to the user the information that needs to be input. However, when this information is output on a report via the web site or a PDF additional wording may well be required. Use this field to phrase the original question in a way suitable for the report.

Cross reference

This field is output on reports to cross-reference the information with any relevant legislation etc.

Item flag

Template item flags are used to apply display classes to template item in a consistent and efficient way.  They are set up in a system list called Template item flags and might be given names such as Danger so the text appears in red, Disclaimer for smaller text, Long answer to give extra space to the answer.  This means that changing the display class can be done in one place rather than on all template items.

*Unique name

A unique name must exist for everything in a magic5 template.  It is so important that magic5 pre-fills the prompt with a non-meaningful name which it will use by default.  This does not need to be changed.

However, if the data associated with the unique name is to be used elsewhere (for example as part of a calculation, imported or exported, or carried over to a new job), it is helpful to use a meaningful name (such as RefNo, QuantityOrdered, ItemTotal, ContactName, ReasonForReferral) and this meaningful name must be entered before the template is used with real data.

If the unique name is changed at a later date, existing data will not be lost but it may no longer be accessible by magic5, in which case it cannot be displayed, used in calculations or exported.  It is therefore recommended that this is done only as a last resort and that the original template is duplicated before changes are made - this means that existing data can still be retrieved if necessary.  If in any doubt, please contact magic5 support for the best way to deal with this.

See Also