AVEVA Instrumentation Instrument Designer User Guide
AVEVA Instrumentation Instrument Designer User Guide
Instrument Engineer
User Guide
AVEVA Solutions Limited
Disclaimer
AVEVA Instrumentation provides instrument sizing calculations for estimation purposes only, end users of the
software should not rely on the calculations produced by the software for design purposes. End users should seek
the advice of certified equipment suppliers prior to specifying or purchasing equipment.
a) AVEVA does not warrant that the use of the AVEVA software will be uninterrupted, error-free or free from viruses;
b) AVEVA shall not be liable for: loss of profits; loss of business; depletion of goodwill and/or similar losses; loss of
anticipated savings; loss of goods; loss of contract; loss of use; loss or corruption of data or information; any
special, indirect, consequential or pure economic loss, costs, damages, charges or expenses which may be
suffered by the customer, including any loss suffered by the customer resulting from the inaccuracy or invalidity of
any data created by the AVEVA software, irrespective of whether such losses are suffered directly or indirectly, or
arise in contract, tort (including negligence) or otherwise;
c) AVEVA's total liability in contract, tort (including negligence), or otherwise, arising in connection with the
performance of the AVEVA software shall be limited to 100% of the licence fees paid in the year in which the
customer's claim is brought.
In the event of any conflict between the above clauses and the analogous clauses in the software licence under
which the AVEVA software was purchased, the clauses in the software licence shall take precedence.
Copyright
All intellectual property rights, including but not limited to, copyright in this manual and the associated software,
(including source code, object code, and any data) belongs to or is validly licensed by AVEVA Solutions Limited or
its subsidiaries.
All rights are reserved to AVEVA Solutions Limited and its subsidiaries. The information contained in this document
is commercially sensitive, and shall not be copied, reproduced, stored in a retrieval system, or transmitted without
the prior written permission of AVEVA Solutions Limited. Where such permission is granted, it expressly requires
that this Disclaimer and Copyright notice is prominently displayed at the beginning of every copy that is made.
The manual and associated documentation may not be adapted, reproduced, or copied, in any material or
electronic form, without the prior written permission of AVEVA Solutions Limited. The user may also not reverse
engineer, decompile, copy, or adapt the associated software. Neither the whole, nor part of the product described in
this publication may be incorporated into any third-party software, product, machine, or system without the prior
written permission of AVEVA Solutions Limited, save as permitted by law. Any such unauthorised action is strictly
prohibited, and may give rise to civil liabilities and criminal prosecution.
The AVEVA products described in this guide are to be installed and operated strictly in accordance with the terms
and conditions of the respective licence agreements, and in accordance with the relevant User Documentation.
Unauthorised or unlicensed use of the product is strictly prohibited.
Copyright 2000 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved.
The AVEVA Instrumentation user interface is based on the Microsoft® Office Fluent™ user interface.
Trademarks
AVEVA and Tribon are registered trademarks of AVEVA Group plc or its subsidiaries. AVEVA product names are
trademarks or registered trademarks of AVEVA Solutions Limited or its subsidiaries. Unauthorised use of
trademarks belonging to AVEVA Group plc or its subsidiaries is strictly forbidden.
Microsoft® Office Fluent™ user interface. Fluent is a trademark of Microsoft Corporation and the Fluent user
interface is licensed from Microsoft Corporation. The Microsoft Office User Interface is subject to protection under
U.S. and international intellectual property laws and is used by AVEVA Solutions Limited under license from
Microsoft.
DevExpress® redistributables are used by AVEVA under license from Developer Express Inc. Copyright © 2000-
2014 Developer Express Inc.
AVEVA Solutions Ltd, High Cross, Madingley Road, Cambridge, CB3 0HB, United Kingdom.
Instrumentation Engineer User Guide
Revision Sheet
Contents Page
Instrument Engineer
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1
Feature Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:4
AVEVA Instrumentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:4
Guide Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:4
Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:1
Instrument List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:1
Datasheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:1
View/Edit Instrument Datasheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:1
Datasheet Data Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:2
Copy Tag Data during Data Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:6
Convert Process Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:7
Datasheet Change Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:9
Datasheets List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:10
Add New Datasheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:13
Edit Datasheet Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:15
Assign Tags To Datasheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:18
Assign Tags from the Datasheet Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:18
Batch Assign Multiple Tags to Datasheets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:19
Delete Datasheet Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:21
Print Datasheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:22
Datasheet Revisions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:22
Create a Revision. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:23
Edit a Revision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:24
Viewing and Editing Multiple Datasheet Revisions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:25
Datasheet Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:26
Highlight Datasheets for Reissue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:27
View a List of Previous Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:27
Import Datasheets from Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:28
Import Datasheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:28
Accept Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:31
Datasheet Publishing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:32
Publishing Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:32
Publish Datasheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:34
Merge Datasheets into a Single Document . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:34
Assign Datasheets to the Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:35
Unassign Datasheets from the Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:36
Enter Basic Document Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:36
Save and Publish the Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:40
Document List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10:41
Exports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12:1
Export to Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12:1
Export to XPS and PDF Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12:1
Export Selected Datasheet Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12:1
Export Datasheets to a Specified Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12:2
Export Datasheets to Pre-Defined Folders with File Names in a Pre-Defined Format. . . . 12:3
Export to AVEVA NET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12:5
AVEVA NET Export Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12:5
Export Data from Grids. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12:7
Export Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12:8
Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15:1
Instrument Sizing Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . .A:1
AVEVA NET Export Configuration Files . . . . . . . . . . . . . . . . . . . . . .B:1
1 Introduction
The Instrument Engineer User Guide is designed to help the user learn the Instrument
Engineer module of AVEVA Instrumentation. The guide describes how to create detailed
project instrument, loop, cable and wiring termination data.
Instrument Engineer manages all tasks typically handled by an Instrument Engineer during
a project life cycle, including instrument index data entry and reports, the generation of
instrument datasheets (specification sheets), process data import/entry and document
management (revision control, batch printing etc.). Instrument Engineer can be used to:
• Manage all project instrumentation data.
• Generate instrument datasheets or spec sheets automatically from the AVEVA
Instrumentation database in Microsoft Excel format (xls).
• Create instrument tags and their wiring data (terminals, junction box allocations,
cables, wire terminations and wire numbers) automatically from “wiring rules” directly
into AVEVA Instrumentation Wiring Manager database.
• All data from Instrument Engineer (Manufacturer, model number, range, P&ID drawing
number, I/O etc.) can be used in loop diagrams generated by AVEVA Instrumentation
Instrument Designer.
• Produce reports, for example:
Instrument List (or Instrument Index)
Loop List
I/O Allocations
Datasheet List
Changes to Instrument data
For more information refer to Feature Overview.
Loop List
• Creation of new loops using the advanced user interface (pick lists, auto tag build, add
from instrument index etc.).
• Assigning of instruments to loops (from instrument list or create new tags on the fly).
• Editing of instrument data of any instrument assigned to a loop (i.e. access Instrument
List data from Loop).
• Definition of “wiring rules” for each loop tag and generate all field cables, equipment
terminals and wire terminations in Wiring Manager application. Refer to Instrument and
Loop Wiring.
Note: An AVEVA Instrumentation Wiring Manager license is required to access Wiring
Rules.
• Database fields are automatically transferred to Designer's Drawing List (creates new
drawings, if required, and updates loop number, service etc.).
• Loop Wiring check enables printing and previewing loop wiring without CAD.
• Change management: Report all loops added, deleted and renamed. Report detail
changes in each field (e.g. Loop No. now ABC was XYZ).
• Export of loop data to AVEVA NET.
Datasheets (Specifications)
• Assigning of instruments to datasheets (supports multiple tags per datasheet).
• Control of the printing and updating of datasheets in 'batch' mode.
• Document management - control document revisions etc.
• Datasheets use Microsoft Excel spreadsheets to define form layout for: Data Entry (if
fields are not updated from Instrument List, Document List or Process Data list).
Formatting/printing (user defined format).
• Datasheets are stand-alone documents (Excel spreadsheets) for easy exchange with
third parties.
• Importing and exporting of data from spreadsheets completed by vendor or client etc.,
highlight changes, accept and reject etc.
• Fully user-definable datasheet design (form layout and cell/database mapping and user
table design).
• Copy datasheet design (form layout/setup etc.) from other AVEVA Instrumentation
projects.
• Tools to copy data from other tags and/or datasheets.
• Auto-input default Process Units (user definable).
• Import/export of Process Data from/to Excel (highlight changes, accept/reject etc.).
• Viewing/editing of Process Data in a grid for easier management of process data
across multiple datasheets and tags.
• Viewing/editing of all Datasheet data by form type in a grid for easier management of all
data across multiple datasheets and tags.
• Change Management: Highlight changes between Issues (revisions) e.g. Pressure
Max now: 2000 kPa.
• Viewing of previous Issues.
• Printing of datasheets to PDF format files.
• Merging of multiple datasheets into single documents for joint publication. Documents
are accessible from Documents grid.
• Export of datasheet data to AVEVA NET.
Change Management
• Report all instruments/datasheets added, deleted and renamed.
• Report detail changes in each field (e.g. Model No now XXXX was YYYY).
• Log changes for future reporting (e.g. Tag FT-600 changed: Model No. 1234 was 4567
etc.).
• Audit Manager enables users to view changes by object type.
Reports
Instrument Engineer supports the following user definable reports:
• Instrument List (or Instrument Index), DCS I/O, PLC/ESD I/O etc.
• Loop List.
• Datasheet List (document list).
• Process Data List.
• Data by form type (e.g. Report all tag data on all 'Orifice Plates' datasheets).
• Tags assigned to data sheets.
• Database changes between Revisions.
• Reports and associated data can be exported to AVEVA NET.
By default, all new projects have the Security Rights features disabled for backward
compatibility with earlier versions of AVEVA Instrumentation. If security is required it must be
turned on using the AVEVA Instrumentation Security Manager. Users must then be allocated
to 'Security Groups' such as Engineers and Designers, Read-Only Users etc. Refer to the
AVEVA Instrumentation Security Manager User Guide for more information.
Options and Setup describes how to set various Instrument Engineer options,
preferences and data used when specifying instrument etc,
such as process units, tag formats etc.
Areas describes the Plant Areas on which all objects are based -
once the project is setup the first task is to add the various
plant areas to the project database.
Instrument List describes the main Instrument Index window used for adding/
editing instruments in the Index, and related facilities.
Process Data, describes how to view and edit instrument process data, and
Equipment and Lines how to view project process items (equipment and lines).
Loop List describes the main window for adding/editing Loops to the
project and to assign instruments, and related facilities.
Instrument and Loop how to use 'Wiring Rules' to auto generate typical field
Wiring instrument and loop wiring/cabling.
Exports includes facilities to export files of item data and report PDF
files for import into AVEVA NET.
Work Packs can be created with selected equipment and time scales for a
particular project.
Change Reports has an in-built Audit Manager that enables users to view
database changes made during the project in the database
audit log.
AVEVA NET Export explains the configuration required for AVEVA NET Export.
Configuration Files
2 User Interface
When Instrument Engineer starts up, the AVEVA Instrument Engineer window is displayed
showing the Home tab.
• Claims
Edit Process Units Enables users to add and edit Process Units to AVEVA
Instrumentation. Refer to Process Units.
Project Voltages Enables users to define the voltages to be used on the project
when defining the power supply details of powered
instruments. Refer to Project Voltages.
Property Definitions Displays the Property Definitions window, used to add and edit
instrument and process properties.
Tag Formats Enables the user to select existing Tag Formats, create new
tag formats and edit existing tag formats.
Set Datasheet Export Enables users to define rules to enable datasheet Excel files to
File Name / Folders be automatically renamed when copied out of AVEVA
Instrumentation into user-defined folders. Refer to Export
Selected Datasheet Files.
Drawings Export to Enables the user to select where the publishing folder is
External System located when exporting to an external system, which
Configuration executable format is required and fields of information written
for each published item. Refer to Datasheet Publishing.
AVEVA P&ID Import Displays the AVEVA P&ID Data Import Configuration
Configuration window. Refer to AVEVA P&ID Tag Data Import Configuration
for further information.
Instruments Displays the Instrument List, which is used to view, create and edit
instrument tags.
Loops Displays the Loop List, which is used to view, create and edit loops
and assign instruments to each loop.
Process Data Displays the Process Data List, a list of all process data fields for
tags assigned to datasheets.
Browse Data by Displays the View Data by Form Type list of instruments by the
Form Type associated with a selected datasheet form type, which enables
viewing of multiple datasheet tag data.
Document List Displays the Document List, which is used to view, create and edit
documents (collections of datasheets).
Instrument Displays the list of Instrument Loads, i.e. instruments which have
Loads power requirements.
Process Lines Displays the list of Process Lines. Refer to Process Equipment and
Lines.
Datasheets Displays the Datasheet Form Catalogue Grid, list of user defined
datasheet form definitions.
Publish to AVEVA Used to export data to AVEVA NET. Refer to Export to AVEVA
NET NET.
AVEVA P&ID Import Used to import data from AVEVA P&ID. Refer to Import Tags
from AVEVA P&ID and Import Loops from AVEVA P&ID
AVEVA Diagrams Used to import data from AVEVA Diagrams. Refer to AVEVA
Import Configuration Diagrams Instrument Tag Import for further information.
From Other Project Used to import instrument catalogue items from another project.
Refer to Import Catalogue Instruments from another Project
I/O Allocations Used to import I/O Allocations from an Excel spreadsheet. Refer
to I/O Allocations.
2.10 Claims
If a user attempts to edit an item which is currently being edited by another item, a message
is displayed to inform the user that the item is locked. For details of how to unlock claims,
refer to the Common Functionality User Guide.
A number of setup procedures may need to be carried out to specify options and for
entering and setting up data required when specifying engineering data. Continue at:
• Options
• Process Units
• Project Voltages
• Property Definitions
• Tag Formats
• Class Definitions
• Instrument Type Catalogue
• Loop Type Catalogue
3.1 Options
The Preferences window enables the user to:
• change the field label captions on the New and Edit Tag windows, on Edit Process
Equipment and Edit Process Line windows, and on the Datasheet Revision window,
• specify whether or not duplicate instrument tags are permitted as long as they are in
different project locations,
• specify whether the values of associated process lines can be used when performing
instrument sizing calculations, and
• to set other options related to datasheets.
To open the Preferences window, click Options on the Project tab.
The window is then displayed with the Instruments tab selected.
Instruments Tab
In the Sizing Calculation Properties section, click Process Item Properties if the values
of associated process lines can be used when performing instrument sizing calculations. If
the values must be entered manually, leave the Instrument Process Properties option
selected.
The Grid Captions section can be used to specify alternative field captions for fields on the
New and Edit Tag windows (for creating and editing instruments), if required.
By default, the Grid Captions grid is inactive and the captions cannot be amended. To
activate the grid check the Use Gridview Captions for Instrument Edit dialog checkbox.
The user can now amend any of the Caption column fields.
The user can revert back to the default settings by un-checking the Use Gridview Captions
for Instrument Edit dialog checkbox.
By default, every instrument tag in the project must be unique. However, if required,
duplicate tags may be permitted as long as they unique within their project location. Check
the Allow duplicate Instrument Tags in different locations checkbox if this is required.
Note: Duplicate tags can only be created in Engineer. In other words, field devices created
in Equipment list in Wiring Manager, even though they are also in the Instrument List,
cannot have duplicate tags.
The Process Data tab is used specify alternative field captions for fields on the Edit
Process Equipment and Edit Process Lines windows, if required.
By default, the grid is inactive and the captions cannot be amended. To activate the grid
check the Use Gridview Captions for Process Data Edit dialog checkbox. The user can
now amend any of the Caption column fields.
The user can revert back to the default settings by un-checking the Use Gridview Captions
for Process Data Edit dialog checkbox.
Datasheets Tab
On the Datasheets tab, the user can set the number of revisions that appear in the history
list and change the default Field Name captions.
To change a Field Name caption, enter the required text in the Caption field and check the
Use box. If no text is entered into the Caption text fields and the Use checkbox is checked,
the default name shown in the Field Name column will be used.
If the Use checkbox is left un-checked, the default Field Name and any text in the Caption
field with be ignored.
The properties of each datasheet include an “of” value. For example, a datasheet may be
sheet 1 of 2. If this value (e.g. “2”) is to be calculated either by simply totalling the number of
sheets with the same datasheet number, the Use MAX sheet No. as value for Sheet Of:
should be checked.
If the first sheet number (i.e. the lowest) is to be used as the basis for this calculation, this
checkbox should be unchecked. In other words, when the lowest number is more than one,
then the sheets with lower numbers that are implied to exist are taken into account.
If this setting is changed, a message will be displayed when preferences are saved asking
whether or not sheet numbers for existing datasheets should be recalculated. If No is
clicked, the change will only be applied to datasheets subsequently created or updated.
If when an instrument tag is assigned to datasheet, the Requisition Number of the datasheet
is to overwrite that of the instrument, check the Overwrite Tag Requisition Number
checkbox (the default setting). Otherwise uncheck the checkbox.
If the checkbox is checked, if the datasheet is deleted or the instrument tag is unassigned
from it, the Requisition Number is deleted from the instrument tag details.
To save any changes made to the Instruments or Datasheets tabs and close the
Preferences window, click Save. Click Cancel to close the Preferences window without
any changes.
If a unit is set as the default, and if the Apply Default Units checkbox of the Process Data
grid is checked, when a value of the unit's process property is entered for an instrument in
the Process Data grid, this unit is automatically applied to that value and added to it in the
grid.
To create a new process property, select the empty space in the drop down list (beneath
ALL in the list), and enter the name of the new process property. Click Add New Process
Property. A process property with the entered name is then created.
To delete a process property, delete all the units of that property.
To save changes and exit the window, click Save.
If more than one unit within a process property has been set as the default, a message is
displayed informing the user of this. The save will not take place and the window will remain
open. Rectify the problem and then click Save again.
To exit the window without saving any changes, click Cancel.
Enter the volts in the field provided and select the number of phrases and the frequency
from the lists of values.
Click Save. The Voltage Detail window is closed and new project voltage is added to the list
in Voltages window.
To edit an existing voltage, select it from the list and click Edit. The Voltage Detail window is
then displayed with the details of the selected voltage displayed.
Edit the details as required and click Save.
To delete a voltage, select it from the list and click Delete. A message is then displayed
requesting confirmation of the deletion. Click Yes to continue with the deletion.
Multiple records may be selected for deletion.
Note: If the user has a Catalogue Datasheet open at the same time as creating a new field,
the new field does not display until the datasheet is closed and then re-opened.
To display the Property Definitions window, select Setup > Property Definitions from the
Project tab:
Select InstrumentData from the Object Type list to view instrument properties and
ProcessData to view process properties.
Enter values in the Property Name and Caption fields. The Property Name must be
completed and a message is displayed if no value is entered into the field, or if the name
has been used before. For example:
If no value is entered in the Caption field, the value in the Property Name is used.
Select the data type of the property (text, numeric (decimal), numeric (integer) or True/
False) from the Data Type list.
If the property type is process, if the new property has units, check the Has Units checkbox
(not present for instrument property types).
If the property is to be available when constructing queries for custom reports (refer to
Common Functionality documentation for details), check the Available for Custom
Reports checkbox. Note that a maximum of 1024 properties can be made available.
If data entered for the new property is to be restricted to the values in a pick list, click the
button in the Pick List field. The Select Picklist window is then displayed:
Select the required picklist by double-clicking on it or clicking on it and clicking Select. The
window then exits and the selected picklist is displayed in the Pick List field.
If a numeric data type was selected in the Data Type field, the minimum and maximum
values that may be entered for the property may be specified in the Minimum Value and
Maximum Value fields.
For any data type except True/False, entries for the property may also be validated against
a regular expression entered in the Regular Expression field.
Click OK to return to the Property Definition window.
When all the required data for the property definition has been entered, click OK to return to
the Property Definitions window, where the new definition will now be listed.
If the property type is process, if the Has Units checkbox was checked, a property definition
for the units of the new property is automatically created at the same time.
The name of a units property definition will be the name of the new property suffixed with the
units suffix specified in the Please enter a new Units Suffix window (see Preferences - the
default suffix is “Units”). The data type of units property definitions is text. Neither this or the
name may be changed.
The Property Name field cannot be edited. All other attributes may be edited. Click OK to
exit the window and save any changes.
If the selection has no tags associated with it, a message will be displayed asking the user
to confirm the deletion.
Click Yes to confirm the deletion and return to the Property Definitions window. The
deleted property will be removed from the grid view.
Click No to cancel the deletion and return to the Property Definitions window.
The user can now enter a value for the Merged Property Name and Merged Property
Caption. The Merged Property Name is mandatory and a message is displayed if no value
is entered into the field.
Note: If the Delete existing Properties box is checked, all references will be set to the
new property.
The user must check one of the radio buttons in the bottom pane to select which one of the
existing properties values will be saved to the newly merged property.
Note: If the Available for Custom Reports checkbox of any of the property definitions
being merged is checked, the checkbox for the merged property will also be
checked.
The user can now select individual properties to import by clicking their Select checkboxes,
or choose all the properties by clicking Select all. Clicking Cancel will return the user to the
Property Definitions window without merging any properties.
Click Import to start the import process. A progress bar will be displayed followed by the
Import Log window.
The Import Log window shows the user the import status and displays the successfully
imported files in the grid view.
Clicking Close closes the Import Log window. The imported definitions will be displayed in
the Property Definitions window.
3.4.6 Preferences
Click Preferences to display the Please enter a new Units Suffix window.
Enter a new suffix for the names of automatically generated units property definitions for
process property definitions with units (see Add New Property Definition). Click Save. All
units property definition names are automatically updated to include the new suffix.
33-FT-600 Typical ISA style tag format where Tag is prefixed with its plant area
number (33, separated by delimiters (dashes).
Tag Formats are selected for each AVEVA Instrumentation instrument and loop class (refer
to Class Definitions for details) to define how the tag numbers of items within these classes
are formatted.
To view, edit and create Tag Formats click Setup > Tag Formats in the Project tab to
display the Tag Formats window.
The window initially lists the existing tag formats for instruments.
Select Loops from the Format for list to view the existing tag formats for loops.
Use the New button to create a new tag format. Continue at Define a New Tag Format.
Use the Edit button to edit an existing tag format. Continue at Edit a Tag Format.
Use the Delete button to delete a tag format. Continue at Delete a Tag Format.
Enter a project-unique name for the new format in the Tag Format field. Complete the
Description and Remarks fields as required.
The instrument attributes (“tag codes”) that the tag format will consist of, their order and the
delimiters separating them (if any), are defined in the Tag Codes section of the window.
Note: The list of available tag codes can be edited via the Tag Codes button. This must be
done before any tag codes are specified for a tag format (the Tag Codes button is
disabled once a tag code is selected). See Edit the List of Available Tag Codes for
details.
To add a tag code, click “Click here to assign Tag Code...” in the Tag Code field. A list of tag
codes (i.e. instrument attributes) is then displayed:
An example tag number in the specified format is displayed above the list of tag codes.
To change the order of a tag code and its following delimiter, select it, and click Up or Down
as appropriate to move the tag code up or down one position in the list of codes.
To delete a tag code and its delimiter, select it and click Remove. A message will be
displayed requesting that the user conform the deletion. Click Yes to continue.
Click Apply to save the new tag format without exiting the window.
Click OK to save the new tag format and exit the window.
Click New to clear all the window of all data.
Click Cancel to exit the window without saving the new tag format.
Note: The list of available tag codes can be edited via the Tag Codes button. This must be
done before changes to the tag codes are specified for a tag format (the Tag Codes
button is disabled once a tag code is selected). See Edit the List of Available Tag
Codes for details.
The window lists all tag codes. Tag codes currently available when constructing tag formats
have their Select checkboxes checked.
To make further tag codes available, check their Select checkboxes.
To make a currently available tag code unavailable, uncheck its Select checkboxes. Note
that this cannot be done for tag codes that have been used to construct a tag format. A
message is displayed to inform the user of this if it is attempted.
Note: New tag codes automatically have their Select checkboxes checked.
Modify the attributes of the tag code as required, then click OK or Apply. Note that the field
name cannot be edited.
If the tag format can be deleted, the deletion is then carried out.
The window initially lists the existing class definitions for instruments. To view the class
definitions for loops instead, select Loops from the Format for list.
Continue at:
• Create New Classes
• Edit Classes
• Delete Classes
• Export Classes to Excel
• Import Classes from Excel
• Assign Tag Formats to Classes
To create a new class for instruments, select Instruments from the Format for list. To create
a new class for loops, select Loops from the Format for list.
Next, click New. The Class Details window is then displayed:
Enter the required details in the Class Name, Class Description and Remarks fields.
The Class Name and Class Description fields cannot be left blank. The entry in the Class
Name field must be unique for the project (i.e. it cannot be a name that another class
already has).
Click Apply to save the new class without exiting the window.
Click OK to save the new class and exit the window.
Click New to clear all the fields.
Click Cancel to exit the window without saving the new class.
Edit the details of the class as required. The Class Name and Class Description fields
cannot be left blank. The entry in the Class Name field must be unique for the project (i.e. it
cannot be a name that another class already has).
Click Apply to save the changes without exiting the window.
Click OK to save the changes and exit the window.
Note: “System” classes, i.e. those supplied with the product cannot be deleted. Neither can
classes that have been assigned a tag format. A message will be displayed to inform
the user why the selected class cannot be deleted.
If classes that can be deleted were selected, the following message is displayed.
Select the filename, location and format in the usual way, and click Save to complete the
procedure.
Note: To minimise the possibility that data currently being worked on by another user may
be affected by an import, a list of the users working on the current project is available
from the UserCount link. The number of current users is displayed next to the link.
This total includes the user performing the import.
The Excel Column Name fields display the names of the columns in the spreadsheet. The
AVEVA Instrumentation Field fields displays the Instrumentation fields they are mapped
to.
To map an Excel Column to an AVEVA Instrumentation database field, click in the AVEVA
Instrumentation Field field adjacent to the relevant Excel Column Name field, and select
the required AVEVA Instrumentation field from a drop-down list. To exclude a field from the
import, click Clear button in the grid against the field to be excluded or select the blank entry
from the mapping drop-down list.
Note: AVEVA Instrumentation automatically checks each Excel Column Name from the
first row in the Excel worksheet against fields names in AVEVA Instrumentation
Database (if not found then the field Captions - as set in the Grid Manager). If a
match is found then AVEVA Instrumentation automatically adds the Field Name to
the mapping list. The user can select a different field from the mapping list if required.
Once the name and description for the mapping have been entered, click Save and the
mappings will be saved and added to the Saved Mappings drop down.
Note: Data can also be imported by just clicking on the Import button. However it may
save time to save the mappings if an import with those mappings is to be performed
again.
AVEVA Instrumentation displays a window showing all the columns in the Excel Workbook
selected earlier.
Once the mappings have been set up, click Import.
AVEVA Instrumentation will display the Import Options window from which the user may
choose to import reports one by one or in a batch. The batch option processes all records
together then displays a differences report enabling users to accept or reject each change.
The one by one option displays a differences report for each record one at a time.
Click on the required option. If field mappings are being tested, it is recommended that the
Process each Record and Show Differences one by one option is selected. AVEVA
Instrumentation will then process the data and show any differences in the Import
Differences window:
The Import Differences window shows the differences between AVEVA Instrumentation
data and proposed (imported Excel) data. If the one by one import option was selected, the
difference for a single record are listed. If the batch option was selected, differences for all
records are displayed.
To accept the changes either select individual field data by clicking the Accept checkbox for
each, or select the Accept All checkbox at the top of this window (all individual records will
be auto-selected).
To save the checked (accepted) data to the project, click Save.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel any import for the current tag record, click Close.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
The Import Log window shows the user the import status and displays the successfully
imported files in the grid view.
The window lists all tag formats for either instruments or loops as appropriate.
To assign a tag format to the class, click its Assign checkbox.
A primary tag format must be specified. To do so, check the appropriate Primary checkbox
of an assigned tag format. Doing so automatically unchecks any previously checked
Primary checkbox.
The primary tag format will be the format selected by default when creating an instrument or
loop associated with the class. The other assigned formats will also be available for
selection if required.
Click Save to exit the window and save the changes.
Click Close to exit the window without saving any changes.
Note: By default, the Instrument Types Catalogue window is displayed when the above
option is selected. To open the Loop Type Catalogue window, select Loops from the
Catalogue for list. Select Instruments from the Catalogue for list to open the
Instrument Type Catalogue window again.
Whether or not a wiring rule and operation principle may be viewed when creating and
editing instrument types is controlled by the Enable Tag Catalogue mode checkbox. If the
checkbox is checked, additional fields are displayed in the Instrument Type Catalogue
window:
These additional fields are also available in the windows used for creating and editing
instrument types (see below).
Continue at:
• Create New Instrument Types
• Edit Instrument Types
• Delete Instrument Types
• Export the Instrument Type Catalogue to Excel
• Import the Instrument Type Catalogue from Excel
From the Class Name list select the class of the instrument type. The Class Description
field is automatically completed with the description of the selected class.
In the Function field, enter the instrument type function. Enter a description of the function
in the Description field.
The Class Name and Function fields cannot be left blank. The combination of class and
function must be unique, i.e it cannot already been have assigned to another instrument
type.
From the System list, select either DCS or PLC as appropriate. The selection controls
which system fields (DCS or PLC/ESD) are automatically populated by the instrument type’s
I/O Type and Location details (see below) when an instrument of this type is created. This
field cannot be left blank.
If required, select an I/O type and location from the I/O Type and Location lists.
If the catalogue is in tag catalogue mode, additional fields are displayed:
If required, select a wiring rule and operating principle from the Wiring Rule and Operating
Principle fields.
Click Apply to save the new instrument type without exiting the window.
Click OK to save the new instrument type and exit the window.
Click New to clear all the fields.
Click Cancel to exit the window without saving the new instrument type.
Note: Editing an instrument type will not change details of instruments previously created
using that type. Only instruments subsequently created will be affected.
Select the filename, location and format in the usual way, and click Save to complete the
procedure.
Note: Importing an instrument type that already exists in the project will not change details
of instruments previously created using that type. Only instruments subsequently
created will be affected.
To import from a spreadsheet, click Import from Excel. The Select excel workbook to
import window is displayed:
Browse for the spreadsheet that data is to be imported from and click Open. The Import
Fields window is then displayed:
Note: To minimise the possibility that data currently being worked on by another user may
be affected by an import, a list of the users working on the current project is available
from the UserCount link. The number of current users is displayed next to the link.
This total includes the user performing the import.
Select an existing Field Mapping (if one for this Import type exists) from saved mappings
drop down or use the automatic mappings created by AVEVA Instrumentation and make
changes to these mappings (if required).
The Excel Column Name fields display the names of the columns in the spreadsheet. The
AVEVA Instrumentation Field fields displays the Instrumentation fields they are mapped
to.
To map an Excel Column to an AVEVA Instrumentation database field, click in the AVEVA
Instrumentation Field field adjacent to the relevant Excel Column Name field, and select
the required AVEVA Instrumentation field from a drop-down list. To exclude a field from the
import, click Clear button in the grid against the field to be excluded, or select the blank
entry from the mapping drop-down list.
Note: AVEVA Instrumentation automatically checks each Excel Column Name from the first
row in the Excel worksheet against fields names in AVEVA Instrumentation Database
(if not found then field Captions, as set in the Grid Manager). If a match is found then
AVEVA Instrumentation automatically adds the Field Name to the mapping list. The
user can select a different field from the mapping list if required.
Once the name and description for the mapping have been entered, click Save and the
mappings will be saved and added to the Saved Mappings drop down.
Note: Data can also be imported by just clicking on the Import button. However it may
save time to save the mappings if an import with those mappings is to be performed
again.
AVEVA Instrumentation displays a window showing all the columns in the Excel Workbook
selected earlier.
Once the mappings have been set up, click Import.
AVEVA Instrumentation will display the Import Options window from which the user may
choose to import reports one by one or in a batch. The batch option processes all records
together then displays a differences report enabling users to accept or reject each change.
The one by one option displays a differences report for each record one at a time.
Click on the required option. If field mappings are being tested, it is recommended that the
Process each Record and Show Differences one by one option is selected. AVEVA
Instrumentation will then process the data and show any differences in the Import
Differences window:
The Import Differences window shows the differences between AVEVA Instrumentation
data and proposed (imported Excel) data. If the one by one option was selected, the
difference for a single tag record are listed. If the batch option was selected, differences for
all records are displayed.
To accept the changes either, select individual field data by clicking the Accept checkbox for
each, or select the Accept All checkbox at the top of this window (all individual records will
be auto-selected).
To save the checked (accepted) data to the project, click Save.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel any import for the current tag record, click Close.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
The Import Log window shows the user the import status and displays the successfully
imported records in the grid view.
Note: Select Instruments from the Catalogue for list to return to the Instrument Type
Catalogue window.
Continue at:
• Create New Loop Types
• Edit Loop Types
• Delete Loop Types
• Export and Import the Loop Type Catalogue
From the Class Name list select the class of the loop type. The Class Description field is
automatically completed with the description of the selected class.
In the Loop Code field, enter the loop type code. Enter a description of the code in the
Description field.
The entry in the Order field defines the position in which a loop type will appear in the list of
values. The lower the order number, the higher the position. Loop types with the same
number will be listed in alphabetically order.
For example, in the screen example above (see Loop Type Catalogue), there are many loop
types with an order value of 99. These will be listed after those loop types with lower order
values, in alphabetical order. If no order number is entered for a loop type, it will appear at
the bottom of the list of values.
The Class Name and Loop Code fields cannot be left blank. The combination of class and
loop code must be unique, i.e it cannot already been have assigned to another loop type.
Click Apply to save the new loop type without exiting the window.
Click OK to save the new loop type and exit the window.
Click New to clear all the fields.
Click Cancel to exit the window without saving the new loop type.
Note: Editing a loop type will not change details of loops previously created using that type.
Only loops subsequently created will be affected.
4 Areas
All Engineering items in AVEVA Instrumentation must be assigned to a Plant Area. The first
task once the project is setup (refer to the Installation User Guide for further information on
project setup), is to add areas to the project database.
For a description of this functionality, refer to the Common Functionality User Guide.
5 Instrument List
The Instruments List is the main Instrument Index window for adding/editing instruments in
Engineer's Instrument Index. By default all instruments for the project are shown in the
Instrument List grid.
A “sub-grid” below the main grid lists the process items (equipment and lines) associated
with the currently selected instrument.
The viewable columns, their captions, column size and order are user definable using the
Grid Manager utility.
Instrument Engineer allows Instruments to be created without assigning them to a loop. For
example pressure gauges, relief valves etc.
A catalogue of common instrument definitions may be created for use when creating
instruments with common attributes.
Refer to Working with the Data Grid for information on the grid controls including selecting
an instrument record, and sorting and filtering the grid data.
The Instrument List consists of two grids. The main, upper grid displays details of the
instruments in the project.
The lower grid displays details of any process items (equipment and lines) assigned to the
instrument (see Assign Process Equipment and Process Lines) currently selected in the
upper grid. Switch between displaying equipment and lines in the lower grid by clicking the
Associated Process Equipment or Associated Process Lines button. Data in the lower
grid cannot be edited in Instrument Engineer. The lower grid can be closed and re-opened
by clicking Show Process Items in the Associated Items Section of the List Tools -
Instruments tab.
Grid PickLists
Some Instrument List grid cells contain pick lists (e.g. Area No, Location, Project Status,
Description, Manufacturer, I/O Type etc.). The value list in each pick list are generally
loaded from both the PickList library, plus any value that has been entered in a pick list's
field. Therefore manually adding a value into the pick list will add that new value to the pick
list for future use.
Note: A pick list may be set so that grid cells must be completed with the values in it, i.e.
other values may not be manually entered.
Note: Any value manually added directly into a grid pick list does not get added to the pick
list's value list until the user clicks Refresh in the Records section of the Home tab,
or the grid is re-loaded (e.g. Instrument Engineer is re-started).
Note: The Location field can be used to change the project location of an instrument. If the
Allow duplicate Instrument Tags in different locations checkbox on the
Instruments tab of the Preferences window is checked (refer to Options for details),
instrument tags need not be unique in the project, as long as their location codes, as
specified here, are different. Be aware of this when changing the location of
instruments.
The following options are located on the List Tools - Instruments tab:
Records Section
Refresh
New These common options are also located on the Home tab.
Edit Refer to the Common Functionality User Guide for details.
Delete
Actions Section
Show Un-Wired This checkbox is used to filter the grid so that only unwired
instruments are listed. Uncheck the checkbox to remove the
filter.
Sizing Calculation Used to perform sizing calculations for the selected instrument.
Refer to Perform Instrument Sizing Calculations for details.
Bulk Edit Used to edit multiple instrument numbers. Refer to Edit Multiple
Instrument Instrument Numbers for details.
Numbers
Bulk Update Tag Used to change the tag format of multiple instruments. Refer to
Format Edit Tag Formats of Multiple Instruments for details.
Open for Selected Opens a list of the documents attached to the selected
instrument.
Change Folder Used to change the folder in which the attached documents of
selected instruments are located.
Refer to Attachments (External Documents) for more information on these two options.
Associate Process Used to associate process lines with the instrument currently
Lines selected in the Instrument List.
Show Process Used to show and hide the lower grid of the Instrument List,
Items which displays the process items associated with the instrument
currently selected in the Instrument List.
Refer to Assign Process Equipment and Process Lines for more information on these
options.
Note: Instrument tags must be unique, either across the entire project, or within their
project location (as selected from the Location Code field in the Add New Tag
window - see below).
For duplicate tags to be permitted in different locations, the Allow duplicate
Instrument Tags in different locations checkbox on the Instruments tab of the
Preferences window must be checked (refer to Options for details).
If a tag number is not unique within the project or location, when the user attempts to
save the instrument, a warning message will be displayed to alert the user of this,
and the save will not take place.
The Class list consists of all classes to which tag formats have been assigned (refer to
Class Definitions for details of classes and tag format allocation). Select the required class.
The Tag Format list is then populated with all the tag formats that have been assigned to
the selected class (the class designated the primary class is automatically pre-selected).
Select the required tag format from this list.
The fields displayed under the Tag Format list will depend on the fields that the selected tag
format consist of (refer to Tag Formats for details). For example, if a different tag format
from that displayed above is selected, the displayed fields will change to reflect this. For
example:
Note that any delimiters defined for tag format are displayed after the fields they follow.
Complete the fields as required. Note that if the tag format includes “Function”, the list of
available functions will be restricted to those associated with the selected class (refer to
Instrument Type Catalogue for details).
The entered tag number is displayed at the bottom of the window. For example:
When the required tag data has been entered, click OK to display the Add New Tag
window:
Note: Field captions in this window are user definable. To change captions use the
Preferences window, accessed from the Project menu.
The user can change the caption for each of the fields, for example Tag No: can be
changed to read Tag Number: For more information refer to Options and Setup.
To change the tag number, click the button next to the Tag No field to display the
Instrument Tag window again (see above).
If the selected tag format for the item includes “Area”, the Area No field displays the plant
area that the instrument is in, and cannot be changed. If the tag format does not include the
plant area, select it this field.
Any System, I/O Type, Location, Wiring Rule and Operating Principle details associated with
the instrument type of the selected tag format are automatically assigned to the new
instrument. These may subsequently be changed if required.
checked (refer to Options for details), instrument tags need not be unique in the project, as
long as their location codes, as specified here, are different.
Loop Order is used to sort instruments within a loop. It has no other purpose.
Loop Number and Loop Service are not editable fields. These fields are populated by data
from the loop to which the instruments is assigned, if applicable, refer to Assign Instrument
Tags to Loops.
Data on several of the fields in this window can be shared with a datasheet defined in the
Datasheet Catalogue for the project.
Wiring Config on the Detail tab is used to assign a wiring rule to the instrument. Refer to
Instrument Wiring. The name is used to auto generate the instrument termination
arrangement including terminal details, cable type, connection arrangement and wire ferrule
numbers etc. Typically this choice is made by the person responsible for detail wiring
design. It can also be edited from the Designer application. Specifying a wiring rule enables
AVEVA Instrumentation to create the field device and terminals in Wiring Manager.
PickLists (pull downs) can be updated with new values to choose from by selecting the
button to the right of most pull-down options. Exceptions are: Area (based on project Areas
defined), Description (based on the ISA Tag Catalogue and any previous value entered for
Description), Wiring Config (based of project Wiring Rules).
The Project Status, Location and Description PickLists are created from all previously
entered values for each respective field in the current project combined with all descriptions
entered in the PickList Manager (for Project Status and Location) or ISA Tag Catalogue
(for Description) for the project.
Data is grouped logically by Tabs. The tabs in the window enable the following information to
be added, viewed and edited:
General Information
Detail Design information related to Detail design
Datasheet Information related to the Datasheet (if any)
DCS System Information related to the DCS I/O
PLC/ESD System Information related to the PLC or ESD (Emergency Shutdown) I/O
User User Defined Fields
Alarms/Settings Information related to Alarms, Set Points etc.
Properties Additional instrument and process data properties
Power Supply Details of any power supply requirements for the instrument
Associated Items Not displayed until the instrument is saved. Process equipment
and lines associated with the instruments
For details of each tab refer to Edit Tag Details - Tab Details.
Note: The Associated Items tab is only displayed in the Edit version of the window. It is not
displayed in the Add New Tag version.
Using the drop-down list Select a Tag to Copy from: select the appropriate tag. The
information from the selected tag will be displayed in the Proposed Value Column. If the
proposed value matches the existing value it will be displayed in black, otherwise it will be
displayed in red. The user can choose which values to copy by checking the boxes in the
Accept column. Checking the Accept All box checks all the boxes in the Accept column.
Click Save to accept the selected proposed values.
To copy from a catalogue instrument, click Copy From Catalogue. The Copying data to
window is then displayed. This works in the same way as the Copying data to window
accessed from the Copy Data window. Pick the catalogue instrument to copy from the
Select a Catalogue Instrument to Copy from list.
For information on creating, editing and viewing catalogue instruments, refer to Instrument
Catalogue.
Note: The Last Edit field displays the date and time when the instrument data was last
edited. The user name of the individual that performed the edit is displayed in a tool-
tip when the mouse cursor is hovered over the field. Click the button in the field to
display the Audit Manager, which will display a list of all the changes to the
instrument data.
Note: Field captions in this window are user definable. To change captions use the
Preferences window, accessed from the Project menu.
To change the tag number, click the button next to the Tag No field to display the
Instrument Tag window. For example:
Note: Changing the Function will not result in any other attributes of the instrument being
changed (except the Function Description).
The user can change the description for each of the text boxes, for example Tag No: can be
changed to read Tag Number.
For more information refer to Options and Setup.
PickLists (pull downs) can be updated with new values to choose from by selecting the
button to the right of most pull down options. Exceptions are: Area (based on project Areas
defined), Description (based on the ISA Tag Catalogue and any previous value entered for
Description), Wiring Configurations (based of project Wiring Rules).
The Project Status, Location and Description PickLists are created from all previously
entered values for each respective field in the current project combined with all descriptions
entered in the Picklist Manager (for Project Status and Location) or ISA Tag Catalogue for
the project.
Data is grouped logically by Tabs. The tabs in the window enable the following information to
be added, viewed and edited:
General Information
Detail Design information related to Detail design
Datasheet Information related to the Datasheet (if any)
DCS System Information related to the DCS I/O
PLC/ESD System Information related to the PLC or ESD (Emergency Shutdown) I/O
User User Defined Fields
Alarms/Settings Information related to Alarms, Set Points etc.
Properties Additional instrument and process data properties
Power Supply Details of any power supply requirements for the instrument
Associated Items Process equipment and lines associated with the instruments
For details of each tab refer to Edit Tag Details - Tab Details.
The information in the tabs can be populated by copying the information from another tag.
Clicking Copy Data displays the Copy data to window.
Select the appropriate tag from the Select a Tag to Copy from: drop-down list. The
information from the selected tag will be displayed in the Proposed Value Column. If the
proposed value matches the existing value it will be displayed in black, otherwise it will be
displayed in red. The user can choose which values to copy by checking the boxes in the
Accept column. Checking the Accept All box checks all the boxes in the Accept column.
Click Save to accept the selected proposed values.
General
The General tab is used to enter typical common data for most instruments in the project.
The values available from the Instrument Range and Calibration Range, Units drop-down
lists are dependant on the Function type specified for the instrument. For example selecting
the AE Function displays the following values via the Units drop-down list:
whereas if the TT function was selected, the following values are available:
Detail
The Detail tab is used to specify more detailed design data, including data typically required
for wiring, and installation information.
The Wiring Config PickList is used to assign a wiring rule to the instrument. The rule is
used to auto-generate the instrument termination arrangement including terminal details,
cable type, connection arrangement and wire ferrule numbers etc. Typically this choice is
made by the person responsible for detail wiring design. It can also be edited from the
Designer and Wiring Manager applications.
The button in the Junction Box cell displays an Assign window which enables the user to
assign the current instrument to a Junction Box.
Click Create Tag Wiring to display the Create Tag Wiring for window.
Clicking Tag Wiring Check displays a report showing wiring connectivity for the current tag.
Datasheet
DCS System
The DCS System tab is used to assign DCS I/O information for the current tag.
Important: The DCS I/O Type must contain a non-blank value for the current tag to be
assigned to an I/O Module in Wiring Manager to enable wiring to be completed
to the I/O terminals.
PLC/ESD System
The PLC/ESD System tab is used to assign PLC or ESD (Emergency/Safety Shutdown) I/O
information for the current tag.
Important: The PLC I/O Type must contain a non-blank value for the current tag to be
assigned to an I/O Module in Wiring Manager to enabled wiring to be completed
to the I/O terminals.
User
Instrument Engineer has twenty-four user defined fields (UserField1 to UserField24). The
User section shows sixteen of these user fields (the others can be added to any grid view).
Complete them as required.
Alarms/Settings
Use this tab to enter any alarm and settings data required for the instrument.
Properties
Use this tab to enter additional instrument and process data properties as required. Click on
the appropriate Select Properties Type option and enter or edit values as required.
Power Supply
Use this tab to enter details of any power supply requirements for the instrument. If
appropriate, check the Requires Power Supply checkbox and enter the details in the fields
provided.
Note: The voltages used when defining the power supply details must be selected from a
pre-defined list of project voltages. Refer to Project Voltages for details.
If the instrument data is to be shared with AVEVA Electrical, click Share with Electrical.
Note: Unless sharing with AVEVA Electrical is enabled for the project the checkbox will be
disabled. Sharing with AVEVA Electrical may be enabled during project setup, or
afterwards (using the Project tab > Edit Project option). Refer to the Installation
User Guide for details.
Associated Items
Note: The Associated Items tab is only displayed once the tag is saved.
This tab is used to view the process equipment and lines associated with the instruments, to
add further associations, and to remove associations. Refer to Assign Process Equipment
and Process Lines for details.
The Properties button is used to open the Edit Process Equipment or Edit Process
Lines window for the process item selected on the tab, in which further details of the item
can be viewed (see View Further Process Item Details).
All process item details are read-only.
Note: Instrument tags must be unique, either across the entire project, or within their
project location (see Manually Add a Tag to the Instrument List).
If a tag numbers are not unique within the project or location, when the user attempts
to save the instruments, a warning message will be displayed to alert the user of this,
and the save will not take place.
To edit multiple tag numbers, select the items, then click Bulk Edit Instrument Numbers in
the Actions section of the List Tools - Instruments tab.
The Instrument Number wizard window is then displayed.
The screen displays all the instruments that were selected for editing, grouped by tag
format. Click the + symbol to the left of each tag format to view details of each of the tags
with that tag format.
Change the tag numbers of the selected instruments by editing all or some of the tag
number fields to make up the a new, project-unique tag number, as displayed in the New
Tag No fields.
Invalid (i.e. not unique) tag numbers are displayed in red in these fields. As each tag number
is changed, it is validated against the database to check its uniqueness. If validation is
successful, display of the tag number in the New Tag No field changes to green.
To edit the tag numbers in bulk instead of one at time, select the tags rows to be edited and
click Edit Selected Rows (click Select All Rows to select all the rows). The Multi Field
Edit (Bulk Edit) window is then displayed:
Click Close.
Note: Instrument tags must be unique, either across the entire project, or within their
project location (see Manually Add a Tag to the Instrument List).
If a tag numbers are not unique within the project or location, when the user attempts
to save the instruments, a warning message will be displayed to alert the user of this,
and the save will not take place.
To edit the tag format of multiple instruments, select the items, then click Bulk Update Tag
Format in the Actions section of the List Tools - Instruments tab.
The Instrument Bulk Update Tag Format window is then displayed.
The window displays the current tag numbers of the instruments selected in the Instruments
list, with their class names (see Class Definitions) and tag formats.
The required tag format to be applied to all the listed instruments is selected from the Tag
Format list.
By default, this list is restricted to the tag formats assigned to the classes of the listed
instruments. If the listed instruments are associated with different classes, only those tag
formats common to all those classes are available. Select the required format.
If required, the class of the listed instruments can be changed. Uncheck the Lock Class
checkbox.
The Class Name list then becomes available. Select the required class from this list. The
Tag Format list will then list the tag formats associated with the selected class. Select the
required format.
Once the required tag format has been selected, click Next.
The window then lists the instruments with the “proposed” tag numbers, i.e. the tag numbers
of the instruments with the selected tag format applied.
The current tag number, and current and proposed classes and tag formats are also
displayed.
Only those instruments with their Select checkboxes checked will have their tag numbers
changed. They are checked by default. Uncheck Select checkboxes as required. The
Select All checkbox can be used to uncheck (and re-check) all Select checkboxes.
When the required instruments have been selected, click Next.
The following warning message is then displayed, warning that the “new” tag numbers
created by this procedure may duplicate those of other instruments.
Note: The columns in this window are the same as the columns in the current Grid view as
defined by the Grid Manager.
Note: It is not mandatory for each instrument tag to be assigned to a loop. For example
field pressure gauges and pressure relief valves are not normally members of a
control loop. They are stand-alone instruments.
Hover the mouse over the Loop No cell for the instrument, and command button appears
as shown below:
If the button is clicked for a tag not currently assigned to a loop, the Assign Tag to Loop
window is displayed.
The Assign Tag to Loop window shows all loops already defined in AVEVA Instrumentation
for the current project.
The list by default is filtered by the current instrument’s Plant Area number. Select a different
are area if required from the Display by Area list, or “All”.
The Match Number checkbox filters the list of loops by the Tag No. 'number' field. In the
example above, selecting Match Number would limit the list of loops to only those
containing '510' (the current instrument is numbered '510').
Note: All details of process items are read-only in Instrument Engineering. They can also
be viewed in a grid. See Process Equipment and Lines.
Note: Instead of associating actual process items with an instrument, process data
associated with an instrument alternatively be recorded on an instrument-by-
instrument basis using the Process Data grid.
However, in this case, if for example, a process value (flow rate) of a line is changed,
this value must be updated for each and every instrument that is associated with that
line. Whereas if those instruments were associated with an actual process line item,
only a single change to that item would be required.
Switch between displaying equipment and lines in the lower grid by clicking the Associated
Process Equipment or Associated Process Lines button. Data in the lower grid cannot
be edited in Instrument Engineer.
The lower grid can be closed and re-opened by clicking Show Process Items in the
Associated Items Section of the List Tools - Instruments tab.
The window lists the available process equipment or process lines. Check the Select
checkboxes for the equipment or lines to be associated with the instrument, then click OK.
The selected process items are then associated with the instrument and displayed in the
lower grid of the Instrument List and on the Associated Items tab of the Edit window.
Note: Process items can also be assigned to instruments using the Import Instrument Data
from Excel procedure. Note that associated process items on the import spreadsheet
must exist in the project database, i.e. new process items cannot be created using
this interface.
A message is then displayed asking that the user confirm the removal of the association.
Click Yes to complete the procedure.
Note: Process items can also be unassigned from instruments using the Import Instrument
Data from Excel procedure by leaving blank the ProcessLines or ProcessEquipment
cells in the spreadsheet that would otherwise include the associated items.
• Datasheet tab of the Edit window (refer to Edit a Tag in the Instrument List) click the
button next to the Datasheet No field.
The datasheet is then displayed. Refer to the Datasheet Data Entry for further details.
Note: If the instrument tag is not currently assigned to a datasheet, then Instrument
Engineer will instead display a window from where a datasheet can be assigned.
Click Delete to continue with the deletions. The messages displayed above will be
displayed for every selected instrument.
To delete all the selected instruments without any prompts being displayed, click Delete All
selected Instruments without prompt to confirm each before clicking Delete.
To delete all the selected instruments without prompts regarding the deletion of associated
wiring being displayed, click Delete Instrument Wiring without prompt to confirm each
before clicking Delete.
Note: Instrument tags must be unique, either across the entire project, or within their
project location (see Manually Add a Tag to the Instrument List).
Tag numbers that are not unique within the project or location cannot be imported.
If duplicate tag numbers are permitted in the project as long as their project locations
are different, the location of an instrument is taken into account when matching
imported tag numbers with those present in the database.
Continue at:
• Import Instrument Data from Excel
• AVEVA P&ID Instrument Tags Import
• AVEVA Schematic Model Instrument Tag Import
• AVEVA Engineering Instrument Tag Import
• AVEVA Diagrams Instrument Tag Import
Note: To minimise the possibility that data currently being worked on by another user may
be affected by an import, a list of the users working on the current project is available
from the UserCount link. The number of current users is displayed next to the link.
This total includes the user performing the import.
Both the AVEVA P&ID and the AVEVA Instrumentation mapping fields will be empty until the
user selects a project file. To select a project file, click the browse button to the right of the
AVEVA P&ID Project file text field. A browser window will then be displayed to enable the
user to navigate to the required project file.
Once the project file is selected, the AVEVA P&ID Data Import Configuration window will
refresh to display the default mappings.
If the user changes the AVEVA P&ID Project file setting, a warning message window will
be displayed informing the user that changing project files may corrupt the data.
Some of the fields in the AVEVA Instrumentation Field column are mandatory. If any of
these fields are not populated with a value and the user clicks Save, the user will prompted
with a message asking them to configure the mandatory field.
The user must click OK to return to the AVEVA P&ID Data Import Configuration window
and configure the mandatory field(s).
To save the changes made to the mapping fields, click Save. To cancel the changes made
to the mapping fields click Cancel.
If the AVEVA P&ID Project is changed after data has been loaded, the Schematic Model
item unique id's stored in AVEVA Instrumentation will potentially be invalid. An additional
checkbox, Remove all the links for items previously imported from this project is
displayed on the AVEVA P&ID Data Import Configuration window.
Checking this checkbox removes all the unique id's, enabling a subsequent import to correct
the tag list in line with the new project.
The Import from AVEVA P&ID window displays totals of new and existing tags with the
option to import all the tags in a batch or one at a time.
The batch option processes all records together then displays a differences report enabling
users to accept or reject each change. The one by one option displays a differences report
for each record one at a time.
If that are any tags previously imported from AVEVA P&ID that have since been deleted in
AVEVA P&ID, the total of these is also displayed, and the Process deleted tags button
becomes active. Click Process deleted tags if these tags are also to be deleted from
Instrumentation.
The Import Differences window shows the differences between AVEVA Instrumentation
data and proposed (imported AVEVA P&ID) data. If the one by one import option was
selected, the differences for a single record are listed.
If the batch option was selected, differences for all records are displayed.
To accept the changes either select individual field data by clicking the Accept checkbox for
each, or select the Accept All checkbox at the top of this window (all individual records will
be auto-selected).
To save the checked (accepted) data to the project, click Save.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel any import for the current tag record, click Close.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel all further importing click Stop Import
The Import Log then shows the user the import status and displays the successfully
imported files in the grid view.
Note: To minimise the possibility that data currently being worked on by another user may
be affected by an import, a list of the users working on the current project is available
from the UserCount link. The number of current users is displayed next to the link.
This total includes the user performing the import.
The AVEVA Schematic Model Version field enables the user to chose which version of the
software to import from by selecting from a drop-down menu which list all the software
versions currently installed on the user's workstation.
The mapping fields will be empty until the user logs onto a Schematic database. Click the
browse button to the right of the AVEVA Schematic Model Version field. To connect to
Select Login to display the AVEVA Schematic Model Login window.
Complete the Project, Username, Password and Project MBD as appropriate and click
OK.
The Elements Types field enables the user to filter the data displayed in the grid view by
selecting an option from the drop-down menu. The mapping data for Offline Instrument,
Inline Instrument, Actuator and Instrument Valve is imported into the Instrument List.
The mapping data for Loops is imported into the Loop List.
To map a field, click on the drop-down list in the AVEVA Instrumentation Field column and
select a value from the list.
Some of the fields in the AVEVA Instrumentation Field column are mandatory. If any of
these fields are not populated with a value and the user clicks Save, the user will prompted
with a message asking them to configure the mandatory field.
The user must click OK to return to the AVEVA Schematic Model Data Import
Configuration window and configure the mandatory field(s).
To save the changes made to the mapping fields, click Save. To cancel the changes made
to the mapping fields click Cancel.
If the user clicks No a message window is displayed informing the user that the import has
been terminated.
Complete the Project, Username, Password and Project MBD as appropriate and click
OK.
Note: If the field mappings have not been set, the AVEVA Schematic Model Data Import
Configuration window is displayed. Refer to AVEVA Schematic Model Import
Configuration for further information. If the user clicks Cancel, a message window is
displayed informing the user that the import cannot continue without the Field
mappings being set.
If field mappings have been setup, the Import from AVEVA Schematic Model window is
displayed:
The Import from AVEVA Schematic Model window displays totals of new and existing
tags with the option to import all the tags in a batch or one at a time.
The batch option processes all records together then displays a differences report enabling
users to accept or reject each change. The one by one option displays a differences report
for each record one at a time.
If that are any tags previously imported from AVEVA Schematic Model that have since been
deleted in AVEVA Schematic Model, the total of these is also displayed, and the Process
deleted tags button becomes active. Click Process deleted tags if these tags are also to
be deleted from Instrumentation.
The Import Differences window shows the differences between AVEVA Instrumentation
data and proposed (imported AVEVA Schematic Model) data. If the one by one import
option was selected, the differences for a single record are listed.
If the batch option was selected, differences for all records are displayed.
To accept the changes either select individual field data by clicking the Accept checkbox for
each, or select the Accept All checkbox at the top of this window (all individual records will
be auto-selected).
To save the checked (accepted) data to the project, click Save.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel any import for the current tag record, click Close.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel all further importing click Stop Import
The Import Log then shows the user the import status and displays the successfully
imported files in the grid view.
Setup the required mappings. The procedure is similar to that described in AVEVA
Schematic Model Import Configuration.
Setup the required mappings. The procedure is similar to that described in AVEVA
Schematic Model Import Configuration.
Click Yes to open Instrument Copy Wizard. Refer to Engineer Instrument Copy Wizard for
details. Otherwise click No.
AVEVA Instrumentation will then display the Instrument Tag window. Enter the required tag
details and click OK.
The Add New Tag window is then displayed with the details of the copied instrument
displayed.
Change the details as required and click Save.
Refer to Manually Add a Tag to the Instrument List for details of the Instrument Tag and
Add New Tag window.
The screen displays all the instruments that were selected for copying, grouped by tag
format. Click the + symbol to the left of each tag format to view details of each of the tags
with that tag format.
To remove any tags from the copying process, uncheck their Select checkboxes. Uncheck
the Select All for Copying checkbox to uncheck all Select checkboxes.
Before continuing each selected instrument must be renamed by editing all or some of the
tag number fields that make up a new, project-unique tag number, as displayed in the New
Tag No fields.
Invalid (i.e. not unique) tag numbers are displayed in red in these fields. As each tag number
is changed, it is validated against the database to check its uniqueness. If validation is
successful, display of the tag number in the New Tag No field changes to green.
To edit the tag numbers in bulk instead of one at time, select the tags rows to be edited and
click Edit Selected Rows (click Select All Rows to select all the rows). The Multi Field
Edit (Bulk Edit) window is then displayed:
Each selected instrument datasheet must be renamed by editing all or some of the fields
that make up the document number, including Sheet No. The new document number is
displayed in the New Doc No field.
The editing facilities on this screen are the same as on the first.
To continue click Next.
Note: The Attached Documents window can also be viewed when editing a tag by clicking
Attached Documents on the General tab on the Edit window.
Note: Documents can also be attached by importing details of attached documents from an
Excel spreadsheet. See Import Attached Documents Data for details.
The file to be attached is selected by clicking the button to the right of the Document field. A
file browser window is then opened, enabling the user to navigate to the file. Select the
required file and click Open on the file browser window to close the file browser window and
return to the Attached Document Details window. The Document field will be populated
with the selected file and file path.
The user can select a document type from the Type drop-down list or manually enter a new
type. An optional description can be entered in the Description text box.
Check the Public checkbox if the attachment is to be shared with all the users on the same
project. Leave the Public checkbox box unchecked if only the current user is to have
access to the attachment.
Note: Only the association to the attached document is deleted. Neither the tag or the
actual document file is deleted.
The window lists the attachments of the selected tags and their current locations.
To select a new location, click the ... button. The Browse For Folder window is then
displayed. Browse for and select the required folder, and click OK.
The selected location is then displayed in the New Folder Path field in the Change Folder
window.
To complete the procedure, click OK in the Change Folder window. The attached
documents for the tags are then moved to the specified location (the originals are not
deleted), and from now on the document attachments for the tags will be linked to that
location.
Click Browse and select the Excel file from which data is to be imported. Click Next >.
The next window shows all the columns in the Excel spreadsheet to be imported. Select an
existing Field Mapping (if one for this Import type exists) from saved mappings drop down
or use the automatic mappings created by AVEVA Instrumentation and make changes to
these mappings (if required).
Note: To minimise the possibility that data currently being worked on by another user may
be affected by an import, a list of the users working on the current project is available
from the UserCount link. The number of current users is displayed next to the link.
This total includes the user performing the import.
Excel Column Name fields display the names of the columns in the spreadsheet. The
AVEVA Instrumentation Field fields displays the Instrumentation fields they are mapped
to.
To map an Excel Column to an AVEVA Instrumentation database field click in the AVEVA
Instrumentation Field field adjacent to the relevant Excel Column Name field, and select
the required AVEVA Instrumentation field from a drop-down list. To exclude a field from the
import, click Clear button in the grid against the field that needs to be excluded or select the
blank entry from the mapping drop-down list.
Note: AVEVA Instrumentation automatically checks each Excel Column Name from the first
row in the Excel worksheet against fields names in AVEVA Instrumentation Database
(if not found then field Captions - as set in the Grid Manager). If a match is found
then AVEVA Instrumentation automatically adds the Field Name to the mapping list.
The user can select a different field from the mapping list if required.
Once the name and description for the mapping have been entered, click Save and the
mappings will be saved and added to the Saved Mappings drop down.
Note: Data can also be imported by just clicking on the Import button. However it may
save time to save the mappings if an import with those mappings is to be performed
again.
Once the mappings have been set up, click Next >.
A list of instruments for which attached document details can be imported is then displayed.
Click Import to proceed with the import. The import then takes place. After the import is
complete, a log of the imported document details is displayed:
Clicking Yes changes the folder path in the Attached Documents window, but the user
cannot view any attachments until the file is moved or copied to the new folder path. Click
No to cancel the folder path change.
To close the Attached Documents window and return to the Instruments grid view, click
Close.
The Tag No column displays the instrument which has been allocated to a particular I/O.
Important: Tags cannot be assigned to an I/O Module through importing unless the Tag No
already exists in the Engineer Instrument List.
Prior to importing, the Excel Worksheet must be in a simple tabular format (columns and
rows) and the first row should contain unique column names (headings) so that Engineer
can identify the column's data to enable 'mapping' to Engineer database fields. The column
names are user-definable but must not be duplicated. Engineer will only import column data
that contains a heading. Furthermore, the Excel file must contain the following mandatory
columns/data: Cabinet Name, I/O Module Name (or Tag), I/O module catalogue number,
Channel No and Tag No.
If the I/O Module Tag/Name does not exist, Engineer will automatically create an I/O module
with that Tag/Name in the Cabinet listed in the Excel workbook.
Once an Excel Worksheet is formatted accordingly and selected for import, users must
'map' each Excel column name (heading) to an Engineer database field using the Engineer
import utility. The data can then be imported into Engineer. The import utility will check if
mandatory columns exists in the Excel file and Mappings. While processing I/O Modules to
be imported, if a Module already exists in the database Engineer will show the differences
between the imported data and the Engineer data, allowing the user to accept/reject the
proposed changes on a record by record (and field by field) basis. If the I/O Module does not
exist in Engineer and the user accepts to import, Engineer will create a new I/O Module in
the Equipment (Cabinet) specified in the Excel data.
To start the import procedure, open the Instrument List grid or the Loops grid. Then click I/O
Allocations in the Import section of the Manage section. The I/O Allocation Import wizard
window is then displayed:
Click Browse and select the Excel file from which data is to be imported. Click Next >.
The next window shows all the columns in the Excel spreadsheet to be imported. Select an
existing Field Mapping (if one for this Import type exists) from saved mappings drop down
or use the automatic mappings created by AVEVA Instrumentation and make changes to
these mappings (if required).
Note: To minimise the possibility that data currently being worked on by another user may
be affected by an import, a list of the users working on the current project is available
from the UserCount link. The number of current users is displayed next to the link.
This total includes the user performing the import.
Excel Column Name fields display the names of the columns in the spreadsheet. The
AVEVA Instrumentation Field fields displays the Instrumentation fields they are mapped
to.
To map an Excel Column to an AVEVA Instrumentation database field, click in the AVEVA
Instrumentation Field field adjacent to the relevant Excel Column Name field, and select
the required AVEVA Instrumentation field from a drop-down list. To exclude a field from the
import, click Clear button in the grid against the field that needs to be excluded or select the
blank entry from the mapping drop-down list.
Note: AVEVA Instrumentation automatically checks each Excel Column Name from the first
row in the Excel worksheet against fields names in AVEVA Instrumentation Database
(if not found then field Captions - as set in the Grid Manager). If a match is found
then AVEVA Instrumentation automatically adds the Field Name to the mapping list.
The user can select a different field from the mapping list if required.
Once the name and description for the mapping have been entered, click Save and the
mappings will be saved and added to the Saved Mappings drop down.
Note: Data can also be imported by just clicking on the Import button. However it may
save time to save the mappings if an import with those mappings is to be performed
again.
Once the mappings have been set up, click Next >.
The list of I/O Modules in the selected Excel file is then displayed.
To import the instrument allocation data for an I/O Module, check its Select checkbox.
Check the Select all checkbox to check all the Select checkboxes.
Click Next >.
The data in the spreadsheet is then validated. Lists of I/O Modules that cannot be imported
and these reasons for this are then displayed. For example:
The list of I/O Modules than can be imported is then displayed. For example:
Click Import to proceed with the import. The import then takes place. After the import is
complete, a log of the imported document details is displayed, including the I/O allocations
that have taken place as a result of the import. For example:
Select a form type from the Datasheet Form Type drop-down menu. The required data is
then displayed in the grid.
Note: The fields in this grid depend on the actual fields mapped to the current Form Type
selected.
Display the datasheet window by clicking on the button that is displayed in the DocNo cell
when the mouse is hovered over the cell. Refer to Datasheet Data Entry for details.
Instrument data may be edited by clicking on the button that appears in the Tag No cell
when the mouse is hovered over the cell. Refer to Edit a Tag in the Instrument List for
details.
Note: Any change made to data in this grid is not updated on the respective datasheet until
the datasheet is opened (or updated from the Datasheet List).
The following options are located on the List Tools - Browse Data by Form Type tab:
Records Section
Refresh
New These common options are also located on the Home tab.
Edit Refer to the Common Functionality User Guide for details.
Delete
Actions Section
Datasheet Form Type Used to select the required form type, as described above.
Apply Default Units If this option is checked then on update of a value in grid cell,
the default unit is appended to the value if no unit is present.
Invert Hide\Show Makes the hidden column visible and hides currently visible
Grid Columns columns.
Note: The fields in this window depend on the actual fields mapped to the current Form
Type selected in the Browse Data By Form Type grid.
Note: If more than one record is selected in the Browse Data By Form Type grid when Edit
is selected, the Multi Field Edit (Bulk Edit) window is displayed instead. Refer to
Edit Data for Multiple Tags.
Click Yes. The Multi Field Edit (Bulk Edit) window is then displayed:
The window enables users to specify which type or types of data are to be imported. Check
the appropriate checkboxes and click Save.
The Select excel workbook to import window is then displayed for the first type of item
(e.g. datasheet list data) the user specified was to be imported. Select the spreadsheet that
the first type of data is to be imported from and click Open.
The import procedure then continues in the standard way, as described in the Common
Functionality User Guide.
Once the import for the first selected item type is completed (or if it is cancelled), the user
will be prompted to select a spreadsheet for the next selected data type (if there is one),
until all import procedures are completed.
Note: Whenever the import detects a duplicate column name, it will append the column
number on the end, so the end will result will be, for example, “Rating_A” and
“Rating_B”.
All data is the grid is display-only. It cannot be edited, deleted or added to.
Note: Load requirements are specified on the Power Supply tab of the Edit window of
instruments. See Edit Tag Details - Tab Details.
In AVEVA Instrumentation, there are two methods of recording the details of process data
associated with an instrument (for example, for inclusion on instrument datasheets):
• The process data can be recorded against each specific instrument using the Process
Data grid.
In this case, if for example a process value (flow rate) of a line changed, this value must
be updated for each and every instrument that is associated with that line.
• Instruments can instead be associated with actual process equipment and process line
items in the AVEVA Instrumentation project database (see Assign Process Equipment
and Process Lines).
These items of equipment and lines have their own specific process and physical
properties. If a process value such as flow rate changes, this change is made against
the line, not the instruments associated with that line i.e. in one place. All instruments
associated with that line that automatically reference this single updated value, thus
ensuring data consistency on deliverables such as instrument datasheets.
These items are created and edited in the Process Engineer module, but can be
viewed in the Instrument Engineer module.
Continue at:
• Process Data
• Process Equipment and Lines
Instrument data may be edited by clicking on the button that is displayed in the Tag No cell
when the mouse is hovered over that cell.
Note: Any change made to data in this grid is not updated onto the respective datasheet
until the datasheet is Opened (or Updated from the Datasheet List).
The grid supports Grid Manager for user defined grid layouts. AVEVA Instrumentation
'remembers' the last Grid View used and starts with that view.
Note: Grid Manager allows each user to define their own sets of data fields/columns,
column order, predefined filters and sort order for the Process Data List. Each set is
known as a 'View'. For example, users can set various views to show only certain tag
types (e.g Control Valves, Pressure Transmitters etc.) and then limit the fields to
show only those specific to that tag type (e.g For a Pressure Transmitter show
PressureMax, TemperatureDesign and exclude LevelMax etc.).
By default all fields in the AVEVA Instrumentation database table 'ProcessData' are shown
along with a few base InstrumentList fields (e.g TagNo, P&IDNo etc.).
The following options are located on the List Tools - Process Data tab:
Records Section
Refresh
New These common options are also located on the Home tab.
Edit Refer to the Common Functionality User Guide for details.
Delete
Actions Section
Apply Default Units If this option is checked then on update of a value in grid cell,
the default unit is appended to the value if no unit is present.
To change a project's default units use the Setup > Edit
Process Units option from the Project tab. Refer to Process
Units.
Invert Hide\Show Grid Makes the hidden column visible and hides currently visible
Columns columns.
Change Process Displays a window that lists all the supported process units for
Units the value in the currently selected cell and allows the user to
change from one unit type to another unit type without
changing the value. For example 100°C to 100°F.
Convert Units Displays a window that lists all the supported process units for
the value in the currently selected cell and allows the user to
change from one unit type and to change the value to reflect
this. For example 100°C to 212°F.
Note: If more than one record is selected in the Process Data grid when Edit is selected
the Multi Field Edit (Bulk Edit) window is displayed instead. Refer to Edit Process
Data for Multiple Tags.
Click Yes. The Multi Field Edit (Bulk Edit) window is then displayed:
Note: Process Equipment and Process Lines are created in Process Engineer and can
only be edited in that module. In Instrument Engineer, they may only be viewed and
assigned to instruments (refer to Assign Process Equipment and Process Lines).
To open the Process Equipment or Process Lines Grid, click Select in the Grids and
Schedules section of the Home tab.
Select Process Equipment or Process Lines from the list of grids that is then displayed.
The selected grid is then displayed:
The following options are located on both the List Tools - Process Equipment and the List
Tools - Process Lines tabs:
Records Section
Refresh These common options are also located on the Home tab.
New Refer to the Common Functionality User Guide for details.
The New and Delete options are disabled in Instrument
Edit
Engineer. The Edit option is used to view further details of an
Delete item. Refer to View Further Process Item Details.
Open For Selected Opens the Attached Documents window, which lists the
documents attached to the selected item. Refer to
Attachments (External Documents) for details.
Actions Section
If no sizing calculations have been performed for the instrument, a list of sizing calculation
types to select from will be displayed.
Click on the required calculation type. A window is then displayed on which the calculation
can be performed. For details of these windows, continue at Perform Calculations.
Note: The first time that sizing calculation functionality is accessed, the following disclaimer
is displayed before the list of calculation types:
Click OK to display the list of calculation types. The disclaimer can be viewed again
at any time by clicking the link below the list of calculation types.
Note: The window for performing Gas compressibility factor “Z” calculations is accessed
from the Control Valve Sizing window.
If a sizing calculation (or calculations) has been performed, the window used to perform that
calculation is displayed instead.
The last type of calculation that was performed (if any) is displayed under the Sizing
Calculation button on the Datasheet tab of the Edit window.
To select a different calculation to perform, double-click on the calculation type name under
the button. The list of calculation types (see above) is then displayed.
Basic details of the selected instrument are displayed at the top of the windows.
Complete the fields with the values required to perform the calculations. All values may be
entered manually.
Alternatively, if an instrument has been associated with a Process Line (refer to Assign
Process Equipment and Process Lines for details), and the Process Item Properties option
on the Instruments tab of the Preferences window has been selected (see Options), then
many of the fields may be completed with the details of that Process Line by selecting it
from the Associated Item list. Complete the rest of the fields “manually”.
Fields should be completed in the order that they are displayed on the window. For example
in the Control Valve Sizing window enter the Upstream Nominal Size first, then the
Upstream Nominal Size, finishing with the Cp/Cv, leaving blank any the values to be
calculated (if values are entered in these fields they will be overwritten when a calculation is
performed).
Fields with a yellow background cannot be edited. They either display general data relating
to the instrument, or can only be populated when a calculation is performed.
Values entered in one calculation window automatically populate corresponding fields in
other calculation windows.
If a field that must be completed is left blank, or is completed with an invalid value, an
warning symbol is displayed next to that field:
Hover the mouse cursor over the symbol to display a tooltip explaining the reason for the
warning:
To perform a calculation, click the appropriate button, e.g. Calc. Flow, Calc. DP, PSV Size
etc.
Note that the Calc. Density button on the Control Valve Sizing window opens the Gas
Compressibility Factor “Z” window (see below).
The calculated values then populate the appropriate fields on the windows.
If there are any warnings or noteworthy implications arising from a calculation, they are
displayed as messages at the bottom of the window.
To save any calculations or entered values and exit a window, click Save. Click Cancel to
exit a window without saving.
Gas Compressibility Factor “Z” calculations are performed by clicking Calc. Density on the
Control Valve Sizing window. The Gas Compressibility Factor “Z” window then opens. As
described above, enter the required values then click Calculate to the perform the
calculation.
To print the calculation results, click Print. The data is then displayed in a Print Preview
window.
To exit the Gas Compressibility Factor “Z” window, click Cancel. Note that calculations and
entered values are not saved when the window is closed.
8 Loop List
The Loop List is the main window for adding/editing Loops in the project and for assigning
instruments to loops. By default all loops in the project are shown in the Loop List grid. If
required, users may use the column filters to filter the list by plant area, etc.
Refer to Working with the Data Grid for information on the grid controls including selecting a
loop record, and sorting and filtering the grid data.
The Loop List consists of two grids. The main, upper grid displays details of the loops in the
project. The lower grid displays details of any instruments assigned to the loop currently
selected in the upper grid.
A Loop can be copied by selecting an existing loop record then clicking the Copy Selected
menu option from the small pull-down menu next to the New option on the Home tab.
Copying a Loop will also copy loop instruments and the original data assigned to each
instrument to the new instruments created, except for the following data: TagNo,
PlantConnection. Refer to Copy Existing Loops for details.
Loop data may also be imported from external applications and sources. Refer to Import
Loop Data from Excel, AVEVA P&ID Loops Import and AVEVA Schematic Model Loops
Import.
The following options are located on the List Tools - Loops tab:
Records Section
Refresh
New These common options are also located on the Home tab.
Edit Refer to the Common Functionality User Guide for details.
Delete
Tools Section
Show Un- This checkbox is used to filter the list so that only unassigned Loops,
Assigned i.e. without allocated instruments, are listed. Uncheck the checkbox to
remove the filter.
Wiring Creates a graphical wiring report for the currently selected Loop(s)
showing detailed loop wiring. The command will only show valid
termination data if wiring/cabling has been created for instruments in
the selected loop(s) using Wiring Manager. Refer to Loop Wiring
Check Reports.
Bulk Edit Used to edit multiple loop numbers. Refer to Edit Multiple Loop
Loop Numbers for details.
Numbers
Bulk Update Used to change the tag format of multiple loops. Refer to Edit Multiple
Tag Format Loops for details.
Note that any delimiters defined for tag format are displayed after the fields they follow.
Complete the fields as required, including the loop type. The list of available loop types will
be restricted to those associated with the selected class (refer to Loop Type Catalogue for
details). The loop function code will be automatically completed with the code associated
with the loop type in the catalogue.
The entered tag number is displayed at the bottom of the window. For example:
When the required tag data has been entered, click OK to display the Add New Loop
window:
To change the tag number, click the button next to the Loop Number field to display the
Loop Tag window again (see above).
The Area No display the area that the loop is in, and cannot be changed. The Area Path:
displays the parent area(s) of that area, if there are any.
If the Drawing Required checkbox is checked, Engineer creates a drawing entry in the
Designer application. The Loop Number and Loop Service are automatically inserted into
the drawing list as a Loop Diagram drawing.
Related Loops
Up to two 'related loops' may assigned to the loop. This enables AVEVA Instrumentation to
place information for related loops (including their instrument tag data) on any Loop
Diagram created with Designer. To assign a related loop, select the button in one of the
Related Loops fields. The Select a Related Loop window is then displayed.
Note: If the PC does not have a valid license for Designer only Loop Wiring Check is
visible.
Loop Wiring Check Displays the Loop Check Report window, showing all
instrument wiring in the AVEVA Instrumentation database
for the current loop. Refer to Loop Wiring Check Reports.
Create Loop Wiring Allows automatic creation of instrument field wiring for
instruments in the current loop. Displays the Create Loop
Wiring for window. Refer to Create Loop Wiring using
Wiring Rules.
Remove Loop Wiring Removes all field wiring/cables and terminations for the
current loop instruments previously created with Create
Loop Wiring.
Note: The Last Edit field displays the date and time when the loop data was last edited.
The user name of the individual that performed the edit is displayed in a tool-tip when
the mouse cursor is hovered over the field. Click the button in the field to display the
Audit Manager, which will display a list of all the changes to the loop data.
To change the tag number, click the button next to the Loop Number field to display the
Loop Tag window again (see Add a Loop to the Loop List).
Note: If the loop type of a loop is changed, the loop function code will be automatically
changed to that associated with the type in the Loop Type Catalogue. However,
changing a loop function will not result in the loop type being updated.
The Area No display the area that the loop is in, and cannot be changed. The Area Path:
displays the parent area(s) of that area, if there are any.
The Drawing Required checkbox tells Engineer to create a drawing entry in the Instrument
Designer application. If this is checked, a Loop Diagram with the Loop Number and Loop
Service is automatically inserted into the drawing list.
Related Loops
Up to two 'related loops' may assigned to the loop. This enables AVEVA Instrumentation to
place information for related loops (including their instrument tag data) on any Loop
Diagram created with Designer. To assign a related loop, select the button in one of the
Related Loops fields. The Select a Related Loop window is then displayed.
Note: If the PC does not have a valid license for Designer only Loop Wiring Check is
visible.
Loop Wiring Check Displays the Loop Check Report window, showing all
instrument wiring in the AVEVA Instrumentation database
for the current loop. Refer to Loop Wiring Check Reports.
Create Loop Wiring Allows automatic creation of instrument field wiring for
instruments in the current loop. Displays the Create Loop
Wiring for window. Refer to Create Loop Wiring using
Wiring Rules.
Remove Loop Wiring Removes all field wiring/cables and terminations for the
current loop instruments previously created with Create
Loop Wiring.
The screen displays all the loops that were selected for editing, grouped by tag format. Click
the + symbol to the left of each tag format to view details of each of the loops with that tag
format.
Change the loop numbers of the selected loop by editing all or some of the loop number
fields to make up the a new, project-unique tag number, as displayed in the New Loop No
fields.
Invalid (i.e. not unique) loop numbers are displayed in red in these fields. As each loop
number is changed, it is validated against the database to check its uniqueness. If validation
is successful, display of the tag number in the New Loop No field changes to green.
To edit the loop numbers in bulk instead of one at time, select the loop number rows to be
edited and click Edit Selected Rows (click Select All Rows to select all the rows). The
Multi Field Edit (Bulk Edit) window is then displayed:
As required, specify new tag numbers for the instruments, following the same procedure as
for loops. Click Next.
The Wizard then shows all the proposed loop and instrument numbers.
Click Close.
Note: It is not mandatory for each tag to be assigned to a loop. For example, simple field
pressure gauges or a pressure relief valves are not normally members of a control
loop. They are stand-alone instruments.
To assign a tags to a Loop from the Loop List, in the Edit Loop window (or from the Add
Loop window if creating a new loop), click the Add Tag button to display the following
window:
The left-hand list shows typical tags and descriptions from the Instrument Engineer ISA tag
Catalogue and built using the current loop Function prefix.
The right-hand list shows all tags assigned to the current loop (if any).
To assign a tag to the current loop, two methods may be used:
1. Build a Tag Number using the ISA tag Catalogue (left list).
Double-click on the required tag and the full tag number is added to the Tags to Add
list (right list).
Note: If required, users may click on a Tag value and overwrite it.
The window lists only those tags yet to be assigned to a loop. The tag list can be filtered to
by Plant Area, using the Display by Area list.
Click Yes to open Engineer Copy Wizard. Refer to Engineer Copy Wizard for details.
Otherwise click No.
AVEVA Instrumentation will then display the Loop Tag window. Enter the required tag
details and click OK.
The Add New Loop window is then displayed with the details of the copied loop displayed.
Change the details as required and click Save.
Refer to Add a Loop to the Loop List for details of the Loop Tag and Add New Loop
window.
Note: The command copies all loop instruments and the original data assigned to each
instrument to the new instruments created except the following: TagNo,
PlantConnection, P&ID No, DataSheetNo, LoopDwgNo, LocationDwg, InstallDwgNo
and JunctionBox. The command also copies any field device definitions and cables
(including terminations) for each loop instrument (if any) as defined in the Wiring
Manager module for the copied loop.
Note: The Wizard copies all selected loops and loop instruments and the original data
assigned to each instrument to the new instruments created except the following:
TagNo, PlantConnection, P&ID No, DataSheetNo, LoopDwgNo, LocationDwg,
InstallDwgNo and JunctionBox. The Wizard does not currently copy any field device
definitions and cables (including terminations) for each loop instrument (if any) as
defined in the Wiring Manager module for the copied loop. The Wizard does enable
copying of all instrument datasheets.
To copy multiple loops, select the loop records to be copied that require copying from the
Loop List and click Copy Selected from the drop-down toolbar menu next to the New button
of the Home tab.
The first screen of the Copy window is then displayed:
To remove any tags from the copying process, uncheck their Select checkboxes. Uncheck
the Select All for Copying checkbox to uncheck all Select checkboxes.
Before continuing each selected loop must be renamed by editing all or some of the fields
that make up the a new, project-unique tag number, as displayed in the New Loop No
fields.
Invalid (i.e. not unique) tag numbers are displayed in red in these fields. As each tag number
is changed, it is validated against the database to check its uniqueness. If validation is
successful, display of the tag number in the New Loop No field changes to green.
To edit the tag numbers in bulk instead of one at time, select the tags rows to be edited and
click Edit Selected Rows (click Select All Rows to select all the rows). The Multi Field Edit
(Bulk Edit) window is then displayed. Refer to Edit Multiple Loops for details of this window.
Once tag numbers have been edited as required, click Next.
The next screen shows all instruments associated with the selected loop (if any), grouped
by tag format.
Click the + symbol to the left of each tag format to view details of each of the tags with that
tag format.
Each selected instrument must be renamed by editing all or some of the fields that make up
the tag number. The new document number is displayed in the New Tag No field.
The editing facilities on this screen are the same as on the first.
To continue click Next.
The next screen shows all datasheets associated with the loop instruments (if any).
Each selected instrument datasheet must be renamed by editing all or some of the fields
that make up the document number, including Sheet No. The new document number is
displayed in the New Doc No field.
The editing facilities on this screen are the same as on the first.
To continue click Next.
The wizard shows all the proposed loops, instruments and datasheets.
To create the new items, click Copy.
AVEVA Instrumentation copies all the new items then stops and displays a log. For
example:
The window provides the option of either unassigning instruments from the loop (Unassign
Instruments from Loop), or deleting them (Delete Instruments in Loop).
If the delete option is selected, a further option to delete the associated instrument wiring is
available: Remove any Instrument Wiring.
Also, if there is a loop diagram for the loop it may be deleted by checking the Delete Loop
Diagram checkbox.
After the required options have been selected, click Delete to proceed with the deletion.
Click Cancel to cancel the deletion.
The Import from AVEVA P&ID window displays totals of new and existing loops with the
option to import all the loops in a batch or one at a time.
The batch option processes all records together then displays a differences report enabling
users to accept or reject each change. The one by one option displays a differences report
for each record one at a time.
If that are any loops previously imported from AVEVA P&ID that have since been deleted in
AVEVA P&ID, the total of these is also displayed, and the Process deleted button becomes
active. Click Process deleted if these loops are also to be deleted from Instrumentation.
The Import Differences window shows the differences between AVEVA Instrumentation
data and proposed (imported AVEVA P&ID) data. If the one by one import option was
selected, the differences for a single record are listed.
If the batch option was selected, differences for all records are displayed.
To accept the changes either select individual field data by clicking the Accept checkbox for
each, or select the Accept All checkbox at the top of this window (all individual records will
be auto-selected).
To save the checked (accepted) data to the project, click Save.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel any import for the current tag record, click Close.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel ALL further importing click Stop Import
The Import Log then shows the user the import status and displays the successfully
imported files in the grid view.
If the user clicks No a message window is displayed informing the user that the import has
been terminated.
If the user clicks Yes the AVEVA Schematic Model Login window is displayed.
Complete the Project, Username, Password and Project MBD as appropriate and click
OK.
Note: If the field mappings have not been set, the AVEVA Schematic Model Data Import
Configuration window is displayed. Refer to AVEVA Schematic Model Import
Configuration for further information. If the user clicks Cancel, a message window is
displayed informing the user that the import cannot continue without the Field
mappings being set.
If field mappings have been setup, the Import from AVEVA Schematic Model window is
displayed:
The Import from AVEVA Schematic Model window displays totals of new and existing
loops with the option to import all the loops in a batch or one at a time.
The batch option processes all records together then displays a differences report enabling
users to accept or reject each change. The one by one option displays a differences report
for each record one at a time.
If that are any loops previously imported from AVEVA Schematic Model that have since
been deleted in AVEVA Schematic Model, the total of these is also displayed, and the
Process deleted button becomes active. Click Process deleted if these loops are also to
be deleted from Instrumentation.
The Import Differences window shows the differences between AVEVA Instrumentation
data and proposed (imported AVEVA Schematic Model) data. If the one by one import
option was selected, the differences for a single record are listed.
If the batch option was selected, differences for all records are displayed.
To accept the changes either select individual field data by clicking the Accept checkbox for
each, or select the Accept All checkbox at the top of this window (all individual records will
be auto-selected).
To save the checked (accepted) data to the project, click Save.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel any import for the current tag record, click Close.
If the one by one import option was selected, the window then displays the differences for
the next record, if there is one.
To cancel ALL further importing click Stop Import
The Import Log then shows the user the import status and displays the successfully
imported files in the grid view.
AVEVA Instrumentation uses 'Wiring Rules' to automatically generate typical field instrument
wiring/cabling. Using the Wiring Rules features can save many hours otherwise required to
build devices and their associated terminal arrangements, cables, terminations etc in Wiring
Manager.
Refer to Instrument Wiring and Loop Wiring for how to apply Wiring Rules.
When a Wiring Rule is applied to a field instrument, the following are defined:
• Terminal arrangements - the number of terminals, their markings, sequence.
• Default wire numbers to be used on wire terminations.
• Default cable types - type of cable (individual cores, pairs or triad etc), whether
shielded/screened, and whether armoured etc.
• Default cable numbers - based of the instruments tag number fields from Instrument
Engineer.
• Default wire terminations at the field devices - how the cable is connected to the field
device terminals (core 1 to terminal 1, core 2 to terminal 2 etc).
• Default wire terminations at non-field device - how the cable is connected at the other
end.
When wiring based on a Wiring Rule is created, AVEVA Instrumentation creates all the
above automatically. Prior to saving this data AVEVA Instrumentation also enables users to:
• Change the default cable number created by the Wiring Rule.
• Select equipment the cable will terminate to at the other end (from a list of Junction
Boxes, Cabinets etc).
After accepting defaults (or making changes as required) the Field Device and terminals are
created, the cable is created and terminated at both ends (if equipment has been selected
at the other end). At the other end, AVEVA Instrumentation always uses the next available
spare terminals.
At any time after a Wiring rule is applied, the data that has been generated can be edited by:
• Re-running the Create Wiring command using same Wiring Rule - this enables users to
reassign a Cable No, reassign a Junction Box etc.
• Re-running the Create Wiring command using a new Wiring Rule - this updates
terminal arrangements, cable type, terminations AND enables users to reassign a
Cable No, reassign a Junction Box etc.
• Edit the cable details/type using Wiring Manager Cable Schedule user interface.
• Edit terminations using Wiring Manager - Equipment Terminations editing user
interface.
Note: The PC must have a license for the Wiring Manager application for this feature to be
available from Engineer.
Note: Although Wiring Rules can be used to create field cables/terminations from Engineer,
this is limited to working on a tag by tag or Loop by Loop basis. AVEVA recommends
creating field wiring using Wiring Rules from the Wiring Manager's Equipment View
or Cable Block Diagram by assigning (allocating) field tags to Junction Boxes, which
is more efficient than doing it in Designer for each tag and Loop.
Explanation of Fields:
Note: Although the specified Wiring Rule (in the Wiring Config field) defines the
terminal configurations of the Field Device, users can select a different
configurations clicking on the button in the Tag No field and selecting from the list
of configurations in the Select a Field Device Terminal Configuration window
that is then displayed. See Select a Field Device Terminal Configuration.
Loop Dwg Code The 'Loop Code' is used by AVEVA Instrumentation Datalinks to
map information into a loop drawing template when generating
CAD drawings. It is ONLY required if CAD loop drawings are to be
generated in Designer. This 'Loop Code' must be unique for the
current loop for CAD loop drawing creation.
Wiring Config The name of the Wiring Rule to apply to the tag. Select the rule by
clicking the button in the field. The Wiring Rule Definitions
window is then displayed (refer to Assign Wiring Rules to Tags for
details). Select the required rule from the list of rules and click OK.
The selected rule is then displayed in this field.
Junction Box This displays the name of the equipment the cable will run to.
Clicking on the button in this field will display a window used to
Assign a Junction Box.
Cable Number This shows the default cable number as created by the wiring rule
or the actual cable number from the AVEVA Instrumentation Cable
Schedule (if the cable has been created previously). Enter a new
value if required.
Cable Type This shows the base cable type. It can be changed by selecting
the cell command button that appears when the mouse is hovered
over this cell. The initial cable type comes from the Wiring Rule
catalogue cable (if the cable is not yet created) or from the Cable
Schedule (if the cable has been created previously). Clicking the
cell button displays the Select a Cable from Catalogue window
allowing a new catalogue cable to be selected.
Cable Length Enter a Cable Length here. This length is saved in Wiring
Manager's Cable Schedule.
Command Buttons:
Create Creates all selected tags, cables, termination and other wiring data from
the Wiring Rules and data in this grid.
Save Saves the changed data in the grid, but does not create Wiring Rule data.
This enables users to pre-assign junction boxes etc prior to cable/device
creation.
As soon the wiring data is created, all the information generated (or changed) may be
viewed in the Tag Wiring Check Report. Refer to Tag Wiring Check Reports.
The Graphic tab displays graphical representations of each available configuration. The List
tab displays them in a simple list.
To select a configuration and exit the window, either double-click on it, or single click on it
and click Select.
Select the required rule from the list on the left. If required, use the facilities above the list to
filter the number of rules displayed.
A graphical representation of the rule is displayed on the right. Click OK to apply the rule to
the field device.
The window then exits, and the selected rule is displayed in the Wiring Config field of the
Create Tag Wiring for window. The Cable Number and Cable Type fields are also
completed or updated as appropriate.
See Wiring Manager documentation for information on creating and editing wiring rule
definitions.
Select the All Areas option to view equipment in all plant areas.
To assign a Junction Box, double-click on the required equipment tag.
Junction Boxes and other Equipment (other than field devices) can only be created in the
Wiring Manager module.
Note: In order to select another Tag as the Junction Box (cable end) connection that tag
must have previously been created by a Wiring Rule for it to appear in the List of
Equipment. For example, to connect a Field Element to a Transmitter, first the
Transmitter must be created, then the element must be assigned to the Transmitter
(e.g the Transmitter becomes the element's Junction Box).
Note: The instrument Signal Type is shown near the top of this window. This comes from
the Instrument's Signal Type field in the AVEVA Instrumentation Instrument Data
window. However any instrument may be assigned to any junction box, regardless of
signal type.
Note: The maximum number of cables that may be connected to a junction box may
(optionally) be specified in Wiring Manager. If the application of a wiring rule would
result in more than when the maximum number of cables being assigned to it, a
message is displayed to inform the user of this.
Note: If the PC has a license for Wiring Manager, on any equipment tag is right-clicked on,
AVEVA Instrumentation will display an option to allow access to the Wiring
Manager's Terminations window, which provides drag and drop editing of cable/wire
terminations, and an option to generate a termination report for the selected
equipment.
Note: If the PC has a license for Wiring Manager when any cable is right-clicked on,
AVEVA Instrumentation will display an option providing access to Wiring Manager's
Cable Detail window, which is used to view and edit the details of the cable.
Refer to Wiring Manager documentation for details of the above Wiring Manager facilities.
Various functions are available to the user via the File, Edit, View and Layout drop-down
menus, or by clicking the required button on the toolbar.
File Menu
File Saves the report to the database. This option is available on the
toolbar.
Refresh Updates and reloads the tag data and refreshes the window. This
option is available on the toolbar.
Export to PDF Exports the report into a .pdf format file in the projects Drawing
folder. The filename used is the Tag number.
Export to XPS Exports the report into an .xps format file in the projects Drawing
folder. The filename used is the Tag number.
Export to Exports the report to AutoCAD. The filename used is the Tag
AutoCAD number.
Page Setup Displays the Page Setup window which enables the user to
change the paper size and source, the orientation and the size of
the margins.
Print Preview Displays the Print preview window which enables the user to view
the print before sending to a printer. This option is also available
on the toolbar.
Print Displays the Print window which enables the user to customise
the print. This option is also available on the toolbar.
Printing Enables the user to print the report to a defined size by selecting a
percentage. After selecting a percentage, the Print preview
window is displayed, enabling the user to view the print before
sending to a printer.
Edit Menu
Undo Undoes the last command. This option is also available on the
toolbar.
Redo Redoes the last Undo. This option is also available on the toolbar.
Trim Canvas Enables the user to change the size of canvas to the actually size
of the diagram.
Find Equipment Displays the Find Text window, enabling the user to search for a
term.
Insert Note Opens a text box within the report which enables the user to type a
note. The text box can be positioned in the report by clicking on it
and dragging it to the required position.
View Menu
Show Overview Display the Overview window which displays all the report pages.
Zoom to Fit Zooms to fit all the pages into the window. This option is also
available on the toolbar.
Zoom In Zooms into the report. This option is also available on the toolbar.
Zoom Out Zooms out from the report. This option is also available on the
toolbar.
Layout Menu
Align Enables the user to move two or more selected nodes to the same
Horizontally row, inline with the first selected node.
Align Vertically Enables the user to move two or more selected nodes to same
column , inline with the first selected node.
Make Sub Enables the user to select multiple items of equipment and group
Diagram them all together, keeping the item to be individually selected and
moved.
Layout Sub Enables the user to layout the items inside sub diagrams
Diagram automatically.
Group Selected Enables the user to select multiply items of equipment and group
them all together.
Preferences
Tag Wiring Check Report preferences can be set from the Preferences window. To display
this window select Preferences from the File menu.
Note: In addition to the preferences described here, the default Enhanced Cable Block
Diagram cable label symbol defined in Wiring Manager may be used on Wiring
Check Reports instead of the normal symbol, depending on the Wiring Manager
preferences for the project.
The General tab is used to specify how the Tag Wiring Check Report is displayed.
The Cable/Wires tab is used to specify how the cable and wires will be displayed in the Tag
Wiring Check Report.
The Printing tab is used to set the default paper size, orientation and margins, the maximum
number of terminals that can be displayed on each page and to add a header and footer to
the pages.
The Export tab is used to define the settings to be used when exporting the Tag Wiring
Check Report to AutoCAD.
Note: The user must have AutoCAD installed on their workstation to export the Tag Wiring
Check Report successfully.
The user can revert the report references back to the default settings by clicking Use
Default.
Click OK to save the changes and close the Preferences window or Cancel to close the
Preferences window without saving any changes.
To commit the changes to the Tag Wiring Check Reports window click Apply. A warning
message is displayed informing the user that applying the new settings will cause the
diagram to reload.
Note: The PC must have a license for the Wiring Manager application for this feature to be
available from Engineer.
Although Wiring Rules can be used to create field cables/terminations from Engineer, this is
limited to working on a tag by tag or Loop by Loop basis. AVEVA recommends creating field
wiring using Wiring Rules from the Wiring Manager's Equipment View or Cable Block
Diagram by assigning (allocating) field tags to Junction Boxes, which is more efficient than
doing it in Designer for each tag and Loop.
The window shows all instruments assigned to the current loop. Only those instruments
selected will be processed by the Create command.
Columns Explanation
Select Only those instruments that have their Select checkbox checked are
processed when the Create command is used.
TagNo The instrument tag number - non-editable (tags can only be assigned to
a loop using Engineer).
Note: Although the specified Wiring Rule (in the Wiring Config field) defines the
terminal configurations of the Field Device, users can select a different
configurations clicking on the button in the Tag No field and selecting from the list
of configurations in the Select a Field Device Terminal Configuration window
that is then displayed. See Select a Field Device Terminal Configuration.
WiringRule The name of the Wiring Rule to apply to the tag. Select the required rule
from the list of available rules (the list is only displayed when the mouse
is hovered over the cell).
Junction This displays the name of the equipment the cable will run to. A button is
Box displayed when the mouse is hovered of this cell. Clicking on that button
will display a window used to Assign a Junction Box.
Terminate When this checkbox is checked, cores will be terminated at the Junction
Box end (on the next available spare terminals). When it is unchecked,
cores will not be terminated at the Junction Box end. The cores will need
to be terminated manually, using Wiring Manager, by dragging the cable
or cores to the desired terminals.
Cable No. This shows the default cable number as created by the wiring rule or the
actual cable number from the AVEVA Instrumentation Cable Schedule (if
the cable has been created previously). Enter a new value if required.
Length Enter a Cable Length here. This length is saved in Wiring Manager's
Cable Schedule.
Cable Type This shows the base cable type. It can be changed by selecting the cell
command button that appears when the mouse is hovered over this cell.
The initial cable type comes from the Wiring Rule catalogue cable (if the
cable is not yet created) or from the Cable Schedule (if the cable has
been created previously). Clicking the cell button displays the
Catalogue Cable window allowing a new catalogue cable to be
selected.
Command Buttons
Create Creates all selected tags, cables, termination and other wiring data from
the Wiring Rules and data in this grid.
Save Saves the changed data in the grid, but does not create Wiring Rule
data. This enables users to pre-assign junction boxes etc prior to cable/
device creation.
Terminate When this checkbox is checked, cores will be terminated at the Junction
Box end (on the next available spare terminals). When it is unchecked,
cores will not be terminated at the Junction Box end. The cores will need
to be terminated manually, using Wiring Manager, by dragging the cable
or cores to the desired terminals.
As soon the wiring data is created, all the information generated (or changed) may be
viewed in the Loop Wiring Check Report. Refer to Loop Wiring Check Reports.
The Graphic tab displays graphical representations of each available configuration. The List
tab displays them in a simple list.
To select a configuration and exit the window, either double-click on it, or single click on it
and click Select.
Select the All Areas option to view equipment in all plant areas.
To assign a Junction Box, double-click on the required equipment tag.
Junction Boxes and other Equipment (other than field devices) can only be created in the
Wiring Manager module.
Note: In order to select another Tag as the Junction Box (cable end) connection that tag
must have previously been created by a Wiring Rule for it to appear in the List of
Equipment. For example, to connect a Field Element to a Transmitter, first the
Transmitter must be created, then the element must be assigned to the Transmitter
(e.g the Transmitter becomes the element's Junction Box).
Note: The instrument Signal Type is shown near the top of this window. This comes from
the Instrument's Signal Type field in the AVEVA Instrumentation Instrument Data
window. However any instrument may be assigned to any junction box, regardless of
signal type.
Or, in the Loop Edit window (see Edit a Loop in the Loop List), click Loop Check Report.
The report is then displayed. For example:
With the exception of the additional Export to Designer option on the File menu (see
below), all menu, toolbar and other facilities are identical to those of the Tag Wiring Check
Report. Refer to Tag Wiring Check Reports for details.
Note: If the PC has a license for Wiring Manager, on any equipment tag is right-clicked on,
AVEVA Instrumentation will display an option to allow access to the Wiring
Manager's Terminations window, which provides drag and drop editing of cable/wire
terminations, and an option to generate a termination report for the selected
equipment.
Note: If the PC has a license for Wiring Manager when any cable is right-clicked on,
AVEVA Instrumentation will display an option providing access to Wiring Manager's
Cable Detail window, which is used to view and edit the details of the cable.
Preferences
Loop Wiring Check Report preferences can be set from the Preferences window. To display
this window select Preferences from the File menu.
All preferences are identical to those of the Tag Wiring Check Report. Refer to Tag Wiring
Check Reports - Preferences for details.
Export to Designer
The is option creates a record of the diagram in the Drawing List in Designer and generates
an AutoCAD version of the Loop diagram.
Settings for the export, such as the seed file to be used, are specified on the Export tab of
the Preferences window.
10 Datasheets
Datasheets are stand-alone documents which the user can view, edit or exchange with third
parties. Refer to Datasheets (Specifications) for further information on the available
features.
Continue at:
• View/Edit Instrument Datasheets
• Datasheets List
• Add New Datasheets
• Edit Datasheet Information
• Assign Tags To Datasheets
• Delete Datasheet Options
• Print Datasheets
• Datasheet Revisions
• Datasheet Issues
• Import Datasheets from Excel
• Datasheet Publishing
• Merge Datasheets into a Single Document
• Document List
• Datasheet Form Catalogue
• When editing a tag, on the Datasheet tab of the Edit window, click the button next to
the Datasheet No field.
The datasheet is then displayed in the Datasheet viewer. Refer to the Datasheet Data Entry
for details.
Note: If the instrument tag or catalogue instrument is not currently assigned to a datasheet
when the button in the Instruments and Instruments Catalogue lists or on the
Datasheet tab is clicked, then Engineer will prompt users to assign it. Refer to Add
New Datasheets for details of how to accomplish this.
Note: Only changes made to Process Data and data associated with form type can be
saved in this window. Changes made to Revisions, the Document Number and Tag
Numbers within this window cannot be saved from this window. To make these
changes use the appropriate Instrument List, Datasheet List and Datasheet List
Revisions windows.
Editing a PickList
If a cell has a PickList attached, then if that cell was right-clicked on, a pop-up menu is
displayed. Select Edit PickList Values from that menu. The PickList edit window is then
displayed, in which values can be added, edited or changed in the selected PickList.
For example:
Save Saves the data values to the database and opens it in an Excel
spreadsheet.
Save & Exit The Save & Exit option is accessed from a drop-
down list next to Save and saves the data values to
the database and to the Excel spreadsheet and
closes the datasheet.
Undo Undoes the last change made. Any subsequent undo will roll back each
previous change.
Print to PDF Saves the data to a PDF file and opens it.
Note: The Print and Save commands use Microsoft Excel, therefore Excel must be
installed on the workstation to if these facilities are to be used. The Print
command uses the print area, print setup (Margins, scales etc.) as defined in the
datasheet form template file for the current project.
Issue Issues the datasheet by taking a snapshot of the data in the datasheet's
mapped cells and saving it to database for future reference. This
enables AVEVA Instrumentation to show changes between Issues.
The Issue option and its sub-menu options are not available for
datasheets assigned to catalogue equipment.
If the document has previously been issued, an Issue message window
is displayed informing the user to create a new revision before issuing.
Reset Resets the datasheet to its last saved / opened state by clearing
“changed” cells and reverting the values back to original values.
Zoom Zooms the Datasheet Layout area according to the value selected from
drop down. Use the and buttons to decrement or increment
the zoom.
Apply Default If this option is checked, then on the update of a value in a datasheet
Units cell, the default unit is appended with the value if no unit is had been
entered previously.
Note: Right-clicking on a cell displays a special menu from which special characters (° ± ² ³
¼ ½ ¾ ?) can be inserted.
The grid shows all fields associated with the datasheet as defined in the Datasheet Form
Catalogue Grid.
Select a Tag Select the tag from which data is to be copied from this list. Only
or Catalogue tag numbers assigned to the same datasheet form type will be
Instrument to available for selection.
Copy From
Show Process Checking the Show Process Data checkbox displays the
Data process data in the grid view.
Existing Value The current value of each field for the target tag.
Proposed Value The data about to be copied, if accepted, from the selected
source tag, as chosen from the Select a Tag to Copy From list.
After all required fields values are selected, click Save to copy the data to the current tag or
Cancel to exit without copying data.
Note: Only fields associated with the datasheet are available to copy. Copying Instrument
Index data such as Tag Number, Service, Line or Equipment Number or Datasheet
title and Revision data is not possible with this feature.
Note: If the selected tag or catalogue instrument type is associated with a datasheet with a
different form type from the tag or catalogue instrument being copied to, a message
is displayed to inform the user of this and to give the option of keeping the existing
datasheet or replacing it with a datasheet derived from the form type linked to the
selected tag or catalogue instrument.
Note: The selected field must already contain valid numeric data along with a Process Unit
recognised by AVEVA Instrumentation.
The Change Process Units sub-menu includes all the supported units for that process and
enables the user to change from one unit type to another unit type without changing the
value. For example 64°C to 64°F.
The Convert Units sub-menu includes all the supported units for that process type. The
example below shows the sub-menu for a Temperature field:
To convert the selected field to a new unit and change the value to reflect this, click on the
required unit from the sub-menu.
Conversion Prefixes
AVEVA Instrumentation uses a smart algorithm to recognise SI unit prefixes automatically
as follows:
y yocto -24
z zepto -21
a atto -18
f femto -15
p pico -12
n nano -9
u micro -6
m milli -3
c centi -2
d deci -1
h hecto 2
k kilo 3
M mega 6
G giga 9
T tera 12
P peta 15
E exa 18
Z zetts 21
Y yotto 24
Note: For the conversion to be successful these Si prefixes must be used with their correct
case. e.g KPa will not be recognised. It should be kPa.
These preferences affect the Datasheet Data Entry window and printed datasheets when
using the Print with Previous Issue's Changes print option and are applied once a
datasheet is Issued.
Note: In a multi-user environment there will only be one set of preferences that will be
applied to all the users, i.e. each user cannot have their own preferences.
Issue Changes:
Font Select the font from the drop down to show in issue change highlighting.
Font Size Select or enter the font size of the text in issue change highlighting.
Bold Specify whether the text in issue change highlighting will be bold or not.
Back Colour Select the back colour for issue change highlighting of cells.
Fore Colour Select the text colour for issue change highlighting of cells.
Current Changes:
Font Select the font from the drop down to show in current change
highlighting.
Font Size Select or enter the font size of the text in current change highlighting.
Bold Specify whether the text in current change highlighting will be bold or
not.
Back Colour Select the back colour for current change highlighting of cells.
Fore Colour Select the text colour for current change highlighting of cells.
Printing:
Watermark The text that appears as watermark on each Datasheet when printing if
there are any changed values since the last issue.
Note: Datasheets assigned to catalogue instruments are not listed in the Datasheets List
grid.
The following options are located on the List Tools - Datasheets tab
Records Section
Refresh
New These common options are also located on the Home tab.
Edit Refer to the Common Functionality User Guide for details.
Delete
Action Section
Update Displays the Update options window which updates the spreadsheets
of the selected datasheets with the current project data. If an Excel
workbook file does not exists the file is created in the project's datasheet
folder.
Open Issues Displays the Issues window listing all the issues of the selected
For Selected datasheet. Refer to View a List of Previous Issues for further
information.
Open Issues Displays the Issues window listing all the issues of all datasheets in the
For All list. Refer to View a List of Previous Issues for further information.
Revisions Displays a list of all datasheets and their revisions. Refer to Viewing and
Editing Multiple Datasheet Revisions.
Add Displays the Revision Entry window, used to add a revision to the
Revision currently selected datasheet. Refer to Create a Revision.
Edit Displays the Revision Entry window, used to edit the current revision
Revision of a selected datasheet. Refer to Edit a Revision.
Highlight Used to highlight which issued datasheets include data that has been
Documents changed in the database and therefore should be reissued. Refer to
for Reissue Highlight Datasheets for Reissue.
Tools Section
Batch Displays the Batch Assign Tags to Datasheets window, which lists all
Assign Tags instrument Tags not yet assigned to a datasheet and provides facilities
for the assignment of multiple tags to datasheets in a batch process.
Refer to Batch Assign Multiple Tags to Datasheets for details.
Printing Section
Number of Select the number of copies of selected datasheets required for printing.
Copies
Print with Prints with changes from the previous issue highlighted.
Changes
Print To PDF Creates a PDF file of the selected datasheets with changes from the
with previous issue highlighted.
Changes
Export Section
To External Publishes documents to the area that was set up using the Setup >
System Datasheets Publishing Configuration option on the Project tab.
Refer to Datasheet Publishing.
Selected
Datasheets
2. Enter a sheet or page number in the Sheet/Page No field, unless the Use Next Sheet
No checkbox is checked.
If the Use Next Sheet No checkbox is checked, AVEVA Instrumentation will
automatically use the next available sheet number by searching for all other datasheets
with the same Datasheet No and using next highest sheet number. If none are found
then AVEVA Instrumentation uses '1'.
Note: The document number is made up of: 'Data Sheet No' + '-' + 'Sheet/Page No'. When
the new datasheet is saved, AVEVA Instrumentation will check that this document
number is unique. If the combination of Datasheet No and Sheet/Page No has been
used before, an error message is displayed. A different combination must then be
entered.
3. If required, filter the list of forms displayed in the window by selecting a form type
(Datasheet or Other) from the Form Type list.
Note: Equipment items can be only be assigned a Datasheet type form once. They may be
assigned Other type forms as many times as required.
4. Select the required datasheet form from the list provided (from the Datasheet Form
Catalogue Grid).
5. Click Next > to create the new datasheet. The new, blank, datasheet is then added to
the Datasheet List and the Add a New Datasheet window is displayed, used to assign
tag(s) to the datasheet and to add of other information relevant to the new datasheet.
The window then changes to display more facilities for entering datasheet information:
Note: If further datasheets are added during the current session Instrument Engineer will
remember the last Plant Area, Datasheet No and Form Type pre-filling those values
in this form.
The window is the same as the Datasheet Information window, used for editing existing
datasheets. Refer to Edit Datasheet Information for details.
The window is also displayed when assigning datasheets to an instrument tag or catalogue
instrument, although it is called Add a New Datasheet or Add Datasheet for: during that
procedure. Refer to Add New Datasheets.
The datasheet and sheet numbers may be changed if required (remember the combination
of these two numbers must be unique for the project).
If required, enter or change the plant area and the contract, requisition and purchase order
numbers of the datasheet.
There are five tabs in the bottom section of the window:
Tags Lists all tags assigned to this datasheet, and is used to assign
further tags, or unassign tags. For further details, see below.
Note: The number of tags that can be assigned to a datasheet is defined in the
Datasheet Form Catalogue for the current form type.
Revisions Lists all revisions for this datasheet, and is used to add, edit and
delete revisions. For further details, see below.
User Fields Used to complete the user fields for the current datasheet.
Note: The Last Edit field displays the date and time when the datasheet data was last
[Link] user name of the individual that performed the edit is displayed in a tool-
tip when the mouse cursor is hovered over the field. Click the button in the field to
display the Audit Manager, which will display a list of all the changes to the datasheet
data.
Note: The number of tags that can be assigned to a datasheet is defined in the Datasheet
Form Catalogue for the current form type.
Note: In the case of catalogue instruments, only a single catalogue instrument may be
assigned to the datasheet. In other words, before assigning a different catalogue
instrument to a datasheet, the catalogue instrument currently assigned must first be
unassigned (see below).
Note: Removing a tag or Catalogue Instrument does not delete the tag or its data from the
project database. If the tag or Catalogue Instrument is reassigned to another
datasheet of the same form type (e.g Venturi Tubes) the data will be inserted into
that datasheet, which is useful if tags need to be moved between datasheets.
Revisions Tab
The Revision Tab displays the revision history for the selected datasheet. The number of
revisions displayed and the column descriptions can be changed using the Preferences
window. For more information, refer to Options and Setup.
Add Displays the Revision Entry window, used to add a new revision to
current datasheet. See Create a Revision.
Edit Displays the Revision Entry window, used to edit the currently selected
revision. See Edit a Revision.
Note: Pressing the <Delete> key will also delete the currently selected
revision.
Save Changes
Changes made using this window are not saved until the Save button is clicked.
Note: AVEVA Instrumentation does not update the external Excel workbook file with any
changes until either the datasheet is opened using the Open command or updated
using the Update command on the List Tools tab of the Datasheet List.
The Select Tag(s) to Assign to Datasheet window shows all the tags that have not yet
been assigned to any datasheet of the DataSheet form type.
Note: Instruments can be only be assigned to a datasheet of the Datasheet type form once.
They may be assigned Other type forms as many times as required.
The tags list can be filtered to enable easier access to tags using standard grid facilities, and
the Match Operating Principle checkbox.
When the Match Operating Principle checkbox is checked, only those tags with the same
Operating Principle as the Catalogue type of the datasheet are listed. When the Match
Operating Principle checkbox is not checked all tags from the Instrument List which have
any operating principle that is not blank (empty) are shown.
Note: The selected tag(s) are allocated to the next available spare tag position on the
datasheet. To change tag positions then the tags can be dragged into a new position
using the Edit Datasheet Information window.
Alternatively, click the Select checkbox for each to be assigned, then click the Select
button.
The Batch Assign Tags to Datasheet window shows all the tags that have not yet been
assigned to any datasheet.
To assign multiple tags to a datasheet type, click the Select checkbox for each tag to be
assigned.
The selected tags are added to the Tag No list to the right of the main grid.
Note: Use the column filters and the Select All button to select multiple tag numbers.
Or drag each instrument record to the Tag No list (or drag all selected records).
Note: Initiate a drag by selecting the white space to left of each record. If multiple Tag
records are selected the drag method will assign all the selected tags.
To remove a tag from the Tag No list select it, then press the <Del> (Delete) key.
Delete from List Only Deletes the datasheet records from Datasheet List, but
does not delete the Excel spreadsheets, if they exist.
Delete Datasheet File Only Deletes any existing Excel spreadsheets, but does not
delete the datasheet records in the Datasheet List.
Delete from List and Deletes both the spreadsheet files and removes the
Datasheet File datasheet records from Datasheet List.
Delete Process Properties Delete process properties from tags assigned to the
datasheets.
Print with Changes Sends the latest issue of the selected datasheets to the
default printer. The printed copy is printed with the changes
made from the previous issue highlighted. Highlighted
changes are as specified by the Datasheet Change
Preferences window.
Print to PDF Prints the latest issue of the selected datasheets to a PDF file
which is stored in the folder designated in the Project Data
window.
Print to PDF Changes Prints the latest issue of the selected datasheets to a PDF file
which is stored in the folder designated in the Project Data
window. The PDF file highlights the changes made from the
previous issue. Highlighted changes are as specified by the
Datasheet Change Preferences window.
Note: The spreadsheet file must already exist to be printed. The Update facility (see
Datasheets List - List Tools Options) can be used on multiple datasheets to create/
update the datasheet spreadsheet file from the database. This ensures the latest
database information (e.g Revisions, Instrument List data changes such as Tag No,
Service, P&ID etc.) will be used.
Note: Printing is handled by Microsoft Excel. To print datasheets Microsoft Excel must be
installed on the workstation.
If a single datasheet was selected, enter the new revision number in the Revision No field.
If multiple datasheets were selected, a different version of the window is displayed:
Either enter a revision number in the Revision No field to be applied to all the selected
datasheets, or click the Auto Increment checkbox (this is not available when editing
multiple revisions, only when creating). The Revision No field is then disabled. When Save
is clicked, all the revision numbers of the selected datasheets are incremented by one, e.g.
if the current revision is “A”, then the next is “B” or if current revision is “2”, then the next is
“3” etc.
Double-click on the Date field to open a date selection form (or press the Enter key when
the Date field is selected).
The Description field contains a list of all previously created revision descriptions. Add a
new description by entering it in the field. Any new descriptions will be available for future
revisions.
Note: Which fields appear on this window (apart from the Revision No, Date and
Description fields) and their names is specified on the Datasheet tab of the Options
window. See Options.
If multiple datasheets were selected, the window will be blank except for the Date field.
Refer to Create a Revision for details.
To view the revisions for a single datasheet, click on the + icon next to its listing.
If the report has already been issued at the current revision, or has had no revisions created
for it, a message window is displayed to inform that the user that a new revision must be
created before issuing.
Click Cancel to cancel the issue or OK to create a new revision. Refer to Datasheet
Revisions for further information on creating a new revision.
Once the revision has been created, or if neither of the above conditions apply, the
datasheet revision is issued, and opened in Microsoft Excel.
To view a list of previous issue, see View a List of Previous Issues.
• Or, click Open Issues for Selected or Open Issues for All as required in the Actions
section of the List Tools - Datasheets tab.
The Issues window is then displayed:
Command Buttons:
Find Displays the Find window, used to search for any text string located
anywhere within the grid.
Filter Displays up window used to define Advanced Grid Filters for the grid.
Refresh Updates entire grid with latest database information (useful in multi-user
project environments).
• The Excel spreadsheet file must reside on an accessible disk (either on a network,
local hard disk or removable drive). Furthermore, if multiple spreadsheet files are to be
imported it is recommended that they all reside in same directory/folder.
Note: The easiest way to satisfy the above criteria is to create the datasheet using the
AVEVA Instrumentation Engineer application (this will satisfy the first two criteria
above), then copy the created Excel spreadsheet to a directory for editing in Excel.
To import an Excel datasheet, with the Datasheets List open, click From Excel in the
Import section of the Manage tab.
The Datasheet(s) Import window is then displayed:
Note: The entry in the Datasheet folder field defaults to the folder selected during the last
import.
Note: To minimise the possibility that data currently being worked on by another user may
be affected by an import, a list of the users working on the current project is available
from the UserCount link. The number of current users is displayed next to the link.
This total includes the user performing the import.
Click the button to the right of the Datasheet Folder field to display the Browse for Folder
window.
Select the folder that holds the Excel spreadsheets and click OK. The Datasheet(s) Import
window refreshes and displays a list of valid spreadsheets in the selected folder.
Note: In this context a valid datasheet spreadsheet means the Excel spreadsheet file name
(.xls) must be identical to a previously created datasheet in the Datasheet List.
To select a spreadsheet to import, select the Import checkbox (on left of each Datasheet
filename) then click Import. To import all spreadsheets check the Select All checkbox
above the list then click Import.
Clicking Import processes each selected spreadsheet and displays a detailed list of
proposed changes, for example differences between data in the spreadsheets and the
current database.
To cancel without importing click Cancel.
Note: The list in this window shows all values that are different in the imported Excel
spreadsheet and the AVEVA Instrumentation database. Values that are the same are
not listed.
Note: The import is done on a per tag basis. The tag value is shown in parentheses after
the field name.
Tag numbers are never imported. The data from each imported datasheet is applied to each
tag that has already been assigned to each datasheet, refer to Assign Tags To Datasheets
for further information.
To import the checked values click Import.
To cancel any import for the current Excel spreadsheet click Cancel.
For both of the above commands, if multiple files are selected for import Instrument
Engineer will display the next files 'Delta Values' window. If multiple files have been selected
for import, users can stop all imports by clicking the Stop Importing command.
In the Publishing folder field, enter the folder into which datasheets are to be published, or
click … and browse for it.
If PDF versions of published files are to be generated using Excel, in addition to the
published Excel files, check Publish as PDF.
If PDF versions of published files are to be generated using a PDF generator other than the
Excel PDF writer, in the Executable to handle publishing field, enter the name and
location of the executable file that will handle the publishing, or click … and browse for it. If
Publish as PDF is checked, this setting will be ignored.
For each published datasheet, an XML file containing selected datasheet data is also
produced in the publishing folder. To select the datasheet data that the XML file will include,
click Add. A blank row is added to the area below this button. From the drop down list in this
row, select the required datasheet data. Repeat for each type of datasheet data required.
To delete a row, select it and click Delete. A message will be displayed requesting that the
deletion be confirmed. Click Yes.
If no fields are selected, the XML files are not generated.
To save configuration changes and exit the window, click Save.
To exit the window without saving any changes, click Cancel.
If the Document Information window is accessed from the Datasheets grid, the
datasheets that were selected are listed in the lower half of the window on the Main tab.
These can be removed and further datasheets can be added.
If the Document Information window is accessed by clicking New on the Document List
grid, no datasheets are listed. Add datasheets as described next.
If the Document Information window is accessed by clicking Edit on the Document List
grid, the datasheets previously assigned to the document are listed. Add or remove
datasheets as required.
To select a datasheet, either double-click on it, or highlight it and click Select. The datasheet
is then added to the list in the Document Information window.
Select the file type from the Format list, PDF, Excel or Zip. The Zip format is a collection of
Excel files, one for each document sheet, in a .ZIP file. The PDF and Excel formats are
single, multi-page files that include all the document sheets.
To select the datasheet that will be used as the front page for the document, click the Select
button next to the Front Sheet field. The DataSheet Catalogue window is displayed.
The Datasheet Catalogue window lists all those datasheets from the catalogue of the Front
Sheet type. To create a new front sheet datasheet, click New. The Catalogue Information
window is then displayed, in which details of the new datasheet can be entered. Refer to
Add a New Datasheet Definition for details.
To select a datasheet, either double-click on it, or highlight it and click Select. Once a front
sheet datasheet is selected, it is displayed in the Front Sheet field. Click the adjacent Clear
button to de-select it and clear the field.
To generate an index sheet for the document, click Create next to the Index Sheet field. A
standard index sheet is then automatically generated for the document and is displayed in
the Index Sheet field. The Create button is then replaced by a View button. Click View to
open the index sheet in the Custom Report window from which it can be edited if required.
Refer to Reports for details. Click the adjacent Clear button to delete the index sheet.
To select the datasheet that will be used as the summary page for the document, click the
Select button next to the Summary Sheet field to display the Datasheet Catalogue
window. To create a new Summary Sheet datasheet, click New. The Catalogue
Information window is then displayed, in which details of the new datasheet can be
entered. Refer to Add a New Datasheet Definition for details. Follow the same procedure as
for front sheets, as described above.
To select a datasheet, either double-click on it, or highlight it and click Select. Once a
summary sheet datasheet is selected, it is displayed in the Summary Sheet field. Click the
adjacent Clear button to de-select it and clear the field.
Revisions
Document revisions are added, edited and deleted using the Revisions tab.
Note: Revisions can also be added, edited and deleted from the Document List window.
To add a new revision, click Add to display the Revision Entry window.
Note: The text field descriptions displayed are dependant on the settings made in the
Preferences window. For further information refer to Options and Setup.
When creating a new revision, leaving the Revision No field blank will cause
Instrumentation to use the next revision number. e.g. if the current revision is "A", then the
next is "B" or if current revision is "2", then the next is "3" etc.
The Date field defaults to the current date, but a different date may be selected if required.
The Description field contains a list of all previously created revision descriptions. Add a
new description by entering any required description. Any new descriptions will be available
for future revision entries.
Once a revision is created it is listed in the Revisions tab.
To edit a revision, select it and click Edit to display the Revision Entry window. Change the
revision details as required and click Save.
To delete a revision, select it and click Delete. The revision is then deleted.
Note: New revisions, changes to revisions and deletions of revisions are not saved to the
project database until the Save button is clicked.
Title
Enter the document title text in the fields in the Title tab.
User Fields
Enter any user/project specific text in the fields in the User Fields tab.
Notes
Enter any notes or remarks in the fields in the Notes tab.
Note: Documents can also be published from the Document List window. See Document
List.
To exit the Document Information window without saving or publishing, click Cancel.
Refer to Working with the Data Grid for information on the grid controls including selecting a
document record, and sorting and filtering the grid data.
Document details cannot be edited directly in the grid. They are edited using the Document
Information window. Refer to Merge Datasheets into a Single Document for details.
Records Section
Refresh
New These common options are also located on the Home tab.
Edit Refer to the Common Functionality User Guide for details.
Delete
Action Section
Revisions Displays a list of all documents and their revisions. Refer to View
and Edit Multiple Document Revisions.
Add Revision Displays a window for adding a new document revision. If multiple
documents are selected, a new revision may be added to each of
these. Refer to Add and Edit Revisions for Single Documents and
Add Revisions to Multiple Documents.
Edit Revision Displays a window for editing the most recent revision of document.
Refer to Add and Edit Revisions for Single Documents.
Refresh Sheet/ Updates the grid with the current sheet/page counts of the listed
Page Count documents.
Delete from List Only Deletes the documents from the Document List but does not
delete any published document files.
Delete Document Only Deletes published files but does not delete the documents
from the list.
Delete from List and Delete the documents from the Document List and delete
Document any published files.
To view the revisions for a single drawing, click on the + icon next to its listing.
To view revisions for all drawings, click Show All Revs.
To edit an existing revision click Edit. The Multi-Field Edit (Bulk Edit) window is displayed.
• To edit a revision field, check the appropriate checkbox and enter the new value.
• Click Select all to select all fields for editing.
• Click Copy first record's data to copy the values for the revision first selected in the
Revision window into the fields.
• Once the required changes have been entered, click Save.
To add a new revision, click New. The Revision Entry window (described below) is then
displayed. Enter the required details and click Save.
To delete a revision, select the revision and click Delete. A message will then be displayed
requesting that the deletion be confirmed. Click Yes to confirm the deletion or No to cancel.
Note: Revisions can also be added and edited using the Revisions tab of the Document
Information window. Refer to Enter Basic Document Details for details.
Note: The text field descriptions displayed are dependant on the settings made in the
Preferences window. For further information refer to Options and Setup.
When creating a new revision, leaving the Revision No field blank will cause
Instrumentation to use the next revision number. e.g. if the current revision is "A", then the
next is "B" or if current revision is "2", then the next is "3" etc.
The Date field defaults to the current date, but a different date may be selected if required.
The Description field contains a list of all previously created revision descriptions. Add a
new description by entering any required description. Any new descriptions will be available
for future revision entries.
Once a revision is created it is listed in the Revisions tab of the Document Information
window. Refer to Enter Basic Document Details for details.
To edit a revision, select it and click Edit Revision on the List Tools - Document List tab.
The Revision Entry window is then displayed. Change the revision details as required and
click Save.
setup, margins, colours, shading etc. are controlled by this Excel template. There is no
control of formatting/layout within AVEVA Instrumentation, which just transfers data between
the spreadsheet cells and the AVEVA Instrumentation database.
Once new spreadsheet layout is complete, register it in the Datasheet Form Catalogue Grid
(see Add a New Datasheet Definition).
Once the new Catalogue Datasheet template is registered, open this datasheet template in
design mode from the Datasheet Form Catalogue Grid List and define map the datasheet
cells to the appropriate database fields (see Map Database Fields to Datasheet Cells). This
step enables AVEVA Instrumentation to update each cell with the required database data
(and vice versa).
Note: AVEVA Instrumentation can only save data to/from the project database/Excel
workbook if a worksheet cell is mapped to a database field. Any other data will not be
saved.
Finally, while in the design mode, assign picklists cells for more efficient data entry (see
Assign a PickList to a Cell).
When this is completed, the new datasheet template is then ready for use on the project.
The Datasheet Form Catalogue grid displays information for each datasheet form definition.
Records Section
Refresh
New These common options are also located on the Home tab.
Edit Refer to the Common Functionality User Guide for details.
Delete
Actions Section
Open Opens the selected datasheet definition for editing. Refer to Map
Database Fields to Datasheet Cells and Assign a PickList to a Cell.
Printing Section
Number of Used to select the number of copies to be printed using the Print Forms
Copies option.
Print Forms Prints selected empty (blank) Catalogue templates (the datasheet Excel
spreadsheet template).
Select DataSheet to create a form for instrument datasheets. Select Other to create a form
for other types of document that can be generated for instruments, such as calibration
sheets, maintenance documents etc. Front Sheets and Summary Sheets are used when
datasheets are merged into a single documents (refer to Merge Datasheets into a Single
Document).
The Catalogue Information window is then displayed.
The version of the Catalogue Information window displayed above is that displayed if the
selected datasheet definition type was “DataSheet”. If the selected type was Front Sheet or
Summary Sheet, a different version is displayed:
Note: The ... button at the end of the File Name field can be used to locate any existing
spreadsheet file and to copy the selected file to the project datasheet template folder.
Any Excel file can be used, including Excel workbooks with multiple worksheets.
The template folder for the current project is listed on the Project Data window, accessed by
selecting Edit Project on the Project tab.
5. Enter the Excel spreadsheet file name in the File Name field. The file must exist in the
Project Datasheets template directory.
6. Select the file format (.xls or .xlsx).
Note: The ... button at the end of the File Name field may be used to locate any existing
Excel file. The file will then be copied to the template folder for the AVEVA
Instrumentation project and renamed to match the form name entered in this window.
7. Enter the spreadsheet cell dimensions (number of columns and Rows). These are
used to limit AVEVA Instrumentation's view of each template to those dimensions. This
restricts viewing to the number of columns and rows entered here.
8. From the Principle of Operation list, select the operating principle which best
describes the type of instrument(s) to be specified on this datasheet. The operating
principle is used to automatically match instruments from the Instrument List with the
form type definition.
This is not relevant to Front Sheet and Summary Sheet definitions and therefore the
field in question is not displayed.
If the Other form type was selected, the field default to the “Other” principle of
operation. A different principle of operation can be selected if required (this will not
change the form type).
9. Click Save to save the definition information or Cancel to exit without saving.
Note: The spreadsheets used for form definitions may include checkboxes. However,
checkboxes will not be displayed in the AVEVA Instrumentation, i.e. in the Datasheet
Design window or the Datasheet viewer window. Checkboxes therefore must be
replaced with a picklist with values of True and False only. Refer to Checkboxes on
Datasheets for details.
The window lists the existing Catalogue Datasheet form definition in the project.
To copy an existing form definition, double-click on the form record in the window above, or
select it and click Copy.
If required form definitions may be copied from a different project. Click Select a Project.
The Select an AVEVA Instrumentation Project window is then displayed. Select the
required project from the list of projects listed in this window. The Copy an Existing
Datasheet form definition window then displays the form definition in that project. Select
the required form definition as described above.
Note: AVEVA Instrumentation also provides facilities to import multiple form types from
another AVEVA Instrumentation project. Refer to Import Catalogue From Other
Project for details.
After selecting the form type, the window is closed and the Catalogue Information window
is displayed again. When that window is saved, the existing form definition is copied,
including the Excel file and field to cell mappings (DataLinks).
The window shows the datasheet form layout as previously created using Microsoft Excel.
There are two main areas on this window:
Datasheet Layout
The left-hand area contains the spreadsheet layout and shows each cell as previously
defined in Microsoft Excel. The layout cannot be changed [Link] must be done using
Microsoft Excel. The grey coloured cells indicate which cells have been mapped (or linked)
to a database field.
Note: To see which DataLink (field) is mapped to a particular cell click in the cell and the list
view will highlight the [Link] the DataLinks List View (see below). The feature
works only when the Used checkbox is checked in the DataLinks List View.
Note: Fields for both process equipment and process lines are stored in this table. Ensure
that when selecting a field it is relevant to the type of item (equipment or line) in
question.
Note: The maximum number of plant connection DataLinks of each type is specified when
a form is defined.
Note: Data should be mapped to Instrument List, Process Data and Datasheet/Revs List
first. Once these common fields are mapped, then map any remaining cells to the
Generic fields in the DSHData table. DSHData is used a generic database location
for all datasheet information that lies outside Process Data and Instrument List data.
These fields can have their captions renamed for each specific datasheet form type
so that users can identify their contents when importing data for viewing multiple tag
data using the Browse Data by Form Type list (see View Data by Form Type).
Note: New properties and the fields to be used to represent them can be user-defined for
equipment. Refer to Add New Property Definition. See also the New Properties
button (described below).
Note: The Print button in this window prints the datasheet form with Datalink mappings.
When this window is first displayed, the DataLinks List view shows used DataLinks only.
Note: Sort the lists by clicking on the column header (e.g. In figure above: “Table” sorts by
Table name, “Field” sorts by field name, “Tag” sorts by tag name etc.).
Whether used or unused DataLinks are displayed is controlled by the Used checkbox. To
view only unused DataLinks, uncheck the Used checkbox. To display both used and
unused DataLinks, clear the Used/Unused filter by clicking on the “clear filter criteria” button
next to the Used checkbox.
Note: If the DataLink is for the first (Tag1) of a multiple tag datasheet then the dragging and
dropping of a Tag1 field will auto-assign all other DataLinks of the same field name if
both Tag1 TagNo and Tag2 TagNo fields are already mapped.
For example, if the user drags ElecVolts for Tag1, if the Automatic Copy for
multiple Tags checkbox (at top of window - only displayed for form definitions with
multiple tags) is checked, then Engineer will attempt to assign DataLinks for
ElecVolts to Tags 2, 3 and 4 also, using the row/column offset between Tag1 and
Tag2 to offset the other fields. The feature makes assigning mappings for multi tag
datasheets far more efficient.
Note: It is recommended that the DataLink list view is sorted by Field to more easily identify
the fields being mapped.
Note: If a picklist is assigned to a field in the Grid Manager (see the Common Functionality
User Guide for details), the picklist will not automatically be available for that field
when mapped to a cell in a datasheet. The pick-list must still be assigned to the cell
using the facilities described below (see Assign a PickList to a Cell).
Note: Multiple cells or ranges can be selected and multiple Datalinks deleted from using
this option (hold the Ctrl key down to select multiple cells).
Command Buttons
Print Opens the datasheet excel file in a print preview window with all the
mapped field names populated in their respective cells.
Zoom Zooms the Datasheet Layout area according to the value selected
Close Closes the window and confirms to save any changes made.
Automatic Only displayed for form definitions with multiple tags. Used to map
Copy for multiple datalinks of the same sort to multiple tags in a form definition
multiple Tags See Map a DataLink to a Cell for details.
Once saved, the new or modified Catalogue Form is ready to be used on the project. It is
recommended that the mappings be tested thoroughly prior to use on a project.
Note: Users should not modify these cell/field mappings for a datasheet type at the same
time other users are accessing datasheets of the same Catalogue type.
Select the Add Picklist option, then select the PickList name from the sub-menu.
To define new PickLists select Add Picklist > Add New PickList and in the resulting text
box enter the name of new picklist to be added, then press enter (to define new items or
modify existing items in a PickList refer to Using PickLists).
To delete an existing picklist select Delete Picklist from the pop up menu.
To edit the values in an existing picklist select the Edit Pick List Values from the menu. The
PickList edit window will be displayed, enabling additional values to be added, edited or
changed in the selected PickList.
For example:
Click on the datasheet headings from which the attributes of the new properties are to be
based. As each heading is clicked on, default details derived from the heading text are listed
in the window. For example:
The default object type is InstrumentData. If required, change this to Process Data by
selecting ProcessData from the list of values available in the Object Type fields.
The rest of the default details can either be edited as described below, or in the Property
Definition window accessed by clicking on the button in the Edit field. Refer to Add New
Property Definition for details.
The default data type is Text. Specify a different data type in the Datatype field if required.
To auto-map a new properties to the datasheet cell to the right of the heading from which it
was derived, check the AutoMap checkbox. Check the AutoMap All checkbox to check all
the AutoMap checkboxes.
To remove a property from the window, select it and then click Delete.
window. Select the project from which the Catalogue Datasheets are to be imported are
defined.
After selecting the project, the Catalogue Import window is displayed, which lists catalogue
forms within the selected project:
Note: To minimise the possibility that data currently being worked on by another user may
be affected by an import, a list of the users working on the current project is available
from the UserCount link. The number of current users is displayed next to the link.
This total includes the user performing the import.
Select the Catalogue Datasheet(s) to be imported and click Import. A progress window is
displayed.
If a catalogue datasheet or template with the same name as one being imported already
exists in the project database, a warning message is displayed. The user may choose to
overwrite the existing datasheet or template.
A warning message is also displayed if a datasheet exists in the current database has been
based on a catalogue datasheet with the same name as one being imported. Such
catalogue datasheets will not be imported.
AVEVA Instrumentation will then copy the selected catalogue forms from the selected
project to the current project, including their DataLinks (Database field/cell mappings).
If the definition has been used to define a datasheet it cannot be delete and the following
message is displayed:
If the definition has not been used to define a datasheet, the Delete 1 datasheet window is
displayed:
If the definition is to be deleted from the list in the Datasheet Form Catalogue grid, but its
Excel file is not to be deleted, click Delete from List Only.
If the Excel file of the definition is to be deleted, but the definition is not to be deleted from
the list, click Delete Datasheet File Only.
If the definition is to be delete from the list, and its Excel file is to be delete as well, click
Delete from List And Datasheet File.
After the required option has been selected, click Delete to proceed with the deletion. Click
Cancel to cancel the deletion.
11 Instrument Catalogue
Many instruments created for a project will have very similar attributes. For example, there
may be dozens of control valves with very little difference between them except for their tag
numbers.
To reduce the amount of repetitive data entry that specifying these items this would
otherwise entail, a catalogue of user-defined instrument definitions can be set up. When an
instrument is being created, selected data from a catalogue definition can be copied to the
new instrument. This definition can be copied to all the instruments with similar attributes,
e.g. similar control valves.
Refer to Manually Add a Tag to the Instrument List the procedure for copying data from a
catalogue instrument.
Continue at:
• Instrument Catalogue Grid
• Add a New Catalogue Instrument
• Edit a Catalogue Instrument
• Import Catalogue Instruments from another Project
• Import Instrument Catalogue Data from Excel
Refer to Working with the Data Grid for information on the grid controls including selecting
an instrument record, and sorting and filtering the grid data.
Note: Any value manually added directly into a grid picklist is not added to the picklist's
value list until the Refresh toolbar command is used or the grid is re-loaded (e.g.
Instrument Engineer is re-started).
Columns with a yellow coloured background, i.e. Name and DataSheetNo cannot be edited
directly in the grid. Datasheet No column fields includes a button for use in assigning,
viewing and editing datasheets for catalogue instruments. Refer to View/Edit Instrument
Datasheets.
Enter a project unique name for the catalogue instrument in the Name field.
Complete the rest of the fields with the data that is to be available for copying to project
instruments creating using this catalogue instrument.
For guidance on completing these fields, refer to Manually Add a Tag to the Instrument List.
Click Save to create the new catalogue instrument. The new catalogue instrument will then
be added to the list of catalogue instruments in the grid.
Note: Double-clicking the record in the grid view also displays the Edit window.
Amend the details as required. For guidance on changing the data in the fields, refer to
Manually Add a Tag to the Instrument List.
Click OK to save the changes.
After selecting the project, the Instrument Catalogue Import window is displayed,
containing a list of all catalogue instruments within that project:
Note: To minimise the possibility that data currently being worked on by another user may
be affected by an import, a list of the users working on the current project is available
from the UserCount link. The number of current users is displayed next to the link.
This total includes the user performing the import.
Click the Select checkbox for those catalogue instruments that are to be imported. Click
Select All if all are to be imported.
Click Next >.
All the selected catalogue instruments are then validated. If any of the catalogue
instruments are found to be invalid, they are listed in the next window, for example:
Once the import is complete, an import log listing the catalogue instruments that have been
successfully imported is displayed:
12 Exports
This section describes the export options available on the Manage and List Tools tabs.
Continue at:
• Export to Excel
• Export to XPS and PDF Files
• Export Selected Datasheet Files
• Export to AVEVA NET
Use the window to select the folder to which the datasheets are to exported and click OK.
The export of the selected datasheets then takes place. A message is displayed when the
export is completed, for example:
In the Root Folder field, enter the root folder under which the sub-folders that contain the
exported files are to be located. Click the … button to browse for the required folder.
If no sub-folders are specified, as described below, all the files will be exported into this
folder.
To specify the sub-folder structure, select the drawing attributes that will define the names of
the sub-folders and from the Sub Folder list.
To select an attribute, check the appropriate checkbox. The selected attribute is then
displayed in curly brackets in the field below the list.
As required, enter delimiter characters or text between the selected attributes in this field.
To specify the file name format of exported drawings, follow the same procedure as for sub-
folders, but using the File Name list and field.
Example:
00 ABC123 1 A
01 XYZ890 1 B
This will result in the creation of folder structure and files as follows:
C:\AI Datasheets (root folder)
Project1-Area00 (sub-folder)
[Link] (exported datasheet file)
Project1-Area01 (sub-folder)
[Link] (exported datasheet file)
Exporting Datasheets
Select the datasheets in the Datasheets Grid.
On the List Tools - Datasheets tab, click Selected Datasheets in the Export section, then
Copy to User Defined Names from the menu that is then displayed.
If changes made since the last issue are to be highlighted, click Copy to User Defined
Names with Previous Issue's Changes highlighted instead.
The export of the selected datasheets then takes place. A message is displayed when the
export is completed, for example:
Instrumentation data of various types and from different sources can be exported to AVEVA
NET, for example instrument data or data from reports. From the Name field, select the type
of data export to AVEVA NET to be configured.
If a log file is to be generated for the export type, check the Log Enabled checkbox.
The Log File field will then become enabled. In the field, specify the file name and the
location of the log file (a .txt file). Click the adjacent button to browse for the required folder.
In the Staging Area field, specify the top level folder into which files are to be exported.
Click the adjacent button to browse for the required folder.
If the Create Trigger File checkbox is checked, a [Link] file (an empty text file) is
created in the staging area folder for each file type. The purpose of the [Link] file is to
trigger the AVEVA NET Portal’s import controller to automatically process all the files that
reside in the same folder.
If, for every object being exported, a separate output file is to be generated, check the
Output File Per Object checkbox.
To select mapping files for the export of data and specify other settings, click Settings. The
Non-CAD Mapping Configuration window is then displayed.
The mappings between Instrumentation data and AVEVA NET Portal format data are stored
in XML files, one for each of the types of mapping:
• Object Mapping
• Class Mapping
For details of these files, refer to AVEVA NET Export Configuration Files.
Click the appropriate … button to browse for the required mapping file.
Click the open file button to open the selected file. It will open in the default text editor,
for example Notepad.
If no file is specified in the field, a new, blank .txt file is opened. If a file is specified that does
not exist, the user will be asked if they wish to create that file at the specified location. If Yes
is clicked, a new blank .txt file is created and opened for editing.
To populate the fields with the default mapping files supplied with AVEVA Instrumentation,
click Copy Sample Files.
Once the export is completed, the Export Report window is displayed, listing the items for
which a data export was requested and whether or not that export was successful or not.
13 Work Packs
Work packs can be created which consist of collections of items with shared project
management requirements or properties. For example, all the items an individual user or
group of users is concerned with may be assigned to a single work pack. Time constraints
may be assigned to work packs, for example the required start and completion dates of
items in the a work pack, so that work can be more easily prioritised.
For a description of this functionality, refer to the Common Functionality User Guide.
14 Change Reports
15 Reports
AVEVA Instrumentation provides facilities for creating and modifying reports. These are
available with the Reports grid.
For a description of these features, refer to the Common Functionality User Guide.
In addition, the following Engineer-specific “fixed” (non-editable) reports are accessible from
the Reports grid:
I/O List Opens a grid view showing which tags are assigned to which I/O
modules/channels.
Instrument Count Opens a grid view showing the number of each instrument per
project status/description.
Tags Assigned to Opens a grid view listing the tags assigned to a loop.
Loop
DCS New Opens a grid view listing new tags assigned to the DCS /IO
system.
DCS New with Opens a grid view listing new tags with signal types assigned to
Signal Type the DCS I/O system.
DCS Remove Opens a grid view listing tags removed from the DCS I/O
system.
PLC/ESD New Opens a grid view listing new tags assigned to the PLC/ESD I/O
system.
PLC/ESD New with Opens a grid view listing new tags with signal types assigned to
Signal Type the PLC/ESD I/O system.
PLC/ESD Remove Opens a grid view listing tags removed from the PLC/ESD I/O
system.
Tags Not Assigned Opens a grid view listing tags not assigned to a datasheet.
to Datasheets
Instrument Index Opens a grid view displaying the instrument index, including
with Process process connection details.
Connections
For a description of these calculations, refer to the Common Functionality User Guide.
The following configuration files will be used by the AVEVA Schematic Gateway to process
the input:
• Project Configuration
• Object Mapping
• Class Mapping
For a description of these files, refer to the Common Functionality User Guide.
Index
Data
Import . . . . . . . . . . . . . . . . . . . . . . 10:28 F
Data Grid Find and Replace
working with . . . . . . . . . . . . . . . . . . . 2:5 Text in a Grid . . . . . . . . . . . . . . . . . . 2:5
Datasheets . . . . . . . . . . . . . . . . . . . . . . 10:1
data entry . . . . . . . . . . . . . . . . . . . . 10:2
view and edit . . . . . . . . . . . . . . . . . 10:1
G
Datasheets Lists . . . . . . . . . . . . . . . . . 10:10 Grid Filters
access . . . . . . . . . . . . . . . . . . . . . 10:10 advanced . . . . . . . . . . . . . . . . . . . . . 2:5
add . . . . . . . . . . . . . . . . . . . . . . . . 10:13 Grid Manager . . . . . . . . . . . . . . . . . . . . . 2:5
assign tag . . . . . . . . . . . . . . . . . . . 10:18
datasheet form catalogue . . . . . . . 10:47
I
datasheet information . . . . . . . . . . 10:15
import datasheets from Excel . . . . 10:28 Instrument Catalogue . . . . . . . . . . . . . . 11:1
process data . . . . . . . . . . . . . . . . . . . 6:1 Add a New Catalogue . . . . . . . . . . 11:2
grid . . . . . . . . . . . . . . . . . . . . . . . 6:1 Edit a Catalogue . . . . . . . . . . . . . . 11:3
property definitions . . . . . . . . . . . . . . 3:7 Grid . . . . . . . . . . . . . . . . . . . . . . . . 11:1
Defining Instrument Copy Wizard . . . . . . . . . . . . 5:51
V
View datasheets by form type . . . . . . . . 5:70
W
Wiring Rules
Applying . . . . . . . . . . . . . . . . . . . . . . 9:1
overview . . . . . . . . . . . . . . . . . . . . . . 9:1
Running . . . . . . . . . . . . . . . . . . . . . . 9:1
Work Pack . . . . . . . . . . . . . . . . . . . . . . . 13:1