SPI User Guide PDF

SmartPlant Instrumentation
User’s Guide
Version 2007.3 (8.0) September 2007 DINS-08.00.0001D

Copyright
Copyright © 1995-2007 Intergraph Corporation. All Rights Reserved.
Including software, file formats, and audiovisual displays; may be used pursuant to applicable software license
agreement; contains confidential and proprietary information of Intergraph and/or third parties which is protected by
copyright law, trade secret law, and international treaty, and may not be provided or otherwise made available
without proper authorization.
Restricted Rights Legend

Use, duplication, or disclosure by the government is subject to restrictions as set forth below. For civilian agencies:
This was developed at private expense and is “restricted computer software” submitted with restricted rights in
accordance with subparagraphs (a) through (d) of the Commercial Computer Software - Restricted Rights clause at
52.227-19 of the Federal Acquisition Regulations (“FAR”) and its successors, and is unpublished and all rights are
reserved under the copyright laws of the United States. For units of the Department of Defense (“DoD”): This is
“commercial computer software” as defined at DFARS 252.227-7014 and the rights of the Government are as
specified at DFARS 227.7202-3.
Unpublished – rights reserved under the copyright laws of the United States.
Intergraph Corporation
Huntsville, Alabama 35894-0001
Warranties and Liabilities

All warranties given by Intergraph Corporation about equipment or software are set forth in your purchase contract,
and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification or
amendment of such warranties. Intergraph believes the information in this publication is accurate as of its
publication date.
The information and the software discussed in this document are subject to change without notice and are subject to
applicable technical product descriptions. Intergraph Corporation is not responsible for any error that may appear in
this document.
The software discussed in this document is furnished under a license and may be used or copied only in accordance
with the terms of this license.
No responsibility is assumed by Intergraph for the use or reliability of software on equipment that is not supplied by
Intergraph or its affiliated companies. THE USER OF THE SOFTWARE IS EXPECTED TO MAKE THE FINAL
EVALUATION AS TO THE USEFULNESS OF THE SOFTWARE IN HIS OWN ENVIRONMENT.
Intergraph is not responsible for the accuracy of delivered data including, but not limited to, catalog, reference and
symbol data. Users should verify for themselves that the data is accurate and suitable for their project work.
Trademarks
Intergraph, the Intergraph logo, PDS, SmartPlant, SmartSketch, FrameWorks, INtools, MARIAN, ISOGEN, and
IntelliShip are registered trademarks and SupportModeler and SupportManager are trademarks of Intergraph
Corporation. Microsoft and Windows are registered trademarks of Microsoft Corporation. MicroStation is a
registered trademark of Bentley Systems, Inc. Other brands and product names are trademarks of their respective
owners.
Table of Contents
Table of Contents
Preface...............................................................................................................................42
Working with SmartPlant Instrumentation: An Overview .........................................43

User Assistance................................................................................................................. 44
Online Help Text Conventions ...................................................................................46
Getting Started Common Tasks..................................................................................48
Start SmartPlant Instrumentation ...................................................................................... 49
Navigating in SmartPlant Instrumentation........................................................................ 49
Open a Different Domain.................................................................................................. 50
Change the Logon Password............................................................................................. 51
Switch to a Different Unit................................................................................................. 51
Open a Module.................................................................................................................. 52
Setting General Preferences Common Tasks .............................................................53
Display and Customize Preferences.................................................................................. 53
Preferences Governed by the .INI File.............................................................................. 54
Searching for Tag and Loop Numbers: An Overview..................................................56

Searching for Tag and Loop Numbers Common Tasks .............................................57
Search for All Tag Numbers ............................................................................................. 58
Use Search Parameters to Find Tag Numbers .................................................................. 59
Search for Typical Tags .................................................................................................... 61
Search for All Loop Numbers........................................................................................... 62
Use Search Parameters to Find Loop Numbers ................................................................ 62
Search for Typical Loops.................................................................................................. 64
Supporting Tables: An Overview ...................................................................................65

Supporting Tables Common Tasks.............................................................................66
Supporting Tables in SmartPlant Instrumentation ............................................................ 67
Supporting Tables for Telecom ........................................................................................ 74
Add a New Value to a Select List ..................................................................................... 75
Customize Manufacturer-Specific Field Headers ............................................................. 76
Manage a Custom Table ................................................................................................... 76
Interface Languages: An Overview................................................................................77

Interface Languages Common Tasks..........................................................................78
Replace the Interface Language with a Language from the Database .............................. 79
Replace the Interface Language with a Language from an External File ......................... 79
Create a Language File with Customized Interface Text.................................................. 80
Edit Interface Text Phrases ............................................................................................... 81
Prefixes and Suffixes in the Interface Text....................................................................... 83
Revision Management: An Overview.............................................................................84
SmartPlant Instrumentation User’s Guide 3

Table of Contents
Global Revisions: An Overview......................................................................................85

Revision Management Common Tasks ......................................................................86
Filter Items for Global Revisions...................................................................................... 87
Add Global Revisions ....................................................................................................... 88
Define Settings for Upgrading Revisions ......................................................................... 90
Update Revisions Globally ............................................................................................... 91
Upgrade Revisions Globally ............................................................................................. 92
Revision Upgrade Example .............................................................................................. 93
Delete Global Revisions ................................................................................................... 94
Add Local Revisions......................................................................................................... 95
Edit Local Revisions ......................................................................................................... 96
Delete Local Revisions ..................................................................................................... 96
View an Archived Revision .............................................................................................. 97
Report Comparison: An Overview.................................................................................98

Setting Font and Color for Report Comparison..........................................................99
Set Font And Color for Report Comparison ..................................................................... 99
Comparing Archived Reports ...................................................................................100
Compare the Currently Previewed Report With an Archived Report............................. 100
Comparing the Current Report with an Archived Report.........................................101
Compare the Currently Previewed Report With an Archived Report............................. 101
Viewing Archived Reports .......................................................................................102
View an Archived Report ............................................................................................... 102
Displaying Changed Documents ..............................................................................103
Display a List of Changed Documents ........................................................................... 103
Workflow: An Overview ...............................................................................................104

Workflow Prerequisites ............................................................................................105
Create a Workflow Browser ........................................................................................... 106
Implementing Workflow ..........................................................................................107
Enter Initial Instrument Data .......................................................................................... 107
Enter Process Data for Instrument Tags ......................................................................... 107
Enter Additional Instrument Data ................................................................................... 108
Process Data Statuses ...............................................................................................109
Printing and Saving Documents: An Overview ..........................................................110

Previewing Documents.............................................................................................111
Preview a Document ....................................................................................................... 112
Printing Documents ..................................................................................................113
Print Documents ............................................................................................................. 113
Batch Printing Documents to PDF Files...................................................................114
Setting Ghostscript Batch Print Options...................................................................115
Set the Ghostscript Batch Print Options ......................................................................... 115
Setting Acrobat Distiller Batch Print Options ..........................................................116
Set the Acrobat Distiller Batch Print Options................................................................. 116
Modifying Printer Settings .......................................................................................117
Saving Documents ....................................................................................................118
4 SmartPlant Instrumentation User’s Guide

Table of Contents
Save the Current Document to a File .............................................................................. 118

Saving in DXF Format..............................................................................................119
Save a Document in DXF Format................................................................................... 119
Editing Document Headers.......................................................................................120
Edit the Headers for a Report.......................................................................................... 120
Customizing Title Blocks for Reports: An Overview .................................................121

Requirements for Customized Report Title Blocks..................................................122
Edit Report Title Block Properties.................................................................................. 126
PSR Files .........................................................................................................................127

Viewing PSR Files....................................................................................................128
Retrieving PSR Files.................................................................................................129
Retrieve a Previously Saved PSR File ............................................................................ 129
Saving PSR File Data ...............................................................................................130
Opening PSR Files from the PSR List......................................................................131
Open a PSR File From the PSR List ............................................................................... 131
Managing the PSR File List......................................................................................132
Manage .psr Files ............................................................................................................ 132
Retrieving PBL File Reports ....................................................................................133
Retrieve a Report From a PBL File ................................................................................ 133
Adding User-Defined Fields to PSR Files................................................................134
Add User-Defined Fields to a PSR File (Using InfoMaker)........................................... 134
Viewing PSR User-Defined Fields...........................................................................136
View PSR User-Defined Fields in a Report Header ....................................................... 136
Displaying and Customizing Preferences ....................................................................137

View Or Customize SmartPlant Instrumentation Preferences ........................................ 137
Preferences Governed by the .INI File............................................................................ 137
Preferences Dialog Box .................................................................................................. 139
General (Preferences)...................................................................................................... 140
Copy File Locations Dialog Box .................................................................................... 143
Instrument Index > New Tag (Preferences).................................................................... 143
Instrument Index > New Loop (Preferences).................................................................. 144
Instrument Index > Profile (Preferences)........................................................................ 145
Instrument Index > Browse (Preferences) ...................................................................... 145
Instrument Index > Duplicate (Preferences) ................................................................... 146
Instrument Index > Delete Tag (Preferences) ................................................................. 147
Instrument Index > Rename (Preferences)...................................................................... 148
Instrument Index > Tag Properties (Preferences) ........................................................... 148
Instrument Index > Move (Preferences) ......................................................................... 149
Instrument Index > Custom (Preferences) ...................................................................... 149
Specifications > General (Preferences)........................................................................... 150
Specifications > Save as Excel (Preferences) ................................................................. 154
Specifications > Export/Import (Preferences)................................................................. 155
Specifications > Custom (Preferences) ........................................................................... 155
Wiring > General (Preferences) ...................................................................................... 156
Wiring > I/O Card (Preferences)..................................................................................... 156

Table of Contents
Wiring > I/O Assignment (Preferences) ......................................................................... 156

Wiring > CS Tags (Preferences) ..................................................................................... 157
Wiring > Copy Items (Preferences) ................................................................................ 158
Wiring > Jumpers (Preferences) ..................................................................................... 160
Wiring > Reports (Preferences) ...................................................................................... 161
Wiring > Cross Wiring (Preferences) ............................................................................. 162
Wiring > Custom (Preferences) ...................................................................................... 162
Process Data > General (Preferences)............................................................................. 163
Process Data > Custom (Preferences)............................................................................. 164
Calculation > General (Preferences) ............................................................................... 164
Calibration and Maintenance > Custom (Preferences) ................................................... 165
Loop Drawings > General (Preferences) ........................................................................ 165
Loop Drawings > CAD File Locations (Preferences)..................................................... 168
Loop Drawings > Custom (Preferences)......................................................................... 169
Browser > Reports (Preferences) .................................................................................... 170
Browser > Fonts (Preferences)........................................................................................ 170
Browser > Custom (Preferences) .................................................................................... 171
Hook-Ups > General (Preferences)................................................................................. 171
Hook-Ups > CAD File Locations (Preferences) ............................................................. 173
Hook-Ups > Reports (Preferences)................................................................................. 175
Hook-Ups > Custom (Preferences)................................................................................. 176
Document Binder > General (Preferences)..................................................................... 176
Document Binder > Specification Binder (Preferences)................................................. 177
Document Binder > General Document Binder (Preferences) ....................................... 178
Document Binder > Custom (Preferences) ..................................................................... 178
Calibration and Maintenance > General (Preferences) ................................................... 178
Calculation > Custom (Preferences) ............................................................................... 180
Enhanced Reports > General (Preferences) .................................................................... 180
Enhanced Reports > Layers (Preferences) ...................................................................... 182
Enhanced SmartLoop > View (Preferences)................................................................... 183
Panel-Strip > View (Preferences) ................................................................................... 185
Wiring Equipment Connections > View (Preferences)................................................... 186
Segment Wiring > View (Preferences) ........................................................................... 188
Communication Line > View (Preferences) ................................................................... 189
Internal Cross Wiring > View (Preferences)................................................................... 191
Fieldbus Loop > View (Preferences) .............................................................................. 192
Network Class > View (Preferences).............................................................................. 193
Strip Signals > View (Preferences)................................................................................. 195
Single Speaker > View (Preferences) ............................................................................. 196
Enhanced PA Amplifier > View (Preferences)............................................................... 197
Cable Block Diagram > View (Preferences)................................................................... 198
Enhanced Reports > Hook-Ups > View (Preferences) ................................................... 199
Symbol Editor > View (Preferences) .............................................................................. 199
Enhanced Reports > Custom (Preferences) .................................................................... 199
Enhanced Reports > Drawing (Preferences)................................................................... 200
Enhanced Reports > File Locations (Preferences).......................................................... 201
Enhanced Reports > File Locations (continued) (Preferences)....................................... 203
Enhanced Reports > Fonts (Preferences) ........................................................................ 203
Enhanced Reports > Title Block (Preferences)............................................................... 204
Enhanced Reports > Connectors (Preferences)............................................................... 206
Enhanced Reports > Pagination and Revisions (Preferences) ........................................ 207

Table of Contents
Interfaces > DCS Vendors (Preferences) ........................................................................ 207

SmartPlant Integration > General (Preferences) ............................................................. 208
SmartPlant Integration > To Do List (Preferences) ........................................................ 209
Claim and Merge Options (Preferences)......................................................................... 210
Report Generator (Preferences) ...................................................................................... 213
SmartPlant Instrumentation Server (Preferences)........................................................... 214
Module Icons (Preferences) ............................................................................................ 214
Claiming As-Built Items in a Project: An Overview ..................................................216
Preparing Project Items for Merging with As-Built: An Overview..........................218

Claiming and Merging Items Common Tasks..........................................................220
Display As-Built and Project Data.................................................................................. 221
Copy As-Built Items to the Claim Buffer ....................................................................... 223
Claim As-Built Items from the Domain Explorer........................................................... 224
Claim Instruments in the Browser or Instrument Index Module .................................... 225
Claim Loops, Lines, and Equipment in the Browser Module......................................... 226
Copy Items to the Merge Buffer as Merge Now............................................................. 227
Copy Items to the Merge Buffer as Release Claim......................................................... 228
Working with the SmartPlant Instrumentation Explorer: An Overview ................229
Working with the Domain Explorer: An Overview....................................................230

Domain Explorer Common Tasks ............................................................................232
The Organization of Items in the Domain Explorer Tree View...................................... 236
Panels by Category Hierarchy Examples........................................................................ 239
Panels by Location Hierarchy Example.......................................................................... 241
Cable Hierarchy Example ............................................................................................... 241
Fieldbus Segments in the Domain Explorer ................................................................... 242
Items in the Drawing Block Types Folder ...................................................................... 242
Items in the Electrical Equipment Folder ....................................................................... 244
Items in the Hook-Ups Folder......................................................................................... 244
Items in the Loops Folder ............................................................................................... 246
Association Rules in the Domain Explorer ..............................................................249
Item Status Indicators in the Domain Explorer............................................................... 253
Create an Item in the Domain Explorer .......................................................................... 254
Duplicate an Item............................................................................................................ 254
Move an Item in the Domain Explorer ........................................................................... 255
Edit Item Properties ........................................................................................................ 255
Delete Items .................................................................................................................... 255
Perform Various Actions with an Instrument ................................................................. 256
Generate a Report for an Instrument............................................................................... 256
Generate a Specification or a Process Data Sheet for an Instrument .............................. 256
Copy a Reference Item to the Domain Explorer............................................................. 257
Search for Items in SmartPlant Instrumentation Explorer .............................................. 257
Find an Item in the Tree View of an Explorer Window ................................................. 259
Filter the Display of Items According to a Specific Item Name..................................... 260
Filter the Display of Items According to a Specific Item Type ...................................... 261

Table of Contents
Filter Cables in an Explorer Window ............................................................................. 263

Define a Filter for Pre-Assigned Device Cables ............................................................. 264
Filter Loops in an Explorer Window .............................................................................. 265
Display a Browser View in the Explorer Items Pane...................................................... 267
Add Items to My List in the Items Pane ......................................................................... 267
Define and Use a Custom View...................................................................................... 268
Working with the Reference Explorer: An Overview ................................................269

Reference Explorer Common Tasks.........................................................................270
The Organization of Items in the Reference Explorer Tree View .................................. 274
Items in the Hook-Up Item Libraries Folder .................................................................. 275
Create a Reference Item.................................................................................................. 277
Create a Reference I/O Card ........................................................................................... 277
Create a Reference Wiring Equipment Item ................................................................... 280
Create a Reference I/O Termination ............................................................................... 282
Copy a Reference Item to the Domain Explorer............................................................. 284
Browser Module Overview............................................................................................285
Browser Manager Overview .........................................................................................286

Browser Manager Common Tasks ...........................................................................287
Select a Default Browser ................................................................................................ 288
Define a View Profile ..................................................................................................... 289
Add a New View............................................................................................................. 290
Duplicate a View ............................................................................................................ 291
Copy a View to Another Plant ........................................................................................ 292
Modify a View Profile .................................................................................................... 292
Delete a View.................................................................................................................. 294
Find a Browser or Browser View ................................................................................... 295
Browser Manager Hierarchy........................................................................................... 296
Browser Types ................................................................................................................ 297
Instrument Index Browser Group ................................................................................... 297
Process Data and Calculation Browser Group................................................................ 299
Instrument Specifications Browser Group...................................................................... 300
Wiring Browser Group ................................................................................................... 301
Hook-Ups Browser Group .............................................................................................. 302
Loop Drawings Browser Group...................................................................................... 302
Control System Browser Group...................................................................................... 303
Dimensional Data Browser Group.................................................................................. 304
Construction and Commissioning Browser Group ......................................................... 304
Document Binder Browser Group .................................................................................. 305
Documents Browser Group............................................................................................. 306
General Browser Group .................................................................................................. 306
Telecom Browser Group................................................................................................. 307

Table of Contents
Style Settings: An Overview..........................................................................................308

Style Settings Common Tasks ..................................................................................309
Display the Current Style Setting ................................................................................... 310
Create a View Style ........................................................................................................ 311
Clear a View Setting ....................................................................................................... 313
Modify Style Settings ..................................................................................................... 314
Structure the Print Layout............................................................................................... 316
Clear a Print Layout Structure ........................................................................................ 318
Duplicate a View Style ................................................................................................... 319
Print the Style Setting Data............................................................................................. 320
Sort Settings: An Overview...........................................................................................321

Sort Settings Common Tasks....................................................................................322
Display the Current Sorting Sequence ............................................................................ 323
Create a Sorting Sequence View..................................................................................... 323
Modify a Sorting Sequence View ................................................................................... 325
Duplicate a Sorting Sequence View ............................................................................... 326
Clear a Sorting Sequence Setting.................................................................................... 327
View Filter Settings: An Overview...............................................................................328

View Filter Settings Common Tasks........................................................................330
Display the Current View Filter Condition..................................................................... 331
Define a View Filter........................................................................................................ 331
Modify a View Filter ...................................................................................................... 333
Duplicate a View Filter................................................................................................... 334
Clear View Filter Settings............................................................................................... 335
Adding New Browsers: An Overview ..........................................................................336

Adding New Browsers Common Tasks ...................................................................337
Create a New Browser for SmartPlant Instrumentation.................................................. 338
Add a Form Browser....................................................................................................... 340
Add a Powersoft Browser ............................................................................................... 340
Browser Views: An Overview .......................................................................................342

Browser Views Common Tasks ...............................................................................343
Open a Browser View..................................................................................................... 345
Edit Data in a Browser View .......................................................................................... 346
Modify and Save a Field Layout..................................................................................... 346
Modify Document Numbers in a Document Browser View........................................... 347
Browser View Buffer...................................................................................................... 348
Clear Data from the Buffer ............................................................................................. 349
Sort Displayed Rows....................................................................................................... 349
Count Displayed Rows ................................................................................................... 349
Refresh Displayed Data .................................................................................................. 350
Find a Value in a Specific Column ................................................................................. 351
Select Non-Editable Field Indication Color.................................................................... 352
Open a Module from a Browser View ............................................................................ 352

Table of Contents
Instrument Index Module: An Overview ....................................................................353
Managing Loop Numbers: An Overview.....................................................................354

Managing Loop Numbers Common Tasks...............................................................355
Create a New Individual Loop Number.......................................................................... 357
Loop Number Naming Convention ................................................................................ 358
Duplicate a Loop Number............................................................................................... 359
Move Loop Numbers ...................................................................................................... 361
Edit Loop Number Properties from the Domain Explorer.............................................. 362
Edit Loop Properties from the Instrument Index Module............................................... 364
Edit Multiple Loop Numbers .......................................................................................... 366
Create a New Loop Number During Tag Edit ................................................................ 367
Customize New Loop Numbers...................................................................................... 368
Delete Loop Numbers ..................................................................................................... 369
Rename A Single Loop Number..................................................................................... 370
Set Preference for Renaming A CAD File from A Loop Number.................................. 371
Rename Multiple Loop Numbers.................................................................................... 372
Define a Functional Requirement for a Loop ................................................................. 373
Working with Instrument Types: An Overview .........................................................374

Instrument Types Common Tasks ............................................................................375
Define an Instrument Type Profile ................................................................................. 377
Define a General Process Function................................................................................. 378
Define Instrument Type Default Settings ....................................................................... 378
Define a Wiring and Controls System Instrument Type Profile ..................................... 378
Copy Instrument Type Profile Data ................................................................................ 380
Set an Alias Control System Tag .................................................................................... 380
Apply all Existing Profiles.............................................................................................. 381
Managing Instrument Tags: An Overview..................................................................382

Working with Tag Numbers Common Tasks...........................................................383
Create an Instrument in the Domain Explorer ................................................................ 385
Create an Instrument Tag in the Instrument Index Module ............................................ 387
Instrument Tag Naming Convention .............................................................................. 388
Customize Tag Name...................................................................................................... 389
Enter Power Supply Data for Panels and Instrument Tags ............................................. 390
Edit an Instrument Tag from the Domain Explorer ........................................................ 392
Enter an Instrument Tag Remark .................................................................................... 393
Duplicate an Instrument Tag in the Domain Explorer .................................................... 394
Duplicate an Instrument Tag in the Instrument Index .................................................... 395
Delete Instrument Tags ................................................................................................... 396
Delete Instrument Tags in the Instrument Index Module ............................................... 396
Delete Instrument Tags in the Browse Window ............................................................. 397
Move an Instrument Tag to Another Plant Group .......................................................... 397
Move Multiple Instrument Tags in the Browser Window .............................................. 398
Rename an Instrument Tag ............................................................................................. 398
Instrument Tag Renaming Options ................................................................................. 400
Changing the Measured Variable.................................................................................... 400

Table of Contents
Change an Instrument Type ............................................................................................ 401

Associating Tag Category and Criticality.................................................................402
Add and Edit Criticality Values ...................................................................................... 402
Add and Edit Instrument Tag Categories........................................................................ 403
Associate Tag Category and Criticality .......................................................................... 404
Generate a Process Data Sheet in a Browser Window.................................................... 404
Incorporating Soft Tags Within an Enhanced Reports Loop Drawing.....................405
Flow of Activities for Managing Soft Tags..............................................................406
Associating Instrument Tags with Loop Numbers: An Overview ............................407

Associating Instrument Tags with Loop Numbers Common Tasks .........................408
Associate Multiple Tag Numbers with a Loop ............................................................... 409
Associate an Instrument Tag with a New Loop.............................................................. 410
Change an Instrument Tag Loop Association in the Domain Explorer .......................... 410
Change Instrument Tag Loop Associations in the Instrument Index Standard Browser View
........................................................................................................................................ 411
Working with Typical Loops and Tags: An Overview...............................................412

Typical Loops and Tags Common Tasks .................................................................413
Create a Typical Loop..................................................................................................... 415
Duplicate a Typical Loop................................................................................................ 417
Batch Loop Creation from Typical Loops ...................................................................... 419
Verify New Loop Numbers ............................................................................................ 420
Edit a Typical Loop ........................................................................................................ 421
Delete a Typical Loop..................................................................................................... 422
Edit a Typical Tag........................................................................................................... 422
Edit a Typical Tag in a Browser View............................................................................ 423
Typical Tag Naming Conventions .................................................................................. 424
Managing Lines: An Overview .....................................................................................425

Working with Lines Common Tasks........................................................................426
Create a New Line .......................................................................................................... 427
Edit Line Data ................................................................................................................. 427
Create or Edit a Line Type.............................................................................................. 428
Change Type of Line ...................................................................................................... 429
Copy Line Data ............................................................................................................... 430
Delete a Line ................................................................................................................... 431
Define or Modify Pipe Specifications............................................................................. 431
Edit Data: An Overview ................................................................................................432

Edit and View Data Common Tasks ........................................................................433
Define a Standard Browser View for the Instrument Index............................................ 437
Edit a Single Row ........................................................................................................... 438
Open a Specific Supporting Table .................................................................................. 439
Find a Record in a Browser View Column ..................................................................... 440
Sort Tag Rows in a Browser View ................................................................................. 441
Edit Instrument Tag Data in Multi-Row Mode............................................................... 442
Count Instrument Tag Rows in a Browser View ............................................................ 443

Table of Contents
View Point-to-Point Wiring Diagrams ........................................................................... 443

View Data History in a Browser View ........................................................................... 444
Set a Date Range for Field Value Changes..................................................................... 445
Track Field Value Changes............................................................................................. 445
Open a Process Data Sheet from the Browser Window.................................................. 446
Open a Specification Sheet from the Browser Window ................................................. 446
Open a Calculation Sheet from the Browser Window .................................................... 446
Display Existing Wiring Connections............................................................................. 447
Open I/O Assignment from a Browser View.................................................................. 447
Change the Process Function and Instrument Type in Batch Mode ............................... 447
Generating Documents: An Overview .........................................................................449

Generating Documents Common Tasks ...................................................................450
Generate a Specification Sheet for an Instrument........................................................... 451
Generate a Process Data Sheet for an Instrument ........................................................... 452
Generate a Drawing and Revision Report....................................................................... 453
Create a List of Available Tags ...................................................................................... 454
Generate Loop Summary Reports................................................................................... 455
Generate Custom Table Reports ..................................................................................... 455
Working with External Documents: An Overview.....................................................456

Managing External Documents Common Tasks ......................................................457
Associate an External Document with Instrument Tags ................................................. 458
Open an External Document Associated with an Instrument Tag .................................. 458
Dissociate an External Document from an Instrument Tag ............................................ 459
View Associated Documents .......................................................................................... 460
Wiring in SmartPlant Instrumentation: An Overview ..............................................461

Principles of Wiring Operations in SmartPlant Instrumentation..............................462
Splitting the Wiring Design Among Several Teams ................................................463
Creating a Wiring Scheme........................................................................................465
Name and Sequence Uniqueness of Wiring Items ...................................................466
General Definitions Common Tasks ........................................................................468
Apply Naming Conventions to Wiring Items ................................................................. 468
Associate a Symbol with an Item .............................................................................469
Remove Trailing Separators From Wiring Item Names ................................................. 470
Creating and Managing Cables: An Overview ...........................................................471

Creating and Managing Cables Common Tasks ......................................................472
Define a Cable Configuration ......................................................................................... 475
Edit a Cable Configuration ............................................................................................. 476
Delete a Cable Configuration.......................................................................................... 478
Create a Cable ................................................................................................................. 479
Create a Connector.......................................................................................................... 481
Edit Cable Properties ...................................................................................................... 482
Add a Cable Set .............................................................................................................. 483
Add a Wire to a Cable Set............................................................................................... 484
Create a Cable Without Sets and Wires .......................................................................... 486

Table of Contents
Apply a Reference Cable to Multiple Cables Without Sets and Wires........................... 486
Apply a Reference Cable to One Cable Without Sets and Wires ................................... 487
Edit Wire Properties........................................................................................................ 487
Apply Regional Wire Colors to Project Cables .............................................................. 489
Conventional Panels: An Overview..............................................................................490

Managing Conventional Panels Common Tasks......................................................491
Create a Junction Box ..................................................................................................... 493
Create a Marshaling Rack............................................................................................... 495
Create a Cabinet.............................................................................................................. 497
Create an Unassociated Conventional Device Panel ...................................................... 499
Create a Distributed Control System (DCS) Panel ......................................................... 501
Create a Programmable Logic Controller (PLC) Panel .................................................. 503
Create a Panel with Terminals and Connectors .............................................................. 504
Enter Power Supply Data for Panels and Instrument Tags ............................................. 505
Create a Rack .................................................................................................................. 507
Create a Slot.................................................................................................................... 508
Device Panels: An Overview .........................................................................................509

Principles of Creating Device Panels .......................................................................510
Managing Device Panels Common Tasks ................................................................511
Create an Instrument with an Automatically Configured Device Panel ......................... 514
Create an Instrument with a Manually Configured Device Panel................................... 516
Create an Instrument Without a Device Panel ................................................................ 518
Create Device Panels and Cables in the Instrument Index Standard Browser View ...... 520
Create Device Panels for Selected Instruments .............................................................. 521
Associate Instruments with Device Panels ..................................................................... 523
Dissociate Device Panels from Instruments.................................................................... 523
Create a Device Cable..................................................................................................... 524
Rename Device Cables in Batch Mode........................................................................... 525
Wiring Equipment: An Overview ................................................................................526

Wiring Equipment Common Tasks ..........................................................................528
Customize and Use Wiring Equipment Categories......................................................... 530
Add User-Defined Wiring Equipment Category Properties ........................................... 532
Create a Wiring Equipment Item .................................................................................... 533
Hierarchy Examples of Wiring Items .......................................................................535
Create an I/O Card .......................................................................................................... 537
Create an I/O Termination .............................................................................................. 540
Customize the Controller/Processor List Header in I/O Card Properties ....................... 542
Associate an I/O card with an I/O Termination .............................................................. 543
Apparatus: An Overview ..............................................................................................545

Apparatus Common Tasks........................................................................................546
Define an Apparatus Configuration ................................................................................ 547
Create an Apparatus Group............................................................................................. 549
Add an Apparatus to an Apparatus Group ...................................................................... 550
Edit Apparatus Terminal Properties................................................................................ 551

Table of Contents
Terminal Strips: An Overview .....................................................................................552

Managing Terminal Strips Common Tasks..............................................................553
Define a Terminal Strip Configuration ........................................................................... 554
Modify a Terminal Strip Configuration .......................................................................... 556
Terminal Strip Configuration Examples ......................................................................... 557
Create a Terminal Strip................................................................................................... 558
Move a Terminal Strip to Another Parent Item .............................................................. 559
Add a Terminal to a Terminal Strip ................................................................................ 560
Add a Group of Terminals to a Terminal Strip............................................................... 561
Edit the Properties of a Terminal .................................................................................... 562
Select a Graphic for a Terminal Connection................................................................... 563
Making Connections in SmartPlant Instrumentation: An Overview .......................564

Making Connections Common Tasks.......................................................................565
Define a Connection Type .............................................................................................. 567
Connection Type Examples ............................................................................................ 569
Connect a Cable or a Cable Set to a Terminal Strip ....................................................... 571
Connect Device Cables to a Terminal Strip in Batch Mode ........................................... 573
Connect a Wire to a Terminal Strip ................................................................................ 575
Move Cables, Cable Sets, and Wires .............................................................................. 576
Disconnect Cables, Cable Sets, and Wires ..................................................................... 577
Add Jumpers to the Existing Wiring............................................................................... 578
Set Preferences for Automatic Naming of Jumpers........................................................ 579
Remove a Jumper from the Existing Wiring .................................................................. 579
Assigning Wire Designation.....................................................................................580
Updating Connection Data .......................................................................................581
View Cable Connection Destinations ............................................................................. 581
Display Adjacent Connections of a Cable ...................................................................... 582
Display the Farthest Connection of a Cable.................................................................... 582
Examples of Farthest Connections of Cables ................................................................. 583
Trace a Signal in a Point-to-Point Wiring Diagram........................................................ 584
Change the Font Size of Cable and Cable Set Names .................................................... 585
Generate a Connection Report from the Connection Window ....................................... 586
I/O Assignment: An Overview......................................................................................587

Effecting I/O Assignment Common Tasks...............................................................588
Set I/O Assignment Instrument Tag Preferences............................................................ 591
Effect I/O Assignment for an Instrument........................................................................ 591
Effect I/O Assignment for a Segment ............................................................................. 593
Assign an Instrument to a Channel ................................................................................. 594
Assign a Segment to a Channel ...................................................................................... 594
Create a Channel ............................................................................................................. 595
Create a Control System Tag .......................................................................................... 596
Create a Control System Tag in the Instrument Index Standard Browser View............. 597
Rename a Control System Tag ....................................................................................... 598
Couple an Instrument with a Control System Tag .......................................................... 598
Decouple an Instrument and a Control System Tag ....................................................... 599
Delete a Control System Tag .......................................................................................... 599
Filter the Display of Data in the I/O Assignment Window............................................. 600

Table of Contents
Cancel I/O Assignment ................................................................................................... 601

Generate an I/O Tag Assignment Report........................................................................ 601
View and Edit Channel Data........................................................................................... 602
Find I/O Channels for Assignment ................................................................................. 603
Cross Wiring: An Overview..........................................................................................605

Cross Wiring Connections Common Tasks..............................................................606
Perform Manual Cross Wiring........................................................................................ 607
Perform Semiautomatic Cross Wiring ............................................................................ 609
Set Cross Wiring Preferences ......................................................................................... 611
Perform Automatic Cross Wiring ................................................................................... 611
Create a Cross Wiring Cable........................................................................................... 614
Generate a Panel Strip Report from the Cross Wiring Window ..................................... 614
Auto-Wiring: An Overview...........................................................................................615
Defining and Executing Auto-Wiring Tasks: An Overview ....................................616
Flow of Activities for Auto-Wiring..........................................................................618
Auto-Wiring Connections Common Tasks ..............................................................619
Pre-Assign Junction Boxes to Device Panels ................................................................. 620
Auto-Wire Pre-Assigned Junction Boxes ....................................................................... 621
Auto-Wire Two Panels ................................................................................................... 623
Auto-Wire Control Systems............................................................................................ 625
Auto-Wire Control Systems Connected to Pre-Assigned Junction Boxes...................... 627
Auto-Wiring Task Statuses ............................................................................................. 630
Change an Auto-Wiring Task Status .............................................................................. 630
Signal Propagation: An Overview................................................................................631

Possible Cases of Signal Propagation ............................................................................. 632
Tag Signal Propagation Common Tasks ..................................................................634
Re-Propagate a Tag Signal.............................................................................................. 636
Force Signal Propagation................................................................................................ 636
Propagate a Tag Signal Manually ................................................................................... 637
Automatically Propagate a Signal from a Non-Wiring Instrument ................................ 638
Create a Local Tag Signal............................................................................................... 639
Filter the Local Signal Dialog Box ................................................................................. 640
Create a General Signal .................................................................................................. 641
Link Tag Signals to a General Signal ............................................................................. 642
Multiplex Tag Signals..................................................................................................... 643
De-Multiplex Tag Signals............................................................................................... 644
Intrinsic Safety Calculations Common Tasks...........................................................645
Create an Intrinsically Safe Circuit Type........................................................................ 646
Manage Intrinsic Safety Circuit Types ........................................................................... 647
Calculate Intrinsic Safety................................................................................................ 647
Define Tag Numbers for Intrinsic Safety Loop Calculation........................................... 649
Define Circuit Cables for Intrinsic Safety Loop Calculation.......................................... 650
Calculate Intrinsic Safety for a Loop .............................................................................. 651

Table of Contents
Cable Routing: An Overview........................................................................................652

Cable Routing Flow of Activities .............................................................................653
Cable Routing Common Tasks.................................................................................654
Set Cable Routing Options.............................................................................................. 656
Customize Cable Routing Terminology ......................................................................... 657
Manage Standard Widths................................................................................................ 658
Manage Standard Positions............................................................................................. 658
Set the Maximum Number of Cables for the Standard Positions ................................... 659
Create a Routing Section ................................................................................................ 660
Edit a Routing Section .................................................................................................... 661
Associate a Routing Section with Cables ....................................................................... 662
Edit a Cable Routing....................................................................................................... 663
Copy Routing Data to Another Cable ............................................................................. 664
Append Routing Data to a Cable .................................................................................... 665
Cable Drums: An Overview..........................................................................................666

Cable Drums Common Tasks...................................................................................667
Create and Manage a Pulling Area ................................................................................. 669
Associate Cables with a Pulling Area ............................................................................. 669
Define Cable Drum Attributes for Cable Types ............................................................. 670
Manage Cable Drums Manually ..................................................................................... 671
Assign Cables to Drums Automatically (with Optimization) ......................................... 672
Assign Cables to Drums Manually (Without Optimization)........................................... 672
Managing Panel Locations: An Overview ...................................................................673

Managing Panel Locations Common Tasks .............................................................673
Define a New Panel Location ......................................................................................... 674
Modify Panel Location Properties .................................................................................. 674
Change the Location of a Panel ...................................................................................... 675
Dissociate a Panel from a Location ................................................................................ 675
Delete a Panel Location .................................................................................................. 676
Generating Wiring Reports Common Tasks.............................................................677
List of Wiring Reports .................................................................................................... 678
Generate a Connection Report from the Connection Window ....................................... 682
Generate a Panel Strip Report from the Cross Wiring Window ..................................... 682
Generate an I/O Tag Assignment Report........................................................................ 683
Generate Panel-Strip Reports as PDF Files .................................................................... 683
Display Channels and Wiring Equipment in Panel-Strip Reports .................................. 684
Cable Block Diagrams: An Overview ..........................................................................685

Cable Block Diagram Common Tasks .....................................................................686
Create a Cable Block Diagram ....................................................................................... 687
Add Cables and Objects to an Existing Cable Block Diagram....................................... 689
View an Existing Cable Block Diagram ......................................................................... 690
Disconnect Cables from Items in a Cable Block Diagram ............................................. 690
Remove Items from a Cable Block Diagram .................................................................. 691

Table of Contents
Associate Cable with Panels: An Overview .................................................................692

Associate Cable with a Panel.......................................................................................... 692
Specifications: An Overview .........................................................................................694

Principles of Generating Specifications....................................................................695
Specification General Operations Common Tasks...................................................697
Generate Instrument Specs in Batch Mode..................................................................... 698
Open a Spec from the Instrument Index Standard Browser View .................................. 699
Open a Spec from the Specifications Module................................................................. 700
Create a Tag Number in the Specifications Module ....................................................... 701
Add Expanded Notes and Remarks ................................................................................ 701
Delete Specs in Batch Mode ........................................................................................... 702
Ways of Defining a Spec Document Number................................................................. 703
Specification Pages: An Overview................................................................................704

Managing Spec Pages Common Tasks.....................................................................705
Open a Page .................................................................................................................... 708
Open a Page from an External File ................................................................................. 708
Display Data Field Names .............................................................................................. 709
Display a List of Forms that Include the Current Page................................................... 709
Regenerate Pages ............................................................................................................ 709
Save a Page to the Database............................................................................................ 710
Save a Page as an External File ...................................................................................... 710
Delete a Page .................................................................................................................. 711
Create a Large Note Page ............................................................................................... 712
Select a Different Process Function for a Page............................................................... 714
Set the Tab Order of the Fields on a Page....................................................................... 715
Switch to the Default Tab Order ..................................................................................... 715
Retrieve Custom Pages as PSR Files .............................................................................. 716
Working with Page Graphics Common Tasks..........................................................717
Add a Line to a Page....................................................................................................... 718
Set Precise Position and Length of a Line ...................................................................... 719
Modify Line Position and Length Using Arrow Keys .................................................... 719
Modify Line Position and Length Using the Mouse....................................................... 720
Change Line Properties................................................................................................... 721
Duplicate Page Lines ...................................................................................................... 722
Add Graphics to a Page................................................................................................... 723
Set Precise Position and Size of Page Objects................................................................ 724
Modify Position and Size of Page Objects Using the Mouse ......................................... 725
Modify Position and Size of Page Objects Using Arrow Keys ...................................... 725
Customizing Pages Common Tasks .........................................................................726
Open a Spec Page in InfoMaker ..................................................................................... 729
Edit Field Headers .......................................................................................................... 730
Display Invisible Fields .................................................................................................. 731
Define Fields with Computed Values ............................................................................. 731
Display Revision Changes for Spec Properties............................................................... 733
Format Field Values........................................................................................................ 734
Add Data Fields to a Page............................................................................................... 734
Associate User-Defined Views ....................................................................................... 735

Table of Contents
Duplicate Data Fields in a Page ...................................................................................... 736

Delete Data Fields........................................................................................................... 737
Add Custom Fields of Wiring Equipment Items ............................................................ 737
Add Function Block Custom Fields to a Fieldbus Spec ................................................. 738
Add a Unit of Measure Drop-Down Data Window in a PSR File .................................. 739
Add a Select List in a PSR File....................................................................................... 740
Drop-Down Data Windows Retrieving Units of Measure.............................................. 741
Spec Forms: An Overview.............................................................................................742

Spec Forms Common Tasks .....................................................................................743
Create a Form.................................................................................................................. 745
Edit Form Properties ....................................................................................................... 746
Add Pages to an Existing Form ...................................................................................... 747
Remove a Page from a Form .......................................................................................... 748
Sort Pages Within Forms ................................................................................................ 749
Define Form Browser Fields........................................................................................... 750
Display a List of Pages Included in a Form .................................................................... 751
Delete a Form.................................................................................................................. 751
Restore Library Forms .................................................................................................... 752
Regenerate Library Forms .............................................................................................. 752
Change the Form Assignment of a Spec......................................................................... 753
Change Form Assignment for a Batch of Specs ............................................................. 754
Form Data Templates: An Overview ...........................................................................755

Form Data Template Common Tasks.......................................................................756
Create and Modify a Form Data Template ..................................................................... 756
Delete a Form Data Template ......................................................................................... 758
Single-Tag Specs: An Overview....................................................................................759

Single-Tag Specs Common Tasks ............................................................................760
Generate a Single-Tag Spec............................................................................................ 761
Notes for Editing a Single-Tag Spec .............................................................................. 762
Edit Manufacturers and Models in a Spec ...................................................................... 763
Move a Single-Tag Spec to a Multi-Tag Spec................................................................ 763
Generate a Spec for a Complex Analyzer....................................................................... 764
Process Data Case Specs: An Overview.......................................................................765

Process Data Case Specifications Common Tasks...................................................766
Generate a Spec for Multiple Process Data Cases .......................................................... 766
Generate a Hybrid Case Spec ......................................................................................... 767
Multi-Tag Specs: An Overview.....................................................................................769

Multi-Tag Specs Common Tasks .............................................................................770
Generate a Multi-Tag Spec ............................................................................................. 772
Add a Single Instrument Tag to a Multi-Tag Spec ......................................................... 773
Add Instrument Tags to a Multi-Tag Spec in Batch Mode............................................. 774
Edit See List Data in a Multi-Tag Spec .......................................................................... 774
Change the Master Tag Definition.................................................................................. 775

Table of Contents
Search for a Specific Tag in a Multi-Tag Spec............................................................... 775

Change the Font Size of See List Column Headers ........................................................ 776
Move a Tag to Another See List ..................................................................................... 777
Move a Tag from See List to a Single-Tag Spec ............................................................ 778
Remove a Tag from a Multi-Tag Spec............................................................................ 779
Generate a Spec for an Analyzer Stream ........................................................................ 780
Multi-Tag Spec Formats: An Overview.......................................................................781

Formats Common Tasks ...........................................................................................782
Create a Format............................................................................................................... 783
Modify a Format ............................................................................................................. 784
Delete a Format............................................................................................................... 786
Regenerate Formats ........................................................................................................ 786
Change the Format for a Multi-Tag Spec ....................................................................... 787
Define Multi-Tag Spec Print Layout .............................................................................. 787
Non-Instrument Specs: An Overview ..........................................................................789

Non-Instrument Specs Common Tasks ....................................................................790
Prerequisites for Generating a Non-Instrument Spec ..................................................... 790
Generate a Non-Instrument Spec .................................................................................... 791
Generate a Functional Requirement Spec....................................................................... 792
Composite Specifications: An Overview......................................................................793

Composite Spec for Multiple Instruments: Generation Workflow ................................. 795
Composite Spec for Instrument with Cases: Generation Workflow............................... 796
Loop Composite Spec: Generation Workflow................................................................ 798
Remove an Instrument from a Composite Spec.............................................................. 800
Remove a Section from a Composite Page..................................................................... 800
Spec Title Blocks: An Overview ...................................................................................801

Title Block in a Multi-Tag Spec ..................................................................................... 802
Spec Title Block Common Tasks .............................................................................803
Customize a Title Block in InfoMaker ........................................................................... 804
Assign a Title Block to a Form ....................................................................................... 805
Modify a Custom Title Block ......................................................................................... 806
Update Custom Title Blocks After Version Upgrade ..................................................... 807
Copying Specification Data: An Overview ..................................................................808

Copying Specification Data Common Tasks............................................................809
Protect Fields from Overwriting When Copying Data ................................................... 810
Copy Data to a Form Data Template from a Spec .......................................................... 810
Copy Data to a Spec from a Form Data Template .......................................................... 812
Copy Data from One Spec to Another ............................................................................ 813

Table of Contents
Spec Revisions: An Overview .......................................................................................814

Revision and Data Comparison Common Tasks ............................................................ 815
Manage Spec Revisions Locally ..................................................................................... 816
Manage Spec Revisions Globally ................................................................................... 817
View and Print Spec Revisions....................................................................................... 818
Compare Current Data with a Saved Revision ............................................................... 818
Compare Current Data with a Saved Spec...................................................................... 819
View Data History .......................................................................................................... 820
Change Storage Method of Specification Revisions....................................................... 821
Delete Spec Revisions..................................................................................................... 822
Save, Export, and Import Options: An Overview ......................................................823

Save, Export, and Import Options Common Tasks ..................................................824
Save a Spec in PSR Format ............................................................................................ 825
Save an Instrument Spec in ISF Format.......................................................................... 826
Save Instrument Specs in Batch Mode ........................................................................... 826
Save an Instrument Spec in Excel Format ...................................................................... 827
Batch Save of Instrument Specs in Excel Format........................................................... 827
Protect Fields Before Exporting Specs to External Editor.............................................. 828
Import Data to a Specification from an External File ..................................................... 829
Import Data to Instrument Specs in Batch Mode............................................................ 830
Save as Excel: An Overview..........................................................................................831

Customizing Specs for Save as Excel Common Tasks ............................................832
Guidelines for Customizing Pages for Save as Excel ..................................................... 834
Guidelines for Customizing PSR Files for Save as Excel .............................................. 836
Create an Invisible Vertical Zero Line............................................................................ 838
Replace Double Lines with Thick Single Lines.............................................................. 839
Correct a Line Discontinuity........................................................................................... 839
Correct Horizontal and Vertical Divergence of Grid Lines ............................................ 840
Set Value Display Precision for Save as Excel Globally................................................ 840
Set Value Display Precision for Individual Fields.......................................................... 841
Save as Excel Troubleshooting.................................................................................842
Resolve Spec Accessing Problem in a Common Excel File ........................................... 844
Remove the Protection from a Spec Saved as Excel ...................................................... 845
Resolve a Data Saving Problem...................................................................................... 845
Resolve Grid Line Overlap Problems ............................................................................. 845
Correct Undershooting and Overshooting of Grid Lines................................................ 846
Prevent Truncation of Labels and Values ....................................................................... 847
Fix Displaced Labels....................................................................................................... 848
Fix Text Display in Excel Cells ...................................................................................... 849
Fix Function Conversion Problems ................................................................................ 849
Set Value Display Precision............................................................................................ 850
Fix Display of Vertical Fields......................................................................................... 850
Fix Display of Select Lists.............................................................................................. 851
Prepare Problematic Excel Files for Intergraph Support ................................................ 851

Table of Contents
Specification Report List...............................................................................................852

Printing Specifications and Reports Common Tasks ...............................................854
Print a Specification Report ............................................................................................ 855
Generate Reports by Date ............................................................................................... 856
Generate a Report for a Selected Field Name................................................................. 856
Assign User-Defined Headers for Spec Form Field Reports .......................................... 857
Print the Currently Open Specification........................................................................... 858
Print Specs into PDF Files .............................................................................................. 859
Pipe Specs: An Overview...............................................................................................860

Pipe Specs Common Tasks.......................................................................................861
Define or Modify Pipe Specs.......................................................................................... 862
Assign Pipe Specs to Instruments ................................................................................... 863
Assign Pipe Specs to Lines ............................................................................................. 864
Associate Pipe Specs with Sub-Libraries........................................................................ 865
Display Pipe Specs Assigned to a Hook-Up Item Sub-Library ...................................... 866
Dissociate a Pipe Spec from Lines.................................................................................. 867
Delete Pipe Specs............................................................................................................ 868
Foundation Fieldbus Design: An Overview.................................................................869

Flow of Activities for Foundation Fieldbus Design .................................................870
Preliminary Definitions for Foundation Fieldbus Common Tasks...........................874
Define Segment-Wide Parameters .................................................................................. 875
Spur Cable Lengths Example.......................................................................................... 878
Working with Function Blocks: An Overview.........................................................879
Create a User-Defined Function Block........................................................................... 880
Associate Function Blocks with Instrument Types......................................................... 881
Manage the Functions Blocks Supporting Table ............................................................ 882
Working with the Fieldbus Tag Numbers Browser: An Overview ..........................883
Managing Fieldbus Instruments Common Tasks .....................................................884
Define Foundation Fieldbus and Profibus Instrument Type Profiles.............................. 885
Create Foundation Fieldbus and Profibus Instruments ................................................... 886
Associate Function Blocks with Instruments.................................................................. 889
Managing Segments Common Tasks .......................................................................890
Create a Foundation Fieldbus Segment .......................................................................... 891
Edit the Properties of a Foundation Fieldbus Segment................................................... 892
Associate an Instrument with a Segment ........................................................................ 892
Dissociate an Instrument from a Segment ...................................................................... 893
Change Instrument / Segment Association ..................................................................... 893
Delete a Fieldbus Segment.............................................................................................. 894
Enable a Function Block for I/O Assignment................................................................. 894
Change the View in the Fieldbus Tag Numbers Browser............................................... 894
Managing Fieldbus Cables Common Tasks .............................................................895
Create a Home-Run Cable .............................................................................................. 895
Create a Spur Cable ........................................................................................................ 896
Fieldbus Plug-and-Socket Boxes: An Overview ......................................................897
Managing Fieldbus Panels (Plug-and-Socket Boxes) Common Tasks ....................898

Table of Contents
Create a Plug-and-Socket Device Panel.......................................................................... 899

Create a Plug-and-Socket Junction Box.......................................................................... 900
Edit the Properties of a Plug-and-Socket Device Panel .................................................. 901
Edit the Properties of a Plug-and-Socket Junction Box .................................................. 902
Working with Terminators: An Overview................................................................903
Managing Terminators Common Tasks ...................................................................904
Create an External Terminator in a Plug-and-Socket Box.............................................. 905
Create an External Terminator on a Terminal Strip........................................................ 905
Create an Internal Terminator......................................................................................... 906
Move an External Terminator to Another Port in a Plug-and-Socket Box ..................... 906
Terminator (Plug-and-Socket Box) — Segment Association....................................... 907
Terminator (Terminal Strip) — Segment Association.................................................. 907
Fieldbus Bricks: An Overview .................................................................................908
Managing Fieldbus Brick Assemblies and Apparatuses Common Tasks ................909
Create a Fieldbus Brick Assembly.................................................................................. 910
Configure a Fieldbus Apparatus ..................................................................................... 912
Making Connections and Associations for Fieldbus Common Tasks ......................914
Define or Edit a Connector Type .................................................................................... 916
Define or Edit a Connector Type Pin Configuration ...................................................... 916
Delete a Connector Type ................................................................................................ 917
Create a Connector.......................................................................................................... 918
Assign Connector Pins to Cable Wires ........................................................................... 919
Associate a Pin or a Terminal with a Channel ................................................................ 920
Delete a Connector.......................................................................................................... 920
Connect a Home-Run Cable to a Plug-and-Socket Box ................................................. 921
Associate a Segment with a Home-Run Cable ............................................................... 922
Managing Fieldbus I/O Cards and I/O Assignment Common Tasks .......................923
Create a Fieldbus I/O Card ............................................................................................. 924
Effect Fieldbus I/O Assignment...................................................................................... 925
Fieldbus Validation: An Overview...........................................................................926
Fieldbus Validation Common Tasks ........................................................................928
Generate a Validation Report for One Segment ............................................................. 928
Generate a Validation Report for Multiple Segments..................................................... 929
Generate a Validation Report for Multiple Segments from the Fieldbus Tag Numbers Browser
........................................................................................................................................ 929
Generate a Segment Wiring Report ................................................................................ 930
Profibus Design: An Overview .....................................................................................931

Flow of Activities for Profibus Design.....................................................................932
Profibus Design Common Tasks ..............................................................................934
Create a Profibus DP Segment........................................................................................ 935
Create a Profibus PA Segment........................................................................................ 935
Associate Profibus PA Instruments with a PA Segment................................................. 935
Associate Profibus DP Instruments with a DP Segment................................................. 936
Create a DP-Compatible PLC or DCS Panel .................................................................. 936
Associate a PLC or DCS Panel with a Profibus DP Segment......................................... 937
Generate an Enhanced Profibus Layout Report.............................................................. 937

Table of Contents
Working with HART Instruments: An Overview ......................................................938

Flow of Activities for HART Instrumentation .........................................................939
Define Instrument Type Profiles for HART Instruments ............................................... 940
Create a HART Instrument ............................................................................................. 940
Create a Virtual Digital Tag............................................................................................ 942
Create an I/O Card Compatible with HART Instruments............................................... 943
Effect I/O Assignment for HART Instruments ............................................................... 943
Fieldbus and Conventional Multi-Input Devices: An Overview ...............................944

Managing Multi-Input Devices Common Tasks ......................................................945
Create a Plug-and-Socket Multi-Input Device Panel ...................................................... 946
Create a Multi-Input Device Panel with Terminal Connections..................................... 947
Create a Multi-Input Instrument with Plug-and-Socket Connections for a Fieldbus Segment
........................................................................................................................................ 948
Create a Multi-Input Instrument with Terminal Connections for a Fieldbus Segment... 950
Create a Multi-Input Instrument with Plug-and-Socket Connections for a Serial Loop Interface
........................................................................................................................................ 952
Create a Multi-Input Instrument with Terminal Connections for a Serial Loop Interface953
Telecom Design: An Overview......................................................................................955

Flow of Activities for Telecom Design ....................................................................956
Arrangement of Telecom Items in the SmartPlant Instrumentation Explorer..........958
Supporting Tables for Telecom ...................................................................................... 959
Working with Old Equipment......................................................................................... 960
Creating and Managing Telecom Devices and Cables Common Tasks...................961
Set Telecom Device Type Profile Defaults..................................................................... 963
Create a Telecom Field Tag............................................................................................ 964
Duplicate a Telecom Field Tag....................................................................................... 965
Create a Telecom Conventional Field Device ................................................................ 966
Create a Telecom Plug-and-Socket Field Device ........................................................... 967
Create a Telecom Cable .................................................................................................. 967
Creating and Managing Telecom Panels Common Tasks........................................968
Create a Telecom Junction Box ...................................................................................... 969
Create a Splice Panel ...................................................................................................... 970
Create a Distribution Frame............................................................................................ 971
Create a Patch Panel........................................................................................................ 972
Managing Equipment Cabinets and Equipment Items Common Tasks ...................973
Create a PA Cabinet........................................................................................................ 975
Create an Amplifier......................................................................................................... 976
Add a Connector to an Amplifier.................................................................................... 977
Create a PABX Cabinet .................................................................................................. 978
Create a PABX Rack ...................................................................................................... 979
Create a Switch ............................................................................................................... 980
Add a Connector to a Switch .......................................................................................... 981
Add a Switch Port ........................................................................................................... 981
Create a Switch Channel................................................................................................. 982
Create and Associate a Telephone Number .................................................................... 982
Create an Unassociated Telephone Number ................................................................... 983

Table of Contents
Associate a Telephone Number with a Channel ............................................................. 983

Create a Miscellaneous Cabinet...................................................................................... 984
Create a Hub Cabinet ...................................................................................................... 985
Create Hub Equipment.................................................................................................... 986
Create a Hub Connector.................................................................................................. 987
Add a Port to a Hub ........................................................................................................ 987
Create an Intercom Cabinet ............................................................................................ 988
Add Intercom Equipment................................................................................................ 989
Add an Intercom Connector............................................................................................ 990
Generating Telecom Reports Common Tasks..........................................................991
Generate a Communication Line Report ........................................................................ 992
Generate a Speaker Load Report .................................................................................... 993
Generate a Telecommunication Device List................................................................... 993
Generate a Telecom Device Type Report ....................................................................... 994
Generate a Telecom Line Number Report ...................................................................... 994
Generate a Telecom Field Equipment Report................................................................. 994
Generate a Telecom Signal Level Report ....................................................................... 995
Generate an Actual Load Report..................................................................................... 995
Document Binder Module: An Overview ....................................................................996

Specification Binder Packages .................................................................................997
General Document Binder Packages ........................................................................998
Document Management Common Tasks..................................................................999
Start the Document Binder Module .............................................................................. 1001
Create a New Binder Package....................................................................................... 1001
Assign an Instrument Specification to a Specification Binder Package ....................... 1002
Edit Binder Package Properties .................................................................................... 1003
Remove Selected Instrument Specifications From a Specification Binder Package .... 1004
Remove a Single Instrument Specification From a Specification Binder Package ...... 1005
Remove All Instrument Specifications From a Specification Binder Package............. 1006
Delete a Binder Package ............................................................................................... 1006
Associate External Files with a Binder Package........................................................... 1007
Notes .......................................................................................................................1008
Notes Common Tasks.............................................................................................1009
Create a Form Note Template....................................................................................... 1010
Edit a Form Note Template........................................................................................... 1010
Delete a Form Note Template....................................................................................... 1011
Create a Form Note....................................................................................................... 1011
Assign a General Note to a Binder Package ................................................................. 1013
Edit a Note .................................................................................................................... 1014
Specification Binder Package Revisions ................................................................1015
Change Summary Report........................................................................................1017
Enabling Specification Changes Notification.........................................................1018
Binder Package Revision Archive ..........................................................................1019
Revisions Common Tasks ......................................................................................1020
Add a Revision to a Binder Package............................................................................. 1021
Delete a Revision From a Binder Package.................................................................... 1022
Convert Binder Package Revisions to .Zip Format Files.............................................. 1023
Modify the Change Notification of a Specification ...................................................... 1024

Table of Contents
Printing from a Binder Package: An Overview ........................................................1025

Printing from a Binder Package Common Tasks ...................................................1026
Print Documents in a Binder Package........................................................................... 1027
Print From a Binder Package to a PDF File.................................................................. 1028
Save From a Binder Package to a .Zip File................................................................... 1029
Displaying Binder Package Properties ...................................................................1030
Display the Properties of a Binder Package.................................................................. 1030
Troubleshooting......................................................................................................1031
Loop Drawings Module: An Overview ......................................................................1033
Blocks in SmartPlant Instrumentation: An Overview .............................................1034

Block Types: An Overview ....................................................................................1036
Loop Blocks: An Overview ....................................................................................1038
Shipped Block Files ...................................................................................................... 1039
Managing CAD Drawing Blocks Common Tasks .................................................1041
Add a Block Type ......................................................................................................... 1042
Add a Block to a Block Type........................................................................................ 1042
View a Drawing Block in a CAD Application ............................................................. 1043
Define Insertion Points for Blocks................................................................................ 1044
Copy Blocks to Another <Plant>.................................................................................. 1045
Assigning Blocks Common Tasks..........................................................................1046
Associate a Loop Block ................................................................................................ 1048
Associate Instrument Blocks Automatically (via Instrument Type)............................. 1049
Change the Block Assignment Method from Automatic to Manual............................. 1050
Associate Instrument Blocks Manually ........................................................................ 1051
Update Block Assignments........................................................................................... 1052
Copy Associated Blocks to Other Instrument Tags ...................................................... 1053
Copy Automatically Assigned Blocks to Tags of Other Loops.................................... 1054
Assign an Instrument Block to a Drawing Page ........................................................... 1055
Dissociate Blocks from Instruments ............................................................................. 1056
Specify Border and Logo Blocks for Loop Drawings .................................................. 1056
Assign General Blocks to All Loop Drawings via Instrument Type ............................ 1057
Updating Loop Drawing Properties: An Overview ..................................................1058

Loop Drawing Types and Drawing Properties Common Tasks.............................1059
Set the Date Format in CAD Loop Drawings ............................................................... 1061
Define a Drawing as a Multi-Drawing.......................................................................... 1062
Define a Drawing as a Multi-Page Drawing................................................................. 1063
Modify Properties of a Single-Page Drawing ............................................................... 1064
Maintain CAD Loop Drawing Revisions...................................................................... 1064
Maintain Document References.................................................................................... 1066
Make CAD Drawing Approvals ................................................................................... 1067
Modify Loop Drawing Identifying Information ........................................................... 1067
Update Paths for CAD Drawings and Block Files........................................................ 1067
Update Paths for Existing CAD Drawings And Block Files ........................................ 1068
Associating an External CAD Drawing ........................................................................ 1069
View an External CAD Drawing .................................................................................. 1069

Table of Contents
Loop Drawing Generation Methods: An Overview..................................................1070
CAD Loop Drawing Generation: An Overview........................................................1071

CAD Settings for SmartPlant Instrumentation.............................................................. 1073
CAD Loop Drawing Generation Common Tasks ..................................................1077
Apply Loop Drawing Generation Method .................................................................... 1078
Generate CAD Loop Drawings..................................................................................... 1079
Show the Latest Generated CAD Drawing ................................................................... 1081
Display CAD Loop Drawing Generation History......................................................... 1082
Delete CAD Loop Drawing Generation History........................................................... 1083
Clear Previous Macro Result Records .......................................................................... 1083
Loop Drawing Reports ...........................................................................................1084
Generate a Report of CAD Loop Drawing Generation Errors...................................... 1084
Macros in SmartPlant Instrumentation: An Overview............................................1085

SmartPlant Instrumentation Macro Structure .........................................................1087
Loop Title Block Macros........................................................................................1088
Wiring Module Macros - Conventions ...................................................................1091
Generate a Macro Report .............................................................................................. 1093
Using Macros in CAD Blocks: An Overview ........................................................1094
Insert Macros in an AutoCAD Drawing Block............................................................. 1096
Customizing Macro Definitions: An Overview......................................................1097
Create a New Macro Definition.................................................................................... 1098
Delete a Macro Definition ............................................................................................ 1099
Working with User-Defined Macro Functions: An Overview ...............................1100
Standard Functions ....................................................................................................... 1102
Create a User-Defined Macro Function ........................................................................ 1103
Modify a User-Defined Macro Function ...................................................................... 1105
Delete a User-Defined Macro Function ........................................................................ 1105
Using External Macro Data Sources: An Overview...............................................1106
External Macro Naming Conventions ....................................................................1107
External Macro Structure Conventions ..................................................................1108
Connecting to an External Data Source..................................................................1109
Prerequisites for Connecting to a dBase ODBC Profile.........................................1110
Connecting to an ODBC Profile .............................................................................1111
Connect to an ODBC Profile ........................................................................................ 1111
Connecting to Database Platforms Other Than ODBC ..........................................1112
Connect to Database Platforms Other Than ODBC...................................................... 1112
Assigning an External Macro Data Source.............................................................1113
Assign an External Macro Data Source to One or More Loop Numbers ..................... 1113
Hook-Ups in SmartPlant Instrumentation: An Overview .......................................1114
Hook-Up Items: An Overview ....................................................................................1115

Table of Contents
Hook-Up Item Libraries and Sub-Libraries: An Overview ....................................1116

Managing Hook-Up Items and Libraries Common Tasks......................................1117
Create an Item Library .................................................................................................. 1118
Create User-Defined Sub-Libraries .............................................................................. 1119
Set an Item Library As the Active Item Library ........................................................... 1119
Create a Hook-Up Item................................................................................................. 1120
Create Hook-Up Items in Batch Mode ......................................................................... 1120
Sort Hook-Up Items in a Sub-Library........................................................................... 1122
Associate Items with User-Defined Sub-Libraries ....................................................... 1123
Remove Items from a User-Defined Sub-Library......................................................... 1124
Delete Hook-Up Items .................................................................................................. 1125
Delete Hook-Up Sub-Libraries ..................................................................................... 1125
Managing Hook-Ups Common Tasks ....................................................................1126
Create a Hook-Up Type ................................................................................................ 1128
Create Hook-Ups .......................................................................................................... 1128
Associate Hook-Up Types with Instrument Types ....................................................... 1130
Associate Instrument Tag Numbers with Hook-Ups .................................................... 1131
Move Hook-Ups to Another Hook-Up Type ................................................................ 1132
Associate Hook-Ups with a Sub-Library ...................................................................... 1133
Associate Items with Hook-Ups ................................................................................... 1134
Dissociate Items from Hook-Ups.................................................................................. 1136
Dissociate Tag Numbers from Hook-Ups..................................................................... 1137
Delete Hook-Ups .......................................................................................................... 1138
Delete Hook-Up Types ................................................................................................. 1138
Hook-Up Drawing Generation: An Overview...........................................................1139

Managing Hook-Up Drawings Common Tasks .....................................................1142
Shipped Enhanced Hook-Ups Symbols ........................................................................ 1144
Apply a Drawing Generation Method to Hook-Ups..................................................... 1144
Set Default Generation Method for Hook-Up Drawings .............................................. 1145
Edit Hook-Up Drawing Identifying Fields ................................................................... 1145
Make Approvals for Hook-Up Drawings...................................................................... 1146
Maintain Hook-Up Drawing Revisions ........................................................................ 1147
Add Document References in Hook-Up Drawings....................................................... 1148
Assign Border and Logo Blocks to Hook-Up Drawings .............................................. 1149
Assign an Enhanced Symbol to a Hook-Up.................................................................. 1149
Update Paths for Hook-Up Drawings and Block Files ................................................. 1150
Generate CAD Hook-Up Drawings .............................................................................. 1151
Generate Enhanced Hook-Up Drawings....................................................................... 1153
Generate Hook-Up Drawings in Mixed Mode.............................................................. 1154
Create a New Macro Definition.................................................................................... 1156
Delete a Macro Definition ............................................................................................ 1157

Table of Contents
Hook-Up Reports: An Overview ................................................................................1158

Calculating the Total of Hook-Up Items for a Bill of Material .................................... 1160
Hook-Up Reports Common Tasks..........................................................................1161
Generate a Bill of Material ........................................................................................... 1162
Sort Data in a Bill of Material....................................................................................... 1163
Generate a Hook-Up Item List Report.......................................................................... 1163
Generate a Hook-Up Tag List Report ........................................................................... 1164
Open Reports by Selecting Document Numbers .......................................................... 1164
Maintenance Module: An Overview ..........................................................................1165

Access Rights in the Maintenance Module ............................................................1166
Starting the Maintenance Module...........................................................................1167
Start the Maintenance Module From Any SmartPlant Instrumentation Module .......... 1167
Start the Maintenance Module From an Instrument Index Browser View ................... 1167
Filtering Maintenance Activities ............................................................................1168
Filter Maintenance Activities........................................................................................ 1168
Generating Maintenance Reports ...........................................................................1169
Generate a Maintenance Report.................................................................................... 1169
Preventive Maintenance Preliminary Activities .....................................................1170
Performing Breakdown Maintenance .....................................................................1171
Defining Preventive Maintenance Attachments .....................................................1173
Define a Preventive Maintenance Attachment.............................................................. 1173
Defining Preventive Maintenance Tasks ................................................................1174
Define a Preventive Maintenance Task ........................................................................ 1174
Defining Preventive Maintenance Activities..........................................................1175
Define a Preventive Maintenance Activity ................................................................... 1175
Scheduling Maintenance.........................................................................................1177
Schedule Maintenance .................................................................................................. 1177
Extending Existing Scheduling...............................................................................1179
Extend the Existing Scheduling of Maintenance .......................................................... 1179
Entering Preventive Maintenance Details ..............................................................1180
Enter Preventive Maintenance Details.......................................................................... 1180
Performing Preventive Maintenance ......................................................................1182
Issuing a New Work Request .................................................................................1184
Issue a New Work Request ........................................................................................... 1184
Opening a Work Request........................................................................................1185
Open an Existing Work Request................................................................................... 1185
Creating Repair Forms............................................................................................1187
Create a New Repair Form ........................................................................................... 1187
Filling Out Repair Forms........................................................................................1188
Fill Out a Repair Form.................................................................................................. 1188

Table of Contents
Maintenance Event Records: An Overview ..............................................................1189

Flow of Activities for Defining and Managing Maintenance Event Records ........1190
Set a Date Format for Maintenance Event Record Names ........................................... 1191
Create a Maintenance Event Record............................................................................. 1192
Complete a Maintenance Event Record........................................................................ 1193
Calibration Module......................................................................................................1194
Calibration Flow of Activities ................................................................................1195
Starting the Calibration Module .............................................................................1196
Start the Calibration Module......................................................................................... 1196
Accessing Calibration Windows.............................................................................1197
Access a Calibration Window....................................................................................... 1197
Searching for Tag Numbers in the Calibration Module .........................................1198
Search For Tag Numbers In The Calibration Module .................................................. 1199
Copying Existing Process Data ..............................................................................1202
Copy Existing Process Data.......................................................................................... 1202
Defining Calibration Settings .................................................................................1203
Define Calibration Settings........................................................................................... 1203
Defining General Calibration Settings....................................................................1204
Define General Calibration Settings ............................................................................. 1204
Defining Alarm / Trip Settings ...............................................................................1205
Define the Alarm / Trip Settings................................................................................... 1205
Defining the Set Point.............................................................................................1206
Define the Set Point ...................................................................................................... 1206
Clearing the Calibration Ranges.............................................................................1207
Clear the Calibration Ranges ........................................................................................ 1207
Managing Action Codes .........................................................................................1208
Manage Action Codes................................................................................................... 1208
Managing Damage Codes.......................................................................................1209
Manage Damage Codes ................................................................................................ 1209
Managing Diagnostic Codes...................................................................................1210
Manage Diagnostic Codes ............................................................................................ 1210
Managing Result Codes..........................................................................................1211
Manage Result Codes ................................................................................................... 1211
Managing Test Equipment Data .............................................................................1212
Manage Test Equipment Data....................................................................................... 1212
Entering Calibration Data .......................................................................................1214
Enter Calibration Data .................................................................................................. 1214
Selecting Test Equipment .......................................................................................1216
Select Test Equipment .................................................................................................. 1216
Loop Error Calculation: An Overview ...................................................................1217
Loop Error Calculation Common Tasks.................................................................1218
Calibration Error Calculations................................................................................1219
Setting Tags for Loop Error Calculation ................................................................1220
Set Tags for Loop Error Calculation............................................................................. 1220
Calculating Loop Error ...........................................................................................1222
Calculate the Loop Error............................................................................................... 1222

Table of Contents
Maintaining Calibration History.............................................................................1224

Deleting a Calibration Result Entry........................................................................1225
Delete a Calibration Result Entry ................................................................................. 1225
Viewing and Modifying Calibration Results..........................................................1226
View Or Modify the Calibration Results ...................................................................... 1226
Generating Calibration Reports ..............................................................................1227
Generate Calibration Reports........................................................................................ 1227
Generating Calibration History Reports .................................................................1228
Generate Calibration History Reports........................................................................... 1228
Working with the Fluke Interface ..............................................................................1229

Downloading Data from SmartPlant Instrumentation ............................................1230
Uploading Data from the Fluke Calibrator.............................................................1232
Process Data Module ...................................................................................................1233

Process Data Principles...........................................................................................1234
Starting the Process Data Module...........................................................................1235
Start the Process Data Module...................................................................................... 1235
Working With Instrument Tags in the Process Data Module.................................1236
Create an Instrument Tag in the Process Data Module................................................. 1236
Open an Instrument Tag in the Process Data Module .................................................. 1236
Define Basic Process Data for an Instrument Tag ........................................................ 1237
Editing Instrument Process Data ............................................................................1238
Edit Instrument Process Data........................................................................................ 1238
Modifying Instrument Base Conditions..................................................................1239
Modify Base Conditions for an Instrument Tag ........................................................... 1239
Copying Instrument Process Data from Another Instrument .................................1241
Copy Instrument Process Data From Another Instrument............................................ 1241
Propagating Line Process Data to an Instrument Tag ............................................1242
Propagate Process Data From the Current Line to the Current Instrument .................. 1242
Propagate Process Data From Any Line to the Current Instrument.............................. 1242
Batch Propagation of Line Data to Instrument Tags ..............................................1243
Propagate Line Data to a Batch of Instrument Tags ..................................................... 1243
Setting the Line-to-Tag Filter .................................................................................1244
Select Line Properties ................................................................................................... 1244
Process Data for Differential Pressure Instruments................................................1245
Define Process Data for a Differential Pressure Instrument ......................................... 1245
Deleting Instrument Process Data ..........................................................................1246
Delete an Instrument Process Data Sheet ..................................................................... 1246
Calculating Physical Properties ..............................................................................1247
Calculate the Properties of a Selected Material ............................................................ 1247
Adding a New Line Type .......................................................................................1248
Add a Line Type ........................................................................................................... 1248
Editing a Line Type ................................................................................................1249
Edit a Line Type ........................................................................................................... 1249
Changing the Line Type .........................................................................................1250
Change the Type of a Selected Line ............................................................................. 1250
Deleting a Line Type ..............................................................................................1251

Table of Contents
Delete a Line Type........................................................................................................ 1251

Adding a New Line.................................................................................................1252
Add a New Line ............................................................................................................ 1252
Modifying Line Properties......................................................................................1253
Modify Line Properties ................................................................................................. 1253
Duplicate a Line............................................................................................................ 1253
Viewing Line Process Data ....................................................................................1254
View Line Process Data................................................................................................ 1254
Editing Line Process Data - Selecting Pipe Standards ...........................................1255
Editing Line Process Data - Fluid...........................................................................1256
Copying Line Data from One Line to Another.......................................................1257
Copy Line Data From One Line to Another ................................................................. 1257
Deleting Line Process Data ....................................................................................1258
Delete Line Process Data .............................................................................................. 1258
Line Fluid Velocity.................................................................................................1259
Multiple Process Data Cases ..................................................................................1260
Creating Process Data Cases ..................................................................................1261
Enable Cases for the Current Tag Or Line.................................................................... 1261
Add a Case for the Current Tag Or Line....................................................................... 1261
Setting a Governing Case .......................................................................................1262
Set a Governing Case.................................................................................................... 1262
Managing the Cases Supporting Table ...................................................................1263
Manage the Cases Supporting Table............................................................................. 1263
Deleting a Process Data Case .................................................................................1264
Delete a Process Data Case........................................................................................... 1264
Process Analyzers...................................................................................................1265
Flow of Activities for Complex Analyzers.............................................................1266
Managing Line Component Tables ........................................................................1267
Manage the Fluid Components Supporting Table ........................................................ 1267
Create A Line Components Table For The Current Line ............................................. 1267
Defining a Complex Analyzer ................................................................................1268
Define a Complex Analyzer.......................................................................................... 1268
Linking Analyzer Stream Components with Line Components.............................1269
Link Analyzer Stream Components With Line Components ....................................... 1269
Adding an Insulation Type .....................................................................................1270
Add a New Insulation Type .......................................................................................... 1270
Entering and Editing a Pipe or Orifice Material.....................................................1271
Edit Or Enter Additional Pipe/Orifice Materials .......................................................... 1271
Defining or Modifying Pipe Specs .........................................................................1272
Create a New Pipe Spec Or Modify an Existing One ................................................... 1272
Deleting Pipe Specs ................................................................................................1273
Delete a Pipe Spec ........................................................................................................ 1273
Setting the Default Units of Measure .....................................................................1274
Set the Default Units of Measure.................................................................................. 1274
API 2540 Standard for Liquid Density Calculation ...............................................1275
Calculate Liquid Density According to the API 2540 Standard ................................... 1275
Converting Engineering Units of Measure Automatically .....................................1276
Convert Engineering Units Automatically.................................................................... 1276

Table of Contents
Copying Default Units of Measure from Another <Unit> .....................................1277

Copy Default Units of Measure From Another <Unit>................................................ 1277
Importing Process Data Files..................................................................................1278
Import Instrument Process Data Files........................................................................... 1278
Import Line Process Data Files..................................................................................... 1279
Exporting Process Data Files..................................................................................1280
Export Instrument Process Data Files........................................................................... 1280
Export Line Process Data Files..................................................................................... 1281
Principles of Generating Process Data Reports ......................................................1282
Generating a Process Data Report for One Instrument or Line..............................1283
Generate a Process Data Report for the Current Instrument Or Line ........................... 1283
Generating Line Reports.........................................................................................1284
Generate Line Reports .................................................................................................. 1284
Generating Instrument Reports...............................................................................1285
Generate Instrument Reports ........................................................................................ 1285
Viewing and Editing Process Data Revisions ........................................................1286
Working with External Revisions...........................................................................1286
Work With External Process Data Revisions ............................................................... 1286
Viewing Process Data History................................................................................1288
View Process Data History ........................................................................................... 1288
Calculation Module: An Overview.............................................................................1290

Starting the Calculation Module.............................................................................1291
Start the Calculation Module ........................................................................................ 1291
Viewing and Editing a Calculation Item ................................................................1292
Open a Process Data Sheet for Calculation .................................................................. 1292
Fluid Definition ......................................................................................................1293
Define the Fluid ............................................................................................................ 1294
Performing Calculations .........................................................................................1295
Preparing for Flowmeter Calculation .....................................................................1296
Prepare for Flowmeter Calculation ............................................................................... 1296
Orifice Flowmeter Calculation ...............................................................................1297
Calculate Orifice Flowmeter Parameters ...................................................................... 1297
Tube Flowmeter Calculation ..................................................................................1299
Calculate Tube Flowmeter Parameters ......................................................................... 1299
Restriction Device Calculation ...............................................................................1301
Calculate the Restriction Device Parameters ................................................................ 1301
Calculating a Relief Valve......................................................................................1303
Calculate a Relief Valve ............................................................................................... 1303
Calculating a Relief Valve in Case of Fire .............................................................1305
Size a Relief Valve in Case of Fire ............................................................................... 1305
Calculating a Control Valve ...................................................................................1306
Calculate a Control Valve............................................................................................. 1306
Calculating a Thermowell.......................................................................................1309
Calculate the Maximum Permissible Thermowell Length............................................ 1309
Performing a Batch Calculation..............................................................................1310
Perform a Batch Calculation ......................................................................................... 1310
Calculating Multiple Cases.....................................................................................1312

Table of Contents
Calculate Multiple Cases .............................................................................................. 1312

Creating a Hybrid Case...........................................................................................1313
Create A Hybrid Case ................................................................................................... 1313
Principles of Generating Calculation Item Reports ................................................1314
Generating Calculation Item Reports .....................................................................1315
Generate a Calculation Item Report.............................................................................. 1315
Calculation Revisions .............................................................................................1316
Maintain Calculation Revisions.................................................................................... 1316
Creating New Tags in the Calculation Module ......................................................1317
Create a New Tag in the Calculation Module............................................................... 1317
Recommended Control Valve Characteristic .........................................................1318
Calculate the Recommended Control Valve Characteristic.......................................... 1318
Entering Built-Up Back Pressure - Relief Valve....................................................1319
Take Built-Up Back Pressure Into the Calculation Account ........................................ 1319
Dimensional Data for Piping Module.........................................................................1320

Principles of the DDP Module................................................................................1321
Starting the DDP Module .......................................................................................1322
Start the Dimensional Data for Piping Module............................................................. 1322
Preliminary Procedures...........................................................................................1323
Defining the Process Connection Class..................................................................1324
Define the Process Connection Class / Rating.............................................................. 1324
Defining the Connection End Preparation..............................................................1325
Define a Process Connection End Preparation ............................................................. 1325
Additional Settings .................................................................................................1326
Defining Dimensional Groups................................................................................1327
Define a Dimensional Group ........................................................................................ 1327
Defining Dimensional Group Properties ................................................................1328
Define Dimensional Group Properties.......................................................................... 1328
Duplicating a Dimensional Group ..........................................................................1329
Duplicate a Dimensional Group.................................................................................... 1329
Assigning Dimensional Data Forms.......................................................................1330
Assign a PSR File to a Dimensional Data Form........................................................... 1330
Assign a Dimensional Data Form to a Dimensional Group.......................................... 1330
Associating an Instrument Type with a DDP Group ..............................................1331
Associate an Instrument Type With a Dimensional Group .......................................... 1331
Managing Vendor Data...........................................................................................1332
Display and Access Vendor Data ................................................................................. 1332
Entering Vendor Data .............................................................................................1333
Enter Vendor Data Manually ........................................................................................ 1333
Entering Vendor Data .............................................................................................1334
Enter Vendor Data Manually ........................................................................................ 1334
Managing Working Data ........................................................................................1335
Display And Access Working Data .............................................................................. 1335
Editing Working Data.............................................................................................1336
Edit Working Data ........................................................................................................ 1336
Piping Design Area.................................................................................................1337
Enter the Piping Design Area ....................................................................................... 1337

Table of Contents
Copying Working Data to Default Data .................................................................1338

Copy Working Data to the Default Library .................................................................. 1338
Copying Default Data to Working Data .................................................................1339
Copy Default Data to Working Data ............................................................................ 1339
Copying from Vendor Data to Working Data ........................................................1341
Copy From Vendor Data to Working Data................................................................... 1341
Modifying Working Data Status.............................................................................1343
Modify Working Data Status ........................................................................................ 1343
Managing Default Dimensional Data .....................................................................1344
Entering Data into the Default Library...................................................................1345
Enter Default Data Into the Default Library ................................................................. 1345
Editing Default Data ...............................................................................................1346
Edit Default Dimensional Data ..................................................................................... 1346
Customizing the Default Library Display and Layout ...........................................1347
Generating a Dimensional Data Sheet....................................................................1347
Generate a Dimensional Data Sheet.............................................................................. 1347
Tracking the Data Status History............................................................................1348
Track the Working Data Status History........................................................................ 1348
Generating DDP Reports ........................................................................................1349
Generate A Suspected Data List, Status History, Or Suspected Data History Report.. 1350
Printing Dimensional Data Sheets ..........................................................................1351
Print Dimensional Data Sheets From the Dimensional Data for Piping Module Window1351
Print Dimensional Data Sheets From the Working Data Window ............................... 1351
Printing Empty Sheet Forms...................................................................................1352
Print Empty Sheets Forms ............................................................................................ 1352
SmartPlant Instrumentation and InfoMaker............................................................1353

SmartPlant Instrumentation Database Structure.....................................................1354
Enabling InfoMaker for SmartPlant Instrumentation Common Tasks...................1356
Create a SmartPlant Instrumentation Database Profile................................................. 1357
Display SmartPlant Instrumentation Data Automatically............................................. 1358
Display SmartPlant Instrumentation Data by Executing an SQL Statement ................ 1358
Define InfoMaker As the Default Report Generator .................................................... 1359
Working with Libraries and Reports Common Tasks ............................................1360
Create an InfoMaker Library ........................................................................................ 1361
Create an InfoMaker Library and Report for Editing PSR Files .................................. 1362
Open a PSR File from an InfoMaker Library and Report............................................. 1363
Save a Customized Report in InfoMaker...................................................................... 1363
Build a Query................................................................................................................ 1364
Create a New Browser for SmartPlant Instrumentation................................................ 1366
SmartPlant Instrumentation and MicroStation: An Overview...............................1368

System Requirements .............................................................................................1369
MicroStation Settings .............................................................................................1370
Define MicroStation Settings........................................................................................ 1370
Setting the SmartPlant Instrumentation Parameters for MicroStation SE/J ...........1372
Enable MicroStation SE/J to Work With Long File Paths............................................ 1372
Creating Tag Sets....................................................................................................1373

Table of Contents
Create Tag Sets ............................................................................................................. 1373

Exporting Tag Sets .................................................................................................1374
Export Tag Sets............................................................................................................. 1374
Importing Tag Sets .................................................................................................1375
Import a Tag Set ........................................................................................................... 1375
Linking a Tag to a Drawing Element .....................................................................1376
Link a Tag to a Drawing Element................................................................................. 1376
Creating a Cell Library ...........................................................................................1377
Create a Cell Library..................................................................................................... 1377
Fencing Elements for a Cell ...................................................................................1378
Fence Elements for a Cell ............................................................................................. 1378
Defining the Cell Origin .........................................................................................1379
Define the Cell Origin................................................................................................... 1379
Defining the Coordinates of the Cell Origin...........................................................1380
Define the Cell Origin Coordinates .............................................................................. 1380
Add a Cell to the Cell Library....................................................................................... 1380
Previewing a Cell....................................................................................................1381
Preview a Cell ............................................................................................................... 1381
Displaying a Cell on the Desktop ...........................................................................1382
Display a Cell on the Desktop ...................................................................................... 1382
Generating a Report Using MicroStation ...............................................................1383
SmartPlant Instrumentation KKS Overview............................................................1384

Requirements for Importing Line Data in KKS Mode ................................................. 1387
Propagation of KKS Names in SmartPlant Instrumentation ..................................1388
Example of KKS Naming Propagation......................................................................... 1389
Scope of KKS Issues for the Current SmartPlant Instrumentation Version...........1391
Rename an Item in KKS Mode...............................................................................1393
Import Utility: An Overview.......................................................................................1394

Database Platform Support .....................................................................................1395
Flow of Activities for Importing Data into SmartPlant Instrumentation................1396
Starting the Import Utility ......................................................................................1397
Link Groups: An Overview ........................................................................................1398

Managing Import Link Groups Common Tasks.....................................................1399
Create a Link Group...................................................................................................... 1400
Rename a Link Group................................................................................................... 1401
Rename a Link in the Link Explorer............................................................................. 1401
Rename a Link in the Import Link Window ................................................................. 1402
Prioritize Links in a Link Group................................................................................... 1403
Duplicate a Link in the Link Explorer .......................................................................... 1403
Duplicate a Link in the Import Link Window............................................................... 1405
Move Links to Another Group...................................................................................... 1406
Associate the Same Links with Several Groups ........................................................... 1406
Dissociate Links From a Group .................................................................................... 1407
Delete Links .................................................................................................................. 1407
Delete a Link Group...................................................................................................... 1408

Table of Contents
Import Links: An Overview........................................................................................1409

Moving Links Between Databases or Domains: An Overview..............................1411
Defining Import Links Common Tasks..................................................................1412
Create an Import Link for an ODBC Source ................................................................ 1413
Create an Import Link for an Oracle Source................................................................. 1415
Create an Import Link for a File Source ....................................................................... 1416
Define a Data Import Source in Excel Spreadsheets .................................................... 1417
Prerequisite for Using Microsoft Access as an Import Source ..................................... 1418
Using the Link Explorer Window................................................................................. 1418
Change Link Source Paths ............................................................................................ 1419
Specify a New Default Folder for All Links................................................................. 1420
Export a Group of Links ............................................................................................... 1420
Import Links ................................................................................................................. 1421
Link Properties: An Overview................................................................................1422
Defining Import Link Properties Common Tasks ..................................................1423
Open Link Properties .................................................................................................... 1425
Set Properties for Handling Mismatched Data ............................................................. 1426
Set Import Mode Parameters ........................................................................................ 1426
Specify a Filtering Condition........................................................................................ 1428
Enable Reference Tables for Import ............................................................................. 1430
Set the Tag/Loop Parameters ........................................................................................ 1431
Set Custom Parameters (Import to Module Only) ........................................................ 1432
Set Column Display for the Module Import Method .................................................... 1434
Refresh Previously Imported Data................................................................................ 1434
Viewing the Source Data ........................................................................................1436
Working with Source Data .....................................................................................1437
View the Source Data ................................................................................................... 1438
Select the Desired Viewing Option............................................................................... 1438
Filter the Displayed Source Data Fields ....................................................................... 1438
Sort the Displayed Source Data Fields ......................................................................... 1439
Associate Additional Source Data ................................................................................ 1439
Built-In Operators and Functions.................................................................................. 1441
SQL Functions Native to Source Database................................................................... 1442
Primary Keys and Primary Values: An Overview..................................................1444
Map Source and Target Fields Common Tasks......................................................1446
Define Links for Naming Conventions......................................................................... 1447
Open Import Links........................................................................................................ 1448
Define the Import Mapping .......................................................................................... 1449
Configure Source Data for Variable Length Data Fields.............................................. 1451
String Operators in Import Links.................................................................................. 1452
Formulas and Arithmetic Functions in Import Links.................................................... 1453
Tag Class Mapping Codes for Instrument Index Import .............................................. 1454
Process Function Mapping Codes for Instrument Index Import................................... 1456
Fluid State Mapping Codes for Process Data Import ................................................... 1457
Mapping Codes for Wiring Data Import....................................................................... 1458

Table of Contents
Import Comparison .....................................................................................................1462

Setting the Import Comparison List Options..........................................................1463
Setting the Target Table Definitions: An Overview...............................................1464
Comparison Options Common Tasks.....................................................................1469
Modify Table Column Definitions................................................................................ 1470
Delete Table Column Key Definitions.......................................................................... 1477
View the Source and Target Rows................................................................................ 1478
Filter the Displayed Target Rows ................................................................................. 1478
Preview and Print the Source and Target Rows............................................................ 1479
Import Data Using the Comparison List ....................................................................... 1479
System Codes: An Overview..................................................................................1481
Working with System Codes Common Tasks ........................................................1482
Define Source Systems ................................................................................................. 1483
Adapt System Codes ..................................................................................................... 1484
Adapt UOM Codes ....................................................................................................... 1485
Adapting UOM Codes - Special Characters ................................................................. 1486
Import Codes................................................................................................................. 1487
Export Codes................................................................................................................. 1487
View the Currently Selected Source System Name...................................................... 1488
Use Source Codes in an Import Link ............................................................................ 1488
General Import Prerequisites ..................................................................................1489
Matching Naming Conventions..............................................................................1490
Importing Data Common Tasks..............................................................................1491
Data Import Process...................................................................................................... 1492
Test the Import Process................................................................................................. 1493
Run an Import Session from the User Interface............................................................ 1494
Run an Import Session from the Command Line ......................................................... 1495
Execute the Import of Data ........................................................................................... 1496
Execute the Import of Data ........................................................................................... 1497
Importing Data into Multiple Plant Hierarchy Items or Projects ...........................1498
Importing Data into Multiple Plant Hierarchy Items or Projects Common Tasks .1500
Import Data Into Multiple Plant Hierarchy Items ......................................................... 1500
Import Data into Several Projects ................................................................................. 1501
Importing Instrument Index Common Tasks..........................................................1503
Prerequisite for Importing Instrument Types................................................................ 1506
Enable Creation of Complementary Elements for Instrument Index............................ 1507
Set Source Fields as Instrument Type Fields ................................................................ 1508
Associate Source Fields with Existing Instrument Types............................................. 1510
Associate Tag Numbers with Correct Instrument Type Descriptions .......................... 1511
Import Instrument Index ............................................................................................... 1512
Import Instrument Properties ........................................................................................ 1514
Example of Concatenated Sources................................................................................ 1515
Creating Specifications by Data Import Common Tasks .......................................1516
Create Specs Using the Module Import Method........................................................... 1517
Create Specs Using the Single Table Import Method................................................... 1519
Create a Multi-Tag Spec by Data Import...................................................................... 1521

Table of Contents
Importing Revisions................................................................................................1523
Import Revisions........................................................................................................... 1524
Import Process Data and Calculation Sheet Revisions ................................................. 1525
Working with Log Files: An Overview ..................................................................1527
Working with Log Files Common Tasks................................................................1528
Create a New Log File .................................................................................................. 1529
Open an Existing Log File ............................................................................................ 1529
View the Current Log File ............................................................................................ 1530
Check the Name of the Current Log File...................................................................... 1530
Close the Current Log File............................................................................................ 1530
Delete an Existing Log File .......................................................................................... 1531
Log the Import Parameters............................................................................................ 1531
Common Error Messages.............................................................................................. 1532
System Codes Table...................................................................................................... 1537
Unit of Measure Codes Table ....................................................................................... 1547
SmartPlant Electrical Interface: An Overview.........................................................1556

Prerequisites for Working with the SmartPlant Electrical Interface ......................1557
Flow of Activities for Creating Control Systems ...................................................1559
Retrieve SmartPlant Electrical Data ............................................................................. 1561
Create Electrical Tags ................................................................................................... 1562
Viewing Electrical Tag Numbers ...........................................................................1563
Associate Electrical Signals with Equipment ............................................................... 1564
Create Wiring Items for SmartPlant Electrical Signals................................................. 1565
Create a Device Panel for an Electrical Tag ................................................................. 1566
Create a Local Signal for Electrical Tags ..................................................................... 1567
Flow of Activities for Defining Power Supplies ....................................................1568
Publish Data for SmartPlant Electrical ......................................................................... 1569
DCS Vendor Interfaces................................................................................................1571

Overview.................................................................................................................1571
SmartPlant Instrumentation - DCS Vendors: Comparative Terminology .................... 1572
Prerequisites for Working with DCS Vendor Interfaces ........................................1573
Configure SmartPlant Instrumentation to Publish and Retrieve Data in File Mode..... 1575
Flow of Activities for Configuring DeltaV ............................................................1576
Data Limitations for the DeltaV Interface .................................................................... 1578
Retrieve DeltaV Definitions ......................................................................................... 1582
Retrieve DeltaV Data.................................................................................................... 1583
Crucial Fields for the DeltaV Interface......................................................................... 1585
Publish Data for DeltaV................................................................................................ 1588
Flow of Activities for Configuring Yokogawa CENTUM CS 3000......................1590
Data Limitations for the Yokogawa CENTUM CS 3000 Interface .............................. 1592
Retrieve Yokogawa CENTUM CS 3000 Definitions ................................................... 1594
Retrieve Yokogawa CENTUM CS 3000 Data ............................................................. 1595
Publish Data for Yokogawa CENTUM CS 3000 ......................................................... 1596
Retrieving ABB Definitions ...................................................................................1597
Retrieve ABB Definitions............................................................................................. 1597
Retrieving Honeywell Definitions..........................................................................1598
Retrieve Honeywell Definitions ................................................................................... 1598

Table of Contents
General DCS Vendor Activities .............................................................................1599

Associate Device Types for DCS Vendors ................................................................... 1599
View the Log File for a DCS Vendor ........................................................................... 1601
NE-100 Interface: An Overview .................................................................................1602

NE-100 Interface Common Tasks ..........................................................................1602
Activate the NE-100 Interface Menu Commands......................................................... 1603
Map NE-100 Attributes to SmartPlant Instrumentation Specs Form............................ 1604
Publish SmartPlant Instrumentation Spec Data to NE-100........................................... 1605
Retrieve NE-100 Data to SmartPlant Instrumentation Specs ....................................... 1605
Working with SmartPlant Integration.......................................................................1606

Overview.................................................................................................................1606
Updating SmartPlant Information in Title Blocks..................................................1609
Updating SmartPlant Information in Title Blocks: Flow of Activities...................1610
Title Block Requirements for Integration Reports .................................................1611
PowerSoft Reports ........................................................................................................ 1611
Enhanced Reports ......................................................................................................... 1612
Associating a Custom Title Block with SmartPlant Instrumentation ........................... 1613
Open a Custom Title Block........................................................................................... 1614
Installing and Configuring Software for Generating PDF Files.............................1615
Configure the Generic PostScript Printer...................................................................... 1616
Configure Adobe Acrobat Distiller 7............................................................................ 1620
Test the PostScript Printer Configuration ..................................................................... 1622
Test the Acrobat Distiller Driver Configuration ........................................................... 1624
Install the Update Title Block Component for SmartPlant Instrumentation................. 1626
Schema Mapping: An Overview.................................................................................1627

General Information About Schema Mapping .......................................................1628
Upgrading the SmartPlant Instrumentation Tool Schema for a New Software Version1630
Upgrade the SmartPlant Instrumentation Tool Schema................................................ 1630
Workflow for Extending the Schema .....................................................................1631
Modify the Tool Schema for a Custom Plant Hierarchy............................................... 1632
Synchronizing Schemas..........................................................................................1640
Synchronize the Map Schema File with the Tool Schema ........................................... 1641
Define a Schema for SmartPlant Instrumentation......................................................... 1646
Export a New Schema Configuration ........................................................................... 1648
Define and Map DDP Data ........................................................................................... 1649
Welcome to the SmartPlant Instrumentation Schema Configuration Wizard............... 1650
Select Domain............................................................................................................... 1650
Schema Options ............................................................................................................ 1650
Define New Schema Configuration .............................................................................. 1650
Select Schema ............................................................................................................... 1650
Select Document Type.................................................................................................. 1651
Select Object Types ...................................................................................................... 1651
Define Object Levels and Restrictions.......................................................................... 1651
Define Filter Condition ................................................................................................. 1651
Select Object Interfaces ................................................................................................ 1651

Table of Contents
Select Interface Properties ............................................................................................ 1652

Completing the Schema Configuration Wizard ............................................................ 1652
Export Schema Configuration Utility.....................................................................1653
Publishing in an Integrated Environment: An Overview .......................................1654
Publish Documents from SmartPlant Instrumentation.................................................. 1657
Find Documents to Publish from SmartPlant Instrumentation ..................................... 1660
List of Publishable Dimensional Groups ...................................................................... 1662
Revising Documents in an Integrated Environment: An Overview........................1665

Revise a Document .................................................................................................1666
Retrieving in an Integrated Environment: An Overview........................................1668
Retrieve Documents to SmartPlant Instrumentation..................................................... 1670
Using the To Do List: An Overview.......................................................................1673
To Do List Common Tasks.....................................................................................1674
Set Preferences for the To Do List................................................................................ 1675
Open the To Do List ..................................................................................................... 1675
Modify To Do List Task Properties .............................................................................. 1676
Run a Task from the To Do List ................................................................................... 1676
Task Dependencies ....................................................................................................... 1678
Complete a Task from the To Do List .......................................................................... 1678
Sort Tasks in the To Do List ......................................................................................... 1679
Filter Tasks in the To Do List ....................................................................................... 1679
Defer a Task from the To Do List................................................................................. 1680
Remove a Task from the To Do List ............................................................................ 1680
Display Deleted Tasks in the To Do List...................................................................... 1680
Run a To Do List Report............................................................................................... 1681
Update the To Do List Display ..................................................................................... 1681
Merger Utility: An Overview......................................................................................1682

Database Platform Support .....................................................................................1683
Configuring Your Environment..............................................................................1684
Start the Merger Utility................................................................................................. 1684
Working with Log Files..........................................................................................1686
Setting the Merger Comparison Criteria.................................................................1687
Preparing to Merge Data: Common Tasks .............................................................1689
Create a New Log File .................................................................................................. 1689
Open an Existing Log File ............................................................................................ 1690
View the Current Log File ............................................................................................ 1690
Close the Current Log File............................................................................................ 1690
Delete an Existing Log File .......................................................................................... 1691
Merging Data: An Overview ..................................................................................1692
Merger Session: Common Tasks ............................................................................1694
Select the Target Item ................................................................................................... 1694
Create a New Merger Session....................................................................................... 1695
Open a Merger Session ................................................................................................. 1695
Rename a Merger Session............................................................................................. 1695
Duplicate a Merger Session .......................................................................................... 1696
Delete a Merger Session ............................................................................................... 1696
Selecting the Source Domain: An Overview ................................................................ 1697

Table of Contents
Selecting and Matching Source Domains: Common Tasks ...................................1698

Select the Same Source Domain As the Target Domain............................................... 1699
Select a Source Domain from an ODBC Database....................................................... 1700
Select a Source Domain From a Database Other Than ODBC..................................... 1701
Match the Source Projects to the Target Projects ......................................................... 1702
Match the Source Data with the Target Data ................................................................ 1702
Match Source And Target Naming Conventions.......................................................... 1703
Defining Merger Utility Settings: Common Tasks ....................................................... 1705
Define Merger Utility Settings...................................................................................... 1708
Select the Source Modules and Module Data ............................................................... 1709
Select the Source Tables to Be Merged ........................................................................ 1711
Select the Source Item Types to Merge ........................................................................ 1711
Specify an Insertion Condition ..................................................................................... 1712
Filter And Sort the Displayed Source Table List.......................................................... 1714
Selecting Source Data Using the Comparison List: Overview.................................1715

Selecting Source Data Using the Comparison List Common Tasks ......................1716
Define Comparison List Options .................................................................................. 1719
Define a Comparison List Style.................................................................................... 1720
Compare Source And Target Data ................................................................................ 1721
Compare Data Using Group Mode ............................................................................... 1723
Check for Duplicate Items ............................................................................................ 1726
Restore a Saved PSR File ............................................................................................. 1727
Run the Comparison List by Making an Individual Item Type Selection .................... 1727
Filter the Comparison List Data.................................................................................... 1728
Display Specific Data Columns in the Comparison List .............................................. 1729
Sort the Comparison List Data...................................................................................... 1729
Display the Comparison List for a Child Item Type..................................................... 1730
Start the Transfer Process ............................................................................................. 1731
Perform A Preliminary Configuration .......................................................................... 1732
Running the Comparison List in Multi-Sessions....................................................1733
Analyzing Comparison Reports..............................................................................1735
Merging Supporting Tables ....................................................................................1737
Guidelines for Selecting Item Types and Defining Merger Settings......................1738
Merging Jumpers and Cross Wires.........................................................................1746
Merging Specification Forms that Include Custom Title Blocks ...........................1747
Customizing the Comparison List Display.............................................................1748
Post Merging Actions .............................................................................................1749
Index..............................................................................................................................1750

Preface
Preface
This user's guide describes concepts, procedures, and interface features of SmartPlant
Instrumentation.
Send documentation comments or suggestions to PPMdoc@intergraph.com.

1

Working with SmartPlant Instrumentation: An Overview
Working with SmartPlant Instrumentation: An

Overview
SmartPlant® Instrumentation powered by INtools® is a Windows-based program that
helps you to design and maintain every stage in the life-cycle of plant engineering
systems, from construction, through maintenance and modernization, to de-
commissioning.
This guide provides instructional, procedural, and reference material to help you get
the most from SmartPlant Instrumentation. Use it to learn the basics and later as a
reference to perform specific tasks.
SmartPlant Instrumentation is a straightforward, menu-driven program whose

functions and modules are readily accessible from the menu and toolbars.
SmartPlant Instrumentation includes the following components:
• The Administration module, which provides all of the options required to

define the administrative and security functions of the software. These
options include defining access rights, managing preferences, creating the
working environment, assigning managers, tag convention definitions,
plant hierarchy item definitions, and so forth.
• SmartPlant Instrumentation Domain Explorer, which allows you to
organize instrumentation items, easily navigate to them, and perform
appropriate actions.
• The main SmartPlant Instrumentation Modules, which enable you to
perform a wide variety of engineering activities.
The following utilities enable the transfer of external data into the SmartPlant
Instrumentation database:
• The Import Utility provides the means to import data into SmartPlant
Instrumentation from the most common database file formats such as
Microsoft Access, DBF files, Oracle, SQL Server, Sybase Adaptive Server
Anywhere, ASCII delimited files, and other ODBC compatible files.
• The Merger Utility provides the means of merging the data of either two
<units> or two <plants> for the purpose of creating one common database
for either the two <units> or the two <plants>.
Related Topics
• Getting Started Common Tasks, page 48

User Assistance
SmartPlant Instrumentation user assistance supplies command information as you
perform tasks. You can access different kinds of information any time you are
running the software. This information could include reference topics, narrative
descriptions or overviews.
SmartPlant Instrumentation offers the following important user assistance features:
Installation Guide — This document provides you with step-by-step procedures for
installing SmartPlant Instrumentation on Oracle or SQL Server database platforms, or
on Sybase Adaptive Server Anywhere. It also contains important configuration
information, useful tips, and troubleshooting advice. The Installation Guide is
presented in the .pdf file format and can easily be printed out. Adobe Reader,
required for the .pdf files, is available from the SmartPlant Instrumentation
installation CD or from the Internet.
User's Guide — This document provides you with detailed information on

SmartPlant Instrumentation Explorer and each SmartPlant Instrumentation
module, along with recommended settings, examples, and useful tips. Also included
in the User Guide are documents which deal with the usage of SmartSketch,
AutoCAD, and MicroStation CAD interfaces and of InfoMaker and Microsoft Access
report generators in SmartPlant Instrumentation.
Tutorial — The tutorial helps novice users acquire the skills necessary to start using
SmartPlant Instrumentation, create a minimal setup for your plant, and all the basic
instrument engineering activities for each module. You will acquire the fundamental
understanding, skills, and practical experience that you need to use the software with
confidence. The tutorial is presented in the .pdf file format and can easily be printed
out. Adobe Reader, required for the .pdf files, is available from the SmartPlant
Instrumentation installation CD or from the Internet.
Online Help — SmartPlant Instrumentation Online Help provides conceptual

overviews and procedures to help you to work efficiently with the software, as well as
context-sensitive help for all windows and dialog boxes. Each context-sensitive help
topic provides accurate reference information for the displayed window or dialog box.
To access context-sensitive help for an open window, do one of the following:
• On the Help menu of any SmartPlant Instrumentation module, click

SmartPlant Instrumentation Help.
• On the toolbar, click the Help icon .

User Interface Features — The user interface provides you with several ways to
see command descriptions:
• ToolTips help you find command names. When you pause the pointer on a
toolbar icon, a yellow label displays the command name.
• Microhelp messages that appear at the bottom of the window inform you
about the command you are going to execute. Pointing to a toolbar icon or
selecting a menu option displays a brief message on the status bar.
Technical Support — Intergraph provides extensive technical support all over the
world. To find out how to get technical support, click About SmartPlant
Instrumentation on the Help menu and then click the Tech Support button.

Online Help Text Conventions

Special Displays
The following displays are used for features designed to capture your attention, such
as warnings, important notes, and useful tips.
Caution
• Indicates a caution to which you should pay attention.
Important
• Important information which supplements the main text.
Note
• General information which supplements the main text.
Tip
• Indicates a tip, pointing out a useful feature which makes life easier for the
user.
Keyboard Conventions
Common functions of some keys are described below:
Keys Example / description

Shortcut keys Combinations of keys can be used as shortcuts. For example, Ctrl
+ F1 means hold down the Control key while pressing F1.
Tab In windows and dialog boxes, pressing the Tab key activates the
next field or command button. To activate the previous item, hold
down the Shift key while pressing the Tab key.
Enter In most windows and dialog boxes, pressing this key is equivalent
to clicking the OK or Save command buttons.
Escape In most windows and dialog boxes, pressing this key is equivalent
to clicking the Cancel command button.
Home, End, Page
Up, Page Down
Arrow keys Use these keys to move between fields in data tables.
Numeric keypad If you have an extended keyboard, you can type numbers with the
numeric keypad if you press Num Lock key to turn the Num Lock
indication on.

Mouse Conventions
The left mouse button is the one referred to, unless otherwise stated.
To Do this
Point Position the pointer on an item.
Click Point to an item, then quickly press and release the mouse button.
Double- Point to an item, then quickly press and release the mouse button twice.
click
Drag Point to an item, and while holding down the mouse button on the item,
move the item to a new location. When the pointer is at the desired
location, release the mouse button.

Getting Started Common Tasks

The following general tasks are used when getting started:
Start SmartPlant Instrumentation

This procedure explains how to log on to SmartPlant Instrumentation. where to select
the required domain and if the domain type is Operating owner, your project. After
this, you navigate to the <unit> you are going to work in. Clicking OK on the Open
dialog box brings you to the SmartPlant Instrumentation environment. For more
information, see Start SmartPlant Instrumentation, page 49.
Open a Different Domain

This procedure shows you how you can move from working in the current domain to
a different one. For more information, see Open a Different Domain, page 50.
Change the Logon Password

This option allows you to change the password that you use when logging on to
SmartPlant Instrumentation. For more information, see Change the Logon Password,
page 51.
Switch to a Different Unit

This option makes it possible to switch from the current <unit> to another <unit>.
For more information, see Switch to a Different Unit, page 51.
Open a Module
You can open any SmartPlant Instrumentation module whether or not other modules
are already open. Access to a particular module is subject to your having appropriate
access rights. For more information, see Open a Module, page 52.

Start SmartPlant Instrumentation

When starting SmartPlant Instrumentation, a splash screen appears, showing the
current version number, followed by the Logon Information dialog box, where you
select the required database and enter your user name and password. After logging
on to SmartPlant Instrumentation, the software displays the Open dialog box, where
you select the desired domain and where the domain type is Operating owner, your
project. After this, you navigate to the <unit> you are going to work in. Clicking
OK on the Open dialog box brings you to the SmartPlant Instrumentation
environment.
Important
• Access to SmartPlant Instrumentation modules is available only after the
System Administrator has created a domain and the Domain Administrator
has set up its resources. See the initialization section appropriate for your
database platform (that is, Oracle, SQL Server or Sybase Adaptive Server
Anywhere) for details.
• User names and passwords are not case-sensitive. The software displays
the password as asterisks.
• If you purchased SmartPlant Instrumentation with an evaluation license,
there is no limit of the number of times that you can log on to SmartPlant
Instrumentation before the expiration date of the license, however after
that date, you will be denied access to SmartPlant Instrumentation.
Related Topics
• Navigating in SmartPlant Instrumentation, page 49
• Working with SmartPlant Instrumentation: An Overview, page 43
Navigating in SmartPlant Instrumentation

You access SmartPlant Instrumentation items using the SmartPlant
Instrumentation Explorer.
Also, you perform various action from SmartPlant Instrumentation modules using the
menu items or clicking the appropriate toolbar icons in the main SmartPlant
Instrumentation window. A number of other options are available when you are in
this window. The window itself consists of the following areas:
Menu bar — The menu bar contains access to all the actions you will perform in
the module, and also to standard Windows features such as window layouts and
Online Help.
Toolbar — The application toolbar provides you with quick access to each module.
The module toolbars enable you to access the most common actions for the modules.

Application work area — The central region where the main module window
appears.
Status bar — The status bar provides you with quick access to information on the
selected icon or menu item (microhelp) or the status of a particular process (for
example, exporting data). In addition, it shows the plant hierarchy items and the
current date and time.
Related Topics
• Open a Different Domain, page 50
• Switch to a Different Unit, page 51
• Working with the SmartPlant Instrumentation Explorer: An Overview,
page 216
Open a Different Domain

1. Close all SmartPlant Instrumentation modules that are open.
2. Click File > Open.
3. On the Open dialog box, select a domain .
4. If the project icon appears (only when the domain type is Operating owner),
double-click the icon to select the project you want to work with (As-Built or a
project).
5. Navigate to a desired <unit> by double-clicking the <plant> and <area>
icons to expand the view and display the <units>.
6. Select a <unit> by doing one of the following:
• Double-click the <unit> icon.

• Click the <unit> once to highlight it, then click OK.
Related Topics
page 216

Change the Logon Password

Important
• The System Administrator has rights to set logon passwords for SmartPlant
Instrumentation users and is able to override any password changes made
by other users. Therefore, after changing the password, you must inform
the System Administrator of such a change.
• Changing SmartPlant Instrumentation logon passwords does not apply to
users who log on to the software using Windows authentication logon
method.
1. Click File > Change Password.
2. In the Current password field, type your current logon password.
Tip
• Passwords appear masked.
3. In the New password field, type the new password.
Tip
• You can use alphanumeric values in either upper or lower case. The
maximum length of your password can be 15 characters.
4. In the Confirm new password field, retype the new password.
5. Click OK.
Related Topics
Switch to a Different Unit

1. Close all SmartPlant Instrumentation modules that are open.
2. Click File > Open.
3. On the Open dialog box, expand the <plant> and <area> hierarchies and
navigate to the <unit> you require.
4. Select a <unit> by doing one of the following:
• Double-click the <unit> icon.

• Click the <unit> once to highlight it, and then click OK.
Related Topics

Open a Module
1. Start SmartPlant Instrumentation.
2. Do one of the following:
• Click the appropriate toolbar icon for the module you want to open.
• On the Modules menu, click a desired module name.
Related Topics
page 216

Setting General Preferences Common Tasks

The following tasks are used frequently when setting general preferences:
Display and Customize Preferences

Use this procedure to display the default preferences or set your own preferences in
SmartPlant Instrumentation. Your preference settings do not affect the preferences
that were defined by other users in the current domain or working in the current
project, if the domain type is Operating owner. For more information, see Display
and Customize Preferences, page 53.
Preferences Governed by the .INI File

Use this topic discusses the various preference settings that you can make in the
Intools.ini file. For more information, see Preferences Governed by the .INI File,
page 54.
Display and Customize Preferences

Important
• Domain Administrators have additional options that allow preferences
management from the Administration module.
• Certain interface options are governed by the INTOOLS.INI file. For more
information, see Preferences Governed by the .INI File, page 54.
1. Click File > Preferences.
2. In the tree view, beside a desired module, click to expand the hierarchy.
3. Click an option to open a specific page where you can view or customize
preferences.
Note
• The Domain Administrator can restrict the ability of other users to set their
preferences. Therefore, you may find that you can only view certain
options but not change their values.
Related Topics
• Setting General Preferences Common Tasks, page 53


intools.ini
X and Y Positions of Certain Windows and Dialog Boxes — If you move a
certain window or dialog box in the screen area, the software saves the X and Y
positions of the window or dialog box in the Intools.ini file under the [Project]
section. This only applies to a small number of windows and dialog boxes.
The ID of the <Unit> Selected Last — When you select a specific <unit> on the
Open dialog box, the software records the <unit> ID in the Intools.ini file under the
[Project] section. The next time you start SmartPlant Instrumentation and display the
Open dialog box, the software displays the <unit> you selected last.
Filter Setting — When you specify a filter setting such as a data range, and then
restart the software, the software updates the date range in every SmartPlant
Instrumentation module in which you use the same filter.
Document Number and Revision Level Segregation — In the Instrument Index

Standard Browser, when you make a document revision in one <unit> and then log
on to another <unit>, both <units> share the same document number and set of
revisions. To specify a separate document number and set of revisions for the current
<unit>, open the Intools.ini file, and under the [Index] section, type the following
line:
DrawingPerLevel = Y
This setting is needed if, for example, you are publishing documents from different
<units>.
Suppression of Loop Equipment Propagation to Tag Numbers by Default —

When you create a new loop, you can specify whether to apply the P&ID, service,
and equipment to tag numbers. By default, these options are selected; however, you
can specify not to propagate these values to tag numbers that you subsequently
associate with the loop. To do so, open the Intools.ini file, and under the [Index]
section, type the following line:
LoopNoPropagateCheck = 1
This setting prevents the software from removing the equipment reference from tag
numbers that you associate with a loop that has no equipment reference.
Performance when Generating Enhanced Reports — Sometimes, the response

time between the application server and the database server is very slow when
generating enhanced reports. To improve this performance, open the Intools.ini file,
and under the [Loop] section, change the value of the DDETimeOut parameter to
20000. This parameter has units of milliseconds.

smartloop.ini
Hiding Macro Entities when Generating Enhanced Reports — If, for a default
macro such as a panel name, you define a filter that hides a particular macro, a dot
appears in place of the macro. The dot is needed to allow editing of the macro filter,
adding new macros to the item associated with the hidden macro, or editing of the
item. If you want to hide the dots, for example when printing the report or saving it
in a different format, you need to define the parameter HideItems = Y in the
Smartloop.ini file.
Related Topics

Searching for Tag and Loop Numbers: An Overview
Searching for Tag and Loop Numbers: An

Overview
SmartPlant Instrumentation provides you with several options to find the tag and loop
numbers that you require to work with.
You can look for your tag and loop numbers in the SmartPlant Instrumentation
Explorer or you can use the search facilities provided in the pertinent modules. For
more information, see Search for Items in SmartPlant Instrumentation Explorer, page
257.
While working in a module, you can search for tag or loop numbers in different ways.
You can enter search parameters and find tag or loop numbers that match the search
parameters that you specified. If you do not specify any search parameters, the
software finds all the existing tag or loop numbers in the current <unit>. In the
Process Data and Calibrations modules, you can search for tag numbers either in the
current <unit>, or in all the <units> of the current <plant>. You can also look for
typical tags created in the current domain.
You search for tag numbers in the Find Tag dialog box. There are many cases where
the software opens the Find Tag dialog box. You can look for tag numbers after
clicking Find in dialog boxes that prompt you to enter a tag number. Also, you can
look for tag numbers when opening a process data sheet, when editing, duplicating, or
deleting a tag number, or when calculating or calibrating tag numbers, and so forth.
You search for loop numbers in the Find Loop dialog box. The software opens the
Find Loop dialog box whenever you need to search for a loop number. There are
many cases where the Find Loop dialog box opens: clicking Find in a dialog box
that prompts you to enter a loop number opens the Find Loop dialog box. For
example, you can click Find when you want to edit or duplicate one or more loop
numbers in the Instrument Index module.
Related Topics
• Search for Items in SmartPlant Instrumentation Explorer, page 257
• Searching for Tag and Loop Numbers Common Tasks, page 57

Searching for Tag and Loop Numbers Common

Tasks
The following tasks are used frequently when searching for tag or loop numbers:
Search for All Tag Numbers

This topic explains how to find all the existing tag numbers in the current <unit>. In
the Calibration and Process Data modules, you can search for tag numbers in all the
<units> of the current <plant>. In the Process Data module, you can find tag
numbers in all units when searching for tag numbers to generate instrument reports.
For more information, see Search for All Tag Numbers, page 58.
Search for Typical Tags

This help topic explains how to find all the existing typical tag numbers in the current
domain. For more information, see Search for Typical Tags, page 61.
Use Search Parameters to Find Tag Numbers

This help topic explains how to find tag numbers by entering search parameters.
Entering search parameters in the Find Tag dialog box enables you to narrow down
your search. You can narrow your search to the maximum by entering all the search
parameters. It is up to you what search parameters to specify. You can use wildcards
in the fields where you type values.
Leaving some of the Search parameter fields empty widens the search. If you do
not specify any search parameters, the software finds all the existing tag numbers.
After the search is complete, the software displays the tag numbers that match your
search parameters in the Search results data window.
For more information, see Use Search Parameters to Find Tag Numbers, page 59.
Search for All Loop Numbers

This topic explains how to find all the existing loop numbers in the current <unit>.
For more information, see Search for All Loop Numbers, page 62.

Use Search Parameters to Find Loop Numbers

This help topic explains how to find loop numbers by entering search parameters.
Entering search parameters in the Find Loop dialog box enables you to narrow down
your search. You can narrow your search to the maximum by entering all the search
parameters. Leaving some of the Search parameter fields empty widens the search.
It is up to you which search parameters to specify. If you do not specify any search
parameters, the software finds all the existing tag numbers in the current <unit>.
Note that you can use wildcards in the fields where you type values.
After the search is complete, the loop numbers that match your search parameters are
displayed in the Results data window.
For more information, see Use Search Parameters to Find Loop Numbers, page 62.
Search for Typical Loops

This help topic explains how to find all the existing typical loops in the current unit.
For more information, see Search for Typical Loops, page 64.
Related Topics
• Searching for Tag and Loop Numbers: An Overview, page 56
Search for All Tag Numbers

1. In the Find Tag dialog box, do not enter any other values in the Search
parameter fields.
Tip
• In the Calibration or Process Data module, select Look in the entire
current plant if you want to find tags in all the <units> of the current
<plant>.
2. Click Find.
Tip
• Select the Show more search results check box to hide the search
parameter fields and enlarge the Search results data window to
display more tag rows. Clear this check box to return to normal view.
3. Select the required tag numbers in the Search results data window and click OK.
Related Topics

Use Search Parameters to Find Tag Numbers

Important
• To specify search parameters in the Calibration module, you need to
perform a separate procedure.
1. In the Find Tag dialog box, from the Tag class list, select the desired tag class.
Tip
• A conventional tag is an instrument that does not belong to the
Fieldbus, Telecom, Typical, or Electrical classes.
2. Use the following fields and lists in the Search parameters group box for search
parameters that narrow your search:
Search Explanation Example
Parameter
Tag Number Type the whole tag number you are looking for. 101-FT – 2225/1
Include any prefix, suffix, and separator
characters. You can use wildcards if needed. Or use a wildcard:
101-FT%
Process Select a process function to narrow your search Flow
function to tags belonging to the selected process Pressure
function.. (This parameter is available in the
Instrument Index and Process Data modules
only.)
Instrument Select an instrument type to narrow your search D/P Type Flow
type to tags belonging to the selected instrument Element (FE), Mass
type. Flow Transmitter
(FT)
Status Select a tag status to narrow your search to tags An existing device,
associated with the selected status. a new instrument, a
relocated device
Location Select a tag location, for example, Field, to Equipment room,
narrow your search to tags for which you have junction box
defined this location.
I/O type Select a I/O type to narrow your search to tags AO (analog output)
for which you have defined this I/O type. DI (Digital input)
Prefix Type the tag number prefix to find all the tag 101
numbers that have this prefix in their names. Do
not include the separator characters. The <unit>
number segment in the tag number name is
usually the tag number prefix. You can also use
wildcards if needed.


Parameter
Number Type the numeric segment of a tag number to 2315
find all the tag numbers that have this numeric
segment. You can also use wildcards if needed.
Suffix Type the suffix segment of the tag number to 1 ( the number
find all the tags that contain this suffix. Do not following the slash (
type the slash ( / ) character. You can also use / ) in tag number
wildcards if needed. 101-FT – 2225/1)
Equipment Select equipment to narrow your search to tags
for which you have defined this equipment.
Line Select a line to narrow your search to tags with
which you have associated this line. (This
parameter is not available in the Process Data
and Specifications modules.)
Form Select a specification form number to narrow
number your search to tags for which you have defined
this form number. (This parameter is available
in the Specifications module only.)
Date range Type dates or use spinners to narrow your
search to a given date range. (This parameter is
available in the Specifications module only.)
3. To broaden the search to include all of the <units> in a given <plant>, select
Look in the entire <plant>.
Tip
• This field is available in the Calibration module, and in the course of
various procedures in the Process Data and Specifications modules.
4. Click Find.
Tip

5. In the Search results data window, do one of the following:

• Select the desired tag number.
• Press and hold down Ctrl to select multiple tag numbers.
Multi-selection is available in the Calculation module when you select
tags for batch calculation, in the Process Data module for instrument
report generation, and in the Specifications module. You can also
select the Select all check box to select all the displayed tag numbers.
6. Click OK.
Related Topics
Search for Typical Tags

Important
• This option is available only in the Instrument Index module.
1. When editing, deleting, duplicating or moving tags in the Instrument Index
module, in the Enter Tag Number dialog box, click Find.
2. In the Find Tag dialog box, select Typical tag from the Tag class list.
3. Do not enter any other values in the Search parameter fields.
4. Click Find.
Tip
5. Select the desired tag numbers in the Search results data window and click OK.
Related Topics

Search for All Loop Numbers

1. In the Find Loop dialog box, do not enter any other values in the Search
parameter fields.
2. Click Find.
Tip
• Select the Display more results check box to enlarge the Search
results data window and display more rows. Clear this check box to
return to normal view.
3. Select the required loop numbers in the Search results data window and click
OK.
Related Topics
Use Search Parameters to Find Loop Numbers

1. Use the fields and lists in the Search parameters group box to enter your search
parameters to narrow your search. The following search parameters are available:
Parameter
Loop name Type the whole loop number you are looking 101F -2225\A
for. Include any prefix, suffix, and separator
characters. You can use wildcards if needed. 101F-%
The Search Results data window will display
this loop number if it exists.
Loop Type the numeric segment of the loop number to 2225
number find all the loop numbers that have this numeric
segment. You can also use wildcards if needed.
Loop prefix Type the loop number prefix to find all the loop 101
numbers that have this prefix. Do not include
the separator characters. The <unit> number
segment in the loop number name is usually the
loop number prefix. You can also use wildcards
if needed.
Loop suffix Type the suffix segment of the loop number to A
find all the loops that have this suffix. You can
also use wildcards if needed.


Parameter
Measured This search parameter is used to find all the Density (D)
variable existing loop numbers that have the measured
variable that you select from this list. Pressure (DP)
Loop type This search parameter is used to find all the Electrical Loop
existing loop numbers that have the loop type (Electrical),
that you select from this list.
Open Loop (Open)
Loop This search parameter is used to find all the Indication and
function existing loop numbers that have the loop Alarm (IA),
function that you select from this list.
Control (C)
Generation This search parameter is used to find all the CAD (a loop
type existing loop numbers that used a specific type drawing generated
of loop drawing generation. by an external CAD
engine)
Manual (a loop
drawing generated
by using the manual
method
2. If required, select the Fieldbus check box to narrow your search to the loop
numbers that contain tags with a fieldbus I/O type.
3. Click Find.
4. Select one or more loop numbers in the Search results data window.
Tips
• The Select all option is not available when duplicating an existing
loop number.
display more loop rows. Clear this check box to return to normal
view.
5. Click OK.
Related Topics

Search for Typical Loops

You perform the search in the Instrument Index module.
Using the Typical Loop Management dialog box:
• Click Edit > Typical Loop Management.

Using the Batch Loop Creation dialog box:
1. Click Edit > Typical Loop Management.
2. Click Find.
3. In the Find Typical Loop dialog box, do not enter any search parameters and
click Find.
In the Find Tag dialog box:
1. From the Tag class list, select Typical.
2. Click Find and select a tag number.
3. In the Typical Tag Number Properties dialog box, click Associate.
4. In the Find Loop dialog box, click Find to list all the available typical loops in
the Search results data window.
Related Topics

Supporting Tables: An Overview

Supporting tables are dialog boxes that allow you to manage the contents of select
lists in SmartPlant Instrumentation. For example, when creating or editing a panel,
the values that you select from the lists are held in the relevant supporting tables.
To access a supporting table, click next to the list arrow in the relevant dialog box,
or when in the Wiring Module or Instrument Index Module window, click Tables
and then the relevant menu command.
Note that in a multi-user installation, SmartPlant Instrumentation allows only one user
at a time to edit a given supporting table record.
For a detailed list and description of all the supporting tables in the SmartPlant
Instrumentation, see Supporting Tables in SmartPlant Instrumentation, page 67.
For details about the various activities that you can perform with the supporting
tables, see Supporting Tables Common Tasks, page 66.
Related Topics
• Supporting Tables Common Tasks, page 66

Supporting Tables Common Tasks

The following tasks are used frequently when managing supporting tables.
Add a New Value to a Select List

This option shows you how to add a new value to a select list. All values are stored
in the supporting tables that you can access from various windows and dialog boxes.
You can access a supporting table from a menu by selecting the appropriate item from
the Tables menu or by clicking in a dialog box. For more information, see Add a
New Value to a Select List, page 75.
Manage a Custom Table

This option shows you how to use custom tables, as defined by the Domain
Administrator, to contain supporting data for instruments. After you enter your data
in a Custom Table dialog box, you can use this data as additional tag attributes when
setting a profile in the Instrument Type Profile dialog box, and when editing tag
number properties in the Tag Number Properties dialog box. For more information,
see Manage a Custom Table, page 76.
Customize Manufacturer-Specific Field Headers

Some field headers on the Distributed Control System (DCS) dialog box,
Programmable Logic Controller (PLC) dialog box, I/O Card Properties dialog
box, and some appropriate reports use manufacturer-specific terminology. Therefore,
these dialog boxes display field headers according to the panel manufacturer you
select from the Manufacturer list when editing panel properties. The procedure
outlines how to customize these field headers according to manufacturer-specific
terminology. For more information, see Customize Manufacturer-Specific Field
Headers, page 76.
Related Topics
• Supporting Tables in SmartPlant Instrumentation, page 67
• Supporting Tables: An Overview, page 65

Supporting Tables in SmartPlant Instrumentation

The following table lists all the available supporting tables and the description of their
functions. You can access these supporting tables by clicking next to a list arrow
or by clicking an appropriate command on the Tables menu in the Instrument Index
and Wiring modules.
Supporting Table Description

General Process Allows you to define a sub-category for the General process
Function Sub- function in the Instrument Types dialog box.
Categories
Instrument Allows you to maintain the contents of the Status select list on
Statuses the Tag Number Properties dialog box.
I/O Types Allows you to maintain the contents of the System I/O type list
on the Tag Number Properties dialog box.
Instrument Allows you to specify general or specific instrument locations
Locations within the <plant>.
Equipment Allows you to categorize the equipment that your instruments are
installed on. Equipment is also categorized according to different
types, for example, you can specify the equipment type as:
pumps, compressors, burners, silos, and so forth.
Equipment Types Allows you to add new equipment types to the Equipment type
select list in the Equipment dialog box. You can categorize the
equipment that your instruments are installed on according to
different types, such as pumps, compressors, burners, silos, and
so forth.
P&ID Drawing Allows you to store P&ID drawing references used for making
References associations with tag numbers in the Instrument Index and Loop
Drawings modules.
Lines Allows you to categorize and modify line data in your <plant>.
This dialog box also enables you to access the Line Properties
dialog box where you can create a new line or edit the properties
of an existing line.
Line Types Allows you to create, view, edit, and delete line types.
Instrument Allows you to customize instrument criticality data. Then, you
Criticality can define criticality for a particular tag in the Associate
Categories and Criticality dialog box that you access from an
Instrument Index Standard Browser view.
Instrument This supporting table holds certification information for
Certification instruments that are certified for hazardous environment.


Instrument Allows you to control the content of the Manufacturer lists in
Manufacturers the Tag Number Properties and Find Tag dialog boxes as well
as the Manufacturer column in an Instrument Index Standard
Browser view.
The URL feature on the Instrument Manufacturer dialog box

allows you to enter a desired URL that can be double-clicked to
automatically launch the Internet Explorer and go to the pertinent
Web site if you are connected to the Internet.
Instrument Models Allows you to store instrument model data in the current domain.
All instrument models are categorized by instrument
manufacturer.
Function Blocks Allows you to add new user-defined function blocks to your
instrument index, delete the redundant ones, or modify the
definition of existing user-defined function blocks.
Intrinsically Safe Allows you to create and manage intrinsically safe circuit types
Circuit Types which you can associate with tag numbers while editing tag
number properties. The intrinsically safe circuit types that are
held in this supporting table then become available in the Wiring
module where you can carry out the intrinsic safety calculation.
Loop Measured Allows you to enter or modify the loop process variable identifier
Variables which is used in the loop naming conventions. The loop process
variable identifier is the first letter in the loop name that comes
after the loop prefix.
Loop Types Allows you to maintain the contents of the Loop type select list
on the Loop Number Properties, Typical Loop Properties, and
Find Loop dialog boxes.
Loop Functions Allows you to enter or modify the loop function identifier which
is used in loop naming conventions. The loop function identifier
is used to identify the succeeding letters that follow the loop
measured variable identifier in the loop name.
Associated Allows you to view equipment tags that are associated with
Electrical signals that are defined in SmartPlant Electrical and the
Equipment equipment type to which each signal belongs.
Associated This supporting table holds all the available associated electrical
Electrical equipment types to which SmartPlant Electrical signals can
Equipment Types belong.
Circuits This supporting table holds circuit values that appear in the
Circuit list on the Electrical tab of the Tag Number Properties
dialog box.


Rated Voltage This supporting table holds rated voltage values that you can use
in the Rated voltage list on the Power Supply tab of the Tag
Number Properties dialog box.
Frequency This supporting table holds frequency values that you can use in
the Frequency list on the Power Supply tab of the Tag Number
Properties dialog box.
Number of Phases This supporting table holds number of phases values that you can
use in the Number of phases list on the Power Supply tab of the
Tag Number Properties dialog box.
Operating Modes This supporting table holds operating mode values that you can
use in the Operating mode list on the Power Supply tab of the
Tag Number Properties dialog box and the properties dialog
boxes of panels that support power supply. SmartPlant
Instrumentation provides you with pre-defined operating modes
(Continuous, Intermittent, Spare, and Standby), which are the
only values that are recognized by SmartPlant Electrical. You
cannot delete or modify these values.
Signal Types This supporting table holds signal type values that are used to
define HART instrument properties. To fill this table, you need to
download DeltaV definitions.
Linearity Types This supporting table holds linearity type values that are used to
define HART instrument properties. To fill this table, you need to
download DeltaV definitions.
Panel Types Allows you to maintain the contents of the Panel type list when
editing the properties of a panel.
Panel Allows you to customize the options on the Manufacturer list on
Manufacturers the Properties dialog boxes listed below. The URL field on the
Panel Manufacturer dialog box allows you to enter a desired
URL. You can then double-click this URL to automatically start
the Internet Explorer and go to the pertinent Web site if you are
connected to the Internet. This supporting table also allows you
to define field headers that use manufacturer-specific
terminology.
Panel Models Allows you to manage the contents of the Model list when
creating or editing a panel. SmartPlant Instrumentation classifies
panel models according to manufacturer. You can find the data
used in the other columns in the manufacturer's catalog. Note
that selecting a different model does not change any other data.
Panel Area Allows you to manage the data contained in the Area
Classifications classification list on any of the panel properties dialog boxes.


Terminal Strip Allows you to manage the data contained in the Type list on the
Types Terminal Strip Properties dialog box. You can use this dialog
box to categorize a terminal strip where the terminal strip
represents a hardware device or a DCS/PLC I/O termination.
Terminal Strip Allows you to manage the contents of the Manufacturer list on
Manufacturers the Terminal Strip Properties dialog box.
Terminal Strip Allows you to manage the contents of the Model select list on the
Models Terminal Strip Properties dialog box. SmartPlant
Instrumentation classifies terminal strip models according to
manufacturer. You can classify a terminal strip model/MFG for
control si/s cards and hardware devices.
Terminal Types Allows you to manage the contents of the Type select list on the
Terminal Properties dialog box. Also, you can classify the
terminals whenever their type needs to be defined. You can
replace the default graphic image of terminal sides that appear in
the Connection window and the appropriate reports.
Terminal Allows you to manage the contents of the Manufacturer select
Manufacturers list on the Terminal Properties dialog box.
Terminal Models Allows you to manage the contents of the Model select list on the
Terminal Properties dialog box. Terminal models are classified
according to manufacturer.
Terminal Colors Allows you to manage the contents of the Color select list on the
Terminal Properties dialog box. You can also select and
customize the graphical representation of the color names defined
in this supporting table. This sets the precise colors for the bar
connecting terminals in the Connection and Cross-Wiring
windows.
Wiring Equipment Allows you to manage the contents of the Wiring equipment
Types types select list. Wiring equipment type is one of the properties
used to define wiring equipment items, such as I/O cards, I/O
terminations, fieldbus bricks, safety barriers, relays, amplifiers,
and so forth.
Wiring Equipment Allows you to manage the contents of the Manufacturers select
Manufacturers list. Wiring equipment manufacturer is one of the properties used
to define wiring equipment items, such as I/O cards, I/O
terminations, fieldbus bricks, safety barriers, relays, amplifiers,
and so forth.
Wiring Equipment Allows you to manage the contents of the Models select list.
Models Wiring equipment model is one of the properties used to define
wiring equipment items, such as I/O cards, I/O terminations,
fieldbus bricks, safety barriers, relays, amplifiers, and so forth.


Wiring Equipment This supporting table holds wiring equipment category values.
Category The categories that exist in this supporting table are available for
selection in the Categories select list of the New Wiring
Equipment dialog box. You can add your own categories and
then set their properties as you require. However, you cannot
modify or delete the categories that are supplied to you with the
software.
Cable Types Enables you to manage cable type data that appears on the Cable
Properties dialog box, Type select list. The Cable Types dialog
box holds all the data that pertains to the cable types in the
current <plant>. Users can view the data or delete it as needed.
This dialog box provides access to the Cable Type Properties
dialog box, where you can create a new cable type or edit the
properties of an existing cable type.
Cable Enables you to manage the data in the Cable Manufacturers
Manufacturers supporting table, which contains all the items of the
Manufacturer select list on the Cable Properties dialog box.
Cable Models Allows you to manage the data in the Cable Models supporting
table, which contains all the items of the Model select list on the
Cable Properties dialog box. SmartPlant Instrumentation
classifies cable models according to manufacturer.
Cable Colors Allows you to manage the contents of the Color select list on the
Cable Properties dialog box.
Cable Glands Enables you to manage the data in the Cable Glands supporting
table, which contains all the items of the End 1 and End 2 select
lists in the Glands group box of the Cable Properties dialog
box. This way, you can assign cable glands to selected cable
types. Once assigned to a cable type, the gland attributes
automatically propagate to all the cables of that type.
Cable Harnesses Allows you to define and maintain the contents of the Cable
harness select list on the Cable Properties dialog box.
Conductor Cross- Enables you to manage the conductor cross-section data for the
Sections cables in the current <plant>. The values that appear in this
dialog box are available in the Cross-section select list on the
Cable Properties dialog box.
Wire Types Allows you to manage the contents of the Type list on the Wire
Wire Colors Allows you to manage the contents of the Color list on the Wire


Connector Types A connector type defines pin configuration and other properties.
When you define connectors for a cable, selecting a connector
type copies these properties for the cable connector. This
supporting table allows you to create and manage the connector
types required for your plug-and-socket boxes and for cables that
require connectors.
Connector Allows you to manage the contents of the Manufacturer select
Manufacturers list on the Connector Types dialog box.
Connector Models Allows you to manage the contents of the Model select list on the
Connector Types dialog box. Connector models are classified
according to the Manufacturer column. The information used in
the other columns can be found in the manufacturer's catalog.
Controllers The controller is the processing hardware that controls and
supervises I/O cards. This supporting table allows you to define
and manage your I/O card controllers. You can define new
controllers, edit the properties of existing controllers, and delete
controllers.
Channel Types Allows you to manage the contents of the Channel Type select
list on the Channels dialog box.
Segment-Wide Allows you to define default settings that serve as design rules for
Parameter Profiles the various Fieldbus segments.
Standard Widths Each routing trunk that you define consists of positions. Instead
of defining new positions for each additional trunk, you select the
positions from the list of standard positions. Instead of defining
the width for each standard position that you can add to a trunk,
you select it from the standard width list that you set in this
supporting table. You use the widths that you add in this
supporting table to define the positions in a routing trunk. The
width that you define here is a standard unit and therefore can be
used several times to characterize different positions.
Standard Routing Each routing section of type trunk that you define consists of
Positions positions. (Building sections do not have positions.) Instead of
defining new positions for each additional trunk, you select the
positions from the list of standard positions that you define in this
supporting table.
Maximum Number The maximum number of cables limits the number of cables that
of Cables a position can contain. After you have defined widths and
created positions, you need to set the maximum number of cables
per defined-width position that you want to associate with a
routing trunk.


Routing Sections Defining routing sections is the last step in creating the <plant>
cable routing before associating routing with cables. The cable
routing sections contain the positions that convey the cables
between the instruments. Using this supporting table, you can
add or edit a routing section and select positions to be included in
a trunk section. The positions that you can select are those for
which you have already defined the maximum number of cables.
Cable Drums Allows you to define and manage the cable drums in your
<plant>. Note that cable drums are categorized according to
cable type.
Pulling Areas Allows you to define the pulling areas in your <plant>. The
pulling area in the <plant> is the area allocated to cables and
the cable drums they are wound on. The purpose of allocating
pulling areas is both to organize the <plant> drums in
designated areas and to regularly use the cables from these
areas.
DCS Block Types Allows you to manage the block type data for control system
tags. The values that appear on this dialog box are available in
the Block Type select list on the Control System Tag
DCS Function Enables you to manage the DCS function block I/O termination
Block I/O data for control system tags. The values that appear on this
Termination dialog box are available in the Function block I/O termination
select list on the Control System Tag Properties dialog box.
Notes
• For the various actions that you can perform with supporting tables, see
Supporting Tables Common Tasks, page 66.
• For the supporting tables used in Telecom, see Supporting Tables for
Telecom, page 74.
Related Topics

Supporting Tables for Telecom

The following table lists all the available Telecom supporting tables and the
description of their functions. You can access these supporting tables by clicking
next to a list arrow or by clicking Tables > Telecom and then an appropriate
command in the Instrument Index and Wiring modules.
Supporting Description
Table
Telecom Allows you to create and manage telecom device types. You define
Device Types the required telecom device type profile for your telecom tag numbers
so that new tags that you create can acquire the necessary properties.
SmartPlant Instrumentation provides a number of predefined telecom
device types, such as AL (alarm), CAM (camera), and so forth. You
can add new telecom device types and modify the shipped ones as
desired. You can also delete a telecom device type that is not in use,
but the software does not let you delete a telecom device type that you
already used to create a tag number.
Telecom Line Allows you to maintain the contents of the Telecom line list when
Numbers creating a telecom field device in the Plug-and-Socket Box wizard
and the Line number list on the Tag Number Properties dialog box.
Telecom Field Allows you to maintain the contents of the Field equipment select list
Equipment on the Tag Number Properties dialog box.
Telecom Allows you to maintain the contents of the Signal level select list on
Signal Levels the Tag Number Properties dialog box.
Panel Sub- Allows you to maintain the contents of the Sub-system select list on
Systems the Equipment Panel Properties dialog box.
Telephone Allows you to define new telephone numbers that you can associate
Numbers with existing switch channels in PABX cabinets.
Telephone Allows you to manage the contents of the Telephone number status
Number select list on the Telephone Number Properties dialog box.
Statuses
Telephone Allows you to manage the contents of the Telephone number usages
Usages
Intercom Allows you to define new intercom numbers that you can later
Numbers associate with amplifiers.
PA Zones Allows you to manage the PA zone definitions which are available for
selection on the Category Properties tab of the Wiring Equipment
Properties (Amplifier) dialog box.

Table
Alarm Zones Allows you to manage the alarm zone definitions which are available
for selection on the Category Properties tab of the Wiring
Equipment Properties (Amplifier) dialog box.
PABX Allows you to manage the contents of the PABX categories select list
Categories on the PABX Cabinet Properties dialog box.
Note
• For the various actions that you can perform with supporting tables, see
Supporting Tables Common Tasks, page 66.
Related Topics
Add a New Value to a Select List

1. Open the appropriate supporting table by clicking in the appropriate dialog box
or by selecting the appropriate menu item on the Tables menu.
2. In the appropriate supporting table dialog box, click New.
3. Type the required value in the fields provided, and press Tab to move to the next
field.
4. Click New to enter another new value, if desired.
5. Click OK to accept the new values and close the dialog box.
Related Topics

Customize Manufacturer-Specific Field Headers

1. Do one of the following to open the Panel Manufacturers dialog box:
• In the Wiring module, click Tables > Panel > Manufacturers.
• Click next to the Manufacturer select list on the appropriate dialog
box: Distributed Control System (DCS) Properties, Programmable
Logic Controller (PLC) Properties, or I/O Card Properties.
2. On the Panel Manufacturers dialog box, click Headers.
3. From the Wiring item list, select the item type for which you want to customize
the field headers.
4. Under Custom Field Header, type the text you require next to the appropriate
value that appears under Field Header in Data Dictionary.
5. Repeat steps 3 and 4 as many times as you require.
6. Click OK.
Related Topics
Manage a Custom Table

1. In the Instrument Index Module menu, click Tables > Custom Tables, and then
select the custom table you want to open.
2. To add a new record, click New, and then type a unique name and an optional
description.
3. To edit an existing record, click a value that you want to edit, and modify as
needed.
4. To delete a record, select the row that you want to delete, and click Delete.
5. Click OK.
Note
• The Domain Administrator has rights to create the required custom tables
for each <plant>. If the Domain Administrator does not create any
custom tables, the Custom Tables menu option is not available.
Related Topics

Interface Languages: An Overview

You can replace the SmartPlant Instrumentation interface language. The System
Administrator must first add languages to the database. You can purchase each
language as a separate add-in. After adding a language to the database, you can
replace your current language with the added one.
The following languages are currently available as add-ins:
• English (default)
• French
• German
• Custom
After the appropriate interface language is added, you can do the following:
• Replace the existing interface language with the imported language.

• Edit interface text phrases.
• Define new phrases to replace existing ones.

Interface Languages Common Tasks

The following tasks are used frequently when working with interface languages:
Replace the Interface Language with a Language from the Database

This procedure explains how to replace the current SmartPlant Instrumentation
interface with a language from the database. For more information, see Replace the
Interface Language with a Language from the Database, page 79.
Replace the Interface Language with a Language from an External File

Use this procedure to replace the interface language with a language from an external
file. In this mode, all the terms and phrases are retrieved from a language file instead
of being retrieved from the database, a change that improves the performance. For
more information, see Replace the Interface Language with a Language from an
External File, page 79.
Create a Language File with Customized Interface Text

An external language file enables you to replace the text in the current interface with
your customized text. To create customized phrases, you use a special interface
language called Custom. After switching to the custom language, all the phrases in
this column replace the original phrases of the interface language without overwriting
them. Empty fields in this column do not affect the original phrases. This way you
can always revert to the original phrases of the interface language. For more
information, see Create a Language File with Customized Interface Text, page 80.
Edit Interface Text Phrases

This procedure allows you to change the interface text by editing its phrases. At this
stage, you change the phrases of the interface language, as described in the overview.
Note that the interface text changes take effect only after exiting and re-entering the
application. For more information, see Edit Interface Text Phrases, page 81.
Prefixes and Suffixes in the Interface Text

This topic contains a table with the information about the prefixes and suffixes that
you can use when customizing new interface text phrases. For more information, see
Prefixes and Suffixes in the Interface Text, page 83.
Related Topics
• Interface Languages: An Overview, page 77

Replace the Interface Language with a Language from the

Database
1. Start SmartPlant Instrumentation or the Administration module.
2. Click Tools > Select Language.
3. In the Select Language dialog box, do one of the following:
• From the Language data window, select the language with which you
want to replace the current interface language.
• Click Default to revert the language to the default language (English).
• Select the Optimize Speed check box to speed up the translation
process. This allows the software to load the interface text to your
computer memory and retrieve it from there.
• Clear the Optimize Speed check box to retrieve the interface text from
the database. This frees the memory resources but decreases the
performance.
5. Click OK to close the dialog box and change the interface language.
Related Topics
• Interface Languages Common Tasks, page 78
Replace the Interface Language with a Language from an

External File
Important
• Use this procedure only if you experience memory problems while
working on your local computer.
2. Click Tools > Select Language.
3. Select Optimize speed.
4. Select Use file to retrieve the interface text from a previously saved file (saved in
.psr format), and do one of the following:
• In the data field, type the path and filename of the appropriate
language file.
• Click Browse to navigate to the language file.

5. To update your language file, do one of the following:

• Select Overwrite existing file to update the contents of the external
language file after running an update for the application. This action
overwrites all existing data in the language file with the data retrieved
from the database.
• Clear Overwrite existing file to leave the language file contents
unchanged.
6. Click OK to close the dialog box and change the interface language.
Related Topics
Create a Language File with Customized Interface Text

Important
• The System Administrator must first add the required language to the
database.
• The interface text changes take effect only after exiting and re-entering the
application.
2. Click Tools > Edit Translation Text.
• Click Open to navigate to the language file that contains the interface
text.
• Click Retrieve to retrieve the interface text from the database.
4. In the Custom Phrase column, type the phrases you want.
Tips
• The column header Custom Phrase changes to German Phrase if
you imported the German language, and to French Phrase if you
imported the French language.
• In the Custom Phrase column, each phrase that you type replaces the
corresponding phrase in the interface text. If you leave a field blank,
the corresponding field in the interface text remains unchanged. Make
sure that you add the same prefixes, suffixes and punctuation marks
that appear in the corresponding original phrases of that interface
language for example, ~, &. For details, see Prefixes and
Suffixes in the Interface Text, page 83.

5. To view the changes, switch to the appropriate language. For details, see Replace
the Interface Language with a Language from the Database, page 79.
Tip
• After the changes are saved, you are prompted to restart SmartPlant
Instrumentation for the changes to take effect.
6. Click Save File to save the edited interface text to a language file (a file with a
.psr extension).
7. Type the path and filename of the language file or navigate to an existing
language file.
8. Click OK in the displayed message and restart SmartPlant Instrumentation or the
Administration module for the changes to take effect.
9. Click OK to save the changes and return to the Edit Translation Text dialog
box.
10. Click Close.
Related Topics
Edit Interface Text Phrases

Important
• The System Administrator must first add the required language to the
database. You can purchase a language that you require as a separate add-
in.
• If you edit the phrases of an interface language that you have previously
imported, you will not be able to revert to the imported interface language.
• When editing, make sure that you fill all the fields in the appropriate
column. If you have a field blank, the phrase from the previous interface
language remains after you switch the currently displayed language to the
language that you are editing now. This can result in your interface text
containing phrases or terms in more than one language.
2. Click Tools > Edit Translation Text.
• Click Open to navigate to the language file that contains the interface
text.
• Click Retrieve to retrieve the interface text from the database.

4. Edit the text by clicking the text in the appropriate field.

Tip
• You can modify the column sequence, for example, you can compare
phrases more easily by moving two columns closer together. Drag a
column header and drop it in the desired location. Then, click Update
to save the changes to the database. If you want to save the changes to
an external language file and not to the database, do not click Update.
5. To view the changes, replace the active language with the language that you have
edited. For details, see Replace the Interface Language with a Language from the
Database, page 79.
Tip
• After the changes are saved, you are prompted to restart SmartPlant
Instrumentation for the changes to take effect.
6. Click Save File to save the edited interface text to a language file (a file with a
.psr extension).
7. Type the path and filename of the language file or navigate to an existing
language file.
8. Click OK in the displayed message and restart SmartPlant Instrumentation or the
Administration module for the changes to take effect.
9. Click OK to save the changes and return to the Edit Translation Text dialog
box.
10. Click Close.
Related Topics

Prefixes and Suffixes in the Interface Text

The following table contains information about the prefixes and suffixes that you can
use when customizing new interface text phrases.
Prefix/Suffix Function Syntax Example

& Specifies a menu item. &[interface text] &Action
Underlines the letter
following the & symbol.
&& Displays the & symbol. && Operators &&
Functions
~n Starts a new line. [interface ~nContinue?
text]~n[interface
text]
~r Starts a new paragraph [interface Warning~n~r
(functions like the Enter text]~r[interface
key in Microsoft Word). It text]
is usually used in
conjunction with ~n.
~t Adds a tab entry. [interface &Action~tCtrl+A
text]~t[interface
text]
Related Topics

Revision Management: An Overview
Revision Management: An Overview

When managing revisions, you can add revisions to documents in SmartPlant
Instrumentation, update them as needed, archive and compare new and existing
document revisions, and delete obsolete revisions. A document is a report or drawing
that has a document number. Also, you can add a document number when adding a
revision to an item .
The software allows you to add a revision to a specific report, drawing, or item , for
example, to a specific I/O card in the Wiring module. You add revisions to reports in
the report print preview and to items in the dialog boxes where you can edit the item
properties. Also, you can create global revisions.
In the Administration module, in the Report Management dialog box, the Domain
Administrator has rights to define revision management settings individually for each
report that you can generate in SmartPlant Instrumentation.
In the database, each report is assigned to the report type, which can be a list or a non-
list type report. The report type determines how you can manage revisions created
for a specific report, for an item , or a group of items. For list-type reports, the
Domain Administrator can enable SmartPlant Instrumentation users to manage
revisions either per document or per item .
In accordance with the revision management setting, you can either create a revision
whose document number and revision number become shared for a specific item and
for reports generated for that item (when the setting is per-item ), or create a unique
revision for a particular report (when the setting is per-document).
Regardless of the revision management setting, any document numbers and revisions
that you create in the software are shared with the document numbers and revisions
created for the same items in the Enhanced Report Utility. For example, a drawing
created in the Enhanced Report Utility automatically inherits the same document
number and revision that you assigned to an Enhanced SmartLoop report generated in
SmartPlant Instrumentation.
When working in an integrated environment, you can specify whether to use

SmartPlant Instrumentation revisions or external revisions created when working in
an integrated environment.
To place issue data on title blocks for enhanced reports, use the Place Drawing
Property Label command in the Enhanced Report Utility. For more information, see
Place Property Labels on a Drawing Sheet in the Enhanced Report Utility User's
Guide, under Working with Templates and Title Blocks.
Related Topics
• Global Revisions: An Overview, page 85
• Revision Management Common Tasks, page 86

Global Revisions: An Overview

Global revisions enable you to perform a revision activity in batch mode.
At the first stage of applying global revisions, you select a revision activity, and
define the default revision settings, such as revision values, numbering method, and
revision details. At the second stage, you select the required items in a specific
module, and apply the defined revision settings.
Revision activities include:
• Add revision - select the required numbering method and add a new
revision.
• Update revision - change the existing revision value without changing the
numbering method. For example, you can update a revision from A1 to
A2.
• Upgrade revision - involves changing the revision numbering method. For
example, you can upgrade a revision from P0 to A.
• Delete revisions - delete all revisions for the selected items.
• Delete last revision - delete only the last revision.
You can add global revisions to non-list-type reports for which the Domain
Administrator selected the Per Document revision management setting in the Report
Management dialog box.
An exception is Enhanced Report Utility reports, which are always assigned to the
Per Item revision management setting. The document number and global revision
that you create in SmartPlant Instrumentation are shared with the document number
and revision created in the Enhanced Report Utility.
Note
• Items that have archive options defined as Save to database, any revisions
are only saved to the archive after closing the Global Revisions dialog
box. Adding a revision and then deleting the revision, before closing the
dialog box, results in the revision not being archived.
Related Topics
• Revision Management: An Overview, page 84

Revision Management Common Tasks

The following tasks are used frequently when managing global and local revisions:
Add Global Revisions

This option enables you to add a global revision to items that belong to any of the
following modules: Specifications, Process Data, Calculation, Loop Drawings, Hook-
Ups, Wiring, and Dimensional Data. For more information, see Add Global
Revisions, page 88.
Define Settings for Upgrading Revisions

This option enables you to define default settings for upgrading revisions globally.
These settings include revision numbering method, and revision details. For more
information, see Define Settings for Upgrading Revisions, page 90.
Update Revisions Globally

You can update the existing revision values globally for the items used in the
following modules: Specifications, Process Data, Calculation, Loop Drawings, Hook-
Ups, Wiring, and Dimensional Data. For more information, see Update Revisions
Globally, page 91.
Upgrade Revisions Globally

After defining the default settings for upgrading revisions, you use this option to
apply these settings to the selected items in batch mode. For more information, see
Upgrade Revisions Globally, page 92.
Delete Global Revisions

You can perform batch deletion of revisions if you have the appropriate access rights.
You have the option to delete all revisions for the selected items in the specified
module, or delete only the last revisions. For more information, see Delete Global
Revisions, page 94.
Filter Items for Global Revisions

You can filter the items in the data window of the Global Revisions dialog box when
adding, updating, upgrading, or deleting revisions in batch mode. On the Wiring tab
of the Global Revisions dialog box, you can also filter the Wiring module items per
report. For more information, see Filter Items for Global Revisions, page 87.

Add Local Revisions

You can add revisions locally to a specific SmartPlant Instrumentation document or
item , depending on revision management settings defined by the Domain
Administrator. For all list-type reports, the revision management setting is always
Per Document. For certain non-list-type reports, the Domain Administrator has
rights to define the setting as either Per document or Per Item . For more
information, see Add Local Revisions, page 95.
Edit Local Revisions

Use this procedure to edit existing local revisions. For more information, see Edit
Local Revisions, page 96.
Delete Local Revisions

Use this procedure to delete existing local revisions. For more information, see
Delete Local Revisions, page 96.
Related Topics
Filter Items for Global Revisions

1. In the Global Revisions dialog box, click one of the following tabs:
Specifications, Process Data, Calculations, Loops, Hook-Ups, Wiring, or
Dimensional Data.
Tips
• If you accessed the Global Revisions dialog box from the main
SmartPlant Instrumentation window, tabs for multiple modules are
available; if you accessed the dialog box from a particular module,
then only the Settings tab and the tab for that module are available.
• If you are working in an integrated environment, then regardless of
where you access this dialog box from, the following tabs are disabled:
Specifications, Process Data, Loops, and Dimensional Data.
2. If you selected the Wiring tab, do the following:
• Under Filter parameters, from the Report for list, select the item for
which you want to apply revisions: Panels, Cables, or DCS/PLC.
• From the Report type list, select a report type appropriate for the item
you selected in the previous step.
Tip
• To set new filter parameters, first click Clear.

3. For all tabs, under Filter parameters, type values in one or more of the text
boxes to specify the parameters that you want to use for filtering the data.
4. Select the Display current <unit> data only check box to display the data in the
current <unit>. Clear this check box to display all data at the level of the current
<plant>.
Tip
• On the Hook-Ups tab, data is filtered at the <plant> level only.
5. Select Activate filter to apply the filter parameters on the items.
Tip
• If you select the Activate filter check box first, the software filters the
data as you select or type the filter parameters.
6. Select Enable wildcard search to use a wildcard, if required, in your search.
Tips
• The Enable wildcard search is enabled only when Activate filter has
been selected.
• The % character is used as the wildcard symbol in your filter.
7. Click Refresh to update the data window as needed.
8. Click Apply.
Related Topics
Add Global Revisions

1. In the main window of any SmartPlant Instrumentation module, click Tools >
Global Revisions.
2. On the Settings tab of the Global Revisions dialog box, from the Activity list,
select Add revision.
3. In the Revision field, enter the desired revision value.
4. Do the following to enter the revision details:
• In the Revised by field, enter the initials of the person performing the
revision. The default is the current user's initials, if previously defined
by the System Administrator.
• In the Date field, enter the date of revision, if required.
• Fill out the other fields as needed.

5. Click one of the following tabs: Specifications, Process Data, Calculations,

Loops, Hook-Ups, Wiring, or Dimensional Data.
Tips
6. In the data window, filter the items as needed. For details, see Filter Items for
Global Revisions, page 87.
7. In the data window, select the items for which you want to add a global revision
defined on the Settings tab by doing one of the following:
• Select the desired tag numbers (hold down Ctrl or Shift to make
multiple selections).
• Select the Select all check box to select all the tag numbers in the data
window.
8. Click Apply to add a revision to each of the selected items.
9. If you want to add revisions for other modules, repeat the appropriate steps for
each module.
Note
• Items that have archive options defined as Save to database, any
revisions are only saved to the archive after closing the Global
Revisions dialog box. Adding a revision and then deleting the
revision, before closing the dialog box, results in the revision not being
archived.
Related Topics

Define Settings for Upgrading Revisions

1. With any main window open, click Tools > Global Revisions.
2. On the Settings tab, from the Activity list, select Upgrade revision.
3. To change the numbering method for items that do not currently have revisions,
from the Initial revision numbering method list, select one of the following
numbering methods you want to start with:
• P0— for preliminary number sequence P0, P1, P2,...
• 0— for number sequence 0, 1, 2,...
• A— for number sequence A, B, C,...
Tip
• The initial revision numbering method only affects items that do not
have revisions. For items that already have revisions, the software
adds a new revision line using the existing revision numbering
method.
4. To change the numbering method for items that currently use the preliminary
revision numbering method (P0, P1, P2,...), select Switch to another numbering
method, and from the Continue using numbering list, select one of the
following new revision numbering methods:
6. Click the appropriate module tab to apply the defined settings. For details, see
Upgrade Revisions Globally, page 92.
Tips

Update Revisions Globally

1. With any main window open, click Tools > Global Revisions.
2. On the Settings tab, from the Activity list, select Update revision.
3. In the Revision field, enter the desired revision value.
Tips
7. In the data window, do one of the following to select the items whose revisions
you want to update:
window.
8. Click Apply to apply the new revision value to all the selected items in batch
mode.
9. If you want to update revisions for other modules, repeat the appropriate steps for
each module.
Related Topics

Upgrade Revisions Globally

1. Define the settings for upgrading revisions globally. For details, see Define
Settings for Upgrading Revisions, page 90.
2. Select the desired module tab and filter the items as needed. For details, see
Filter Items for Global Revisions, page 87.
3. To change the numbering method for items that do not currently have revisions,
from the Initial revision numbering method list, select one of the following
numbering methods you want to start with:
• P0— for preliminary number sequence P0, P1, P2,...
4. In the data window, do one of the following to select the items for which you
want to upgrade revisions:
window.
5. Click Apply to apply the new revision value to all the selected items in batch
mode.
6. If you want to upgrade revisions for other modules, repeat the appropriate steps
for each module.
Related Topics
• Revision Upgrade Example, page 93

Revision Upgrade Example

This example is based on the following parameters:
• Initial numbering method: P0

• Switch to numbering method for preliminary revisions: A
With the above parameters, the following results are obtained for subsequent
revisions (on clicking Apply in the module sub folders of the Global Revisions
dialog box):
Previous 1 2 2 Comments
None P0 A B First revision uses initial numbering method (P0); subsequent
revisions use switch to numbering method (A, B, and so
forth.)
P2 A B C First and subsequent revisions use switch to numbering
method (A, B, and so forth.)
A B C D Incremented by one step each time from the previous revision
B C D E Incremented by one step each time from the previous revision
1 2 3 4 Incremented by one step each time from the previous revision
2 3 4 5 Incremented by one step each time from the previous revision
Related Topics
• Upgrade Revisions Globally, page 92

Delete Global Revisions

1. In the main window of any SmartPlant Instrumentation module, click Tools >
Global Revisions.
2. On the Settings tab of the Global Revisions dialog box, from the Activity list,
select one of the following:
• Delete revisions — select to delete all revisions for the selected
items.
• Delete last revision— select to delete the last saved revision for each
selected item .
Tips
5. In the data window, do one of the following to select the required items:
window.
6. Click Apply to delete the revisions for the selected items.
7. If you want to delete revisions for other modules, repeat the appropriate steps for
each module.
Related Topics

Add Local Revisions

1. In the Revisions dialog box, select one of the revision numbering methods from
the Revision method list (use P0, P1, P2... for preliminary revisions or 0, 1, 2 / A,
B, C, and so forth for normal serial revisions).
Tip
• If you select a revision numbering method other than preliminary
revisions (P0, P1, P2...), you will not be able to return to the
preliminary revision method and this option will be disabled.
2. If needed, in the Drawing number field, type the number of the document
associated with the item for which you create the revision. In drawings and
reports, this number appears in the title block.
3. Click New to add a new revision.
Tips
• If you are working in an integrated environment in a module that
supports publishing and retrieving of documents, clicking New opens
the Revise dialog box for the integrated environment instead of the
SmartPlant Instrumentation Revisions dialog box.
• The software automatically increments the revision number according
to the selected revision method. You can overwrite SmartPlant
Instrumentation revisions if desired.
4. Add or edit the revision data as needed.
Note
• If the document for which you are making a revision contains a custom-
title block, the User-defined fields data window becomes available for
you. In this data window, you can view the user-defined fields that you
added to the custom title block that you created. To learn more about
custom title blocks, see Customizing Title Blocks for Reports: An
Overview, page 121.
Related Topics
• View an Archived Revision, page 97

Edit Local Revisions

1. In the Revisions dialog box, select the revision that you want to edit.
2. Make the desired changes according to the revision table:
Field Description
No The revision number. This is incremented automatically according to
the revision method selected, you can overwrite it if required.
By Type the initials of the person performing the revision. The default is
the current logged-in user initials, if previously defined by the System
Administrator.
Date The default is today's date, you can modify it if required.
Description Description of the changes made or the purpose of the revision.
Checked By Type the name of the person checking the revision, if required.
Approved Type the name of the person approving the revision, if required.
By
3. Make changes for other revisions as desired.

4. Click OK to apply your changes.
Related Topics
Delete Local Revisions

1. On the Revisions dialog box, select the revision that you want to delete.
2. Click Delete.
Related Topics

View an Archived Revision

1. In the Administration module, select the desired archiving option. For details, see
Set Archiving Options for Report Comparison in the Administration User's
Guide, under Domain and Project Administration, Report Management.
2. In SmartPlant Instrumentation application, save a revision for the desired
document.
Important
• For enhanced reports, you must perform revisions from the Enhanced
Report Utility if you want them to be archived for performing report
comparison or viewing a changes report.
• The software archives revisions for browser view reports separately
for each view regardless of any existing filter or sort sequence.
3. On the Print Preview toolbar, click to open the Document Revision Archive
dialog box where you view the revision.
4. Double-click the desired revision or revisions to open the print preview.
Related Topics

Report Comparison: An Overview

Report comparison is available if you have saved revisions for a particular report.
For every saved report revision, there is an archived report, stored according to the
archiving option. The Domain Administrator defines an archiving option for each
report.
When comparing reports, you can generate a comparison report to view the report
fields in which the values are different.
Notes
• Report comparison is only available if the System Administrator has
selected Audit trail options in the Domain Definition window for the
current domain, and if the Domain Administrator has selected one of the
options for saving revisions of the specified report in the Report
Management dialog box in the Administration module.
• For enhanced reports, you must perform revisions from the Enhanced
Report Utility if you want them to be archived for performing report
comparison.
• You cannot perform report comparison for Powersoft browsers.
Using report comparison, you can do the following:
• Compare the currently previewed report with an archived report. For

details, see Comparing the Current Report with an Archived Report, page
101.
• Compare two archived reports. For details, see Comparing Archived
Reports, page 100.
Related Topics
• Setting Font and Color for Report Comparison, page 99
• Viewing Archived Reports, page 102

Setting Font and Color for Report Comparison

This option enables you to set a comparison color and font style prior to comparing
reports. The preset color and font style appear in a previewed report after comparing
this report with an existing archived report. You can also set the grayscale and font
style to appear in a printed report after report comparison. In a previewed report, the
comparison color and font style indicate the differences between the previewed report
and an archived report selected for comparison.
Set Font And Color for Report Comparison

1. On the Tools menu of any SmartPlant Instrumentation module, click Data
Comparison Display Options.
2. Beside the Highlight color for display field, click .
3. In the Color dialog box, choose the color that you require.
4. Click OK to return to the Data Comparison Display Options dialog box.
Tip
• The highlight color you have set appears after report comparison in
any report print preview to indicate the differences between the current
and the archived report.
5. Beside the Grayscale field, click .
6. In the Grayscale dialog box, move the slider to the required position.
7. Click OK to close the Grayscale dialog box.
Tip
• The grayscale you have set appears after report comparison in a
printed report to indicate the differences between the current and the
archived report.
8. Under Font style, do the following if required:
a. Select Bold to mark the differences between the current and the archived
report in bold.
b. Select Italic to mark the differences between the current and the archived
report in italic.
Related Topics
• Report Comparison: An Overview, page 98

Comparing Archived Reports

This option enables you to compare between two archived reports.
Compare the Currently Previewed Report With an Archived

Report
1. In the Print Preview window, do one of the following:
• On the Print Preview window toolbar, click

• On the View menu, click Compare Reports.
2. In the Report Comparison Options dialog box, click Compare two archived
reports.
3. Click OK.
4. In the Select Archived Revisions for Report Comparison dialog box, do the
following:
a. From the Compare data window, select the revision corresponding to the
source archived report.
b. From the With data window, select the revision corresponding to the target
archived report that you want to compare with the source report.
Tip
• If there is a long list of revisions in either of the data windows, type
the desired revision number in the Revision filter box and select
Activate.
Note
• If the archived and the currently previewed reports are different, in the
previewed report the software marks the differences in color. If required,
you can set your own comparison highlight color and font style to indicate
the differences for report display. You can also set a grayscale and font
style to indicate the differences in a printed report. For details, see Setting
Font and Color for Report Comparison, page 99
Related Topics
• Comparing the Current Report with an Archived Report, page 101

Comparing the Current Report with an Archived

Report
The option enables you to compare the currently previewed report with an archived
report.
Compare the Currently Previewed Report With an Archived

Report
• On the Print Preview window toolbar, click .

• On the View menu, click Compare.
2. In the Report Comparison Options dialog box, click Compare the current
report with an archived report.
3. Click OK.
4. In the Report Revision Archive dialog box, select the revision corresponding to
the archived report that you require.
Tip
• If there is a long list of revisions in the data window, type the required
revision number in the Revision filter box and select Activate.
5. Click OK to reopen the Print Preview window.
• If the archived and the currently previewed reports are different, in the
previewed report the software marks the differences in color. If required,
you can set your own comparison highlight color and font style to indicate
the differences for report display. You can also set a grayscale and font
style to indicate the differences in a printed report. For details, see Setting
Font and Color for Report Comparison, page 99
Related Topics

Viewing Archived Reports

This option enables you to open a report preview of any archived report. The software
automatically archives reports when saving report revisions for the currently
previewed report. The Domain Administrator defines an archiving option for each
report.
View an Archived Report

• On the Print Preview window toolbar, click
• On the View menu, click Report Revision Archive.
2. In the Report Revision Archive dialog box, select the revision which
corresponds to the archived report you want to view.
Tip
• If there is a long list of revisions in the data window, type the required
revision number in the Revision filter list, and select Apply.
3. Click OK to open the archived report in the Print Preview window.
Related Topics

Displaying Changed Documents

This option enables you to display a list of documents for which data modifications
have been made. To use this option, the Domain Administrator must first select the
Save Document Data option in the Report Management dialog box for each report
that you want to include in the list. The software does not include in changes reports
any modifications that you make to title block macros or external symbols such as
DCS data or non- wiring tag lists in enhanced reports.
The software does not display data changes in the following cases:
• If you add a new item such as a panel or gland in list reports, because the
software cannot determine whether the item is part of the document.
• If you remove or assign tags or items in the Hook-ups module.
• For the Instrument Index Drawing Summary Browser. Changes that you
make in the Instrument Index Standard Browser are included in the
Browse - Instrument Index Report item, and not in the Instrument
Index under the list of browser
Display a List of Changed Documents

1. On the Tools menu, click Changed Documents.
2. In the Changed Documents dialog box, do one of the following:
• Under Document types, highlight the desired document types. For
multiple selection, hold down Ctrl or Shift while making your
selection.
• Select the Select All check box.
3. Under Filter by, select an option to specify the method of filtering. The available
options are:
• Documents changed since last revision - select to filter documents
for which data was changed since the last revision of the document. If
there is no revision, the software does not display that document.
• Documents changed between specified dates - select to filter
documents for which data was changed during the date range specified
by the From date and To date fields.
4. Click Find to retrieve the list of changed documents according to the document
types and filter options that you specified.
5. Click Changes Report if you want to display a report of the changed documents.

Workflow: An Overview
The Workflow option enables instrument engineers to control the data entry process
for instrument tags by specifying if and when process data should be entered for a
particular tag. Workflow defines an additional level of access rights for individual
instrument tags, determined by the Workflow status of the tags. In this way, an
instrument engineer, while working on instrument data for a particular tag, can lock
out process engineers from making changes to process data until all the instrument
data has been entered.
Example Scenario
The following stages describe a typical Workflow scenario:
1. An instrument engineer creates a new instrument tag and determines whether or
not the tag requires process data. In the event that the instrument tag does require
process data, the process data fields of the tag become available to the process
engineers for editing.
2. The process engineer, after first accessing the instrument tag for editing of
process data, can lock the process data fields against any changes wherever the
instrument engineers have access rights.
3. On being released by the process engineer, the instrument engineer can now enter
instrument data as required. The instrument engineer can lock the tag against any
changes wherever the process engineers have access rights.
Related Topics
• Create a Workflow Browser, page 106
• Implementing Workflow, page 107
• Process Data Statuses, page 109
• Workflow Prerequisites, page 105

Workflow Prerequisites
Before you can implement Workflow in a given <unit>, the System Administrator and
Domain Administrator need to perform the following tasks:
• The System Administrator enables Workflow in your domain. For more

information, see the Administration module Online Help, System
Administration > Domain Management > Enable Workflow.
• The Domain Administrator defines two groups that will be responsible for
working in the areas of process engineering and instrument engineering.
For more information, see Creating a New Group Profile in Online Help
for the Administration module.
• The Domain Administrator does one of the following:
• Associates Windows groups with the SmartPlant Instrumentation
process engineering and instrument engineering groups. For more
information, see the Administration module Online Help, Users,
Departments, and Groups > Create a Group for Windows
Authentication Logon Method.
• Assigns users individually to the process engineering and instrument
engineering groups. For more information, see the Administration
module Online Help, Users, Departments, and Groups > Assign Users
to Groups.
• The Domain Administrator defines Workflow access rights for the process
engineering and instrument engineering groups. For more information,
see the Administration module Online Help, Domain And Project
Administration > Access Rights > Workflow Access Rights.
Note
• After initialization of a domain from a source or after a version upgrade, it
is essential to regenerate the library forms to enable the Workflow options
to be used in the Specifications Browser.
Related Topics
• Workflow: An Overview, page 104

Create a Workflow Browser

Important
• Workflow needs to be set up by an instrument engineer.
• Make sure that the System Administrator and the Domain
Administrator have prepared SmartPlant Instrumentation for
Workflow. For more information, see Workflow Prerequisites, page
105.
1. Open the Browser Manager.
2. Under Browser groups, double-click Workflow to expand the hierarchy.
3. Select the Instrumentation/Process Data Browser and create a new view.
4. Double-click the view to expand the hierarchy.
5. Click , and in the Style settings section, click Edit.
6. Select the check boxes in the View column to specify the fields to be displayed in
the view.
Important
• You must include the Process Data Status field among the fields
selected for displaying in the view.
7. Click Save.
8. Select the View level in the tree, and then click Actions > Open View.
The Browser View opens showing the process data statuses for all the instrument
tags in the database. For details, see Process Data Statuses, page 109
Related Topics
• Workflow Prerequisites, page 105

Implementing Workflow
Workflow implementation begins when the instrument engineer who is going to work
on particular instrument tags determines whether those tags require process data.
Next, those tags that do require process data are assigned to a process engineer for
process data input. On completion of the data input, the tags are reassigned to the
instrument engineer for instrument data input.
Enter Initial Instrument Data

1. Log on to SmartPlant Instrumentation as a user in the Instrument group.
2. In the Instrument Index module, create the instrument tags as you require and
enter appropriate data.
3. In the Browser Manager, under Browser groups, double-click Workflow to
expand the hierarchy.
4. Refresh the screen by clicking .
Any new instrument tags should be visible, with default status: Process Data
not Required.
5. In the Process Data Status field, select the required status of each instrument tag
you will be editing as follows:
a. For instrument tags that require process data, select status: Process Data
Required.
These tags will be available for the process engineer in the Process Data
and Calculation modules.
b. For instrument tags that do not require process data, select status: Process
Data not Required.
Enter Process Data for Instrument Tags

1. Log on to SmartPlant Instrumentation as a user in the Process group.
2. In the Process Data module, for each tag that requires the addition of process data,
do the following:
a. Find and open the tag.
b. In the Process Data window, enter process data as you require.
c. On the Actions menu, click Save Process Data.
d. In the Select a New Process Data Status dialog box, select Release to
Instrument, and click OK.

Enter Additional Instrument Data

1. Log on to SmartPlant Instrumentation as a user in the Instrument group.
2. In the Browser Groups list, Workflow, select the Instrumentation/Process
Data Browser and open the view you created for it.
3. For each tag for which you want to edit instrument data, make sure that the value
under Process Data Status is Lock out from Process.
4. In the Instrument Index module, do one of the following:
• Open each tag individually and enter the required instrument data.
• Create an appropriate Instrument Index browser view from which to
enter the data.
Related Topics

Process Data Statuses

There are five statuses that relate to tags under Workflow. The following table
provides a description of each status and which groups (instrument engineers or
process engineers) are allowed to set and change the status in the Workflow >
Instrumentation / Process Data Browser and in the Process Data module:
Status Description Set / Changed by

Process Data Tags that do not require process data and Set and changed by
not Required therefore are not available to the process instrument engineers
engineering group.
Process Data Tags available for process data entry by Set by instrument
Required the process engineering group (in the engineers Can be changed
Process Data module or Browser). by process engineers
Lock out from Tags marked for editing by the process Set and changed by
Instrument engineering group and not available to process engineers
the instrument group.
Release to Tags available to the instrument Set by process engineers
Instrument engineering group following release Can be changed by
from the process group. instrument engineers
Lock out from Tags not available to the process Set and changed by
Process engineering group. instrument engineers
Related Topics

Printing and Saving Documents: An Overview

You can print or save documents containing essential data from every module.
Documents that can be printed include all reports, and some visual presentations of
data such as point-to-point wiring diagrams. Selecting to preview a document
ensures that it will be printed the way you want and enables you to specify the file
format if you want to save the document.
Related Topics
• Editing Document Headers, page 120
• Modifying Printer Settings, page 117
• Previewing Documents, page 111
• Printing Documents, page 113
• Saving Documents, page 118
• Saving in DXF Format, page 119

Previewing Documents
The option to preview a document is available whenever you select a report, a point-
to point wiring diagram for printing, or if you select the Print Preview option from a
browser view.
Note
• The Print Preview dialog box appears only after you select Always or
Ask user in the General tab of the Preferences dialog box.
The Print Preview dialog box appears only after you select Always or Ask user in
the General tab of the Preferences dialog box.

Preview a Document
1. Select the report you want to display and when prompted to preview the report,
click Yes.
2. Click to adjust the currently displayed report's magnification level.
3. In the Zoom dialog box, do one of the following:
• In the Magnification section, select a predefined magnification level:
200%, 100% (the default level), 65%, or 30%.
• Type the required magnification level in the field next to the Custom
option button.
4. Click OK to return to the Print Preview window at the selected magnification.
5. In the case of reports consisting of several pages or multiple reports, navigate
using the following options:
Click... ...or on the View ...to do this:
menu, click
First Page Browse to the first page of a multi-page report. You can
also move through the pages of a report using the
vertical scroll box. Clicking the scroll box displays the
current page number.
Previous Page Browse to the previous page of a multi-page report
Next Page Browse to the following page of a multi-page report
Last Page Browse to the last page of a multi-page report
First Report Browse to the first report (available with multiple report
selection only).
On the View Browse to the previous report (available with multiple
menu, click report selection only).
Previous Report
Next Report Browse to the following report (available with multiple
report selection only).
Last Report Browse to the last report (available with multiple report
selection only).
Related Topics

Printing Documents
Depending on the options you selected, printing is available directly when you select
a document for printing, or you can print a document from a print preview. This
procedure refers to general printing. For details of batch printing to .pdf files, see
Previewing Documents, page 111.
Note
• If your default printer is Acrobat PDFWriter, you must perform the
following operation in the Registry Editor: in the registry path
HKEY_CURRENT_USER\Software\Adobe\Acrobat PDFWriter, set the
SZ Busy key value to NULL.
Print Documents
1. Select the desired items from which you can print reports, and on the appropriate
main menu or, if available, on a shortcut menu, click the report that you want to
print.
2. If a print preview prompt appears, do one of the following:
• Click Yes to display a print preview of one or more reports.
• Click No to print the reports directly to a printer or a file.
3. To print a report from a print preview to a printer or a file, do one of the
following:
• In the Print Preview window, click to print the currently selected

report.
• In the Print Preview window, click to print all the retrieved
reports or documents in batch mode.
Note
• If you choose to directly print a report without previewing it, and the
particular report usually includes printing parameters when viewed in the
Print Preview window (for example, selection of a group separator), a
dialog box opens to enable you to select those same parameters prior to
printing.
Related Topics

Batch Printing Documents to PDF Files

SmartPlant Instrumentation supports batch printing of the following documents to
.pdf files:
• Enhanced reports.
• Specification sheets.
• Binder packages from the Document Binder module.
Notes
• When printing .pdf files in batch mode for the above document types, you
must install GNU Ghostscript or Adobe Acrobat Distiller. You then open
the Preferences dialog box and under the General tab, select the
appropriate application from the PDF generator list.
• In general, SmartPlant Instrumentation supports batch printing to .pdf files
only for the above document types. It Is possible to print to .pdf files in
batch mode for other types of documents; however, the software cannot
create unique file names for each document and is liable to overwrite the
previously generated file, resulting in generation of the last report only in
the batch. In this case, to prevent this from occurring, you must configure
your printer settings to prompt for a file name for each document (for
details, see the user's guide for your specific printer).
Related Topics
• Setting Acrobat Distiller Batch Print Options, page 116
• Setting Ghostscript Batch Print Options, page 115

Setting Ghostscript Batch Print Options

When you print reports in batch mode using GNU Ghostscript, the software does not
create unique names for multiple output files (except for enhanced reports). For this
reason, you need to configure the driver settings so that the software prompts you to
enter a name for each report file.
Set the Ghostscript Batch Print Options

1. On the Windows taskbar, click Start > Settings > Printers.
2. Right-click Generic PostScript Printer, and on the shortcut menu, click
Properties.
3. Click the Ports tab.
4. Click Configure Port.
5. In the dialog box that opens, from the Output list, select Prompt for filename.

Setting Acrobat Distiller Batch Print Options

When you print reports in batch mode using Acrobat Distiller, the software does not
create unique names for multiple output files (except for enhanced reports). For this
reason, you need to configure the print settings so that the software prompts you to
enter a name for each report file.
Set the Acrobat Distiller Batch Print Options

1. Start Acrobat Distiller.
2. On the File menu, click Printing Preferences.
3. On the Adobe PDF Settings tab, select the check boxes Prompt for the PDF
filename and Ask to replace existing PDF file.

Modifying Printer Settings

This option enables you to view and modify the current printer settings, if required.
You can select a standard paper size with predefined width, height, and orientation or
customize these settings as required. Furthermore, you can save your settings as
default for future print sessions. You can customize your own paper width, height,
and orientation and include these values in the default settings. Note, that some
reports have their orientation hard-coded, therefore only the hard-coded settings will
apply.
Notes
• All your page settings apply to all reports and documents that you print
and they are true for all plant hierarchy levels (domain, <plant>, <area>,
and <unit>).
• All your page settings apply to your local machine only and do not affect
other users of SmartPlant Instrumentation.
• If you want to change the page setup for the current print session only, do
not click Default, just make your changes and click OK.
When saving your settings as default, the software stores the values in the intools.ini
file under the [PRINTER] section. If you want the software to calculate the required
paper size from the Windows printer driver settings, open the intools.ini file and
under the [PRINTER] section, remove the semi-colon before the following
parameters:
• LEFTMARGIN
• RIGHTMARGIN
• TOPMARGIN
• WIDTH
• HEIGHT
• ORIENTATION
• HRES
• VRES
Add a semi-colon before the PAPERSIZE parameter.
For additional information about this option, click Help in the Page Setup dialog
box.
Related Topics

Saving Documents
When you display a document, you can choose to save it as a file. This section
describes the various methods available for saving documents.
Save the Current Document to a File

1. With the Print Preview window open, click .
2. In the Save As dialog box, select one of the following data formats:
• Original: Saves the report data in all the fields, including the ones that
are not visible in the preview (for example, internal database ID
numbers). This option is recommended if you want to save the file in
.psr or .xls format, or if you want to re-import the data into SmartPlant
Instrumentation at a later stage.
• Data Only: Saves only the report data that is visible in the preview.
This option is recommended for easier viewing of the data, and also
enables you to manipulate the headers and select the columns you
want to display.
3. Click OK and navigate to the location where you want to save the file.
4. Select the required file format and type the name of the file, then click Save.
Related Topics

Saving in DXF Format

You can save any report in .dxf format for insertion into a CAD drawing (with
AutoCAD or MicroStation). This option is available when you select to save a
document as a file from a Print Preview window. On selecting to save the file in dxf
format, you can specify whether to include the title block and frame, whether to build
a script file for AutoCAD, and define certain other parameters for AutoCAD.
Save a Document in DXF Format

2. In the Save As dialog box, select DXF File.
3. In the Save As DXF Options dialog box, select Include title block and frame
with report to save the report with the title block (which includes the logo and
generic report data) and the frame. (Clear the check box to exclude the title block
and frame from the saved report if the CAD package has its own frame.)
4. If you are working in batch mode to save a number of files that are to be opened
in AutoCAD, you can automate the process as far as possible. Define the
parameters in the AutoCAD Options and User-defined options sections of the
dialog box as follows:
File Description
Insertion point The X- and Y- coordinates for the insertion point of the report in
the AutoCAD file define the displacement from the lower-left
corner of the AutoCAD file. The upper-left corner of the report is
inserted at this location.
Scale factor The scale factor determines the size of the report so that it will fit
into the AutoCAD drawing.
Font height Font height and width coefficients for the text characters in the
coefficient / Font report. This option is needed because the software calculates the
width coefficient font size independently of the size of the report, whereas
AutoCAD scales the font with the report as a whole.
Change black Type the value of the AutoCAD color to be used as a substitute
report color to for black. All reports are displayed in black-and-white. If
viewing the report in AutoCAD with a black background, an
alternative foreground color needs to be used. The recommended
value is 7.
5. Browse to the target folder and click OK.
Related Topics

Editing Document Headers

When you select to save a document as a file from the Print Preview dialog box and
you choose to save it as data only, you have the option of saving the data with or
without headers. Furthermore, if you select to include the headers with the data, you
can also edit them. This includes the possibility of exporting the headers to a separate
text file.
Edit the Headers for a Report

2. In the Save As dialog box, select Data Only.
3. Select the Allow Headers check box.
4. Select the Edit Headers check box and click OK.
5. Select the required file format and file path and click Save.
6. In the Edit Column Headers dialog box, select the Incl. check box for the
columns you want to include in the output file.
7. Under the Header Text column, edit the text as required.
8. Under the Width column, change the maximum text width (number of characters
allowed) as required.
9. If you want to save the header settings in this screen to a text file:
a. Click Export Headers.
b. In the Export to File dialog box, navigate to the required location and enter a
file name.
c. Click Save.
Note
• If an external header text file exists, you can click Import Headers to
load the data into the Export to File dialog box.
Related Topics

Customizing Title Blocks for Reports: An Overview
Customizing Title Blocks for Reports: An

Overview
Title blocks for reports are templates that SmartPlant Instrumentation uses for the
design of its reports. While the standard default title blocks supplied with the
software are adequate for many reports, you can also create your own custom title
blocks that provide you with the required design and layout of your reports. You can,
for example, customize report titles and headers, as well as the frame size of the title
block.
You first create a title block or duplicate it from an existing one using InfoMaker and
save it as a .psr file. You then open the .psr file in SmartPlant Instrumentation and
add it to the title block inventory. After that, you need to associate the title block
with the required reports and finally, generate a report through the relevant module
using the created title block.
Note
• It is usually more convenient to edit an existing title block and save it
under a different name rather than to create a new one.
Related Topics
• Requirements for Customized Report Title Blocks, page 122

Requirements for Customized Report Title Blocks

You can customize a title block for reports in InfoMaker. In either application, the
custom title block has to meet several standard requirements. The title block has to be
compatible with the report it is associated with. Therefore, make sure that the
customization process accurately fits the SmartPlant Instrumentation customizing
conventions as specified in the following topic.
The following list outlines mandatory and optional InfoMaker requirements:
Report type — When creating a new report set the report type to be External
(mandatory).
Report style — Set the report style to be Tabular (mandatory).
Field prompt — When prompted to set the required fields for a title block, type any
text in the appropriate field. There is no significance to inserting any particular field
name as long as something is typed (mandatory).
Group — The title block customization has to be performed in the Detail group
(mandatory).
Layer — Make sure that you create the title block in the Band layer (the default -
mandatory).
Design — The frame of the title block consists of four lines. Make sure that each
line has its own unique name typed in small caps as follows:
Upper side L_width

Lower side ln_down
Left side ln_left
Right side ln_right
Important
• When adding other design-related items, such as internal lines, text boxes,
and so forth, to the title block, make sure that the names of the new items
contain the tb segment. For example, if you want to add a new line, name
the line as <Line>_tb_<1>. This is required to distinguish between items
that belong to the title block and items that belong to the rest of the report
outside the title block.
Field type — select any field type other than Column (mandatory).
Revisions — Make sure that you have a number 1 revision field. For instance, a title
block with solely a revision no. 2, would not apply.

Report measurement units — The units of measure of the customized title block
must be compatible with the units of measure of the report it is associated with. All
the reports were created in inches except for the following, which use PowerBuilder
units:
• All the calculation reports

• The Segment map report
Fields — SmartPlant Instrumentation created an inventory of macros available for
the custom title block fields. From this inventory you can select the fields that serve
your purposes most. Each field and macro has its unique name (this is the name to
insert in the name field when creating the item in InfoMaker) as shown in the tables
below.
Notes
• Macros retrieve the data and enter it to the fields. For these macros to
function properly, you must insert the macro name accurately according to
the macro tables below.
• You can implement custom title blocks that for macros custom_1 through
custom_5 display field values without labels, for example, 'DCS-1' instead
of 'Panel DCS-1'. To enable this option, make sure that the [Custom]
section of the intools.ini file includes the line
'RemoveFixedTextFromTB=1'.
Table includes Text type fields only:
Field Name Field Description

custom_1 Report name
custom_2 – custom_5 Item names or other data used in reports or drawings.
For example, in a panel-strip report, custom_2 is used to
display the panel name, custom_3 is used to display the
strip name, and custom_5 is used to display the domain
name. All values that the software can retrieve for these
macros are hard coded. This means that even if you use
all of the custom fields, in the title block, fields that do not
have any associated hard coded data appear empty.
eproj_name Project name (Operating owner domain)
project_t Project header (Operating owner domain)
proj_name Domain name
proj_num Project number (Operating owner domain)
city_name City name
owner_name <Plant> owner.
location_name Location name


plant_hierarchy Plant hierarchy defined by the Domain Administrator. The
default plant hierarchy is Plant\Area\Unit. The Domain
Administrator has rights to change the number of plant
hierarchy levels and customize the level names.
hierarchy_item_name_x The name of a specific item in the plant hierarchy, where
the segment X defines the plant hierarchy level number.
For example, suppose that your plant hierarchy is
Plant\Area\Unit, and on the Unit level, you have an item
name Crude. To display Crude in the title block, you need
to substitute the segment X with the number 3.
plant_name The name of the item on the highest plant hierarchy level
(the default highest level is Plant).
plant_addr1 Address 1 of the highest plant hierarchy level item
plant_addr2 Address 2 of the highest plant hierarchy level item
plant_country Country of the highest plant hierarchy level item
plant_state State of the highest plant hierarchy level item
plant_zip ZIP code of the highest plant hierarchy level item
area_name The name of the item on the intermediate level of the plant
hierarchy (the default intermediate level is Area). If the
plant hierarchy has more than three levels, the macro
area_name retrieves the name of the lowest intermediate
level, that is one level above the lowest level of the plant
hierarchy.
unit_name The name of the item on the lowest level of the plant
hierarchy (the default lowest level is Unit).
hierarchy_udf_y_x A custom field value associated with a specific plant
hierarchy item. The segment y retrieves the number of the
custom field (the Domain Administrator can define up to
twenty custom field values for each plant hierarchy item).
The segment x retrieves the number of the level to which
the plant hierarchy item belongs.
hierarchy_udf_y_x_t Custom fields associated with a plant hierarchy item are
regular text fields and behave as any other custom fields
that are available in SmartPlant Instrumentation for
specific items.
hierarchy_udf_y_x_t The header of a custom field associated with a specific
plant hierarchy item. The segments y and x correspond to
the segments in the macro hierarchy_udf_y_x. The
segment t indicates the header.
tb_dwg_name_t Document number


lastrev Last revision
rev_no_1 – rev_no_9 Revision number 1 (mandatory field)
rev_udf_cXX_1 – Revision custom fields (for more details, see below)
rev_udf_cXX_9
create_by_1 – Created by
create_by_9
date_1 – date_9 Date
chk_by_1 – chk_by _9 Checked by
appr_by_1 – appr_by _9 Approved by
desc_1 – desc_9 Revision description
The following table includes Computed type fields only:
Field name Field Expression

description
C_page_num Current sheet Page()
C_page_count Total sheets PageCount()
comp_1 Logo name bitmap ( ProfileString ( "intools.ini", "Project",
"LogoPath", " " + "projlogo.bmp" )
Revision custom fields — You can define your own fields and related macros in
addition to those in the inventory of macros (designated for fields) that are supplies
with SmartPlant Instrumentation. You can add up to 20 revision custom fields per
title block. Inserting the right name in the field name box is necessary for the proper
function of the field in the title block. The naming convention for the revision custom
fields is as specified in the following table:
rev_udf_c01_t Header
rev_udf_c01_1 Data field
rev_udf_c01_2 Second data field under the same header
rev_udf_c02_t Header 2 (another UDF)
rev_udf_c02_1 The data in the field (2)

Document custom fields — Using these fields you can have a record of the
documents that were related to a certain report. These are fields that you define under
the following limitation: each custom field must have only two fields, one for the
header and one for the data. This is the naming convention for these fields:
dwg_udf_c01_t Header
dwg_udf_c01 Data field
dwg_udf_c02_t Header 2 (another custom field)
dwg_udf_c02 Data field (2)
Related Topics
• Customizing Title Blocks for Reports: An Overview, page 121
Edit Report Title Block Properties

You can edit report title block properties under two editing levels. The first is
internal and includes changing the revision custom field headers, document headers
and the title block name. The second level is external to SmartPlant Instrumentation
and includes changes in the design, replacing macros, fields, adding and removing
fields.
1. In the main SmartPlant Instrumentation window, on the Tools menu, click Title
Blocks.
2. In the Title Block dialog box, select the desired title block and click Properties.
3. In the Title Block Properties dialog box, do the following:
a. Under Revision custom field headers, in the Header column, type the name
for each custom field.
b. In the Title block name field, type the name that you have selected for the
title block.
c. Under Document custom field headers, in the Header column, type the
name for each custom field.
Tips
• If you want to modify the number of revisions of custom title blocks,
you need to add more revision rows and create appropriate macros in
InfoMaker. The Revision rows box displays the number of revision
rows that you have customized for your title block.
• For the second level of editing you can use an external editing
application (for example, InfoMaker). When editing title blocks, you
must follow the title block requirements.
Related Topics
• Requirements for Customized Report Title Blocks, page 122

PSR Files
PSR Files
SmartPlant Instrumentation provides you with a Power Soft Report (.psr) file viewer
that enables you to retrieve, view, and manage files saved in the .psr format. You can
create a .psr file when you want to save a report or a specification using the Save As
command. You can also view and edit .psr files in InfoMaker.
Related Topics
• Adding User-Defined Fields to PSR Files, page 134
• Managing the PSR File List, page 132
• Retrieving PBL File Reports, page 133
• Saving PSR File Data, page 130
• Viewing PSR Files, page 128
• Viewing PSR User-Defined Fields, page 136

PSR Files
Viewing PSR Files

This feature enables you to retrieve files saved in the .psr format and view their
contents. This way you can view specifications, reports, and forms which were saved
as .psr files.
You can:
• Retrieve a .psr report that is saved in a file. For details see Retrieving PSR
Files, page 129.
• Open a report from the PSR List window. For details see Opening PSR
Files from the PSR List, page 131.

PSR Files
Retrieving PSR Files

If you saved a report as a .psr file, you can navigate to that file and open it.
Retrieve a Previously Saved PSR File

1. Within any module, on the File menu, click Import PSR.
• Click .
• On the Actions menu, click PSR Viewer.
3. In the Select Report File dialog box, navigate to the desired .psr file and click
OK to display the content of the selected .psr file in the PSR File Viewer
window.
Related Topics
• Opening PSR Files from the PSR List, page 131

PSR Files
Saving PSR File Data

You can save data (for example, a .psr file or data from the database) to an external
file in any format supported by the PowerSoft format, for example: .psr, .wmf, .html,
.sql.
For general details of how to save data from a Print Preview window, see Saving
Documents, page 118
Related Topics

PSR Files
Opening PSR Files from the PSR List

This option enables you to select an existing .psr file from the list and view its content
in the PSR File Viewer window. The .psr file list is useful where you have a
permanent set of standard .psr files that you want to view frequently.
Open a PSR File From the PSR List

1. Within any module, on the File menu, click Import PSR.
• Click .
• On the Actions menu, click List.
3. In the PSR List window, select the .psr file you want to view in the PSR File
Viewer window.
4. Click .
Related Topics
• Retrieving PSR Files, page 129

PSR Files
Managing the PSR File List

You can manage the list of .psr files displayed in the PSR List window.
Manage .psr Files

1. In the PSR File Viewer window, click .
2. In the PSR List window, in the Description data field, type in a description to
characterize the selected .psr file.
3. Perform one of the following actions as required:
Click... ...to do the following:
Insert Append a new line where you can type in the path statement for an existing
.psr file.
File Retrieve a .psr file from a folder and add it to the list.
Delete Remove a .psr file from the list.
Path Set a new default path for all the files in the list. This option is useful if you
have moved all the .psr files in the list to the same folder and you need to
show the new location so that the files can be found. In this case, you do not
need to change each file path separately. At least one .psr file must already
be present in the required path.
Select Display the data for the highlighted file in the PSR File Viewer window.
Caution
• If you click Path and choose a new folder location for the .psr files,
the original paths that were displayed for the files will be overwritten.
You should therefore only use this option where you are certain that all
the files in the list are located in the same folder.
4. On completion of the required action, click Save.
Related Topics
• Retrieving PBL File Reports, page 133

PSR Files
Retrieving PBL File Reports

The .psr format allows you to save a multi-page report and nested reports (reports
which contain sub-reports or embedded objects). The .psr file format also enables
you to design your own reports in InfoMaker and use names of columns from your
database. You can then view the reports with the actual data by the PBL Viewer
option.
Important
• Prior to retrieving the reports from the appropriate .pbl file you need to
define the .pbl file location. To define the pbl file location, in the
intools.ini file [Custom] section, LibraryList parameter, you type the pbl
file path and one of the pbl files in the path.
Retrieve a Report From a PBL File

1. With the PSR File Viewer window open, click .
2. In the standard Select Source File dialog box, navigate to the required .pbl file
and click OK.
Important
• Make sure you select an appropriate pbl file, as the .pbl format is also
used for purposes other than storing reports.
3. In the DataWindow List pop-up window, scroll to the required data window and
select it.
4. Click to retrieve the appropriate column data from the database and display it
in the PSR File Viewer window.
Related Topics

PSR Files
Adding User-Defined Fields to PSR Files

When working with reports, you sometimes need to use extra fields in addition to
those currently available to you. A number of user-defined fields (named Udf C01,
Udf C02, and so forth.) are appended by default to every .psr file that you import.
The first step in making the user-defined fields appear in a report is opening the
report using a report generator, such as InfoMaker or MicroStation, and adding the
appropriate user-defined fields to that report.
After saving a report as a .psr file, you can retrieve your user-defined field values and
include them in the header of the desired report.
Add User-Defined Fields to a PSR File (Using InfoMaker)

1. Start InfoMaker.
2. Build a query for generating a report.
3. For each user-defined field that you want to add, do the following:
a. With the main report window open, click Insert > Control > Computed
Field.
b. Click the mouse pointer at the position where you want to place the computed
field on the report.
c. On the Modify Expression dialog box, under the Expression section, type an
expression according to the following syntax:
ProfileString("<SmartPlant Instrumentation home
folder>\intools.ini", "External
Report","<s_udf_name>","<s_udf_value>")
For example:
ProfileString("C:\Program Files\SmartPlant\Instrumentation\intools.ini",
"External Report","udf_C01","Not found")
Tip
• The 's_udf_value' parameter is used to specify a default string to
display where no value exists for the specified user-defined field.
d. At the right of the report, using the Position, Font, and Format tabs, make
the desired definitions for the user-defined field (for example, alignment,
positioning, color, style).

PSR Files
4. If you intend to display more than one .psr file in the SmartPlant Instrumentation
PSR List window, display the SQL data source, and under the where section, type
the following expression:
psr_storage.psr_stor_desc='<PSR description>.>
Caution
• Without adding this expression to InfoMaker, SmartPlant
Instrumentation always retrieves from the database the first row of
user-defined fields in the PSR List window, regardless of the report
you select. Make sure that the '< PSR description>' has the same value
as the value in the Description column of the PSR List window.
5. Save the current report as a .psr file.
6. Open SmartPlant Instrumentation.
7. With any main module window open, click File > Import PSR.
8. In the PSR File Viewer window, click to open the PSR List window.
9. Scroll to the right side of the window to view the user-defined columns and in the
columns Udf C01 to Udf C10, type the desired values.
10. Click Save to save your user-defined data to the database.
Related Topics

PSR Files
Viewing PSR User-Defined Fields

This option enables you to retrieve your user-defined field values from the existing
.psr files, and include these values in the header of the desired report within the
SmartPlant Instrumentation environment.
View PSR User-Defined Fields in a Report Header

Caution
• If more than one .psr file is displayed in the PSR List window, you must
open the desired report in InfoMaker, and under the where section, type
the following expression:
psr_storage.psr_stor_desc='<PSR description>
Without adding this expression to InfoMaker, SmartPlant Instrumentation always

retrieves from the database the first row of user-defined fields in the PSR List
window, regardless of the report you select. Make sure that the '< PSR
description>' has the same value as the value in the Description column of the
PSR List window. When done, save the changes to the report and close
InfoMaker.
1. From SmartPlant Instrumentation, do one of the following:
• Retrieve the desired .psr file. For details, see Retrieving PSR Files,
page 129, and on the PSR File View window toolbar, click .
• Open the desired .psr file from the PSR List window. For details, see
Opening PSR Files from the PSR List, page 131.
2. In the data window of the PSR List window, select a .psr file with user-defined
fields.
3. Do one of the following to open the PSR File Viewer window:
• Double-click the selected .psr file.
• On the toolbar, click .
• On the Actions menu, click Select.
4. On the PSR File Viewer window toolbar, click .
Tip
• For the selected file, the software copies the values in columns Udf
C01 to Udf C10 to the [External Report] section of the Intools.ini file
so that the appropriate user-defined field values appear in the report.
Related Topics

Displaying and Customizing Preferences

Use this procedure to display the default preferences or set your own preferences in
SmartPlant Instrumentation. Your preference settings do not affect the preferences
that were defined by other users in the current domain or working in the current
project, if the domain type is Operating owner.
Notes
• Domain Administrators have additional options that allow preferences
management from the Administration module.
• Certain interface options are governed by the intools.ini file. For more
information, see Preferences Governed by the .INI File, page 54.
View Or Customize SmartPlant Instrumentation Preferences

1. On the File menu, click Preferences.
2. In the tree view, beside a desired module, click to expand the hierarchy.
3. Click an option to open a specific page where you can view or customize
preferences.
Tip
• The Domain Administrator can restrict the ability of other users to set
their preferences. Therefore, you may find that you can only view
certain options but not change their values.

intools.ini
X and Y Positions of Certain Windows and Dialog Boxes — If you move a
certain window or dialog box in the screen area, the software saves the X and Y
positions of the window or dialog box in the Intools.ini file under the [Project]
section. This only applies to a small number of windows and dialog boxes.
The ID of the <Unit> Selected Last — When you select a specific <unit> on the
Open dialog box, the software records the <unit> ID in the Intools.ini file under the
[Project] section. The next time you start SmartPlant Instrumentation and display the
Open dialog box, the software displays the <unit> you selected last.
Filter Setting — When you specify a filter setting such as a data range, and then
restart the software, the software updates the date range in every SmartPlant
Instrumentation module in which you use the same filter.

Document Number and Revision Level Segregation — In the Instrument Index

Standard Browser, when you make a document revision in one <unit> and then log
on to another <unit>, both <units> share the same document number and set of
revisions. To specify a separate document number and set of revisions for the current
<unit>, open the Intools.ini file, and under the [Index] section, type the following
line:
DrawingPerLevel = Y
This setting is needed if, for example, you are publishing documents from different
<units>.
Suppression of Loop Equipment Propagation to Tag Numbers by Default —

When you create a new loop, you can specify whether to apply the P&ID, service,
and equipment to tag numbers. By default, these options are selected; however, you
can specify not to propagate these values to tag numbers that you subsequently
associate with the loop. To do so, open the Intools.ini file, and under the [Index]
section, type the following line:
LoopNoPropagateCheck = 1
This setting prevents the software from removing the equipment reference from tag
numbers that you associate with a loop that has no equipment reference.
Performance when Generating Enhanced Reports — Sometimes, the response

time between the application server and the database server is very slow when
generating enhanced reports. To improve this performance, open the Intools.ini file,
and under the [Loop] section, change the value of the DDETimeOut parameter to
20000. This parameter has units of milliseconds.
smartloop.ini
Hiding Macro Entities when Generating Enhanced Reports — If, for a default
macro such as a panel name, you define a filter that hides a particular macro, a dot
appears in place of the macro. The dot is needed to allow editing of the macro filter,
adding new macros to the item associated with the hidden macro, or editing of the
item. If you want to hide the dots, for example when printing the report or saving it
in a different format, you need to define the parameter HideItems = Y in the
Smartloop.ini file.
Related Topics

Preferences Dialog Box

Customizing preferences allows you to automate a number of procedures. Your
preference settings do not affect the preferences that were defined by other
SmartPlant Instrumentation users in the current domain or working in the current
The Domain Administrator can restrict the ability of other users to set their
preferences. Therefore, you can find that certain options are disabled. If you want to
enable these options, contact your Domain Administrator, who can manage
preferences from the Administration module.
Tree view — Click beside a desired module to expand the hierarchy, and then
click an option to open a specific page where you can set your preferences.
Pages — Using the options on the pages, you can view the default preferences set
by the Domain Administrator. Also, you can overwrite certain default preferences
with you own settings, provided that the Domain Administrator has not disabled these
preferences.
Reset — Resets all the properties for the selected module to their default values.
This option appears when you select a module or some of the other categories such as
Enhanced Reports, Interfaces, or SmartPlant, at the highest level of the tree view.
Reset all — Resets all the properties in the Preferences dialog box to their default
values.
Import — Imports the domain/project preferences from the intools.ini file.
Export — Saves the domain/project preferences to an external .dmp or .txt file.

General (Preferences)
The options on the General page of the Preferences dialog box enable you to
customize the SmartPlant Instrumentation interface and set general application
preferences. These settings do not affect the preferences that were defined by other
SmartPlant Instrumentation users in the current domain or working in the current
When customizing the general preferences, you can:
• Set the default locations of the main toolbar and the module toolbar.
• Set the toolbar and icon display.
• Automatically start SmartPlant Instrumentation with the unit and module
you last worked in.
• Set print preview options.
• Overwrite the default logo.
Note that the Domain Administrator can restrict your ability to set various
Select toolbar — Allows you to select the toolbar whose display options you want
to define: Main Toolbar or Module Toolbar.
Show toolbar — Makes the currently selected toolbar visible in the application.
Clear the check box to hide the toolbar.
Show toolbar text — Displays text with the icons in the currently selected toolbar.
Clear the check box to hide the text.
Toolbar position — The following options enable you to set the toolbar the position
on your screen. Click the desired option:
• Top— Places the selected toolbar along the top of the screen right under
the menu bar.
• Bottom— Places the selected toolbar along the bottom of the screen.
• Floating— Makes the selected toolbar float on your screen.
• Right— Places the selected toolbar along the right edge of the screen.
• Left— Places the selected toolbar along the left edge of the screen.

Automatic start of the last module — Starts SmartPlant Instrumentation

automatically in the lowest level plant hierarchy item in which you last worked.
After you select this check box, the software bypasses the Select Unit dialog box and
automatically opens the last module that you worked in. If several modules were
open when closing SmartPlant Instrumentation, the software treats the active module
as the last one.
Overwrite logo — Retrieves automatically the current logo from the database and
overwrites the projlogo.bmp file in the [SmartPlant Instrumentation home
folder]\temp folder. The projlogo.bmp file is from where SmartPlant Instrumentation
takes the logo which is used in documents and reports. If you clear the check box, the
software retrieves the logo from the original bitmap file – in this way the
projlogo.bmp file is not changed when switching to another domain, so that you use
the same logo. Clearing the check box also speeds up your work.
Print preview options — The following options enable you to set a print preview
option for report generation.
• Always— Opens print previews automatically, without prompting you for

confirmation.
• Never— Automatically spools reports to the output device, without
prompting you for confirmation.
• Ask user (default) — Prompts you to open a report print preview before
printing.
Current report preview options — The following options enable you to compare a
new report displayed in the Print Preview window with an existing archived report.
• Mark changes only— Marks the changes in the print preview of a new
report, if the currently previewed report is different from the archived
report.
• Generate changes report only— Generates a changes report after
comparing a new report with an archived report.
• Mark changes and generate changes report— Generates a changes
report after comparing a new report with an archived report and marks the
changes in the print preview of the new report.
Display license expiration reminder … days in advance — Allows you to specify
the number of days (between 1 and 37) prior to license expiration that the software
will display an advance warning.

Temporary folder path — Allows you to specify the path to the SmartPlant
Instrumentation temporary folder where the software stores the temporary logo and
custom files. Click Browse to navigate to the path.
For example:
C:\Program Files\SmartPlant\Instrumentation\TEMP
In the temporary folder, the software creates temporary files during various activities
that you perform in SmartPlant Instrumentation. For example, when you create
specifications, generate CAD drawings, hook-up drawings, or reports, and so forth.
Notes
• In the Specifications module, when you generate the Spec Forms report,
the software generates the report as the specprn.psr file and saves this file
to the folder you specify in the Temporary folder path box. If you leave
this box blank, the software saves the specprn.psr file to the SmartPlant
Instrumentation home folder and not to the PSR working folder path
preference (on the Specifications > Export/Import page).
• If your CAD application is MicroStation, make sure the path string does
not exceed fifty two characters. A longer path prevents MicroStation from
generating or displaying drawings or cells from SmartPlant
Instrumentation.
• If the System Administrator specified a global path in your domain, the
global path does not apply to the temporary folder path.
PDF generator — Enables you to select the PDF file generator that you installed
for generating IDEAL reports. Available options are: Acrobat Distiller and Generic
PostScript Printer. Selecting a PDF generator also allows SmartPlant
Instrumentation users to save specification sheets and specification binder packages
as .pdf files.
Output document folder — Enables you to specify the path to the folder where the
software generates IDEAL report files. Click Browse to navigate to the path.

Copy File Locations Dialog Box

This dialog box allows you to copy the file locations from one Enhanced Reports
module to another, for example; from Enhanced Loop File Locations to Cable
Layout File Locations.
Copy from — Choose from the list the enhanced report that you want to copy the
file locations from.
Copy to — Choose from the list one or more enhanced reports that you want to
copy the file locations to.
Select all — Select this option when you want to copy the file locations from one
enhanced report to all the enhanced reports.
Instrument Index > New Tag (Preferences)

These options allow you to customize the default tag number name template that
appears in the New Tag Number dialog box.
Define new tag name template — These options determine how SmartPlant
Instrumentation displays new tag number names in the New Tag Number dialog box
in relation to the previously created tag number.
• No default — The data field in the New Tag Number dialog box will
not display any default tag, letting you type the number you need.
• Same as the last created tag — The data field in the New Tag Number
dialog box displays the last created tag. You can accept the displayed
number, modify it, or type the number you need.
• Same as the last created tag + 1 — The data field in the New Tag
Number dialog box displays the last created tag plus 1 (one). You can
accept the displayed number, modify it, or type the number you need.
Note
• This option is available for numeric tag names only. If your tag names are
not numeric, the data field in the New Tag Number dialog box will
display the last created tag.
Ignore loop creation when creating new virtual tag — Allows you to create a
virtual tag without being prompted to create a loop associated with the new virtual
tag.
Use loop suffix in tag number name — Allows you to include the loop suffix in
the name of a newly created tag number.

Instrument Index > New Loop (Preferences)

The options in this dialog box allow you to customize the loop number name template
that appears in the New Loop Number dialog box. You can also choose to propagate
the loop service description to the loop drawing reference if desired.
Define new loop name template — These options determine how SmartPlant
Instrumentation displays new loop number names in the New Loop Number dialog
box in relation to the previously created tag number.
• No default — The data field in the New Loop Number dialog box does
not display any default loop, letting you type the number you need.
• Same as the last created loop — The data field in the New Loop
Number dialog box displays the last created loop. You can accept the
displayed number, modify it, or type the number you need.
• Same as the last created loop + 1 — The data field in the New Loop
Number dialog box displays the last created loop number incremented by
one. You can accept the displayed number, modify it, or type the number
you need.
• The last existing loop in the unit + 1 — The data field in the New Loop
Number dialog box displays the last existing loop number in the current
unit incremented by one. You can accept the displayed number, modify it,
or type the number you need.
• The last existing loop in the domain + 1 — The data field in the New
Loop Number dialog box displays the last existing loop number in the
current domain incremented by one. You can accept the displayed
number, modify it, or type the number you need.
Note
• The last three options are available for numeric loop names only. If your
loop names are not numeric, the data field in the New Loop Number
dialog box will display the last created loop.
Apply loop service to drawing description — Specifies that in the Loop Drawings
module, a loop service which you define for a loop appears in the Loop Drawing
List dialog box under the Description column. If you clear the check box, the
Description column remains empty.

Instrument Index > Profile (Preferences)

These options allow you to set the instrument type profile properties in the
Instrument Type Profile dialog box. You can deactivate certain instrument type
profile settings if you are working in a multi-user environment. This enables creating
new tag numbers on your station according to your local settings without affecting the
global selections made in the Instrument Type Profile dialog box.
Activate instrument type profile options — Activate instrument type profile

options in the Instrument Type Profile dialog box.
Clear the check boxes to deactivate instrument type profile options in the Instrument
Type Profile dialog box.
• Wiring— Wiring and I/O profile options.

• Instrument specifications— Instrument specification profile options
• Hook-ups— Hook-up profile options
• I/O type— I/O type profile options
• Location— Instrument location profile options
• Custom tables— custom table profile options
Instrument Index > Browse (Preferences)

These options allow you to set your preferences for the browse option in the
Instrument Index module.
Browser view options

Open the Instrument Index module in a browser view — Starts the Instrument
Index module with the default browser view in the browser designated for use with
the Instrument Index module (the Instrument Index Standard Browser or a suitable
PowerSoft Browser). If the Instrument Index module was the last module that you
worked in, and on the General page you selected Automatic start of the last
module, SmartPlant Instrumentation starts with this browser view.
Open the Browser Manager to define a default view before opening — Select
this check box to require the user to select a view in the Instrument Index Standard
Browser or a suitable PowerSoft Browser before opening this browser view. Clear
this check box to open automatically the browser view set as the default in the
specified browser.
Fluid phase for process data — Selects the fluid phase to use as default when
generating new process data sheets for the tags selected in the browser view. The
available fluid phase options are Liquid, Water, Gas/Vapor, Steam, Solid/Powder.

Instrument Index > Duplicate (Preferences)

These options allow you to set your preferences for tag number duplication and tag
creation when running batch loop creation from typical loops. Depending on the
preferences that you set, when duplicating tags, the software can do one of the
following:
• Create new conventional tags based on the instrument type profile of the
source tag number, and when running batch loop creation, create new
conventional tags based on the instrument type profile of the typical tag
number defined for the selected typical loop. You cannot create typical
tags based on the instrument type profile of the source tag.
• Create new tags based on the properties of the selected source tag number,
and when running batch loop creation, create new tags based on the
properties of the typical tags defined for the selected typical loop in the
Typical Tag Number Properties dialog box.
Tag duplication and batch creation options
Create new tags according to profile options — Select this option to do the
following:
• Create new duplicated tag numbers based on the instrument type profile of
the source tag number. Note that you also have to activate the required
profile options on the Profile page of the Preferences dialog box.
• Create new tags based on the instrument type profile of the typical tags
during batch loop creation. Note that you also have to activate the
required profile options on the Profile page of the Preferences dialog box.
Duplicate source tag data — Select this option to do the following:
• Create new tags based on the properties of the selected source tag number.
• Create new tags based on the properties of the typical tags defined for the
selected typical loop in the Typical Tag Number dialog box.
When duplicating a tag number, you can also include additional data associated with
source tag numbers. Select the appropriate check boxes below.
Note
• The following check boxes are not applicable when running batch loop
creation.
CAD blocks — Includes all the CAD block associations of the source tag, page
numbering in the loop drawing where the blocks are located, and the X, Y, Z offset
coordinates of the block in the loop drawings.

Instrument specifications — Includes all the instrument specifications associated

with the source tags. You can include the process data information in the source
specifications only if you select the Process Data check box as well.
Notes
• Instrument specifications are duplicated only if you select the Process
data check box too.
• When duplicating an instrument tag associated with a composite spec, the
software never duplicates the composite spec, regardless of the
preferences that you specify.
• When duplicating a loop, the software always duplicates the loop
composite spec.
Process data — Includes the process data information of the source tag. This
option is required if you want include tag source instrument specifications as well.
Wiring — Includes the entire wiring information of the source tag.
Include custom fields when copying (applicable for tag duplication and batch loop
creation) — Duplicates the tag number with the custom fields of the source tag.
Instrument Index > Delete Tag (Preferences)

These options allow you to set device cable and control system tag deletion options.
Also, you can enable batch tag deletion without being prompted to confirm the
deletion of each tag.
Delete device cables — Deletes all the device cables associated with the tag number
that you select to delete.
Delete associated control system tags — Deletes all the control system tags
associated with the tag you select to delete.
Change tag sequence — Allows you instruct the software to automatically update
tag sequence values in a loop when deleting a tag number.

Instrument Index > Rename (Preferences)

These options allow you to specify how the software implements renaming of tag and
loop numbers.
Tag number
Display old tag number automatically — Enables automatic display of the old tag
number in the Old tag number field of the Tag Number Properties dialog box.
Clear the check box to leave the Old tag number field empty.
Loop number
Display old loop number automatically — Enables automatic display of the old
loop number in the Old loop number field of the Loop Number Properties dialog
box. Clear the check box to leave the Old loop number field empty.
Apply loop number segment and suffix changes to tags — Enables you to apply
new loop segments to tags associated with this loop. After you change loop segments
in the Rename Loop Number dialog box, you can view both the old and the new list
of tag numbers for tags associated with this loop. Then, you can select those tags
whose segments will be changed automatically according to the loop segments.
Rename drawing file name when renaming the loop — Allows you to rename the
associated CAD drawing file names when renaming loop numbers. After you rename
a loop number, the software opens the Rename Loop Drawing File dialog box,
where you can change the drawing file names.
Instrument Index > Tag Properties (Preferences)

These options allow you to propagate line pipe spec data and P&ID drawing
reference to tag numbers that are associated with lines.
Propagate options
The options are:
Propagate options
Propagate P&ID drawing when assigning tags to lines — After selecting this
option, in the Tag Number Properties dialog box, the software automatically
displays the P&ID drawing reference that is associated with the line for the current
tag number.
Propagate line pipe spec when assigning tags to lines — After selecting this
option, in the Tag Number Properties dialog box, the software automatically
displays the line pipe spec that is associated with the line for the current tag number.

Instrument Index > Move (Preferences)

This option allows you to specify how the software deals with naming conventions
for tag and loop numbers that you move to another <unit>.
Naming conventions
Complete target tag or loop names using properties — If the target <unit>
naming conventions contain segments that do not exist in the source <unit> naming
conventions, the software can automatically complete the name for those segments
using the properties of the tag or loop number you are moving. Select this check box
to complete the name of the target tag or loop number using the property values.
For example, if you are moving Tag 101-FE – 100 to a <unit> that has a line number
segment in its tag naming convention, the software names the tag number in the target
<unit> as it was named in the source <unit> and retrieves the line number from the
tag properties to complete the line number segment.
Instrument Index > Custom (Preferences)

Use these options to customize features in the current module.
Custom features for the Instrument Index module

Parameter — Enables you to type the parameter for the feature that you want to
customize in this module.
Value — Type the value of the parameter.

Specifications > General (Preferences)

These options enable you to customize your preferences for the various options and
activities that you can perform in the Specifications module. These include:
• General options, such print options, process data changes notification, and
so forth.
• Multi-tag options, such as the master tag display, the SEE LIST label
customization, tag assignment to process data cases, and so forth.
• Opening a specification of an instrument tag selected in the browser view
for the Instrument Index module when starting the Specifications module
with the browser view open.
• Instrument tag creation and data copying options.
To access the general Specifications module preferences, in the Preferences dialog
box, in the tree view pane, click beside Specifications and then click General.
Use default print layout — This option affects the layout of the printout for multi-
tag specifications (Individual tag list page). When selected, the default grid layout
will be used, with one header per column. When cleared, a multi-line layout will be
used for the specification format, if defined. A multi-line layout can be customized to
display several headers per column, and the font and column sizes can be modified.
(Where no other format is defined, the default will be used whether or not this check
box is selected.)
Show notes — For specification and form data template reports, to include notes —
or reference to the notes — on the first page, select Show notes. To omit notes —
or reference to the notes — from the first page, clear Show notes.
Edit fieldbus columns in specs — Allows you to edit data displayed in fieldbus
columns in specification sheets. If you clear the check box, all columns related to
fieldbus data become non-editable in specifications.
Note, however, that although you can include fieldbus instruments in a multi-tag
spec, the software does not support editing of fieldbus columns in a multi-tag spec.
In a single-tag spec, you can only edit fieldbus columns if the instrument type of the
spec tag number is Fieldbus.
Print notes on a separate sheet — For specification and form data template
reports, to print the notes section on a separate page, select this check box. To print
notes as displayed, clear this check box. This setting also affects specifications that
you print as part of Binder Packages.
We recommend that you select this check box if the text in the Note box on the spec
data page is long, and the software displays a scroll bar in the Note box.

Process data changes notification — In order to have better synchronization

between users, it is prominent to be aware of the process data changes modifications
displayed in a specification for a certain instrument tag. You can set the software to
notify when the process data related to a certain tag has been changed. If process data
has been changed, the appropriate message appears when you open an existing
specification for that tag.
• Always (default) — The software notifies about process data changes,

regardless of whether the specification revision exists or not.
• Never— The software never notifies about process data changes.
• Only when spec revision exists— The software only notifies about
process data changes when the specification has a revision.
Multi-tag specification options
Show master tag — Select this check box to show the master tag number (in
parentheses) next to the multi-tag list in the Tag Number column of a multi-tag
specification.
Only governing case for multi-tag specs — Select this check box to specify that
only one tag in a multi-tag specification can be assigned to a case (the governing
case). This preference only applies to new multi-tag specifications that you create.
After you select the check box, when creating a multi-tag specification, only one
record of the same tag appears in the Multi-Tag tab of the specification.
Selecting this check box affects the way SmartPlant Instrumentation displays tag
records of the same tag that is assigned to multiple process data cases. For example,
in the Find Items dialog box of the Specifications module, when a tag is assigned to
multiple cases, the software only displays the governing case.
If you clear the check box, when you create a multi-tag specification, you can add of
the cases in the Multi-Tag tab of the specification.
Customize the SEE LIST label — Allows you to change the default label SEE
LIST, which appears in the main pages of a multi-tag specification. In a multi-tag
specification, the SEE LIST label appears in every field that the multi-tag list format
contains. You can enter any combination of alpha-numeric characters (up to 20
characters) or leave the box blank.

Moving and removing tags from multi-tag list

This option enables you specify how the software behaves when you remove a tag
from a multi-tag list, or move a tag from a multi-tag to a single-tag specification.
Skip individual confirmation — Select to skip a confirmation message each time

you remove a tag from a multi-tag list, or move a tag from a multi-tag list to a single-
tag specification.
Clear to display a confirmation message each time you remove a tag from a multi-tag
list, or move a tag from a multi-tag list to a single tag specification.

Open specification sheet — These options determine what happens when you click
with an instrument tag selected in the browser view.
• Always — If the selected instrument tag is already associated with a

specification, the specification is displayed automatically. If the selected
instrument tag is not associated with a specification, the Select
Specification Page dialog box opens, from which you can select the page
to be used to generate a new specification.
• Never — This option ignores the instrument tag selected in the
browser view and opens the Specifications dialog box as if you had
opened the Specifications module directly.
• Ask user (default) — This option prompts you to display the
specification. If you accept, the result depends on whether a specification
already exists for that tag. If the selected instrument tag is already
associated with a specification, the specification is displayed. If the
selected instrument tag is not associated with a specification, the Select
Specification Page dialog box opens, from which you can select the page
to be used to generate a new specification.
Tag creation — These options determine if the user can create new tags from the
Specifications module.
• Not allowed (default) — The user cannot create new tags from the
• Allowed— The user is able to create new tags in the Specifications
module.

Data copying options

This set of options allows you to specify how the software copies or imports data in
the following situations:
• Copying data from one specification to another

• Importing data from an external specification to the active specification
• Copying data from the active form data template to the current
specification
• Copying data from a specification to a form data template
Select one of the following options:
• Copy without overwriting existing data— Copies data without

overwriting data that already exists in the target.
• Copy excluding blank fields in source— Copies data except for source
fields that are blank. A blank field is a field that does not contain a value
or only contains spaces.
• Copy all fields— Copies all data fields, overwriting all target data fields.
If there is a source field that does not have a value or only has spaces, the
software updates the corresponding target field accordingly: if the target
field has a value, after copying data, this field becomes blank with no
spaces.

Specifications > Save as Excel (Preferences)

Generated file path — Allows you to enter the path to the folder where you save
specifications in Excel format. If you leave this box blank, the software saves the
Excel files in the default folder, which is <SmartPlant Instrumentation home
folder>\SaveAsExcel\ResultFiles.
Global path — Displays the global path set by the System Administrator.
Saving method — These options affect both batch mode and individual mode of
saving specifications in Excel format.
• Common Excel file for tags with the same form — Creates a unified
Excel file for all of the specifications based on a given form. This is the
default setting.
• Separate file for each tag— Creates an individual Excel file for each
specification.
Accuracy level — Allows you to define the number of digits that appear after the
decimal point in the Excel file. You can use the spinners or type the number of digits.
Delete temporary Excel files — Deletes working files that the software creates in
the process of exporting specifications in Excel format.

Specifications > Export/Import (Preferences)

These options enable you set preferences when saving specifications as .psr files.
Also, you can specify a default folder for exporting specification data to .isf files, or
for importing specification data from .isf files.
PSR options
PSR working folder — Click Browse to select a working folder in which to keep
specification page files (in .psr format). For best performance, define a folder on
your client computer. If you do not define a PSR working folder, the software keeps
the files in the temporary folder path that you specify under the general preferences.
Note
• The .psr files that the software generates when opening a print preview do
not get saved in this folder but in the temporary folder. You specify the
temporary folder path on the General page of the Preferences dialog box.
Overwrite PSR file — For best performance, make sure that this check box is
cleared. In some network configurations, however, a .psr working file may not be
properly updated from the database. In such a case, select this check box to overwrite
.psr files every time that you save specifications. Note that when you select this
check box, the performance of the software can slow down.
ISF export/import
Default export/import folder — Click Browse to select a folder that you want to
set as your default .isf file folder. The software will display this folder automatically
in all dialog boxes where you need to select a folder for importing data from .isf files,
or for exporting data to .isf files.
Specifications > Custom (Preferences)

Custom features for the Instrument Specifications module

If, in the Report Management dialog box of the Administration module, the Domain
Administrator assigned the template title block Specs default TB with PB Units to
specifications, you need to place the title block correctly in the layout of a spec page.
To do so, enter the TitleFooterHeight parameter and define a value.

If you use the template title block Specs default TB with PB Units in specifications
you create using SmartPlant Instrumentation options, the optimal value is 798. If you
created a spec page in InfoMaker, you may need to enter a different value, depending
on your page layout settings.
Wiring > General (Preferences)

The general preferences for wiring allow you to enforce name uniqueness for wiring
items.
Name uniqueness
Enforce name uniqueness — Select this check box to enforce the name uniqueness
for wiring items.
Wiring > I/O Card (Preferences)

These preferences allow you to determine if the software will allow to create multiple
wiring equipment items or just one item under a vacant slot.
To access these preferences, in the Preferences dialog box, in the tree view pane,
click beside Wiring and then click I/O Card.
Assign slots for racks

• All slots (vacant and occupied)— Allows you to create multiple wiring
equipment items or double-width I/O cards under vacant slots.
• Vacant slots only— Allows you to create only one wiring equipment
item per vacant slot. The software will not allow you to add a double-
width card or another wiring equipment item under an occupied slot.
Wiring > I/O Assignment (Preferences)

These preference options enable you to determine the I/O types of the instrument tags
that become available in the I/O Assignment window. One setting allows you to
make all instrument tags be available in the I/O Assignment window regardless of
their I/O type. The other setting limits the availability of instrument tags only to
those instruments whose I/O type is identical to the I/O type of the current I/O card.
Note that after you effect an I/O assignment and your preference was set to the Same
I/O type for tag and I/O card, you can still change the I/O type of the I/O card if
you need to do so. The software does not verify the compatibility of a changed I/O
type with instrument tags already associated with I/O cards.

click beside Wiring and then click I/O Assignment.
I/O assignment validation

• Same I/O type for tag and I/O card — Limits the I/O type of the
instrument tag to be the same as the I/O type of the I/O card selected in the
I/O Assignment window. Note that the software validates I/O type
compatibility also upon connection.
• All I/O types — Allows the selection of all instrument tag I/O types in
the I/O Assignment window and upon connection.
Wiring > CS Tags (Preferences)

These options allow you to set the appropriate Control System tag name uniqueness
level. Control System tag name uniqueness can be set on the plant level or can be
customized. You can also choose to define your Control System tag names as not
unique.
click beside Wiring and then click CS Tags.
CS tag name uniqueness level — Use these options to determine at what level in
the Wiring module the software prevents duplication of a Control System tag name.
• Custom— Allows access to the following options where you can set the
Control System tag name uniqueness level separately for each Control
System, or for tag names not assigned to I/O cards.
• Per plant— Allows the use of a specific CS tag name in the plant only
once.
• Not unique— Allows the use of the same CS tag name more than once at
any level in the plant.
DCS
The following options allow you to set the required uniqueness level for a Distributed
Control System (DCS):
• Plant— Set uniqueness at the plant level.

• Panel— Set uniqueness at the panel level.
• Terminal strip— Set uniqueness at the terminal strip level.
• Not unique— Allow use of the same Control System tag name at any
level.

PLC
The following options allow you to set the required uniqueness level for a
Programmable Logic Controller (PLC):
• Plant— Set uniqueness at the plant level.

• Panel— Set uniqueness at the panel level.
• Terminal strip— Set uniqueness at the terminal strip level.
• Not unique— Allow use of the same Control System tag name at any
level.
Unassigned CS tag
The following options allow you to set the required uniqueness level for Control
System tag names of tags that are not assigned to I/O cards:
• Unique— Allow the use of a CS tag name of an unassigned tag only

once.
• Not unique— Allow the use of the same CS tag name for any tag that is
not assigned to an I/O card.
Wiring > Copy Items (Preferences)

This preference allows you to determine whether to include jumpers, internal
connections, and cable lengths when duplicating wiring items.
click beside Wiring and then click Copy Items.
Include when copying items

Duplicate jumpers — Select this check box to include source panel jumpers in the
duplication process. Clear this check box to exclude source panel jumpers when
duplicating a panel.
Retain cable length — Select this check box to retain the cable length property
when copying or duplicating a cable. Clear this check box (default value) not to
retain the cable length of the source cable.

Copy internal connections — Select this check box to preserve the internal
connections within a copied item. This means that the software will retain the cables
and cross wires that connect among the various terminal strips within the item that
you are copying or duplicating.
Note that SmartPlant Instrumentation performs the operation described when

duplicating an item or when copying items from the Reference Explorer to the
Domain Explorer or from the Domain Explorer to the Reference Explorer as
follows:
• Cross wires and cross-cables— The software does not duplicate or copy
any cross wires or cables whose wires are also used to connect terminal
strips that are located outside of the terminal strip that you are copying.
• System cross-cables— Internal connections that use system cross-cables
are duplicated even when other wires belonging to that cable are
connected to other items.
• User-created cross cables— Internal connections that use cross cables
created by users will be duplicated as long as all the wires of the user-
created cross cable are connected internally to the selected item. If there
are wires connected to another item, the user-created cross cable will not
be duplicated.
• Cables— Cables connected only on one end and not connected on their
other end will be duplicated when copying an item to which the cable is
connected. For example, when copying a junction box, the connected
cable will be duplicated if the multi-pair cable that is connected on the
terminal strip is not connected on its other end. Device cables will not be
duplicated if they are connected to device panels.
• Jumpers — When duplicating jumpers, your Duplicate jumpers
preference setting overrides all other settings. Therefore, the software
duplicates jumpers only if you select the Duplicate jumpers preference.
• Naming conventions— When the software creates a copy of a cable
during a duplication of an item, it uses the following naming convention:
Copy of +<source cable name>.

Wiring > Jumpers (Preferences)

This option allows you to set SmartPlant Instrumentation to name jumpers
automatically using the default naming format.
click beside Wiring and then click Jumpers.
Automatic naming
Name jumpers automatically — Allows you to select name jumpers automatically.
Select this check box in the following cases:
• When making connections using connection types whose definitions

contain jumpers. In this case, the software automatically names the
created jumpers using the following default format: J<first terminal
name>/<second terminal name>. For example, J1+/3sh. You cannot
modify the default format.
Clear this check box to name new jumpers by incrementing the jumper
number, for example J1/1, J1/2 and so forth.
• When adding new jumpers to a terminal strip in the Connection window.
In this case, the software suggests a jumper name in the New Jumper
Connection dialog box. The suggested jumper name is based on the
default format mentioned in the previous paragraph. You can accept the
suggested name or type another jumper name as needed.
Clear this check box to prevent the software from suggesting jumper
names when making new jumper connections on the New Jumper
Connection dialog box.
Propagate tag signal through jumpers — Allows you to instruct the software to
propagate tag signals through jumpers. If you do not select this preference, the
software will not propagate tag signals through jumpers.

Wiring > Reports (Preferences)

These preferences allow you to fine-tune the printing of wiring reports.
click beside Wiring and then click Reports.
General settings for Panel-Strip and I/O Map reports

Show wire tag and color in separate columns — Adds an additional column to
panel-strip reports. Adding an extra column improves the display of the cable, cable
set, wire, and color fields.
Include unclaimed As-Built items — Includes in the reports not only items
claimed for a specific engineering project, but also the items that have not been
claimed.
Restart pagination for each terminal strip when not previewing the report —
When not previewing a report before printing, restarts the pagination of the report for
each terminal strip. (This preference is available for reports with adjacent
connections only.)
Include channel information in Panel-Strip reports

I/O channels — Includes all the channels that are child items of terminal strips
under I/O cards.
Apparatus — Includes all the apparatus channels.
Channels — Includes all the channels that are not child items of terminal strips
under I/O cards.

Wiring > Cross Wiring (Preferences)

These options enable you to change the definitions for the matching signals whose
strips you cross-wire automatically.
click beside Wiring and then click Cross Wiring.
Automatic cross-wiring — These options determine how the software
• Different strips, same panel— Performs automatic cross- wiring of two

signals between two different strips belonging to the same panel (this is
the default selection).
• Different panels (no DCS or PLC panels)— Performs automatic cross-
wiring of signals between two strips belonging to two different panels in
the current plant, except for strips with channels (that is, I/O cards).
• Different panels including DCS or PLC panels (terminal sequence
connection) — Performs automatic cross-wiring of signals between two
strips belonging to two different panels in the current plant, including
strips with channels where the connection will be done according to the
terminal sequence that is shown in the dialog box. Note that we do not
recommend using the third option unless you are absolutely certain that
this option will select matching signals. In any case, do not forget to
change the setting back to the default (Different strips, same panel) when
done!
Default wire color — Select the required wire color from the list. Selecting the
default wire color determines the cross-wire color in the Connection window. The
wire color data in the list is retrieved from the Wire Color dialog box.
Wiring > Custom (Preferences)

Custom features for the Wiring module


Process Data > General (Preferences)

The options on this page allow you to customize various options in the Process Data
module. You can enable automatic conversion of values when changing the units of
measure, select the default gas/vapor, liquid/water fluid state properties. You can
also determine how a process data sheet opens in the browser view.
To access the general Process Data module preferences, in the Preferences dialog
box, in the tree view pane, click beside Process Data and then click General.
General options
Convert units of measure automatically — Select this check box to automatically
convert numerical data when changing the units of measure.
Enable velocity auto recalculation — Select this check box to automatically

recalculate the velocity parameters for a control valve.
Highlight required process data properties — Select this check box to

automatically highlight the required fields in the Process Data window. Note that in
the Calculation module, the software also highlights the same fields in a calculation
sheet.

Open process data sheet — These options determine what happens when you click
• Always— Always opens a process data sheet for the tag selected in the
browser view when you open the Process Data module.
• Never— Never opens a process data sheet for the tag selected in the
browser view when you open the Process Data module.
• Ask user (default) — Prompts you whether you want to open a process
data sheet for the tag selected in the browser view when you open the
Process Data module.
Tag creation — Select an option to determine whether users are allowed to create
new instrument tags in the Process Data module.
• Allowed— Allows users to create new instrument tags in the Process

Data module.
• Not allowed— Prohibits users from creating new instrument tags in the
Process Data module.

Process data report display options — Allows you to determine how the software
displays the Notes field on the report by varying the area on the report taken up by
the custom fields. The available options are:
• Full-length custom fields — Each custom field occupies a full row in

the report. Select this option to display the Notes field in the minimum
available area.
• Short custom fields — Each group of custom fields occupies a single
row of the report. Select this option to display the Notes field in an
intermediate-sized area of the report.
• No custom fields — Custom fields do not appear on the report. Select
this option to display the Notes field in the maximum available area.
Process Data > Custom (Preferences)

Custom features for the Process Data module

Calculation > General (Preferences)

These options enable you to customize preferences for opening calculation sheets.
To access the general Calculation module preferences, in the Preferences dialog box,
in the tree view pane, click beside Calculation and then click General.

Open calculation sheet — These options determine what happens when you click
• Always— Always opens a calculation sheet for the tag selected in the
browser view when you open the Calculation module.
• Never— Never opens a calculation sheet for the tag selected in the
browser view when you open the Calculation module.
• Ask user (default) — Prompts you whether you want to open a
calculation sheet for the tag selected in the browser view when you open
the Calculation module.

Tag creation — Select an option to determine whether users are allowed to create
new instrument tags in the Calculation module.
• Allowed— Allows users to create new instrument tags in the Calculation

module.
• Not allowed— Prohibits users from creating new instrument tags in the
Calculation module.
Calibration and Maintenance > Custom (Preferences)

Use these options to customize features in the Calibration module.
Custom features for the Calibration module

Loop Drawings > General (Preferences)

These options enable you to define various general loop drawing preferences and
some drawing preferences that are specific to the CAD program that you are using.
Plot drawing — Enables you to set the default option for printing CAD loop
drawings at the time of generation. After you select this check box, the software
automatically prints loop drawings you generate using your CAD application. This
preference affects the Send to plotter or printer check box selection on the CAD
Options tab of the Generate Loop Drawings dialog box.
Notes
• This preference does not affect printing loop drawings generated using the
Enhanced Report Utility.
• If you do not want to print CAD loop drawings but save them
automatically at the time of generation, clear this check box and then
specify the output drawing folder path on the Preferences > Loop
Drawings > CAD File Locations page.
• Regardless of this check box setting, when generating a batch of CAD
loop drawings, the software only opens the CAD drawing generated last in
the batch. It is not possible to set the software to open a print preview of
every CAD loop drawing when generating multiple loop drawings.
Generate null macro list — Select this check box to generate a list of macros that
are used in the Macro report but which do not return a value when executed.

Generate undefined macro list — Select this check box to generate a list of macros
that are used in the Macro report but are not found in the SmartPlant Instrumentation
database.
Use macro functions — Select this check box to enable the use of macro functions
with macros in CAD drawings. You define macro functions in the Loop Drawings
module, in the User-Defined Macro Functions dialog box.
Display references to wiring reports automatically — Select this check box to

display references to wiring reports generated in the title block of a specific CAD
drawing. After generating a report in the Wiring module, a reference to this report
appears automatically in the Document Reference dialog box, where you can add a
reference description.
Explode block in AutoCAD — Enables you to edit the loop drawing by separating
the drawing block into elements.
Create error.log file — Select this check box to create the error.log file in the
location specified on the General preferences page under Temporary folder path.
This file is created during the loop generation process.
Use macro symbol (&) to retrieve data — Select this option according to the CAD
program you are using:
• For SmartSketch users — Always select this check box because in

SmartSketch all macros have the `&' prefix. If you clear the check box,
only the macro strings will appear in the drawings.
• For AutoCAD users — Select this check box if you have manually added
the `&' prefix to the macros. Any macros that do not have the `&' prefix
do not retrieve data in AutoCAD drawings but are displayed only as macro
strings.
MicroStation version — Select your MicroStation version from this list. The
available options are: MicroStation 95 and MicroStation SE/J.
AutoCAD macro result type — Select the required macro result from the list. This
way you determine the macro result type in AutoCAD while generating a loop
drawing. You can set the macro result type as Text or as Attribute.
Revision macro order — Select the relation between the order of revisions and the
order of the macros that you have set in the title block. The options are:
• Ascending— In ascending order, macro number 1 contains the first added

revision, so that the last added revision appears at the bottom of the list in
the title block.
• Descending— In descending order, macro number 1 contains the last
added revision, so that the last added revision appears at the top of the list
in the title block.

Generation options — Select your default preferences for generating new loop
drawings. You can change these preferences manually when defining loop drawing
generation settings in the Generate Loop Drawings dialog box. From the list, select
one of the following:
• Per loop — Enables you to generate drawings using the loops selected in
the Loop Explorer.
• Per page — Enables you to type a desired page number in the Page
number box in the Generate Loop Drawings dialog box and generate the
specified drawing page only.
• Per block — Enables you to select a block from the Block name list in
the Generate Loop Drawings dialog box and generate loop drawings
only for the loops that use this block.
Default generation method — Allows you to specify the default method for
generating loop drawings from the Domain Explorer. The software uses the default
generating method if you do not specify any generation method for the loops you
select in the Domain Explorer. The following methods are available:
• Enhanced Report — Generates enhanced loop drawings using the

Enhanced Report Utility. When you select this option, you specify the
details of the generation method and other application-specific options on
the Enhanced SmartLoop - View and Enhanced Reports - File
Locations preferences pages.
• SmartSketch — Generates loop drawings using Intergraph SmartSketch
as the CAD program. You must specify the appropriate file locations on
the Loop Drawings - CAD File Locations preferences page. You can
also specify application-specific options on this page.
• AutoCAD — Generates loop drawings using AutoCAD as the CAD
program. You must specify the appropriate file locations on the Loop
Drawings - CAD File Locations preferences page. You can also specify
application-specific options on this page.
• MicroStation — Generates loop drawings using MicroStation as the
CAD program. You must specify the MicroStation version on this page
and the appropriate file locations on the Loop Drawings - CAD File
Locations preferences page. You can also specify other application-
specific options on this page.
Date format — Type the date format for display in any loop drawing after
generation. The valid date formats are the same as the formats you use in Windows,
for example, dd/mm/yy, mm/dd/yyyy, and so forth).

Loop Drawings > CAD File Locations (Preferences)

These options enable you to define the default paths for generating and saving loop
drawings using your CAD application: SmartSketch, AutoCAD, or MicroStation.
Note for MicroStation Users

• MicroStation paths must not have spaces. Paths with spaces prevent
MicroStation from generating or displaying drawings or cells from
SmartPlant Instrumentation. If you installed MicroStation in the default
Program Files folder, you must reinstall MicroStation in a path that does
not have spaces.
CAD folder — Click Browse to navigate to the folder containing the executable file
of the CAD application installed on your computer. For example:
C:\Program Files\SmartSketch\program
CAD configuration folder — Click Browse to navigate to the folder containing the
CAD configuration file of the CAD application installed on your computer.
CAD function folder — Click Browse to navigate to the folder containing the CAD
function files. For example:
C:\Program Files\SmartPlant\Instrumentation\CAD\CADFunc
Note
• If your CAD application is SmartSketch, the CADFunc folder contains a
shipped file pid.igr. This is a template file on which all your SmartSketch
drawings are based. The default print sheet size is defined in the pid.igr
file as A3 Wide. If you want to generate drawings using a different print
sheet size, you must open the pid.igr file in SmartSketch and modify the
sheet settings as you require. Changes that you make in the pid.igr file
affect both loop drawings and hook-up drawings you generate in
SmartSketch. If you want the print sheet size of loop drawings not to
affect the print sheet size of hook-up drawings, duplicate the CADFunc
folder with all its content and define a different path setting preference for
hook-up drawings on the Hook-Ups > CAD File Locations page.
Important
Instrumentation. If your CAD function folder path is longer than allowed,
you need to copy the CADFunc folder and its content to another location,
for example, C:\CAD\CADFunc.

Open drawing files from — Click Browse to navigate to the default folder from
which saved loop drawings are to be opened. For example:
C:\Program Files\SmartPlant\Instrumentation\CAD\DWG
Drawing block folder — Click Browse to select the path to be used as the default
for new block files. For example:
C:\Program Files\SmartPlant\Instrumentation\CAD\Blocks
Save drawings automatically — Enables you to define the default path for saving
CAD loop drawings automatically as files at the time of generation.
Output drawing folder (available after selecting Save drawings automatically) —

Enables you to click Browse and then specify the default path for saving CAD loop
drawings automatically as files at the time of generation. The path that you specify
appears on the General tab of the Generate Loop Drawings dialog box when you
select the CAD generation method. On the Generate Loop Drawings dialog box,
you can modify the path for a specific generation. When generating a batch of loop
drawings using the As previously applied option on the Generate Loop Drawings
dialog box, the software always uses the preference setting. The following setting is
an example of the default folder where you want the software to save all your CAD
loop drawings automatically:
C:\Program Files\SmartPlant\Instrumentation\CAD\My CAD Loop
Drawings
The file format of the saved files depends on the CAD application you have selected.
Loop Drawings > Custom (Preferences)

Custom features for the Loop Drawings module


Browser > Reports (Preferences)

These options enable you to define the printing preferences for the Browser module
reports.
Printing without preview

These options allow you to customize your printout when printing without a preview
if the total column width exceeds the width of your page.
Print all columns if exceeding page width — Select this option if the width of
your paper cannot accommodate all the columns of the report. When you select this
option, the software prints out subsequent pages containing the additional columns
that do not fit the width of the first page. If you do not select this option and your
report has more columns than the width of your paper can allow for, only the columns
that fit the paper width are printed out.
Show first column on each page — If you selected Print all columns if exceeding
page width, you can select this option to print out the first column on every page of
the report. This is helpful for showing on each printed page which items the rest of
the data belongs to.
Browser > Fonts (Preferences)

These options enable you to set the font properties of the headers and body text in all
windows in the Browser module, including report sheets.
Font — Select a font from the list of available Windows fonts.
Font style — Select a font style from the list of available styles: Regular, Italic,
Bold, or Bold Italic.
Size — Select a font size from the list of available font sizes.
Sample — Indicates the appearance of the font according to the properties that you
have selected.
Reset — Resets the SmartPlant Instrumentation font defaults for body text in the
Browser view and in the Print Preview window in the Instrument Index module.
The font defaults are:
• Font – MS Sans Serif

• Font style – Regular
• Size – 8

Browser > Custom (Preferences)

Custom features for the Browser module

Hook-Ups > General (Preferences)

These options allow you to customize general hook- up drawing preferences, such as
generation settings, drawing block path, macro symbol, and so forth. Also, you can
set tag association preferences and preferences for displaying a prompt message when
removing a hook-up type from an instrument type. Note that you define the CAD
program and file locations for hook-ups under the Loop Drawings preferences.
General drawing preferences — You use these options to define your general
drawing that appears on the second and all other subsequent sheets of any multi-sheet
hook-up drawings that you generate. You must define these options to enable the
General drawing option in CAD tab of the Generate Hook-Up Drawings dialog
box.
Drawing block name
Enter the required block name as follows, depending on the CAD application
installed on your machine:
• For Enhanced Report Utility — Type the name of the drawing block
that you have selected in the Drawing block file name and path box.
• For MicroStation — Type the name of the cell in the cell library that
you have selected in the Drawing block file name and path box.
• For SmartSketch or AutoCAD— The value in this field appears
automatically after you specify the drawing block file name and path.
Drawing block file name and path
Click Browse to navigate to the required file or enter the required file name as
follows, depending on the CAD application installed on your machine:
• For Enhanced Report Utility— Type the exact path of a .dwg file.
• For SmartSketch— Type the exact path to a .sym .dwg or .dgn file.
• For AutoCAD— Type the exact path of a .dwg file.
• For MicroStation— Type the exact path of a cell library (.cel file).

Global path
Displays the global path set by the System Administrator.
Use global border/logo
Select this check box when you do not have your own border and logo, in order to use
the Default General Blocks dialog box options to specify the border and logo for all
of your hook-up drawings. Note that if you already have your own border and logo in
the hook-up drawings, selecting the check box and defining the border and logo in the
Default General Blocks dialog box cause the software to display two borders and
two logos in the same hook- up drawing.
Clear this check box to insert the border and logo using your CAD application. This
check box is only available after selecting Enable hook- up drawing generation.
Use macro symbol (&) to retrieve data
• For SmartSketch — If you use SmartSketch, you must select this check
box because in SmartSketch all macros have the & prefix. If you clear the
check box, the software displays only macro properties in the drawings.
• For AutoCAD — Select this check box if you manually added the &
prefix to the macros. Note that in this case, macros that do not have the &
prefix do not retrieve any data in AutoCAD drawings but are displayed
only as macro properties.
Revision macro order
Select the relation between the order of revisions and the order of the macros that you
have set in the title block.

the title block.
in the title block.
Tag association — Select the allowed assignments of tags to hook-ups.
• Limit to a single hook-up type— Restricts the assignment of each tag

number to one particular hook-up only.
• Limit to a single hook-up type— Restricts the assignment of each tag
number to one hook-up type only.
• Do not limit— Allows you to assign each tag to any hook-up without
restriction.

Remove hook-up type from instrument type
Display prompt messages
Select this check box if you want the software to prompt you before removing a
hook-up type from an instrument type.
Hook-up units of measure — Determine whether you can assign a unit of measure
name or code to a hook-up item when defining or modifying hook-up item properties.
The software displays codes or names of hook-up item units of measure in the Item
Properties dialog box, in the Units of measure list.
Display names
Allows you to display the names in the Units of measure list.
Display codes
Allows you to display the codes in the Units of measure list.
Default generation method — Allows you to specify the default method for
generating hook-up drawings from the Domain Explorer. The software uses the
default generating method if you do not specify any generation method for the hook-
ups or hook-up types you select in the Domain Explorer. The following methods are
available:
• Enhanced Report— Generates hook-up drawings using the Enhanced

Report Utility.
• SmartSketch— Generates loop drawings using Intergraph SmartSketch
as the CAD program.
• AutoCAD— Generates loop drawings using AutoCAD as the CAD
program.
• MicroStation— Generates loop drawings using MicroStation as the CAD
program.
Hook-Ups > CAD File Locations (Preferences)

These options enable you to define the default paths for generating and saving hook-
up drawings using your CAD application: SmartSketch, AutoCAD, or MicroStation.
Note for MicroStation Users

• MicroStation paths must not have spaces. Paths with spaces prevent
MicroStation from generating or displaying drawings or cells from
SmartPlant Instrumentation. If you installed MicroStation in the default
Program Files folder, you must reinstall MicroStation in a path that does
not have spaces.

CAD folder — Click Browse to navigate to the folder containing the executable file
of the CAD application installed on your computer. For example:
CAD configuration folder — Click Browse to navigate to the folder containing the
CAD configuration file of the CAD application installed on your computer. For
example:
CAD function folder — Click Browse to navigate to the folder containing the CAD
function files. For example:
C:\Program Files\SmartPlant\Instrumentation\CAD\CADFunc
Note
• If your CAD application is SmartSketch, the CADFunc folder contains a
shipped file pid.igr. This is a template file on which all your SmartSketch
drawings are based. The default print sheet size is defined in the pid.igr
file as A3 Wide. If you want to generate drawings using a different print
sheet size, you must open the pid.igr file in SmartSketch and modify the
sheet settings as you require. Changes that you make in the pid.igr file
affect both hook-up drawings and loop drawings you generate in
SmartSketch. If you want the print sheet size of hook-up drawings not to
affect the print sheet size of loop drawings, duplicate the CADFunc folder
with all its content and define a different path setting preference for loop
drawings on the Loop Drawings > CAD File Locations page.
Important
Instrumentation. If your CAD function folder path is longer than allowed,
you need to copy the CADFunc folder and its content to another location,
for example, C:\CAD\CADFunc.
Open drawing files from — Click Browse to navigate to the default folder from
which saved hook-up drawings are to be opened. For example:
C:\Program Files\SmartPlant\Instrumentation\CAD\DWG
Drawing block folder — Click Browse to select the path to be used as the default
for new block files. For example:
C:\Program Files\SmartPlant\Instrumentation\CAD\Blocks

Copy file locations from CAD loop drawings

Copy — Copies file location preferences set on the Loop Drawings > CAD File
Locations tab. This overrides all the existing settings that appear on the current tab.
Save drawings automatically — Enables you to define the default path for saving
CAD hook-up drawings automatically as files at the time of generation.
Output drawing folder (available after selecting Save drawings automatically) —

Enables you to click Browse and then specify the default path for saving CAD hook-
up drawings automatically as files at the time of generation. The path that you
specify appears on the CAD Options tab of the Generate Hook-Up Drawings dialog
box when you select CAD as a generation method or use the As previously applied
option to generate a batch of hook-up drawings in mixed mode. On the CAD
Options tab of the Generate Hook-Up Drawings dialog box, for a specific
generation, you can modify the default path setting if needed. The following setting
is an example of the default folder where you want the software to save all your CAD
hook-up drawings automatically:
C:\Program Files\SmartPlant\Instrumentation\CAD\My CAD Hook-Up
Drawings
The file format of the saved files depends on the CAD application you have selected.
Hook-Ups > Reports (Preferences)

These options allow you to set or customize item display options in certain reports
that you can generate in the Hook-Ups module.
Tag display level — You can set the software to display tag numbers on the highest
or lowest level of your plant hierarchy. This setting apply to BOM, Hook-Up Tag list
report, and hook-up drawings. Note that in the Domain Explorer or Hook-Up
Explorer, tag numbers and other items are always displayed on the lowest plant
hierarchy level. The default highest level is Plant. The default lowest level is Unit.
The Domain Administrator makes plant hierarchy level definitions in the Plant
Hierarchy dialog box of the Administration module.
• Highest plant hierarchy level — Allows you to display tag numbers in

reports on the highest level of the plant hierarchy. This way you include
in a report all tag numbers that appear in all <units> that belong to the
current highest plant hierarchy level item.
• Lowest plant hierarchy level — Allows you to display tag numbers in
reports on the lowest level of the plant hierarchy, that is, tags displayed in
the Domain Explorer or Hook-Up Explorer for the current <unit>.
Show pipe spec names in reports — Select this check box to display the pipe spec
names of pipe specs associated with hook-up sub- libraries.

Bill of Material
Hide item number row when total quantity is zero — Allows you not to include
in BOM the item number whose quantity is zero.
Enable the use of edit mode — Allows you to select the Edit mode check box in a
BOM print preview.
Sort hook-up items in generated drawings — Use these option buttons to

determine how the hook-up items are sorted in reports.
• By item number— Allows you to sort the hook-up items in order of the
item numbers.
• By item order— Allows you to sort the hook-up items by their order of
their assignment to a hook-up.
Hook-Ups > Custom (Preferences)

Custom features for the Hook-Ups module

Document Binder > General (Preferences)

Printing and revision location — These options determine whether you can work
with SmartPlant Instrumentation during generation of revisions or preparation of
document packages for printing. The options are:
• Client— Select if you are working with a client installation of SmartPlant

Instrumentation.
• Remote server— Select if you use APITools to generate revisions and
prepare document packages for printing.
Include external documents in page numbering — Select to include in the page
numbering external documents that appear in a General Document Binder package.
Clear the check box to include only SmartPlant Instrumentation documents in the
page numbering. Note that the option to include external documents only applies
when you set the page numbering options for General Document Binder packages to
Consecutive page numbering for all documents.

Document Binder > Specification Binder (Preferences)

These options enable you to customize viewing format for the Specification List in
the Document Binder window.
Select instrument specification list display — These options determine the

specification list layout setup in a print preview and how it is printed. The options are:
• Fixed columns— Use to display the specification list with a fixed set of
pre-defined columns. The orientation of the list is portrait when printed.
• User defined columns from Browser module— Use to display the
specification list with the columns defined in the default view for the
Document Binder Browser group. The orientation of the list is landscape
when printed.
Revision options
When removing instrument specifications, delete associated specification binder
revisions — When you remove an instrument specification from a Specification
Binder package, select this check box to specify deletion of Specification Binder
package revisions. Clear the check box to keep the revisions when you remove the
instrument specification.
View instrument specification and specification binder revisions independently

— Select to view separate listings for revisions of a specification when it was
independent and when it was part of a Specification Binder package. This means that
in the Document Binder module, a specification displays only revisions created since
you added it to the Specification Binder package, and in the Specifications module,
the specification displays only revisions created before you added it to the
Specification Binder package.
Clear to view a unified revision listing. This means than in either module, when you
open a given specification, it displays all revisions that you created for that
specification.
Change report options — These options determine how the software compares the
current report with previous revisions. The options are:
• Compare current report with last revision only— When running a

comparison report, the software always compares the current report with
the last saved revision.
• Compare current report with any previous revision— When running a
comparison report, the software allows you to select a previously saved
revision to compare with.

Re-order tags automatically by tag number when adding new instrument

specifications. — Select to display the tags in tag number order after adding new
instrument specifications to the Specification Binder package. Clear the check box to
display the tags in the order that they were added to the package.
Document Binder > General Document Binder (Preferences)

This option determines the format in which the software displays reports. Your
selection only affects those reports for which an option exists to display them as
enhanced reports or as standard SmartPlant Instrumentation reports.
Report display format

Enhanced reports (where available) — When selected, displays the report as an
enhanced report, if the specified report is available in this format. When cleared,
displays the report using the standard (PowerSoft) report format.
Document Binder > Custom (Preferences)

Custom features for the Document Binder module

Calibration and Maintenance > General (Preferences)

These preferences allow you to set the default point at which the software performs a
loop error calculation. These settings do not affect the preferences that were defined
by other SmartPlant Instrumentation users in the current domain or working in the
current project, if the domain type is Operating owner. Also, it is possible to set
preferences that determine how the software defines maintenance event record names
when users create such records in As-Built.
To access these preferences, on the Preferences dialog box, in the tree view pane,
click Calibration and Maintenance > General.

Validations
Validate mandatory fields for data entry — Select to generate warning messages
where the user does not enter data values in mandatory fields; clear to ignore any data
that is missing in those fields.
Loop error calculation

Calculation method — Select a calculation method from this list to determine how
a loop error will be calculated. The options are:
• Ask user — Select to open the Loop Error Calculation Method dialog
box, where you can select the desired loop error calculation method.
• Normal— Select to calculate a loop error automatically according to
normal values.
• Absolute— Select to calculate a loop error automatically according to
absolute values.
• Root Mean Square— Select to calculate a loop error automatically
according to root mean square values.
Calculate at point — Type a number from 1-100 or use the spinners to enter the
default percentage point at which the software performs the loop error calculation.
Tag settings
Enable clearing of tag settings — Select to allow clearing of the tag calculation
values.
Reports
Display AF and AL graphs in the Instrument Calibration Result report to print
all pages of this report including the As Found and As Left graphs that appear on the
second page of the report. Clear the check box to print only the tabular data that
appears on the first page of the report.
Define maintenance event record name by

The following options enable you to determine how the software defines a name for a
maintenance event record that you can create in the Instruments folder of the
Domain Explorer. Names of maintenance event records accept up to fifty
characters.
• Tag number, then event date— The maintenance event records are
displayed as follows: 101 -FT -100 02-03-07.
• Event date, then tag number— The maintenance event records are
displayed as follows: 02-03-07, 101 -FT -100. We recommend that you
select this option if you instrument tag number strings are long. When you
create a maintenance event record, the record name characters that exceed
sixty characters are truncated.

• Event date only— The maintenance event records are displayed as

follows: 02-03-07.
Note
• If you set the software to create maintenance event record names using a
combination of tag number and date, the software automatically inserts a
space character between the tag number and date. The date format
depends on the Maintenance event date format preference.
Maintenance event date format — Allows you to specify a date format that the
software uses when defining names of maintenance event records. The valid date
formats are the same as the formats you use in Windows, for example, dd/mm/yy,
mm/dd/yyyy, and so forth).
Calculation > Custom (Preferences)

Custom features for the Calculation module

Enhanced Reports > General (Preferences)

Use these options to customize the display of items for all enhanced report types
before generation. Also, you can set your preferences for the generation status
window.
General
Show generation status window — Select to show the generation status window
when generating enhanced reports. Note that the items that appear in the window do
not reflect the actual items that in the reports after generation.
Display warning message when closing document — Select to display a warning

message in the Enhanced Report Utility whenever you close a report. Clear this
option if you do not want to receive a warning message every time you close a report.
View
View-only mode — Select to open the report in view-only mode. Clear to allow
editing of the report, redlining, saving, and so forth.
Display color property of cross wires — Select to display labels indicating the
colors of cross wires where defined. Clear to hide the color labels.

Sort wires by wire sequence in set — Select to sort wires according to the
sequence number in the cable set. Clear to sort wires according to the wire IDs. If
you are not sure that the wire IDs match the actual sequence of the wires, for
example, if you imported cable data or added wires manually, it is recommended that
you select this option.
Split strip display between sheets — Select to display strips in a split manner
between two sheets where those strips would otherwise appear on the margin of one
of the drawing sheets.
Enlarge terminals with multiple connections — Select to enlarge terminals with

multiple connections so that you can view all the multiple connections separately.
When a terminal has several connections, the software duplicates this terminal as
many times as there are connections and displays this terminal as one item that
contains several terminals attached underneath each other.
Replace missing symbols with default terminal symbol — Select to replace all
terminal symbols that the software cannot find with the default terminal symbol
term.sym. Clear this check box to display the text `Symbol is missing' for all terminal
symbols that the software cannot find.
Drawing
Disable macro generation and annotation options — Select to disable macro
generation in enhanced reports and also to disable macros, SmartText and redlining.
Disabling these options speeds up report generation.
Gap connectors on intersection — Select to specify that connector lines that are
crossed appear in generated enhanced reports with gaps on intersections. The
connector that appears with a gap is the connector that is generated second. Clear this
option to speed up report generation.
By-pass strips — Select to re-draw any connector lines that intersect strips so that
those connector lines by-pass the strips. Clear this option to speed up report
generation.
Redraw all connections — Select to redraw all the connectors on the sheet to
minimize the number of connector overlaps and intersections. Clear this option to
speed up report generation.
Optimize overlapping connectors — Select to separate overlapping connectors

from one another. Clear this option to speed up report generation.
Optimize overlapping wires and cable sets — Select to separate the lines that
represent different sets and wires of a particular cable where they overlap one
another. Clear this option to speed up report generation.

Enforce wiring connections to opposite sides of adjacent terminals — Select to

force the Enhanced Report Generator to always draw wiring connections from the
right side of one terminal to the left side of the adjacent terminal when the
configuration was wired between the left sides of both terminals, or between the right
sides of both terminals.
Set loop drawing orientation from right to left — Select to generate the drawing
with field devices drawn at the right edge of the drawing sheet. Clear to generate the
drawing in the conventional way with the with field devices drawn at the left edge of
the drawing sheet.
Copy file locations — Opens the Copy file locations dialog box to allow you to
copy the data on the File Locations tab of a specific enhanced report type to one or
more other enhanced report types.
Enhanced Reports > Layers (Preferences)

SmartPlant Instrument allows you to predefine up to six different layer names for use
when generating reports in the Enhanced Reports utility. These layers can then be
used to display different attributes of your drawing, such as symbols, texts, wiring
and so forth. You can then select to see one specific layer or a combination of certain
layers. These layers can then be transferred to Autocad and MicroStation formats
when saved as an external file.
Use these options to customize the names of the layers used in enhanced reports.
Layers
Shows a list of the enhanced report layers.
Name — Describes the use of the layer.
Value — Type your own names for each layer as desired.
Note
• If you leave a field value empty, the layer will not be available for
selection. Any items that would be created on the unnamed layer are
created on the default layer instead.

Enhanced SmartLoop > View (Preferences)

Use these options to customize the display of items in Enhanced SmartLoop reports
before generation.
Retrieve last saved position — Select to enable the Save Position command in the
Enhanced Report Utility and display drawing elements in the positions where they
appear on the drawing before this command is implemented. Clear this check box to
display generated drawing elements in their default positions.
Display options
All jumpers — Select to display all the jumpers between the entry and exit points of
a signal on a cabinet. Clear to display one line for all the midway jumpers.
Overall shield connected to another strip — Select to display the overall shield
connected to another strip. If you clear the check box, this strip is not displayed.
DCS / PLC attributes — Select to display the attributes of DCS / PLC devices
when placing them on the drawing layer. The displayed attributes are: whether it is
connected to a CS tag, channels, number of slots and cabinet name.
Unconnected DCS / PLC terminals — Select to display unconnected DCS / PLC

terminals. If you clear the check box, the software replaces the terminals with a
break-in-sequence symbol.
Unconnected Apparatus terminals — Select to display unconnected Apparatus

Panel location — Select to display the panel location in its unit, on the drawing
layer (for example Field, Control room, and so forth).
Terminal discontinuity — Select to display a gapping symbol which indicates

discontinuity in a sequence of terminals. A gapping symbol appears between
terminal symbols wherever there is a gap in a terminal sequence.
Loop drawing reference — Select to display on the report a reference to an

external drawing.
CS block when tag has no wiring — Select to display Control System tags that are
assigned to the generated loop where those Control System tags do not have wiring
connections.

Instrument list — Select to display a list of instruments on the report that do not
have wiring. When displaying the list, the following options are available:
• All instruments in loop— Displays instruments that are included in the

loop wiring as well as non-wiring instruments.
• Non-wiring instruments only— Displays only those instruments that are
not included in the loop wiring.
Channel items — Select to display channels with the channel names at the
appropriate positions on the strip.
Connector representation
Default layout — Set the desired connector representation for the default layout.
Select one of the following:
• Diagonal— Represents connectors as straight diagonal lines between the

short horizontal lines that come from the terminals.
• Orthogonal— Represents connectors as lines consisting of horizontal
and vertical sections.
Cross wiring — Set the desired connector representation for cross- wiring
connections. Select one of the following:

Note
• When generating an enhanced report with many connectors, where the
layout settings for the connectors are set to diagonal, the connector names
do not appear directly over their respective connectors.

Panel-Strip > View (Preferences)

Use these options to customize the display of items in Panel-Strip reports before
generation.
Display options



Left-most strip descriptions on the left — Select to place all the descriptions of
the leftmost strips to the left of the strips. Clear this check box to retain all the
descriptions of the leftmost strips above the strips.


Cross wiring — Set the desired connector representation for cross-wiring

Note
Wiring Equipment Connections > View (Preferences)

Use these options to customize the display of items in Wiring Equipment Connections
reports before generation.
Display options





Note

Segment Wiring > View (Preferences)

Use these options to customize the display of items in Segment Wiring reports before
generation.
Display options


General signals assigned to segment — Select to display general signals such as

power supplies or multiplexed wiring, that are assigned to wiring segments.

Virtual tags — Select to display the existing virtual tags in a generated segment
wiring report.


Cross wiring — Set the desired connector representation for cross-wiring

Note
Communication Line > View (Preferences)

Use these options to customize the display of items in Communication Line reports
before generation.
Display options




Note

Internal Cross Wiring > View (Preferences)

Use these options to customize the display of items in Internal Cross- Wiring reports
before generation.


Note

Fieldbus Loop > View (Preferences)

Use these options to customize the display of items in Fieldbus Loop reports before
generation.
Display options



Loop drawing reference — Select to display on the report a reference to an

external drawing.
CS block when tag has no wiring — Select to display Control System tags that are
assigned to the generated loop where those Control System tags do not have wiring
connections.

Instrument list — Select to display a list of instruments on the report that do not
have wiring. When displaying the list, the following options are available:
• All instruments in loop— Displays instruments that are included in the

loop wiring as well as non-wiring instruments.
• Non-wiring instruments only— Displays only those instruments that are
not included in the loop wiring.

Cross wiring — Set the desired connector representation for cross - wiring

Note
Network Class > View (Preferences)

Use these options to customize the display of items in Network Class reports before
generation.

Display options


Cross wiring — Set the desired connector representation for cross - wiring

Note

Strip Signals > View (Preferences)

Use these options to customize the display of items in Strip Signal reports before
generation.
Display options






Note
Single Speaker > View (Preferences)

Use these options to customize the display of items in Single Speaker reports before
generation.
Display options


Report end point level — Select to specify whether to report the end point level
from Amplifier or DCS.


Note
Enhanced PA Amplifier > View (Preferences)

Use these options to customize the display of items in PA Amplifier reports before
generation.
Display options




Note
Cable Block Diagram > View (Preferences)

Use these options to customize the display of items in Cable Block Diagram reports
before generation.

Enhanced Reports > Hook-Ups > View (Preferences)

Use these options to customize the display of items in enhanced hook-up drawings
before generation.
Display options
Use these options to display a tag list and an associated item list on your hook-ups
drawing.
Tag list — Select this check box to display the tag list on your hook-ups drawing.
Clear the check box not to show the tag list.
Associated item list — Select this check box to display the associated item list on
your hook-up drawing. Clear the check box not to show the associated item list.
Symbol Editor > View (Preferences)

Use this option to customize the display of items in the Symbol Editor.
Display options
Origin point — Select this check box to display the origin point of any symbol that
you open in the Symbol Editor. Clear the check box to hide the origin point.
Enhanced Reports > Custom (Preferences)

Custom features for enhanced reports


Enhanced Reports > Drawing (Preferences)

Use these options to specify the default report generation method, drawing area units
and spacing of rows and columns. These options apply to Enhanced SmartLoop or
Fieldbus Loop reports only.
Generation method
Select the default generation method to use when you do not specify a generation
method in the Loop Explorer for a particular loop.
• By Loop— Displays items such as strips that are common to a number of

signals once only on the drawing.
• By Signal— Displays each signal path separately on the drawing so that
common items such as strips appear repeatedly; once in each signal
representation.
• Custom by Loop — Displays Enhanced SmartLoop or Fieldbus Loop
reports using custom symbols that you define for each item and allows you
to specify the placement of the symbols on the drawing sheet by
displaying the Domain Explorer in the Enhanced Report Utility and
dragging items from it onto the drawing sheet.
• Custom by Signal— Displays Enhanced SmartLoop or Fieldbus Loop
reports using custom symbols and showing separate signal paths.
Display each signal on separate page — (available for By Signal and Custom by
Signal options only)
Select to display each signal path on a separate drawing sheet.
Group by location (available for By Signal and Custom by Signal options only) —
Select to organize panels or strips that belong to the same location in the same
column of the drawing, if possible.
Drawing area parameters — When you select the Custom by Loop or Custom by
Signal generation method for a particular loop, the drawing area parameters allow
you to specify the optimum spacing between separate graphical elements on the
drawing sheet. The optimum spacing can vary according to the sizes of the symbols
that you use.
Units — Select the units to specify for the spacing values: inches, millimeters, or
twips.
Row spacing — Type a value to specify the spacing between rows on the drawing
sheet.

Column spacing — Type a value to specify the spacing between columns on the
drawing sheet.
Reset — Resets the drawing area parameters with default values of 0.79 inches and
1.77 inches for row and column spacing respectively.
Enhanced Reports > File Locations (Preferences)

Use these options to set the file paths for the default layout, symbols, logo bitmap,
and output files for the selected report type. These file paths apply to all generated
enhanced reports of the selected report type.
Template for default layout — Allows you to select the .sma file that you want to
use as the page template for the selected report. Type the path and file name in the
box or click Browse to navigate to the file. For example:
C:\SmartPlant\Instrumentation\RAD\Template\A4wide.sma< /p>
The following is a list of standard .sma files that SmartPlant Instrumentation supplies:
Template File Description

A3tall.sma A3 portrait
A3wide.sma A3 landscape
A4tall.sma A4 portrait
A4wide.sma A4 landscape
Atall.sma 11 in x 8.5 in letter portrait
Awide.sma 11 in x 8.5 in letter landscape
Btall.sma 11 in x 17 in portrait
Bwide.sma 11 in x 17 in landscape
Title block for default layout — Allows you to select the .sym file that you want to
use as the default title block in the template. Type the path and file name in the box
or click Browse to navigate to the file. For example:
C:\SmartPlant\Instrumentation\RAD\Templates\Types\Loop\
Loop_Wide.sym
Logo file — Allows you to select the .sym file that you want to use as the logo in
the default title block. This logo does not appear on enhanced reports automatically.
You need to perform a procedure in the Enhanced Report Utility to save the logo as
part of the default layout. Type the path and file name in the box or click Browse to
navigate to the file.

Viewer output folder — Use this option to define the folder where the software
saves the output files when your default printer is specified as a viewer (Acrobat
PDFWriter, Acrobat Distiller, or Generic PostScript Printer). When you generate
new enhanced reports and print to a file in batch mode (without previewing the
reports before printing), the software saves the files in this path using the item names
in the native viewer format. Click Browse to select a path and enter that path to the
field. For example:
C:\SmartPlant\Instrumentation\RAD\My Batch Drawings\
If you do not specify any path, the software saves the files to the location specified on
the General preferences page under Temporary folder path.
Automatic save options — Save reports automatically — Select to save the

specified enhanced reports automatically as files at the time of generation. If you
clear the check box, the software prints the reports at a printer when you generate
them without a print preview.
Save without printing — This option becomes available when you select Save
reports automatically. When you select this option, the software automatically
saves reports that you generate without a print preview but does not print them at
your printer. If you clear the check box, the software saves and prints the reports at a
printer when you generate them without a print preview.
Output report folder — Click Browse to navigate to the default folder where you
want the software to save all your enhanced reports automatically. For example:
C:\SmartPlant\Instrumentation\RAD\My Drawings\
Save as type — Select the file type for saving enhanced reports automatically.
Symbol folder — Allows you to define the default folder for all the .sym files that
appear as items on generated enhanced reports. Type the folder name in the box or
click Browse to navigate to the folder. For example:
C:\SmartPlant\Instrumentation\RAD\Symbols\
Custom symbol folder — Allows you to define the default folder for all the .sym
files that you use for Enhanced SmartLoop and Fieldbus Loop reports when using the
Custom by Loop or Custom by Signal generation method. Type the folder name in
the box or click Browse to navigate to the folder. For example:
C:\SmartPlant\Instrumentation\RAD\Symbols\Custom\

Enhanced Reports > File Locations (continued)

(Preferences)
Use these options to set the file paths for the symbols used for instrument list tables.
Symbol for instrument list table header — Allows you to select the .sym file that
you want to use as the header symbol for the table used to display a list of instruments
on the report. Type the path and file name in the box or click Browse to navigate to
the file.
Symbol for instrument list table details — Allows you to select the .sym file that
you want to use as the symbol for the table rows used to display a list of instruments
on the report. Type the path and file name in the box or click Browse to navigate to
the file.
Enhanced Reports > Fonts (Preferences)

These options allow you to set the font properties of the headers and body text for all
enhanced reports of the selected report type. Also, the font style and size become the
default settings of SmartText, macro attributes and names of SmartPlant
Instrumentation items. Note that the font options do not affect the title block or other
external data such as channel information. To change the font size of the title block
in a enhanced report, edit the corresponding title block symbol (for example,
loop_wide.sym).
Font — Select a font from the list of available Windows fonts. Note that if you
select a font other than a TrueType font (indicated by a TT symbol), the text appears
in the Enhanced Report Utility with a yellow-green font, regardless of any subsequent
change you try to make to the font color in the Enhanced Report Utility. It is
therefore recommended to choose a TrueType font.
Font style — Select a font style from the list of available styles: Regular, Italic,
Bold or Bold Italic.
Size — Select a font size from the list of available font sizes.
Sample — Indicates the appearance of the font according to the properties that you
have selected.

Reset — Resets the SmartPlant Instrumentation font defaults. These defaults are:
• Font – MS Sans Serif

• Font style – Regular
• Size – 8
Enhanced Reports > Title Block (Preferences)

The options on this page allow you to determine the default alignment of the title
block, the relative position of the drawing area, and the working area margins for all
enhanced reports of the selected report type.
Alignment — Displays the position of the title block origin and the edges of the
drawing area on the page, when you use a symbol file (.sym) as the title block. Drag
the title block icon to the position you require. You can position the title block in any
corner of the drawing or at the center of any of its edges. Note that the alignment
does not change the orientation of the title block.
Horizontal — Select the horizontal alignment for the title block origin: left, center,
or right. Note that you cannot select center for both the horizontal and vertical
alignments.
Vertical — Select the vertical alignment for the title block origin: top, center, or
bottom. Note that you cannot select center for both the horizontal and vertical
alignments.
Drawing area relative to title block — Specifies where the drawing area should be
located in relation to the title block origin. For example, if you place the title block at
the bottom left corner, you can place the drawing to the right of the title block, above
the title block, or above and to the right of the title block. If you place the title block
at the center of any of the edges of the drawing, you can only specify one position for
the drawing.
Reset — Resets the title block in its default position at the bottom left corner of the
page, with the drawing area above the title block.
Size — Allows you to specify the area of the drawing sheet that the title block can
occupy by setting its maximum size.
Units — Select the units to specify for the title block height or width: inches,
millimeters, or twips.
Maximum size — Type a value for the maximum height or width of the title block.
The dimension affected, height or width, depends on the alignment specified for the
title block.

Set size — Select this check box if you want to specify a maximum size for the title
block. Clear the check box to allow the title block to take up as much space as
needed on the title block. It is recommended that you select this check box if the title
block is very tall or very wide, to avoid overlap with other graphical elements on the
drawing sheet.
Working area margins — Displays the margins of the initial working area on the
drawing page. Drag the edges of the working area to set the margins to the position
you require. Note that when you set the working area margins, the defined area
includes the title block. The software generates the drawing starting from the top left
corner at the position relative to the title block that you specified on the Title Block
tab. If any drawing elements extend beyond the right and bottom limits of the
working area, the software displays those elements on a new sheet.
Units — Select the units to specify for the working area margins: inches,
millimeters, or twips.
Left — Specifies the width of the left margin of the working area in the specified
units.
Right — Specifies the width of the right margin of the working area in the specified
units.
Top —
Specifies the width of the top margin of the working area in the specified units.
Bottom —
Specifies the width of the bottom margin of the working area in the specified units.
Reset — Resets the working area margins with a default value of 20 twips for all
margins.

Enhanced Reports > Connectors (Preferences)

The options on this page allow you to determine the format of the lines that represent
connectors for various items. Note that the first connected wire of a cable always
inherits the properties of the cable and that the first connected wire of subsequent
cable sets always inherits the properties of the cable set. For the Custom by Loop
and Custom by Signal generation methods, the software displays the wires
individually and assigns them the format that you specify.
Format
Item — Allows you to select the type of wiring item for which the formatting
definitions apply, for example, cable, cable set, wire, jumper.
Reset — Resets the formatting definitions to their default values for the selected
item.
Style — Allows you to specify the line style for the connector representation. The
box beside this list indicates the visual appearance of the style that you select. You
should not change the default style used for jumpers; if you do so, the software will
not display the jumpers.
Color — Displays the current color that the software uses for the connector
representation. To change the connector color, click the ellipsis to open the Color
dialog box.
Units — Select the units to specify for the connector width: inches, millimeters, or
twips.
Width — Specifies the connector width in the selected units.

Enhanced Reports > Pagination and Revisions

(Preferences)
The options on this page allow you to determine the starting page number and
revision order for the specific enhanced report type.
Pagination options
Start from page number — Select the desired page number to appear on the first
drawing sheet.
Revision options
Revision macro order — Select the relation between the order of revisions and the
order of the macros that you have set in the title block. The options are:

the title block.
in the title block.
Interfaces > DCS Vendors (Preferences)

Use this option while preparing SmartPlant Instrumentation data that you want to
publish for the DCS vendor (such as DeltaV, Yokogawa)
DCS vendor options

Fieldbus mode — Determines whether you can work with fieldbus devices you
created in SmartPlant Instrumentation or with fieldbus devices you downloaded to
SmartPlant Instrumentation. Select this check box if you are preparing fieldbus data
for publishing to the DCS vendor software. When the check box is selected, on the
Fieldbus tab of the Tag Number Properties dialog box, the contents of the fieldbus
device revision list is limited according to the manufacturer that you select on the
General tab. Your selection of manufacturer and fieldbus device revision then
determines function block association for a given instrument. The software displays
only those function blocks that belong to the downloaded fieldbus devices and makes
the Function Blocks supporting table inaccessible.
If you clear this check box, you can work with function blocks you create in
SmartPlant Instrumentation. The software hides function blocks belonging to
fieldbus devices you previously downloaded.

SmartPlant Integration > General (Preferences)

The option on this page enables you to specify the analyzer accuracy for use in an
integrated environment.
Relative tolerance — Type a value using a decimal point with `1' preceded by the
number of zeros representing the accuracy that you require, for example: 0.01,
0.0001.
Output XML folder

Default folder for XML files — This option applies when you publish data in File
mode using the interface to SmartPlant Electrical, DeltaV, or Yokogawa. Click
Browse to select a working folder in which to keep the .xml files containing your
published data.

SmartPlant Integration > To Do List (Preferences)

These options enable you to specify the way that the software handles tasks in the To
Do List when you are working in an integrated environment.
Task execution — Use these option buttons to determine how the software executes
tasks in the To Do List when the user implements the Run command.
• Execute — Click to specify that Run executes the task immediately.

• Submit — Click to specify that Run submits the task for execution at a
later stage for batch mode execution.
Enable claim and release of basic engineering data — Select this check box to
allow the software to generate tasks for claiming basic engineering data into a project
or releasing claimed basic engineering data back to As-Built.
Enable claim and release of wiring data — Select this check box to allow the
software to generate tasks for claiming wiring data into a project or releasing claimed
wiring data back to As-Built.
Delete failed tasks — Select this check box to allow the software to delete tasks for
which implementation failed.
Activate instrument type profile — When running a task that results in the
creation of a new instrument, if you select this check box, the software applies
instrument type profile options according to the settings specified under Preferences
> Instrument Index > Profile, provided the appropriate options are defined for the
specific instrument type. If you clear the check box, the software creates the
instrument type without applying the profile options.
Display tasks for all plant hierarchy items — Select this check box to display the
tasks for all plant groups in the current plant. Clear the check box to display tasks in
the current lowest plant hierarchy item only.

Claim and Merge Options (Preferences)

The options on this page only apply in an Operating owner domain. These options
allow you to set preferences for claiming As-Built items for a project from
SmartPlant Instrumentation or merging project data with As-Built. When working
with As-Built data, you can either claim items directly or copy them to the Claim
Buffer. Then, your Project Administrator can claim these items in the
Administration module. When working in a project, you cannot merge items directly.
It is only possible to copy project data to the Administration module Merge Buffer
for merging.
These preferences determine how the software claims, merges, or copies to the Claim
Buffer or Merge Buffer the sub-items and parent items associated with the items you
select for claiming or merging from the explorer windows. Documentation dealing
with claiming and merging data appears in the Administration module Help. For
common tasks associated with claiming data, see Scoping Data for Projects Common
Tasks in the Administration User's Guide. For common tasks associated with
merging data, see Merging Project and As-Built Data Common Tasks in the
Administration User's Guide.
The following table shows the related data or items that the software can include in
the Claim Buffer or Merge Buffer when you select a main item belonging to a
specific item type.
Main Item Related Items/Data Included with the Main Item

Loop Tags with basic engineering data (process data, calculation,
calibration, dimensional data for piping, and specification sheets,
hook-up associations), wiring items that have a signal propagated
to the loop or tag. If you placed a device panel inside a cabinet or
junction box, when claiming the loop, this device panel is not
claimed or merged together with the cabinet or junction box
because this device panel does not have a signal propagated to the
loop. You must claim or merge such a device panel manually.
Instrument Basic engineering data, wiring items that have a signal propagated
to the instrument.
Wiring item All wiring sub-items and control system tags that appear in the
(panel, rack, appropriate wiring item folder in the Domain Explorer.
wiring equipment,
and so forth
Terminal strip Terminals
Cable Cable sets, wires
Wire Cables, cable sets

Notes
• The Claim Buffer and Merge Buffer are only accessible from the
Administration module. For more information about the Claim Buffer,
see the Administration module Help, Claim Buffer in the Administration
User's Guide. For more information about the Merge Buffer, see the
Administration module Help, Merge Buffer in the Administration User's
Guide.
• Preferences that you set do not affect preferences the Project
Administrator defines on the Preferences for Scoping and Merging Data
dialog box of the Administration module.
Include with the item
No sub-items — Affects only items you selected in an explorer window. The
associated sub-items are claimed, or copied to the buffer as dummy items. In the
project, dummy items appear as view-only and are marked by a specific color defined
in the Administration module. In the Domain Explorer, dummy items appear with
the indicator . The associated wiring sub-items that do not have a signal (for
example, disconnected terminals or spare wires) are not processed at all. When
merging items, the software ignores dummy items.
Sub items — Allows you to claim, merge, or copy to the buffer the associated sub-
items. After you select this option, you can select any combination of the check
boxes if you want the software to include wiring data when you perform a desired
claim or merge operation using shortcut menu commands of an explorer window.
For example, if you do not select any check box, and then, in the Domain Explorer,
select a loop or a tag, the software includes all the engineering data but does not
include any wiring items that have a signal propagated to the loop or tag. The
engineering data that the software includes consists of process data, calculation,
calibration, dimensional data for piping, and specification sheets, and hook-up
associations. To include these wiring items, you must select the Wiring data of tags
and loops check box.
Note
• When you select a tag for claiming or merging, the basic engineering data
is selected automatically. You cannot claim or merge a specific
instrument, process data sheet, and so forth.
Wiring data of tags and loops — Allows you to claim, merge, or copy to the buffer
all the wiring items that have a signal propagated to the tags and loops you select for
claiming.
Tags and loops with lowest level sub-items only — Only available after you select
Wiring data of tags and loops. Allows you to claim, merge, or copy to the buffer
only the terminals and wires that have a signal propagated to the tags and loops you
select for claiming. The intermediate sub-items are processed as dummy.

Wiring equipment sub-items — Only available after you select Wiring data of
tags and loops. Allows you to claim, merge, or copy to the buffer all the wiring
items that are associated with wiring equipment. For example, if you claim a tag
associated with an apparatus, the software also claims all of the sub-items associated
with the apparatus.
Non-connected terminals and spare wires — Only available after you select
Wiring data of tags and loops. Allows you to claim, merge, or copy to the buffer
the non-connected terminals and spare wires together with the other associated wiring
items that have a signal.
Wires connected to terminals — Allows you to claim, merge, or copy to the buffer
all the wires that are connected to terminals associated with the parent items. For
example, if you claim a panel, the software also claims the panel strips, the terminals,
and the wires that are connected to the terminals.
Note
• If you selected a loop or tag, and also selected the Wiring data of tags
and loops check box, the Wires connected to terminals check box does
not apply to the wiring items associated with the loop or tag. In this case,
the software always claims, merges, or copies to the buffer all the wires
that have signal propagated to the tag.
When claiming items, include parent items as
Dummy items — Allows you to claim or copy to the Claim Buffer parent items as
dummy items. For example, if you claim an instrument, the source loop number
appears in the project as a dummy item.
Fully-functional items — Allows you to claim or copy to the Claim Buffer parent
items as fully-functional items. For example, if you claim an instrument, the source
loop number appears in the project as a fully-functional item.
Note
• When you claim instruments directly from the Instruments folder of the
Domain Explorer, the source loop is always claimed as a dummy item.
In this case, this preference does not apply.

When merging items

Convert parent items to dummy items — Allows you to copy items to the Merge
Buffer and display their parent items in the Merge Buffer as dummy items. When
your Project Administrator merges the items that you copied, the software converts
those parent items that remain in the projects to dummy items. For example, when
merging a strip, the strip is removed from the project and the parent panel remains in
the project as a dummy panel. The software automatically removes the dummy
parent item from the project if this item does not have any other sub-items.
Leave parent items a fully-functional items — Allows you to copy items to the
Merge Buffer and display their parent items in the Merge Buffer as fully-functional
items. When your Project Administrator merges the items that you copied, the
software leaves those parent items that remain in the project as fully-functional items.
Copy revision data — Includes revision data of the documents associated with
items that you claim.
Reclaim items — Allows you to claim the same items again. When an item exists
in a project, reclaiming the item results in an automatic update of the project item
properties, connections and associations. If you deleted an item, this item reappears
in the project after reclaiming.
Report Generator (Preferences)

The options on the Report Generator page enable you to select whether to use the
default report generator, InfoMaker. This setting does not affect the preferences that
were defined by other SmartPlant Instrumentation users working in the current
domain or, if the domain type is Operating owner, in the current project.
Default report generator

Report generator — Select an option: InfoMaker or None.
Path — Type the full path and filename or click Browse to navigate to the
InfoMaker executable file.

SmartPlant Instrumentation Server (Preferences)

These options enable you to specify preferences when using the SmartPlant
Instrumentation Server.
Enhanced report format — Enables you to specify the file type when generating
enhanced reports using IDEAL. Available options are:
• SMA – Generates files in the native format of the Enhanced Report

Utility.
• PDF – Generates PDF files. For this option to work, you must install a
PostScript printer driver or Acrobat Distiller.
Shared Web folder — Enables you to specify the path to the shared Web folder for
the SmartPlant Instrumentation Server. When you generate reports using IDEAL, the
output document folder must be a sub-folder of the shared Web folder. Click Browse
to navigate to the shared Web folder path. For example:
C:\inetpub\wwwroot
Log file path — Enables you to specify the path to the folder where the software
creates the log file output. Click Browse to navigate to the path. Note that if no path
is defined or the path definition is invalid, the software generates the log file in the
Temp folder defined in Windows.
Module Icons (Preferences)

These options enable you to customize the main toolbar by adding, removing, and
rearranging the icons on the main toolbar in any sequence. These settings do not
affect the preferences that were defined by other SmartPlant Instrumentation users in
the current domain or working in the current project, if the domain type is Operating
owner.
Note the following limitations:
• An icon cannot appear on the main toolbar more than once.

• You cannot change the original icon assignment.
• You cannot modify the icon image.

Left pane — This pane contains all the available icons that can be placed on the
main toolbar in any position. To place an icon on the main toolbar, do one of the
following:
• Drag an icon from the Icons pane and drop it in the Main toolbar pane.
• Double-click an icon or its name in the Icons pane.
• Select an icon and click Add.
Right pane — This pane contains all the icons that have already been placed on the
main toolbar. By default, all the icons appear in the Main toolbar pane. To remove
an icon from the main toolbar, do one of the following:
• Drag an icon from the Main toolbar pane and drop it in the Icons pane.
• Double-click an icon or its name in the Main toolbar pane.
• Select an icon and click Remove.

Claiming As-Built Items in a Project: An Overview
Claiming As-Built Items in a Project: An

Overview
In an Operating owner domain, when working in a project with As-Built items
displayed, you can claim As-Built items for this project directly in SmartPlant
Instrumentation. It is possible to claim As-Built items using one of the following
modes: exclusive claim mode or non-exclusive claim mode. The System
Administrator sets the claim mode when making domain definitions in the
Administration module. After a Project Administrator creates the first project in the
domain, the claim mode becomes set permanently for the current domain until the
Project Administrator deletes all of the projects.
Claiming items is the final stage of defining the scope of items for the project. Before
claiming the items, you can copy the required items to the Claim Buffer, which only
available in the Administration module. Then, your Project Administrator can log on
to the Administration module and claim the copied items for the project in batch
mode, or use copy the copied items using command line parameters. Alternatively,
you can claim specific As-Built items directly from the project, without copying them
to the Claim Buffer first, provided that the Claim Buffer is empty.
When using non-exclusive claim mode, in SmartPlant Instrumentation, it is only

possible to claim items from As-Built. If you want to claim items from one project to
another, you must use the Administration module options. For details about claiming
data using the Administration module options or command line parameters, see
Scoping Data for Projects: An Overview in the Administration User's Guide, under
Domain and Project Administration, Scoping Data for Projects.
When the As-Built item used as a source for claiming has child items, you can set
preferences to include or exclude the child items when claiming the parent item. For
example, you can claim a cable with or without its associated cable sets or wires. It is
also possible to reclaim the same item to update the item properties with the As-Built
item properties. For details about the preferences for claming, see Claim and Merge
Options (Preferences), page 210.

Claiming As-Built Items in a Project: An Overview
In a project, claiming options are available in the Instrument Index module, Browser
module, and the Domain Explorer:
• In the Instrument Index module, you can select instruments and claim
them with the engineering data defined in other modules, for example,
with the associated hook-ups.
• In the Browser module, you can select instruments, lines, loop numbers, or
equipment data for claiming.
• In the Domain Explorer, you can select any item and copy it to the Claim
Buffer for further processing by your Project Administrator, or claim the
items according to the preferences set on the Claim and Merge Options
page of the Preferences dialog box. Note, however, that if you want to
claim fieldbus tags, you only need to claim the associated fieldbus
segments with their sub-items and the fieldbus tags are claimed
automatically.
Related Topics
• Claiming and Merging Items Common Tasks, page 220
• Display As-Built and Project Data, page 221

Preparing Project Items for Merging with As-Built: An Overview
Preparing Project Items for Merging with As-

Built: An Overview
In a project opened in an Operating owner domain, in the Domain Explorer, you can
select items you want to merge with As-Built and copy them to the Merge Buffer for
further processing from the Administration module or for merging the copied items
using command line parameters. The Merge Buffer is only accessible from the
Administration module. It is not possible to merge items directly from a project. For
details about merging data using the Administration module options or command line
parameters, see Merging Project and As-Built Data: An Overview in the
Administration User's Guide, under Domain and Project Administration, Scoping
Data for Projects..
Before you copy items to the Merge Buffer, you can set preferences to include or
exclude the child items when copying the parent item. For example, you can copy a
cable with or without its associated cable sets or wires. For details about the
preferences for copying items to the Merge Buffer, see Claim and Merge Options
(Preferences), page 210.
When copying items to the Merge Buffer, you select a merge action for all or
selected items. At this stage, the software applies the merge action to the items and
also applies the preferences options that you have set. The following actions are
available per item:
Merge now — Overwrites the data in As-Built with the modified data in the current
project. The results depend on the change made in the project:
• Items that SmartPlant Instrumentation users created in the project are also
inserted in As-Built. If an item that exists in the project was deleted in As-
Built, that item is reinserted in As-Built.
• Items that SmartPlant Instrumentation users deleted in the project are also
deleted in As-Built.
• Items that SmartPlant Instrumentation users updated in the project are also
updated in As-Built. Also, if you made any changes to As-Built data after
claiming the item for the project, the software overwrites the As-Built data
with the project data on merging.

Release claim — Disregards changes and leaves the data in As-Built as it was
before claiming it for the project. When using the Release Claim action, the
following rules apply to project data:
• The Release Claim action does not apply to new items that you create in
the project.
• The Release Claim action does not apply to new sub-items you associated
with a claimed item.
• If a claimed item does not have new sub-items you created in the project,
the software removes the claimed item from the project even if you
changed its name and description in the project.
• If a claimed item has new sub-items you created in the project, the
software always leaves this claimed item as a dummy item in the project.
• If a claimed item has both claimed sub-items and new sub-items you
created in the project, the software only removes the claimed sub-items
from the project. The parent item appears in the project as a dummy item.
Notes
• Your Project Administrator can merge items using one of the two modes
set by System Administrator for the current domain: with deletion from
the project or without deletion from the project. Depending on the merge
mode, on merging data, the software either deletes the merged items from
the project or leaves view-only copies of the merged items in the project.
You cannot delete these copies or update their properties. It is possible,
however, to claim these items for another project even if you are working
in exclusive claim mode.
• If you want to merge fieldbus tags, you only need to copy to the Merge
Buffer the associated fieldbus segments with their sub-items. It is not
possible to merge fieldbus tags manually.
Related Topics
• Display As-Built and Project Data, page 221

Claiming and Merging Items Common Tasks

In an Operating owner domain, the following tasks are used frequently when you
claim or copy to the Claim Buffer items directly from a project opened in SmartPlant
Instrumentation. Also, it is possible to prepare project data for merging with As-Built
by copying project items to the Merge Buffer. After copying items to the Merge
Buffer, your Project Administrator can either user the Administration module options
to merge the items, or merge the items from the command line. The Claim Buffer
and Merge Buffer are only accessible from the Administration module.
Display As-Built and Project Data

If you open a project in an Operating owner domain, you can either choose to display
only the project items, or project items together with view-only As-Built items, which
you can claim for the project. It is only possible to claim items if you open a project
together with As-Built items displayed. For details, see Display As-Built and Project
Data, page 221.
Copy As-Built Items to the Claim Buffer

This procedure allows you to copy items from the SmartPlant Instrumentation
Domain Explorer to the Claim Buffer, which is only accessible from the
Administration module. After you copy the items, the Project Administrator can log
on to the Administration module and claim all or specific the items that you copied in
the Claim Buffer. When you select items, the software automatically applies
preferences that you set on the Preferences dialog box. These preferences determine
how the software copies to the Claim Buffer sub-items that are associated with the
items you select. For more information, see Copy As-Built Items to the Claim Buffer,
page 223.
Claim As-Built Items from the Domain Explorer

If the Claim Buffer does not contain any items, you can use this procedure to claim
items directly from the Domain Explorer. When you select items, the software
automatically applies preferences that you set on the Preferences dialog box. These
preferences determine how the software claims sub-items that are associated with the
items you select. For more information, see Claim As-Built Items from the Domain
Explorer, page 224.
Claim Instruments in the Browser or Instrument Index Module

You can claim tag numbers in the Instrument Index module, or in the Browser
module. In an Operating owner domain, use this procedure to claim the As-Built tags
for the current project, with or without the engineering data associated with the tags.
For more information, see Claim Instruments in the Browser or Instrument Index
Module, page 225.

Claim Loops, Lines, and Equipment in the Browser Module

This procedure describes how to claim As-Built loops, lines, and equipment in the
Browser module. The software claims items without any engineering data that is
associated with the items. For example, when claiming a loop, the software does not
claim the tag numbers associated with the loop. For more information, see Claim
Loops, Lines, and Equipment in the Browser Module, page 226.
Copy Items to the Merge Buffer as Merge Now

Use this procedure to copy specific items from the Domain Explorer to the Merge
Buffer and assign a Merge Now action to these items. For more information, see
Copy Items to the Merge Buffer as Merge Now, page 227.
Copy Items to the Merge Buffer as Release Claim

Use this procedure to copy specific items from the Domain Explorer to the Merge
Buffer and assign a Release Claim action to these items. For more information, see
Copy Items to the Merge Buffer as Release Claim, page 228.
Related Topics
• Claiming As-Built Items in a Project: An Overview, page 216
• Preparing Project Items for Merging with As-Built: An Overview, page
218
Display As-Built and Project Data

1. On the Open dialog box, select a domain of type Operating owner.
2. Double-click the appropriate project icon to select the project you want to
work with (As-Built or a project).
• To view As-Built data only, select As-Built from the list.
• To view project data, select any project from the list (you can choose
afterwards whether to display As-Built data with the project data –
see steps 4 and 5 for details).
3. Select the <unit> in which you want to work and click OK. By default,
SmartPlant Instrumentation opens with data visible only from the project you
selected.
4. To display As-Built and project data together, do one of the following:
• Click .
• Click File > As-Built Data.

5. To return to the display of project data only, do one of the following:
• Click .
• Click File > Project Data.
Notes
• According to the data you select to display, the items will be formatted
according to the settings made in the Administration module.
• If you select to display both project and As-Built data, you can edit the
project data only.
• When working in a project with As-Built items displayed, As-Built items
are view-only. In the Domain Explorer, you can select an As-Built item
and display its properties. As-Built items are indicated with the icon.
Related Topics

Copy As-Built Items to the Claim Buffer

1. Open a project together with the As-Built data displayed. For details, see Display
As-Built and Project Data, page 221.
2. Press F7 to open the Domain Explorer.
3. Expand the explorer hierarchy to display folders of item types.
4. In the tree view pane, click an item type folder to display the items.
• In the tree view pane, right-click a specific item, and then, on the
shortcut menu, click Project Activities > Copy to Claim Buffer.
• In the Items pane, select and right-click one or more items, and then,
on the shortcut menu, click Project Activities > Copy to Claim
Buffer.
Tips
• When you copy items to the Claim Buffer, in addition to the main
items you select, the software can select the associated sub-items
automatically, or you have the option to include the sub-items
manually with the main item by setting preferences accordingly. For
details, see Claim and Merge Options (Preferences), page 210.
• If you copied to the Claim Buffer a loop or instrument together with
the wiring items, the software only copies those wiring items that have
a signal propagated to the loop or instrument. If you placed a device
panel inside a cabinet or junction box, when claiming the loop, this
device panel is not copied together with the cabinet or junction box
loop. You must select and copy such a device panel manually.
Related Topics

Claim As-Built Items from the Domain Explorer

Note
• Claiming items from the Domain Explorer is only possible if the Claim
Buffer in the Administration module has no items.
shortcut menu, click Project Activities > Claim.
on the shortcut menu, click Project Activities > Claim.
Tips
• When claiming instruments from the Domain Explorer, you cannot
select basic engineering data manually or set the software to claim
instruments without including the associated basic engineering data. It
is possible to claim instruments without the engineering data in the
Browser or Instrument index module. For details, see Claim
Instruments in the Browser or Instrument Index Module, page 225.
• When you claim items, in addition to the main items you select, the
software can select the associated sub-items automatically, or you have
the option to include the sub-items manually with the main item by
setting preferences accordingly. For details, see Claim and Merge
Options (Preferences), page 210.
• If you claimed a loop or instrument together with the wiring items, the
software only claims those wiring items that have a signal propagated
to the loop or instrument. If you placed a device panel inside a cabinet
or junction box, when claiming the loop, this device panel is not
claimed together with the cabinet or junction box because this device
panel does not have a signal propagated to the loop. You must select
and claim such a device panel manually.
Related Topics

Claim Instruments in the Browser or Instrument Index

Module
• Open an Instrument Index Standard Browser view.
• In the Browser module, open a browser view for the Instrument Index
browser.
3. Select and right-click the As-Built tag numbers that you want to claim for the
current project.
Tip
• As-Built and project tag numbers have different color coding. The
Project Administrator selects which colors to use on the Project
Activities dialog box in the Administration module.
4. On the shortcut menu, click Claim.
5. In the Tag Claiming Options dialog box, select Basic engineering data to claim
associated data that was defined for the tags in the Instrument Index, Calculation,
Specifications, Hook-Ups, Process Data, and Dimensional Data for Piping
modules.
6. Select Wiring data to claim associated wiring data that was defined for the tags
in the Wiring module.
Tip
• It is possible to claim instruments either without the engineering data
or without the wiring data. You must select at least one check box.
Related Topics

Claim Loops, Lines, and Equipment in the Browser Module

2. In the Browser module, expand the Instrument Index browser group and open a
browser view for one of the following browsers:
• Loop Browser.
• Line Browser.
• Equipment Browser.
3. Select and right-click the As-Built items that you want to claim for the current
project.
Tips
• As-Built and project items have different color coding. The Project
Administrator selects which colors to use on the Project Activities
dialog box in the Administration module.
• In the Browser module, you can also claim instrument tag numbers.
For details, see Claim Instruments in the Browser or Instrument Index
Module, page 225.
4. On the shortcut menu, click Claim.
Related Topics

Copy Items to the Merge Buffer as Merge Now

shortcut menu, click Project Activities > Copy to Buffer as Merge
Now.
on the shortcut menu, click Project Activities > Copy to Buffer as
Merge Now.
Tips
• If the items that you select already appear in the Merge Buffer, when
copying the items, the software also changes the merge action to
Merge Now for those items.
• When you copy items to the Merge Buffer, in addition to the main
• If you copied to the Merge Buffer a loop or instrument together with
the wiring items, the software only copies those wring items that have
panel inside a cabinet or junction box, when merging the loop, this
Related Topics
218

Copy Items to the Merge Buffer as Release Claim

shortcut menu, click Project Activities > Copy to Buffer as Release
Claim.
on the shortcut menu, click Project Activities > Copy to Buffer as
Release Claim.
Tips
• If the items that you select already appear in the Merge Buffer, when
copying the items, the software also changes the merge action to
Release Claim for those items.
• When you copy items to the Merge Buffer, in addition to the main
• If you copied to the Merge Buffer a loop or instrument together with
the wiring items, the software only copies those wring items that have
panel inside a cabinet or junction box, when merging the loop, this
Related Topics
218

Working with the SmartPlant Instrumentation Explorer: An Overview
Working with the SmartPlant Instrumentation

Explorer: An Overview
You use the SmartPlant Instrumentation Explorer to access and manage all the
items that exist in SmartPlant Instrumentation. SmartPlant Instrumentation features
the Domain Explorer and the Reference Explorer.
• Domain Explorer — this view of the SmartPlant Instrumentation

Explorer allows you to create and manage your current domain items.
You can perform almost all the actions that are possible in the SmartPlant
Instrumentation modules. For example, you can create new tag numbers,
edit their properties, create and edit wiring items, make wiring
connections, generate various data sheets, reports, and so forth. Also, you
can copy items from the Reference Explorer and this way create items
based on reference configurations on the fly. The Domain Explorer
displays instrumentation items according to hierarchical structure. You
can arrange the hierarchical structure of the data according to the item
types, the physical location of the items, or the item sequence within their
parent item. For more information, see Working with the Domain
Explorer: An Overview, page 230.
• Reference Explorer — allows you to create and manage all the
available wiring reference items that are created by SmartPlant
Instrumentation users and that are provided with the software. Note that
wiring reference items are typical configurations that facilitate rapid
creation of various wiring items in your domain. For more information,
see Working with the Reference Explorer: An Overview, page 269.
Note
• When you create an item in the Domain Explorer, make sure you set
the naming convention for it in the Administration module. For details
see Naming Conventions: An Overview in the Administration User's
Guide, under Domain Administration.
Related Topics
• Domain Explorer Common Tasks, page 232
• Working with the Reference Explorer: An Overview, page 269

Working with the Domain Explorer: An Overview
Working with the Domain Explorer: An

Overview
You use the Domain Explorer to create and manage your current domain items. The
Domain Explorer displays instrumentation items according to hierarchical structure.
You can arrange the hierarchical structure of the data according to the item types, the
physical location of the items, or the item sequence within their parent item .
Note
• When you create an item in the domain explorer, make sure you set the
naming convention for it in the Admin module. For details see Naming
Conventions: An Overview in the Administration User's Guide, under
Domain and Project Administration.
The Domain Explorer enables you to perform almost all the actions that are possible
in the SmartPlant Instrumentation modules. For example, you can create new tag
numbers, edit their properties, create and edit wiring items, open the Connection
window to make wiring connections, generate various data sheets, reports, and so
forth. You can drag items from the Reference Explorer to the Domain Explorer
and in this way create numerous items based on reference configurations on the fly.
Also, you can drag items from the Domain Explorer to the Reference Explorer to
create reference items based on existing configurations.
Working with the Domain Explorer is another mode of working with SmartPlant
Instrumentation, just like working with SmartPlant Instrumentation modules.
You can open the Domain Explorer from anywhere in SmartPlant Instrumentation.
Press F7 or on the Tools menu, click Domain Explorer.
Tips
• Depending on the access rights that have been granted to you, the Domain
Explorer allows you to perform actions with SmartPlant Instrumentation
items that belong to all the existing <plants> in your domain and not just
with the items in the plant that you have currently logged in.
• You can expand the hierarchy of any <unit> and view the item structure.
However, specification, process data, or calculation sheets are only
accessible from the <unit> you have logged on to. Process data,
specification, and calculation sheets of items belonging to <units> that you
are not logged to are not accessible even for viewing.

The tree view pane of the Domain Explorer shows instrumentation items organized
by folders. SmartPlant Instrumentation defines standard folders in the database. You
cannot move or delete these folders, nor can you add new folders. Each folder
contains a particular item type, and the options available on the menus depend on the
currently selected item type.
For a detailed explanation of all the folders and their organization in the Domain
Explorer, see The Organization of Items in the Domain Explorer Tree View, page
236.
Item status indicators — the software uses various icons beside a folder or item to
indicate the status of a folder or an item , for example access denied, view only, an
item that belongs to As-Built, and so forth. For the full list of the item indicators,
see Item Status Indicators in the Domain Explorer, page 253.
Notes
• You can open several instances of the Domain Explorer by pressing F7.
• After exiting SmartPlant Instrumentation, and starting a new session, the
software retains the size and position of all the windows that were open in
the previous session.
• Some SmartPlant Instrumentation modules have their own Explorers.
These are just limited views of the Domain Explorer and they contain
items specific to their modules. For details, see Working with the
SmartPlant Instrumentation Explorer: An Overview, page 216.
Related Topics
• Association Rules in the Domain Explorer, page 249
page 216

Domain Explorer Common Tasks

The following tasks are used frequently when you work with the Domain Explorer.
Create an Item in the Domain Explorer

This procedure shows how to create an item in the Domain Explorer. For more
information, see Create an Item in the Domain Explorer, page 254.
Edit Item Properties

This procedure explains how to edit the properties of an item that you select in the
Domain Explorer. For more information, see Edit Item Properties, page 255.
Duplicate an Item
You use this action to create a duplicate item within the same parent hierarchy. That
is, the software creates another copy of the selected item under the immediate parent
item. For example, if you need to insert an apparatus within an existing apparatus
group, expand an apparatus group and duplicate an apparatus. You can then change
the sequence numbers of the apparatuses to re-arrange them on the strip the way you
require. Furthermore, if you are duplicating a panel or another item that contains
child items, the software duplicates this item in its entirety. That is, SmartPlant
Instrumentation creates the new item with exactly the same child items as the original
panel. Note that in this case, the software also retains all the existing internal
connections if you selected Copy internal connections in the wiring preferences.
For more information, see Duplicate an Item, page 254.
Move an Item in the Domain Explorer

This feature allows you move an item from one parent item to another within the
Domain Explorer. This can be very helpful when, for example, you want to move a
terminal strip to another panel. If you are moving an item that contains child items,
the software moves the selected item together with all its child item.
Note that the same rules apply when you want to move an item in the Reference
Explorer. If you drag an item from the Reference Explorer to the Domain
Explorer or vice versa, SmartPlant Instrumentation creates a copy of that item and
retains the selected one in its original place. If you open another instance of the
Domain Explorer and drag an item from one Domain Explorer window to another,
the same rules apply as when you drag an item within the same Domain Explorer
window.
For more information, see Move an Item in the Domain Explorer, page 255.
Delete Items
This procedure shows how to delete the items that you select in the Domain
Explorer. For more information, see Delete Items, page 255.

Search for Items in SmartPlant Instrumentation Explorer

You use this feature to find items that you want to work with. You can search for
multiple items in the entire domain, the current highest plant hierarchy level, or the
current lowest plant hierarchy level. The term "current" refers to the plant hierarchy
level that you selected in the Open dialog box when you started SmartPlant
Instrumentation. For more information about searching for items, see Search for
Items in SmartPlant Instrumentation Explorer, page 257.
Find an Item in the Tree View of an Explorer Window

This feature enables you to find an item in the Domain Explorer tree view. This
feature is especially useful when you want to find an item in a particular folder that
contains numerous items. You can type an item name and click Find or you can let
the software look for the item as you type the item name. The feature allows you to
set the search delay that determines how long the software waits after the last time
you press a key on your keyboard.
For more information, see Find an Item in the Tree View of an Explorer Window,
page 259.
Filter the Display of Items According to a Specific Item Type

This option allows you to filter the items according to a specific item type. You can
apply an item type filter to the entire tree view of the current view of the current
Explorer window or only to a particular folder or node that contains child items.
Item type filters override your item name filters.
Also, you can filter the items so that the software displays only those items that
belong to the current lowest plant group and only those items that were created by the
current user of SmartPlant Instrumentation. You can use these two filtering options
on their own or in concurrence with another filter definition.
Filter settings take effect only for the user who defined the filter and only for the
current custom view of the active Explorer window.
Note that item type filters override your item name filters.
For more information, see Filter the Display of Items According to a Specific Item
Type, page 261.

Filter the Display of Items According to a Specific Item Name

This option allows you to filter the items according to a specific item name. An item
name filter affects the entire tree view of the current view of the active Explorer
window and not just a particular folder or hierarchy node. You can also instruct the
software to override the item type filters if needed.
You can define an item name filter only if you do one of the following:
• Without selecting anything in the Explorer window, click on the

toolbar.
• Right-click the root node in the Explorer tree view and then on the
shortcut menu, click Filter.
Note that filter settings take effect only for the user who defined the filter and only for
the current custom view of the active Explorer window. For more information, see
Filter the Display of Items According to a Specific Item Name, page 260.
Filter Cables in an Explorer Window

Allows you to set additional filter definitions for the Cables and the Cross Cables
folders. You can filter cables according to their connections and cables that are
connected to a specific Foundation Fieldbus or Profibus segment. For more
information, see Filter Cables in an Explorer Window, page 263.
Filter Loops in an Explorer Window

Allows you to set additional filter definitions for the Loops folder. You can filter
loops according to blocks associated with loop tags. For more information, see Filter
Loops in an Explorer Window, page 265.
Add Items to My List in the Items Pane

This procedure explains how to add various items to the My List view of the Items
pane. My List allows you to create a special view of the Items pane where you can
keep items that belong to various folders in the tree view. The software retains all the
items in the My List view until you remove them from that list. Exiting SmartPlant
Instrumentation and starting a new session does not affect the contents of My List.
For more information, see Add Items to My List in the Items Pane, page 267.

Display a Browser View in the Explorer Items Pane

This option allows you to display a browser view in the Items pane for an item type
or a folder that you select in the Domain Explorer tree view. This way, instead of
displaying child items, you can display item properties of the item you selected in the
tree view pane. The software displays the browser view according to the style
settings of the selected browser. You can print out the current browser view,
however, you cannot edit the item properties. For more information, see Display a
Browser View in the Explorer Items Pane, page 267.
Perform Various Actions with an Instrument

This feature allows you to select a tag number and perform various actions. You can
effect I/O assignment, associate blocks, create CS tags, create device panels and
cables, connect device panels, and so forth. For more information, see Perform
Various Actions with an Instrument, page 256.
Generate a Specification or a Process Data Sheet for an Instrument

This option allows you to select a tag number and generate a specification and a
process data sheet. For more information, see Generate a Specification or a Process
Data Sheet for an Instrument, page 256.
Define and Use a Custom View

SmartPlant Instrumentation allows you to define custom views for the Domain
Explorer and the Reference Explorer. The software lets you select a folder or
multiple folders and add these folders with their child items to a custom view that you
select. Note that the custom views that you define are not available to other users of
SmartPlant Instrumentation. For more information, see Define and Use a Custom
View, page 268.
For the rules that govern the dragging of items in the Domain Explorer, see
Association Rules in the Domain Explorer, page 249.

The Organization of Items in the Domain Explorer Tree View

The tree view pane of the Domain Explorer shows instrumentation items organized
by folders. SmartPlant Instrumentation defines standard folders in the database. You
After expanding a plant hierarchy, the following folders are displayed:
Loops
Loops are arranged at the lowest level of the plant hierarchy. You can navigate to a
loop by expanding the plant hierarchy. Continue expanding your plant hierarchy to
display the Loops folder that contains all the existing loops in the current <unit>.
Loops, in turn, can contain loop blocks used in CAD loop drawing generation,
instruments and control system tags. Instruments can contain instrument blocks used
in CAD loop drawing generation. For more information, see Items in the Loops
Folder, page 246.
Instruments
Instrument tags are arranged at the lowest level of the plant hierarchy in the
Instruments folder. You can navigate to a tag number by expanding the plant
hierarchy. Continue expanding your plant hierarchy to display the Instruments
folder that contains all the existing tag numbers in the current <unit>. Instrument
tags can be parent items of CS tags, maintenance event record, specifications, process
data sheets, and any other documents that are associated with a selected instrument
tag.
Electrical Tags
This folder holds all the tag numbers that have either been published to SmartPlant
Instrumentation from SmartPlant Electrical or that you have created for the purpose
of representing electrical signals. You can associate these tags with items under the
Electrical Equipment folder and publish the items with these associations back to
SmartPlant Electrical.
Functional Requirement Tags

This folder holds all the existing functional requirement tag numbers. You can only
view the list of existing tags and open the tag number properties for editing.
However, you cannot create new tags by right-clicking this folder.
Wiring items are organized in the following folders:

Panels by Location
Panels are arranged according to their location and category. In this folder, panels are
arranged according to their location. You can perform the following actions:
• Create a new location based on the structure you define in the Location
Manager.
• Move a panel from one location to another by dragging it to another
location.
• Right-click a location and create a new panel and then create the required
child items.
• When right-clicking a location or a wiring item within a location, you can
perform various actions that are available on the shortcut menu.
You can create various wiring structures in the Panels by Location folder. For an
example of one possible wiring structure, see Panels by Location Hierarchy Example,
page 241.
Panels by Category
In this folder, panels are arranged according to their category. Panels, in turn, contain
their child items, for example terminal strips, racks, wiring equipment, and so forth.
There is a lot of flexibility in creating a panel hierarchy. There is no rigid structure
like "panel – strip – terminal" that limits your wiring design. You can create
various wiring structures, as you require.
Cables
This folder holds all the existing cables. You can create various child items under
cables. For an example, see Cable Hierarchy Example, page 241.
Cross Cables
This folder holds all the cross wiring cables and wires. You can create new cross
cables and cross wires as you require.
Lines, hook-ups, process equipment, P&IDs, and so forth are organized in separate
folders at the top hierarchy level of the tree view.:
Telecom Equipment
This folder holds all the available telecom equipment cabinets classified by their
categories: PA Cabinets, PABX Cabinets, Miscellaneous, Hubs, Amplifiers, and
Intercoms. Each folder displays the existing equipment cabinets belonging to that
category. You cannot create new cabinets in the Telecom Equipment folder. To
create a new equipment cabinet, expand the following hierarchy:
Panels by Category > Telecom Panels > Equipment Cabinets. Then, right-click
the Equipment Cabinets folder, point to New and click the command that you
require.

Process Equipment
This folder displays all the existing equipment that your instruments are installed on.
Equipment is also categorized according to different types, such as compressors,
burners, pumps, and so on. You can right-click this folder and create new process
equipment. Then, you can create an instrument by right-clicking an equipment item.
Lines
This folder holds all the existing lines in your <plant>. After right-clicking a line,
you can add a new instrument.
Fieldbus Segments
This folder contains all the segments, their associated tag numbers and virtual tags
that exist in your fieldbus system. All fieldbus items are arranged in a tree-like
hierarchy that can be expanded and collapsed. For details, see Fieldbus Segments in
the Domain Explorer, page 242.
Hook-Ups
This folder holds all the existing hook-up types, hook-ups, and their child items. For
details, see Items in the Hook-Ups Folder, page 244.
P&IDs
This folder displays all the existing P&ID document references. You can right-click a
P&ID document reference and create a new instrument, loop, and line.
Controllers
This folder displays all the existing controllers and their child items. You cannot
create new controllers in this folder, but you can select a slot and add a terminal strip,
an I/O card, or any other wiring equipment item.
Drawing Block Types

This folder holds all the existing CAD drawing block types and their blocks, which
you use when generating CAD loop drawings. In this folder, you create your blocks
but you do not make any associations. You can only associate blocks with loops or
instruments using the Loops folder actions of the Loop Drawings module options.
For details, see Items in the Drawing Block Types Folder, page 242.
Electrical Equipment
This folder holds all the items of electrical equipment that have been retrieved from
SmartPlant Electrical. In this folder, you can view the items and associate them with
electrical signals. For details, see Items in the Electrical Equipment Folder, page
244.
Related Topics

Panels by Category Hierarchy Examples

The following examples show a number of different structures that you can create in
the Panels by Category folder.
Example 1:
Example 2:
Example 3:

Example 4:
Example 5:
Related Topics

Panels by Location Hierarchy Example

The following is an example of a panel by location hierarchy structure:
Related Topics
Cable Hierarchy Example
Related Topics

Fieldbus Segments in the Domain Explorer

The Fieldbus Segments folder displays all the segments, their associated instrument
tags and virtual tag.
All fieldbus items are arranged in a tree-like hierarchy that can be expanded and
collapsed:
Icon Explanation
Foundation Fieldbus segment that contains all the associated instruments and
virtual tags
Profibus DP segment that contains all the associated instruments and virtual tags
Profibus PA segment that contains all the associated instruments and virtual tags
Fieldbus instrument associated with a segment
Function block associated with a fieldbus instrument
Virtual tag associated with a fieldbus instrument
Related Topics
Items in the Drawing Block Types Folder

The Drawing Block Types folder of the Domain Explorer enables you to navigate
to a CAD drawing block types and a drawing block in a graphical way resembling the
Windows Explorer. The Drawing Block Types folder contains all of the blocks
defined in the current <plant>. You organize your block in block type folders. The
blocks that you define become available for association with instruments, loops, or
hook-ups but you do make any associations in the Drawing Block Types folder.
CAD drawing blocks appear in the Domain Explorer because it is only possible to
define blocks at the highest plant hierarchy level.
You can expand or collapse the levels to view the existing items. To perform an
action, right-click the Drawing Block Types folder, a specific block type or a block,
and then click a command. The software uses various icons beside a folder or item to
indicate the status of a folder or an item , for example a view-only item, a claimed
item , an item that belongs to As-Built, and so forth. For the full list of the item
indicators, see Item Status Indicators in the Domain Explorer, page 253. For a
detailed explanation of the tree view and Items panes, see Working with the Domain
In the Drawing Block Types folder, the items appear in two levels, based on the
relationship among them.

Level 1
Drawing Block Types
This is the highest level in the Drawing Block Types folder hierarchy. At this level,
the software displays all the drawing block types that exist in the current domain and
allows you to add general and instrument block types and manage block type
properties.
The following drawing block types are available:
• Border and Logo (shown as ) — Shipped general block types that

allow you to create logo and border blocks for all loop drawings or hook-
up drawings. You cannot delete these block types.
• User-defined general block type (shown as ) — A block type that
allows you to create blocks you can use in all loop drawings in addition to
the border and logo blocks. You can create as many user-defined general
block types as you require by right-clicking the Drawing Block Types
folder and clicking New > General Block Type. Blocks belonging to
user-defined general block types cannot be assigned to hook-up drawings.
• Loop Block (shown as ) — A shipped block type that allows you to
create blocks that you can associate with the loop numbers in the Loops
folder of the Domain Explorer. The Loop Block folder is the only folder
where you can create loop blocks. You can only associate one loop block
per loop. You cannot delete the Loop Block folder.
• Instrument block type (shown as ) — A user-defined block type that
allows you to create blocks that you can associate with the instrument tag
numbers in the Loops folder of the Domain Explorer. You can create as
many instrument block types as you require by right-clicking the Drawing
Block Types folder and clicking New > Instrument Block Type.
Level 2
Drawing Blocks
CAD blocks appear under block types. Blocks do not contain child items. You can
add new blocks or delete blocks that are not in use.
The following block icons are available:
• — Indicates logo, border, or user-defined general blocks

• — Indicates loop blocks
• — Indicates instrument blocks
Related Topics
page 216

Items in the Electrical Equipment Folder

The Electrical Equipment folder of the Domain Explorer enables you to view items
of electrical equipment that have been retrieved from SmartPlant Electrical.
There are several sub-folders available for the following categories of electrical
equipment:
• PDBs— for Power Distribution Boards and their associated circuits.

• Main Equipment— for items such as motors, heaters, and control
stations that are associated with electrical equipment.
• Control Stations— for control stations without associations with
electrical equipment.
By expanding the electrical equipment items, you can view signal (electrical tag)
associations. If a particular piece of equipment does not have an associated signal,
you can make an association by dragging an electrical tag from the Electrical Tags
folder to the desired electrical equipment item.
Related Topics
page 216
Items in the Hook-Ups Folder

The Hook-Ups folder of the Domain Explorer enables you to navigate to a hook-up
type, hook-up, hook-up item, or instrument in a graphical way resembling the
Windows Explorer. You can expand or collapse the levels to view the existing items.
The Hook-Ups folder shows you at a glance the graphical representation of the
relationships that exist among the hook-up types, hook-ups, and hook-up items,
instruments, and child items associated with instruments.
The Hook-Ups folder employs an expandable/collapsible hierarchy that allows you to

navigate to relevant items and select them for use. To perform an action, right-click a
folder or an item and then click a command. Note that the software uses various
icons beside a folder or item to indicate the status of a folder or an item , for example
a view-only item , a claimed item , an item that belongs to As-Built, and so forth. For
the full list of the item indicators, see Item Status Indicators in the Domain Explorer,
page 253. For a detailed explanation of the tree view and Items panes, see Working
with the Domain Explorer: An Overview, page 230.
The software arranges the items based on the relationship among them. The display
rules follow a rigid structure of the following four levels.

Level 1
Hook-Up Types and Hook-Ups
This is the highest level in the Hook-Ups folder hierarchy. At this level, the software
displays both all the hook-ups types and hook-ups that exist in the current domain.
Hook-up types are shown as and hook-ups as .
Hook-up types contain hook-ups for instruments sharing similar features, for
example, Control, Measure, Flow, and so forth. For each hook-up type, on the
shortcut menu, you can click New to add hook-ups. At this level, you can only create
one hook-up at a time. Also, you can move hook-ups from one hook-up type to
another, assign instrument tags and hook-up items. To assign tag numbers, on the
shortcut menu, click Actions > Associate Tag Numbers with Hook-Ups. To assign
hook-up items, on the shortcut menu, click Actions > Associate Items with Hook-
Ups. Also, at this level, you can generate various hook-up reports, a Bill of Material,
and hook-up drawings.
Level 2
Hook-Ups
Hook-ups (shown as ) appear under hook-up types. At this level, you can create
hook-ups in batch mode by duplicating existing hook-ups you select in the Items
pane. You can move hook-ups from one hook-up type to another, assign instrument
tags and hook-up items. To assign tag numbers, on the shortcut menu, click Actions
> Associate Tag Numbers with Hook-Ups. To assign hook-up items, on the
shortcut menu, click Actions > Associate Items with Hook-Ups. Also, at this level,
you can generate various hook-up reports, a Bill of Material, and hook-up drawings.
Level 3
Hook-Up Items
Hook-up items (shown as ) appear under hook-ups. Hook-up items do not contain
child items. To assign hook-up items to hook-ups, use a shortcut menu command
available at the level of hook-ups or hook-up types. You cannot create or delete
hook-up items in the Domain Explorer. Hook-up item management options are only
available in the Hook-Up Item Libraries folder of the Reference Explorer.
Instruments
Instruments (shown as ) appear under hook-ups. Instruments can contain
document assigned to instrument specs, process data, or calculation sheets. Also,
instruments can contain control system tags. You create documents and control
system tags in the appropriate modules of SmartPlant Instrumentation. To assign
instrument tag numbers to hook-ups, use the shortcut menu command available at the
first or second level of the folder hierarchy.

Level 4
Control System Tag
Control system tags (shown as ) appear under instruments at the lowest level of the
Hook-Ups folder hierarchy. It is possible to assign control system tags to instruments
when performing I/O assignment.
Documents
Documents (shown as ) appear under instruments at the lowest level of the folder
hierarchy. You define documents when creating specs, process data sheets, or
calculation sheets. You can modify or delete document data in the module pertaining
to the document displayed. For example, if you delete an instrument specification
from the Specifications module, the software automatically removes the document
from the Hook-Ups folder. Use the shortcut menu command to open documents.
The software opens the document in the module in which the document was created.
Instrument Blocks
Instrument blocks are represented by icons and . In the Hook-Ups folder,
instrument block options are not in use because they are only used in a CAD loop
drawing generation. You manage instrument blocks in the Loops folder.
Related Topics
page 216
Items in the Loops Folder

The Loops folder of the Domain Explorer enables you to navigate to a loop number,
tag number, or CAD block in a graphical way resembling the Windows Explorer.
You can expand or collapse the levels to view the existing loop numbers, tag
numbers, and CAD blocks. The Loops folder shows you at a glance the graphical
representation of the relationships that exist among the loops, instruments, and
blocks.
To perform an action, right-click the Loops folder or an item and then click a
command. Note that the software uses various icons beside a folder or item to
indicate the status of a folder or an item , for example a view-only item , a claimed
item , an item that belongs to As-Built, and so forth. For the full list of the item
indicators, see Item Status Indicators in the Domain Explorer, page 253. For a
detailed explanation of the tree view and Items panes, see Working with the Domain
The software arranges the items in three levels based on the relationship among them.

Level 1
Loops
This is the highest level in the Loops folder. This hierarchy level contains all the
loop numbers existing at the current highest plant hierarchy level. Loops are
indicated with the icon.
Loops contain tag numbers, which in turn contain blocks. For each loop, on the
shortcut menu, you can click New to add instruments. Also, you can assign
documents to loops. These documents are associated with drawings that you generate
for the loop. Loops can display annotations which refer to the generation method you
assigned for that loop, for example, C indicates a CAD method, M indicates a manual
method (intended for generation without using SmartPlant Instrumentation options).
Level 2
Instruments
The second hierarchy level contains all the instrument tag numbers that are associated
with the existing loops. Instruments are shown as .
If you use a CAD application to generate loop drawings, under instrument tags, you
can add instrument blocks using the following block assignment methods:
Block-tag assignment — Allows you to assign a block to a tag number manually,

using the shortcut menu command Associate Blocks with Tag Numbers.
Block-instrument type assignment — Allows you to assign a block to the instrument

type, and, thus, assign this block to all the tag numbers that belong to this instrument
type. To perform this operation, on the Actions menu of the Loop Drawings
Module window, click Block-Instrument Type Assignment.
Loop Blocks
If you use a CAD application to generate loop drawings, at the second level of the
Loops folder hierarchy, you can assign CAD drawing blocks to the loop. Loop
blocks are indicated with the icon.
In the Domain Explorer, you create and manage loop blocks in the Drawing Block
Types > Loop Block folder.
Documents
The second hierarchy level contains all the documents that are associated with the
loop drawings you generated. Documents are indicated with the icon.
The software assigns a document number to a loop on loop creation. However, in the
Loops folder, the software only displays a document number after generating a
drawing for a loop. You can view and modify document numbers using options of
the Loop Drawing List dialog box, which you can open using a shortcut menu
command.

Level 3
Instrument Blocks
Instrument blocks, which are used in a CAD loop drawing generation, are the lowest
level in the Loops folder hierarchy. The displayed blocks are those blocks that you
associated with the instrument tag numbers according to the method of association.
The block icons that the software displays depend on the block assignment method:
• — Indicates blocks associated with instrument tags manually. At the

instrument level, on the shortcut menu, click Actions > Associate Blocks
with Tag Numbers.
• — Indicates blocks associated with a specific instrument type to
which the instruments belong. On the Actions menu of the Loop
Drawings Module window, click Block - Instrument Type Assignment.
You create and manage instrument blocks in the Drawing Block Types folder of the
Domain Explorer, where the instrument blocks are indicated with the icon.
Control System Tags

Control system tags appear at the lowest level of the Loops folder hierarchy, under
instruments. You manage control system tags in the I/O Assignment window. In the
Loops folder, you can only update the control system tag properties. Control system
tags are shown as .
Related Topics
page 216

Association Rules in the Domain Explorer

You can move and create associations among items by dragging them from one
parent item to another in the Domain Explorer. The following table summarizes the
rules that govern these associations.
Source Item in Target Folder or Result Pre-

the Domain Item in the conditions
Explorer Domain Explorer
Loop The Loops folder The software moves the loop
in another <unit> to the target <unit>.
Loop P&ID drawing The software associates the
loop with the target P&ID
drawing.
Instrument The Instruments The software moves the
folder in another instrument to the target
<unit> <unit>.
Instrument Loop The software associates the
instrument with the target
loop.
Instrument Line The software associates the
line.
Instrument Process equipment The software associates the
process equipment.
Instrument P&ID drawing The software associates the
P&ID drawing.
Functional The Loops folder The software moves the
requirement tag in another <unit> functional requirement tag to
the target <unit>.
Location Location The software moves the
location to the target location
in the Panels by Location
folder (in accordance with the
location level structure
defined by the Domain
Administrator).
Panel (all panel Location The software associates the
categories) panel with the target location.


Device panel Panel (apart from The software moves the
device panel and device panel to the target
plug-and-socket panel.
junction box)
Plug-and-Socket Panel (apart from The software moves the plug-
junction box device panel and and-socket junction box to the
plug-and-socket target panel.
junction box)
Rack Panel (apart from The software moves the rack
device panel and to the target panel.
plug-and-socket
junction box)
Wiring Panel (apart from The software moves the See Note 1.
equipment item device panel and wiring equipment item to the
(for example: I/O plug-and-socket target panel.
card, fieldbus junction box)
brick, and so
forth)
Wiring Rack The software moves the See Note 1.
equipment item wiring equipment item to the
(for example: I/O target rack.
card, fieldbus
brick, and so
forth)
Wiring Terminal strip The software moves the See Note 1.
equipment item wiring equipment item to the
(for example: I/O target terminal strip.
card, fieldbus
brick, and so
forth)
Wiring Slot The software moves the loop See Note 1.
equipment item to the target slot.
(for example: I/O
card, fieldbus
brick, and so
forth)
Connector Panel (apart from The software moves the See Notes 2
device panel and connector to the target panel. and 3.
plug-and-socket
junction box)


Connector Rack The software moves the See Notes 2
connector to the target rack. and 3.
Connector Wiring equipment The software moves the See Notes 2
item connector to the target wiring and 3.
equipment item .
Connector Slot The software moves the See Notes 2
connector to the target slot. and 3.
Connector Cable The software moves the See Notes 2
connector to the target cable. and 3.
Terminal strip Panel (apart from The software moves the See Note 4.
device panel and terminal strip to the target
plug-and-socket panel.
junction box)
Terminal strip Rack The software moves the See Note 4.
terminal strip to the target
rack.
Terminal strip Wiring equipment The software moves the See Note 4.
item (e.g., I/O terminal strip to the target
card, fieldbus wiring equipment item.
brick, etc.)
Terminal strip Slot The software moves the See Note 4.
terminal strip to the target
slot.
Terminal Terminal strip The software moves the
terminal to the target terminal
strip.
Terminal Channel The software moves the
terminal to the target channel.
Channel Wiring equipment The software moves the
item (for example: channel to the target wiring
I/O card, fieldbus equipment item.
brick, and so
forth)
Channel Terminal strip The software moves the
channel to the target wiring
terminal strip.
Cable set Cable The software moves the cable
set to the target cable.


Cable set Cross cable The software moves the cable
set to the target cross cable.
Wire Cable set The software moves the wire Connected
to the target cable set. wires cannot
be moved.
Line P&ID drawing The software associates the
line with the target P&ID
drawing.
Hook-Up Hook-up type The software associates the
hook-up with the target hook-
up type.
Notes
1. I/O cards cannot be moved if they function as primary or secondary I/O cards.
2. Wiring equipment connectors cannot be moved to cables.
3. Cable connectors can only be moved to other cables. This is possible only if none
of the connector pins are associated with wires.
4. Terminal strips cannot be moved if:
• They are used in instrument type profile definition.
• They are associated with Auto-Wiring tasks.
• They are associated with CS tags.
• They are associated with general or local signals.
Special Conditions
• The software does not allow you to drag items to incompatible hierarchies.
For example, you cannot drag a rack to device panel or a plug-and-socket
junction box.
• The software does not allow you to move an item that contains a child
item that cannot be moved. For example, you cannot move a rack if it
contains an I/O card that functions as a primary or secondary I/O card for
an I/O termination.
• In an Operating owner domain, you cannot move items that have not been
claimed for the current project.
Related Topics
page 216

Item Status Indicators in the Domain Explorer

The software uses a number of icons to indicate the status of various folders and
items in your domain. The icons appear beside the folders and items in the tree view
of the Domain Explorer.
Icon Description
An item that belongs to the current project.
An item that belongs to As-Built. When working in a project with As-Built
items displayed, As-Built items are view-only. In the Domain Explorer, you
can select an As-Built item and display its properties.
A dummy item.
An item that does not belong to the current project or As-Built. Also, an item
that belongs to As-Built and all the projects, for a example, a hook-up type.
An item that cannot be deleted, duplicated, and under which no child items can
be created. However, you can edit the item properties and move the item to
another hierarchy level.
Access denied.
View-only. The item is marked as view-only if it has not been created using the
Domain Explorer. You cannot delete such an item or manage the item
properties using the Domain Explorer options. For example, a document, such
as a specification is always marked as view-only. However, you can open the
spec print preview and make changes as you require.
An item that cannot be deleted, duplicated, moved to another hierarchy level,
and under which no child items can be created. However, you can edit the item
properties.
An As-Built item that has been claimed for a project.
Indicates that a folder or parent hierarchy item has been filtered according to an
item type.
Indicates that a folder or parent hierarchy item has been filtered according to an
item type name.
Notes
• An item without any indicator denotes an item that is not supported by the
Domain Explorer. The software allows you to perform actions with such
items only from the pertinent SmartPlant Instrumentation modules.
• The software does not use item indicators in the Reference Explorer.
Related Topics

Create an Item in the Domain Explorer

2. In the tree view pane, expand the plant hierarchy to display the folder in which
you need to create the new item .
3. Right-click the folder in which you need to create the new item .
4. On the shortcut menu, point to New and then click the command that you require.
Note
• When you create an item in the domain explorer, make sure you set the
naming convention for it in the Admin module. For details see Naming
Conventions: An Overview in the Administration User's Guide, under
Domain Administration.
Related Topics
page 216
Duplicate an Item
1. Do one of the following
• Press F7 to open the Domain Explorer.
• Press F8 to open the Reference Explorer.
2. In the tree view pane, expand the plant hierarchy.
• In the tree view pane, select an item.
• In the Items pane, select one or more items.
4. Right-click the selected items and then on the shortcut menu, click Duplicate.
5. Modify the properties as you require. For help with individual properties, click
the Help button on the dialog box.
Note
• When you duplicate an item in the domain explorer, the duplicate item
inherits the naming conventions from the original item. Make sure you
set the naming convention for an item you wish to duplicate. For
details see Naming Conventions: An Overview in the Administration
User's Guide, under Domain Administration.
Related Topics
• Reference Explorer Common Tasks, page 270

Move an Item in the Domain Explorer

2. In the tree view pane, expand a hierarchy to display the item that you want to
move.
3. Drag your selection to the required destination in the Domain Explorer.
Related Topics
page 216

• In the tree view pane, select an item .
4. Right-click the selected items and then on the shortcut menu, click Properties.
5. Modify the properties as you require. For help with individual properties, click
the Help button on the dialog box.
Related Topics
page 216
Delete Items
1. Press F7 to open the Domain Explorer or F8 to open the Reference Explorer.
• In the tree view pane, select an item .
4. Right-click the selected items and then on the shortcut menu, click Delete.

Perform Various Actions with an Instrument

2. In the tree view pane, expand the plant hierarchy to display the Instruments
folder.
3. Expand the Instruments folder and then right-click a tag number.
4. On the shortcut menu, point to Actions and then click the command that you
require.
Related Topics
page 216
Generate a Report for an Instrument

folder.
4. On the shortcut menu, point to Reports and then click the command that you
require.
Related Topics
page 216
Generate a Specification or a Process Data Sheet for an

Instrument
folder.
4. On the shortcut menu, point to Actions and then click the command that you
require.
Related Topics
page 216

Copy a Reference Item to the Domain Explorer

1. Press F7 and then F8 to open the Domain Explorer and the Reference Explorer.
2. In the Reference Explorer, expand a hierarchy level and select a reference item.
3. Drag your selection to a destination level in the Domain Explorer. Place both
Explorer windows side by side on your screen and then drag the required items
from one Explorer to the other.
4. In the appropriate properties dialog box, (depending on the reference item that
you are copying), modify the properties of the new item as you require.
Related Topics
page 216

2. On the toolbar, click to open the Search dialog box.

3. Select an item type. Note that the Item type list is a required field and without
selecting an item type, the software cannot proceed with the search.
4. Under Item name, type a name of an item that you want to find.
Tip
• You can use wildcard characters (* or %) to find items whose names
contain part of the text that you type. If you do not know the item
name, leave the asterisk * in this field.
5. Under Search in, select a plant hierarchy level on which the software searches for
items:
• Entire domain — the current domain that you selected in the Open
dialog box when you started SmartPlant Instrumentation.
• Current highest plant hierarchy level — the highest plant
hierarchy level that you selected in the Open dialog box, for example,
your current plant.
• Current lowest plant hierarchy level — the lowest plant hierarchy
level that you selected in the Open dialog box, for example, your
current unit.

6. In the Item properties data window, if needed, specify item properties so that the
software looks for items with those properties only. Click Add to append a new
row if you want to specify more than one property.
• Property— select an existing property from the list.
• Operator — select an operator from the list to determine how the
selected property will relate to the expression you type in the Value
field.
• Value— type an appropriate value to determine how the selected
property will be specified.
• Logic— select a logic operator (AND or OR) to determine how the
next expression will relate to the current one. Leave this field empty if
this is the last expression you are defining.
7. Click Search Now.
8. In the Results data window, select the items that you want to work with and click
Add to My List.
Notes
• After the software finds the items that you were looking for and lists them
in the Results data window, you can search for more items without losing
your current results. Select another item type and click Search Now. The
software adds the newly found items to the previously found results.
• To start a new search and clear the Search results data window.
Related Topics
page 216

Find an Item in the Tree View of an Explorer Window

2. In the tree view pane, expand the tree view hierarchy and navigate to a folder.
3. Right-click the folder that you require and then on the shortcut menu, click Find
Item .
4. On the Find Item dialog box, select Match case if you want the software to find
items whose names match the capitalization of the item name you entered.
5. Select Find whole name only if you want the software to search for occurrences
that are whole names and not part of a larger item name.
• Under Item , type a name and click Find.
• Select As typed and then under Item type a name. The software looks
for the item as you type. You can set the search delay to determine
how long the software will wait after the last time you press a key on
your keyboard.
7. Click Close.
Related Topics
• Search for Items in SmartPlant Instrumentation Explorer, page 257
page 216

Filter the Display of Items According to a Specific Item

Name
1. In an Explorer window, do one of the following:

toolbar.
2. On the Filter Definition dialog box, type a filter name as you require.
3. On the Item Name tab, under Item name, type a valid name or part of a name.
You can use wildcard characters to specify partial strings: asterisk (*) or percent
(%) for multiple characters and underscore (_) for single characters.
4. Select the Override all item type filters check box if you want this item name
filter the software to override all existing item type filters. Normally, item name
filters do not take effect if an item type filter exists.
5. To filter the data of the current lowest plant group, select the Current lowest
plant hierarchy level check box.
6. To limit the display of items to only those that were created by the current user,
select the Show items created by the current user only check box.
7. Click OK.
Notes
• To clear the filter, on the Filter Definition dialog box, delete the filter
definition.
• Filter settings take effect only for the user who defined the filter and only
for the current custom view of the active Explorer window.
• Item type filters override your item name filters.
Related Topics
• Filter Cables in an Explorer Window, page 263
• Filter Loops in an Explorer Window, page 265
• Filter the Display of Items According to a Specific Item Type, page 261
page 216


1. In an Explorer window, do one of the following:
• To filter the entire tree view, select a hierarchy node whose immediate
child items are folders and not plant items. Then click on the
toolbar.
• To filter a particular folder or a hierarchy node, select a hierarchy node
or a folder containing the items that you want to filter and then click
.
Alternatively, you can right-click a folder or a hierarchy node and then
on the shortcut menu, click Filter.
2. On the Filter Definition dialog box, type a filter name as you require.
3. On the Item Type tab, from the Item type list, select an item type appropriate to
the folder or parent node that you selected in the tree view.
4. Select one of the following options:
• If, in the Explorer tree view, you selected a hierarchy node whose
immediate child items are folders and not plant items, click the All the
tree view option button.
• If you selected a particular folder or hierarchy node, click the Selected
folder or parent item option button.
5. From the Item type list, select an item type according to which you want to set
the filter.
Tip
• If, in the Explorer tree view, you select a hierarchy node whose
immediate child items are folders and not plant items, the Item type
list contains all the item types of the child items that belong to the
selected folders.

6. In the Filter definition group box, define the criteria that you use to filter the
items displayed:
• Property— select a property to use for filtering the items.
• Operator — select the required comparison operator to determine
how the header selected under Property will relate to the expression
you select for Value.
• Value — select or type a required value for the item you selected
under Property. The available values depend on the specific property
that you select.
• Logic — You use this option when you specify more than one filter
condition. The option allows you to select the required logical
operator (And or Or) to determine how the next filter expression will
relate to the current expression. When you have a mixture of logical
operators for several conditions, the software performs the expressions
on the conditions in order, for example:
(A and B) or C
(A or B) and C
7. Click Add if you want to add another item type property to the filter definition.
8. Click Verify to check the validity of the current filtering condition.
9. To filter the data of the current lowest plant group, select the Current lowest
plant hierarchy level check box.
10. To limit the display of items to only those that were created by the current user,
select the Show items created by the current user only check box.
11. Click OK.
Notes
• Clicking Advanced allows you to define an additional filter for the
Cables, Cross Cables, and Loops folders. For details, see Filter Cables
in an Explorer Window, page 263 and Filter Loops in an Explorer
Window, page 265.
• To reset the filter, click Reset.
• To clear the filter, right-click a hierarchy node and then on the shortcut
menu, click Clear Filter.
• When filtering the entire domain or setting a filter without selecting a
specific node or folder, the Clear Filter command is not available. In this
case, to clear the filter, open the Filter Definition dialog box and delete
the filter definition.
• Filter settings take effect only for the user who defined the filter and only
for the current custom view of the active Explorer window.
• Item type filters override your item name filters.


1. In an Explorer window, select the Cables or the Cross Cables folder and do one
of the following:
• Right-click the folder, and then click Filter.
• On the Explorer window toolbar, click .
2. On the Filter Definition (Cables) dialog box, type a filter name.
3. Click Advanced.
4. On the Advanced Filter Definition (Cables) dialog box, do one of the following:
• Select the Look for connections check box to include and select
connection criteria in the filter condition.
• Clear the Look for connections check box if you do not want to
include any of the connection criteria in the filter condition. Selecting
this option disables the check boxes in this group box and in the
Connected to group box.
5. To select a connection criterion, in the Connection group box, click the
following:
• No connections on either end— Filters for cables that are not
connected to anything on either wire end.
• At least one wire connected on one end only— Filters for cables
that contain at least one wire that is only connected on one of its ends.
• At least one wire connected on both ends— Filters for cables that
contain at least one wire that is connected on both wire ends.
6. In the Connected to group box, select one or more check boxes to define a filter
according to the type of panel that is connected to the cable. This selection
defines connection criteria for cables that have at least one wire connected to one
or both ends.
• Junction boxes— Filter for all the cables that are connected to
junction boxes.
• Marshaling racks— Filter for all the cables that are connected to
marshaling racks.
• Cabinets— Filter for all the cables that are connected to cabinets.
• Device panels— Filter for all the cables that are connected to device
panels.
• DCS panels— Filter for all the cables that are connected to DCS
panels.
• PLC panels— Filter for all the cables that are connected to DCS
panels.

7. In the Cable associations group box, select an appropriate Foundation Fieldbus

or Profibus segment if you want to filter for cables that are associated with a
specific fieldbus segment.
8. Select the Display telecom cables check box only if you want to filter the Cables
folder so that it displays telecom cables only.
9. Select the Cables without sets check box to filter for cables that were created
without sets and wires. This feature is useful when creating a cable block
diagram.
10. Click OK in the Advanced Filter Definition (Cables) dialog box.
11. Click OK in the Filter Definition dialog box.
Related Topics
• Define a Filter for Pre-Assigned Device Cables, page 264
• Filter Loops in an Explorer Window, page 265
• Filter the Display of Items According to a Specific Item Name, page 260
page 216
Define a Filter for Pre-Assigned Device Cables

1. In the Domain Explorer, click .
2. On the Filter Definition (Cables) dialog box, click Advanced.
3. On the Advanced Filter Definition (Cables) dialog box, select the Display pre-
assigned device cables only check box.
4. Select the junction box that you require from the list below.
Related Topics
page 216


1. In an Explorer window, select the Loops folder and do one of the following:
• Right-click the folder, and then click Filter.
• On the Explorer window toolbar, click .
2. To filter according to an item name in the Loops folder, under Item name, type a
valid name or part of a name. You can use wildcard characters to specify partial
strings: asterisk (*) or percent (%) for multiple characters and underscore (_) for
single characters.
Tip
• The value that you enter in this box overrides all other filter criteria in
this dialog box.
3. Type a filter name.
• Select Selected node definition to filter the child items that belong to
a folder or the items at any hierarchy level that you selected in the
Explorer tree view.
• Select Global definition to define a filter for the entire tree view of
the active Explorer. The software applies this definition to the item
type you selected. If you defined a filter definition for a specific
folder, the filter for the folder overrides the settings for the global filter
definition.
5. In the Filter definition group box, define the criteria that you use to filter the
items displayed:
• Property— select a property to use for filtering the items.
• Operator — select the required comparison operator to determine
how the header selected under Property will relate to the expression
you select for Value.
• Value — select or type a required value for the item you selected
under Property. The available values depend on the specific property
that you select.
• Logic — You use this option when you specify more than one filter
condition. The option allows you to select the required logical
operator (And or Or) to determine how the next filter expression will
relate to the current expression. When you have a mixture of logical
operators for several conditions, the software performs the expressions
on the conditions in order, for example:
(A and B) or C
(A or B) and C

6. Click Verify to check the validity of the current filtering condition.

7. Click Advanced to define a filter for loops according to loop blocks.
8. In the dialog box that opens, if needed, under Display level for blocks, click one
of the following to filter the blocks displayed in the data windows:
• Highest plant hierarchy level— Displays blocks on the highest level
of the plant hierarchy defined by the Domain Administrator. The
default level is Plant.
• Lowest plant hierarchy level— Displays blocks on the lowest level
of the plant hierarchy defined by the Domain Administrator. The
default level is Unit.
9. To filter the loops according to blocks, do one of the following:
• Under Blocks associated with tags, select one or more blocks that are
associated with loop tags. After you select these blocks, in the current
explorer window, the software only displays loops whose blocks are
assigned to tags using the block-tag assignment method.
• Under Blocks associated with instrument type, select one or more
blocks that are associated with the instrument type of the loop tags.
After you select these blocks, in the current explorer window, the
software only displays loops whose blocks are assigned to tags using
the block-instrument type assignment method.
Tip
• In the Loops folder, blocks associated with tags using the manual
block assignment method are marked with the icon . Blocks
associated with tags using the automatic block assignment method are
marked with the icon .
10. Click OK in the Advanced Filter Definition (Loops) dialog box.
11. Click OK in the Filter Definition dialog box.
Related Topics
page 216


• In the tree view pane of the Domain Explorer, expand the plant
hierarchy and then select a folder or an item .
• In the tree view pane of the Reference Explorer, select a folder or an
item .
2. Right-click the selected folder or item and then on the shortcut menu, click Show
Browser.
3. From the Browser view list, select a Browser view that exists in the Browser
module.
Important
• If there are no Browser views on this list or if the browser view you
need is not on the list, close the Show Browser dialog box and switch
to the Browser module. In the Browser Manager, open the style
settings of the browser view that you need. Select the Enable in
explorer windows check box and then click Save. Open the Show
Browser dialog box again and select the browser view that you need.
Related Topics
page 216
Add Items to My List in the Items Pane

• Press F7 to open the Domain Explorer and do one of the following:
• In the Domain Explorer tree view, right-click an item and then on the
shortcut menu, click Add to My List.
• In the Items pane, click My List and then drag an item from the tree
view to My List.
Notes
• To remove an item from My List, right-click it and then click Remove
from My List.
• To clear the My List view of all the items, right-click an item and then
click Remove All.


1. Press F7 to open the Domain Explorer or F8 to open the Reference Explorer.
2. Click above the toolbar.
3. On the Custom View Properties dialog box, click New.
4. Type a custom view name and then click OK.
• Right-click a single folder in the tree view pane.
• Right-click multiple folders in the Items pane.
6. On the shortcut menu, click Add to Custom View and then click the command
for the appropriate custom view.
Note
• To remove a folder from a custom view, right-click a folder and then on
the shortcut menu, click Remove from Custom View.
Related Topics
page 216

Working with the Reference Explorer: An Overview
Working with the Reference Explorer: An

Overview
The Reference Explorer allows you to create and manage all the available wiring
reference items that are created by SmartPlant Instrumentation users and that are
provided with the software. Note that wiring reference items are typical
configurations that facilitate rapid creation of various wiring items in your domain.
The Reference Explorer displays a graphical representation of the relationships that

exist among the predefined wiring equipment, panels, terminal strips, and terminals as
well as cables, cable sets, and wires. Also, you can manage hook-up libraries and
hook-up items.
You can use predefined configurations as reference items and copy them to the
Domain Explorer. For more information about using reference wiring items, see
Copy a Reference Item to the Domain Explorer, page 257.
You can open the Reference Explorer from anywhere in SmartPlant

Instrumentation. Press F8 or on the Tools menu, click Reference Explorer.
The tree view pane of the Reference Explorer shows reference items organized by
folders. SmartPlant Instrumentation defines standard folders in the database. You
contains a particular item type, and the options available on the shortcut menus
depend on the currently selected item type.
Item status indicators — the software uses various icons beside a folder or item to
indicate the status of a folder or an item, for example access denied, view only, an
item that belongs to As-Built, and so forth. For the full list of the item indicators,
see Item Status Indicators in the Domain Explorer, page 253.
Notes
• You can create several instances of the Reference Explorer by pressing
F8.
• After exiting SmartPlant Instrumentation, and starting a new session, the
software retains the size and position of all the windows that were open in
the previous session.
Related Topics
• Copy a Reference Item to the Domain Explorer, page 257
page 216

Reference Explorer Common Tasks

The following tasks are used frequently when you work with the Reference
Explorer.
Create a Reference Item

This procedure shows how to create an item in the Reference Explorer. For more
information, see Create a Reference Item, page 277.
Create a Reference I/O Card

This procedure explains how to create a reference I/O card. For more information,
see Create a Reference I/O Card, page 277.
Create a Reference I/O Termination

This procedure explains how to create a reference I/O termination. For more
information, see Create a Reference I/O Termination, page 282.
Create a Reference Wiring Equipment Item

This procedure explains how to create a reference wiring equipment item. For more
information, see Create a Reference Wiring Equipment Item, page 280.

This procedure explains how to copy a reference item from the Reference Explorer
to the Domain Explorer. This way you can create numerous plant items based on
typical configurations on the fly. Note that SmartPlant Instrumentation allows you to
preserve the internal connections within a copied item. This means that the software
retains the cables and cross wires that connect among the various terminal strips
within the item that you are copying. Also, if you are copying a panel or another item
that contains child items, the software duplicates this item in its entirety, including all
the existing child items.
For more information, see Copy a Reference Item to the Domain Explorer, page 257.

This procedure explains how to edit the properties of an item that you select in the
Reference Explorer. For more information, see Edit Item Properties, page 255.

Duplicate an Item
You use this action to create a duplicate item within the same parent hierarchy. That
is, the software creates another copy of the selected item under the immediate parent
item. For example, if you need to insert an apparatus within an existing apparatus
group, expand an apparatus group and duplicate an apparatus. You can then change
the sequence numbers of the apparatuses to re-arrange them on the strip the way you
require. Furthermore, if you are duplicating a panel or another item that contains
child items, the software duplicates this item in its entirety. That is, SmartPlant
Instrumentation creates the new item with exactly the same child items as the original
panel. Note that in this case, the software also retains all the existing internal
connections if you selected Copy internal connections in the wiring preferences.
For more information, see Duplicate an Item, page 254.
Delete Items
This procedure shows how to delete the items that you select in the Reference
Explorer. For more information, see Delete Items, page 255.

You use this feature to find items that you want to work with. You can search for
multiple items in the entire domain, the current highest plant hierarchy level, or the
current lowest plant hierarchy level. The term "current" refers to the plant hierarchy
level that you selected in the Open dialog box when you started SmartPlant
Instrumentation. For more information about searching for items, see Search for
Items in SmartPlant Instrumentation Explorer, page 257.
Find an Item in the Tree View

This feature enables you to find an item in the Reference Explorer tree view. This
feature is especially useful when you want to find an item in a particular folder that
contains numerous items. You can type an item name and click Find or you can let
the software look for the item as you type the item name. The feature allows you to
set the search delay that determines how long the software waits after the last time
you press a key on your keyboard.
For more information, see Find an Item in the Tree View of an Explorer Window,
page 259.


This option allows you to filter the items according to a specific item type. You can
apply an item type filter to the entire tree view of the current view of the current
Explorer window or only to a particular folder or node that contains child items.
Item type filters override your item name filters.
Filter settings take effect only for the user who defined the filter and only for the
current custom view of the active Explorer window.
Note that item type filters override your item name filters.
For more information, see Filter the Display of Items According to a Specific Item
Type, page 261.
Filter the Display of Items According to a Specific Item Name

This option allows you to filter the items according to a specific item name. An item
name filter affects the entire tree view of the current view of the active Explorer
window and not just a particular folder or hierarchy node. You can also instruct the
software to override the item type filters if needed.
You can define an item name filter only if you do one of the following:

toolbar.
Note that filter settings take effect only for the user who defined the filter and only for
the current custom view of the active Explorer window. For more information, see
Filter the Display of Items According to a Specific Item Name, page 260.

Allows you to set additional filter definitions for the Cables and the Cross Cables
folders. You can filter cables according to their connections and cables that are
connected to a specific Foundation Fieldbus or Profibus segment. For more
information, see Filter Cables in an Explorer Window, page 263.


Allows you to set additional filter definitions for the Loops folder. You can filter
loops according to blocks associated with loop tags. For more information, see Filter
Loops in an Explorer Window, page 265.
Use My List in the Items Pane

This procedure explains how to add various items to the My List view of the Items
pane. My List allows you to create a special view of the Items pane where you can
keep items that belong to various folders in the tree view. The software retains all the
items in the My List view until you remove them from that list. Exiting SmartPlant
Instrumentation and starting a new session does not affect the contents of My List.
For more information, see Add Items to My List in the Items Pane, page 267.

This option allows you to display a browser view in the Items pane for an item type
or a folder that you select in the Reference Explorer tree view. This way, instead of
displaying child items, you can display item properties of the item you selected in the
tree view pane. The software displays the browser view according to the style
settings of the selected browser. You can print out the current browser view,
however, you cannot edit the item properties. For more information, see Display a
Browser View in the Explorer Items Pane, page 267.

SmartPlant Instrumentation allows you to define custom views for the Domain
Explorer and the Reference Explorer. The software lets you select a folder or
multiple folders and add these folders with their child items to a custom view that you
select. Note that the custom views that you define are not available to other users of
SmartPlant Instrumentation. For more information, see Define and Use a Custom
View, page 268.

The Organization of Items in the Reference Explorer Tree

View
The tree view pane of the Reference Explorer shows reference items organized by
folders. SmartPlant Instrumentation defines standard folders in the database. You
Panels
In this folder, reference panels are arranged according to their category. Panels, in
turn, contain their child items, for example terminal strips, racks, wiring equipment,
and so forth. There is a lot of flexibility in creating a panel hierarchy. There is no
rigid structure like "panel – strip – terminal" that limits your wiring design. You
can create various wiring structures, as you require. For details, see Panels by
Category Hierarchy Examples, page 239 to examine a few possible structures.
Cables
This folder holds all the existing reference cables. You can create various child items
under cables. For an example, see Cable Hierarchy Example, page 241.
Wiring Equipment
This folder holds all the available reference wiring equipment. The items are
organized in sub-folders according to the wiring equipment category such as barriers,
amplifiers, hubs, I/O cards, and so forth.
Hook-Up Item Libraries

This folder enables you to create and manage hook-up libraries and sub-libraries, and
organize hook-up items in sub-libraries as you require. For details, see Items in the
Hook-Up Item Libraries Folder, page 275.
Related Topics
page 216

Items in the Hook-Up Item Libraries Folder

The Hook-Up Item Libraries folder of the Reference Explorer enables you to
navigate to a hook-up item library, hook-up item sub-library, or hook-up item in a
graphical way resembling the Windows Explorer. You can expand or collapse the
levels to view the existing items. The Hook-Up Item Libraries folder shows you at
a glance the graphical representation of the relationships that exist among the hook-up
item libraries, hook-up item sub-libraries, and hook-up items.
The Reference Explorer employs an expandable/collapsible hierarchy that allows

you to navigate to relevant items and select them for use. To perform an action, right-
click the Hook-Up Item Libraries folder or an item and then click a command. Note
that the software uses various icons beside a folder or item to indicate the status of a
folder or an item , for example a view-only item , a claimed item , an item that
belongs to As-Built, and so forth. For the full list of the item indicators, see Item
Status Indicators in the Domain Explorer, page 253. For a detailed explanation of the
tree view and Items panes, see Working with the Reference Explorer: An Overview,
page 269.
In the Hook-Up Item Libraries folder, the software arranges the items in three
levels, based on the relationship among them.
Level 1
Hook-Up Item Libraries
This is the highest level in the Hook-Up Item Libraries folder hierarchy. At this
level, the software displays all the hook-up libraries that exist in the current domain.
Hook-up libraries are indicated with the icon.
A hook-up library always contains one default sub-library and can also contain any
number of user-defined sub-libraries. For each hook-up library, on the shortcut
menu, you can click New to add user-defined sub-libraries, or click Properties to
update properties of an existing sub-library. You must set a specific library as the
active item library, which is indicated with the icon. To do so, on the shortcut
menu, click Actions > Set as Active Item Library. You cannot delete the default
sub-library.
Level 2
Hook-Up Item Sub-Libraries
Hook-up sub-libraries (indicated with the icon) appear under hook-up libraries.
At this level, you can click New to add items to sub-libraries, or click Properties to
update properties of an existing sub-library. You cannot delete the default sub-
library.

Level 3
Hook-Up Items
Hook-up items (indicated with the icon) appear under hook-up item sub-libraries.
Hook-up items do not contain child items. The actions that you can perform at this
level depend on the sub-library to which the items belong.
In the default sub-library, you can perform the following actions:
• Add new hook-up items one by one or in batch mode. To add a single
item, right-click the default sub-library and on the shortcut menu, click
New. To add items in batch mode, on the shortcut menu, click Actions >
Batch Item Creation.
• Update properties of an existing item. If this item exists in the user-
defined sub-libraries, the software automatically updates the item
properties in the user-defined sub-libraries.
• Permanently delete a hook-up item. When deleting an item from the
default sub-library, the software also deletes this item from all of the sub-
libraries that exist in the entire item library.
• Manually associate an item with a user-defined sub-library by dragging
the item from the default sub-library to a user-defined sub-library.
In a user-defined sub-library, you can perform the following actions:
• Add new hook-up items. When you create a new item in a user-defined
sub-library, the software automatically creates this item in the default sub-
library too.
• Update properties of an existing item. When you update properties of an
item in a user-defined sub-library, the software automatically updates the
item properties in the default sub-library too. You can only add new
hook-up items that do not exist in the default sib-library.
• Associate hook-up items with sub-libraries or remove items from sub-
libraries. To do so, select and right-click a user-defined sub-library and
then, on the shortcut menu, click Actions > Associate Items with Sub-
Libraries.
• Associate pipe specs with sub-libraries. To do so, select and right-click a
user-defined sub-library and then, on the shortcut menu, click Actions >
Associate Pipe Specs with Sub-Libraries.
Related Topics
• The Organization of Items in the Domain Explorer Tree View, page 236
• Working with the Reference Explorer: An Overview, page 269

Create a Reference Item

1. Press F8 to open the Reference Explorer.
2. Double-click a folder to display the other existing folders or items.
Tip
• If a folder does not contain sub-folders, right-click the main folder.
3. Right-click a sub-folder and then on the shortcut menu, point to New and click a
menu command.
Note
• The software does not check for duplicate names when creating a
reference I/O card. This is so because I/O card uniqueness is based on a
parent item and there are no parent items for I/O cards in the Reference
Explorer.
Related Topics
page 216
Create a Reference I/O Card

1. Press F8 to open the Reference Explorer and expand the Panels folder.
2. In the Reference Explorer, expand the Wiring Equipment folder.
3. Right-click the I/O Cards folder and then on the shortcut menu, click New >
Wiring Equipment.
4. In the New Wiring Equipment dialog box, under Name, type the name of the
new I/O card and click OK.
Tip
• As a rule, I/O cards reside in rack slots. However, reference I/O cards
do not have parent hierarchy items. As a result, the software does not
check the name uniqueness of new reference I/O cards. Therefore,
make sure that you name your new reference I/O cards appropriately.

5. On the Wiring Equipment Properties - I/O Card dialog box, on the General
tab, do one of the following to define the name of the new card:
• Select the Apply naming convention check box selected if you want
the software to name the new card automatically according to the
naming conventions that are set for this type of equipment in the
Administration module. For more information, see SmartPlant
Instrumentation Administration Help, Domain Administration >
Naming Conventions.
• Clear the Apply naming convention check box and under Name, type
the name of the new card. Note that if you do not clear the Apply
naming convention check box, the software will ignore the name that
you type under Name.
6. Select the Double width check box if the card occupies a double width slot.
7. In the Details group box do the following as you require:
a. Type a description.
b. Select an I/O card type, model, and manufacturer. If the required value is not
available on the list, click to define a new one.
c. Enter a sequence if you need to define the sequence of the new card in its
parent item. This sequence also determines the order in which wiring items
appear under their parent item in the Domain Explorer tree view.
8. Click the Control System tab.
9. In the Control system details group box, under I/O type, select a I/O type to
determine the actual function of the new I/O card. For example, AI, AO, DI, DP,
Fieldbus, Profibus, and so forth. You can add more values to this list in the I/O
Type supporting table in the Instrument Index module. (See the important notes
at the end of this procedure.)
10. Under Module, type the software address that this card is assigned to.
Tip
• Module, Controller/Processor, Rack, and Slot are field headers
specific to panel manufacturers. Selecting a different manufacturer
when editing the panel displays the headings used by that panel
manufacturer.
11. From the Controller/Processor list, select an I/O card controller. If the required
controller is not available on the list, click to define a new one.
12. To view the list of all I/O terminations associated with the current I/O card, click
the I/O Terminations button.
13. Click the Category Properties tab.

14. Revise and modify category property values as you require. Click the value for
each property and modify it as needed.
Tip
• I/O card is a wiring equipment category that is shipped with
SmartPlant Instrumentation. You cannot delete or rename any of the
wiring equipment categories that have been shipped with the software.
Nor can you delete or rename the properties of the shipped categories.
However, when editing I/O card properties, you can add user-defined
properties which you can rename or delete as you wish.
15. Click the Associate Symbols tab to associate a symbol with the current I/O cards.
The software will use this symbol when generating a report in the Enhanced
Report Utility.
16. Click OK to accept your settings and close the dialog box.
Important
• In a redundant system configuration, an I/O card can function as a primary
or secondary I/O card and can be associated with several I/O terminations.
Therefore, an I/O termination can serve multi-paired redundant I/O cards.
However, in these redundant I/O card configurations, the I/O termination
can be associated only with one pair of primary and secondary I/O cards.
Also, an I/O card cannot function as both a primary and secondary I/O
card for the same I/O termination.
• If an I/O card functions as a primary I/O card, the Control System tab of
the Wiring Equipment Properties - I/O Card dialog box displays the
secondary I/O card data and the primary I/O card data properties remain
blank. If an I/O card functions as a secondary I/O card, the Control
System tab displays the primary I/O card data and the secondary I/O card
data properties remain blank.
Related Topics

Create a Reference Wiring Equipment Item

3. Right-click an appropriate child folder and then on the shortcut menu, click New
> Wiring Equipment.
Tip
• Since reference wiring equipment items do not have parent hierarchy
items, the software does not check the name uniqueness of new
reference wiring equipment items. Therefore, make sure that you
name your new reference items appropriately.
4. On the New Wiring Equipment dialog box, under Name, type the name of the
item and click OK.
5. On the Wiring Equipment Properties dialog box, on the General tab, do one of
the following to define the name of the new equipment:
the software to name the new equipment automatically according to
the naming conventions that are set for this type of equipment in the
Naming Conventions.
the name of the new equipment. Note that if you do not clear the
Apply naming convention check box, the software will ignore the
name that you type under Name.
6. Select the Double width check box if the item occupies a double width slot.
b. Select an item type, model, and manufacturer. If the required value is not
c. Enter a sequence if you need to define the sequence of the new item in its
parent item . This sequence also determines the order in which wiring items


Tip
• If you are creating a miscellaneous wiring equipment item , the
Category Properties tab is not available.
Tip
• Wiring equipment categories that are shipped with SmartPlant
Instrumentation have predefined properties. You cannot delete or
rename any of these categories or their properties. You can only edit
their values. However, you can add user-defined properties to any
category which you can rename or delete as you wish.
10. Click the Associate Symbols tab to associate a symbol with the current item .
Report Utility.
Related Topics

Create a Reference I/O Termination

3. Right-click the I/O Terminations folder and then on the shortcut menu, click
New > Wiring Equipment.
Tip
• Since reference I/O termination items do not have parent hierarchy
items, the software does not check the name uniqueness of new
reference I/O termination items. Therefore, make sure that you name
your new reference I/O termination items appropriately.
4. On the New Wiring Equipment dialog box, from the Category list, select I/O
Termination.
5. Under Name, type the name of the new I/O termination and click OK.
6. On the Wiring Equipment Properties - I/O Termination dialog box, on the
General tab, do one of the following to define the name of the new card:
Naming Conventions.
b. Select an I/O termination type, model, and manufacturer. If the required value
is not available on the list, click to define a new one.
c. Enter a sequence if you need to define the sequence of the new I/O
termination in its parent item . This sequence also determines the order in
which wiring items appear under their parent item in the Domain Explorer
tree view.

10. From the I/O type list, select a I/O type to determine the actual function of the
new I/O termination. For example, AI, AO, DI, DP, Fieldbus, Profibus, and so
forth. You can add more values to this list in the I/O Type supporting table in the
11. To set the new I/O termination in a distant cabinet or to associate the I/O
termination with an I/O card that resides in another panel, do the following:
a. select the Set within a distant cabinet check box.
b. Select a cabinet in the Primary I/O card group box.
12. To associate the current I/O termination with an I/O card that does not have a
built-in termination block, select the required options in the Primary I/O card
group box.
Tip
• The I/O card list contains only those I/O cards that have been created
under a rack and a slot.
13. To define the current I/O termination as an I/O termination that serves two
redundant I/O cards, do the following:
a. Select the Define a redundant I/O card check box.
b. Select the required options in the Secondary I/O card group box.
Tip
• I/O termination is a wiring equipment category that is shipped with
However, when editing I/O termination properties, you can add user-
defined properties which you can rename or delete as you wish.
16. Click the Associate Symbols tab to associate a symbol with the current I/O
termination. The software will use this symbol when generating a report in the
Related Topics


1. Press F7 and then F8 to open the Domain Explorer and the Reference Explorer.
2. In the Reference Explorer, expand a hierarchy level and select a reference item.
3. Drag your selection to a destination level in the Domain Explorer. Place both
Explorer windows side by side on your screen and then drag the required items
from one Explorer to the other.
4. In the appropriate properties dialog box, (depending on the reference item that
you are copying), modify the properties of the new item as you require.
Related Topics
page 216

Browser Module Overview
Browser Module Overview

The Browser module provides you with a wide-angle view of your instrument index
data and allows you to browse through and modify it from a single location in
The core of the Browser module is the Browser Manager that contains a number of
predefined browsers categorized by data type. Each browser is associated with a
particular SmartPlant Instrumentation module but in some cases, it is possible to
present data from several different modules in a single browser view. In addition to
the predefined browsers, you can also create two types of custom browsers – form
browsers and Powersoft browsers that can be customized according to your needs.
The browsers are grouped according to their category. Such a group is referred to as
a browser group. For example, by defining a browser view for the Control Valve
browser in the Process Data & Calculation group, you can display information for
all instrument tags which have the same process function, for example, flow meters.
You access and manipulate module data and various items by creating customized
browser views for each of the predefined and custom browsers in the Browser
Manager. You customize each browser view by defining its style, sorting sequence,
and filter. You can define a number of different browser views for each browser to
organize your data according to different requirements. Each browser view will have
its own style settings, sorting sequence, and filter to present your instrument index
data in the most efficient and informative manner. The browser view style settings
determine which columns and items will be displayed. The sorting sequence
organizes the selected fields in a particular order and the filter lets you display the
data filtered according to the condition you define.
In addition to the database fields provided to you by default, the Browser Manager
also allows you to display custom fields, which you can use to complement data
attributes not supported by the given database fields in a particular module. You can
modify the names of custom fields, as you desire. Depending on your SmartPlant
Instrumentation license, you can also import browser views into SmartPlant
Instrumentation. The views are available as add-ons, and once added you can use
them to access the required data.
Related Topics
• Adding New Browsers: An Overview, page 336
• Browser Manager Overview, page 286
• Browser Views: An Overview, page 342
• Sort Settings: An Overview, page 321
• Style Settings: An Overview, page 308
• View Filter Settings: An Overview, page 328

Browser Manager Overview

The Browser Manager enables you to define the settings for the Browser View
window that displays your project data. You select your data and determine how the
software displays it in the Browser View window. You define your viewing settings
by defining a view for a selected Browser that is associated with a particular
SmartPlant Instrumentation module. Once you define and then select a view for a
particular browser, the Browser View window displays your data according to the
selected view settings. You define a view by either creating a new view or
duplicating an existing one.
The first step in defining view settings, is to create a browser view profile (viewing
template) for a browser that you select from the Browser groups list. Each browser
view must be based on a view profile that is defined before any other settings can be
selected. A browser view can contain style, sorting sequence, and filter settings:
• Style— select the fields to be displayed, define the field layout (that is,
the order in which these fields will be displayed), define the data field
headers which will be used for the current style, and set the field length
(number of characters) which will be displayed for each selected field.
• Sort — determine the sorting sequence of the fields in the Browser
View window. You can also select a different sorting sequence when
viewing the data in the Browser View window.
• Filter — set a filtering condition that is used to filter the selected data
rows displayed in the Browser View window.
After you have defined all the view settings that you require, you can open the
Browser View window, where the current settings are applied to the data with which
the selected browser is associated.
Related Topics
• Browser Manager Common Tasks, page 287
• Browser Manager Hierarchy, page 296
• Browser Types, page 297

Browser Manager Common Tasks

The following tasks are used frequently when working with the Browser Manager.
Select a Default Browser

This procedure shows you how to define a default browser in the Browser Manager.
This enables you to open the default browser view whenever starting SmartPlant
Instrumentation with the Browser module. If other modules are open, the default
browser option is disabled. For more information, see Select a Default Browser, page
288.
Define a View Profile

This option shows you how to define a view profile, the first step in creating a
browser view. A browser view profile serves as a basis for a browser view. After
creating a view profile, you can define style, sort, and filter settings for the selected
browser view. Once you have defined all the view settings, you can open the view
and work with the available data. For more information, see Define a View Profile,
page 289.
Add a New View

This option shows you how to add a new view to an existing browser, enabling you to
create a customized display of your data. SmartPlant Instrumentation displays your
data in the Browser View window according to the style, sort, and filter settings you
chose. You start by defining a view profile . Then, you define the required style, sort,
and filter settings for the new view. Note that you can also duplicate an existing view
and then modify some of the settings as required. For more information, see Add a
New View, page 290.
Duplicate a View
This procedure shows you how to duplicate an existing view. Creating several
different views for the same browser can be very useful when you need to work with
the same module data organized in a different manner. Duplicating an existing view
within the same browser is a fast way to create a new view on the fly. After
duplicating a view, you can modify it as needed. For more information, see
Duplicate a View, page 291.
Copy a View to Another Plant

This procedure shows you how to copy a view from one <plant> to another within
the same SmartPlant Instrumentation domain. When copying view settings, the
software copies style, sort, and filter settings defined in the source view. For more
information, see Copy a View to Another Plant, page 292.

Modify a View Profile

This option shows you how to modify the profile of an existing browser view. This
can be necessary after duplicating a browser view. For more information, see Modify
a View Profile, page 292.
Delete a View
This option shows you how to delete a browser view that is no longer required.
Remember that when deleting a browser view you also delete its Style, Sort and
Filter settings. For more information, see Delete a View, page 294.
Find a Browser or Browser View

This option shows you how to find a browser or browser view in the Browser
Manager. For more information, see Find a Browser or Browser View, page 295.
Related Topics
Select a Default Browser

1. Open the Browser Manager and expand the required browser group to display its
browsers.
2. Highlight the required browser view, and click Edit.
3. Select the Set as default view check box.
4. Right-click the browser which you want to set as default and then, on the shortcut
menu, click Set As Default.
Important
• The default browser that you select must have a default view. For details,
see Add a New View, page 290
Related Topics

Define a View Profile

1. Open the Browser Manager and expand the required browser group to display its
browsers.
2. Select the browser to which you want to add a view and do one of the following:
• Click Actions > Add View.
• Right-click the highlighted browser and then, on the shortcut menu,
click Add View.
• Click .
3. In the View Name field, type the name of the new browser view that you are
creating.
4. In the View Description field, type a brief description of the new browser view.
5. From the Display data at level list, to set the level on which to display the data in
the Browser View window. You can select any of the hierarchy levels that you
defined for the domain , for example, <Plant> , <Area>, <Unit>, or the level of
the domain itself.
Tips
• For an Instrument Index Standard Browser or Tag Number Browser,
you can also select Typical to create a browser view profile with only
typical tag and typical loop data.
• For an Instrument Type browser, you can create a browser view profile
on the domain level only.
6. Select the Set as default check box to make the current view the default view for
the browser to which this view belongs. This way, all the settings defined for this
view will be used to display the data in all the views belonging to the current
browser.
Tip
• Selecting this option allows you to switch between plants in a given
domain and define a default browser view for another plant, while
retaining the default browser views that were previously defined for
plants in the current domain. By not selecting the Set as default view
check box, your default browser view is not retained when defining a
new default browser view in a different plant.
7. Select the Count per group check box to display in the print preview and the
printed view, the total number of rows contained in each group, delimited by the
group separator in the print preview.
8. Select the Personal view check box to make this view available to the current
user only. Other users will not be able to see this view under Browser Groups
and therefore will not be able to open it.
9. Click Save.

10. Define the style settings you require. For more details, see Style Settings: An
Overview, page 308.
11. Define the sort settings you require. For more details, see Sort Settings: An
Overview, page 321.
12. Define the filter settings you require. For more details, see View Filter Settings:
An Overview, page 328.
13. Select another browser to define a View profile, or close the Browser Manager.
Related Topics
• Create a Sorting Sequence View, page 323
Add a New View

1. Start the Browser Manager by doing one of the following:
• Click File > Browser Manager.
• Click .
2. If the Browser View is open, then open the Browser Manager by doing one of
the following:
• Click Actions > Manager.
• Click .
3. In the Browser Manager, highlight the required browser in the Browser Groups
data window. For more information on how the browsers are organized, see
Browser Manager Hierarchy, page 296.
4. Define a view profile for the new browser view. For more information, see
Define a View Profile, page 289.
5. Define the style settings. For more details, see Create a View Style, page 311
6. Set a sorting sequence. For more details, see Create a Sorting Sequence View,
page 323
7. Define a filtering condition if needed. For more details, see Define a View Filter,
page 331
8. Click to open the new browser view.
Related Topics
• Select a Default Browser, page 288
• Working with Instrument Types: An Overview, page 374

Duplicate a View
• Click .
the following:
• Click .
3. In the Browser Manager, highlight the required browser in the Browser groups
• To duplicate all the view settings, highlight the view that you want to
duplicate.
• To duplicate only a selected view setting, expand the view and select
the Style, Sort or Filter icon as required.
• Click .
• Click Actions > Copy.
• Right-click the view you want to copy and then, on the shortcut menu,
click Copy.
6. Select the target browser and do one of the following:
• Click .
• Click Actions > Paste.
• Right-click the target browser and then, on the shortcut menu, click
Paste.
Notes
• You can duplicate the view with all its settings or only with the setting
(view, sort, or filter) that you select.
• You can duplicate browser views only if they belong to the same browser.
• If you close the Browser Manager, the item you copied will be lost.
Related Topics

Copy a View to Another Plant

1. On the Browser Manager, select a view that you want to copy to another plant.
• Right-click and from the shortcut menu select Copy to Other Plant.
• Click Actions > Copy to Other Plants.
3. On the Copy View Settings dialog box, select a plant, and then click Copy.
Note
• If the same view name already exists in the target plant browser, the
software does not overwrite the settings of the target view, but creates
another view with the same name.
Related Topics
Modify a View Profile

• Click .
the following:
• Click .
4. Click Edit.

5. Modify the current view profile settings, by doing any of the following:
• In the View name field — modify the name of the browser view.
• In the View description field — add or change a brief description of
the browser view.
• From the Display data at level list — change the level on which to
display the data in the Browser View window.
• In the Set as default check box — select to make the current view
the default view for the browser, or unselect the check box so the
current view is not the default view for the browser.
• In the Count per group check box — select to display in the print
preview and the printed view, the total number of rows contained in
each group delimited by the group separator in the print preview, or
unselect the check box so this option will not work.
• In the Select the Personal view check box — select to make this
view available to the current user only, or unselect the check box so
this option will not work.
6. Click Save, to save the view profile with the settings you have just entered.
Related Topics

Delete a View
• Click .
the following:
• Click .
4. In the Browser groups data window, highlight the view you want to delete.
• Click
• Click Actions > Delete.
• Right-click and on the shortcut menu select Delete.
Related Topics

Find a Browser or Browser View

1. In the Browser Manager, do one of the following:
• Click .
• On the menu bar, click Actions > Find.
2. Select the Browser or View option button, depending on what you want to find.
3. In the data field, type the value that you want to find.
4. To match the retrieved values with the value you are searching for, do one of the
following:
• Select Whole Value to find only occurrences that are whole words
(this is the default selection).
• Select String to find occurrences that are either whole words or part of
a word.
5. Click Find.
Tips
• During the search, the Find button changes to Stop, allowing you to
stop the search, if required.
• When an appropriate occurrence is found, the corresponding row is
automatically selected.
6. Click Find to find the next occurrence.
7. Click Close when finished.
Related Topics

Browser Manager Hierarchy

You define the viewing settings for a specific browser hierarchy level as shown
below (the following example is the hierarchy which is displayed in the Browser
Manager Browser Groups data window).
The Browser Group hierarchy is as follows:
First Level — Browser Group

Second Level — Browser
Third Level — View
Fourth Level — View settings
• Browser Group — The first level of the hierarchy stands for a Browser
Group which represents a module or an item (for example, Control
System). Each group can contain one or more predefined Browsers.
• Browser — Each browser is associated with the relevant module data
(for example, Loop and Equipment in the Instrument Index) or item whose
data it displays. A Browser contains one or more viewing templates or
Views that you can select and modify to customize the way the
corresponding data will be displayed in the Browser View window. Note
that you cannot add or delete any browser group or browser, nor can you
change their names. You can only delete a custom browser.
• View — Each view contains the following viewing settings that will be
used to display the data with which that view is associated: the viewing
style, sorting order, and filtering condition. You can add, delete,
modify, and duplicate the view profile to customize the way the data will
be displayed in the Browser View window.
Related Topics
• Add a New View, page 290
• Delete a View, page 294
• Display the Current Sorting Sequence, page 323
• Display the Current Style Setting, page 310
• Duplicate a View, page 291
• Modify a View Profile, page 292

Browser Types
For more information on the different browser types, see:
• Instrument Index Browser Group, page 297

• Process Data and Calculation Browser Group, page 299
• Instrument Specifications Browser Group, page 300
• Wiring Browser Group, page 301
• Hook-Ups Browser Group, page 302
• Loop Drawings Browser Group, page 302
• Control System Browser Group, page 303
• Dimensional Data Browser Group, page 304
• Construction and Commissioning Browser Group, page 304
• Document Binder Browser Group, page 305
• Documents Browser Group, page 306
• General Browser Group, page 306
• Telecom Browser Group, page 307
Related Topics
Instrument Index Browser Group

The following table lists all the available browsers, and their descriptions, within the
Instrument Index Browser Group.
Browser Description
Calibration Results Displays instruments and their attributes that include instrument
Browser calibration results. After filtering the fields, create a calibration
result analysis for a certain period, an instrument calibration list,
and so forth.
Calibration Settings Displays calibration settings (ranges, set points, alarm points,
Browser and so forth) for a selected instruments.
Circuit Related Displays data for tag numbers derived from SmartPlant
Electrical Tag Electrical signals for circuits. If a circuit relates to more than
Browser one electrical item, a separate data row appears for each item.
DDP and Index Displays instruments and their associated dimensional data for
Browser piping.

Browser Description
Drawing Summary Allows you to generate a drawing list for selected instruments.
Browser A drawing list may include specifications, process data sheets,
loop and hook-up drawings.
Electrical Power Displays electrical properties owned by SmartPlant
Element Browser Instrumentation and SmartPlant Electrical for instruments and
cabinets.
Electrical Tag Displays data for all tag numbers derived from SmartPlant
Browser Electrical signals for all items but does not retrieve data values
of associated attributes for signals created under circuits. The
software displays data for the main item and also associated
circuit data.
Equipment Browser Process equipment list for the current plant, area, or unit.
Fieldbus Tag Displays fieldbus instruments and their associated segments.
Number List You can create browser views to be used in the Fieldbus Tag
Browser Numbers browser to associate tags with segments.
Function Displays existing function requirement tag numbers and their
Requirement properties. The browser allows you to view and edit the data.
Browser
Instrument Allows you to pre-assign specific panels to selected device
Connection Pre- panels. This pre-assignment facilitates faster and more efficient
assignment Browser wiring design. The purpose of this pre-assignment is to enable
you to define an AutoWiring task for the pre-assigned panels as
well as providing a criterion by which to filter the cables so that
only pre-assigned device cables are displayed for connection
with panels.
Instrument In addition to the options available for the Instrument
Connection Pre- Connection Pre-assignment Browser, you can also display the
assignment Control System Tag data in the browser view.
(Advanced)
Browser
Instrument Index Allows you to display and edit tag numbers from the Instrument
Standard Browser Index module.
Instrument Type Displays a list of instrument types and their default profiles.
Browser This browser is especially useful when you need to define a
default profile for numerous instrument types at the start of a
project design.
JB – Index Displays existing field devices and their connections to junction
Browser boxes and terminals. Note that you can view only those field
devices that are connected to the junction box whose wiring is
continued from the other side of the terminal.

Browser Description
Line Browser Lists existing lines and their properties (except for process data),
and allows you to edit the properties.
Loop Browser Lists existing loop numbers and their properties, and allows you
to edit the properties. This browser does not show associated tag
numbers.
Maintenance Lists existing instruments for which work requests or repair
Schedule Browser forms have been issued. Also, displays the instruments for
which preventive maintenance has been scheduled.
Range Browser Displays the following range values: calibration range, process
data range, alarm and trip settings.
Tag Category Displays existing instrument tag numbers that have been
Browser associated with a tag category.
Tag Number Lists existing instrument tag numbers and their properties, and
Browser allows you to edit the properties.
Related Topics
Process Data and Calculation Browser Group

Process Data and Calculation Browser Group.
Browser Description
Analyzer Browser Lists the existing analyzers, and allows you to edit the associated
data. You can also include custom fields.
Control Valve Lists the existing control valves for process and calculation data,
Browser and allows you to edit the control valve properties. You can also
include custom fields.
Flow Instrument Lists the existing flow instruments for process and calculation
Browser data, and allows you to edit the flow instrument properties. You
can also include custom fields.
General Process Lists all the General Process Data field records, tag number
Browser custom field data, as well as specification and process data
custom field information.
Level Instrument Lists the existing level instruments for process data, and allows
Browser you to edit the level instrument properties. You can also include
custom fields.

Browser Description
Line Component Lists existing line measuring components for analyzers and
Browser allows you to edit the components.
Line Process Data Lists the line data for process data and calculation, and allows
Browser you to edit the line data. You can also include line custom field
data.
Pressure Lists the existing pressure instruments for process data, and
Instrument allows you to edit the pressure instrument properties. You can
Browser also include custom fields.
Relief Valve Lists the existing relief valves for process data and calculation,
Browser and allows you to edit the relief valve properties. You can also
include custom fields.
Temperature Lists the existing temperature instruments for process data and
Instrument calculation, and allows you to edit the temperature instrument
Browser properties. You can also include custom fields.
Related Topics
Instrument Specifications Browser Group

Browser Description
Specifications Lists specifications and allows you to edit them. You can also
Browser include drawing custom field data.
Related Topics

Wiring Browser Group

Wiring Browser Group.
Browser Description
Auto-Wiring Routing Allows you to define and execute auto-wiring tasks for
Task Browser selected junction boxes and control system panels.
Cable Browser Lists all the available cables and their attributes.
Cable Set Browser Displays all the cable sets in the existing cables and allows you
to edit the cable sets. Only the cable set data can be edited.
Device Panel Displays field devices and their connections.
Browser
General Panel Displays existing panel data and allows you to edit the data.
Browser
I/O Card Browser Displays I/O card data and allows you to edit the data. This
browser also includes I/O card custom fields.
I/O Terminal Displays I/O terminal data and allows you to edit the data. You
Browser can also view the panels and I/O cards to which the terminals
belong.
Local Signal Browser Displays the existing local signals.
Rack Browser Displays the existing hardware racks and allows you to edit
them.
Slot Browser Displays existing slot data and allows you to edit the data.
Strip Browser Displays all the existing terminals and allows you to edit them.
You can also view the appropriate strips and panels.
Telecom Channel Displays channel data for telecom objects and allows you to
Data Browser edit the data.
Terminal Browser Displays the existing terminals and allows you to edit them.
Terminal Connection Displays terminal connection data. The data includes the
Browser connection on both sides of the terminals.
Wire Browser Displays wire data and also displays the cable sets and cables
to which the wires belong. You can edit the wire data as you
require.
Wire Connection Displays wire connection data. The data includes the
Browser connection on both sides of the wires.
Wiring Equipment Displays existing wiring equipment data and allows you to edit
Browser the data.

Hook-Ups Browser Group

Hook-Ups Browser Group.
Browser Description
Hook-Up Display and edit the existing hook-up types, and the associated
Browser hook-ups.
Item List Lists all the items from the Hook-Up Library.
Browser
Related Topics
Loop Drawings Browser Group

Loop Drawings Browser Group.
Browser Description
Block Browser Displays all the existing blocks and allows you to edit them.
Display the loop and tag numbers to which the blocks belong.
Enhanced Report Displays all loop numbers that are assigned to Enhanced Report
Utility Browser Utility drawing layouts. You can reassign loop numbers to any
available layout.
Loop Browser Displays all the existing loop drawings with their revisions and
generation types.
Related Topics

Control System Browser Group

Control System Browser Group.
Browser Description
NIM General Browser Displays all the tag numbers that have been assigned to
channels and associate these tags with appropriate point
types. This browser uses Honeywell-specific terminology.
Control System Tag Display all the tag numbers that have been assigned to
Browser channels and enter custom information for the displayed
tags.
Delta V Conventional Displays all the conventional tag numbers available for
Tag Browser publishing to Delta V.
Delta V Fieldbus Tag Displays all the fieldbus tag numbers available for
Browser publishing to Delta V.
NIM Analog Input Displays all the tag numbers with the point type defined as
Browser NIM Analog Input. You can also set the control system tag
parameters. This browser uses Honeywell-specific
terminology.
NIM Analog Output Displays all the tag numbers with the point type defined as
Browser NIM Analog Output. You can also set the control system
tag parameters. This browser uses Honeywell-specific
terminology.
NIM Digital Input Displays all the tag numbers with the point type defined as
Browser NIM Digital Input. You can also set the control system tag
parameters. This browser uses Honeywell-specific
terminology.
NIM Digital Output Displays all the tag numbers with the point type defined as
Browser NIM Digital Output. You can also set the control system
tag parameters. This browser uses Honeywell-specific
terminology.
Publish Yokogawa CST Displays Yokogawa conventional control system tags
(Conventional) Browser intended for publishing.
Publish Yokogawa CST Displays Yokogawa fieldbus control system tags intended
(FF) Browser for publishing.
Important
• The DeltaV and Yokogawa browsers are intended specifically for viewing
the DCS data as described, and you should not make any customizations
to these browsers using InfoMaker.

Dimensional Data Browser Group

Dimensional Data Browser Group.
Browser Description
Default Data Displays default dimensional data for piping and allows you to
Browser edit the data.
Vendor Data Displays vendor dimensional data for piping and allows you to
Working Data Displays working dimensional data for piping and allows you to
Related Topics
Construction and Commissioning Browser Group

Construction and Commissioning Browser Group.
Browser Description
Cable Schedule Installation Lists all the cables for the current unit or plant where you
Index Browser can change the Electrical Installation Index, edit cable
descriptions, and so forth.
Cable Schedule Installation Lists all the plant or unit cables, their attributes,
Index Changes Browser installation index status and version.
Instrument Installation Allows you to generate an electrical, instrument, and
Index Browser mechanical installation report that includes the
appropriate drawing references.
Instrument Installation Displays electrical, instrument, and mechanical
Index Changes Browser installation changes that include the installation status
and version.
Panel Termination Displays the plant or unit device panels and their
Installation Index Browser electrical index.
Panel Termination Displays the plant or unit device panels with their
Installation Index Changes electrical installation index and installation changes.
Browser
Terminal Schedule Displays the plant or unit termination schedule and the
Installation Index Browser appropriate installation indexes.

Browser Description
Terminal Schedule Shows the plant or unit termination schedule and the
Installation Index Changes installation index changes.
Browser
Wiring Schedule Displays the plant or unit cable, cable set, and wire
Installation Index Browser connections and their appropriate installation indexes.
Wiring Schedule Displays the plant or unit cable, cable set, and wire
Installation Index Changes connections and their installation index changes.
Browser
Related Topics
Document Binder Browser Group
Browser Description
Spec Binder Allows you to generate a browser that includes tag numbers
Package belonging to a Specification Binder package, tag number attributes,
Browser package item number, and specification data.
Related Topics

Documents Browser Group

Documents Browser Group.
Browser Description
Archive Allows you to generate a document list of all archived documents
Browser associated with the report names that you selected in the Admin module
for archiving, and then view and compare archived reports.
Drawing Allows you to generate a document list that shows the document name,
Browser type (P&ID, process data, calculation, specification, loop, or hook-up
drawing), and custom field data.
Revision Allows you to generate a document revision browser that includes all
Browser drawings in the plant hierarchy and all their revisions.
Changes Log These browsers allow you to generate reports that show when changes
Browsers were made to the item type. You can generate reports for Cables,
Control System Tags, Equipment, Instruments, Lines, Loops, Panels,
and Wiring Equipment.
Related Topics
General Browser Group

General Browser Group.
Browser Description
Changes Log Displays changes to property values for items at the selected plant
Browser hierarchy level. This browser is only visible when the System
Administrator selects the Item registry check box for the domain.
Task Displays tasks available in the To Do List (that is, tasks generated after
Browser you retrieve documents.
Related Topics

Telecom Browser Group

Process Data and Calculation Browser Group.
Browser Description
End Point Amplifier Displays existing end point amplifier data and allows you
Browser to edit the data.
End Point Hub Browser Displays existing end point hub data and allows you to
edit the data.
End Point Intercom Displays existing end point intercom data and allows you
Browser to edit the data.
End Point Miscellaneous Displays existing end point miscellaneous equipment data
Browser and allows you to edit the data.
End Point PABX Browser Displays existing end point PABX data and allows you to
edit the data.
Hub Cabinet Browser Displays existing hub cabinet data and allows you to edit
the data.
Hub Equipment Browser Displays existing hub equipment data and allows you to
edit the data.
Intercom Cabinet Browser Displays existing intercom cabinet data and allows you to
edit the data.
Intercom Equipment Displays existing end point intercom equipment data and
Browser allows you to edit the data.
Miscellaneous Cabinet Displays existing miscellaneous cabinet data and allows
Browser you to edit the data.
Miscellaneous Equipment Displays existing miscellaneous equipment data and
Browser allows you to edit the data.
PA Cabinet Browser Displays existing PA cabinet data and allows you to edit
the data.
PABX Cabinet Browser Displays existing PABX cabinet data and allows you to
edit the data.
Port-Data Browser Displays existing port data and allows you to edit the data.
Related Topics

Style Settings: An Overview

You define style settings as part of the browser view customization. Style options
allow you to display or define the style settings for a browser view that you select in
the Browser groups pane. SmartPlant Instrumentation then uses these style settings
to display your data associated with the current browser.
Style settings include the following options:
• Determining which fields the software displays in the Browser View

window.
• Setting the order and width of the selected fields and determining how
they appear in the Browser View window.
• Customizing the layout of a browser view for printing.
• Printing out the style setting data.
Related Topics
• Style Settings Common Tasks, page 309

Style Settings Common Tasks

The following tasks are used frequently when customizing browser views in
Display the Current Style Setting

This option shows you how to display the current style settings of the browser view
that you select from the Browser groups list in the Browser Manager. If you have
not yet defined a view profile for a selected browser, no style settings are available.
For more information, see Display the Current Style Setting, page 310.
Create a View Style

You use this option to create new style settings for a selected browser view. For
more information, see Create a View Style, page 311.
Modify Style Settings

This option enables you to modify existing style settings for a selected browser view.
For more information, see Modify Style Settings, page 314.
Structure the Print Layout

This option shows you how to structure the print layout of the data when printing out
the data displayed in a customized Browser View window. You can select the fields
that you want to be displayed in the print preview and the printout as well as do the
following:
• Sequence the columns.

• Set the column width.
• Define the number of fields per column: a single field per column or
multiple (no more than five) fields per column.
• Set the text and header font size.
• Set the header height.
For more information, see Structure the Print Layout, page 316.
Clear a Print Layout Structure

This option shows you how to clear the existing print preview layout structure
defined for the current browser view without clearing all the style settings for this
browser view. For more information, see Clear a Print Layout Structure, page 318.
Duplicate a View Style

This option shows you how to copy view style settings to another existing browser
view. Note that this action overwrites the target style settings with the duplicated
style settings. For more information, see Duplicate a View Style, page 319.

Clear a View Setting

Use this option to clear all the style settings for a selected browser view. For more
information, see Clear a View Setting, page 313.
Print the Style Setting Data

Use this option to print out all the data that appears in the Style settings data window.
You can print out the data for all the fields or just for the ones you have selected to
view. For more information, see Print the Style Setting Data, page 320.
Related Topics
Display the Current Style Setting

• Click .
the following:
• Click .
data pane. For more information on how the browsers are organized, see Browser
Manager Hierarchy, page 296.
4. Expand the required browser view in the Browser Groups data window and do
• In the Browser Groups data window, click .
• In the upper-right data window, double-click .
The fields currently used in the selected style are listed in Style field list pane, to
the right of the Browser groups pane. The current style settings of the selected
view are displayed in the lower pane.
Related Topics

Create a View Style

• Click .
the following:
• Click .
3. In the Browser Manager, add a new view profile or edit an existing one.
• In the Browser groups data window, click .
• In the upper-right data window, double-click .
5. On the lower Style pane, click Edit.
6. In the Name data field, type the new style name (defaults to Style followed by a
number).
7. Select the Enable in explorer windows check box to make the current browser
view available in the Domain Explorer, Reference Explorer, and all the other
explorer windows in SmartPlant Instrumentation. After selecting this check box
and saving the style settings, the current browser view becomes available in the
Show Browser dialog box that you open from an explorer window.
8. Do one of the following to select the fields to be displayed in the browser view:
• Select the appropriate View check boxes, by scrolling down the Style
settings data window and selecting the required fields individually.
Note that the primary value field is always selected, and a check mark
appears in its View check box by default.
• Select the All check box in the Select group box, to select all the
available fields.
• Select the Custom check box in the Select group box to select all the
custom fields.
• Select the Non-custom check box in the Select group box to select all
the fields that are not custom fields.

9. Click the Data Field Header box to customize the header.

Tips
• Data field headers that you customize appear in the browser view
column headers when using the current style to view the data. You
can customize any data field header.
• In addition to the database fields provided to you by default, the
Browser Manager also provides you with custom fields, which you
can use to complement data attributes. A user with Domain
Administrator rights can make default custom field definitions in the
Administration module.
• It is not possible to display an apostrophe in a custom field header. If
your definition includes an apostrophe character, this character
changes in the header to a double quote character ". If your definition
includes a double quite character, it changes in the header to a tilde
character ~. Other special characters appear in custom field header as
defined.
10. Click in the Length data field to edit the field's maximum number of characters
displayed in the Browser View when using the current style to view the data.
11. If you want to display in the Browser View print preview or print out the sum or
average value of any numeric field, select its Sum and/or Avg. check box. For
non-numeric fields, the Sum and Avg. check boxes are disabled.
12. To set the sorting options, do one of the following:
• Click on any header (Data Field header, Table Column Name,
Length, View, Sum, or Avg.) to sort the fields that appear in the Style
settings section in an ascending order (click again on the same header
to sort the displayed fields in a descending order.)
• Select the Default Sort check box when available to revert to the
default sorting order (the way the fields are arranged in the database).
The Default Sort option is available only if you changed the sort order
by clicking on any header in the Style settings screen section.
13. To set the width and sequence of the selected fields, do the following:
a. Click Customize to open the Column Layout dialog box.
b. To change the field sequence, drag the header of the field that you want to
move to the left or to the right, then release the mouse button to drop the
column in the new location.
c. To resize the column width, point to the right or left edge of the column you
want to resize so that the mouse pointer changes its shape to a double-headed
arrow. Drag the column edge either to the left or to the right until the column
matches the required width.

14. Click OK to close the Column Layout dialog box and save the changes that you
made to the column layout field and the style settings.
Tip
• Clicking OK in the Column Layout dialog box saves the new
column layout field and the changes you made to the style settings in
the Browser Manager. Therefore, when you return to the Browser
Manager the Save button automatically changes to Edit. Clicking
Cancel returns you to the Style settings to continue creating your view
style.
15. If changes have been made that have not been saved, the Save button will be
visible, click Save to save your new style settings.
Note
• In the Style settings data window, red is used to symbolize a selected
field. Yellow is used to symbolize a read-only field which cannot be
accessed in the browser for data editing. You can set a different color for
the read-only fields.
Related Topics
Clear a View Setting

• Click .
the following:
• Click .
3. In the Browser Manager, display the style settings you want to modify. For
more information, see Display the Current Style Setting, page 310.
4. Click Edit.
• Click .

Modify Style Settings

• Click .
the following:
• Click .
3. In the Browser Manager display the style settings you want to modify.
4. On the lower Style pane, click Edit.
5. In the Name field, type the new style name (defaults to Style followed by a
number).
6. Do one of the following to select the fields to be displayed in the browser view:
• Select the appropriate View check boxes, by scrolling down the Style
settings data window and selecting the required fields individually.
Note that the primary value field is always selected, and a check mark
appears in its View check box by default.
• Select the All check box in the Select group box, to select all the
available fields.
• Select the Custom check box in the Select group box to select all the
custom fields.
• Select the Non-custom check box in the Select group box to select all
the fields that are not custom fields.

7. Click the Data Field Header box to customize the header name.
Tips
• Data Field Headers that you customize appear in the browser view
column headers when using the current style to view the data. You
can customize any Data Field Header.
• In addition to the database fields provided to you by default, the
Browser Manager also provides you with custom fields, which you
can use to complement data attributes. A user with Domain
Administrator rights can make default custom field definitions in the
• It is not possible to display an apostrophe in a custom field header. If
your definition includes an apostrophe character, this character
changes in the header to a double quote character ". If your definition
includes a double quite character, it changes in the header to a tilde
character ~. Other special characters appear in custom field header as
defined.
8. Click in the Length data field to edit the field's maximum number of characters
displayed in the Browser View when using the current style to view the data.
9. If you want to display in the Browser View print preview or print out the sum or
average value of any numeric field, select its Sum and/or Avg. check box. For
non-numeric fields, the Sum and Avg. check boxes are disabled.
10. To set the sorting options, do one of the following:
• Click on any header (Data Field Header, Table Column Name,
Length, View, Sum, or Avg.) to sort the fields that appear in the Style
settings section in an ascending order (click again on the same header
to sort the displayed fields in a descending order.)
• Select the Default Sort check box when available to revert to the
default sorting order (the way the fields are arranged in the database).
The Default Sort option is available only if you changed the sort order
by clicking on any header in the Style settings screen section.
11. To set the width and sequence of the selected fields, do the following:
a. Click Customize to open the Column Layout dialog box.
b. To change the field sequence, drag the header of the field that you want to
move to the left or to the right, then release the mouse button to drop the
column in the new location.
c. To resize the column width, point to the right or left edge of the column you
want to resize so that the mouse pointer changes its shape to a double-headed
arrow. Drag the column edge either to the left or to the right until the column
matches the required width.

12. Click OK to close the Column Layout dialog box and save the changes that you
made to the field layout and the style settings.
Tip
• Clicking OK in the Column Layout dialog box saves the new field
layout and the changes you made to the style settings in the Browser
Manager . Therefore, when you return to the Browser Manager the
Save button automatically changes to Edit. Clicking Cancel returns
you to the Style settings to continue creating your view style.
13. If changes have been made that have not been saved, the Save button will be
visible, click Save to save your new style settings.
Note
• In the Style settings data window, red is used to symbolize a selected
field. Yellow is used to symbolize a read-only field which cannot be
accessed in the browser for data editing. You can set a different color
for the read-only fields.
Related Topics
Structure the Print Layout

• Click .
the following:
• Click .
3. In the Browser Manager display the style settings you want to modify.
4. Click Edit.
5. Click Layout to open the Define Print Layout dialog box.
6. Select a field from the Column Header pop-up window and drag it to the field
where you want it to appear. Your print layout can take the form of single fields
in each column or multiple (no more than 5) fields in a column. Remember that
the fields that you do not select from the Column Header pop-up window will
not show up in the printout even though they exist in the current browser. Note,
however, that if you decide to display two or more fields in a column, the printed
out report will not display the Group Row Count, nor will it show the sum
and/or average field values even if you have selected these options.

7. Click Font to open the Customize Font Size dialog box, where you can
customize the column and header font size as well as the column and header
height.
8. Set the font sizes as required using the spinners:
a. Use the Column Font Size spinner to define the font size.
b. Use the Column Height spinner to define the column height. Note that if you
do not define the column height before generating the layout, the Define Print
Layout dialog box does not display any data.
c. Use the Header Font Size spinner to define the header font size.
d. Use the Header Height spinner to define header height size.
9. Click OK to accept your settings and return to the Define Print Layout dialog
box.
10. Click Generate to open the Generate Print Layout dialog box where you
customize the column sequence and size.
11. Set the layout structure as follows:
a. Set the column sequence by dragging the column header to the required
position.
b. Set the column size by dragging the edge of the column either to left or to the
right.
c. Click OK to accept the settings and return to the Define Print Layout dialog
box.
12. Click Save to save all the settings and close to the Define Print Layout dialog
box.
Related Topics

Clear a Print Layout Structure

• Click .
the following:
• Click .
4. Click Edit.
5. Click Print Layout.
6. In the Print Layout dialog box, click Clear.
7. Click Save.
Related Topics

Duplicate a View Style

• Click .
the following:
• Click .
4. Select the style that you want to duplicate.
• Click .
• Right-click the highlighted style in the Browser groups data window
and then, on the shortcut menu, click Copy.
6. Navigate to the target style whose settings you want to replace with ones you
copied.
7. Highlight the selected target style.
Important
• If you close the Browser Manager at this stage, you cannot paste the
duplicated style settings.
• Click .
• Right-click and on the shortcut menu, click Copy.
Related Topics

Print the Style Setting Data

• Click .
the following:
• Click .
3. Click Print to open the Print Preview window.
4. In the Show Fields group box, do one of the following:
• Select All to display and print out all the data for all the fields
appearing in the Style settings screen section.
• Select Selected to display and print out the data for only those fields
that you selected to be viewed.
5. Perform any of the following actions as required:
• Click Zoom to select your preview magnification level.
• Click Save As to save the data as an external file.
• Click Print to start printing.
Related Topics

Sort Settings: An Overview

A browser view sorting sequence determines the sequence in which the selected rows
are displayed in the Browser View window. In addition to defining a sorting
sequence for the Browser View window, you also determine whether the displayed
rows will be sorted in an ascending or descending order. Note that you will also be
able to sort the selected fields in the Browser View window that will override your
sort sequence settings. You can perform the following activities:
• Create and modify a view sorting sequence.

• Duplicate a view sorting sequence.
• Clear the existing view sorting sequence settings.
Related Topics
• Sort Settings Common Tasks, page 322

Sort Settings Common Tasks

The following tasks are used frequently when you define the sorting sequence for
your browser view.
Display the Current Sorting Sequence

This option shows you how to display the current sorting sequence for an existing
browser view that you select from the Browser Groups list in the Browser
Manager. Note that if you have not yet defined a view profile for a selected browser,
no sorting sequence will be available. For more information, see Display the Current
Sorting Sequence, page 323.
Create a Sorting Sequence View

This option shows you how to create a new sorting sequence for a selected browser
view. For more information, see Create a Sorting Sequence View, page 323.
Modify a Sorting Sequence View

This option shows you how to modify an existing view sorting sequence. For more
information, see Modify a Sorting Sequence View, page 325.
Duplicate a Sorting Sequence View

This procedure shows you how to copy an existing sorting sequence to another
existing browser view. This action overwrites the target sorting sequence with the
duplicated style settings. For more information, see Duplicate a Sorting Sequence
View, page 326.
Clear a Sorting Sequence Setting

This option shows you how to remove an existing sorting sequence. For more
information, see Clear a Sorting Sequence Setting, page 327.
Related Topics

Display the Current Sorting Sequence

• Click .
the following:
• Click .
3. In the Browser Manager, expand the required browser group, to navigate to the
browser view in the Browser groups data pane. For more information on how
the browsers are organized, see Browser Manager Hierarchy, page 296.
4. Expand the required browser view in the Browser groups data pane and do one
of the following:
• In the Browser groups data pane, click .

• In the upper-right data pane, double-click .
Note
• The fields currently selected for the sorting sequence are listed in the right
data pane (with the caption Sort field list) and the current sorting
sequence of the selected view is displayed in the lower data pane. You
can now modify the sorting sequence as needed.
Related Topics
Create a Sorting Sequence View

• Click .
the following:
• Click .
3. In the Browser Manager, add a new view profile or edit an existing one. For
more details, see Define a View Profile, page 289.

of the following:

5. Click Edit.
6. In the Name box, type the required sorting sequence name (defaults to Sort
followed by a number).
7. Under Data Field Header, from the list of database fields, select a sort field
according to which you want the data to be sorted in the browser view.
Tips
• For any browser view that supports sorting data by tag numbers, you
can sort tag numbers according to the numeric segment. From the
Data Field Header list, select Tag Trans Name, and define the sort
sequence in the Start Char and Length fields.
• For any browser view that supports sorting data by loop numbers, you
can sort loop numbers according to the numeric segment. From the
Data Field header list, select Loop Trans Name, and define the sort
sequence in the Start Char and Length fields.
8. In the Start Char. data field, type the starting position of the current segment,
i.e., the selected sorting field leftmost character.
9. In the Length data field, type the total number of characters (from the starting
character) the selected sorting field will contain.
10. Under Order, clear the Ascending check boxes if you want the data to be sorted
and displayed in the Browser in a descending order. The default setting is
Ascending.
11. Click Insert to insert a sorting field before the one currently selected in the Sort
settings group box.
12. Click Delete to remove the currently selected field from the sorting sequence.
13. To resize and re-sequence the fields currently displayed in the Sort settings group
box, do the following:
a. Drag and drop a field to a new position to change the field sequence.
b. To change the width of a field, position the cursor on the border between two
fields and then drag the order to the right or to the left.
14. Click Save to save the new sorting sequence. The Sort Field List data window
displays the sorting sequence you have created.
Related Topics

Modify a Sorting Sequence View

• Click .
the following:
• Click .
of the following:

4. Click Edit.
5. In the Name box, type the required sorting sequence name (defaults to Sort
6. Under Data Field Header, from the list of database fields, select a sort field
according to which you want the data to be sorted in the browser view.
7. In the Start Char. data field, type the starting position of the current segment,
i.e., the selected sorting field leftmost character.
8. In the Length data field, type the total number of characters (from the starting
character) the selected sorting field will contain.
9. Under Order, clear the Ascending check boxes if you want the data to be sorted
and displayed in the Browser in a descending order. The default setting is
Ascending.
10. Click Insert to insert a sorting field before the one currently selected in the Sort
settings group box.
11. Click Delete to remove the currently selected field from the sorting sequence.
12. To resize and re-sequence the fields currently displayed in the Sort settings group
box, do the following:
a. Drag and drop a field to a new position to change the field sequence.
b. To change the width of a field, position the cursor on the border between two
fields and then drag the order to the right or to the left.
13. Click Save to save the modified sorting sequence. The Sort Field List data
window displays the sorting sequence you have created.
Related Topics

Duplicate a Sorting Sequence View

• Click .
the following:
• Click .
3. Expand the Browser groups tree to display the sort sequence you want to
duplicate.
4. Highlight the sorting sequence, and do one of the following:
• Click .
5. Navigate to the target sorting sequence whose setting you want to replace with the
copied settings.
6. Highlight the sorting sequence, and do one of the following:
• Click .
Related Topics

Clear a Sorting Sequence Setting

• Click .
the following:
• Click .
of the following:

4. Click Edit.
• Click .
Related Topics

View Filter Settings: An Overview

These settings allow you to define a filtering condition which will be used to filter the
data associated with the selected browser view.
A filter consists of:
• Field Name.
• Operator or function.
• Value.
• Logical expressions: And -or- Or (for complex filter conditions).
Important
• A complex filter condition may take longer to retrieve your data. For this
reason, performing an ÒR' operation is more time-consuming than
performing an ÀND' operation.
The following table lists the built-in operators and functions available to you when
defining the filter settings:
Operator/Function Description Example

= Equal to Manufacturer =
"Shell"
> Greater than Tag Number > 101
<</TD> Less than Process Function
Name < 'P'
>= Greater or equal to Velocity >= 10
<= Less than or equal to Low Alarm <= 30
<> Not equal to Loop Prefix <> AA
BETWEEN Select an alphanumeric value that is Price between 150
between the stated expression. and 250
LIKE (value) Select a similar value that is similar to Tag Number LIKE
the one in the `[value]' field. `%AA%'
You can use the following wildcard Process Function
characters: Name LIKE P__
% - any combination of characters.
_ - any single character.
IS NULL Contains an undefined value Service IS NULL
IS NOT NULL Not equal to NULL Loop Number IS
NOT NULL
AND Include the following expression in the
filter combination.

Operator/Function Description Example

OR Accept either the previous or the
following expression in the filter
expression.
Related Topics
• View Filter Settings Common Tasks, page 330

View Filter Settings Common Tasks

The following tasks are used frequently when working with filter settings in a
browser view.
Display the Current View Filter Condition

You use this option to display the current filter condition of browser view that you
select from the Browser groups list in the Browser Manager. If you have not yet
defined a filter condition for a selected browser, no filter settings will be available.
For more information, see Display the Current View Filter Condition, page 331.
Define a View Filter

This procedure shows you how to define a new filter condition for a selected browser
view. For more information, see Define a View Filter, page 331.
Modify a View Filter

This option shows you how to modify an existing filter condition for a selected
browser view. For more information, see Modify a View Filter, page 333.
Duplicate a View Filter

This option enables you to copy an existing filter condition to another existing
browser view. This action overwrites the target filter condition with the duplicated
filter condition. For more information, see Duplicate a View Filter, page 334.
Clear View Filter Settings

This option shows you how to clear the filter condition for a selected browser view.
For more information, see Clear View Filter Settings, page 335.
Related Topics

Display the Current View Filter Condition

• Click .
the following:
• Click .
of the following:
Note
• The filter condition you define is displayed in the Filter field list in the
right data pane.
Related Topics
Define a View Filter

• Click .
the following:
• Click .

of the following:
5. Click Edit.
6. In the Name data field, type the required filter condition name (defaults to Filter
7. Click the Data Field Header and select an appropriate tag number attribute
according to which you want to filter the data in the Browser View window.
Tip
• The Data Field Header list contains all the fields that are used for the
data that the current browser is associated with.
8. Click the Operator data field and select a suitable operator to determine how the
tag number attribute selected from the Column Name list will relate to the
expression in the Value field. For more information on filter operators, see View
Filter Settings: An Overview, page 328.
9. In the Value data field, select or type a suitable value to determine how the tag
number attribute selected from the Column Name list are specified.
10. Depending on whether you want to add another filtering condition, in the Logical
data field, do one of the following:
• Leave the field empty if the condition is the last one in the list.
• Click the field and select either And or Or as the logical function from
the list if the condition is to be followed by another one. Select And to
include the following expression in the filter condition. Select Or to
accept either the previous or the following expression in the filter
condition.
11. Click Verify to verify the current filtering condition.
• Click Insert to append new a data line.
• Click Delete to delete the currently selected data line.
• Click Save to save the new filter settings.
Tip
• The Filter field list data pane displays the filter condition you have
just defined.
Related Topics

Modify a View Filter

• Click .
the following:
• Click .
3. Expand the browser view you want to modify in the Browser groups data pane
and do one of the following:
4. Click Edit.
5. In the Name data field, type the required filter condition name (defaults to Filter
6. Click the Data Field Header and select the field from the list.
Tip
• The Data Field Header list contains all the fields that are used for the
data that the current browser is associated with.
7. Click the Operator data field and select the required operator from the list.
8. In the Value data field, select or type a suitable value.
9. Depending on whether you want to add another filtering condition, in the Logical
data field, do one of the following:
• Leave the field empty if the condition is the last one in the list.
• Click the field and select either And or Or as the logical function from
the list if the condition is to be followed by another one.
10. Click Verify to verify the current filtering condition.
• Click Insert to append new a data line.
• Click Delete to delete the currently selected data line.
• Click Save to save the new filter settings.
Tip
• The Filter field list data pane displays the filter condition you have
just defined.

Duplicate a View Filter

• Click .
the following:
• Click .
3. Expand the browser view you want to duplicate in the Browser groups data pane
and do one of the following:
• Click .
4. Navigate to the target filter condition that you want to replace with the one you
copied.
5. Highlight the selected filter condition, and do one of the following:
• Click .
Related Topics

Clear View Filter Settings

• Click .
the following:
• Click .
3. In the Browser groups pane, expand the browser view you want to clear the
view filter settings from, and do one of the following:
• Click .
Related Topics

Adding New Browsers: An Overview

SmartPlant Instrumentation is supplied with predefined browsers for you to view and
manipulate your data. In addition you can add two kinds of browser that can be
customized extensively. These two types of browsers are added to the Browser
Manager where you can use them just like any of the other supplied browsers. The
two browsers are:
• Form Browsers — a browser for every form that you generate and save
in the Spec Data Dictionary.
• Powersoft Browsers— a browser you create as a .psr report or a .pdb file
using InfoMaker.
Related Topics
• Adding New Browsers Common Tasks, page 337

Adding New Browsers Common Tasks

The following tasks are used when you add a new Form or PowerSoft Browser in
Create a New Browser for SmartPlant Instrumentation

In addition to the shipped browsers that are available in SmartPlant Instrumentation,
you can create custom browsers using InfoMaker. Using InfoMaker to create a
custom browser gives you complete flexibility to specify any number of tables, fields,
and database views, as you require.
You can create single custom browsers as .psr files or save a group of custom
browsers in a .pbl library. Then, in the Browser module, you can import several
browsers from a library or import a single .psr file.
Notes
• You must have a connection to the SmartPlant Instrumentation database to
be able to select SmartPlant Instrumentation tables and fields.
• The procedure includes only those steps in InfoMaker that are required for
creating a new browser for SmartPlant Instrumentation.
For more information, see Create a New Browser for SmartPlant Instrumentation,
page 338.
Add a Form Browser

This procedure enables you to add form browsers to the Specifications browser
group. The basis for a form browser is a spec form with database fields you made
available using the Field Properties options of the Spec Data Dictionary. When
you generate such a form in the Specifications module, take into consideration the
following:
• Fields that you do not define in the Spec Data Dictionary are not
available for a form browser.
• A form browser displays the header text that you set in the Spec Data
Dictionary. This text can differ from the header text in the actual forms,
and in the specifications based on these forms.
• You can add one form browser for each form.
For more information, see Add a Form Browser, page 340.

Add a Powersoft Browser

This advanced shows you how to add a browser created in InfoMaker to an existing
browser group in the Browser Manager. This browser can be created in InfoMaker as
a .psr or .pbd file. For this browser to be fully compatible with the Browser module,
you must follow specific rules when creating the browser in InfoMaker.
Important
• Only proficient users who have advanced knowledge of the database
structure should attempt this advanced feature.
• You cannot perform report comparison for Powersoft browsers.
For more information, see Add a Powersoft Browser, page 340.
Related Topics

1. Click File > New.
2. On the New dialog box, on the Library tab, double-click the library icon and
create a .pbl library where you can group newly-created browsers.
3. Reopen the New dialog box and click the Object tab.
4. Select Grid for the report layout and click OK.
5. In the Grid Report Generator Wizard, select SQL Select, and then complete
the Wizard steps.
6. On the Select Tables dialog box, select the tables that you require.
7. In the Select window, do the following:
a. Select fields from the tables.
b. Select a primary key from each table.
8. Click the Return icon to open the Select Color and Border Settings dialog
box, where you can set the browser colors. After setting the browser colors, click
Next and then click Finish to display the Report preview window.
9. In the report preview window, click the Data Source icon to reopen the Select
window.


a. On the Design menu, click Convert to Syntax to convert the selected fields
from the graphic mode to the syntax mode.
b. Remove all the quotation marks (") from the displayed SQL statement.
The following example shows how the final SQL statement should appear:
SELECT component.cmpnt_name,
component.cmpnt_serv,
loop.loop_name,
loop.loop_serv, component.cmpnt_id,
loop.loop_id
FROM component,
loop
WHERE (loop.loop_id=component.loop_id )
loop
11. Return to the report preview window and do the following:

a. Set the header font style to MS Sans Serif, 8 point, Bold.
b. Protect fields that you want to reserve for internal use (do not protect the
primary keys) by the protected column attribute to 1 (one).
c. For each header name, use the following naming convention: <column
name>_t. For example, cmpnt_name_t.
d. For each field name, use the following naming convention: <column name>.
For example, cmpnt_name.
e. Delete the flag_color field, and also delete all the columns that contain
primary keys (the primary keys remain in the SQL statement).
f. On the General tab, from the Units select list, select Inches.
12. Save the report data in one of the following ways:
• Without previewing, click Save As to save the report in the specially
created .pbl library.
• Save the report as a stand-alone .psr file.
13. If you saved the report in the .pbl library, do the following:
a. Copy the .pbl file to another location, preferably to the SmartPlant
Instrumentation home folder, and then change the file extension from .pbl to
.pbd.
b. In the [CUSTOM] section of your Intools.ini file, add the following line
(including the full pathname of the .pbd file): LibraryList=XYZ.pbd.
Related Topics
• Add a Powersoft Browser, page 340

Add a Form Browser

1. Start the Browser Manager.
2. Click Browser > Form Browser, to open the Add a Form Browser dialog box.
3. Select the specification forms for which you want to add browsers to the
Specifications browser group.
4. Click Add.
Note
• You can display the Notes field in a view defined in the Specifications
browser group and modify the contents one line at a time. To ensure that
each new line will be visible in the specification itself, press Ctrl + Enter
to add a carriage return.
Related Topics
Add a Powersoft Browser

Important
• You must follow specific rules when creating a new browser in
InfoMaker. For more details, see Create a New Browser for SmartPlant
Instrumentation, page 338
1. Start the Browser Manager.
2. Click, Browser > Powersoft Browser.
3. In the Add a Powersoft Browser dialog box, click Browse next to the File Name
field.
4. In the Select a Powersoft File dialog box, do one of the following:
• Navigate to a desired .psr file.
• Navigate to a desired .pbd file and then, in the data window of the Add
a Powersoft Browser dialog box, select one or more Powersoft forms
belonging to the specified .pbd file.
Tip
• When defining settings for multiple Powersoft forms belonging to the
specified .pbd file, use the Previous and Next buttons, or click Form
List and then select a Powersoft form for which you want to define
browser settings.
5. Click OK to open the Powersoft Browser Settings dialog box.
6. In the Browser field, type the name of the target browser.

7. In the Description field, type the new browser description.

8. From the Primary table list, select the primary table for the new browser. This
list contains all the tables that you selected when creating the report in InfoMaker.
9. From the Primary value list, select the value for the primary key name of the
new browser. For example, in the COMPONENT table, the primary value is
CMPNT_NAME.
10. From the Browser group list, select a browser group to which you want to assign
the new browser.
11. From the Access right item list, select the item for the access rights definition.
For example, MODULE ACCESS – INDEX.
12. From the Default sort list, select the default sort value.
13. From the Item for enhanced reports list, select an item on which to apply the
Enhanced Report Utility macro filter.
Important
• An Enhanced Report Utility macro filter is a filter for which you
define conditions for displaying macro attributes in Enhanced Report
Utility drawings. After you select an item from this list, in the Loop
Drawings module, you can set filter conditions for Enhanced Report
Utility drawings that use this browser data. For details, see Set Filter
Conditions for Item Properties in the Enhanced Report Utility Guide,
under Using the Enhanced Report Utility, Using Filters, Set Filter
Conditions for Item Properties.
Tip
• If you want to work with the new browser in the Instrument Index
module, select the Define as browser for Instrument Index module
check box.
Related Topics

Browser Views: An Overview

A browser view is the customized presentation of your instrument index data. The
data displayed in a browser view depends on the settings you selected when creating
that view. Each browser view is associated with a particular browser that allows you
to retrieve data pertinent to the associated SmartPlant Instrumentation module. You
can create multiple browser views for the same browser to meet different
requirements. Each browser view has its own style settings, filter, and sorting
sequence. You can also select a default browser whose settings will be used to
display data in the Browser View window. Default settings take effect only when
you start the Browser module from one of the other modules.
All Browser View access rights correspond to the access rights of the appropriate
item type.
Note
• You can select a new P&ID drawing number from the P&ID list and have
this drawing number propagated to all tag numbers associated with the
current loop. After saving the settings, the new P&ID appears selected in
both the Loop Browser View window in the browser module and in the
Tag Number Properties dialog box in the Instrument Index module.
Before using this feature, make sure that in the Instrument Index module,
in the Loop Number Properties dialog box, the Apply P&ID check box
is selected.
Related Topics
• Browser Views Common Tasks, page 343

Browser Views Common Tasks

The following tasks are used frequently when working in a Browser View to change
view settings on the fly, and to edit your data.
Open a Browser View

This option shows you how to open a Browser View window. For more information,
see Open a Browser View, page 345.
Edit Data in a Browser View

This option shows you how to edit your data in a Browser View window. For more
information, see Edit Data in a Browser View, page 346.
Modify and Save a Field Layout

This procedure is used to modify and save a field layout for a browser style in the
Browser View window directly, without having to structure the print layout from the
Browser Manager. In the Browser View window, prior to saving the field layout,
you can modify the following layout settings:
• Column sequence.
• Column width.
For more information, see Modify and Save a Field Layout, page 346.
Pre-Assign Junction Boxes to Device Panels

You use this feature to pre-assign specific junction boxes to selected instruments.
This pre-assignment serves several purposes:
• Pre-assign the required junction boxes to define an Auto-Wiring routing

task.
• Connect multiple pre-assigned device cables in batch mode.
• Filter the display of cables in the Domain Explorer so that only pre-
assigned device cables for connection with junction boxes are displayed.
For details, see Pre-Assign Junction Boxes to Device Panels, page 620.
Browser View Buffer

This option shows you how to use the Browser View Buffer data window to copy
data from one row and update multiple rows in a batch with that data. For more
information, see Browser View Buffer, page 348.

Clear Data from the Buffer

This procedure shows you how to clear the stored data from the buffer. You can clear
the entire buffer or the data in the currently selected field. For more information, see
Clear Data from the Buffer, page 349.
Sort Displayed Rows

This option shows you how to modify the current sorting settings which were defined
in the Browser Manager. For more information, see Sort Displayed Rows, page 349.
Count Displayed Rows

This option shows you how to count the displayed rows. For more information, see
Count Displayed Rows, page 349.
Refresh Displayed Data

This option shows you how to refresh the displayed data with the data from your
database. The data which is displayed in the Browser View window is not kept
automatically up-to-date. Therefore, you need to manually refresh the displayed data
to view updated data. For more information, see Refresh Displayed Data, page 350.
Find a Value in a Specific Column

This procedure shows you how to search a selected column in a Browser View for a
specific value. The following search options are available:
• Search for a whole value.

• Search for a phrase or a sub-string.
• Search the column for a value as you type it in.
For more information, see Find a Value in a Specific Column, page 351.
Select Non-Editable Field Indication Color.

This procedure shows you how to change the color used in the Browser View to
mark fields which are not accessible for editing. For more information, see Select
Non-Editable Field Indication Color, page 352.
Open a Module from a Browser View

This option enables you to open the relevant module directly from the Browser View
window. In other words, the Browser module will open for you the appropriate
module for the item you select in the Browser View window. For example, if you
select a loop in the Loop Browser view of the Instrument Index browser, you can
automatically open the Loop Number dialog box to edit the selected loop. For more
information, see Open a Module from a Browser View, page 352.
Related Topics

Open a Browser View

1. To open the default Browser View, do one of the following:
• Click .
2. To select a Browser View other than the default view, with the browser default
view open, do one of the following:
• Click .
• Click .
3. In the Browser Manager, expand the Browser groups hierarchy and select the
browser you want to open.
• Click .
• Click Actions > Open View.
Note
• If you have not defined a default Browser View clicking on the browser
button or Actions > Open View opens the Browser Manager where
you can create a default view. For more details, see Define a View Profile,
page 289.
Related Topics

Edit Data in a Browser View

1. Open the required browser view. For more details, see Open a Browser View,
page 345.
2. Select the data field that you want to edit.
3. To edit the selected data field, use one of the following methods, as required:
• Type the appropriate value.
• Click to open a list and select the appropriate value.
• Select or clear a check box.
• Right-click, and from the shortcut menu select the appropriate option.
Tip
• Press Tab to move to the next data field. Press Tab + Shift to move
to the previous data field.
Notes
• If you wish to add or delete some of the options in a list, you can access
that list from the Tables menu in the Instrument Index Module window.
• Fields that hold naming convention data (Name, Prefix, Number, and
Suffix) cannot be edited.
Related Topics
Modify and Save a Field Layout

1. Open the Browser View window that you want to modify. For more details, see
Open a Browser View, page 345.
2. Place the mouse pointer over a column heading and then drag and drop the
column to a desired position in the data window.
3. Place the mouse pointer on an edge of a column heading so that the pointer
changes to a double-headed arrow, and then resize the column width as you
require.
4. Right-click anywhere in the data window and then, on the shortcut menu, click
Save Field Layout.
Related Topics

Modify Document Numbers in a Document Browser View

1. In the SmartPlant Instrumentation window, do one of the following to open the
Browser Manager:
• On the menu bar, click File > Browser Manager.
2. Double-click the Documents browser group.
3. Double-click Document Browser and do one of the following:
• Click Actions > Add View.
• Right-click the highlighted browser and then, on the shortcut menu,
click Add View.
4. Define a view profile for the new browser view. For more information, see
Define a View Profile, page 289.
5. Define the view style settings containing the following data field column headers:
• Document Number (DWG_NAME) — Allows you to displays
document numbers.
• Document Type (DWG_TYPE_ID) — Allows you to display all
documents available in SmartPlant Instrumentation according to their
document type, for example, all specifications, all process data reports,
and so forth.
Tip
• For details on how to define view style settings, see Create a View
Style, page 311.
6. Set a sorting sequence and filter conditions if needed.
7. On the Browser Manager toolbar, click to open the browser view that you
created.
8. Under the Document Number column, modify the document numbers as you
require.
9. On exiting the browser view, save the changes when prompted.
Related Topics
• Create a Sorting Sequence View, page 323
• Define a View Filter, page 331
• Define a View Profile, page 289

Browser View Buffer

page 345.
2. Click in the appropriate field of the Buffer data window and type the relevant
information. Press the Tab key to move to the next data field or press Shift +
Tab to move to the previous data field.
3. To copy an entire row to the Buffer data window, select the appropriate row, and
do one of the following:
• Click .
• Click Edit > Copy to Buffer.
4. To copy a field to the Windows Clipboard, select the appropriate field and then
press either Ctrl + Ins or Ctrl + C.
5. In the Browser View window, highlight the row(s) or the field(s) that you want to
update. (To select more than one row, hold down Ctrl and click the required
rows.)
Important
• Use the scrollbar to view all parts of the Buffer data window and
check the data they contain before pasting data from the Buffer data
window to the Browser View window.
6. To paste the data from the buffer to the currently selected row, do one of the
following:
• Click .
• Click Edit > Paste From Buffer.
Tip
• Empty Buffer columns do not update the target fields.
7. To paste the data from the Windows Clipboard to a selected field, press Ctrl + V.
Related Topics

Clear Data from the Buffer

1. To clear the entire buffer, click .
2. To clear one field in the buffer, do the following:
a. Click in the field you want to clear.
b. Click .
Related Topics
Sort Displayed Rows

page 345.
2. Double click the header of the column you want the displayed rows to be sorted
by. The displayed rows are sorted in an ascending order according to the selected
column.
3. Double click the header again, and the displayed rows are sorted in a descending
order according to the selected column.
Related Topics
Count Displayed Rows

page 345.
• Click .
• Click Actions > Count.
Note
• If the data window contains a large number of rows, the counting process
may require a few seconds to refresh the data.
Related Topics

Refresh Displayed Data

page 345.
• Click .
• Click Edit > Refresh.
3. If you are prompted to save changes:
• Click Yes to save the modified data before refreshing the data from the
database.
• Click No to discard the changes that you made to the displayed data.
Related Topics

Find a Value in a Specific Column

page 345.
2. Click the header of the column you want to find the value in.
• Click Edit > Find.
• Click .
4. In the Find dialog box, do one of the following:
• Select Whole Value to find only occurrences that are whole words
(this is the default selection).
• Select String to find occurrences that are either whole words or part of
a word.
• Select As Typed to search for the value as you type it in.
5. Type the value you are looking for. If you selected either Whole Value or
String, click Find to find the next occurrence.
Tips
• During the search, the Find button changes to Stop, allowing you to
stop the search, if required. When an appropriate occurrence is found,
the corresponding row is automatically highlighted. (If you selected
As Typed, the Find button becomes inactive, and the search is carried
out as you type the value in the Find dialog box.)
• Change the search column when the Find dialog box is open by
clicking on the header of another column.
6. Click Close when you have finished your search.
Related Topics

Select Non-Editable Field Indication Color

1. Open the Browser Manager. For more details, see Open a Browser View, page
345.
2. Click Actions > Set Color for Read-Only Fields.
3. In the Color dialog box, to select a color, do one of the following:
• Select a color from the Basic colors.
• Click the approximate color on the color palette, and then use the
control bar to adjust the color to your requirements. You can save this
color as a custom color by selecting a Custom colors box, and then
clicking Add to Custom Colors.
• Enter the Red, Green, and Blue numeric values, or the Hue; Sat; and
Lum; numeric values in the relevant fields.
4. Click OK.
Related Topics
Open a Module from a Browser View

page 345.
2. Highlight the required data row.
3. Right-click the highlighted data row to open a shortcut menu.
Tip
• The shortcut menu displays the available modules relevant to the
selected data row. The disabled modules are either irrelevant to the
selected data row or do not contain appropriate data.
4. Select the required sub-menu item from the available options.
Related Topics

Instrument Index Module: An Overview
Instrument Index Module: An Overview

The Instrument Index module allows you to create, modify, and maintain a
comprehensive database that contains all your instrumentation data.
The module offers tools for adding, editing, duplicating, and deleting loop and
instrument tag numbers. Instrument types and their profiles are organized in a
comprehensive fashion providing easy data entry. Other data, such as model and
manufacturer, P&ID drawing numbers, lines, locations, I/O types, equipment names
are organized in supporting tables.
The Instrument Index module also provides other functions that include item-oriented
(tag, loop, and so forth), filtered, sorted and customizable database viewing options.
You can generate reports in several formats, attaching remarks to items, creating
specific summaries, and viewing and managing history.
Before working with the Instrument Index module make sure the Domain
Administrator has defined the Loop and Tag naming conventions in the
Administration Module. For more information, see Naming Conventions: An
Overview in the Administration User's Guide, under Domain and Project
Administration, Naming Conventions, Naming Conventions: An Overview.
Related Topics
• Associating Instrument Tags with Loop Numbers: An Overview, page 407
• Edit Data: An Overview, page 432
• Generating Documents: An Overview, page 449
• Managing Instrument Tags: An Overview, page 382
• Managing Lines: An Overview, page 425
• Managing Loop Numbers: An Overview, page 354
• Working with External Documents: An Overview, page 456
• Working with Typical Loops and Tags: An Overview, page 412

Managing Loop Numbers: An Overview

SmartPlant Instrumentation allows you to easily create and manage loops through out
your <plant>. You can create unique numbered loops for each <unit> in your
<plant>. Duplicate, rename, and move loops about your <plant> without losing
critical information. Edit loop number information, change loop numbers, create new
numbers, simply and quickly without creating a duplicate loop number within a
<unit>, or losing any information. SmartPlant Instrumentation keeps track of all your
loops making the necessary adjustments automatically.
Related Topics
• Managing Loop Numbers Common Tasks, page 355

Managing Loop Numbers Common Tasks

The following tasks are used frequently when you create and manage the loop
numbers in your plant.
Create a New Individual Loop Number

This option shows you how to create a new single loop number, in the Domain
Explorer or in the Instrument Index Module, and add it to your database. For more
information, see Create a New Individual Loop Number, page 357.
Duplicate a Loop Number

This option shows you how to create a new loop number by duplicating an existing
one. SmartPlant Instrumentation creates a new loop number based on the properties
of a source loop that you select. This feature is useful when you want to create a loop
number similar to an existing one. You duplicate a loop number and then edit its
properties as needed. Note that you can duplicate a loop number in the same <unit>
as the source loop number or in any other <unit> of the current domain. For more
information, see Duplicate a Loop Number, page 359.
Edit Loop Number Properties from the Domain Explorer

This option allows you to modify the properties of an existing loop number from the
Domain Explorer . You can also edit the target loop number when duplicating an
existing loop number. For more information, see Edit Loop Number Properties from
the Domain Explorer, page 362.
Edit Loop Properties from the Instrument Index Module

This option allows you to modify the properties of an existing loop number from the
Instrument Index Module. You can also edit the target loop number when duplicating
an existing loop number.; For more information, see Edit Loop Properties from the
Instrument Index Module, page 364.
Edit Multiple Loop Numbers

This option shows you how to select a group of loop numbers and modify the profile
of these loop numbers. This option is especially effective if you do not want to edit
the tag numbers associated with the loops you are editing. For more information, see
Edit Multiple Loop Numbers.
Create a New Loop Number During Tag Edit

This option shows you how to create a new loop number on the fly while editing a tag
number. You can then associate the current tag number with that new loop you are
creating. For more information, see Create a New Loop Number During Tag Edit.

Move Loop Numbers

This option shows you to select one loop number or a group of loop numbers and
move them to another <unit> in the current <plant>. For more information, see
Move Loop Numbers.
Delete Loop Numbers

This option shows you how to delete loop numbers that are no longer required. You
can delete a single loop number or several ones as needed. When deleting a loop
number, several batch deletion options are possible depending on your loop number
deletion preference settings. You can delete several loop numbers in batch mode
(without being prompted to confirm each deletion) or delete several loop numbers one
by one, confirming the deletion of each loop number.
Note that if you are deleting a loop number associated with wiring, SmartPlant
Instrumentation automatically disconnects all the required instruments. For more
information, see Delete Loop Numbers, page 369.
Rename A Single Loop Number

This option shows you how to rename a single loop number. For more information,
see Rename A Single Loop Number.
Rename Multiple Loop Numbers

This option shows you how to rename multiple loop numbers in the current <unit>.
You can also modify the loop number service and edit associated tag numbers if
required. For more information, see Rename Multiple Loop Numbers.
Define a Functional Requirement for a Loop

This option shows you to define a functional requirement for a selected loop number.
Functional requirement is the combination of loop function and process function data
for a specific loop. For example, for Loop FIC-100, F refers to process function and
IC to process function. C can be interpreted as measuring and control. During the
early stages of a project, the loop functional requirements are known. However, the
functional requirements for the project devices are not known yet. To make cost
estimations during the early stages of your project, you need loop functional
requirements that contain process data, such as loop number, DN, pipe specifications,
and so forth. Later on in your project, you can copy these functional requirements to
the real devices.
Note that you can define multiple functional requirements for a specific loop number.
Also, you can generate a specification for a loop that has a functional requirement.
For more information, see Define a Functional Requirement for a Loop.
Related Topics

Create a New Individual Loop Number

1. On the Domain Explorer, expand your current <plant> hierarchy to display the
Loops folder.
2. Right-click the Loops folder and on the shortcut menu, click New > Loop.
3. On the New Loop Number dialog box, type the name of the new loop number.
For an explanation of the segments of a loop number see Loop Number Naming
Convention, page 358
4. When prompted select No if you do not want to associate a new tag number at this
moment, the Loop Number Properties dialog box will open. Select Yes to
create a new tag number that will be associated with the new loop:
a. The New Tag Number dialog box opens.
b. Type the tag number and click OK.
c. On the Select Instrument Type dialog box, select your instrument type and
click OK.
d. The Tag Number Properties dialog box opens where you can define the
general properties for your tag number. For details of the options available
click the Help button in the New Tag Properties dialog box.
e. When you have finished click OK to open the Loop Number Properties
dialog box.
5. On the Loop Number Properties dialog box, define the properties you want to
associate with the loop number. For details of the options available click the Help
button in the Loop Number Properties dialog box.
6. Click OK. to close the Loop Number Properties dialog box.
Notes
• You can also create a loop number from the Instrument Index module. In
the Instrument Index Module window, click on the toolbar or on the
menu bar, click Edit > Loop Numbers > New Loop Number.
• The data field in the New Loop Number dialog box displays the loop
name template which is based on the loop naming convention defined by
the Domain Administrator. In the alphanumeric and the numeric parts of
the name, you can type any character (letters, digits, spaces, and so forth).
You can customize the loop name template but only the Domain
Administrator can change the naming conventions. For more details see
Customize New Loop Numbers, page 368.
• You can define a functional requirement while creating a new loop. For
details see Define a Functional Requirement for a Loop, page 373.
Related Topics

Loop Number Naming Convention

When renaming existing loop numbers or creating new ones, make sure that the loop
number names comply with the naming conventions set for the current <unit> by the
Domain Administrator for the current <unit>. In the alphanumeric and the numeric
parts of the name, you can type any character (letters, digits, spaces, and so forth).
Example Loop Number: 101- FIC – 2225/E
Segment Description
100 – prefix derived from the loop naming convention defined by
the Domain Administrator
F – measured variable
IC – loop function
2225 – loop number
E – suffix
Related Topics
• Create a New Individual Loop Number, page 357
• Create a New Loop Number During Tag Edit, page 367

Duplicate a Loop Number

1. In the Domain Explorer, expand your current <plant> hierarchy to display the
Loops folder.
2. Double-click the Loops folder to display the existing loops.
3. Right-click the loop you want to duplicate, and on the shortcut menu, click
Duplicate.
4. On the Duplicate Loop Number dialog box, type the new loop number.
Tip
• The data field on the Duplicate Loop Number dialog box displays the
loop name template based on the loop naming convention defined by
the Domain Administrator. In the alphanumeric and the numeric parts
of the name, you can type any character (letters, digits, spaces, and so
forth).
5. If required, do the following to create the duplicated loop number in a different
<unit> in the current domain:
a. On the Duplicated Loop Number dialog box, check the Create in another
unit check box.
b. On the Select Target Unit dialog box, select the target unit.
c. Click OK to return to the Duplicated Loop Number dialog box.
6. Click OK in the Duplicated Loop Number dialog box.
7. Do the following to create new tag numbers that will be associated with the new
loop number:
a. On the Create Loop Tags dialog box, select the appropriate check boxes
beside the tag numbers that you want to create. The software duplicates the
tags associated with the source loop and associates the new tags with the new
loop number. Note if you have more than one type of tag associated with the
loop, for example; Conventional tags and Functional requirement tags, then a
Create Loop Tags dialog box will open for each tag type, one after the other.
b. Modify the names of the new tag numbers as needed. Note that you cannot
change the prefix and the separator.
c. Select Copy the instrument type from the source tag numbers to keep the
instrument type of the source tags.
d. Click Next, to move to the next tag type Create Loop Tags dialog box. Note
if you click Next after editing all the loop tag types a prompt will appear, click
Yes to return to the first Create Loop Tags dialog box, or No to close the
prompt.
e. Click OK.

f. When prompted, click Yes to edit the tag properties you have duplicated, or
No to duplicate the tag numbers with their existing parameter values.
g. On the Loop Number Properties dialog box, define the properties you want
to associate with the loop number. For details of the options available click the
Help button in the Loop Number Properties dialog box.
h. Define a functional requirement if required. For details see Define a
Functional Requirement for a Loop, page 373.
i. Click OK .
Notes
• You can change the measured variable of the new loop number or keep
it the same as the source one. New tag numbers associated with the
new loop number will be affected accordingly, that is, the measured
variable of the new tag numbers will change if the measured variable
of the new duplicated loop is changed. For example, if you are
duplicating Loop 101-F-102 and you change the measured variable of
the new loop to T, the new tag numbers associated with the new loop
number will change their instrument type in accordance with the new
measured variable: source Tag Number 101-FE-102 will change to
101-TE-102.
• You can also duplicate a loop number from the Instrument Index
module. In the Instrument Index Module window, click on the
toolbar or on the menu bar, click Edit > Loop Numbers > Duplicate
Loop Number.
Related Topics

Move Loop Numbers

1. Start the Instrument Index Module by doing one of the following:
• Click .
• Click Modules > Instrument Index.
2. On the Instrument Index menu bar click Edit > Loop Numbers > Move
Number.
3. On the Enter Loop Number dialog box, do one of the following:
• To move one loop number, type the required loop number.
• To move a group of loop numbers, click Find.
• In the Find Loop dialog box click Find again.
• In the Search results data window, hold down Ctrl and highlight the
required loop numbers, or select the Select all check box to move all
the displayed loop numbers.
4. Click OK.
5. On the Select Target <Unit> dialog box, select the <unit> to which you what to
move the selected loop numbers.
6. Click OK.
Related Topics

Edit Loop Number Properties from the Domain Explorer

Loops folder
2. Double-click the Loops folder to display the existing loops.
3. Right-click a loop, then click Properties.
Tip
• You can also edit the properties of a loop number from the
Instrument Index Module. For more details see Edit Loop
Properties from the Instrument Index Module, page 364
4. On the Loop Number Properties dialog box, edit the loop properties by entering
values or selecting values from the lists.
Tips
• If needed, click the button beside an appropriate list arrow to open
the pertinent supporting table where you can rename a loop number,
add, edit, or delete an item on the list.
• You can define a functional requirement while creating a new loop.
For details see Define a Functional Requirement for a Loop, page 373
5. Select Apply P&ID drawing to tags to apply the P&ID drawing number data to
any new tag numbers that will be subsequently associated with this loop. Then, in
the Loop Browser View window (in the Browser module), you can select a
different drawing number (if available) and propagate it to all tag numbers
associated with this loop. If you are editing an existing loop which is already
associated with a P&ID drawing number, selecting this option replaces the
existing drawing number values with the new drawing number that you enter in
the P&ID drawing field.
6. Select the Apply service to tags check box to download the loop service to any
new tag numbers that will be subsequently associated with the current loop. If
you are editing an existing loop which is already associated with tag numbers,
selecting this option replaces the existing tag service values with the new loop
service that you type in the Loop service field.

7. Select Apply equipment to tags to apply the equipment data to any new tag
numbers to be subsequently associated with this loop.
Tips
• If you clear the Apply P&ID drawing to tags check box, you will still
be able to define a P&ID drawing reference for subsequently
associated new tag numbers by selecting a required drawing number
from the P&ID list in the Tag Number Properties dialog box.
• If the loop you are editing already contains associated equipment,
selecting this option replaces the existing equipment values with the
new equipment that you type in the Loop equipment field.
8. Select the Update document number check box to update the document number
of the associated loop drawing.
Tip
• A document number naming convention can contain segments that
represent loop number properties. Therefore, if you select this check
box, changing a loop number property that is used in the document
number segment also changes the document numbers in accordance
with this change. After you select this check box, the software updates
numbers of all documents containing the current loop number. For the
current loop number, the software overrides the default or user-defined
numbers of all the documents that appear in the Loop Drawing List
dialog box of the Loop Drawings module. For details on document
number naming conventions, see the Administration module Help,
Document Number Naming Convention Examples.
9. Click OK.
10. At the prompt, do one of the following:
• Click Yes to edit the tag numbers associated with the current loop.
• Click No to close the Loop Number Properties dialog box and save
new loop number values without editing the associated tag numbers.
Related Topics

Edit Loop Properties from the Instrument Index Module

1. To start the Instrument Index Module do one of the following:
• Click .
2. In the Instrument Index Module window, do one of the following:
• Click .
• Click Edit > Loop Numbers > Loop Number Properties.
3. In the Enter Loop Name dialog box, do one of the following:
• Type the loop number that you want to edit and click OK.
• Click Find without entering any loop number and in the Find Loop
dialog box click Find. Select the loop number whose properties you
want to edit in the Search results data window, and click OK.
4. In the Loop Number Properties dialog box, edit the loop properties by entering
Tips
the pertinent supporting table where you can rename a loop number,
add, edit, or delete an item on the list.
• You can define a functional requirement while creating a new loop.
For details see Define a Functional Requirement for a Loop, page 373
5. Select Apply P&ID drawing to tags to apply the P&ID drawing number data to
any new tag numbers that will be subsequently associated with this loop. Then, in
the Loop Browser View window (in the Browser module), you can select a
different drawing number (if available) and propagate it to all tag numbers
associated with this loop. If you are editing an existing loop which is already
associated with a P&ID drawing number, selecting this option replaces the
existing drawing number values with the new drawing number that you enter in
the P&ID drawing field.
6. Select the Apply service to tags check box to download the loop service to any
new tag numbers that will be subsequently associated with the current loop. If
you are editing an existing loop which is already associated with tag numbers,
selecting this option replaces the existing tag service values with the new loop
service that you type in the Loop service field.

7. Select Apply equipment to tags to apply the equipment data to any new tag
numbers to be subsequently associated with this loop.
Tips
• If you clear the Apply P&ID drawing to tags check box, you will still
be able to define a P&ID drawing reference for subsequently
associated new tag numbers by selecting a required drawing number
from the P&ID list in the Tag Number Properties dialog box.
• If the loop you are editing already contains associated equipment,
selecting this option replaces the existing equipment values with the
new equipment that you type in the Loop equipment field.
8. Select the Update document number check box to update the document number
of the associated loop drawing.
Tip
• A document number naming convention can contain segments that
represent loop number properties. Therefore, if you select this check
box, changing a loop number property that is used in the document
number segment also changes the document numbers in accordance
with this change. After you select this check box, the software updates
numbers of all documents containing the current loop number. For the
current loop number, the software overrides the default or user-defined
numbers of all the documents that appear in the Loop Drawing List
dialog box of the Loop Drawings module. For details on document
number naming conventions, see the Administration module Help,
Document Number Naming Convention Examples.
9. Click OK.
10. At the prompt, do one of the following:
• Click Yes to edit the tag numbers associated with the current loop.
• Click No to close the Loop Number Properties dialog box and save
new loop number values without editing the associated tag numbers.
Related Topics

Edit Multiple Loop Numbers

• Click .
• Click .
3. On the Enter Loop Number dialog box, click Find without typing any loop
number.
4. On the Find Loop dialog box, click Find.
5. On the Search results data window, select the loop numbers you require. You
can hold down the Ctrl key and select a group of loop numbers or check the
Select all check box.
6. Click OK.
7. On the Loop Number Properties dialog box, edit the loop properties by entering
Tip
the supporting table where you can rename a loop number, add, edit,
or delete an item on the list.
8. Select Apply service to tags to apply the loop service of the current loop number
to the associated tag numbers.
9. Select Apply P&ID to tags to propagate the P&ID drawing number data to all the
tag numbers associated with the current loop number.
10. Select Apply equipment to tags to propagate the equipment data to all the tag
numbers associated with the current loop number.
11. Click Next to edit the properties of another loop.
Tip
• When you save the new loop number values, the software does not
update the properties of the tags associated with the loop numbers you
are editing. When editing multiple loop numbers, the software does not
prompt you to edit the associated tag numbers.
12. Click OK to close the Loop Number dialog box and save new loop number
values.

Create a New Loop Number During Tag Edit

1. From the Domain Explorer select the tag you want to edit.
2. Right click the tag and select Properties.
3. On the Tag Number Properties dialog box, click New Loop.
4. On the New Loop Number dialog box, type the name of the new loop number
and click OK. For an explanation of the segments of a loop number see Loop
Number Naming Convention, page 358
5. Edit the properties of the new loop number as required In the Loop Number
Properties dialog box and click OK.
6. On the Tag Number Properties dialog box, click OK.
Related Topics

Customize New Loop Numbers

The options in this dialog box allow you to customize the loop number name
template that appears in the New Loop Number dialog box. You can also choose to
propagate the loop service description to the loop drawing reference if desired.
• Define new loop name template:

These options determine how SmartPlant Instrumentation displays new loop number
names in the New Loop Number dialog box in relation to the previously created tag
number. The options are:
• No default – The data field in the New Loop Number dialog box does
not display any default loop, letting you enter the number you need.
• Same as the last created loop – The data field in the New Loop
Number dialog box displays the last created loop. You can accept the
displayed number, modify it, or type the number you need.
• Same as the last created loop + 1 – The data field in the New Loop
Number dialog box displays the last created loop number incremented by
one. You can accept the displayed number, modify it, or type the number
you need.
• The last existing loop in the unit + 1 – The data field in the New Loop
Number dialog box displays the last existing loop number in the current
unit incremented by one. You can accept the displayed number, modify it,
or type the number you need.
• The last existing loop in the domain + 1 – The data field in the New
Loop Number dialog box displays the last existing loop number in the
current domain incremented by one. You can accept the displayed number,
modify it, or type the number you need.
• Apply loop service to drawing description
Specifies that in the Loop Drawings module, a loop service which you define for a
loop appears in the Loop Drawing List dialog box under the Description column. If
you clear the check box, the Description column remains empty.
Note
• The last three options in the Define new loop name template are
available for numeric loop names only. If your loop names are not
numeric, the data field in the New Loop Number dialog box will display
the last created loop.
Related Topics
• Loop Number Naming Convention, page 358

Delete Loop Numbers

1. On the Instrument Index module menu bar, click Edit > Loop Numbers > Delete
Loop Number.
2. On the Enter Loop Name dialog box, do one of the following:
• Type the loop number that you want to delete.
• Click Find without typing a loop number, so that you can select
several loop numbers for deletion in the Find Loop dialog box.
3. On the Find Loop dialog box, if required, click the Find loops with one or more
fieldbus tags check box to narrow your search results to loops that contain tags
with a fieldbus system I/O type.
4. Click Find.
Tip
• You can view more loop number rows, select Show more search
results.
5. On the Search results data window, select the loop numbers that you want to
delete and click OK.
6. On the Delete Loop Number dialog box, click Delete.
Tip
• If there are any tag numbers associated with the Loop Number a
prompt box will ask you if you want to delete all associated tag
numbers. Click Yes to delete, or No to save the tag numbers
Notes
• If you are deleting several loop numbers and you have selected the Skip
deletion confirmation option in your loop deletion preferences, all the
loop numbers you have highlighted in the Search results data window
will be deleted on the fly without prompting to confirm each deletion.
• You can also delete one or more loop numbers using the Domain
Explorer without opening the Instrument Index module. In the tree view
of the Domain Explorer, click the Loops folder. Then, in the Items
pane, select the loops you want to delete. Right-click the selected loop
numbers and then click Delete.
Related Topics

Rename A Single Loop Number

• Click
2. On the Instrument Index Module, do one of the following:
• Click
3. On the Enter Loop Number dialog box type the name of the loop that you want
to rename and click OK or do the following:
• On the Enter Loop Number dialog box, click Find without typing
any loop number.
• On the Find Loop dialog box click Find.
• Select the loop number from the Search results dialog box and click
OK.
4. On the Loop Number Properties dialog box, click next to the Loop number
field.
5. On the Rename Loop Number dialog box, type the new loop number name.
6. Click OK.
7. On the Loop Number Properties dialog box click OK.
Tips
• If you set the preferences to open the Rename Loop Drawing File
dialog box after renaming a loop number, do the following to rename
the file name of the associated CAD drawing. In the Rename Loop
Drawing File dialog box, select a check box beside a desired file
name. Type a new name over the name displayed in the New Drawing
File column.
• If more than one file appears in the data window, the drawing type is
multi-drawing.

Notes
• You can rename the drawing file name if the loop number that you are
renaming is associated with a CAD loop drawing. To do this, set a
preference on the Rename page of the Preferences Dialog box before
performing this procedure. For more details see Set Preference for
Renaming A CAD File from A Loop Number, page 371
• Make sure that your new loop number name complies with the naming
conventions for the current <unit>.
• All loop numbers must have unique names in the current <unit>.
Related Topics
Set Preference for Renaming A CAD File from A Loop

Number
1. From the Menu Bar click, File > Preferences.
2. On the Tree View pane, double click the Instrument Index icon.
3. Click the Rename icon.
4. Select the Rename drawing file name when renaming the loop check box.
5. Click OK.
Related Topics
• Rename A Single Loop Number, page 370

Rename Multiple Loop Numbers

• Click .
2. On the Instrument Index Module, do one of the following:
• Click .
• Click Edit > Loop Numbers >Rename Multiple Loop Numbers.
3. On the Enter Loop Number dialog box, click Find.
4. On the Find Loop dialog box, click Find again.
5. On the Search results data window, select the loop numbers you require. You
can hold down the Ctrl key and select a group of loop numbers or check the
Select all check box.
6. Click OK.
7. On the Rename Multiple Loop Numbers dialog box, do the following:
a. Select the Select check box next to each loop number that you want to
rename, or select the Select all check box to rename all the loops in the
Rename Multiple Loop Numbers dialog box.
b. On the New Loop Number field, type the new loop number name.
c. Click on the Loop Service field and modify the value if needed.
d. Select the Edit tag numbers check box to edit the properties of the tag
numbers associated with the selected loop numbers after you rename these
loop numbers
e. Click Rename.
8. On the Tag Number Properties dialog box, edit the properties of the tag
numbers you have chosen.
9. Click OK.

10. The Rename Multiple Loop Numbers dialog box reopens.

Tip
• If after clicking Rename some of the selected loop numbers have not
been renamed, the Result field of the Rename Multiple Loop
Numbers dialog box displays the reason why you could not rename
these loop numbers.
11. Click Close.
Note
• Make sure that your new loop number names comply with the naming
conventions of the current <unit>. All loop numbers must have unique
names in the current <unit>.
Related Topics
Define a Functional Requirement for a Loop

1. Create or edit a loop number.
2. On the Loop Number Properties dialog box, click Func. Req.
3. On the New Tag Number dialog box, under Tag number type the new tag
number name and click OK.
4. On the Select Process Function dialog box, select the process function that you
need and click OK.
5. On the Tag Number Properties dialog box, define the properties of the new tag
number as you require.
6. Click OK.
Related Topics
• Duplicate a Loop Number, page 359
• Edit Loop Number Properties from the Domain Explorer, page 362
• Edit Loop Properties from the Instrument Index Module, page 364

Working with Instrument Types: An Overview

You use instrument type to identify and classify instruments in SmartPlant
Instrumentation. SmartPlant Instrumentation provides a number of predefined
instrument types, such as FE, PT, and so forth. You can add new instrument types
and modify the shipped instrument types as required. You can also delete an
instrument type that is not in use, but the software does not let you delete an
instrument type that you already used to create a tag number.
SmartPlant Instrumentation uses standard function identifier acronyms to identify

instrument types. However, some function identifier acronyms are not unique and are
used for more than one instrument type. For instance, FE can refer to D/P Type Flow
Element or a Mass Flow Sensor. As a result, when creating a new tag number with
such an acronym, the software opens the Select Instrument Type dialog box where
you select the appropriate instrument type.
You classify all instrument types in SmartPlant Instrumentation according to process

function. You use process function to associate an instrument with a specific type of
specification, process data, and calculation sheet. For example, if you need to
associate a tag number with a specification that contains flow information, this tag
number must have an instrument type that belongs to the Flow process function.
For each instrument type that you define, you also set a profile definition that allows
you to automate the creation of tag numbers with a number of predefined properties.
When defining an instrument type, you also define its profile. Instrument type profile
allows you to automate the creation of tag numbers with a number of predefined
properties. In other words, when you create a new tag number based on a particular
instrument type, SmartPlant Instrumentation automatically creates and associates a
number of items that you chose in the instrument type profile that serves as a basis for
the new tag number.
Related Topics
• Instrument Types Common Tasks, page 375

Instrument Types Common Tasks

The following tasks are used frequently when you create and manage instruments in
your plant.
Define an Instrument Type Profile

This option shows you how to define a new instrument type, or edit the properties of
an existing instrument type. For more information, see Define an Instrument Type
Profile, page 377.
Define a General Process Function

This option shows you how to create a sub-category for the General process function.
You can then select one of these sub-category values for any General process
function in the data window of the Instrument Types dialog box. For more
information, see Define a General Process Function, page 378.
Define an Instrument Type Default Settings

This option shows you how to define a profile for each instrument type that you use.
An Instrument type profile is a group of default settings that allow you to create new
tag numbers with certain predefined properties. For example, you can create new tag
numbers associated with a particular specification, I/O type, reference device panel,
and so forth. You define an instrument type profile for each instrument type. As a
result, SmartPlant Instrumentation creates new tag numbers with the predefined
properties based on the instrument type that you select for the new tag number.
Define a Wiring and Controls System Instrument Type Profile

This option shows you how to set the wiring and control system default settings
allowing you to create new tag numbers with the settings that you defined for the
instrument type. For example, you can automatically define new instruments as
control-system-enabled so that new tag numbers with the current instrument type
profile will be part of a control system and be able to send and receive signals. You
can also include automatic creation of control system (CS) tags, selection of reference
panels and cables, and connector definitions. For more information, see Define a
Wiring and Controls System Instrument Type Profile, page 378.
Copy Instrument Type Profile Data

This option shows you how to copy instrument type profile data from one instrument
type to another. This procedure is useful when you want to define instrument types
with similar profile properties. This way you do not need to define all the profile data
for a new instrument type from scratch. After completing this procedure, you can
access the profile associated with the target instrument type and change the required
properties. For more information, see Copy Instrument Type Profile Data, page 380.

Set an Alias Control System Tag

This option shows you how to create an alias for automatically created CS tags.
When creating CS tags automatically, you can instruct SmartPlant Instrumentation to
use CS tag naming conventions or use the shipped predefined naming convention for
CS tags. SmartPlant Instrumentation will name new CS tags according to the rules
you set only after the Domain Administrator has set the control system tag naming
conventions for the current <unit>. If the CS tag naming conventions haven't been
set, the software uses the following predefined rule for all automatically created CS
tags:
INSTRUMENT TYPE + NUMBER + \SUFFIX
After the Domain Administrator defines the control system tag naming conventions
for the current <unit>, you can decide whether to use the tag number's instrument
type for the CS tag or set an alias for the new CS tags. If you do not set an alias for
these CS tags, SmartPlant Instrumentation names them according to the instrument
type of the tag numbers with which they are created. Note that the length of the alias
text should not exceed the length of the instrument type alias string defined by the
Domain Administrator in the Naming Conventions dialog box. For more
information, see Set an Alias Control System Tag, page 380.
Apply all Existing Profiles

This option shows you how to create the following tag items specified in the
instrument type profiles for selected instruments in an Instrument Index Standard
Browser view: instrument specification sheets, control system tags, and device
panels and cables. For more information, see Apply all Existing Profiles, page 381.
Related Topics

Define an Instrument Type Profile

1. On the Instrument Index module menu bar, click Tables > Instrument Types.
2. In the Instrument Types dialog box, from the Process function list, select the
process function that you require.
• Click New to append a new data row in the data window.
• Click a selected row to edit the values of an existing instrument type.
4. Under Instrument Type, type an instrument type acronym. You can have
duplicate acronyms if needed.
Tip
• If you have duplicate instrument type acronyms, when creating new
tags based on such an instrument type, SmartPlant Instrumentation
opens the Select Instrument Type dialog box and lets you select the
exact instrument type that you require for the new instrument.
5. Under Description, type a brief description as desired.
6. Under CS Tag Instrument Type Alias, type an alias for a control system tag
instrument type. Do this only if you want to create control system tags that will
have an alias instrument type associated with the current instrument type. Leave
this field blank if you are not going to create CS tags based on the current
instrument type or if you want the CS tags to have the same instrument type as the
tag number.
7. If you selected the General process function, under General Process Function
Sub-Category, select a value that you predefined in the General Process
Function Sub-Category supporting table. For details, see Define a General
Process Function, page 378.
Related Topics
• Apply all Existing Profiles, page 381
• Generate a Process Data Sheet for an Instrument, page 452
• Set an Alias Control System Tag, page 380

Define a General Process Function

1. On the Instrument Index module menu bar, click Tables > General Process
Function Sub-Category.
2. Click New to append a new data row.
3. Type the new sub-category name, for example, Mechanical, Electrical, and a
description, as you require.
Related Topics
• Define an Instrument Type Profile, page 377
Define Instrument Type Default Settings

1. On the Instrument Index Module window menu bar, click Tables > Instrument
Types.
2. From the Process function list, select the process function that you require.
3. In the data window, select the instrument type you desire.
4. Click Profile.
5. Make your definitions as you require.
Note
• Make sure that your preferences are set to activate the options that you
require.
Related Topics
Define a Wiring and Controls System Instrument Type

Profile
1. On the Instrument Index Module menu bar, click Tables > Instrument Types.
2. On the Instrument Types dialog box, from the Process function list, select the
process function type.
• Create a new instrument type.
• On the data window, select an existing instrument type.
4. Click Profile.

5. On the Instrument Type Profile dialog box, on the General tab, you can edit
fields as needed.
6. On the Wiring and Control System tab, select the Include wiring check box.
7. To define new instrument tags as control-system-enabled, select the Control
system check box. This enables the corresponding tag numbers for tag
assignment.
8. To enable automated creation of coupled control system tags, select Automatic
CS tags.
9. From the Reference device panel list, select an appropriate reference panel for
this instrument type. These are device panels that were created in Reference
Explorer.
10. If your reference device panel settings enable the Conventional connections
group box, do one of the following for each connection that you need for the
current instrument type:
• Click New, to add a connection.
• Click Properties, to edit the properties of an existing convention, and
on the Conventional Connection Properties dialog box, define the
settings that you require, and click OK.
11. If your reference device panel settings enable the Plug-and-socket connections
on the Plug-and-Socket Connection Properties dialog box, define
the settings that you require, and click OK.
Notes
• SmartPlant Instrumentation creates the wiring items according to an
instrument type profile, it always connects the created cable to the right
side of the panel that it creates. Therefore, you are not allowed to select a
left-oriented terminal from the Starting terminal list on the
Conventional Connection Properties dialog box. You can check the
configuration of a terminal by right-clicking it in the Domain Explorer
and selecting Properties on the shortcut menu.
• SmartPlant Instrumentation does not allow you to define a wiring
instrument type profile that enables connections on the left side of a device
panel.
Related Topics

Copy Instrument Type Profile Data

1. On the Instrument Index module menu bar, select Tables > Instrument Types.
2. From the Process function list, select the process function that you require.
3. Click Profile.
4. On the Instrument Type Profile dialog box, click Copy From to open the Copy
Instrument Type Profile Data dialog box.
5. From the Process function list, select the required process function.
6. In the data window, select the instrument type whose profile data you want to
copy.
7. Click OK to reopen the Instrument Type Profile dialog box, where you can
view the new profile properties.
8. Define the instrument type profile as you require.
Note
• If you want to copy the specification profile properties, note that both the
source and the target instrument type must belong to the same process
function. When the source and the target instrument type belong to
different process functions, the system copies the data without the
specification profile properties.
Related Topics
Set an Alias Control System Tag

1. Check that your Domain Administrator has set the naming conventions for control
system tags that you create in the current <unit> .
2. Define the instrument type profile for the required tag numbers and enable the
automatic creation of CS tags. For more details, see Define an Instrument Type
Profile, page 377.
3. In the Instrument Types dialog box, highlight the required instrument type.
4. Click in the CS Tag Instrument Type Alias field for the selected instrument type
and enter the CS alias by overtyping the displayed value.
5. Click OK to accept your settings and close the Instrument Types dialog box.
Note
• The CS tag alias will be enabled only if the Domain Administrator has
selected INST. TYPE ALIAS from the Description list in the Naming
Conventions dialog box when setting the control system tag naming
conventions.

Apply all Existing Profiles

1. Open an Instrument Index Standard Browser view.
2. Select the desired tag numbers.
• Right-click, and on the shortcut menu, click Apply Profile > Apply
All Profile Options.
• Click Actions > Apply Profile > Apply All Profile Options.
4. In the Results dialog box, view the results for each set of items, and then click
Close.
Notes
• To make this feature work, you must select the appropriate check boxes
and options in the instrument type profiles of the selected tag number. For
more details, see Define an Instrument Type Profile, page 377
• This option does not affect instrument profile options for items other than
instrument specification sheets, control system tags, and device panels and
cables.
Related Topics

Managing Instrument Tags: An Overview

SmartPlant Instrumentation allows you to easily create and manage instrument tags
through out your <plant>. You can create unique numbered tags for each <unit> in
your <plant>. Duplicate, rename, and move tags about your <plant> without losing
critical information. Define each instrument tag simply. Easily add or remove
instrument tags from loops, without creating a duplicate instrument tag, or losing any
information. SmartPlant Instrumentation keeps track of all your instrument tags,
automatically making the necessary adjustments as you work.
Related Topics
• Working with Tag Numbers Common Tasks, page 383

Working with Tag Numbers Common Tasks

The following tasks are used frequently when you create and manage instrument tags
in your plant.
Create an Instrument in the Domain Explorer

This option shows you how to create an instrument in the Domain Explorer. When
you define new instruments, the software creates them according to the instrument
type profiles that you defined in the Instrument Type Profile dialog box for a
selected instrument type. Defining a profile allows you to set instrument type default
settings for new instrument tags and thus create them with certain predefined
properties based on the instrument type you select for the new instrument. You set
profiles for every instrument type that you use. Consequently, make sure that you set
and activate all the required instrument type profiles before you start creating new
instruments. For more information, see Create an Instrument in the Domain
Explorer, page 385.
Enter Power Supply Data for Panels and Instrument Tags

This procedure explains how to enter power supply data for instrument tags that
require power supply. Although power supply data is not essential for SmartPlant
Instrumentation functionality, it is indicated for the interface with the SmartPlant
Electrical application. SmartPlant Instrumentation allows you to enter power supply
data in all panels except for junction boxes and device panels. For more information,
see Enter Power Supply Data for Panels and Instrument Tags, page 390.
Edit Instrument Tags from the Instrument Index

This option enables you to edit single and multiple instrument tags. If you want to
edit the instrument tag associated with a particular loop, use the Loop Number
Properties option. You can edit individual tags that you enter in the Enter Tag
Number dialog box or select the required tags from the Search results data window
in the Find Tag dialog box.
Edit an Instrument Tag from the Domain Explorer

This option enables you to edit individual instrument tags. If you want to edit the tags
associated with a particular loop, use the Loop Number Properties option. You can
edit individual instrument tags that you enter in the Enter Tag Number dialog box or
select the required tags from the Search results data window in the Find Tag dialog
box. For more information, see Edit an Instrument Tag from the Domain Explorer,
page 392.

Enter an Instrument Tag Remark

You use this option to enter a short remark to instrument tag properties in the
Instrument Index Standard Browser view. You add your tag remarks in the Rem
column. The browser view displays in the Rem column for the tags that contain
remarks. For more information, see Enter an Instrument Tag Remark, page 393.
Duplicate an Instrument Tag in the Domain Explorer

This option enables you to create a new instrument tag by duplicating the properties
of an existing one and then editing the new tag properties as required. You can create
the new duplicated instrument tag in the same <unit> as the original tag or any other
<unit> in the current domain. For more information, see Duplicate an Instrument
Tag in the Domain Explorer, page 394.
Delete Instrument Tags

This option enables you to delete one or more instrument tags that are no longer in
use. For more information, see Delete Instrument Tags, page 396.
Delete Instrument Tags in the Browse Window

This option allows you to delete more than one instrument tag at the same time in
batch mode. For more information, see Delete Instrument Tags in the Browse
Window, page 397.
Move an Instrument Tag to Another Plant Group

This option allows you to move an instrument tag to another <unit> in the same
<plant> or to a <unit> in a different <plant> in the domain. For more information,
see Move an Instrument Tag to Another Plant Group, page 397.
Move Multiple Instrument Tags in the Browser Window

This option allows you to move one or more instrument tags in the Browser View
window. You can move a tag to another <unit> in the same <plant> or to a <unit>
in a different <plant> in the domain. For more information, see Move Multiple
Instrument Tags in the Browser Window, page 398.
Rename an Instrument Tag

This option allows you to rename an existing instrument tag. For more information,
see Rename an Instrument Tag, page 398.
Change an Instrument Type

This option allows you to change the instrument type and process function of an
instrument tag. You make this change when editing instrument tag number, this can
be done in single or multi-mode. For more information, see Change an Instrument
Type, page 401.

Add and Edit Criticality Values

This option allows you to create and customize instrument criticality values that
appear on the Criticality list in the Associate Categories and Criticality dialog box.
Tag criticality is a user-defined process classification of instruments, for example
process safety system, environmentally vital system, quality system, and so forth.
Tag categories help you select groups of tags when performing Maintenance module
procedures. For more information, see Add and Edit Criticality Values, page 402.
Add and Edit Instrument Tag Categories

This option enables you to edit the name and the description of the available
instrument tag categories>. Using this option, you can also add new categories
which you will be able to associate with instrument tags. For more information, see
Add and Edit Instrument Tag Categories, page 403.
Generate a Process Data Sheet in a Browser Window

Use this option to generate a process data sheet for a selected instrument in an
Instrument Index Standard Browser view, where a process data sheet was not
previously defined for the instrument. For more information, see Generate a Process
Data Sheet in a Browser Window, page 404.
Related Topics
Create an Instrument in the Domain Explorer

2. Expand the plant hierarchy to display the Instruments and Loops folders.
• To create an instrument unassociated with a loop number, right-click
the Instruments folder and on the shortcut menu click New >
Instrument.
• To create an instrument that is associated with a specific loop number,
expand the Loops folder, right click the required loop, and click New
> Instrument.
4. On the New Tag Number dialog box, do the following:
a. From the Tag class list, select the desired tag class according to whether you
want to create a conventional, Foundation Fieldbus, HART instrument, soft
tags, Telecom tag, and so forth.
b. Type the name of the new tag. For details on instrument tag naming
conventions see Instrument Tag Naming Convention, page 388.
5. Click OK.

6. If the Select Instrument Type dialog box opens (because there is more than one
record for a given instrument type acronym), select the required instrument type
and click OK.
Tips
• If the tag name does not correspond to an existing loop name, you are
prompted to enter a loop name based on the tag you have entered. If
the loop identifier already matches an existing loop, then the new tag
name will automatically be associated with the loop.
• If the loop convention includes the loop function parameter, the
prompt will always appear. In this case, you have to complete the loop
name. If a profile exists for the selected instrument type, any new tags
for that instrument type will be created with the selected default
settings.
7. On the Loop Name dialog box, do one of the following:
• Type the loop number that the new tag is to be associated with.
• Accept the displayed loop number.
• Click Cancel to create the tag number without a loop association.
8. Click OK.
9. On the Loop Number Properties dialog box, accept the loop number properties
or modify them as required and then click OK.
Tip
• The Loop Number Properties dialog box only opens if the tag
number is associated with a loop number.
10. On the Tag Properties dialog box enter the properties as required, and click OK.
For details on entering power supply data (not available if the selected Tag Class
is electrical), see Enter Power Supply Data for Panels and Instrument Tags, page
390
Notes
• You can also create a new instrument tag in the Instrument Index module.
For more details, see Create an Instrument Tag in the Instrument Index
Module, page 387.
• When creating a new tag, you can determine whether or not process data is
required for it, and if so, at what stage the information should be entered
by a process engineer.
Related Topics
• Create an Instrument Tag in the Instrument Index Module, page 387

Create an Instrument Tag in the Instrument Index Module

1. To start the Instrument Index module do one of the following:
• Click .
• Click Edit > Tag Numbers > New Tag Number.
• Click
want to create, a conventional, Foundation Fieldbus, HART instrument, soft
tags, Telecom tag, and so forth.
b. Type the name of the new instrument tag. For details on instrument tag
naming conventions, see Instrument Tag Naming Convention, page 388.
4. Click OK.
and click OK.
Tips
• If the instrument tag name does not correspond to an existing loop
name, you are prompted to enter a loop name based on the instrument
tag name you have entered. If the loop identifier already matches an
existing loop, then the new tag name will automatically be associated
with the loop.
number. If a profile exists for the selected instrument type, any new
tags for that instrument type will be created with the selected default
settings.
• Type the loop number that the new tag is to be associated with.
• Click Cancel to create the tag name without a loop association.
7. Click OK.

or modify them as required and then click OK.
Tip
• The Loop Number Properties dialog box only opens if the tag
number is associated with a loop number.
9. On the Tag Properties dialog box enter the properties as required and click OK.
For details on entering power supply data (not available if the selected Tag Class
is electrical), see Enter Power Supply Data for Panels and Instrument Tags, page
390.
Notes
• You can also create a new instrument tag in the Domain Explorer without
opening the Instrument Index module. For more details, see Create an
Instrument in the Domain Explorer, page 385.
• When creating a new instrument tag, you can determine whether or not
process data is required for it, and if so, at what stage the information
should be entered by a process engineer.
Instrument Tag Naming Convention

The data field displays the instrument tag name template which is based on the tag
naming convention defined by the Domain Administrator for the current <unit>. In
the alphanumeric and the numeric parts of the name, you can type any character
(letters, digits, spaces, and so forth). You can customize the tag name template to set
a default, but only the Domain Administrator can change the naming conventions.
For more details see Customize Tag Name, page 389
Example: 101- FE – 2225/E
Segment Description
100 Prefix derived from the tag naming convention defined by the Domain
Administrator
FE Measured variable
2225 Loop number that the tag is associated with
E Suffix
Note
• Though the naming conventions do not apply to tags classed as electrical,
you can not create an electrical tag until the naming convention for
conventional instruments has been defined.

Customize Tag Name

These options allow you to customize the default tag number name template that
appears in the New Tag Number dialog box.
Define new tag name template – These options determine how SmartPlant
Instrumentation displays new tag number names in the New Tag Number dialog box
in relation to the previously created tag number. The options are:
• No default – The data field in the New Tag Number dialog box will not
display any default tag, letting you enter the number you need.
• Same as the last created tag – The data field in the New Tag Number
dialog box displays the last created tag. You can accept the displayed
number, modify it, or enter the number you need.
• Same as the last created tag + 1 – The data field in the New Tag
Number dialog box displays the last created tag plus 1 (one). You can
accept the displayed number, modify it, or enter the number you need.
This option is available for numeric tag names only. If your tag number
names are not numeric, the data field in the New Tag Number dialog box
will display the last created tag.
Ignore loop creation when creating new virtual tag – Allows you to create a
virtual tag without being prompted to create a loop associated with the new virtual
tag.
Use loop suffix in tag number name – Allows you to include the loop suffix in the
name of a newly-created tag number.
Related Topics
• Instrument Tag Naming Convention, page 388


1. Do one of the following to open the Properties dialog box of a panel or tag
number:
• In the Domain Explorer or Reference Explorer, right-click a desired
panel and then click Properties.
instrument and then click Properties.
2. On the General tab, select the Requires power supply check box.
3. Click the Power Supply tab.
4. Under Criticality, select the criticality, which is used in SmartPlant Electrical to
determine whether the current instrument requires UPS power or regular power.
5. Under Rated voltage, select a value that indicates the voltage at which the
instrument is designed to operate.
6. If the instrument is running on alternating current, under Power supply type click
AC and do the following:
a. Under Frequency, select the operating frequency of the instrument.
b. Under Number of phases, select the number of phases in the power supply to
the instrument.
c. Under Power factor full load, enter a value between 0 and 1 for the ratio of
active to apparent power at 100% of the rated power.
7. If the instrument runs on direct current, under Power supply type, click DC.
8. Under Rated active load, type the full load power consumption in kilowatts.
9. Type the following values in amperes:
a. Full load current.
b. Starting current.

10. In the Coincidence factors group box, do one of the following:

• Under Operating mode, select Continuous, and under X –
continuous, type a value between 0 and 1.
• Under Operating mode, select Intermittent, and under Y –
intermittent, type a value between 0 and 1.
• Under Operating mode, select Spare, and under ZZ – spare, type a
value between 0 and 1
• Under Operating mode, select Standby, and under Z – stand by,
type a value between 0 and 1.
Note
• The fields under Power distribution board data group box display data
that is determined within SmartPlant Electrical. On the Power Supply
tab, click Help for more information.
Related Topics
• Conventional Panels: An Overview, page 490
• Create an Instrument in the Domain Explorer, page 385
• Duplicate an Instrument Tag in the Domain Explorer, page 394
• Duplicate an Instrument Tag in the Instrument Index, page 395
• Edit an Instrument Tag from the Domain Explorer, page 392
• Managing Conventional Panels Common Tasks, page 491

Edit an Instrument Tag from the Domain Explorer

Instruments folder.
2. Double-click the Instruments folder to display the existing tag numbers.
3. Right-click on the required tag, and from the shortcut menu select Properties .
4. On the Tag Properties dialog box enter the properties as required. For details on
entering power supply data (not available if the selected Tag Class is electrical),
5. Click OK.
Notes
• Editing the properties of an existing tag does not affect its existing
association with a loop. For more details, see Change an Instrument Tag
Loop Association in the Domain Explorer, page 410
• The data that appears in the Prefix, Number, and Suffix fields is derived
from the tag number itself.
• You can also edit the properties of an instrument tag from the Instrument
Index module.
Related Topics

Enter an Instrument Tag Remark

1. On the main menu bar, click .
2. On the Browser Manager window, expand the Instrument Index on the
Browser Groups pane and select Instrument Index Standard Browser group.
3. Ensure that the Rem. column is selected for displaying in the browser view by
doing the following:
a. Expand the Instrument Index Standard Browser group, and click .
b. Under Style settings, click Edit.
c. Scroll down the Data Field Header column to the Rem. field header and
select the View check box.
d. Click Save.
e. Close the Browser Manager window.
4. Open the browser view, select the instrument tag that you require, and do one of
the following:
• Double-click the Rem. field.
• On the Actions menu, click Remarks.
• On the selected tag, Right-click and on the shortcut menu click Tag
Number Activities > Remarks.
5. On the Remarks dialog box, type the required text in the fields provided.
6. On the Notes box, type a short note if needed.
Tip
• The text that you type in the Notes box also appears in the Tag
Number Notes dialog box.
Note
• If necessary, define a custom browser view that you want to use for
displaying the remarks. For details, see Define a Standard Browser View
for the Instrument Index, page 437
Related Topics

Duplicate an Instrument Tag in the Domain Explorer

Instruments folder of the <unit> you are working on.
2. Double-click the Instruments folder to display the existing instrument tags.
3. Right-click the instrument tag you want to duplicate, and on the shortcut menu
click Duplicate.
4. Type the new instrument tag on the Duplicated Tag Number dialog box, and
then click OK.
5. If you want to duplicate the instrument tag in another <unit> of the same domain,
do the following:
a. Select the Create in another unit check box.
b. Click OK.
c. The Select Target <Unit> dialog box opens, select the target <unit> for the
new tag, and then, click OK.
6. On the Select Instrument Type dialog box, select the instrument you want to
associate with the current tag number, and then, click OK.
• Type the loop number that you want to associate the new instrument
tag with, click OK, and then on the Loop Properties dialog box, enter
the desired data and click OK.
• Click OK to accept the displayed loop number and then on the Loop
Properties dialog box, enter the desired data and click OK.
• Click Cancel not to associate the new instrument tag with any loop.
You can associate the new tag with a loop later. For more details, see
Change an Instrument Tag Loop Association in the Domain Explorer,
page 410.
8. On the Tag Properties dialog box enter the required data or select the appropriate
values from the lists. For details about entering power supply data (not applicable
to electrical tags), see Enter Power Supply Data for Panels and Instrument Tags,
page 390.
9. Click OK.
Note
• You can also duplicate an instrument tag from the Instrument Index
module. For more details, see Duplicate an Instrument Tag in the
Instrument Index, page 395.
Related Topics

Duplicate an Instrument Tag in the Instrument Index

• Click .
• Click Edit > Tag Numbers > Duplicate Tag Number.
2. On the Enter Tag Number dialog box, type the instrument tag number you want
to duplicate, and then click OK.
3. To find a tag that you want to duplicate do the following:
a. On the Enter Tag Number dialog box, click Find.
b. On the Find Tag dialog box, click Find.
c. Select the instrument tag you want to duplicate, and then click OK.
4. Type the new instrument tag on the Duplicated Tag Number dialog box, and
then click OK.
5. If you want to duplicate the instrument tag in another <unit> of the same domain,
do the following:
a. Select the Create in another unit check box.
b. Click OK.
c. On the Select Target <Unit> dialog box, select the target <unit> for the new
tag and then click OK.
6. On the Select Instrument Type dialog box, select the instrument type you want
to associate with the current tag number, and then, click OK.
7. On the Loop Name dialog box, and do one of the following:
• Type the loop number that you want to associate the new instrument
tag with, and click OK.
• On the Loop Properties dialog box, type the desired data and click
OK.
• Click OK, to accept the displayed loop number.
• Click Cancel, not to associate the new instrument tag with any loop.
You can associate the new tag with a loop later.

8. On the Tag Properties dialog box enter the desired data or select appropriate
values from the lists. For details on entering power supply data (not applicable
for electrical tags), see Enter Power Supply Data for Panels and Instrument Tags,
page 390.
9. Click OK.
Note
• You can also duplicate an instrument tag from the Domain Explorer. For
more details, see Duplicate an Instrument Tag in the Domain Explorer,
page 394
Related Topics
Delete Instrument Tags

1. In the Domain Explorer, click the Instruments folder of the <unit> you are
working on.
2. On the Items pane, select the items you want to delete.
3. Right-click the selected items, and click Delete.
4. When prompted, click Yes to confirm deletion.
Related Topics
Delete Instrument Tags in the Instrument Index Module

1. On the Instrument Index module menu bar, click Edit > Tag Numbers > Delete
Tag Numbers.
to delete, or click Find to select one or more instrument tags.
3. On the Find Tag dialog box ,click Find and select the instrument tags you want
to delete.
4. Click OK.
Related Topics

Delete Instrument Tags in the Browse Window

1. On the Instrument Index module, open the Instrument Index Standard Browser
view by doing one of the following:
• Click Actions > Browse Index.
• Click
2. On the Browser View window, select the instrument tags you want to delete.
• Right-click the selected Instrument tags, and on the shortcut menu
click Tag Number Activities > Delete Tag number.
•On the menu bar click Actions > Delete Tag Number.
Related Topics
Move an Instrument Tag to Another Plant Group

1. On the Instrument Index module menu bar, click Edit > Tag Numbers > Move
Tag Number.
to duplicate, and then click OK.
3. To find a tag that you want to duplicate do the following:
a. On the Enter Tag Number dialog box, click Find.
b. On the Find Tag dialog box, click Find.
c. Select the instrument tag you want to duplicate, and than click OK.
4. On the Select Target dialog box, select the <unit> to which you want to move
the current tag.
5. Click OK.
Note
• If you move an instrument tag to a target <unit> whose tag naming
conventions are different from the naming conventions of the <unit>
where the source tag is, the software applies the target <unit> naming
conventions to the duplicated tag number.
Related Topics

Move Multiple Instrument Tags in the Browser Window

1. Open the Instrument Index module, by doing one of the following:
• Click
2. Open an Instrument Index Standard Browser view, by doing one of the following:
• Click
3. Select the instrument tags you want to move.
• Click Actions > Move Tag Number.
• Right-click the selected tags, and from the shortcut menu click Tag
Number Activities > Move tag Number.
5. On the Select Target <Unit> dialog box, select the <unit> you want to move the
instrument tags to.
6. Click OK.
Note
• If you move an instrument tag to a target <unit> whose tag naming
conventions are different from the naming conventions of the <unit>
where the source tag is, the software applies the target <unit> naming
conventions to the duplicated tag number.
Related Topics
Rename an Instrument Tag

1. From the Instrument index module, do one of the following:
• Click Edit > Tag Numbers > Tag Number Properties.
• Click
2. On the Enter Tag Number dialog box, do one of the following:
• Type the tag number you want to rename.
• Click Find, to open the Find Tag dialog box. In the Find Tag dialog
box, click Find and select the tags you want to rename.
3. If needed, on the Tag Number Properties dialog box, change the instrument type
of the tag you want to rename.

4. Next to the Number field, Click .

5. On the Rename Tag Number dialog box, change the tag class, edit the tag
instrument type, number, or suffix as required.
6. Click OK.
7. If the instrument type acronym is not unique, select the required instrument type
from the Select Instrument Type dialog box and click OK to open the Tag
Number Renaming Options dialog box.
8. If you want to rename the associated control system tags, do the following:
a. Select the Rename CS tag check box.
b. In the New Control System Tag data field, modify the control system tag
name as required.
c. Click OK.
9. Click OK, to close the properties dialog box.
Notes
• If you have connected several CS tags to the current tag number, the
system automatically assigns the same new name to all the CS tags. You
must rename the new CS tags manually to make the names unique.
• Before clicking OK, note that all the wiring items that were associated
with the old CS tag will be renamed according to the new control system
tag name, and the associated specification will be deleted. Verify whether
the appropriate loop blocks and hook-ups are associated with the new tag
number.
• Make sure that the new name complies with the naming conventions for
the current <unit> (naming conventions do not apply to tags classed as
electrical). For more details, see Instrument Tag Naming Convention,
page 388
• For more information about instrument tag renaming options, see
Instrument Tag Renaming Options, page 400
Related Topics

Instrument Tag Renaming Options

1. When you rename a tag, two situations are possible for changing the process
function and the instrument type of that tag:
• The Process Function has not changed— for example: renaming
108-PT-2212 to 108-PI-2212. Renaming a tag number this way does
not change the process which the tag describes. Therefore, all the
process data information that has been associated with the old tag will
be automatically associated with the new tag. You can also delete the
old process data if required.
• The Process Function has changed— for example: renaming 108-
PT-2212 to 108-FT-2212. If you rename a tag number this way, only
general process data properties, such as pressure, temperature, and
density will be propagated from the old tag number to the new one.
Process data properties specifically associated with the tag's process
function, for example, range, alarm trip settings, upper level, and so
forth, will either not be propagated to the renamed tag or only be
propagated partially. In this case, the old tag's additional properties
and calculation results will not propagate to the new tag either.
Related Topics
• Customize Tag Name, page 389
• Instrument Tag Naming Convention, page 388
• Rename an Instrument Tag, page 398
Changing the Measured Variable

You can change the measured variable of the new loop number or keep it the same as
the source one. New tag numbers associated with the new loop number will be
affected accordingly, that is, the measured variable of the new tag numbers will
change if the measured variable of the new duplicated loop is changed. For example,
if you are duplicating Loop 101-F-102 and you change the measured variable of the
new loop to T, the new tag numbers associated with the new loop number will take a
new instrument type in accordance with the new measured variable: source Tag
Number 101-FE-102 will change to 101-TE-102.

Change an Instrument Type

1. Open the Tag Number Properties dialog box.
2. On the Tag Number Properties dialog box, do one of the following:
• From the Instrument type list, select the instrument type that you
require.
• Click to open the Instrument Type dialog box, where you can
modify the existing instrument types or add a new instrument type to
the list.
3. On the Tag Number Properties dialog box, click Apply.
Tip
• Instead of clicking Apply, you can click Rename to rename the
current tag number as required.
4. If the selected instrument type belongs to a different process function, in the Tag
Number Renaming Options dialog box do one of the following:
• Select Keep general process data to delete only specific process data
associated with the tag whose instrument type you are changing.
• Select Delete process data to delete all the process data associated
with the tag whose instrument type you are changing.
5. If you want to rename the associated control system tags, do the following:
a. Select the Rename CS tag check box.
b. On the New Control System Tag data field, modify the control system tag
name as required.
c. Click OK, to return to the Tag Number Properties dialog box.
Notes
• If you have connected several CS tags to the current tag number, the
system automatically assigns the same new name to all the CS tags. You
must rename the new CS tags manually to make the names unique.
with the old CS tag will be renamed according to the new control system
tag name, and the associated specification will be deleted. Verify whether
the appropriate loop blocks and hook-ups are associated with the new tag
number.
Related Topics

Associating Tag Category and Criticality

You can associate a selected instrument with several tag categories and one
instrument criticality. You can also associate instruments that require preventive
maintenance with either Process Safety Systems or Quality Systems. For example, if
an instrument is used for custody purposes, it can be defined as a Quality System.
Related Topics
Add and Edit Criticality Values

1. To open the Criticality Values dialog box, do one of the following:
• On the Instrument Index Module window menu bar, click Tables >
Instrument Criticality.
• On the Instrument Index Standard Browser view, right-click a tag
number and on the shortcut menu, click Tag Number Activities >
Associate Categories and Criticality. Then, in the Associate
Categories and Criticality dialog box, click beside the Criticality
list arrow.
2. In the Instrument Criticality dialog box, do one of the following:
• Click New to append a new row to list of existing options and type a
criticality name and description.
• Highlight a row and edit the Criticality and Description fields.
• Highlight a row and click Delete to delete this criticality option.
3. Click OK to save the settings and close the dialog box.
Notes
• If the criticality list is long, start typing a criticality name in the Find
criticality box. In the data window, SmartPlant Instrumentation
highlights the required name as you type.
• After you delete a row, the criticality dissociates from all tags for which it
was defined. The criticality option will no longer be available in the
Associate Categories dialog box.
Related Topics

Add and Edit Instrument Tag Categories

2. Click Actions > Tag Categories.
3. Click New to add a new tag category row.
4. Type the desired tag category name and description.
5. To edit an existing tag category, double-click a field and type the new value.
6. To delete an existing tag category:
a. Select a tag category in the data window.
b. Click Delete to delete the highlighted category.
c. When prompted, click Yes to confirm the deletion, or click No to keep the
selected category.
7. Click OK to save the changes you made to the tag categories.
Related Topics

Associate Tag Category and Criticality

2. In the browser view, right-click an instrument, and on the shortcut menu, click
Tag Number Activities > Associate Categories and Criticality.
Tip
• You must select a single tag (not multiple tags) to associate tag
categories and criticality.
3. To associate the desired categories with the selected tag, do one of the following:
• Drag a category from the Unassociated Categories pane to the
Associated Categories pane.
• Select a category under the Unassociated Categories pane and click
.
Tip
• You can associate the selected tag number with as many categories as
you desire. For details of how to add new categories, see Add and Edit
Instrument Tag Categories, page 403.
4. From the Criticality list, select a value to associate the current instrument with a
criticality setting.
5. Select the Quality System (ISO) check box to associate the currently selected tag
with an ISO quality system.
Related Topics
Generate a Process Data Sheet in a Browser Window

1. In the browser view, select the tag numbers that you require.
• Right-click, and on the shortcut menu, click Generate Process Data
Sheet.
• Click, Actions > Generate Process Data Sheet.
3. In the Results dialog box, view the process data sheet creation results, and then
click Close.
Related Topics

Incorporating Soft Tags Within an Enhanced

Reports Loop Drawing
The Enhanced Reports utility allows you to generate loop drawings for loops that
include soft tags. For example, a loop that contains an air-conditioning system with
temperature gauges, lines, engines, compressors, and so forth. The temperature
gauges send signals to a DCS panel and from there to a computer. A software code
that functions as a thermostat, interprets the signal and sends a command to start the
engine. The compressor, connected to the engine, compresses more gas through the
lines to lower the room temperature (closed loop).
To generate an Enhanced Reports utility drawing that includes a soft tag you need to
create a symbol representing the tag using the Symbol Editor. Then you associate the
symbol with the tag in SmartPlant instrumentation, associate the tag with a loop and
generate the appropriate drawing.

Flow of Activities for Managing Soft Tags

The following flow of activities allows you to create soft tags their related instrument
type, associate soft tags with loops, generate a loop drawing in Enhanced Reports
utility, and edit the drawing to display the soft tags properly.
1. In the Domain Explorer, create a new loop or select an existing one, see Create a
New Individual Loop Number.
2. In the Symbol Editor create a symbol with a macro. For details, see Create a
Custom Symbol and Add a Macro to a Symbol in the Symbol Editor help. You
will later associate this symbol with a soft tag.
3. Define a new instrument type for soft tags, see Define Instrument Type. For
example, ST for soft tag.
4. Create a new soft tag. See Create an Instrument in the Domain Explorer.
5. Set the new soft tag instrument type to ST , see Instrument Type Common Tasks
6. To associate the custom symbol with the soft tag do one of the following:
• Associate the custom symbol with the tag instrument type, see Set a
Default ESL Drawing Symbol For an Instrument Type
• Associate a custom symbol with the specific soft tag.
7. Set the loop generation method to Custom By Loop or Custom by Signal to
allow the software to use custom symbols when generating an Enhanced Reports
utility drawing, see Loop Drawing Generation Method
8. Generate an Enhanced Reports utility drawing for this loop, see Generate a Report
Using the Domain Explorer
9. In the Enhanced Reports utility environment, press F7 to open the Domain
explorer.
10. Find the loop in the Domain Explorer, see Find an Item in the Domain Explorer.
11. Drag the Soft tag from the Domain explorer to the drawing. The selected tag can
also be from a different loop.
Tip
• The software automatically saves the position of the tag after you
place it.
12. Connect the soft tag to a conventional loop tag, see Attach Redlining to Drawing
Items.
13. Click File > Save Custom Changes.
Related Topics

Associating Instrument Tags with Loop Numbers: An Overview
Associating Instrument Tags with Loop

Numbers: An Overview
This section shows you how to associate instrument tags to loops. There are several
different ways that you can associate an instrument tag with a loop. You can select a
particular loop number and make a batch instrument tag association or dissociate any
tags from the selected loop as needed. Another way is to select an instrument tag and
change its loop association if it exists. You can also create a new loop with which
you want to associate a selected instrument tag and associate it with this loop on the
fly.
Related Topics
• Associating Instrument Tags with Loop Numbers Common Tasks, page
408

Associating Instrument Tags with Loop Numbers

Common Tasks
The following tasks are used frequently when you create and manage the loop
numbers in your plant.
Associate Multiple Tag Numbers with a Loop

This option shows you how to select an existing loop number and associate it with the
required instrument tag. You make the association using the Associate Tag Number
dialog box which displays the selected loop numbers and all the tags that are already
associated with it. You can also associate numerous instrument tags with the selected
loop. For more information, see Associate Multiple Tag Numbers with a Loop, page
409.
Change an Instrument Tag Loop Association in the Domain Explorer

This option shows you how to move a selected instrument tag that is associated with a
specific loop number to another existing loop number. You change this association
when editing an instrument tag. For more information, see Change an Instrument
Tag Loop Association in the Domain Explorer, page 410.
Change Instrument Tag Loop Associations in the Instrument Index

Standard Browser View
This option shows you how to move multiple instrument tags that are associated with
a specific loop number to another existing loop number. You change this association
when editing an instrument tag. For more information, see Change Instrument Tag
Loop Associations in the Instrument Index Standard Browser View, page 411.
Associate an Instrument Tag with a New Loop

This option shows you how to create a new loop number on the fly while editing an
instrument tag. You can then move the current instrument tag and associate it with
the new loop you created. For more information, see Associate an Instrument Tag
with a New Loop, page 410.
Dissociate an Instrument Tag from Loops

This option shows you how to dissociate instrument tags from a selected loop.

Associate Multiple Tag Numbers with a Loop

1. Start the Instrument Index module.
• Click Actions > Associate.
• Click .
• Type the name of the required loop number on the Enter Loop
Number data field, and click OK.
• Click Find, to open the Find Loop dialog box. Search for a desired
loop, select it, and then click OK.
4. On the Associate Tag Number dialog box, click Find to open the Find Tag
dialog box.
5. On the Find Tag dialog box, click Find and select the tag numbers that you want
to associate with the current loop.
6. Click OK.
7. On the Associate Tag Number dialog box, under Available tag numbers, select
a tag number and click Associate. Repeat this step for every tag number that you
want to associate with the current loop.
8. Click OK, to make the association.
Related Topics
408

Associate an Instrument Tag with a New Loop

Instruments folder.
3. Right-click on the required tag, and from the shortcut menu select Properties.
4. On the Tag Number Properties dialog box, click New Loop.
5. On the New Loop Number dialog box, type the new loop number and click OK.
6. Edit the properties of the new loop number on the New Loop Number dialog box
and click OK.
7. On the Tag Number Properties dialog box, click Associate.
8. On the Find Loop dialog box, type the required search parameters as needed and
click Find.
9. Select the loop you have just created in the Search results data window and click
OK.
Related Topics
408
Change an Instrument Tag Loop Association in the Domain

Explorer
Instruments folder.
3. Right-click on the required tag, and from the shortcut menu select Properties.
4. On the Tag Number Properties dialog box, click Associate.
5. On the Find Loop dialog box, type the required search parameters as needed and
click Find.
6. Select the loop you require in the Search results data window and click OK.
Related Topics
408

Change Instrument Tag Loop Associations in the

Instrument Index Standard Browser View
1. To start the Instrument Index module do one of the following:
• Click .
• Click .
• Click Edit > Tag Numbers > Tag Number Properties.
• To choose a single tag, type the tag number in the box.
• To choose multiple tags, click Find to open the Find Tag dialog box,
and then click and select the desired tags.
4. Click OK, to open the Tag Number Properties box.
5. Click Associate.
6. On the Find Loop dialog box, type the desired search parameters as needed and
click Find.
7. Select the loop you require in the Search results data window and click OK.
8. If you chose one instrument tag, on the Tag Number Properties dialog box, click
OK.
9. If you chose more than one instrument tag, on the Tag Number Properties
dialog box:
a. Click Apply to save the changes.
b. Click Next to find the next tag.
c. Click Associate to associate a tag with a loop.
d. Click OK to finish.
Related Topics
408

Working with Typical Loops and Tags: An Overview
Working with Typical Loops and Tags: An

Overview
A typical loop is a combination of user-defined loop properties that you can use as a
template for creating loops and tags in batch mode. These properties include a loop
measured variable, loop type, loop function and so forth. This template must contain
at least one typical tag.
A typical tag is a virtual tag that is used for the creation of instrument tag numbers in
your plant. Each typical tag must be associated with a specific instrument type and
description. Furthermore, you can set instrument tag number properties for a virtual
tag. For example, you can define service, location, I/O type, and so forth. You must
define at least one typical tag for each typical loop you create.
You can create as many typical loops as required and use them to create loops in
batch mode. Typical loops with associated typical tags can be very useful when you
need to create numerous loops based on the same loop template.
You can view all the typical loops you have created in the current domain. The list of
typical loops is automatically updated after you create a new typical loop, or if you
edit or duplicate existing loops.
Related Topics
• Typical Loops and Tags Common Tasks, page 413

Typical Loops and Tags Common Tasks

The following tasks are used frequently when you create and manage typical loops
and tags in your plant.
Create a Typical Loop

This procedure shows you how to create a new typical loop and the associated tag.
Typical loops with associated typical tags can be very useful when you need to create
numerous loops based on the same loop template.
Creating a new typical loop is the first stage in batch loop creation procedure. This is
when you make all the required typical loop definitions including the typical loop
name, measured variable, and so forth. At this stage, you also select the appropriate
instrument types for the typical tags you associate with this typical loop.
For more information, see Create a Typical Loop, page 415.
Duplicate a Typical Loop

This option enables you to duplicate an existing typical loop.
Duplicating a typical loop involves defining a new typical loop name and new typical
tag names to ensure name uniqueness.
For more information, see Duplicate a Typical Loop, page 417.
Batch Loop Creation from Typical Loops

This option shows you how to create numerous loop numbers based on existing
typical loops. SmartPlant Instrumentation creates these loop numbers in batch mode.
The software also lets you verify that the data you selected and entered will not stop
the loop creation process. When creating numerous loop numbers based on existing
typical loops, the software also creates new tag numbers and associates them with the
newly created loops. The software creates these tag numbers according to your
settings on the Duplicate page of the Preferences dialog box.
For more information, see Batch Loop Creation from Typical Loops, page 419.

Verify New Loop Numbers

This option shows you how to verify new loop numbers that you want to create from
typical loop numbers in batch mode, are correct and will not cause problems during
there creation.
When creating numerous loops and tag numbers from typical loops in batch mode,
some data problems might cut short the creation process. If, during batch loop
creation, SmartPlant Instrumentation encounters a data problem with one loop, the
creation process cannot proceed with the rest of the typical loops. To avoid this
problem, SmartPlant Instrumentation helps you verify that you selected and entered
data that will not stop the creation process.
SmartPlant Instrumentation verifies the following:
• Loop number uniqueness.

• Loop and instrument naming conventions.
• Loops and tags reserved for other projects.
The verification procedure takes much less time than the actual creation; therefore,
you should do it before you start creating new loops and tag numbers.
For more information, see Verify New Loop Numbers, page 420.
Edit a Typical Loop

This option enables you to edit the properties of an existing typical loop. You can
modify the existing typical loop properties and associate new typical tags with the
current loop.
For more information, see Edit a Typical Loop, page 421.
Delete a Typical Loop

This option shows you how to delete the required typical loop with or without the
associated typical tags.
For more information, see Delete a Typical Loop, page 422.

Edit a Typical Tag

This option shows you how to edit the properties of an existing typical tag, including
renaming a typical tag if needed. You might want to edit the properties of the typical
tags if you plan to perform batch loop creation according to specific tag data you
define in the Typical Tag Number Properties dialog box. Depending on your
preference options, when creating loops in batch mode, the software creates
conventional tag numbers using the profile data of the source instrument type, or
creates typical tags using specific source tag data you define in the Typical Tag
For more information, see Edit a Typical Tag, page 422.
Edit a Typical Tag in a Browser View

Use the following procedure to edit the properties of one or more typical tags in an
Instrument Index Standard Browser view. You can select typical tags, edit the
properties of each typical tag separately and associate these typical tags with other
existing typical loops.
For more information, see Edit a Typical Tag in a Browser View, page 423.
Related Topics
Create a Typical Loop

2. On the Instrument Index menu bar, click Edit > Typical Loop Management.
3. On the Typical Loop Management dialog box, click New.
4. On the Typical Loop Properties (New) dialog box, in the Loop name field, type
a unique name for the new typical loop.
5. In the Loop service field, type an appropriate loop service if needed.
6. In the Loop suffix field, type a suffix if required.
Tip
• Use a suffix if you want to have numerous typical loops with the same
names. This is useful when you have numerous typical loops that
perform the same or similar function.
7. From the Measured variable list, select the required measured variable for the
new typical loop. If the required value is not available, click next to the list
arrow to open the Loop Measured Variables dialog box where you can add a
new loop process variable identifier or edit an existing one.

8. From the Loop type list, select the required loop type for the new typical loop. If
the required value is not available, click next to the list arrow to open the Loop
Types dialog box where you can add a new loop type or edit an existing one.
9. From the Loop function list, select the required loop function for the new typical
loop. If the required value is not available, click next to the list arrow to open
the Loop Functions dialog box where you can add a new loop function identifier
or edit an existing one.
10. In the Note field, type a short note if needed.
11. Select the Apply service to tags check box, to propagate the loop service you
entered for this typical loop to all typical tags that are associated with it.
12. Click Add, to append a new typical tag row in the Associated typical tags data
window.
13. In the data window, do the following:
a. From the Instrument Type list, select the instrument type that you require.
b. In the Number field, type the required typical tag number.
c. In the Suffix field, enter the required typical tag suffix to ensure tag name
uniqueness.
14. Click Add, to add as many typical tags as required, and then click OK, to create
the typical loop with the associated tags.
Tip
• On clicking OK, you are prompted to edit the newly-created typical
tag.
Notes
• Typical tags do not have any profile data associated with the instrument
type that you specify for typical tags. However, if you set your
preferences for tag creation to the profile options, the SmartPlant
Instrumentation creates the new tag numbers based on the instrument type
profiles defined for the typical tags that are associated with the current
typical loop.
• Make sure that you define the instrument type profiles prior to creating a
typical loop.
• SmartPlant instrumentation allows you to select only those instrument
types that belong to the conventional tag class.
• Ensure that the typical tag naming conventions comply with the required
naming convention rules. For more details, see Typical Tag Naming
Conventions, page 424.
• The New Tag Name field automatically displays the name of the new
typical tag after defining the typical tag instrument type, number, and
suffix.

Duplicate a Typical Loop

2. Click Edit > Typical Loop Management.
3. Select a typical loop to duplicate.
4. On the Typical Loop Management dialog box, click Duplicate.
Tip
• The changes you make to the source typical loop affect the properties
of the target typical loop only.
5. In the Loop name field, type a unique name for the new typical loop.
6. In the Loop service field, enter an appropriate loop service if required.
7. In the Loop suffix field, type a suffix if required.
Tip
• Use a suffix if you want to have numerous typical loops with the same
names. This is useful when you have numerous typical loops that
perform the same or similar function.
8. From the Measured variable list, select the required measured variable for the
new typical loop. If the required value is not available, click next to the list
arrow to open the Loop Measured Variables dialog box where you can add a
new loop process variable identifier or edit an existing one.
9. From the Loop type list, select the required loop type for the new typical loop. If
the required value is not available, click next to the list arrow to open the Loop
Types dialog box where you can add a new loop type or edit an existing one.
10. From the Loop function list, select the required loop function for the new typical
loop. If the required value is not available, click next to the list arrow to open
the Loop Functions dialog box where you can add a new loop function identifier
or edit an existing one.
11. In the Note field, type a short note if needed.
12. Select the Apply service to tags check box, to propagate the loop service you
entered for this typical loop to all typical tags that are associated with it.
13. Click Add, to append a new typical tag row in the Associated typical tags data
window.

14. On the data window, do the following:

a. From the Instrument Type list, select the instrument type that you require.
SmartPlant instrumentation retrieves profile data associated with this
instrument type and applies this data to new tag numbers only when
performing batch loop creation. For more details, see Batch Loop Creation
from Typical Loops, page 419.
b. On the Number field, type the required typical tag number.
c. On the Suffix field, enter the required typical tag suffix to ensure tag name
uniqueness.
15. Click Add, to add as many typical tags as required, and then click OK, to create
the typical loop with the associated tags.
Tip
• On clicking OK, you are prompted to edit the newly-created typical
tag.
Notes
suffix.
Related Topics

Batch Loop Creation from Typical Loops

2. Click Edit > Batch Loop Creation.
3. On the Batch Loop Creation dialog box, select an existing typical loop from the
Typical Loop list. SmartPlant Instrumentation will base the new loops on this
typical loop.
4. To find a typical loop from a long list of typical loops, do the following:
a. Click Find.
b. In the Find Typical Loop dialog box, enter the required search parameters
and click Find.
c. Select the required typical loop in the Search results data window and than
click OK. The selected typical loop will automatically appear in the Typical
Loop field of the Batch Loop Creation dialog box.
5. In the New Loop Numbers field, enter the range of numbers for the new loops
that will be created based on the selected typical loop.
Tip
You can create as many loops based on the selected typical loop as you
require. To create more than one loop, simply enter the required new loop
number names in the New Loop Number field. You can enter a range of loop
names or a list as needed.
For noncontiguous alphanumeric or numeric loop numbers, type the loop

numbers with commas between them. For a range of numeric loop numbers,
type the range of loop numbers with a hyphen between them. For example, to
create loops 1000, 1001, 1002, 1003, 1057, FT10, F11,and F12 type: 1000-
1003, 1057, FT10, F11, F12.
6. Click Add to add a new data row to create another set of loops. You can add as
many sets of loops as you require for batch creation.
Tip
• You should verify the correctness of the data if you are creating a large
number of loops. The creation process may stop if SmartPlant
Instrumentation encounters a problem with one of the loops. To avoid
this situation, click Verify to correct some possible data problems
before you proceed with loop creation. For more details, see Verify
New Loop Numbers, page 420.

7. Click Create to start the loop creation.

Tip
• If for some reason the loop creation process fails, the software displays
an appropriate message informing you that a particular set in a
specified row has not been created. Moreover, the Done check box for
that row remains cleared.
8. Click Close.
Note
• To avoid duplicate loop numbers in your <plant>, check which tag
number numeric segments are available before starting batch loop
creation. For more details, see Create a List of Available Tags, page 454.
Related Topics
• Duplicate a Typical Loop, page 417
Verify New Loop Numbers

1. In the Batch Loop Creation dialog box, select the required typical loops and
enter the new loop numbers in the Loop creation set data window. For more
details, see Batch Loop Creation from Typical Loops, page 419.
2. Click Verify.
3. If a data problem is encountered, follow the instructions given by the software to
correct the problem.
Related Topics

Edit a Typical Loop

2. On the Typical Loop Management dialog box, select the required typical loop
and click Properties.
3. On the Typical Loop Properties dialog box, edit the fields as needed.
Important
• The Loop name and the Measured variable fields are required fields.
4. On the Associated typical tags data window, select an existing typical tag that
has been already associated with the current loop and do one of the following:
• Click Properties to open the Typical Tag Number Properties dialog
box to edit the typical tag properties. For more details, see Edit a
Typical Tag, page 422.
• Click Delete to delete the selected tag.
5. Click Add to append a typical tag row in the Associated typical tags data
window.
6. On the data window, do the following:
a. In the Instrument Type column, select the required instrument type from the
list. The selected instrument type serves as a typical tag associated with the
current typical loop.
b. In the Number field, type the required typical tag number.
c. In the Suffix field, type the required typical tag suffix to ensure tag name
uniqueness.
7. Add as many typical tags as required and click OK to associate the newly added
typical tags with the current loop.
Notes
suffix.
Related Topics

Delete a Typical Loop

2. On the Typical Loop Management dialog box, select the required typical loop
and click Delete.
3. On the Delete Typical Loop dialog box, review the typical loop properties and
click Delete.
4. If prompted, click Yes to delete the typical loop and associated tags. Click No to
delete the typical loop only.
5. On the Typical Loop Management dialog box, click Close.
Related Topics
Edit a Typical Tag

• Click Edit > Tag Numbers > Tag Numbers Properties.
• Click .
3. On the Enter Tag Number dialog box, Click Find to open the Find Tag dialog
box.
4. On the Find Tag dialog box, from the Tag class list select Typical, enter the
required search parameters if needed and click Find.
5. In the Search results data window, select the typical tag that you want to edit and
click OK.
6. In the Typical Tag Number Properties dialog box, modify the typical tag
properties as you require.
7. Click OK.
Note
• You can also edit a typical tag when editing a typical loop. For more
details, see Edit a Typical Loop, page 421.
Related Topics

Edit a Typical Tag in a Browser View

1. Open the Browser Manager by doing one of the following:
• From an Instrument Index Standard Browser view, click .

• On the main SmartPlant Instrumentation toolbar, click .
• On the SmartPlant Instrumentation menu, click File > Browser
Manager.
2. Select the browser (Instrument Index Standard Browser or a PowerSoft
Browser that supports tag number data, if available) that has the default view that
you want to open.
3. Select the appropriate browser view.
4. Click Edit.
5. On the View profile display, from the Display data at level list, select Typical.
6. Click Save.
7. Open the browser view and use the Shift or Ctrl key to select the typical tags that
you require.
• On the menu, click Edit > Properties.
• Click .
• Right-click the selected tag numbers, on the shortcut menu, click Tag
Number Activities > Properties.
9. In the Typical Tag Number Properties dialog box, edit the typical tag properties
as required.
10. Click Apply > Next, to edit the next selected tag.
11. Click OK.
Related Topics

Typical Tag Naming Conventions

You can use any naming convention for your typical tags as long as it contains the
typical tag number segment. The name segment of a typical tag can be the same
length or shorter than the name segment of a tag. You defined tag name segments in
the naming conventions for the current <unit>.
The naming conventions for typical tags are as follows:
• Instrument type — up to 4 characters in the name segment, (the typical

tag name segment is automatically truncated to 4 characters when the
instrument type name contains more than 4 characters).
• Typical tag number — up to 8 characters in the typical tag number
segment.
• Typical tag suffix — up to 3 characters in the typical tag suffix segment.
Example of a typical tag name: FT-FLOW_CTLR/2.
The naming convention for typical loops is as follows:
• Typical loop name — up to 50 characters. When using a loop suffix the

maximum loop name length is shortened to 48 characters. The typical
loop suffix can contain up to 3 characters. In addition, there must be a
slash (`/') separator between the number and the suffix.
Related Topics
• Create a Typical Loop, page 415
• Duplicate a Typical Loop, page 417
• Edit a Typical Loop, page 421

Managing Lines: An Overview

You can create, modify, and delete lines in the Instrument Index module. The Lines
dialog box holds all the line data in your <plant>. Lines are categorized according to
line types. You can create new line types and then add new lines to these types as
required. You can also change the type of an existing line if needed and copy line
data from a selected line to several target lines.
Related Topics
• Working with Lines Common Tasks, page 426

Working with Lines Common Tasks

The following tasks are used frequently when you create and manage lines in your
plant.
Create a New Line

This option shows you how to create a new line in the Instrument Index module. For
more information, see Create a New Line, page 427.
Edit Line Data

This option shows you how to edit the data of an existing line. Line data comprises
such properties as the line number, pipe material and standard, line size, its internal
diameter, and wall thickness. For more information, see Edit Line Data, page 427.
Create or Edit a Line Type

Line types are used for categorizing the lines in your <plant>. Each line must belong
to a particular line type, for example, Process or Utilities. You can create as many
line types as required and move the existing lines from one type to another. For more
information, see Create or Edit a Line Type, page 428.
Change Type of Line

This option shows you how to change the line type of an existing line. For more
information, see Change Type of Line, page 429.
Copy Line Data

You use this option to copy line process data from a selected line to one or more
target lines. For more information, see Copy Line Data, page 430.
Delete a Line
This option shows you how to delete a line that is no longer in use. Note that you
cannot delete a line that is associated with a tag number. For more information, see
Delete a Line, page 431.
Define or Modify Pipe Specifications

Pipe spec is a specification that defines various process conditions for a specific pipe.
You use this procedure to define a pipe spec to the Pipe Specs supporting table from
the Instrument Index module, or to modify properties of an existing pipe spec. For
more information, see Define or Modify Pipe Specifications, page 431.
Related Topics

Create a New Line

2. To open the Lines dialog box, do one of the following:
• On the Tables menu, click Lines.
• Open the Tag Number Properties dialog box, click next to the
Line list arrow.
3. On the Line type list, select the required line type.
Tip
• If the required line type does not exist, click next to the Line type
list arrow to open the Line Types and create a new line type. For
more details, see Create or Edit a Line Type, page 428.
4. Click New to open the Line Properties dialog box.
5. Define the line properties as you require and click OK.
Related Topics
Edit Line Data

Line list arrow.
3. From the Line type list, select the required line type or select the Show all line
types check box.
4. Select the required line in the data window.
5. Click Properties to open the Line Properties dialog box.
6. Define the line properties as you require and click OK.
Related Topics

Create or Edit a Line Type

Line list arrow.
3. Click next to the Line type list arrow.
4. In the Line Type dialog box, click New to append a new data line.
5. Type the line type name and description in the appropriate fields.
6. To modify a line type, highlight the required line type and click in the desired
field.
Tip
• To quickly find a line type in a long list of line types, type the line type
name in the Find Line Type box. SmartPlant Instrumentation will
automatically highlight the line type you are looking for.
Related Topics
• Change Type of Line, page 429
• Create a New Line, page 427

Change Type of Line

Line list arrow.
3. From the Line type list, select the required line type.
4. Select the required line in the data window.
5. Click Change Type.
6. In the Change Type dialog box, highlight the required line type and click OK.
Tip
• If the required line type does not exist, click Cancel to close the
Change Type dialog box, then click next to the Line type list
arrow, to create or modify a line type. For more details, see Create or
Edit a Line Type, page 428.
Related Topics
• Change Type of Line, page 429

Copy Line Data

Line list arrow.
3. From the Line type list, select the required line type.
4. Select the source line from which you want to copy process data.
5. Click Copy Line.
6. On the Copy Line Data dialog box, from the Line Type list, select the required
line type of the target line.
7. In the Target lines data window, highlight the target lines to which you want to
copy the source line data.
Tip
• You can use the filter facility to display only the required lines in the
Target lines data window.
8. Click OK to start the copying process.
Note
• You can also copy line process data while working in the Process Data
module. The Process Data module allows you to select a source line in the
Copy Line Data dialog box different from the one you highlighted in the
Lines dialog box.
Related Topics

Delete a Line
Line list arrow.
3. From the Line type list, select the required line type or select the Show all line
types check box.
4. Highlight the required line in the data window.
5. Click Delete.
Related Topics
Define or Modify Pipe Specifications

Line list arrow.
3. On the Lines dialog box, under Line type, select a line type, or click to create
a new line type.
4. Click New to open the Line Properties (New) dialog box.
5. Beside the Pipe spec list, click to open the Pipe Specs dialog box.
• To create a new pipe spec, click New and type entries in the Pipe Spec
and Description boxes.
• To edit an existing pipe spec, click a field in a highlighted row and
modify the existing entry as needed.
Related Topics

Edit Data: An Overview

You can edit the data fields in a browser view by either selecting one row or by
selecting multiple rows. The single-edit mode is useful when you need to edit one
row or a few rows. The multi-edit mode is a more powerful tool. In addition to being
able to edit multiple rows, you can also carry out certain editing operations that are
not available in the single-edit mode.
You can view, organize, and edit your instrument index data by opening an
Instrument Index Standard Browser view in the Browser module. You can also add a
PowerSoft browser that supports the display of tag data and define a view for it to use
with the Instrument Index module.
In the selected browser view, you can access numerous commands to manage your
instrument index data. You can edit the tag number properties in the multi-edit or
single-edit mode, create new loop and tag numbers, associate an instrument with a tag
category, associate and open external documents, generate process data sheets and
specifications for tags, and so forth.
Related Topics
• Edit and View Data Common Tasks, page 433

Edit and View Data Common Tasks

The following tasks are used frequently for viewing and editing data in your <plant>.
Define a Standard Browser View for the Instrument Index

This procedure shows you how to create and define a designated custom browser
view in the Instrument Index Standard Browser. When you view and edit tags from
the Instrument Index browser using a browser view the Browse command opens this
designated custom browser. For more information, see Define a Standard Browser
View for the Instrument Index, page 437.
Edit a Single Row

This option shows you how single-row editing allows you to modify the data for one
tag number at a time from a browser view. You edit the data by typing or selecting
values from the available lists. You can also use the buffer to copy data from one row
and then paste in multiple rows as needed. For more information, see Edit a Single
Row, page 438.
Open a Specific Supporting Table

This option shows you how to open the supporting table dialog box for an active
column in an Instrument Index Standard Browser view. There are two main uses of
this feature:
• Adding, editing, duplicating or deleting items in a supporting table.

• Finding a select list item in an active column of the browser view on the
fly. This option is especially useful when you have a long list of items in
a select list and you need to scroll up or down to find the item you need.
Opening a supporting table for that select list enables you to quickly find
the required item which will automatically be selected for you after
closing the supporting table dialog box.
For more information, see Open a Specific Supporting Table, page 439.

Find a Record in a Browser View Column

This option shows you how to search the displayed instrument index data for a
specific record. You can search for any record that exists in any of the browser view
columns. For example, you can find a specific tag number, an instrument type, or an
I/O type, and so forth. The following search options are available:
• Find a record by entering the whole value, for example, 101-FV 100 (the
full tag number name) or CONTROL VALVE (the full instrument type
value).
• Find a record by entering a string which is a part of a value, for example,
FV (or just V) or CONTROL VALVE (the full instrument type value).
• Search for a record as you type in the value.
For more information, see Find a Record in a Browser View Column, page 440.
Sort Tag Rows in a Browser View

This option show you how to sort the tag number rows in an Instrument Index
Standard Browser view by a selected column for the current work session. You can
set a default sorting sequence for the browser view that takes effect every time you
open the browser view. You use the following procedure to override the default
sorting sequence for the current session. After closing the browser view, the sorting
sequence you set now will be lost and the default one will be applied when you
reopen the browser view. You can sort the rows in ascending or descending order as
needed. For more information, see Sort Tag Rows in a Browser View, page 441.
Edit Instrument Tag Data in Multi-Row Mode

This option shows you how to use the multi-row mode to select several rows of tag
number data that you can edit. You select the required tag numbers by highlighting
multiple tag rows in the browser view. The editing is done in the Tag Number
Properties dialog box, from which you also have access to the appropriate supporting
tables if you need to update the available options in the lists. For more information,
see Edit Instrument Tag Data in Multi-Row Mode, page 442.
Count Instrument Tag Rows in a Browser View

This option shows you how to count the total number of tag number rows currently
displayed in an Instrument Index Standard Browser view, where each tag number row
represents one record in the database. When selecting several tag number rows, you
can count both the total and the selected number of records. Also, when the list of
records is long, you can count the total number of tag number rows before the
software finishes retrieving the records from the database. For more information, see
Count Instrument Tag Rows in a Browser View, page 443.

View Point-to-Point Wiring Diagrams

This option shows you how with a tag that contains wiring information, you can open
the point-to-point wiring diagram directly from an Instrument Index Standard
Browser view. For more information, see View Point-to-Point Wiring Diagrams,
page 443.
View Data History in a Browser View

SmartPlant Instrumentation can indicate changes to the data currently displayed in an
Instrument Index Standard Browser view with the data stored in the audit trail
repository for the date range that you specify. You can choose any or all of the
following modes of emphasis:
• Set a color to emphasize changes on the screen.

• Set a shade of gray to emphasize the changed data in printed reports and
their previews.
• Set bold and italic font style for emphasis on the screen and in print.
History indication is available only if the System Administrator has activated the
audit trail functionality. When the audit trail functionality is activated, each time that
you save data after making changes, the data is recorded in the audit trial repository.
For more information, see View Data History in a Browser View, page 444.
Set a Date Range for Field Value Changes

This option shows you how to define a period within which you can track changes
made to a specific value in an Instrument Index Standard Browser view. For more
information, see Set a Date Range for Field Value Changes, page 445.
Track Field Value Changes

This option shows you how you can view the changes you have made to a value in
any field, in an Instrument Index Standard Browser view. Each field can display one
specific instrumentation value. You can view both the new and the old values, and
generate a report that displays these changes. For more information, see Track Field
Value Changes, page 445.
Open a Specification Sheet from the Browser Window

This option shows you how you can quickly access specifications for selected
instruments from the Browser window. You can open an existing specification
directly from an Instrument Index Standard Browser view and then perform the
appropriate action in the module that opens. For more information, see Open a
Specification Sheet from the Browser Window, page 446.

Open a Process Data Sheet from the Browser Window

This option shows you how you can quickly access a process data sheet from the
Browser window. You can open an existing process data sheet directly from an
Instrument Index Standard Browser view and then perform the appropriate action in
the module that opens. For more information, see Open a Process Data Sheet from
the Browser Window, page 446.
Open a Calculation Sheet from the Browser Window

This option shows you how you can quickly access a calculation sheet from the
Browser window. You can open an existing calculation sheet directly from an
Instrument Index Standard Browser view and then perform the appropriate action in
the module that opens. For more information, see Open a Calculation Sheet from the
Browser Window, page 446.
Display Existing Wiring Connections

This option shows you how to display existing wiring connections for selected
instrument tags in an Instrument Index Standard Browser view, where you can then
modify them if required. For more information, see Display Existing Wiring
Connections, page 447.
Open I/O Assignment from a Browser View

This option shows you how to access the I/O Assignment window for an instrument
you selected in the Instrument Index Standard Browser view. This way you can
implement the input/output assignment for the selected tags on the fly, by-passing the
Wiring Module window. For more information, see Open I/O Assignment from a
Browser View, page 447.
Change the Process Function and Instrument Type in Batch Mode

This option shows you how to change the process function and the instrument type of
multiple tag numbers in batch mode. You can choose whether to change both the
process function and the instrument type or only the instrument type. For more
information, see Change the Process Function and Instrument Type in Batch Mode,
page 447.
Related Topics

Define a Standard Browser View for the Instrument Index

1. Open the Browser Manager by doing one of the following:
• From an existing Instrument Index Standard Browser view, click .

• On the main SmartPlant Instrumentation tool bar, click .
2. On the Browser Manager, on the Browser groups pane, expand the hierarchy
Instrument Index > Instrument Index Standard Browser.
• Open an existing view for this browser.
• Click , or right-click and on the shortcut menu click Add View.
4. On the View profile pane, select Set as default view and Set as Instrument
Index browse view (per user) boxes.
5. Click Save.
6. Expand the Instrument Index Standard view.
7. Click Style, and on the Style pane click Edit.
8. Select the fields you want to see in the browser and click Save.
9. Right-click Instrument Index Standard Browser, and on the shortcut menu,
click Set as Default.
10. Close the Browser Manager.
Related Topics

Edit a Single Row

1. Open an Instrument Index Standard Browser view by doing one of the following:
• Click .
2. Highlight the required tag number.
3. Click in a required field to edit the data, and do one of the following:
• Type over the displayed value.
• Select an item from a list. If the item you need is not on the list you
just opened or if it is a long list and you need to scroll down to find
your value, click to open the appropriate supporting table where
you can find the required item on the fly. For more details, see Open a
Specific Supporting Table, page 439
4. Press Tab to move to the next field.
Notes
• Fields that hold tag number data (Name, Prefix, Number, and Suffix)
cannot be edited.
• Changes you make to a record are automatically saved to the database
when you proceed to another record or when you close the browser view.
Related Topics

Open a Specific Supporting Table

• Click .
2. Highlight the tag number that you require.
3. Click in a column of the highlighted row and do one of the following:
• Click Actions > Open Supporting Table.
• Click .
4. In the supporting table that opens, type the item you are looking for in the Find
box.
5. Click OK after the software highlights the row you need. Clicking OK closes the
supporting table and displays the selected item in the list.
Tip
• If the item you are looking for does not exist in the supporting table,
click New and add an item. Clicking OK after adding the new item
automatically selects this item in the active select list in the browser
view.
Related Topics

Find a Record in a Browser View Column

• Click .
2. Click on a column header to select the column you want to search. Note that all
the fields in the column become highlighted.
• Click Edit > Find.
• Click .
4. Select Case sensitive if you want to distinguish between uppercase and lowercase
characters. When selected, SmartPlant Instrumentation finds only those instances
in which capitalization matches the text you typed in the data field.
5. Select the required Match option:
• Whole value— searches for occurrences that are whole values and
not part of a larger value.
• String— searches for a particular string that you type in the data field.
• As typed— searches for a value as you type it in the data field.
6. Click Find.
7. Click Find again to find the next occurrence.
8. Close the Find dialog box when done.
Related Topics

Sort Tag Rows in a Browser View

• Click .
2. Double-click on the column header by which you want to sort the tag numbers.
Tip
• The first time you double-click a header, the software sorts the data in
ascending order - an arrow pointing down appears next to the header.
3. To sort the data in descending order, double-click the same header again. An
arrow pointing up appears next to the header according to which the data is
sorted.
Note
• After closing the browser view, the sorting sequence you set now will be
lost and the default one will be applied when you reopen the browser
view.
Related Topics

Edit Instrument Tag Data in Multi-Row Mode

• Click .
2. Select the tag numbers that you require using the Shift and Ctrl keys.
• Click Edit > Properties.
• Click .
• Right-click the selected tag numbers, and then on the shortcut menu,
click Tag Number Activities > Properties.
4. In the Tag Number Properties dialog box, edit the data for each tag as you
require. You can also do the following:
• Click New Loop to create a new loop number and then associate it
with the current tag number.
• Click New to create a new tag number.
5. When you have edited data for a particular tag number, click Apply.
6. Click Next or Previous to move from one tag number to another.
Related Topics

Count Instrument Tag Rows in a Browser View

• On the Instrument Index menu bar, click Actions > Browse Index.
• Click .
2. Select as many tag number rows as required.
• Right-click the highlighted row or rows, and on the shortcut menu,
click Count Records.
• Click Actions > Count Records.
• Click .
Related Topics
View Point-to-Point Wiring Diagrams

• Click .
• Click Actions > Documents.
• Click .
3. In the Documents pop-up window, select Tag Signal Diagram.
Related Topics

View Data History in a Browser View

• Click .
2. On the menu bar, click Options > History Options.
3. Select the date range for data history comparison, by doing one of the following:
• In the From and To data fields, type the appropriate dates. To set the
To data field value as today's date, click Today.
• Select the appropriate dates using the spinners.
4. To set a font style to emphasize changes on the screen and in print, do one or both
of the following:
• Select Bold.
• Select Italic.
5. To change the color used to display changes on the screen:
a. Beside the Highlight color for display box, click .
b. In the Color dialog box, choose the color that you require.
c. Click OK to save your new color settings and return to the History Options
dialog box.
6. To change the shade of gray used to emphasize the changed data in printed reports
and their previews:
a. Beside the Grayscale for printing box, click .
b. In the Grayscale dialog box, slide the bar to the required position.
c. Click OK to save your new grayscale settings and return to the History
Options dialog box.
7. Click OK to save your current history options and close the History Options
dialog box.
8. On the menu bar, click; Options > Mark Changes to mark changes in the data
currently displayed in the browser view for the dates that you specified in the
History Options dialog box.
Note
• To clear all history indications in the browser view, cancel the Mark
Changes selection on the Options menu.
Related Topics

Set a Date Range for Field Value Changes

• Click .
2. On the menu bar, click Options > Date Range for Changes.
3. In the From field, select or enter the date from where you want to start displaying
the changes using the DD/MM/YYYY format.
4. In the To field, select or enter the date until where you want to display the
changes using the DD/MM/YYYY format. Click Today to display the current
date in the To field.
Related Topics
Track Field Value Changes

• Click .
2. Select the tag numbers that you require.
3. Right-click, and from the shortcut menu, select Field Value Changes.
4. Click Print to generate and print out a value changes report.
Notes
• To shorten the period within which you want to track field changes, set a
date range.
• The system records field value changes in the audit trail repository.
Before using this option on Sybase Adaptive Server Anywhere, make a
revision in the Spec Binder module to add records to the audit trail
repository. This operation is required because on Sybase Adaptive Server
Anywhere, if you want to track field value changes, the audit trail
repository must not be empty.
• Under Previous values in the Field Value Changes dialog box, for the
value you have selected in the browser view, you can view the previous
values, the date of the value change, the user name of the user who
changed the value, and the change status.

Open a Process Data Sheet from the Browser Window

1. On the main SmartPlant Instrumentation menu, click File > Preferences.
2. In the tree view pane, to expand the tree, click beside Process Data.
3. Click General.
4. In the Browser view options group box, select Always from the Open process
data sheet list.
5. Click OK to close the Preferences dialog box.
6. In an Instrument Index Standard Browser view, select the instrument tags you
require and click on the main toolbar to access the process data sheets.
Related Topics
Open a Specification Sheet from the Browser Window

2. In the tree view pane, to expand the tree, click beside Specifications.
3. Click General.
4. In the Browser view options group box, select Always from the Open
specification sheet list.
require and click on the main toolbar to access the specification sheets.
Related Topics
Open a Calculation Sheet from the Browser Window

2. In the tree view pane, to expand the tree, click beside Calculation.
3. Click General.
4. In the Browser view options group box, select Always from the Open
calculation sheet list.
require and click on the main toolbar to access the calculation sheets.

Display Existing Wiring Connections

1. On the Instrument Index Browser view, highlight the tags you require.
2. Right-click the highlighted tags and on the shortcut menu click Device Panel
Connection.
Related Topics
Open I/O Assignment from a Browser View

1. On the Instrument Index Browser view, highlight the tag you require.
2. Right-click the highlighted tag and on the shortcut menu click I/O Assignment.
Related Topics
Change the Process Function and Instrument Type in Batch

Mode
1. On an Instrument Index Standard Browser view, select the required tag numbers.
2. Right-click the selected tag numbers and on the shortcut menu, click Tag
Number Activities > Change Instrument Type.
3. In the Select New Process Function and Instrument Type dialog box, do one of
the following:
• To change both the process function and the instrument type in batch
mode, from the Process function list, select the required process
function, and on the data window highlight the required instrument
type.
• To change only the instrument type in batch mode, on the data
window, select a different instrument type.
4. Click OK.
Tip
• When changing the process function, clicking OK opens the Tag
Number Renaming Options dialog box; when changing the
instrument type only, clicking OK completes the procedure.

5. On the Tag Number Renaming Options dialog box, do one of the following:
• Select the Keep general process data option to delete only process
data that is specific for each tag number.
• Select the Delete process data option to delete all the process data
associated with the tag numbers.
6. Select Change all so that SmartPlant Instrumentation does not prompt you to
change the process function and the instrument type for each tag number.
Tip
with the old CS tag will be renamed according to the new control
system tag name, and all the specifications associated with the tags
will be deleted. Verify that the appropriate loop blocks and hook-ups
are associated with the new tag number.
7. Click OK when done.
Notes
• If among the tags whose process function and instrument type you are
changing there are control system tags, SmartPlant Instrumentation
reopens the Tag Number Renaming Options dialog box, so that you can
rename the CS tags if you want to.
• To find and select the instrument type that you require quickly, start
typing in the Find instrument type field, and the software highlights the
record in the data window as you type. If the instrument type is not
available, you can create a new one. For more details, see Working with
Instrument Types: An Overview, page 374.
Related Topics

Generating Documents: An Overview

SmartPlant Instrumentation enables you to generate various reports and
documentation to help you keep track of your <plant> and the items in it. For
example, the Loop Summary report, gives you an exact picture of all the loop
numbers in use within your <plant>, including those that don't have instrument tags
associated with them. All the reports are easily accessible from the Standard Index
Browser and include:
• Specification sheets
• Process Data sheets
• Drawing and Revision reports
• Available tag lists
• Loop Summary
• Generating Documents Common Tasks, page 450

Generating Documents Common Tasks

The following tasks are used frequently when you generate documents.
Generate a Specification Sheet for an Instrument

This option shows you how to generate specifications for the instruments you select
in an Instrument Index Standard Browser view. This option is useful when you need
to create a specification for a tag number for which a specification profile was defined
after the tag number had been created. Note that this option is applicable only to
instruments for which you have not generated specifications yet and if the tag has a
specification data profile. For more information, see Generate a Specification Sheet
for an Instrument, page 451.
Generate a Process Data Sheet for an Instrument

This option shows you how to generate process data sheets for the instruments you
select in an Instrument Index Standard Browser view. This option is useful when you
need to create a process sheet for a tag number for which a process data profile was
defined after the tag number had been created. Note that this option is applicable
only to instruments for which no process data sheets have been generated yet, and has
an appropriate instrument type. For more information, see Generate a Process Data
Sheet for an Instrument, page 452.
Generate a Drawing and Revision Report

This option shows you how to view and print out a report listing the drawings
(documents) and the drawing revision data for the tag numbers currently displayed in
an Instrument Index Standard Browser view. The report displays all the appropriate
tags according to the filtering and sorting conditions that you defined for the browser
view. You can display any of the following drawings:
• Specification
• Process data sheet
• Calculation sheet
• Loop drawing
• Hook-up drawing
• P&ID drawing
You can also display revision data for all of the above drawings, except P&ID
drawings. For more information, see Generate a Drawing and Revision Report, page
453.

Create a List of Available Tags

This option shows you how to generate a report that lists all the available numeric
segments of tag numbers in the current <unit> or <plant>. For more information,
see Create a List of Available Tags, page 454.
Generate Loop Summary Reports

This option shows you to how generate a summary report of the existing loop
numbers in the current <unit> or in all the <units> in the <plant>. You can generate
the following summary reports:
• Summary of all loop numbers.

• Summary of loop numbers with no associated tags.
For more information, see Generate Loop Summary Reports, page 455.
Generate Custom Table Reports

This option shows you how to generate a report that displays the values used in one or
more custom tables. Custom tables hold user-defined information for instrument
tags. You can only use custom tables after the Domain Administrator creates the
custom tables and names them as appropriate. For more information, see Generate
Custom Table Reports, page 455.
Related Topics
Generate a Specification Sheet for an Instrument

• Click .
2. Select the required tag numbers and do one of the following:
• Click Actions > Apply Profile > Generate a Specification Sheet.
• Right-click the selected tag numbers and on the shortcut menu click
Apply Profile > Generate a Specification Sheet.
3. In the Results dialog box, take note of the generation results and then click Close.
4. Access the new specification sheet by doing one of the following:
• Select the required tag numbers in the browser view and click .
• Select the required tag numbers in the browser view, click Actions >
Documents.
Related Topics

Generate a Process Data Sheet for an Instrument

• Click .
2. Select the required tag numbers and do one of the following:
• Click Actions > Generate a Process Data Sheet.
• Right-click the selected tag numbers and on the shortcut menu click
Generate a Process Data Sheet.
3. In the Results dialog box, take note of the generation results and then click Close.
4. Access the new specification sheet by doing one of the following:
• Select the required tag numbers in the browser view and click .
• Select the required tag numbers in the browser view, click Actions >
Documents.
Note
• You can generate a process data sheet only if the tag that has an
appropriate instrument type. For details, see Define an Instrument Type
Profile, page 377
Related Topics

Generate a Drawing and Revision Report

• Click .
2. Click Actions > Drawing Report.
3. In the Select Drawings and Revisions dialog box, do one of the following:
• Under Drawings, select the check boxes beside the drawings you want
to include in the drawing report or check the Select all drawings
check box.
• Under Revisions, select the check boxes beside the revisions you
want to include in the report or check the Select all revisions check
box.
4. Click OK to generate the report.
Note
• If revisions are available they can only be selected after the appropriate
drawings have been selected.
Related Topics

Create a List of Available Tags

1. On the Instrument Index Module window, click Reports > Available Tag
Numeric Segments.
2. On the Generate Available Tags List dialog box, do the following to set your
report criteria:
a. In the Numeric segment range group box, type the range of numbers that
will be included in the report.
b. Select Current <unit> or <plant> to specify the plant hierarchy level for the
tag numbers that will be included in the report.
c. For one process function, in the Process function selection group box, select
the Process function option button and then the required process function
from the list.
d. For all the existing process functions, select the Select all option. You can
also select the Include process functions with available numbers check box
if you want to include the process functions available with the loop numbers
numeric segments.
e. Select the Exclude reserved tags check box to exclude the numeric segments
of reserved tag numbers.
f. Click OK
3. When prompted select Yes to preview the report before printing, select No to
print the report without previewing first.
Related Topics
• Batch Loop Creation from Typical Loops, page 419

Generate Loop Summary Reports

1. On the Instrument Index Module window, click Reports > Loop Summary.
2. In the Report Selection Options dialog box, do one of the following:
• Select Current <unit>, so that you can generate a loop summary
report of the loop numbers in the <unit> you are working.
• Select Current <plant>, so that you can generate a loop summary
report of the existing loop numbers in all the <units> in the current
<area>.
• Select All <units> in the <plant>, so that you can generate a loop
summary report of the existing loop numbers in all the <units> in the
current <plant>.
3. Click OK.
4. In the Loop Selection dialog box, do one of the following:
• Select All loops to generate the Summary of All Loop Numbers report.
• Select Loops with no associated tags to generate Summary of Loop
Numbers with no Associated Tags report.
5. Click OK.
6. When prompted select Yes to preview the report before printing, select No to
print the report without previewing first.
Related Topics
Generate Custom Table Reports

1. On the Instrument Index Module window, click Reports > Tables > Custom
Tables.
2. On the Select Custom Tables for Report dialog box, select a check box from
the Include column, beside every custom table that you want to include in the
report.
Tip
• Select the Include all check box, to include all of the available custom
tables into the report.
Related Topics

Working with External Documents: An Overview
Working with External Documents: An

Overview
External documents, that are associated with instrument tags, serve as an additional
document for the storage of information that can not be directly entered into
SmartPlant Instrumentation. These documents can be viewed and modified from
SmartPlant Instrumentation. Each document can be associated with a number of
Instrument tags and can be in any format supported by your Windows environment,
such as .doc, .txt, . bmp, .wav, and so forth.
Related Topics
• Managing External Documents Common Tasks, page 457

Managing External Documents Common Tasks

The following tasks are used frequently when you want to associate an external
documents with existing instrument tags in your plant.
Associate an External Document with Instrument Tags

This option shows you how to associate an external document to existing instrument
tags. For more information, see Associate an External Document with Instrument
Tags, page 458.
Open an External Document Associated with an Instrument Tag

This option shows you how to open an external file associated with an instrument.
You can do this on the fly while associating files with an instrument. SmartPlant
Instrumentation starts the appropriate application that is associated with the file you
want to open. For more information, see Open an External Document Associated
with an Instrument Tag, page 458.
Dissociate an External Document from an Instrument Tag

This option shows you how to dissociate an external document from the instrument
tags. For more information, see Dissociate an External Document from an
Instrument Tag, page 459.
View Associated Documents

Tag numbers in SmartPlant Instrumentation are associated with various documents
whether these are documents generated by the software or external documents that
can be opened with another application. SmartPlant Instrumentation displays the type
of document that is associated with a selected tag number in the Documents pop-up
window from which you can open the appropriate document on the fly.
Using this option, you can view the following documents associated with a tag
number:
• Various reports generated in other modules: Specifications, Process Data,

Calculation, and so forth.
• Enhanced SmartLoop drawings.
• Loop drawings generated using your CAD application (SmartSketch,
AutoCAD or MicroStation).
• Hook-Up drawings.
• External documents created using other applications.

Associate an External Document with Instrument Tags

2. Highlight the instrument tags you want to associate with an external file.
3. Click Actions > Associate Documents.
4. On the Associated Documents dialog box, click Associate.
5. On the Associate External Document dialog box, navigate to the required file
and click Open.
6. Click on the Description field and type a brief description as needed.
7. Click OK.
Related Topics
Open an External Document Associated with an Instrument

Tag
2. Highlight the required tag numbers.
4. On the Associated Documents dialog box, highlight the file you want to open.
• Click Open.
• Double click the highlighted file.
Related Topics

Dissociate an External Document from an Instrument Tag

2. Highlight the required instrument tags.
4. On the Associated Documents dialog box, highlight the external file you want to
dissociate.
5. Click OK.
Related Topics

View Associated Documents

2. Select the required tag numbers and then do one of the following:
• Click Actions > Documents.
• On the Instrument Index tool bar, click .
3. On the Documents pop-up window, click one of the available options to display
the print preview of the available documents. The disabled options represent
unavailable document types.
4. To view external documents, on the Documents pop-up window:
a. Click Other.
b. On the Associated Documents dialog box, select a document.
c. Click Open.
5. To view associated CAD drawings, on the Documents pop-up window:
a. Click CAD Loop Drawings.
b. On the View Drawing File pop-up window, open the CAD drawing.
6. To view associated hook-up drawings, on the Documents pop-up window:
a. Click Hook-Up Drawing.
b. On the Associated Hook-Up Drawings dialog box, select the required
drawing.
c. Click View.
Note
• You can generate a report showing all the tags in the browser view and
their related documents. To generate a report, click Actions > Related
Documents Report.
Related Topics

Wiring in SmartPlant Instrumentation: An Overview
Wiring in SmartPlant Instrumentation: An

Overview
SmartPlant Instrumentation provides the means to efficiently create a comprehensive
and detailed wiring design of your plant. You can create various types of wiring
items that perform specific functions in your plant. You can define and manage the
following:
• panels belonging to a number of different categories, such as junction

boxes, DCS and PLC panels, marshaling racks, and so forth
• plug-and-socket boxes that support Foundation Fieldbus and Profibus
systems
• field devices and their cables
• multi-input devices with either terminal or plug-and-socket connections
• terminal strips and terminals
• wiring equipment (I/O cards, fieldbus bricks, safety barriers, hubs, relays,
and so forth)
• cables based on shipped and user-defined configurations that include cable
sets (pairs, triads, and so forth), wires, and connectors
After creating the required wiring items, you can effect I/O assignment and make the
required connections. This will enable you to create a point-to-point wiring diagram
and generate numerous wiring reports using the Enhanced Report Utility.
Related Topics
• Creating and Managing Cables: An Overview, page 471
• I/O Assignment: An Overview, page 587
• Principles of Wiring Operations in SmartPlant Instrumentation, page 462
• Splitting the Wiring Design Among Several Teams, page 463
• Wiring Equipment: An Overview, page 526

Principles of Wiring Operations in SmartPlant

Instrumentation
SmartPlant Instrumentation creates and keeps track of wiring routing and connections
by identifying the wires and their connection points.
The wires and the items to which they are connected are arranged hierarchically as
they appear in the Domain Explorer. These terms are described in detail in the
relevant help topics.
You can make connections between or within any of the <unit> in a <plant>.
Reference cables and panels are, however, available for all the <plants> in the
domain.
The following sequence of operations is necessary for the creation of a wiring

scheme:
• Creation of panels, plug-and-socket boxes, terminal strips, wiring

equipment, terminals, and so on
• Creation of cables, cable sets, and wires
• Connecting wires to terminals
In addition, tagged instruments may be wired so that their wiring routing is
automatically tracked and wire names are automatically propagated. For details, see:
• Device Panels: An Overview, page 509

Related Topics

Splitting the Wiring Design Among Several Teams

There are projects in which, for various reasons, several teams work on the wiring
design of the same project. These teams can be located at the same site or be in
different geographical locations.
A good example of such a project is when the main contractor designs the field
instrumentation wiring up to the marshaling racks while the DCS vendor is
responsible for the DCS design and also for the design of the wiring from the
marshaling panels to the terminals of the I/O cards that they supply, as shown below:
At the end of the project, or at any intermediate stage, there is a need to integrate both
designs into one database to complete the wiring from the field to the DCS and then
generate the complete loop diagrams and the wiring reports.
At this time, the boundary or the scope of the design that each party is responsible for
can vary from project to project. Usually, the intersection point would be somewhere
around a marshaling panel, either at the field side of a terminal strip and the control
system terminal strip side. This issue is usually discussed between the parties and
they agree where to draw this line.
In SmartPlant Instrumentation, we recommend the following strategy to handle this

split wiring design:
1. The main contractor or the EPC starts with the creation of an As-Built domain and
then creates a project for each of the working parties involved in the overall
design. In the example mentioned above, the main contractor works on the main
As-Built plant and defines the projects for the DCS vendors.
2. All the teams work on the same database using Citrix. However, it is also
possible to work offline.

Using this approach for splitting the design has the following advantages:
• Provides the ability to see the current As-Built data while connecting to
the data (and not the other way around).
• Enables good control of new tag numbers and subcomponents.
• Retains the uniqueness of rules when adding various subcomponents such
as terminals on a terminal strip.
• Enables the comparison of As-Built loops and project loops.
Note that the members of the various teams working on the projects have to be
informed of the changes made in As-Built so that they can update their databases.
Consequently, based on the data maturity, teams should coordinate among themselves
when to transfer their wiring data to the rest of the projects.
For more information, see Operating Owner Domain (As-Built and Projects): An
Overview in the Administration User's Guide, under Domain and Project
Administration, Operating Owner: General Activities.

Creating a Wiring Scheme

After the System Administrator initializes and creates a domain, SmartPlant
Instrumentation creates the following items:
• reference cables
• reference device panels with terminal strips
• connection types
These reference items suffice for the most common connections to device panels. For
more sophisticated combinations, you should create your own reference items.
For example, for a 2-wire device you need to create in the Reference Explorer:
• a device panel with a two-terminal strip named DEFAULT 2W DEVICE

PANEL
• a cable with a shielded twisted pair (cable + one shielded pair), named
DEFAULT 2W CABLE
• a connection device that connects two wires from a pair one after the other
named 2 IN A ROW
You can then select the above items the wiring profile to define the reference wiring
properties for a given instrument type.
When you start a new wiring scheme, the folders in the Domain Explorer are empty.
You can right-click one of the panel folders in the Domain Explorer and on the
shortcut menu, click New and then click the required option. The Reference
Explorer contains several reference panels and cables that are provided as shipped
data that you can copy to the Domain Explorer.
Note that you must have appropriate access rights to alter the reference items.

Name and Sequence Uniqueness of Wiring Items

When creating or editing the properties of a wiring item , SmartPlant Instrumentation
validates that the wiring item has a unique name and sequence. The software applies
the following validation rules:
Item Sequence
If SmartPlant Instrumentation detects that the sequence of a wiring item is not unique,
the software displays an appropriate message and does not create the item until you
enter a unique sequence.
The software validates sequence uniqueness according to the following rules:
• In an Operating owner domain, the software validates sequence

uniqueness in As-Built and all the projects belonging to the current
Operating owner domain.
• Panels, cables, and connectors do not require any sequence.
• Terminals must have a sequence which is unique at the terminal strip
level.
• All the other wiring items must have a sequence which is unique at the
level of the immediate parent item under which the item exists.
Item Names
If SmartPlant Instrumentation detects that an item does not have a unique name, the
software displays a warning message, after which you proceed depending on the
setting you made on the General page of the wiring preferences. You can set the
software to proceed without changing the item name if you do not select the Enforce
name uniqueness wiring preference option on the General page. If you select the
Enforce name uniqueness check box, you must rename the item in order to proceed
with your work.

The software validates name uniqueness according to the following rules:
• In an Operating owner domain, the software validates name uniqueness in

As-Built and all the projects belonging to the current Operating owner
domain.
• For panels and cables, SmartPlant Instrumentation checks for name
uniqueness at the level of the current <plant>.
• Wires do not require name uniqueness.
• The software checks for terminal name uniqueness at the terminal strip
level.
• For all the other wiring items, SmartPlant Instrumentation checks for
name uniqueness at the level of the immediate parent item under which the
item exists.
• If you try to create a wiring item that has no name, the software prompts
you to enter a name. If you select the Enforce name uniqueness wiring
preference option, the software treats items without names according to
the validation rules stated above. If you do not select this wiring
preference option, the software allows you to create wiring items without
names.
• When moving an item to another parent item , the software validates the
name uniqueness at the target level. If you did not select the Enforce
name uniqueness wiring preference option, the software moves the item
and retains its name. If you selected the Enforce name uniqueness
wiring preference option, the software does not allow you to move the
item if the item name violates the validation rules.
For more information, see Naming Conventions: An Overview in the Administration
User's Guide, under Domain and Project Administration, Naming Conventions: An
Overview.

General Definitions Common Tasks

The following tasks are used frequently for general definitions in SmartPlant
Instrumentation.
Apply Naming Conventions to Wiring Items

SmartPlant Instrumentation allows you to apply naming conventions to various
wiring items. You can apply naming conventions to all panels, racks, and wiring
equipment. Note that naming conventions are set by your Domain Administrator.
After applying the naming conventions, the software renames the selected items
according to the existing conventions. You can apply naming conventions to a single
item or multiple items. If you need to that for a single wiring item, you can do it in
the Properties dialog box of that item by selecting the Apply naming convention
check box.
For more information, see Apply Naming Conventions to Wiring Items, page 468.
Remove Trailing Separators From Wiring Item Names

Wiring items that have been created according to naming conventions sometimes may
have trailing separators. This happens when the last naming convention segment is
not defined and there is no value for it. You can instruct the software to remove the
trailing separators automatically when creating wiring items. For more information,
see Remove Trailing Separators From Wiring Item Names, page 470.
Apply Naming Conventions to Wiring Items

1. In the Domain Explorer, do one of the following:
• In the Tree view, select one desired item.
• Expand a folder and in the Items pane, select the items you require.
2. Right-click the selected items and then on the shortcut menu, click one of the
following:
• Apply Naming Conventions to Selected Items— to rename only the
items you selected without renaming the child items that exist on the
lower hierarchy level of these items.
• Apply Naming Conventions to Selected Items and Child Items—
to rename the items you selected and all the child items that exist on
the lower hierarchy level of these items.
Related Topics
• General Definitions Common Tasks, page 468

Associate a Symbol with an Item

Important
• Make sure that you have defined a custom symbol folder in the SmartPlant
Instrumentation Preferences dialog box for the appropriate enhanced
report type before you associate a symbol with an item .
• When you associate a symbol with an item that can have more than one
possible relation to other items for which you want to display data, make
sure that the symbol you select uses macros with the appropriate relations.
If a macro has an incorrect relation, the software cannot display the data.
1. In the Domain Explorer, select the desired item , for example, a particular panel.
2. Right-click the item and click Properties.
3. Click the Associate Symbols tab.
4. Click New.
5. In the Name column, select the desired report type.
6. Beside the Symbol File column, click Browse.
7. Navigate to the desired .sym file.
8. If you require, repeat steps 4 -7 to associate symbols with the item for other report
types.
Tip
• When associating symbols with a panel, for example, you will use one
symbol to represent the panel in a Location Layout report, and another
symbol to represent the panel in a Panel Layout report.

Notes
• For an instrument, when you associate a symbol for Enhanced Report
Utility reports, the symbol will also be displayed in other wiring reports.
• You can associate each item with one symbol only per available report
type.
• You can associate the same symbol with more than one item if you desire.
• When using custom terminal symbols in enhanced reports, there are two
ways of displaying the terminals on the drawing sheet:
1. Associating a symbol with a panel, where the symbol exactly represents the
panel-strip-terminal configuration, and dragging the panel onto the drawing
sheet. With this method, the software displays the entire panel.
2. Associating a symbol with each individual terminal and dragging the desired
terminals onto the drawing sheet. With this method, the software displays the
selected terminals with their associated strips and panels, together with the
appropriate macros.
Remove Trailing Separators From Wiring Item Names

1. In the Wiring module, click File > Preferences.
2. In the Preferences dialog box, under Wiring, click Custom.
3. In the Custom features for the Wiring module group box, under Parameter,
type Remove Trailing Separator.
4. Under Value type Y.
Note
• The default setting is N which instructs the software not to remove the
trailing separators,
Related Topics
• General Definitions Common Tasks, page 468

Creating and Managing Cables: An Overview

You create new cables in SmartPlant Instrumentation based on a particular cable
configuration. A cable configuration includes a particular arrangement of cable sets
(pairs, triads, and so forth within a cable) and wires to be built with the cable.
Therefore, when creating a new cable, you have to select an existing cable
configuration or define a new one. After creating a cable, you can add additional
cable sets and wires to that cable if required.
As a time saver, it is recommended that you create reference items for the cable, cable
set, and wire arrangements you intend to use frequently. You create these reference
cables in the Reference Explorer. You can then drag them to the Domain Explorer
and this way create numerous cables on the fly.
In SmartPlant Instrumentation Explorer, cables occupy the top hierarchy level

under which you can create various wiring items such as cable sets, wires, and
connectors. There is a lot of flexibility in creating a cable hierarchy. There is no
rigid structure like "cable – cable set – wire" that limits your cable design. You
can create various cable hierarchy structures, as you require.
Related Topics
• Creating and Managing Cables Common Tasks, page 472

Creating and Managing Cables Common Tasks

The following tasks are used frequently when you manage the cables in your plant.
Define a Cable Configuration

This option allows you to create a new cable configuration. All cables in SmartPlant
Instrumentation are based on a particular cable configuration. Therefore, you need a
cable configuration so that you can create a new cable. A cable configuration
includes a cable set (pairs, triads, and so forth within a cable) and wire arrangement.
As a result, when creating a new cable, SmartPlant Instrumentation creates the
required cable sets and wires within that cable automatically based on the
configuration that you define. You can add more cable sets and wires to that cable
manually later if needed. For more information, see Define a Cable Configuration,
page 475.
Edit a Cable Configuration

This procedure explains how to modify an existing cable configuration. For more
information, see Edit a Cable Configuration, page 476.
Delete a Cable Configuration

This procedure explains how to delete a cable configuration. For more information,
see Delete a Cable Configuration, page 478.
Create a Cable
This procedure explains how to create cables. You can create new cables either in the
Domain Explorer or the Reference Explorer. If you are creating a cable that is
going to have a frequently used configuration, we recommend that you create it in the
Reference Explorer. Reference cables facilitate fast creation of plant cables by
copying an existing cable configuration from the Reference Explorer to the Domain
Explorer. However, if you want to create a cable that does not have a configuration
that you intend to use frequently, we recommend that you create this cable in the
Domain Explorer and in the <unit> where it is to be physically located. This is
helpful when filtering the cables in the current <unit>.
For more information, see Create a Cable, page 479.

Create a Connector
Connectors are needed for fieldbus home-run cables, telecom cables, and other cables
that require connectors. SmartPlant Instrumentation allows you to build your wiring
system with any of the following connector implementations:
• Connector at one or both cable ends

• Connector at end of a single cable set
• Connector at end of wires from different cable sets
For details on how to create a connector, see Create a Connector, page 481.
Edit Cable Properties

This procedure shows how to edit the properties of a cable. For more information,
see Edit Cable Properties, page 482.
Create a Cable Without Sets and Wires

This option allows you to create a cable that does not have any sets or wires. You can
use such cables in the early stages of your design and when creating cable block
diagrams where it is not necessary to specify cable types, the number of sets and
wires in the cables, and so forth. For more information, see Create a Cable Without
Sets and Wires, page 486.
Apply a Reference Cable to Multiple Cables Without Sets and Wires

This feature enables you to apply a reference cable to cables that do not have any sets
or wires. This batch operation enables you to select multiple cables in the Domain
Explorer and then select an appropriate reference cable for each cable that you
selected. For more information, see Apply a Reference Cable to Multiple Cables
Without Sets and Wires, page 486.
Apply a Reference Cable to One Cable Without Sets and Wires

This procedure explains how to apply a reference cable to a single cable that does not
have any sets or wires. You can apply a reference cable or a cable structure as you
require. For more information, see Apply a Reference Cable to One Cable Without
Sets and Wires, page 487.
Add a Cable Set

SmartPlant Instrumentation adds cable sets (pairs, triads, and so forth within a cable)
automatically when you create a new cable based on a cable configuration. This
procedure describes how you can add another cable set to an existing cable that
already contains a number of cable sets. For more information, see Add a Cable Set,
page 483.

Add a Wire to a Cable Set

SmartPlant Instrumentation adds wires automatically when you create a new cable
based on a cable configuration. This procedure describes how you can add another
wire to an existing cable set. You can add a wire either to a cable set created
automatically or to a cable set that you added manually. For more information, see
Add a Wire to a Cable Set, page 484.
Edit Wire Properties

This option describes how to edit the properties of a wire. For more information, see
Edit Wire Properties, page 487.
Create a Connector

Apply Regional Wire Colors to Project Cables

This allows you to apply regional wire colors to your project cables based on
reference cables. For more information, see Apply Regional Wire Colors to Project
Cables, page 489.
Related Topics

Define a Cable Configuration

2. In the Domain Explorer or Reference Explorer, right-click the Cables folder
and then click New > Cable.
3. In the Cable Configuration dialog box, click New.
4. In the New Cable Configuration dialog box, enter the total number of sets (pairs,
triads, and so forth) that SmartPlant Instrumentation will create automatically
when a new cable is based on this new configuration.
Tip
• Add an additional cable set for an overall shield.
5. From the Default cable set type list, select the appropriate cable type.
Tip
• The selected cable type determines whether cables based on this
configuration have multiple wires, pairs, triads, and so forth.
6. Click OK to return to the Cable Configuration dialog box.
7. In the Cable Configuration dialog box, type the name of the new configuration
in the Cable Configuration data field.
8. In the Cable default name field, type a name of the cables that will be based on
the current configuration.
Tip
• This means that every time you create a new cable based on this new
configuration, SmartPlant Instrumentation uses this default setting to
name the new cable. You can then modify this name as needed when
you define the cable in the Cable Properties dialog box.
9. In the Description text field, type a brief description of the new configuration.
10. Click in the Cable Set text field and type the name of each cable set that is
defined in this configuration. You can rename the individual cable sets later if
needed when editing the cable set in the Cable Set Properties dialog box.
11. For each cable set, in the Cable Set Type field, accept the displayed value (the
cable set type you selected in the New Cable Configuration dialog box) or select
another one if needed.

12. For each first cable set of a given cable set type, do the following under Cable set
details:
a. Click in the Wire Tag text field and type the names of the individual wires
within the cable sets. You can accept the displayed value if needed.
b. From the Wire Color list, select a color for each wire. If the required value is
not available, you can add it in the Wire Color dialog box that you access
from the Tables menu in the Wiring Module window.
c. From the Wire Type list, select a type for each wire. If the required value is
not available, you can add it in the Wire Type dialog box that you access
d. From the Polarity list, select the appropriate polarity or shield for each wire.
13. For additional cable sets based on a cable set type for which you already entered
settings under Cable set details, do one of the following:
• To copy the values from a selected cable set to all sets based on the
current cable set type, click Apply. You can select the Exclude wire
tags check box before you click Apply if you do not wish to copy the
wire tags while copying wire color, wire type, and polarity details.
• Enter the settings individually for each cable set.
14. Click Save.
Related Topics
Edit a Cable Configuration

3. In the Cable Configuration dialog box, select a configuration from the Cable
configuration list.
4. Click Edit.
5. In the Cable Configuration dialog box, enter the total number of sets (pairs,
triads, and so forth) that SmartPlant Instrumentation will create automatically
when a new cable is based on this new configuration.
Tip
• Add an additional cable set for an overall shield.

6. From the Default cable set type list, select the appropriate cable type.
Tip
• The selected cable type determines whether cables based on this
configuration have multiple wires, pairs, triads, and so forth.
7. Click OK to return to the Cable Configuration dialog box.
8. In the Cable Configuration dialog box, type the name of the new configuration
in the Cable Configuration data field.
9. In the Cable default name field, type a name of the cables that will be based on
the current configuration.
Tip
• This means that every time you create a new cable based on this new
configuration, SmartPlant Instrumentation uses this default setting to
name the new cable. You can then modify this name as needed when
you define the cable in the Cable Properties dialog box.
10. In the Description text field, type a brief description of the new configuration.
11. Click in the Cable Set text field and type the name of each cable set that is
defined in this configuration. You can rename the individual cable sets later if
needed when editing the cable set in the Cable Set Properties dialog box.
12. For each cable set, in the Cable Set Type field, accept the displayed value (the
cable set type you selected in the New Cable Configuration dialog box) or select
another one if needed.
13. For each first cable set of a given cable set type, do the following under Cable set
details:
a. Click in the Wire Tag text field and type the names of the individual wires
within the cable sets. You can accept the displayed value if needed.
b. From the Wire Color list, select a color for each wire. If the required value is
not available, you can add it in the Wire Color dialog box that you access
c. From the Wire Type list, select a type for each wire. If the required value is
not available, you can add it in the Wire Type dialog box that you access
d. From the Polarity list, select the appropriate polarity or shield for each wire.

14. For additional cable sets based on a cable set type for which you already entered
settings under Cable set details, do one of the following:
• To copy the values from a selected cable set to all sets based on the
current cable set type, click Apply. You can select the Exclude wire
tags check box before you click Apply if you do not wish to copy the
wire tags while copying wire color, wire type, and polarity details.
• Enter the settings individually for each cable set.
15. Click Save.
Related Topics
Delete a Cable Configuration

3. In the Cable Configuration dialog box, select a configuration from the Cable
configuration list.
4. Click Delete.
Related Topics

Create a Cable
3. In the Cable Configuration dialog box, select a cable configuration from the
Cable configuration list.
Tip
• Click New if you do not have a suitable configuration. For details, see
Define a Cable Configuration, page 475.
4. Click Create.
5. In the Cable Properties dialog box, under Cable, type the cable name.
Tip
• If you are working under cable type dependency, your selection of
cable type determines the reference cable name.
6. Under Description, type the new cable description as needed.
7. Select one of the following under Cable class:
• To create a conventional cable, accept the default setting
Conventional.
• To create a fieldbus spur, select Conventional.
• To create a fieldbus home-run cable, select Fieldbus home-run.
• To create a telecom cable, select Telecom.
8. Under Type, select the required cable type if needed. If the required type is not
available, click next to the list arrow to add the required item to the list.
9. Select the cable manufacturer, model, color as appropriate. If the item that you
need is not on the list, click .
10. Type the end one and end two locations of the cable.
11. Type the cable length and select the unit of measure.
12. To assign this cable to a cable drum, select values from the Pulling area list and
from the Cable drum list. For details, see Assign Cables to Drums Manually
(Without Optimization), page 672.
13. To define a cable harness, select the cable harness from the list. If the item that
you need is not on the list, click .

14. To name the wires ends in this cable according to a naming convention, select the
appropriate naming convention from the Wire end naming convention list.
15. To define the cable as intrinsically safe, select Set as intrinsically safe.
16. To define glands for the cable, from the Glands group box, select the End 1, End
2 or both cable glands. If the required gland is not available, click .
17. Note the graphic representation of cable glands in the software:
— A cable with no glands
— A cable with a gland on one of its sides
— A cable with a gland on both sides

18. Click Connectors to create connectors for the cable and manage connector-wire
assignments.
19. In the Cable Properties dialog box, click OK.
Related Topics

Create a Connector
1. In the Domain Explorer or Reference Explorer, do one of the following:
• To create a new cable, right-click the Cables folder and on the
shortcut menu click New > Cable.
• Right-click an existing cable, and on the shortcut menu click
Properties.
2. Modify cable properties as needed. For details, see Create a Cable, page 479.
3. Click Connectors.
4. In the Connector Assignments dialog box, do one of the following:
• To manage connector-wire associations for end 1 of the cable, click
the End 1 tab.
• To manage connector-wire associations for end 2 of the cable, click on
the End 2 tab.
5. In the Connector Assignments dialog box, click New.
6. In the Connector Properties dialog box that opens, under Connector, type the
name of the new connector.
• From the list, select a connector type as configured.
• To modify or create a connector type, click .
7. Under Male/female select Male or Female as needed.
8. Click OK to return to the Connector Assignments dialog box.
Related Topics

Edit Cable Properties

2. Expand the Cables folder and right-click a cable.
3. On the shortcut menu, click Properties.
4. In the Cable Properties dialog box, under Cable, type the cable name.
Tip
• If you are working under cable type dependency, and have already
created plant cables based on a reference cable that you are editing,
certain reference cable fields are not enabled for editing. The System
Administrator can enable cable type dependency when making domain
definitions.
5. Under Description, type the new cable description as needed.
6. Select one of the following under Cable class:
• To create a conventional cable, accept the default setting
Conventional.
• To create a fieldbus spur, select Conventional.
• To create a fieldbus home-run cable, select Fieldbus home-run.
• To create a telecom cable, select Telecom.
7. Under Type, select the required cable type if needed. If the required type is not
available, click next to the list arrow to add the required item to the list.
8. Select the cable manufacturer, model, color as appropriate. If the item that you
need is not on the list, click .
9. Type the end one and end two locations of the cable.
10. Type the cable length and select the unit of measure.
11. To assign this cable to a cable drum, select values from the Pulling area list and
from the Cable drum list. For details, see Assign Cables to Drums Manually
(Without Optimization), page 672.
12. To define a cable harness, select the cable harness from the list. If the item that
you need is not on the list, click .
13. To name the wires ends in this cable according to a naming convention, select the
appropriate naming convention from the Wire end naming convention list.
14. To define the cable as intrinsically safe, select Set as intrinsically safe.

15. To define glands for the cable, from the Glands group box, select the End 1,
End 2 or both cable glands. If the required gland is not available, click .
16. Note the graphic representation of cable glands in the software:
— A cable with no glands
— A cable with a gland on one of its sides
— A cable with a gland on both sides

17. Click Connectors to create connectors for the cable and manage connector-wire
assignments.
18. In the Cable Properties dialog box, click OK.
Related Topics
Add a Cable Set

Important
• If you are working under cable type dependency, and have already created
plant cables based on a particular reference cable, the software does not
allow you to add cable sets to such a reference cable. Further, you cannot
add cable sets to a plant cable created under cable type dependency. The
System Administrator can enable cable type dependency when making
domain definitions.
2. Expand the Cables folder and right-click a cable.
3. On the shortcut menu, click New > Cable Set.
4. In the Cable Set Properties dialog box, type the cable set name in the Cable set
text field.
5. Under Cable set sequence, enter the sequence of the cable set in the cable.
Tip
• Typically, the cable set sequence is determined by the manufacturer.
If you change the sequence number of a cable set, make sure that you
also change the sequence number of the other cable sets in the cable as
appropriate to avoid duplicate values and erroneous terminations.
6. Click OK to add a new cable set.

Add a Wire to a Cable Set

Important
allow you to add cable sets or wires to such a reference cable. Further,
you cannot add cable sets or wires to a plant cable created under cable
type dependency. The System Administrator can enable cable type
dependency when making domain definitions.
2. Expand the Cables folder and then double-click a cable to display its cable sets.
3. Right-click a cable set and then on the shortcut menu, click New > Cable Wire.
4. In the Wire Properties dialog box, under Wire, type the wire tag.
Tip
• By default, wire tags are based on the signal that they carry. To name
wires based on user input the Domain Administrator needs to enable
cable type dependency when making domain definitions.
5. In the Details group box, under Wire sequence in set, accept the automatically
assigned value that determines the numbering sequence of the wire in the cable
set.
Tip
• The values that SmartPlant Instrumentation suggests under Wire
sequence in set are unique throughout As-Built and all engineering
projects where the current cable set appears.
6. From the Polarity list, select the signal polarity or shield.
Tip
• When you create a cable for the first time, or when you copy from
reference cables, check for the existence of shield indication wherever
needed. Shield indication is important when SmartPlant
Instrumentation propagates signals through wires. In this case, the
software does not overwrite the wire tag with the tag signal. You can
also define a wire as an overall shield if required.
7. From the Type list, select the required wire type. If the required type is not on
this list, click next to the list arrow to open a dialog box where you can add,
modify, or delete items from the Wire type list.

8. From the Color list, select the required wire color. If the required color is not on
modify, or delete items from the Wire color list.
9. In the Note text field, type a brief note if needed.
10. To name the wire ends according to a naming convention, select the appropriate
naming convention from the Wire end naming convention list. Note that this
check box is available only if the Domain Administrator has enabled it in the
Wire End Naming Conventions dialog box.
11. Do the following to name the wire ends not according to a naming convention:
a. Select Override naming convention.
b. Under Wire end 1, type the first wire end name.
c. Under Wire end 2, type the second wire end name.
12. Click Revisions to manage revisions for the current wire.
13. Click OK in the Wire Properties dialog box.
Related Topics

Create a Cable Without Sets and Wires

Important
• The software does not allow you to create cables without sets and wires if
you are working under cable type dependency.
2. Right-click the Cables folder and then on the shortcut menu click New > Cable.
3. On the Cable Configuration dialog box, click New.
4. Do the following on the New Cable Configuration dialog box:
a. Under Number of cable sets, type 0 (zero).
b. Click OK.
5. On the Cable Configuration dialog box, click Save and then Create.
6. On the Cable Properties dialog box, enter the cable properties as you require.
Tip
• Since cables without cable sets and wires are useful during the early
stages of plant design and when creating cable block diagrams, the
only cable property that you need to enter is the cable name. You can
populate the other properties when you apply a reference cable to this
cable.
7. Click OK.
Related Topics
Apply a Reference Cable to Multiple Cables Without Sets

and Wires
1. In the Domain Explorer, click the Cables folder.
2. In the Items pane, press and hold the Ctrl key and then right-click the cables you
require.
3. On the shortcut menu, click Actions > Apply Reference Cable.
4. On the Apply Reference Cable dialog box, select an appropriate reference cable
for each cable.
5. Click OK.

Apply a Reference Cable to One Cable Without Sets and

Wires
1. In the Domain Explorer, click the Cables folder.
2. In the tree view right-click a cable you require.
3. On the shortcut menu, click Actions > Apply Cable Structure.
4. On the Apply Cable Structure dialog box, do one of the following:
• Click the Create items based on a reference cable option button and
then select an appropriate reference cable from the list.
• Click the Create items based on a cable configuration option button
and then select an appropriate cables structure from the list. You can
click to open the Cable Configuration dialog box to define a new
cable configuration if needed.
5. Click OK.
Related Topics
Edit Wire Properties

Important
allow you to add cable sets or wires to such a reference cable. Further,
you cannot add cable sets or wires to a plant cable created under cable
type dependency. The System Administrator can enable cable type
dependency when making domain definitions.
2. Expand the Cables folder and then double-click a cable to display its cable sets.
3. Double-click a cable set to display the existing wires.
4. Right-click a wire and then on the shortcut menu, click Properties.
5. In the Wire Properties dialog box, under Wire, type the wire tag.
Tip
• By default, wire tags are based on the signal that they carry. To name
wires based on user input the Domain Administrator needs to enable

6. In the Details group box, under Wire sequence in set, accept the automatically
assigned value that determines the numbering sequence of the wire in the cable
set.
Tip
• The values that SmartPlant Instrumentation suggests under Wire
sequence in set are unique throughout As-Built and all engineering
projects where the current cable set appears.
7. From the Polarity list, select the signal polarity or shield.
Tip
• When you create a cable for the first time, or when you copy from
reference cables, check for the existence of shield indication wherever
needed. Shield indication is important when SmartPlant
Instrumentation propagates signals through wires. In this case, the
software does not overwrite the wire tag with the tag signal. You can
also define a wire as an overall shield if required.
8. From the Type list, select the required wire type. If the required type is not on
modify, or delete items from the Wire type list.
9. From the Color list, select the required wire color. If the required color is not on
modify, or delete items from the Wire color list.
10. In the Note text field, type a brief note if needed.
11. To name the wire ends according to a naming convention, select the appropriate
naming convention from the Wire end naming convention list. Note that this
check box is available only if the Domain Administrator has enabled it in the
Wire End Naming Conventions dialog box.
12. Do the following to name the wire ends not according to a naming convention:
a. Select Override naming convention.
b. Under Wire end 1, type the first wire end name.
c. Under Wire end 2, type the second wire end name.
13. Click Revisions to manage revisions for the current wire.
14. Click OK in the Wire Properties dialog box.
Related Topics

Apply Regional Wire Colors to Project Cables

Important
• This feature works only if your System Administrator has enabled the
1. Import the required reference cables.
2. In the target database, turn off the cable type dependency feature.
3. Change the wire color of the reference cables.
4. Turn on the cable type dependency feature.
5. In the Wiring module, click Actions > Apply Regional Wire Colors.
6. On the Apply Regional Wire Colors dialog box, click Apply.
Notes
• You can view the results on the Regional Wire Colors Application
Results dialog box.
• The software applies the wire colors only to those project cables that fully
conform to the structure of reference cables on the basis of which they
were built. That is, project cables must have the same number of cable
sets and wires in each set as the appropriate reference cables.
Related Topics

Conventional Panels: An Overview

The Wiring module enables you to create and configure various types of conventional
panels. Conventional panels in SmartPlant Instrumentation refer to all types of panels
and cabinets that do not have a plug-and-socket connection. In SmartPlant
Instrumentation Explorer, panels occupy the top hierarchy level under which you
can create various wiring items such as terminal strips, I/O cards, racks, and so on.
There is a lot of flexibility in creating a panel hierarchy. There is no rigid structure
like "panel – strip – terminal" that limits your wiring design. You can create
various wiring structures, as you require.
Note that when duplicating a panel that has another panel as its child item (usually a
device panel), the software duplicates the parent item without the child panel.
SmartPlant Instrumentation allows you to create the following types (categories) of

conventional panels:
• Junction boxes
• Marshaling racks
• Cabinets (multi-purpose panels)
• Device panels
• Distributed Control System (DCS) panels
• Programmable Logic Controller (PLC) panels
Related Topics

Managing Conventional Panels Common Tasks

The following tasks are used frequently when you manage the conventional panels in
your plant. Conventional panels in SmartPlant Instrumentation are those panels that
do not have a plug-and-socket connection.
You can create new panels either in the Domain Explorer or the Reference
Explorer. If you are creating a panel that is going to have a frequently used
configuration, we recommend that you create it in the Reference Explorer.
Reference panels facilitate fast creation of plant panels by copying an existing panel
configuration from the Reference Explorer to the Domain Explorer. However, if
you want to create a panel that does not have a configuration that you intend to use
frequently, we recommend that you create this panel in the Domain Explorer and in
the <unit> where it is to be physically located. This is helpful when filtering the
panels in the current <unit>.
Create a Junction Box

This procedure explains how to create a generic junction box. For more information,
see Create a Junction Box, page 493.
Create a Marshaling Rack

This procedure explains how to create a marshaling rack. For more information, see
Create a Marshaling Rack, page 495.
Create a Cabinet
This procedure explains how to create a cabinet. For more information, see Create a
Cabinet, page 497.
Create an Unassociated Conventional Device Panel

This procedure explains how to create a device panel that is not associated with any
tag number and not connected to any device cable. For more information, see Create
an Unassociated Conventional Device Panel, page 499.
Create a Distributed Control System (DCS) Panel

This procedure explains how to create a distributed control system (DCS) panel. For
more information, see Create a Distributed Control System (DCS) Panel, page 501.
Create a Programmable Logic Controller (PLC) Panel

This procedure explains how to create a programmable logic controller (PLC) panel.
For more information, see Create a Programmable Logic Controller (PLC) Panel,
page 503.

Create a Panel with Terminals and Connectors

Use this procedure to create a panel that contains both terminals and plug-and-socket
connections. Some fieldbus and Telecom devices have inputs via a plug-and socket
arrangement and outputs via terminated wires on terminals. To provide for this need,
SmartPlant Instrumentation allows you to add a connector under any panel type
(except for device panels) and then make the required connections either through the
terminals or the connectors. For more information, see Create a Panel with
Terminals and Connectors, page 504.

This procedure explains how to enter power supply data for various panels that
require power supply. Although power supply data is not essential for SmartPlant
Instrumentation functionality, it is indicated for the interface with the SmartPlant
Electrical application. SmartPlant Instrumentation allows you to enter power supply
data in all panels except for junction boxes and device panels. For more information,
Create a Rack
This procedure deals with the creation of racks. Since racks are panel child items,
you can add a new rack under any panel except for a device panel. For more
information, see Create a Rack, page 507.
Related Topics

Create a Junction Box

• Press F8 to open the Reference Explorer and expand the Panels
folder.
• Expand the Panels by Category folder to display all the panel
category folders.
• Expand the Panels by Location hierarchy and right-click a location
where you want your new panel to reside.
3. In the Domain Explorer under Panels by Category or in the Reference
Explorer under Panels, right-click the Junction Boxes folder and then click New
> Junction Box (Generic).
4. In the Junction Box Properties dialog box, on the General tab, do one of the
following to define the name of the new panel:
• Clear the Apply naming convention check box and under Panel, type
the name of the new panel. Note that if you do not clear the Apply
you type under Panel.
• Keep the Apply naming convention check box selected if you want
the software to name the new panel automatically according to the
naming conventions that are set for this type of panel in the
Naming Conventions.
5. Select the required values from the Type, Manufacturer, Model, Dimensions,
Area classification, and Location lists. If the required value is not available,
click next to the relevant list arrow to open the appropriate supporting table.
6. Under Dimensions, type a value for the marshaling rack dimensions if needed.
7. Under Maximum number of racks, type a value to set the maximum number of
racks that can be created in this panel.
Tip
• Setting this value to zero means that the current panel can have an
unlimited number of racks.
8. Under Mounting, type a value if needed.
9. Under Backplane, type a value if needed.

10. Select the Set as intrinsically safe check box if this junction box has intrinsic
safety certification.
11. Click the Associate Symbols tab to associate a symbol with the current panel.
Report Utility. For details, see Associate a Symbol with an Item, page 469.
12. Click Revisions to manage the revisions of the new panel if needed.
13. Click OK to accept your definitions for the new junction box and close this dialog
box.
Note
• To create a junction box panel that contains both terminals and plug-and-
socket connections, see Create a Panel with Terminals and Connectors,
page 504.
Related Topics
• Create a Panel with Terminals and Connectors, page 504

Create a Marshaling Rack

folder.
category folders.
Explorer under Panels, right-click the Marshaling Racks folder and then click
New > Marshaling Rack.
4. In the Marshaling Rack Properties dialog box, on the General tab, do one of
the following to define the name of the new panel:
Naming Conventions.
Tip

10. Select the Set as intrinsically safe check box if this marshaling rack has intrinsic
11. If you need to enter power supply properties, select the Requires power supply
check box and then click the Power Supply tab. For details, see Enter Power
Supply Data for Panels and Instrument Tags, page 390.
14. Click OK to accept your definitions for the new marshaling rack and close this
dialog box.
Note
• To create a marshaling rack that contains both terminals and plug-and-
socket connections, see Create a Panel with Terminals and Connectors,
page 504.
Related Topics

Create a Cabinet
folder.
category folders.
Explorer under Panels, right-click the Cabinets folder and then click New >
Cabinet.
4. In the Cabinet Properties dialog box, on the General tab, do one of the
Naming Conventions.
6. Under Dimensions, type a value for the cabinet dimensions if needed.
Tip
• Setting this value to zero means that the current cabinet can have an

10. Select the Set as intrinsically safe check box if this cabinet has intrinsic safety
certification.
13. Click Revisions to manage the revisions of the new cabinet if needed.
14. Click OK to accept your definitions for the new cabinet and close this dialog box.
Note
• To create a cabinet that contains both terminals and plug-and-socket
connections, see Create a Panel with Terminals and Connectors, page
504.
Related Topics


folder.
category folders.
Explorer under Panels, right-click the Device Panels folder and then click New
> Device Panel (Conventional).
4. In the Device Panel Properties dialog box, on the General tab, do one of the
Naming Conventions.
5. In the Address 1 and Address 2 fields, type the required definitions.
Tip
• You can change the Address 1 and Address 2 field headers to reflect
manufacturer specific terminology.
9. Select the Set as intrinsically safe check box if this marshaling rack has intrinsic

12. Click OK to accept your definitions for the new device panel and close this dialog
box.
Note
• To create a device panel that contains both terminals and plug-and-socket
504.
Related Topics
• Managing Device Panels Common Tasks, page 511

Create a Distributed Control System (DCS) Panel

folder.
category folders.
Explorer under Panels, right-click the DCS Panels folder and then click New >
DCS Panel.
4. In the Distributed Control System (DCS) Properties dialog box, on the
General tab, do one of the following to define the name of the new panel:
Naming Conventions.
5. In the Highway and Node fields, type the required DCS definitions.
Tip
• You can change the Highway and Node field headers to reflect
manufacturer-specific terminology.
6. Select the required values from the Type, Manufacturer, Model, Area
classification, and Location lists. If the required value is not available, click
next to the relevant list arrow to open the appropriate supporting table.
Tip

8. To create a DCS panel compatible with a Profibus DP segment, do the following:

a. Select the Enable DP Profibus check box.
b. Under DP Profibus node, type a node for the new panel.
12. Click OK to accept your definitions for the new DCS panel and close this dialog
box.
Note
• To create a DCS panel that contains both terminals and plug-and-socket
504.
Related Topics

Create a Programmable Logic Controller (PLC) Panel

• Double-click the Panels by Location folder, right-click a location and
then on the shortcut menu click New > PLC Panel.
• Double-click the Panels by Category folder, right-click the DCS
Panels folder and then on the shortcut menu click New > PLC Panel.
3. In the Programmable Logic Controller (PLC) Properties dialog box, on the
General tab, do one of the following to define the name of the new panel:
Naming Conventions.
4. In the Address 1 and Address 2 fields, type the required PLC definitions.
Tip
• You can change the Address 1 and Address 2 field headers to reflect
manufacturer-specific terminology.
Tip
7. To create a PLC panel compatible with a Profibus DP segment, do the following:
a. Select the Enable DP Profibus check box.
b. Under DP Profibus node, type a node for the new panel.

11. Click OK to accept your definitions for the new PLC panel and close this dialog
box.
Note
• To create a PLC panel that contains both terminals and plug-and-socket
504.
Related Topics
Create a Panel with Terminals and Connectors

1. In the Domain Explorer or Reference Explorer, create or select a panel.
Tip
• You can select or create any type of panel except for device panels.
2. Right-click the panel you selected and then on the shortcut menu, click New >
Connector.
3. In the Connector Properties dialog box, under Connector, type the name of the
new connector.
4. Under Connector type, do one of the following:
• From the list, select a connector type with pins.
• To modify or create a connector type, click .
6. Click OK.
Related Topics


1. Do one of the following to open the Properties dialog box of a panel or tag
number:
panel and then click Properties.
instrument and then click Properties.
2. On the General tab, select the Requires power supply check box.
3. Click the Power Supply tab.
4. Under Criticality, select the criticality, which is used in SmartPlant Electrical to
determine whether the current instrument requires UPS power or regular power.
5. Under Rated voltage, select a value that indicates the voltage at which the
instrument is designed to operate.
6. If the instrument is running on alternating current, under Power supply type click
AC and do the following:
a. Under Frequency, select the operating frequency of the instrument.
b. Under Number of phases, select the number of phases in the power supply to
the instrument.
c. Under Power factor full load, enter a value between 0 and 1 for the ratio of
active to apparent power at 100% of the rated power.
7. If the instrument runs on direct current, under Power supply type, click DC.
8. Under Rated active load, type the full load power consumption in kilowatts.
9. Type the following values in amperes:
a. Full load current.
b. Starting current.

10. In the Coincidence factors group box, do one of the following:

• Under Operating mode, select Continuous, and under X –
continuous, type a value between 0 and 1.
• Under Operating mode, select Intermittent, and under Y –
intermittent, type a value between 0 and 1.
• Under Operating mode, select Spare, and under ZZ – spare, type a
value between 0 and 1
• Under Operating mode, select Standby, and under Z – stand by,
type a value between 0 and 1.
Note
• The fields under Power distribution board data group box display data
that is determined within SmartPlant Electrical. On the Power Supply
tab, click Help for more information.
Related Topics

Create a Rack
folder. Then, select a desired reference panel.
category folders.
• Expand the Panels by Location hierarchy to display the available
locations and their panels. Then, select a desired panel.
3. In the Domain Explorer or in the Reference Explorer, right-click the selected
panel and then click New >Rack.
4. In the Rack Properties dialog box, on the General tab, do one of the following
to define the name of the new panel:
• Clear the Apply naming convention check box and under Rack, type
the name of the new rack. Note that if you do not clear the Apply
you type under Rack.
naming conventions that are set for racks in the Administration
module. For more information, see SmartPlant Instrumentation
Administration Help, Domain Administration > Naming Conventions.
5. In the Details group box, type a description and sequence as you require.
6. Click Slots to add some slots for the current rack.
7. In the Batch Slot Creation dialog box, type the number of new slots that you
want to add in the new rack.
8. Do the following to define the slot numbering:
a. Type a prefix for the slot name.
b. Enter a value in the Start from number and Increment by fields.
9. Click OK and to add the new slots return to the Rack Properties dialog box.
Tip
• In the Rack Properties dialog box, the software now displays the
number of slots that you added.

10. Click the Associate Symbols tab to associate a symbol with the current rack. The
software will use this symbol when generating a report in the Enhanced Report
Utility. For details, see Associate a Symbol with an Item, page 469.
Note
• When duplicating a rack that contains child items, the software duplicates
the rack together with its child items.
Related Topics
Create a Slot
folder. Then, select a desired reference panel.
category folders.
• Expand the Panels by Location hierarchy to display the available
locations and their panels. Then, select a desired panel.
3. In the Domain Explorer or in the Reference Explorer, expand the hierarchy of a
panel to display the existing racks.
4. Right-click a rack and then click New > Slot.
5. On the Slot Properties dialog box, enter the values for the new slot as you require
and click OK.
Related Topics

Device Panels: An Overview

A device panel in SmartPlant Instrumentation is a wiring item that has wiring and
instrument tag information, for example transmitters, transducers, sensors, and so
forth.
Wiring information consists of a signal (a wire group), signal level, and signal
sequence. An instrument generates a signal which is carried through a group of
wires. These wires are connected to a device panel associated with that instrument.
The software propagates the signal through the wires on different levels. Signal
levels can be, for example, plus, minus, and shield. A signal sequence is a method
used by SmartPlant Instrumentation to assign numbers, in ascending or descending
increments, to connection points along the signal propagation path at the same signal
level.
The following diagram indicates how a device panel is associated with an instrument.
You may then continue the wiring routing as required.
Each signal level defines a signal routing associated with a particular loop. It is
possible to have up to 99 levels within one signal.
Note that SmartPlant Instrumentation automatically tracks signals and assigns the
signal, signal level, and signal sequence values when you create a device panel.
Also, if a device panel is a child item of another panel, the software does not
duplicate the child device panel when duplicating the parent panel.
Related Topics
• Principles of Creating Device Panels, page 510

Principles of Creating Device Panels

SmartPlant Instrumentation offers the following options for device panel creation:
• Create an individual device panel in the Domain Explorer. This device

panel will not be associated with any instrument and will not have a
device cable.
• Create a device panel for an existing instrument and configure its
connection manually or automatically.
• Create a new instrument with an associated device panel and device cable.
You can configure the connection automatically or manually as desired.
SmartPlant Instrumentation provides you with an easy to use mechanism to create
device panels and their wiring directly from the Instrument Index module.
Alternatively, you can create the connection information manually in the Device
Panels window in the Wiring module, including the terminals, the cable, and the
connections between them. The Device Panels window can help create the
connection information needed in most cases where a `single' cable is connected to
the terminals of the instrument.
Before creating a device panel with wiring information you need to define a number
of reference items. These reference items are the panel, cable, and connection type.
You can also define appropriate instrument type profiles that include wiring
definitions. When creating an instrument based on a defined instrument type profile,
the software automatically checks if the instrument that is being added needs to have
a device panel. Based on the given default settings, the software will create the panel,
the cable, and the connections between them. Also, SmartPlant Instrumentation
automatically propagates the signals and names the device panels and cables
according to the appropriate naming conventions defined in the Administration
module. If no naming convention for device cables has been defined, the software
names the cable after the instrument, when the name is prefixed with "C-".
Related Topics

Managing Device Panels Common Tasks

The following tasks are used frequently when you manage the device panels and
cables in your plant.
Create an Instrument with an Automatically Configured Device Panel

This option enables you to create a new instrument with an associated device panel
and device cable. In this case, SmartPlant Instrumentation automatically creates a
device panel and a device cable and automatically configures the required connection
for you. SmartPlant Instrumentation does not prompt you to select a reference panel,
reference cable, or a connection type. The software selects the default configuration
for the new device panel, device cable, and connection type that you have defined in
the Wiring and I/O Profile group box of the Instrument Type Profile dialog box in
the Instrument Index module. The new device panel will have the same name as the
new instrument. SmartPlant Instrumentation will create the new instrument
according to the wiring profile defined for it in the Instrument Index module. Make
sure that you set and activate all the required instrument type profiles before you start
creating new instruments. For more information, see Create an Instrument with an
Automatically Configured Device Panel, page 514.
Create an Instrument with a Manually Configured Device Panel

You use this option to create a new instrument with an associated device panel and
device cable. In this case, SmartPlant Instrumentation creates a device panel and a
device cable and lets you manually configure the required connection. The software
prompts you to select a reference device panel and reference cable that will be used to
create the new device panel and cable. SmartPlant Instrumentation copies the
definitions for the new device panel and cable from the selected reference panel and
cable that you defined in the Reference Explorer. You can also select an existing
connection type and you can name the new device panel as you require. SmartPlant
Instrumentation creates the new instruments according to the wiring profile that you
defined in the Instrument Index module. Make sure that you set and activate all the
required instrument type profiles before you start creating new instruments. For more
information, see Create an Instrument with a Manually Configured Device Panel,
page 516.

Create an Instrument Without a Device Panel

This option enables you to create a new instrument in the Device Panels window
without creating a device panel or a device cable. You can then select an existing
device panel and associate it with the new instrument. You can also create a new
device panel for the new instrument if needed. Note that SmartPlant Instrumentation
creates the new instrument according to the wiring profile defined for it in the
Instrument Index module. Make sure that you set all the required instrument type
profiles before you start creating new instruments.
For more information, see Create an Instrument Without a Device Panel, page 518.
Create Device Panels for Selected Instruments

This option enables you to create device panels associated with selected a
instruments. This process also includes the creation of the required device cables that
will be connected to the new device panels. You can let SmartPlant Instrumentation
configure the connection for you or you can choose the manual configuration option
that allows you to configure the connection:
• Automatic configuration — the software creates a device panel, a

device cable, and automatically configures the required connection for
you. SmartPlant Instrumentation does not prompt you to select a reference
panel, reference cable, or a connection type. Instead, the software selects
the reference configuration for the new device panel, device cable, and
connection type that you have defined in the Wiring and I/O Profile
group box of the Instrument Type Profile dialog box in the Instrument
Index module. The new device panel will have the same name as the new
instrument. Make sure that you set and activate all the required instrument
type profiles before you start creating new instruments.
• Manual configuration — SmartPlant Instrumentation creates a device
panel and a device cable and lets you manually configure the required
connection. The software prompts you to select a reference panel and
reference cable that will be used to create the new device panel and cable.
SmartPlant Instrumentation copies the definitions for the new device panel
and cable from the selected reference panel and cable that you defined in
the Reference Explorer. You can also select an existing connection type
and name the new device panel as needed.
For more information, see Create Device Panels for Selected Instruments, page 521.

This procedure explains how to create a device panel that is not associated with any
instrument and not connected to any device cable. For more information, see Create
an Unassociated Conventional Device Panel, page 499.

Associate Instruments with Device Panels

This option enables you to associate an instrument with a device panel. This feature
is useful when, for instance, you create a number of device panels in the Domain
Explorer by copying a reference item from Reference Explorer. The device panels
you create in the Domain Explorer are not associated with any instruments and they
are not connected to device cables. A device panel must be associated with an
instrument before you can create a device cable for it.
For more information, see Associate Instruments with Device Panels, page 523.
Dissociate Device Panels from Instruments

This feature enables you to dissociate an instrument from a device panel. When
carrying out this procedure, SmartPlant Instrumentation automatically disconnects
single cables belonging to the dissociated device panels. Furthermore, the software
renames the disconnected cables to '?-' plus <name>. For example, a cable named 'C-
FT -2221' is renamed to '?-C-FT -2221'.
SmartPlant Instrumentation renames the cable to draw your attention to the fact that
the cable is not connected to any device. In addition, the software renames the wires
to SPARE throughout the signal run. For more information, see Dissociate Device
Panels from Instruments, page 523.

This pre-assignment serves several purposes:
• Pre-assign the required junction boxes to define an Auto-Wiring routing

task.
• Connect multiple pre-assigned device cables in batch mode.
• Filter the display of cables in the Domain Explorer so that only pre-
assigned device cables for connection with junction boxes are displayed.
For details, see Pre-Assign Junction Boxes to Device Panels, page 620.
Create a Device Cable

You use this option to create a new device cable and connect it to a selected device
panel. This feature is useful when you created a device panel in the Domain
Explorer, associated it with an instrument in the Device Panels window, but have
not yet defined a device cable for it. You can configure the cable and its connection
type manually or you can let SmartPlant Instrumentation select the reference cable
and connection type automatically. For more information, see Create a Device
Cable, page 524.

Rename Device Cables in Batch Mode

This option enables you to select a panel with device cables (cables connecting a
device panel and any other panel) and rename all the device panel cables connected to
this panel in batch mode. For more information, see Rename Device Cables in Batch
Mode, page 525.
Related Topics
Create an Instrument with an Automatically Configured

Device Panel
1. Activate the instrument type profile default settings as follows:
a. Click File > Preferences.
b. In the tree view pane, to expand the tree, click beside Instrument Index.
c. Click Profile.
d. Under Activate instrument type profile options, select the Wiring check
box.
e. Click OK
2. In the Wiring Module window, do one of the following:
• Click .
• On the menu bar click Actions > Device Panels.
3. In the Device Panels window, clear the Manual configuration check box.
• Click .
• On the menu bar click Actions > New Tag.
5. In the New Tag Number dialog box, do the following:
want to create a conventional instrument, Foundation Fieldbus instrument,
HART instrument, Telecom instrument, and so forth.
b. Type the name of the new instrument. If needed, it is possible for instruments
and device panels to have the same names. Make sure that you follow the
naming conventions for new tag numbers. For details, see Instrument Tag
Naming Convention, page 388.
c. Click OK to create the instrument.

6. If more than one function identifier exists for the current instrument type
acronym, on the Select Instrument Type dialog box, select the appropriate
instrument type, and then, click OK.
Tips
• If the instrument name does not correspond to an existing loop name,
SmartPlant Instrumentation prompts you to enter a loop name based on
the tag number you have entered. The software automatically
associates the new instrument with the loop if the loop identifier
already matches an existing loop.
prompt always appears. In this case, you have to complete the loop
number. If a profile exists for the selected instrument type, the
software creates the new instruments for that instrument type
according to the selected reference items For details, see Define
Instrument Type Default Settings, page 378.
7. In the Loop Name dialog box, do one of the following:
• Type the loop number name that the new instrument will be associated
with.
• Accept the displayed value to create a new loop with this name.
• Click OK to create the new loop number.
• Click Cancel to create the new instrument without a loop association.
9. On the Tag Number Properties dialog box, edit the instrument properties as you
require and click OK.
Note
• The software adds the new instrument to the list of instruments in the
Device Panels window. Also, you can see the new instrument in the
Instruments folder of the Domain Explorer.
Related Topics

Create an Instrument with a Manually Configured Device

Panel
1. Activate the instrument type profile default settings as follows:
c. Click Profile.
d. Under Activate instrument type profile options, select the Wiring check
box.
e. Click OK
• Click .
3. In the Device Panels window, select the Manual configuration check box.
• Click .
and device panels to have the same names. Make sure that you follow the

Tips
already matches an existing loop.
with.
9. On the Create Device Panel and Cable dialog box, under Device panel, accept
or the displayed name of the device panel that will be created with the current
instrument.
Tip
• The Create Device Panel and Cable dialog box opens only if the
instrument that you creating is based on an instrument type profile that
has at least partial wiring definitions.
10. From the Reference device panel list, select a reference device panel that you
want to use as a basis for the new device panel.
Tips
• The displayed reference panel is the one that you defined in the
Instrument Index module, in the Instrument Type Profile dialog box,
under Wiring and I/O Profile.
• The properties of the reference panel that you select determine whether
one or both of the Conventional connections and Plug-and-socket
connections group boxes are enabled, and the values that are initially
displayed.

11. In the active group boxes, to define the device cables, do the following as
necessary:
• To modify the properties of a selected device cable connection, click
Properties, and in the dialog box that opens, change the values as
necessary.
• To add an additional device cable connection, click New, and in the
dialog box that opens, enter the appropriate values.
• To delete selected cable connections, click Delete.
12. Click OK to complete the process.
Note
• The new device panel appears next to the selected instrument in the
Device Panels window. SmartPlant Instrumentation displays a cable icon
next to the new device cable indicating that a device cable is
connected to it.
Related Topics
Create an Instrument Without a Device Panel

1. Deactivate the instrument type profile default settings as follows:
c. Click Profile.
d. Under Activate instrument type profile options, clear the Wiring check
box.
e. Click OK
• Click .
3. In the Device Panels window, do one of the following:
• Click .

4. In the New Tag Number dialog box, do the following:

and device panels to have the same names. make sure that you follow the
Tips
already matches an existing loop
with.
Note
• The software adds the new instrument to the list of instruments in the
Device Panels window. Also, you can see the new instrument in the
Instruments folder of the Domain Explorer.
Related Topics

Create Device Panels and Cables in the Instrument Index

1. In the Instrument Index Module window, do one of the following to open the
Instrument Index Standard Browser view:
• On the menu bar, click Actions > Standard Browser View.
• On the toolbar, click
• Right-click, and on the shortcut menu, click Apply Profile > Create
Device Panel and Cable.
• On the Actions menu, click Apply Profile > Create Device Panel
and Cable.
4. On the Results dialog box, view the propagation results, and then click Close.
Note
• To make this feature work, you must select the Create wiring check box
and choose a reference device panel on the Wiring and Control System
tab in the instrument type profile of the selected tag number before you
attempt to create a new device panel. You can also select a reference
device cable if you want SmartPlant Instrumentation to create device
cables with the device panels. For more details, see Define an Instrument
Type Profile, page 377.
Related Topics
• Define a Standard Browser View for the Instrument Index, page 437

Create Device Panels for Selected Instruments

• Click .
• Select the Manual configuration check box to define the device panel
and cable manually.
• Clear the Manual configuration check box to define the device panel
and cable automatically.
3. On the menu bar, click Actions > New Tag or click on the toolbar.
4. Select the instruments for which you want to create device panels and cables.
You can use the Ctrl and Shift keys to select multiple instruments.
5. On the menu bar click Actions > Create.
Tips
• If you cleared the Manual configuration check box, SmartPlant
Instrumentation creates and configures the device panel automatically.
The creation process ends at this point and the new device panels
appear next to the selected instruments in the Device Panels window.
The software displays a cable icon next to the new device panel
indicating that a device cable is connected to it.
• If you selected the Manual configuration check box, the creation
process continues.
6. On the Create Device Panel and Cable dialog box, under Device panel, accept
or the displayed name of the device panel that will be created with the current
instrument.
Tip
• The Create Device Panel and Cable dialog box opens only if the
instrument that you creating is based on an instrument type profile that
has at least partial wiring definitions.

7. From the Reference device panel list, select a reference device panel that you
want to use as a basis for the new device panel.
Tips
• The displayed reference panel is the one that you defined in the
Instrument Index module, in the Instrument Type Profile dialog box,
under Wiring and I/O Profile.
• The properties of the reference panel that you select determine whether
one or both of the Conventional connections and Plug-and-socket
connections group boxes are enabled, and the values that are initially
displayed.
8. In the active group boxes, to define the device cables, do the following as
necessary:
• To modify the properties of a selected device cable connection, click
Properties, and in the dialog box that opens, change the values as
necessary.
• To add an additional device cable connection, click New, and in the
dialog box that opens, enter the appropriate values.
• To delete selected cable connections, click Delete.
9. To apply the values that you set to the selected instruments with incomplete
wiring profiles, select Apply to all selected instruments with incomplete
profile.
Note
• You can also create device panels and cables for selected instruments in
the Instrument Index Standard Browser view. For details, see Create
Device Panels and Cables in the Instrument Index Standard Browser
View, page 520.
Related Topics

Associate Instruments with Device Panels

• Click .
2. In the Device Panels window, select the Manual configuration check box.
3. In the Device Panels window, select the instruments you require and then do one
of the following:
• Click .
• On the menu bar, click Actions > Associate.
4. On the Select Device Panels dialog box, select the appropriate device panels.
5. Click OK.
Note
• The new device panel appears next to the selected instrument in the
Device Panels window. You can now create a device cable for these
panels.
Related Topics
Dissociate Device Panels from Instruments

• Click .
2. In the Device Panels window, select the instruments you require and then do one
of the following:
• Click .
• On the menu bar, click Actions > Dissociate.
Related Topics

Create a Device Cable

• Click .
• Select the Manual configuration check box to define the device panel
and cable manually.
• Clear the Manual configuration check box to define the device panel
and cable automatically.
3. Select the required device panel - instrument associations for which you want to
create device cables.
4. On the menu bar, click Actions > Create.
Tips
• If you cleared the Manual configuration check box, SmartPlant
Instrumentation creates and configures the device panel automatically.
The creation process ends at this point and the new device panels
appear next to the selected instruments in the Device Panels window.
The software displays a cable icon next to the new device panel
indicating that a device cable is connected to it.
• If you selected the Manual configuration check box, the creation
process continues.
5. On the Create Device Panel and Cable dialog box, in the active group box
(Conventional connections or Plug-and-socket connections) do the following
for each device panel — associated with an instrument.
a. Click New.
b. On the dialog box that opens, enter the appropriate values.
c. Click OK.
6. On the Create Device Panel and Cable dialog box, click OK.
Note
• The new device cable appears in the Device Panels window next to the
selected instrument.
Related Topics

Rename Device Cables in Batch Mode

1. In the Domain Explorer, expand the Panels by Location or Panels by Category
folder.
2. Right-click a junction box in the tree view or select several junction boxes in the
Items pane and then right-click them.
3. On the shortcut menu, click Actions > Rename Device Cables.
4. On the Rename tab of the Rename Device Cables dialog box, select the check
boxes next to the cables that you want to rename or choose the Select All check
box to select all the cables displayed in the data window.
5. Click the Convention tab to define the cable name template, that is, the rules how
the cable names will change.
Tip
• If a name template has been defined, it is displayed in the Current
Convention field.
6. Insert and define as many conventions as required.
7. Select the Use as default check box to use the convention row definitions as your
default naming conventions.
8. Click Apply when done.
Note
• You can modify the device panel name according to your needs. Device
cable names are, however, not editable in this dialog box. You can
rename device cables in the Domain Explorer.
Related Topics

Wiring Equipment: An Overview

SmartPlant Instrumentation enables you to create and manage various types of wiring
equipment. Wiring equipment is a generic name for different termination objects that
can handle multiple input and output signals (channels). These items need an external
power supply and they usually have several terminals to feed the electronic
components. Examples of wiring equipment are barriers, isolators, trip amplifiers,
relays, and so forth. I/O cards, I/O termination items, and various terminal strips also
belong to the group called wiring equipment.
Prior to Version 7, SmartPlant Instrumentation provided for this type of objects only
by letting you create an apparatus. However, apparatus did not deal with certain
aspects of wiring equipment such as electric properties. Apparatus provided a "flat"
structure that could only group terminals on an apparatus strip under a position name.
Wiring equipment, however, introduces a structured object which you can remove,
add, and copy. You can accurately define wiring equipment properties such as
category, manufacturer, model, and so forth.
Wiring equipment is a much wider feature which allows you to create various types
of termination objects and define their electric properties. You can use wiring
equipment whenever you need to define any type of card, or piece of hardware that
you need to buy separately, count the number of units you need (BOM), install it
inside a panel, and make connections
SmartPlant Instrumentation enables you to create and manage wiring equipment items
that:
• contain various terminal strips or combination of terminal strips.

• serve multiple tags or channels.
• contain terminal strips and connectors.
• require custom properties for each wiring equipment category.
• require a specific presentation using special custom symbols.
Wiring equipment items are classified according to various categories. SmartPlant
Instrumentation is shipped with a number of these categories. You can customize
your own wiring equipment categories and create various wiring equipment items
belonging to these customized categories. For more information, see the following:
• Customize and Use Wiring Equipment Categories, page 530

• Add User-Defined Wiring Equipment Category Properties, page 532

When designing a Foundation Fieldbus or Profibus system, you can create a wiring
equipment item belonging to the fieldbus brick category. Then, under a fieldbus
brick you can add a fieldbus apparatus. This compound object provides for the
creation and management of fieldbus termination objects required for your
Foundation Fieldbus or Profibus system.
Also, note the following features of wiring equipment:
• Wiring equipment can encapsulate multiple objects, terminal strips, and

channels.
• Since every wiring equipment is a separate item , the Connection window
cannot display multiple objects as it does for an apparatus strip. Nor is it
possible to connect a cable to multiple wiring equipment items in one step.
• Using wiring equipment in combination with custom symbols provides for
a better representation of loop drawings.
• Wiring equipment information does not appear in loop drawing
generation. In most cases, it is possible to add macros and retrieve
information or use custom symbols.
• Wiring reports do not show wiring equipment. All reports continue to
show panels, terminal strips, and terminals.
Related Topics
• Wiring Equipment Common Tasks, page 528

Wiring Equipment Common Tasks

The following tasks are used frequently when you create and manage the wiring
equipment in your plant.
Customize and Use Wiring Equipment Categories

SmartPlant Instrumentation provides you with a number of predefined wiring
equipment categories. However, you can also customize your own wiring equipment
categories for wiring items that do not belong to any existing categories.
This procedure explains how to customize a wiring equipment category and add a
customized property to a category. Note that some of the shipped wiring equipment
categories have predefined properties. You can add your own customized properties
to the shipped categories as well as to the customized ones.
After customizing a new wiring equipment category, it becomes available in the

Categories list of the New Wiring Equipment dialog box and you can create new
wiring equipment items belonging to this category. For more information, see
Customize and Use Wiring Equipment Categories, page 530.
Add User-Defined Wiring Equipment Category Properties

This feature allows you to add user-defined properties to existing wiring equipment
categories. This option applies to the user-defined categories as well as to those that
have been supplied with SmartPlant Instrumentation. For more information, see Add
User-Defined Wiring Equipment Category Properties, page 532.
Create a Wiring Equipment Item

This procedure explains how to create a wiring equipment item that belongs to any
wiring equipment category except for I/O cards and I/O terminations.
You can create new wiring equipment items either in the Domain Explorer or the
Reference Explorer. If you are creating a wiring equipment item that is going to
have a frequently used configuration, we recommend that you create it in the
Reference Explorer. Reference wiring equipment items facilitate fast creation of
plant items by copying an existing wiring equipment item from the Reference
Explorer to the Domain Explorer. However, if you want to create a wiring
equipment item that does not have a configuration that you intend to use frequently,
we recommend that you create it in the Domain Explorer and in the <unit> where it
is to be physically located. This is helpful when filtering the wiring equipment items
in the current <unit>.
For more information, see Create a Wiring Equipment Item, page 533 .

Create an I/O Card

As a rule, I/O cards reside in slots. Therefore, you have to navigate to a particular
rack and select a slot where you want to create a new I/O card. Note that I/O cards
may or may not have built-in termination blocks. If an I/O card does not have a built-
in termination block, you need to associate it with an I/O termination. To define an
I/O card that has a built-in termination block, create an I/O card and then add a
terminal strip with channels under this I/O card. For an I/O card with a built-in
terminal block, you need to create a terminal strip with channels under an I/O card to
be able to effect I/O assignment and make connections.
You can create new I/O cards either in the Domain Explorer or the Reference
Explorer. If you are creating an I/O card that is going to have a frequently used
Reference I/O cards facilitate fast creation of plant I/O cards by copying an existing
item from the Reference Explorer to the Domain Explorer. However, if you want
to create an I/O card that does not have a configuration that you intend to use
frequently, we recommend that you create it in the Domain Explorer and in the
<unit> where it is to be physically located. This is helpful when filtering I/O cards in
the current <unit>.
For more information, see Create an I/O Card, page 537.
Customize the Controller/Processor List Header in I/O Card Properties

This option enables you to make the Controller/Processor list header on the Control
System tab of the I/O Card Properties dialog box dependant on the panel
manufacture to which the current I/O card belongs. For more information, see
Customize the Controller/Processor List Header in I/O Card Properties, page 542.
Create an I/O Termination

I/O terminations are wiring equipment items that are used to connect I/O cards and
other wiring items that do not have built-in termination blocks. You associate an I/O
termination with an I/O card that does not have a built-in termination block and then
make the required connections to the I/O termination. You can also associate an I/O
termination with several I/O cards if there are redundant I/O cards.
Also, you can create an I/O termination when you need to define a distant I/O card
that resides in a different panel or rack. You need to create a terminal strip with
channels under an I/O termination to be able to effect I/O assignment and make
connections.

You can create new I/O termination cards either in the Domain Explorer or the
Reference Explorer. If you are creating an item that is going to have a frequently
used configuration, we recommend that you create it in the Reference Explorer.
Reference items facilitate fast creation of plant items by copying an existing item
from the Reference Explorer to the Domain Explorer. However, if you want to
create an I/O termination that does not have a configuration that you intend to use
frequently, we recommend that you create it in the Domain Explorer and in the
<unit> where it is to be physically located. This is helpful when filtering the wiring
equipment items in the current <unit>.
For more information, see Create an I/O Termination, page 540.
Associate an I/O card with an I/O Termination

I/O terminations function as termination blocks for I/O cards that do not have built-in
termination blocks. Therefore, you need to associate an I/O termination with an I/O
card that needs a built-in termination block. You can associate only those I/O cards
that have been created in a particular rack and slot.
For more information, see Associate an I/O card with an I/O Termination, page 543.
Related Topics
Customize and Use Wiring Equipment Categories

1. On the Wiring module menu bar, click Tables > Wiring Equipment >
Categories.
2. In the Wiring Equipment Category dialog box, click New.
3. In the New Wiring Equipment Category dialog box, type a category name and
description.
4. To select a user-defined icon for the current wiring equipment category, under
Icon file name, click Browse to navigate to the icon file that you require.
Tip
• The icon that you select will appear in the Domain Explorer or the
Reference Explorer next to each wiring equipment item belonging to
the current category.
5. In the Properties group box, click Add.
6. Under Header, type the text that will appear as the property name on the
Category Properties tab of the appropriate wiring equipment properties dialog
box.

7. From the Type list, select the type of value for the new customized category
property. You will then be able to enter a value for this new property on the
box. The values can be numeric, text, or date/time.
• Click Add to define another new property.
• Click OK to accept your definitions and close this dialog box.
9. Create a new wiring equipment item .
Tip
• In the Domain Explorer, right-click a panel or a panel child item, and
then on the shortcut menu, click New > Wiring Equipment.
10. In the New Wiring Equipment dialog box, from the Category list, select the
newly created category, type the wiring equipment item name, and click OK.
11. On the General tab of the Properties dialog box, define wring equipment
properties as you require and click the Category Properties tab.
12. On the Category Properties tab, enter the values for each property as you
require,
13. Continue defining the properties of the new wiring equipment item as you need.
Note
• The software does not allow you to delete or rename the shipped wiring
equipment categories. Nor can you delete or rename any of the predefined
properties belonging to the shipped wiring equipment categories.
Related Topics

Add User-Defined Wiring Equipment Category Properties

1. On the Wiring module menu bar, click Tables > Wiring Equipment >
Categories.
2. In the Wiring Equipment Category dialog box, select a category and click
Properties.
3. To select a user-defined icon for the current wiring equipment category, under
Icon file name, click Browse to navigate to the icon file that you require.
Tip
• The icon that you select will appear in the Domain Explorer or the
Reference Explorer next to each wiring equipment item belonging to
the current category.
4. In the Wiring Equipment Category Properties dialog box click Add.
5. Under Header, type the text that will appear as the property name on the
box.
6. From the Type list, select the type of value for the new customized category
property. You will then be able to enter a value for this new property on the
box. The values can be numeric, text, or date/time.
• Click Add to define another new property.
• Click OK to accept your definitions and close this dialog box.
Notes
• You cannot delete or rename any of the predefined properties belonging to
the shipped wiring equipment categories.
• After adding a category property, it becomes available on the Category
Properties tab of the appropriate wiring equipment properties dialog box.
Related Topics

Create a Wiring Equipment Item

folder.
• Expand the Panels by Category folder and navigate to a wiring item
under which you want to create a new wiring equipment item .
• Expand the Panels by Location folder and navigate to a wiring item
under which you want to create a new wiring equipment item .
Tip
• There is a lot of flexibility in creating a wiring hierarchy in SmartPlant
Instrumentation. There is no rigid structure like "panel – terminal
strip – terminal" that limits your wiring design. Therefore, you can
create wiring equipment items under various types of items. To see
examples of possible wiring hierarchy structures, see Hierarchy
Examples of Wiring Items, page 535.
3. Right-click a wiring item under which you want to create new wiring equipment
and then on the shortcut menu, click New > Wiring Equipment.
4. In the New Wiring Equipment dialog box, from the Category list, select a
category to which the new item belongs.
Tip
• If you need to create an I/O card or an I/O termination, see Wiring
Equipment Common Tasks, page 528.
5. Under Name, type the name of the item and click OK.
6. In the Wiring Equipment Properties dialog box, on the General tab, do one of
the following to define the name of the new equipment:
the software to name the new equipment automatically according to
the naming conventions that are set for this type of equipment in the
Naming Conventions.
the name of the new equipment. Note that if you do not clear the
Apply naming convention check box, the software will ignore the
name that you type under Name.

7. Select the Double width check box if the item occupies a double width slot.
b. Select an item type, model, and manufacturer. If the required value is not
c. Enter a sequence if you need to define the sequence of the new item in its
Tip
• If you are creating a miscellaneous wiring equipment item , the
Category Properties tab is not available.
Tip
category which you can rename or delete as you wish. For details, see
Customize and Use Wiring Equipment Categories, page 530.
11. Click the Associate Symbols tab to associate a symbol with the current item .
Related Topics

Hierarchy Examples of Wiring Items

There is a lot of flexibility in creating a wiring hierarchy in SmartPlant
Instrumentation. There is no rigid structure like "panel – terminal strip – terminal"
that limits your wiring design. Therefore, you can create wiring equipment items
under various types of items.
Example 1:
Example 2:
Example 3:

Example 4:
Example 5:
Example 6:
This example shows the wiring items that can exist in the Panels by Location folder.

Example 7:
This example shows the items that can exist in the Cables folder.
Related Topics
Create an I/O Card

under which you want to create a new I/O card.
under which you want to create a new I/O card.
3. Double-click a panel and then a rack till you see the existing slots.
Tip
• As a rule, I/O cards reside in rack slots. Therefore, you have to
navigate to a slot where you want to create an I/O card. However,
SmartPlant Instrumentation allows the creation of flexible wiring
hierarchies and therefore you can add I/O cards to a number of various
item types. To see examples of possible wiring hierarchy structures,
see Hierarchy Examples of Wiring Items, page 535.
4. Right-click a slot or any other wiring item under which you want the new card
reside and then on the shortcut menu, click New > Wiring Equipment.
5. In the New Wiring Equipment dialog box, from the Category list, select I/O
Card.
6. Under Name, type the name of the new I/O card and click OK.

7. In the Wiring Equipment Properties - I/O Card dialog box, on the General tab,
do one of the following to define the name of the new card:
Naming Conventions.
b. Select an I/O card type, model, and manufacturer. If the required value is not
c. Enter a sequence if you need to define the sequence of the new card in its
11. In the Control system details group box, under I/O type, select a I/O type to
determine the actual function of the new I/O card. For example, AI, AO, DI, DP,
Fieldbus, Profibus, and so forth. You can add more values to this list in the I/O
Type supporting table in the Instrument Index module. (See the important notes
at the end of this procedure.)
12. Under Module, type the software address that this card is assigned to.
Tip
manufacturer. For details, see Customize the Controller/Processor
List Header in I/O Card Properties, page 542.
14. To view the list of all I/O terminations associated with the current I/O card, click
the I/O Terminations button.

Tip
• I/O card is a wiring equipment category that is shipped with
However, when editing I/O card properties, you can add user-defined
properties which you can rename or delete as you wish. For details,
see Customize and Use Wiring Equipment Categories, page 530.
17. Click the Associate Symbols tab to associate a symbol with the current I/O cards.
Important
Related Topics

Create an I/O Termination

folder.
under which you want to create a new I/O termination.
under which you want to create a new I/O termination.
3. Double-click a panel and then a rack till you see the existing slots.
Tip
• As a rule, I/O terminations reside in DCS panels or marshaling racks.
However, SmartPlant Instrumentation allows to create flexible wiring
hierarchies and therefore you can add I/O terminations to a number of
various item types. To see examples of possible wiring hierarchy
structures, see Hierarchy Examples of Wiring Items, page 535.
4. Right-click a slot or any other wiring item under which you want the new card
reside and then on the shortcut menu, click New > Wiring Equipment.
5. In the New Wiring Equipment dialog box, from the Category list, select I/O
Termination.
6. Under Name, type the name of the new I/O termination and click OK.
7. In the Wiring Equipment Properties - I/O Termination dialog box, on the
General tab, do one of the following to define the name of the new card:
Naming Conventions.


b. Select an I/O termination type, model, and manufacturer. If the required value
is not available on the list, click to define a new one.
c. Enter a sequence if you need to define the sequence of the new I/O
termination in its parent item . This sequence also determines the order in
which wiring items appear under their parent item in the Domain Explorer
tree view.
11. From the I/O type list, select a I/O type to determine the actual function of the
new I/O termination. For example, AI, AO, DI, DP, Fieldbus, Profibus, and so
forth. You can add more values to this list in the I/O Type supporting table in the
12. To set the new I/O termination in a distant cabinet or to associate the I/O
termination with an I/O card that resides in another panel, do the following:
a. select the Set within a distant cabinet check box.
b. Select a cabinet in the Primary I/O card group box.
13. To associate the current I/O termination with an I/O card that does not have a
built-in termination block, select the required options in the Primary I/O card
group box.
Tip
• The I/O card list contains only those I/O cards that have been created
under a rack and a slot. Fore more information, see Associate an I/O
card with an I/O Termination, page 543.
14. To define the current I/O termination as an I/O termination that serves two
redundant I/O cards, do the following:
a. Select the Define a redundant I/O card check box.
b. Select the required options in the Secondary I/O card group box.

Tip
• I/O termination is a wiring equipment category that is shipped with
However, when editing I/O termination properties, you can add user-
defined properties which you can rename or delete as you wish. For
details, see Customize and Use Wiring Equipment Categories, page
530.
17. Click the Associate Symbols tab to associate a symbol with the current I/O
termination. The software will use this symbol when generating a report in the
Enhanced Report Utility. For details, see Associate a Symbol with an Item, page
469.
Related Topics
Customize the Controller/Processor List Header in I/O Card

Properties
1. In the Domain Explorer, navigate to a panel.
2. Right-click the selected panel and then on the shortcut menu, click Properties.
3. On the General tab of the Properties dialog box, click beside the
Manufacturer list.
4. In the Panel Manufacturers supporting table, select a manufacturer and then
scroll to the right to the Controller/Processor header.
5. Click in the Controller/Processor field and type the text that you want to appear
instead of the Controller/Processor list header on the Control System tab of the
I/O Card Properties dialog box.
6. Click OK to close the Panel Manufacturers supporting table.
7. Click OK in the Panel Properties dialog box.
Related Topics

Associate an I/O card with an I/O Termination

Important
folder.
• Expand the Panels by Category folder, hierarchy and navigate to a
wiring item under which you want to create a new I/O card.
• Expand the Panels by Location hierarchy and navigate to a wiring
item under which you want to create a new I/O card.
3. Create or select an I/O card under a particular panel, rack, and slot.
4. Create or select an I/O termination that you want to associate with an I/O card.
5. In the Wiring Equipment Properties - I/O Termination dialog box, click the
Control System tab.
Tip
• To open the Wiring Equipment Properties - I/O Termination dialog
box, in the Domain Explorer, right-click an I/O termination and then
on the shortcut menu, click Properties.
6. To associate a primary I/O card, in the Primary I/O card group box, click
next to the I/O card select list arrow.

7. In the Domain Explorer, select an appropriate I/O card and click OK.
Tips
• You cannot select an I/O card whose child item is a terminal strip with
channels.
• Note that the I/O type of both the I/O card and the I/O termination
must be the same. If the I/O type of the I/O termination differs from
the I/O type of the I/O card, the software displays a warning.
8. To associate a secondary I/O card, do the following:
a. Click the Define a redundant I/O card check box.
b. In the Secondary I/O card group box, click next to the I/O card select list
arrow.
c. Click OK.
Note
• To be able to effect I/O assignment and make connections, create a
terminal strip with channels under the I/O termination you are editing.
Related Topics

Apparatus: An Overview
Apparatus is a wiring item that pertains to different types of multi-purpose I/O
devices. These devices accept wires and signals, for example, barriers, opto-couplers,
relays, repeaters, isolators, and so forth. You also use this feature to create a fieldbus
termination block whose configuration is different from an apparatus configuration.
SmartPlant Instrumentation allows you to create a group of apparatuses or a single

apparatus. An apparatus group constitutes an apparatus strip (that is, a terminal strip)
with a number of apparatuses created according to a selected apparatus configuration.
Adding a new apparatus group to a panel or a wiring equipment item starts with
configuring the new apparatuses: setting the number of apparatuses on an apparatus
strip, defining the apparatus terminal numbering pattern, signal propagation, and the
color of the terminals. After defining an apparatus configuration, you can proceed
with the creation of an apparatus group. The software opens the Terminal Strip
Properties dialog box so that you can define an apparatus strip for the new apparatus
group. After defining the apparatus strip properties in the Terminal Strip Properties
dialog box, the software creates the apparatus strip and the apparatuses according the
selected configuration.
SmartPlant Instrumentation also allows you to add a single apparatus to an apparatus

group. In this case, you do not define an apparatus configuration. Then, you can
select the new apparatus and add the required terminals.
Once you have created a new apparatus group or a single apparatus, SmartPlant
Instrumentation displays it in the Domain Explorer showing the terminals belonging
to the apparatus.
Note that an apparatus is a wiring item . Therefore, you can define apparatus
properties, duplicate, or delete an apparatus, and assign it a special symbol. The
software uses this symbol in the Enhanced Report Utility.
Related Topics
• Apparatus Common Tasks, page 546

Apparatus Common Tasks

The following tasks are used frequently when you create and manage the apparatus
items in your plant.
Define an Apparatus Configuration

You need to create an apparatus configuration before you can add an apparatus group
to a selected panel or wiring equipment item. An apparatus group constitutes an
apparatus strip (that is, a terminal strip) with a number of apparatuses created
according to a selected apparatus configuration.
When defining an apparatus configuration, you define the apparatus profile (name,
description, manufacturer, and model), the number of apparatuses, the apparatus
terminal configuration, and the position numbering.
For more information, see Define an Apparatus Configuration, page 547.
Create an Apparatus Group

SmartPlant Instrumentation allows you to add an apparatus group to a panel or a
wiring equipment item . An apparatus group constitutes an apparatus strip (that is, a
terminal strip) with a number of apparatuses created according to a selected apparatus
configuration. You can add an apparatus group to a panel or a wiring equipment item
.
The software adds an apparatus group after selecting an appropriate apparatus

configuration. You can add a new apparatus group after creating an apparatus
configuration. When adding a new apparatus to a panel, the software also creates a
new apparatus (terminal) strip on which the apparatus is created.
You can add an apparatus to a panel or to a wiring equipment item . It is also

possible to add a single apparatus to another apparatus.
For more information, see Create an Apparatus Group, page 549.
Add an Apparatus to an Apparatus Group

SmartPlant Instrumentation allows you to add a single apparatus to an apparatus
group. The software creates a new apparatus without any terminals and adds it at the
bottom of the apparatuses in the current apparatus group. If needed, you can then
change apparatus sequence within the group and add the required terminals. For
more information, see Add an Apparatus to an Apparatus Group, page 550.
Edit Apparatus Terminal Properties

The following procedure explains how to edit the properties of an apparatus terminal.
For more information, see Edit Apparatus Terminal Properties, page 551.

Configure a Fieldbus Apparatus

To create a fieldbus brick assembly, you must have a predefined apparatus group
configuration An apparatus group constitutes an apparatus strip (that is, a terminal
strip) with a number of apparatuses created according to a selected apparatus
configuration. When defining an apparatus configuration, you define the apparatus
profile (name, description, manufacturer, and model), the number of apparatuses, the
apparatus terminal configuration, and the position numbering.
Related Topics
• Apparatus: An Overview, page 545
Define an Apparatus Configuration

Important
• To facilitate fast creation of apparatus groups with various configurations,
we recommend that you create several apparatus configurations in the
Reference Explorer so that you can create different reference apparatus
groups that can be copied to the Domain Explorer.
• In the Domain Explorer, double-click the Panels by Location folder,
and select a panel.
• In the Domain Explorer, double-click the Panels by Category folder,
and select a panel.
• In the Reference Explorer, double-click the Panels folder, and select
a panel.
3. Right-click a panel to which you want to add an apparatus and then on the
shortcut menu, click New > Apparatus Group.
4. In the Apparatus dialog box, click New.
5. In the Apparatus profile group box, in the Configuration name field, type the
name of the new apparatus configuration.
6. Select the Fieldbus apparatus check box if you need to create a configuration for
a fieldbus brick. Note that the apparatus configuration for a fieldbus brick differs
from the conventional one.
7. From the Manufacturer list, select the appropriate apparatus manufacturer. If the
required value is not available, click next to the list arrow to add or edit values
for this list.

8. In the Apparatus numbering group box, type the position name in the Prefix
field if required.
Tip
• Position names can be 15-character long. This name will appear in the
Domain Explorer within the new strip (only the first four characters),
in the Connection window, and in the appropriate reports.
9. Select the Numbered check box to number the positions.
10. Select the Internal terminator check box if you need to add an internal
terminator on the new termination block.
11. In the Description field, type a short description for the new configuration.
12. From the Manufacturer list, select the appropriate termination block
manufacturer. If the required value is not available, click next to the list arrow
to add or edit values for this list.
13. From the Model list, select the appropriate termination block model. If the
for this list.
14. Use the Number of apparatuses spinner or type the required number of
apparatuses to be added. This way you can have a block of more than one
apparatuses. This number will be displayed by default when adding a new
apparatus to an apparatus strip.
15. In the Apparatus numbering group box, type the apparatus name in the Prefix
field if required.
Tip
• Apparatus names can be 15-character long. This name will appear in
the Domain Explorer within the new apparatus strip (only the first
four characters), in the Connection window, and in the appropriate
reports.
16. Select the Numbered check box to number the apparatuses.
17. In the Apparatus configuration group box, from the Orientation list, select one
of the following terminal patterns:
• Left / Right— an apparatus that has two sides: input and output (that
is, left and right).
• Left— an apparatus that has wires on the left side only.
• Right— an apparatus that has wires on the right side only.
• Regular— an apparatus that has a conventional terminal that
functions as a single unit.

18. Do the following to define the apparatus terminal name and color:
a. Click in the left and/or right terminal side text box and type the required
terminal name, for example 1A:
b. Select a color of the terminal side from the list, for example red:
19. Repeat steps 17 and 18 for the other terminal side if appropriate. Note that the
line between the two terminal list arrows represents the internal relation between
the input and output terminals.
20. Click Add Terminal to add another terminal to this apparatus configuration if
needed and then repeat steps 14 through 16.
21. Click Delete Terminal if you need to delete a selected terminal from the current
configuration.
22. Click Save and then Close. You can now add the required apparatus as needed.
Related Topics
Create an Apparatus Group

and select a panel.
and select a panel.
a panel.
3. Right-click a panel to which you want to add an apparatus and then on the
4. In the Apparatus dialog box, select the required configuration from the
Configuration name list.

Tip
• If you do not have an appropriate configuration, create one. For
details, see Define an Apparatus Configuration, page 547.
apparatuses to be added. This way you can have a block of more than one
apparatus to an apparatus strip.
7. Click Create.
Tip
• SmartPlant Instrumentation automatically assigns sequential position
numbers to each apparatus. You can edit them later if required. For
details, see Edit Apparatus Terminal Properties, page 551.
8. In the Terminal Strip Properties dialog box, define the new apparatus strip as
required and click OK. For details, see Create a Terminal Strip, page 558.
9. Click Close in the Apparatus dialog box.
Tip
• The new apparatus appears in the Domain Explorer within the new
terminal strip.
10. Connect the apparatus to the appropriate cables. Select the apparatus group you
want to connect and click . The Connection window opens displaying the
apparatus terminals in yellow:
Related Topics
Add an Apparatus to an Apparatus Group

1. In the Domain Explorer or Reference Explorer, right-click an apparatus group.
2. On the shortcut menu, click New > Apparatus.
3. In the Apparatus Properties dialog box, enter the apparatus properties as you
Related Topics

Edit Apparatus Terminal Properties

1. In the Domain Explorer, select the terminal that you want to edit.
2. Right-click the selected terminal and click Properties on the shortcut menu.
3. In the Terminal Properties dialog box, on the General tab, from the Terminal
configuration list, select the required orientation of the current apparatus
terminal.
4. Define the terminal name by typing values in the Left terminal and Right
terminal boxes as you require. The combination of the left and right terminal
name will then appear in the Domain Explorer.
5. In the Sequence field, type a unique terminal sequence number.
Tip
• This number designates the physical position of the terminal on the
strip. The software assigns this number automatically when you add a
new terminal to the selected terminal strip. If you change the sequence
number of a terminal, be sure to change the sequence numbers of the
other terminals on the apparatus strip to avoid duplicate values, which
may interfere with the termination process.
6. Define the color as required.
7. Under Details, from the Manufacturer list, select the required terminal
to open the Terminal Manufacturer dialog box where you can add additional
items to the Manufacturer list.
8. From the Model list, select the required terminal model. If the required value is
not available, click next to the list arrow to open the Terminal Model dialog
box where you can add additional items to the Model list.
9. From the Type list, select the appropriate terminal type to which the new terminal
belongs. If the required type is not on the list, click next to the list arrow to
open the Terminal Type dialog box where you can add additional items to the
Type list. The Terminal Type dialog box, also allows you to replace the default
image of terminal side icons for single and multiple connections.
10. In the Note text box, type, if required, a brief note or a remark about this terminal.
11. Click OK to create the new terminal.
Related Topics

Terminal Strips: An Overview

In SmartPlant Instrumentation, you create terminal strips based on a particular
configuration of terminals. This configuration is a repeating numbering pattern that
enables logical numbering of terminals on a strip. A strip terminal configuration
includes the total number of terminals and the terminal numbering system.
You can create terminal strips either in the Domain Explorer or the Reference
Explorer. If you are creating a terminal strip that is going to have a frequently used
Reference terminal strips facilitate fast creation of terminal strips in your plant by
copying a terminal strip from the Reference Explorer to the Domain Explorer.
However, if you want to create a terminal strip that does not have a configuration that
you intend to use frequently, we recommend that you create it in the Domain
Explorer and in the <unit> where it is to be physically located. This is helpful when
filtering the terminal strips in the current <unit>.
In the SmartPlant Instrumentation Explorer, terminal strips are child items of

panels, racks, slots, and various wiring equipment items. Terminal strips are parent
items of channels and terminals.
Related Topics
• Managing Terminal Strips Common Tasks, page 553

Managing Terminal Strips Common Tasks

The following tasks are used frequently when you manage the terminal strips and
terminals in your plant.
Define a Terminal Strip Configuration

When creating a terminal strip, you are required to use a basic repeating numbering
pattern (configuration) to enable logical numbering of terminals. A numbering
pattern identifies the basic numbering system, or stepping method used for terminals
in a terminal strip. Set +1,-1,+2,-2, for example, has a pattern of two, while the Set
1,2,3SH,4,5,6SH has a pattern of three.
You can label the terminals on a terminal strip according to any numbering system
that you require (up to ten characters in length). To facilitate logical terminal
numbering, SmartPlant Instrumentation requires you to configure the basic repeating
numbering pattern (configuration) for the terminals in the new terminal strip before
defining that terminal strip.
When creating a strip in an I/O card or I/O termination, you use configurations that
include channels. If you want to create a terminal strip without channels in one of
these panels, set the number of terminals per channel to zero.
For more information, see Define a Terminal Strip Configuration, page 554.
Modify a Terminal Strip Configuration

This procedure explains how to modify an existing configuration of terminals.
Modifying a terminal configuration does not affect the existing terminal strips. They
retain their previous terminal configuration.
For more information, see Modify a Terminal Strip Configuration, page 556.
Create a Terminal Strip

This procedure explains how to create a terminal strip. You can add a terminal strip
to a panel, rack, slot, or a wiring equipment item. For more information, see Create a
Terminal Strip, page 558.
Move a Terminal Strip to Another Parent Item

This option enables you to move a terminal strip with connected cables to another
parent item (panel, rack, slot, or wiring equipment). The software retains all the
connection definitions after moving a terminal strip. For more information, see
Move a Terminal Strip to Another Parent Item, page 559.
Add a Terminal to a Terminal Strip

This procedure explains how to add a single terminal to an existing terminal strip.
For more information, see Add a Terminal to a Terminal Strip, page 560.

Add a Group of Terminals to a Terminal Strip

This procedure explains how to add a new group of terminals to an existing terminal
strip. For more information, see Add a Group of Terminals to a Terminal Strip, page
561.
Select a Graphic for a Terminal Connection

This procedure explains how to replace the default screw head graphic that represents
a terminal connection of a terminal in the Connection window and various Panel-
Strip reports. You select a graphic for a particular terminal type and the number of
wires connected to the terminal connection. That is, a specific graphic represents a
connector type and whether there is no wire, a single wire, or multiple wires,
connected on that particular side of the terminal. For more information, see Select a
Graphic for a Terminal Connection, page 563.
Related Topics
• Terminal Strips: An Overview, page 552
Define a Terminal Strip Configuration

1. In the Domain Explorer or Reference Explorer, right-click a panel.
2. On the short-cut menu, click New > Terminal Strip.
3. On the Terminal Strip Configuration dialog box, click New.
4. On the Number of Terminals in Pattern dialog box, type or select a number to
define the number of terminals to be repeated in the pattern and click OK.
Tip
• This number determines the number of rows (terminals) that will
constitute the basic repeating numbering (naming) pattern.
• This numbering pattern is shown in the Terminal Numbering
Pattern data grid on the Terminal Strip Configuration dialog box.
5. Under Configuration name, type the name of the new configuration.
6. Under Configuration description, type an optional description of the new
configuration.
7. Type or select the total number of terminals required in the terminal strip.
8. Select the starting number for the first terminal in the terminal strip.
9. Select the required number of terminals per channel or segment.

10. Select the first channel.

Tip
• If the new configuration is to be used to create I/O cards, the value in
the Number of terminals per channel and First channel fields must
be larger than zero. Otherwise, the terminals on the terminal strip are
created without channels and you will not be able to create an I/O card.
11. In the Terminal Numbering Pattern data grid, click and type in the Prefix field,
click and type a value if you want to prefix the names of the terminals.
12. Select the Incremented check box if you want the terminal number to be
incremented within the pattern.
13. Select the Numbered check box if you want the number of the terminal to appear
between the prefix and the suffix.
14. In the Suffix field, click and type a value if you want a suffix for the names of the
terminals.
15. From the Orientation list, select the connection orientation to the terminal:
• Regular— a conventional terminal that functions as a single unit.
• Left— a terminal that has wires on the left side only.
• Right— a terminal that has wires on the right side only.
• Left / Right— a terminal that has wires on the left side only.
16. Click Save.
Notes
• If the required number of terminals is not exactly divisible by the number
of terminals in a pattern, the remaining terminals are labeled SPARE.
• For examples of possible terminal strip configurations, see Terminal Strip
Configuration Examples, page 557.
Related Topics

Modify a Terminal Strip Configuration

1. In the Domain Explorer or Reference Explorer, right-click a panel.
3. On the Terminal Strip Configuration dialog box, select a configuration from the
4. Click Edit.
Tip
• The software does not allow you to change the terminal numbering
pattern of an existing configuration. Therefore, you have to define a
new configuration if you need to make such a change.
5. Under Configuration name, type the name of the new configuration.
6. Under Configuration description, type an optional description of the new
configuration.
7. Type or select the total number of terminals required in the terminal strip.
8. Select the starting number for the first terminal in the terminal strip.
9. Select the required number of terminals per channel or segment.
10. Select the first channel.
Tip
• If the new configuration is to be used to create I/O cards, the value in
the Number of terminals per channel and First channel fields must
be larger than zero. Otherwise, the terminals on the terminal strip are
created without channels and you will not be able to create an I/O card.
11. In the Terminal Numbering Pattern data grid, click and type in the Prefix field,
click and type a value if you want to prefix the names of the terminals.
12. Select the Incremented check box if you want the terminal number to be
13. Select the Numbered check box if you want the number of the terminal to appear
between the prefix and the suffix.
14. In the Suffix field, click and type a value if you want a suffix for the names of the
terminals.
15. From the Orientation list, select the connection orientation to the terminal:
• Regular— a conventional terminal that functions as a single unit.
• Left— a terminal that has wires on the left side only.
• Right— a terminal that has wires on the right side only.
• Left / Right— a terminal that has wires on the left side only.

16. Click Save.

Notes
• If the required number of terminals is not exactly divisible by the number
of terminals in a pattern, the remaining terminals are labeled SPARE.
• For examples of possible terminal strip configurations, see Terminal Strip
Configuration Examples, page 557.
Related Topics
Terminal Strip Configuration Examples

Each of the following examples demonstrates how various features of the strip
configuration operate. In each case, the terminal strip has a repeating sequence of
three terminals, and a total of 8 terminals (the last 2 terminals are designated SPARE,
and are not shown).
Input Data and Explanation Resultant Terminal

Configuration
No numbering
The + and - terminals are numbered.

The numbers are incremented for the
first terminal of each repeating sequence.


The numbers are incremented for all
the numbered terminals.

All the numbers are numbered and
incremented.
Note the use of the suffix.
Related Topics
Create a Terminal Strip

1. In the Domain Explorer or Reference Explorer, right-click one of the following
items:
• A panel
• A rack
• A slot
• A wiring equipment item, for example an I/O card
3. On the Terminal Strip Configuration dialog box, select a configuration from the
Tip
• If you do not have an appropriate terminal configuration, click New.
4. Click Create.
5. On the Terminal Strip Properties dialog box, on the General tab, under
Terminal strip type the name of the new terminal strip.

6. From the Type, Model, and Manufacturer lists, select appropriate values to
define the new terminal strip as you require. If any of the lists do not contain the
value that you need, click to open the relevant supporting table where you can
manage the contents of the select lists.
7. Type a value for mounting, dimensions, and rail if needed.
8. Under Sequence, enter a number to define the sequence of the current terminal
strip in its parent item (a panel, rack, slot, or wiring equipment).
9. To manage the revisions of the terminal strip, click Revisions.
10. Click the Associate Symbols tab to associate a symbol with the current terminal
strip. The software will use this symbol when generating a report in the Enhanced
11. Click OK to create the new terminal strip.
Related Topics
Move a Terminal Strip to Another Parent Item

1. In the Domain Explorer or Reference Explorer, select a terminal strip that you
want to move.
2. Expand the hierarchy of the target parent item.
Tip
• You can open another instance of the Domain Explorer or Reference
Explorer and place it beside the one that is already open to make the
drag-and-drop operation easier.
3. Drag the selected terminal strip to the desired parent item.
Important
• The following restrictions apply when trying to move a terminal strip with
connected cables:
• The terminal strip is associated with an instrument type.
• The terminal strip is used by an auto-wiring task.
• The terminal strip has connected terminals or channels that are
associated with control system tags.
• The terminal strip hasn't been claimed for a project.
• The terminal strip is associated with a local or general signal.
• The target parent item is a plug-and-socket box.

Add a Terminal to a Terminal Strip

1. In the Domain Explorer or Reference Explorer, select a terminal strip to which
you want to add a terminal.
2. Right-click the selected terminal strip and then on the shortcut menu, click New >
Terminal.
3. On the General tab of the Terminal Properties dialog box, accept or select the
required terminal orientation.
4. Enter the terminal number or numbers in the Left terminal or Right terminal
fields.
Tip
• Your selection of the terminal orientation determines whether the Left
terminal or Right terminal fields are available. If you select Left and
right-oriented, the software lets you enter a value for both left and
right terminals. If you select Regular, the software lets enter the
terminal number under Terminal.
5. Under Sequence, type a unique terminal sequence number.
Tip
• The sequence number designates the physical position of the terminal
on the terminal strip. The software assigns a sequence number
automatically when you add a new terminal to a terminal strip. If you
change the sequence number of a terminal, be sure to change the
sequence numbers of the other terminals on that terminal strip to avoid
duplicate values, which may interfere with the termination process.
6. Select a terminal color as needed.
7. In the Details group box, enter a channel number.
8. If the current terminal is in a channel which in turn is a wiring equipment sub-
item, enter a sequence number with in the current channel.
define the new terminal as you require. If any of the lists do not contain the value
that you need, click to open the relevant supporting table where you can
10. In the Note text box, type, if required, type a brief note or a remark about this
terminal.
11. Click the Associate Symbols tab to associate a symbol with the current terminal.

Add a Group of Terminals to a Terminal Strip

1. In the Domain Explorer or Reference Explorer, select a terminal strip to which
you want to add a group of terminals.
2. Right-click the selected terminal strip and then on the shortcut menu, click
Actions > Add Terminal Group.
3. On the Add Terminals dialog box, select an appropriate terminal configuration
from the Configuration name list. The configuration you choose determines the
labeling of the terminals you are about to create.
Tip
• If the required configuration is not available, close this dialog box and
create a new terminal configuration.
• If the selected configuration is suitable, click OK to add the terminals.
• Change the configuration according to your requirements as specified
in the steps below.
5. In the Total number of terminals spin box, enter the total number of new
terminals required.
6. In the First terminal of added group spin box, enter the number of the next
incremented terminal.
Tip
• To continue the numbered sequence of the existing terminals, you
should enter the next numerical value of the terminal, and not the
ordinal sequence. For example, if you already have 48 terminals
arranged in groups of three, where the last 3 terminal labels are +16, -
16, and SH, the value in the First terminal of added group spin box
must be 17 and not 49.

7. In the Terminal Numbering Pattern group box, do the following:

a. Type a prefix in the Prefix field if required.
b. Select the Incremented check box if you want the terminal number to be
c. Select the Numbered check box if you want the number of the terminal to
appear between the prefix and the suffix.
d. Type a suffix if required.
8. Click OK to create the new group of terminals on the terminal strip.
Note
• This dialog box does not allow you to save the changes you make to an
existing terminal strip configuration. The software applies the changes
only to the group of terminals you are currently adding.
Related Topics
Edit the Properties of a Terminal

1. In the Domain Explorer or Reference Explorer, select a terminal that you want
to edit.
2. Right-click the selected terminal and then on the shortcut menu, click Properties.
3. On the General tab of the Terminal Properties dialog box, accept or select the
required terminal orientation.
4. Enter the terminal number or numbers in the Left terminal or Right terminal
fields.
Tip
• Your selection of the terminal orientation determines whether the Left
terminal or Right terminal fields are available. If you select Left and
right-oriented, the software lets you enter a value for both left and
right terminals. If you select Regular, the software lets enter the
terminal number under Terminal.
5. Under Sequence, type a unique terminal sequence number.
Tip
• The sequence number designates the physical position of the terminal
on the terminal strip. The software assigns a sequence number
automatically when you add a new terminal to a terminal strip. If you
change the sequence number of a terminal, be sure to change the
sequence numbers of the other terminals on that terminal strip to avoid
duplicate values, which may interfere with the termination process.

6. Select a terminal color as needed.

7. In the Details group box, enter a channel number.
8. If the current terminal is in a channel which in turn is a wiring equipment sub-
item, enter a sequence number with in the current channel.
define the new terminal as you require. If any of the lists do not contain the value
that you need, click to open the relevant supporting table where you can
10. In the Note text box, type, if required, type a brief note or a remark about this
terminal.
11. Click the Associate Symbols tab to associate a symbol with the current terminal.
Related Topics
Select a Graphic for a Terminal Connection

1. On the Wiring Module window menu bar, click Tables > Terminal > Types.
2. On the Terminal Types dialog box. select a terminal type or create a new one.
3. Click in G1 box to select a graphic that will represent a terminal connection with
a single wire or without any wire.
4. Click in G2 box to select a graphic that will represent a terminal connection with
a multiple wires.
Notes
• The selected graphic appears in the G1, G2, or both boxes. The size of the
G1 and G2 boxes represents the actual size of the icons that appear in the
Connection window.
• If you do not select anything in the G1 or G2 box, SmartPlant
Instrumentation displays the default gray screw head for terminal
connections with or without single wires and the turquoise screw head
for terminal connections with multiple wires.
Related Topics

Making Connections in SmartPlant Instrumentation: An Overview
Making Connections in SmartPlant

Instrumentation: An Overview
SmartPlant Instrumentation employs two methods for implementing cable
terminations - direct visual connection, and a more advanced technique called
connection type. The connection concept behind these methods is based on the
simple idea of letting you work as you would in the field, meaning that if you install a
wire and connect it to a panel, for example, you can do exactly the same on the
screen.
The software enables you to make connections by using the drag-and-drop operation
in the Connection window.
You can make the following connections:
• Connect cables and cable sets to terminals in single mode — this option
allows you to connect cables one by one to the appropriate terminals.
• Connect cables and cable sets to terminals in batch mode — this option
allows you to simultaneously connect cables to the appropriate terminals
and define their connections.
Notes
• You can keep more than one Connection window open at the same time.
This can be useful when viewing the wiring routing.
• Dragging a cable, cable set, or wire to a terminal not currently visible in
the Connection window makes the screen scroll up or down until the
required terminal is displayed.
• If the width of your computer monitor allows it, you can follow the course
of a cable from one terminal strip to the other (provided that the cable is
connected between two terminal strips). You can view the cable
continuation between two terminal strips by resizing the Connection
window and clicking (or clicking Actions > Adjacent on the
Connection window menu bar) to simultaneously display both terminal
strips.
• When connecting the right side of a DCS or PLC panel, the software
increases the signal level by one.
Related Topics
• Making Connections Common Tasks, page 565

Making Connections Common Tasks

The following tasks are used frequently when you make connections in SmartPlant
Instrumentation.
Define a Connection Type

This option allows you to select, create, or edit a connection type that facilitates rapid
cable set connections. You define a connection type that contains a connection
pattern. A connection type contains the definition of the pattern by which wires will
be connected on a terminal strip, and allows automatic creation and connection of
jumpers between successive cable sets. Once a wiring pattern has been defined, it can
be selected whenever desired and will determine how the connections are made. For
more information, see Define a Connection Type, page 567.
Connect a Cable or a Cable Set to a Terminal Strip

This procedure explains how to connect a cable or cable set to a terminal strip. The
connection is accomplished by dragging a cable or cable set to a terminal in the
Connection window. Then, you are required to define the cable connection, which
effects the connection. Note that you can connect only plant cables and panels and
not reference panels and cables. However, while the Connection window is open,
you can copy reference items from the Reference Explorer to the Domain Explorer
and then drag them to the Connection window. For more information, see Connect a
Cable or a Cable Set to a Terminal Strip, page 571.
Connect Device Cables to a Terminal Strip in Batch Mode

Use this procedure to connect device cables or cable sets to a terminal strip in batch
mode. Note that these are device cables that are already connected to device panels.
For more information, see Connect Device Cables to a Terminal Strip in Batch Mode,
page 573.
Connect a Wire to a Terminal Strip

This procedure explains how to connect a wire to a terminal strip. For more
information, see Connect a Wire to a Terminal Strip, page 575.
Disconnect Cables, Cable Sets, and Wires

This procedure shows how to disconnect a given cable or selected cable sets and
wires from a terminal strip. For more information, see Disconnect Cables, Cable
Sets, and Wires, page 577.
Move Cables, Cable Sets, and Wires

After making initial connections to terminals, SmartPlant Instrumentation lets you
relocate cables, cable sets, and wires to another terminal on the same terminal strip.
You can move a wiring item using the drag-and-drop feature. For more information,
see Move Cables, Cable Sets, and Wires, page 576.

View Cable Connection Destinations

This option enables you to view the connection destinations of a cable that you select
in the Domain Explorer. When you select this option, you see the junction boxes
and terminals that the selected cable is connected to. For more information, see View
Cable Connection Destinations, page 581.
Display Adjacent Connections of a Cable

When you are working on wiring connections for a specific panel, you can follow the
wiring routing to an adjacent panel. For more information, see Display Adjacent
Connections of a Cable, page 582.
Display the Farthest Connection of a Cable

While working in the Connection window, in addition to displaying the adjacent
connection of a cable or a wire, you can also open the farthest connection. This
means that the software switches to the end of the wiring routing of the current wire
and displays the last panel on that end. If a signal exists in the direction that you
chose to switch to, SmartPlant Instrumentation follows the signal to the end. If there
is no signal, the software shows the panel that is connected at the end of the wiring
routing. For details, see Display the Farthest Connection of a Cable, page 582.
Trace a Signal in a Point-to-Point Wiring Diagram

You can follow a signal along a sequence of wires. SmartPlant Instrumentation uses
wire groups, group level and group sequence data to follow a signal along a series of
wires and check for any discontinuity. The wire group is the signal name
representing the tag number from which the signal originates. The result is displayed
in a point-to-point wiring diagram that you can print. For more information, see
Trace a Signal in a Point-to-Point Wiring Diagram, page 584.
Add Jumpers to the Existing Wiring

SmartPlant Instrumentation enables you to create and connect multiple jumpers in a
repetitive way. You can define constant gaps between the jumpered terminals if
required. Also, you can jumper the last remaining terminal in the selected terminal
pattern if required. Note that unlike regular wires, jumpers do not propagate signals.
You can assign a wire group to a jumper manually on the Terminal Connection
dialog box. For more information, see Add Jumpers to the Existing Wiring, page 578.
Remove a Jumper from the Existing Wiring

This procedure explains how to remove a jumper. For more information, see Remove
a Jumper from the Existing Wiring, page 579.

Generate a Connection Report from the Connection Window

While in the Connection window, you can generate a connection report for the
current terminal strip. The report lists all the cables connected to the selected
terminal strip and shows all the cable-sets within each cable, the wire tags, their color,
and terminal number. This report does not show adjacent connections. For more
information, see Generate a Connection Report from the Connection Window, page
586.
Related Topics
• Making Connections in SmartPlant Instrumentation: An Overview, page
564
Define a Connection Type

1. Start the Wiring module and then do one of the following:
• Click Actions > Connection Types.
• Click on the Wiring module toolbar.
2. On the Connection Type dialog box, click New.
3. On the New Connection Type dialog box, configure the new connection type by
selecting the number of wires and jumpers that the new connection type will
contain.
4. Click OK to return to the Connection Type dialog box.
5. In the Connection type text field, type the name of the new connection type.
6. In the Description text field, type a short description if needed.
7. In the Skip between sets field, enter the number of terminals that will be skipped
between the first terminals of each cable set.
8. In the Wires group box, do the following:
a. Click in the Skip text field and type the number of terminals to skip before
connecting this wire in the cable set. The skip is always relative to the first
terminal to which a wire in the cable set is connected. Enter the number of
terminals to be skipped according to your needs. In most cases, this value is
incremented for successive wires. You can accept the displayed value if
suitable.
b. In the Side field, click the A – Active or O – Opposite option button to
select the terminal side to which you want to connect each wire. The side that
is currently active depends on the side you start to connect.
c. Click in the Land field to connect a wire. A screw head appears indicating
that a connection has been configured.

Tip
• The Wire field displays a specific wire in the cable set. The displayed
W00x values represent the wire names and are used to illustrate the
current connection type configuration. This field is not editable.
9. To configure a jumper connection, do the following in the Jumpers group box:
a. From the Type list, select a jumper type from this list. The values in this list
are determined in the Wire Type supporting table.
b. From the Color list, select the required jumper color.
c. Click in the End 1 and End 2 fields to connect to a jumper. A screw head
shows up indicating that a connection has been configured.
d. Click in the Skip text field and type the number of terminals to skip for the
jumper in the cable set for landing. You can accept the displayed value if
appropriate. Repeat the same procedure for the other end.
e. In the Side fields, click the A – Active or O – Opposite option button to
select the terminal side where the jumper will be connected. The side that is
currently active depends on which side you start to connect.
Tips
• The options in the Jumpers group box become available only if you
have selected jumpers to be configured on the New Connection Type
dialog box.
• The terminals to which the ends of a jumper are connected must reside
on the same strip. Both ends of a jumper must be connected for it to
appear in the display region. For an illustration, see Connection Type
Examples, page 569.
10. Click Save.
Related Topics
564

Connection Type Examples

Example 1: (a two-wire cable set)
The following connection type example illustrates how the connections are made for
a 2-wire cable set when the skip between cable sets is 6:
The position of the + wire in each cable set to be connected has been assigned a skip
of 0. The – wire of Set 1 has been assigned a skip of 1. The – wires of Sets 2 and 3
have each been assigned a skip of 6.

Example 2: (two wires with a jumper)
The following example illustrates how you can connect a single pair to a strip and
create a jumper on the opposite side between the first and third terminals. The next
pair will be connected to the third terminal, if the skip between sets parameter was set
to 2.
The outcome of this operation, when terminating multiple pairs, will be pairs
connected sequentially where every first wire in a set is connected by a jumper to the
one that follows, as illustrated below:
Related Topics
• Define a Connection Type, page 567

Connect a Cable or a Cable Set to a Terminal Strip

2. Expand the Cables folder or a panel hierarchy and then right-click one of the
following items:
• a cable
• a cable set
• a panel
• a terminal strip
3. On the shortcut menu, click Actions > Connection.
4. In the Connection window, from the Terminal strip list, select an appropriate
terminal strip.
Tip
• If the terminal strip that you need does not exist in the Domain
Explorer, you can copy a reference terminal strip from Reference
Explorer to the Domain Explorer while the Connection window is
open. (Press F8 to open the Reference Explorer.)
5. In the Domain Explorer, select the cable or cable set that you want to connect.
6. Drag the selected cable or cable set to the appropriate terminal in the data
window.
7. Drop the cable or cable set on the required terminal (shown as a screw head ) to
open the Cable Connection Definition dialog box.

8. On the Cable Connection Definition dialog box, do the following:

a. Select End 1 or End 2 for the side of the cable that you want to connect.
b. To change the terminal number where the first wire is to be connected, from
the Start at terminal list, select the required terminal.
c. In the Cable set connection details data window, select the cable sets that
you want to connect, or choose Select all cable sets.
d. From the Connection Type list, select the connection type for each cable set
that you are going to connect.
e. Select L (left) or R (right) for the physical side of the terminal where the cable
set enters. Note that screw head indicates that the cable set is already
connected on the selected cable end.
f. Click Connect to connect the selected cable sets and return to the Connection
window.
Notes
• SmartPlant Instrumentation connects the individual wires automatically in
accordance with the selected connection type.
• You can double-click a cable, cable set, wire, terminal, or terminal strip
header in the Connection window to edit it.

Connect Device Cables to a Terminal Strip in Batch Mode

2. Expand the Panels by Location or the Panels by Category folder to display the
existing panels and terminal strips.
3. Right-click a terminal strip to which you want to connect device cables, and then
on the shortcut menu, click Actions > Batch Connection.
4. In the Domain Explorer, select the device cables that you want to connect and
drag them to the Batch Device Cable Connection window.
Tips
• You can only drag those cables that have been connected to device
panels on one end and unconnected on the other end. Also, there
cannot be any connectors on the unconnected end.
• You can filter the display of cables in the Domain Explorer so that
you can easily find the device cables that you need. For details, see
Pre-Assign Junction Boxes to Device Panels, page 620.
• Click on the lower toolbar to open a pop-up window that displays

which terminals are connected.
• The settings displayed under Starting Terminal are determined by the
automatic implementation of connection type definitions for the cables
that you move to the data window.
• You can change the order of cables in the data window by dragging
them up or down.
5. To change the connection type for a given cable set, from the Connection Type
list, select an appropriate connection type.
6. When changing the connection type for the first cable set, in response to the `Do
you want to change the connection type for all cable sets?' prompt, do one of the
following:
• To change the connection type for all of the cable sets displayed in the
data window, click Yes. Note that this also results in automatic
renumbering of the starting terminals for all of the cable sets.
• To change the connection type for the given cable set only, click No.
Note that this results in no automatic renumbering of starting
terminals.

7. To change the cable set starting terminals, do one of the following:

• To change the starting terminal for a given cable set, select a value
from the Starting Terminal list.
• To automatically renumber starting terminals according to cable type
definitions, from the selected cable set and below, click Actions >
Reassign.
8. Under Terminal Side accept the default setting L to connect the device cables to
the left side of the panel, or select R to connect the cables to the right side.
9. Under Connect all shields to, do one of the following:
• Do not select any terminal. Use this option to connect the shields
according to the configuration of the active cable types.
• Select a common terminal to which you connect all of the shields.
10. Under Connect all overall shields to, do one of the following:
• Do not select any terminal. Use this option to connect the overall
shields according to the configuration of the active cable types.
• Select a common terminal to which you connect all of the overall
shields.
• To prepare for connection of the all of the device cables displayed in
the data window, clear Connect selected rows only.
• To prepare for connection of some of the device cables displayed in
the data window, select the rows that you want to connect and then
select Connect selected rows only.
12. To connect the devices cables to the terminal strip according to your settings, do
• Click Actions > Connect.
• On the lower toolbar, click .
Related Topics
564

Connect a Wire to a Terminal Strip

2. Expand the Panels by Category or Panels by Location folder.
3. Right-click a panel or a terminal strip and then on the shortcut menu, click
Actions > Connection.
4. If, in the Domain Explorer, you selected a panel and not a terminal strip, in the
Connection window, select one from the Terminal Strip list.
5. In the Domain Explorer, select a cable and expand its hierarchy to display its
wires.
6. Select a wire and drag it to a terminal (shown as a screw head ) in the
Connection window.
Tip
• Click to find a specific terminal or the next available terminal.
SmartPlant Instrumentation marks your terminals with .
7. On the Wire Connection Options dialog box, select the wire that you require and
then click OK.
Notes
• If you are connecting more than one wire in a cable or cable set to a group
of terminals on a terminal strip, make sure that the wire end that you
connect is the same for all the wires. This is important to ensure that the
connections appear correctly in reports.
• If one end of the wire is already connected, SmartPlant Instrumentation
selects the loose end by default.
Related Topics
564

Move Cables, Cable Sets, and Wires

1. In the Connection window, select the appropriate cables, cable sets, or wires.
2. Drag the selected items to another terminal. If you are moving a cable or a cable
set, the Cable Connection Definition dialog box opens. If you are moving a
wire, the Wire Connection Options dialog box opens.
3. Select the required definitions on the Cable Connection Definition dialog box or
on the Wire Connection Options dialog box and then click Connect or OK
respectively.
Notes
• The Connection window reopens showing the new connections.
• You should ensure that there are sufficient terminals to accept all the wires
to be relocated.
• You can connect any number of wires to a single terminal.
• If you are connecting more than one wire in a cable or cable set to a group
of terminals, make sure that the wire end that you connect is the same for
all the wires. This is important to ensure that the connections appear
correctly in reports.
Related Topics
564

Disconnect Cables, Cable Sets, and Wires

1. In the Connection window, select the cable, cable sets, or wires you want to
disconnect.
Tip
• SmartPlant Instrumentation automatically selects the wiring items in
the hierarchy below the item that you select.
2. In the Connection window, do one of the following:
• Right-click the selected item then click Disconnect on the shortcut
menu.
• On the menu bar, click Connection > Disconnect.
• Click on the Connection toolbar.
Notes
• If a terminal strip or terminal is connected to more than one cable, only
wires which are unique to a terminal or which belong to a cable at the top
level layer (at the front) will be disconnected by SmartPlant
Instrumentation.
• SmartPlant Instrumentation uses to represent terminals on which
multiple wires are connected.
• To ensure disconnection of the correct cables or cable sets, first move the
cable you want to disconnect to front by selecting it from the Cable name
list.
Related Topics
564

Add Jumpers to the Existing Wiring

2. Expand the Panels by Location or the Panels by Category folder to display the
existing panels and terminal strips.
3. Right-click a panel or a terminal strip and then on the shortcut menu, click
4. In the Connection window, select a wire connected to the terminal that will be
the first terminal connected to the first jumper.
Tip
• Do not make any selection if you want the terminal connected to the
first wire to be the connected to the first jumper.
• Right-click the selected wire and then on the shortcut menu, click
Connect Jumpers.
• Click Connection > Connect Jumpers.
• Click .
6. On the Connect Jumpers dialog box, do the following:
a. From the Terminal one - first jumper list, select a terminal and set its Left
or Right orientation.
b. From the Terminal two - first jumper list, select a terminal and set its Left
or Right orientation.
c. If you need to define a constant gap between the jumpered terminals, enter a
value in the Interval between jumpers box.
d. From the Last terminal list, select the last terminal in the pattern that you
want to jumper.
e. Select the Jumper the last terminal check box if you want to jumper the last
remaining terminal in the terminal pattern.
f. Select a jumper color.
g. In the Jumper name box, type the name of the new jumper, or accept the
default setting. By default, SmartPlant Instrumentation suggests a name for a
new jumper of the format J<first terminal name>/<second terminal name>.
You can change the preferences so as not to display a suggested jumper name.
For details, see Set Preferences for Automatic Naming of Jumpers, page 579.
7. Click OK.
Note
• Your new jumpers appears in the Connection window.

Set Preferences for Automatic Naming of Jumpers

2. Expand the Wiring hierarchy in the tree view and select Jumpers.
3. Under Automatic naming, select Name jumpers automatically.
4. Click OK.
Related Topics
• Add Jumpers to the Existing Wiring, page 578
564
Remove a Jumper from the Existing Wiring

1. In the Connection window, select a jumper you want to remove.
• Right-click the selected jumper and then on the shortcut menu, click
Disconnect.
• On the Connection window menu bar, click Actions > Disconnect.
• Click .
Notes
• Jumpers exist in the database as long as they are connected. Disconnected
jumpers are deleted from the database.
• You cannot move a jumper. Instead, disconnect the jumper that you do
not need and then add a new jumper as required.
Related Topics
564

Assigning Wire Designation

The Terminal Connection dialog box opens when you click a screw head on the
terminal in the Connection window. This dialog box shows the Wire Group, Group
Level, and Group Sequence of the wires connected to the selected terminal.
When you click on Wire Group, Group Level, or Wire Sequence data, you can
reassign the wire designation by selecting the required value from the appropriate
lists.
You can assign a new signal name to more than one terminal without having to
browse through the Wire Group list for each terminal. You use this feature only
with terminals whose Wire Group is currently undefined (that is, the Wire Group
data field displays asterisks).
First, you need to assign a new signal name to a terminal whose Wire Group is
currently undefined. After assigning the new signal to the current terminal, select
another terminal (click the up or down arrow or select a terminal in the Terminal
name list). If you now click in the Wire Group data field, the list opens with the
new signal name selected by default. Clicking the terminal name enables you to
navigate quickly.
Note
• If you want to reassign wire designations on the Terminal Connection
dialog box, it is advisable to plan your changes in advance on paper, to
avoid conflicting Wire Group, Group Level, and Group Sequence data.
564

Updating Connection Data

Multiple users can work on the same module. In most cases, you may not edit data
that is being edited by another user, however, under certain circumstances, other users
may have made changes that affect the data in the Connection window. For
example, another user has added a new plant cable. This cable does not appear in the
Domain Explorer until you refresh the window display. Click to do so.
The Connection window is automatically refreshed only when you open it.
However, SmartPlant Instrumentation does not refresh the data in the Connection
window, if you have several instances of the Connection window open and you
switch from one Connection window to another.
Related Topics
564
View Cable Connection Destinations

1. In the Domain Explorer, double-click the Cables folder.
2. Right-click a cable.
3. On the shortcut menu, click Actions > Destination.
Notes
• The Cable Destination pop-up window displays individual connections
for the selected cable. Note that each line shows a connection to a
different panel.
Related Topics
564

Display Adjacent Connections of a Cable

1. In the Connection window, select a cable, cable set, or wire whose routing you
want to trace on a particular terminal side.
Tip
• If you select a cable or cable set, SmartPlant Instrumentation displays
the adjacent connection for the first wire. You can follow the routing
for the other wires by selecting other panels from the list.
• On the menu bar, click Actions > Open Adjacent Connection.
• Right-click the selected item and then on the shortcut menu, click
Open Adjacent Connection.
• Click on the lower toolbar.
Note
• The Connection window opens, showing the adjacent panel which is the
continuation of the wiring routing.
Related Topics
564
Display the Farthest Connection of a Cable

1. In the Connection window, select a wire whose routing you want to trace on a
particular terminal side.
• On the menu bar, click Actions > Open Farthest Connection.
• Right-click the selected item and then on the shortcut menu, click
Open Farthest Connection.
Note
• The Connection window opens, showing the farthest panel at the end of
the wiring routing. For examples, see Examples of Farthest Connections
of Cables, page 583.
Related Topics

Examples of Farthest Connections of Cables

While working in the Connection window, in addition to displaying the adjacent
connection of a cable or a wire, you can also open the farthest connection. This
means that the software switches to the end of the wiring routing of the current wire
and displays the last panel on that end. If a signal exists in the direction that you
chose to switch to, SmartPlant Instrumentation follows the signal to the end. If there
is no signal, the software shows the panel that is connected at the end of the wiring
routing.
Example 1:
In this example, you selected the left side connections of JB-2. Therefore, SmartPlant
Instrumentation will display the connection of the device panel.
Example 2:
In this example, you selected the right side connections of JB-2. Therefore, the
software will display the connection of the DCS or the I/O card.
Related Topics
564


1. Do one of the following to open the Point-to-Point Wiring Diagram:
• In the Domain Explorer, right-click a cable, cable set, panel, or a
terminal strip and then on the shortcut menu, click Actions >
Connection. For best results, make sure that the connection
information is complete for the items that you selected.
• In the Domain Explorer, right-click a cable, cable set, panel, or a
terminal strip and then on the shortcut menu, click Actions > I/O
Assignment. For best results, make sure that the I/O assignment
information is complete for the items that you selected.
2. In the Connection window, from the Terminal strip list, select the terminal strip
to which you want to trace the signal path.
Tip
• If you are working in the I/O Assignment window, skip steps 2 and 3.
3. From the Cable list, select the cable containing the wire for which you want to
trace the signal path.
• In the Connection window, select the wire for which you want to trace
the signal path.
• In the I/O Assignment window, under Channel Assignment, select a
channel associated with an instrument tag.
5. Click to locate a specific terminal or channel.
6. Do one of the following to generate the Point to Point Wiring Diagram report:
• On the module toolbar, click .

• On the menu bar, click Reports > Point to Point Wiring Diagram.
• In the Connection window, right-click the selected wire and on the
shortcut menu click Point to Point Wiring Diagram.

7. Do one of the following when prompted to preview the report:

• Click Yes to preview the Point to Point Wiring Diagram.
• Click No to print the report without displaying it on your computer.
Notes
• To view the point-to-point diagram legend, scroll down to the lower part
of the preview.
• To hide the default notation of level and sequence of the signals and tags,
click View > Show Level/Sequence. To display the notation, click again.
• You can resize the fonts of the cable and cable set names in the Point to
Point Wiring Diagram. For details, see Change the Font Size of Cable
and Cable Set Names, page 585.
Related Topics
564
• Signal Propagation: An Overview, page 631
Change the Font Size of Cable and Cable Set Names

1. In the Point-to-Point Wiring Diagram, click View > Font Size.
2. Do one of the following on the Resize Fonts dialog box:
• In the Size field, type the required font size of the cable and cable set
names.
• Use the spinner to increase or decrease the font size.
3. Click OK to close the Resize Fonts dialog box and return to the Point to Point
Wiring Diagram print preview where you see the changes you made to the cable
and cable set name fonts.
Related Topics
564

Generate a Connection Report from the Connection

Window
• On the menu bar, click Reports > Connection.
• Click .
2. In the Print Preview prompt, click Yes to display the report print preview or
click No to print out the report without displaying its print preview.
Related Topics
• Generating Wiring Reports Common Tasks, page 677
• List of Wiring Reports, page 678
564

I/O Assignment: An Overview

The I/O assignment in SmartPlant Instrumentation enables you to assign a channel to
a specific instrument or a fieldbus segment.
I/O assignment for an instrument is performed in two stages:

1. Associating (coupling) an instrument with a control system tag.
2. Assigning the coupled pair to a channel.
I/O assignment for a segment is also performed in two stages:
1. Associating (coupling) each virtual tag with a control system tag.
2. Assigning the coupled pairs to an I/O channel.
Note
• The software displays the available instruments according to the current
I/O type. You can change the I/O type by setting the appropriate I/O
assignment preference. For details, see Set I/O Assignment Instrument
Tag Preferences, page 591.
Related Topics
• Effecting I/O Assignment Common Tasks, page 588

Effecting I/O Assignment Common Tasks

The following tasks are used frequently when effecting I/O assignment in SmartPlant
Instrumentation.
Set I/O Assignment Instrument Tag Preferences

Prior to effecting I/O assignment, you can set your I/O assignment preferences for the
I/O types of the instrument tags. These preference options enable you to determine
the I/O types of the instrument tags that become available in the I/O Assignment
window. One setting allows you to make all instrument tags be available in the I/O
Assignment window regardless of their I/O type. The other setting limits the
availability of instrument tags only to those instruments whose I/O type is identical to
the I/O type of the current I/O card.
Note that after you effect an I/O assignment and your preference was set to the Same
I/O type for tag and I/O card, you can still change the I/O type of the I/O card if
you need to do so. The software does not verify the compatibility of a changed I/O
type with instrument tags already associated with I/O cards.
For more information, see Set I/O Assignment Instrument Tag Preferences, page 591.
Effect I/O Assignment for an Instrument

I/O assignment is essentially assigning a control system tag to a free channel. I/O
assignment for an instrument is performed in two stages:
1. Associating (coupling) an instrument with a control system tag.
2. Assigning the coupled pair to a channel.
For more information, see Effect I/O Assignment for an Instrument, page 591.
Effect I/O Assignment for a Segment

I/O assignment for a segment is performed in two stages:
1. Associating (coupling) each virtual tag with a control system tag.
2. Assigning the coupled pairs to an I/O channel.
For more information, see Effect I/O Assignment for a Segment, page 593.

Assign an Instrument to a Channel

The essence of I/O assignment is assigning an instrument to a channel. SmartPlant
Instrumentation provides several options for this purpose. You can choose one of the
following options for I/O assignment:
• Select an instrument tag coupled with a control system tag and assign both
of them to a free channel.
• Couple an instrument tag with an existing control system tag and then
assign them to a free channel.
• Assign an uncoupled control system tag to a free channel.
• Assign an uncoupled instrument tag to a free channel. You will have to
create a new control system tag in the process and the coupling will be
done automatically.
• Assign an uncoupled instrument tag to a channel to which a control system
tag has already been assigned.
For more information, see Assign an Instrument to a Channel, page 594.
Assign a Segment to a Channel

This option enables to assign a segment to a channel so that you can effect I/O
assignment for fieldbus segments. For more information, see Assign a Segment to a
Channel, page 594.
Create a Channel
This option allows you to create additional channels to the ones that the software
created in a particular I/O card or terminal strip. For more information, see Create a
Channel, page 595.
Create a Control System Tag

This option allows you to create a new control system tag. Note that control system
tag names must be unique. If you are using a DCS, the uniqueness applies per
<plant>. If you are using a PLC, the uniqueness applies per cabinet or panel. For
more information, see Create a Control System Tag, page 596.
Rename a Control System Tag

You can change the name of an existing control system tag, for example, if you
replace an existing one with a newer model. For more information, see Rename a
Control System Tag, page 598.
Couple an Instrument with a Control System Tag

One of the ways to implement I/O assignment is to assign to a free channel a control
system tag coupled with an instrument tag. For more information, see Couple an
Instrument with a Control System Tag, page 598.

Decouple an Instrument and a Control System Tag

This procedure explains how to decouple an instrument tag and a control system tag
where the instrument is no longer connected. For more information, see Decouple an
Instrument and a Control System Tag, page 599.
Filter the Display of Data in the I/O Assignment Window

This feature enables you to filter the data displayed in the I/O Assignment window.
You can instruct the software to display only assigned or unassigned instruments.
Furthermore, you can display only uncoupled instruments, uncoupled CS tags, or
both. Also, you can select a predefined Browser filter for panels. For more
information, see Filter the Display of Data in the I/O Assignment Window, page 600.
Cancel I/O Assignment

Canceling I/O assignment involves a simple procedure of removing the instrument
assignment (unassigning) an instrument from a channel. For more information, see
Cancel I/O Assignment, page 601.
Generate an I/O Tag Assignment Report

This option enables you to generate a report showing I/O assignments for an I/O card
or I/O termination that you select in the I/O Assignment window. For more
information, see Generate an I/O Tag Assignment Report, page 601.
View and Edit Channel Data

This option enables you to view the channels of a selected DCS/PLC panel or all
DCS/PLC panels in the current <plant>. You can also modify the control system tag
names if required. For more information, see View and Edit Channel Data, page
602.
Find I/O Channels for I/O Assignment

This option enables you to search DCS or PLC panels in the current <plant> for I/O
cards and individual channels according to required criteria. SmartPlant
Instrumentation then displays these channels in the I/O Assignment window, and you
can use them to effect an I/O assignment. For more information, see Find I/O
Channels for Assignment, page 603.
Related Topics

Set I/O Assignment Instrument Tag Preferences

2. Expand the Wiring hierarchy in the tree view and select I/O Assignment.
3. Under I/O assignment validation select one of the following options:
• Same I/O type for tag and I/O card — limits the I/O type of the
instrument tag to be the same as the I/O type of the I/O card selected in
the I/O Assignment window. Note that the software validates I/O
type compatibility also upon connection.
• All I/O types — allows the selection of all instrument tag I/O types
in the I/O Assignment window and upon connection.
4. Click OK.
Related Topics
Effect I/O Assignment for an Instrument

• Select a parent wiring item that contains one or more I/O card child
items and whose I/O type is Fieldbus FF.
• Select an I/O card or an I/O termination whose I/O type is Fieldbus
FF.
3. Right-click the selected items and then on the shortcut menu, click Actions > I/O
Assignment.
Tips
• The software allows you to open the I/O Assignment window without
selecting anything in the Domain Explorer. On the Wiring Module
window toolbar, click .
• You can also open the I/O Assignment window for an I/O card from
the Connection window. On the Connection menu, click I/O
Assignment.
4. On the I/O Assignment Type dialog box, select I/O Assignment.
Tip
• For fieldbus I/O assignment, select Segment I/O assignment.

5. If you did not select a panel or an I/O card in the Domain Explorer before
opening the I/O Assignment window, do one of the following in the I/O
Assignment window:
• Click to open the Find Channel dialog box, where you find and
select channels to display in the I/O Assignment window.
• In the I/O card details pane, click beside the I/O termination list to
open the Domain Explorer where you select the required I/O cards,
then click OK to add them to the I/O card list.
6. From the I/O termination list, select an item for which you want to effect I/O
assignment.
Tip
• The I/O type of the selected I/O card or I/O termination determines the
I/O type of the initial instrument tag displayed in the I/O type list.
You can select a different I/O type from this list if required. The list of
instruments displayed in the Tag list data grid depends on the I/O type
that you select from the I/O type list. If the I/O type selection is
MIXED, instruments of all I/O types are shown. If any another I/O
type is selected, only the instruments of the selected I/O type are
shown.
7. If required, select a different I/O type, which enables you to use an instrument tag
for the I/O assignment whose I/O type is different from the I/O card I/O type. To
do this, do one of the following:
• If the I/O type selection is MIXED, select the required I/O type from
the I/O type list.
• If the I/O type selection is not MIXED, change the definitions to
make the I/O type list available at all times by selecting the All I/O
types preference on the Preferences (Wiring - I/O Assignment)
dialog box. For details, see Set I/O Assignment Instrument Tag
Preferences, page 591.
8. Drag an instrument or a control system tag to a free channel in the Channel
assignment pane to effect I/O assignment.
Note
• Several assignment options are possible. For details, see the Assign an
Instrument to a Channel section in Effecting I/O Assignment Common
Tasks, page 588.
Related Topics

Effect I/O Assignment for a Segment

FF.
Assignment.
Tips
• You can also open the Segment I/O Assignment window from the
Connection window. On the Connection menu, click I/O
Assignment.
4. On the I/O Assignment Type dialog box, select I/O Assignment.
Tip
• For fieldbus I/O assignment, select Segment I/O assignment.
5. If the I/O Assignment Type dialog box opens, select Segment I/O Assignment
I/O assignment.
6. From the I/O termination list, select an item for which you want to effect I/O
assignment.
7. From the Segment coupling list, select a required segment type. This selection
determines which items are displayed under Segments.
8. Drag a segment to a free channel in the Channel assignment pane to effect I/O
assignment.
Note
• Several assignment options are possible. For details, see the Assign an
Instrument to a Channel section in Effecting I/O Assignment Common
Tasks, page 588.
Related Topics

Assign an Instrument to a Channel

1. Open the I/O Assignment window.
2. In the Tag coupling data grid, select one of the following:
• An instrument tag coupled with a control system tag.
• An instrument not coupled with a control system tag.
• A control system tag not coupled with an instrument.
3. Drag the selected item to a free channel in the Channel assignment pane.
4. If you selected an instrument not coupled with a control system tag, do the
following:
a. On the Control System Tag dialog box, type the name of the control system
tag that SmartPlant Instrumentation creates automatically.
b. Click OK on the Control System Tag dialog box to complete the I/O
assignment.
Note
• You can shift the assignment of an instrument to another unassigned
channel by simply pressing and holding the Ctrl key while dragging the
instrument to another unassigned channel. You cannot change the
assignment this way if the target channel has already been assigned to
another instrument. Note that when changing the assignment, the software
retains the existing control system data.
Assign a Segment to a Channel

FF.
Assignment.
4. From the Segments list, select an appropriate segment.
Tip
• The software displays only those segments that contain instruments for
which virtual tags have been created.

5. Drag the selected segment to a free channel in the Channel assignment pane.
Note
• You can shift the assignment of a segment to another unassigned channel
by simply pressing and holding the Ctrl key while dragging the segment to
another unassigned channel. You cannot change the assignment this way
if the target channel has already been assigned to another segment. Note
that when changing the assignment, the software retains the existing
control system data.
Create a Channel
1. In the Domain Explorer, select an I/O card, I/O termination, or a terminal strip
with channels.
2. Right-click the item to which you want to add a channel and then on the shortcut
menu, click New > Channel.
3. On the Channel Properties dialog box, on the General tab, type a channel name,
description and sequence as you require.
4. If you are adding a channel on a terminal strip under an I/O card or I/O
termination, click the I/O Properties tab.
5. On the I/O Properties tab, select the channel type, I/O type, and signal type.
6. Type a value in the Address field as you require.
7. Type a minimum and maximum range and select a unit of measure for the range
values.
8. Select the Enable for use with external DCS interfaces (DeltaV) check box to
make these channel property values available for use with a DCS interface such as
DeltaV.
9. Click the Associate Symbols tab to associate a symbol (.sym) file with the new
channel. For details, see Associate a Symbol with an Item, page 469.
10. Click OK.
Related Topics

Create a Control System Tag

1. On the I/O Assignment window menu bar, click Actions > New Control System
Tag.
2. On the Control System Tag Properties (New) dialog box, type the name of the
new control system tag and click OK.
Tip
• You can now add an additional control system point configuration if
needed.
3. To document additional DCS/PLC data, on the SmartPlant Instrumentation
toolbar click .
Tip
• The Browser Manager opens. If you have a predefined Wiring
default browser and a default view, the Browser View opens by
default.
4. Do the following in the Browser Manager:
a. Expand the Control System browser group by clicking next to its icon or
double-clicking the icon.
b. To view the control system tag data, select the Control System Tag Browser
and click to create a browser view for this browser.
c. Define the view style, filter, and sorting sequence as you require.
d. Click to view the selected field data in the browser view.
e. If desired, you can edit the displayed data, sort, change the sequence of, and
resize the columns. For more information on how to work with browser
views, see Browser Views Common Tasks, page 343.
Related Topics

Create a Control System Tag in the Instrument Index

1. In the Instrument Index Module window, do one of the following to open the
Instrument Index Standard Browser view:
• On the menu bar, click Actions > Standard Browser View.
• Right-click, and on the shortcut menu, click Apply Profile > Create
Control System Tag.
• On the Actions menu, click Apply Profile > Create Control System
Tag.
4. In the Results dialog box, view the CS tag creation results, and then click Close.
Note
• To make this feature work, you must select the Create wiring and
Control system check boxes on the Wiring and Control System tab in
the instrument type profile of the selected tag number before you attempt
to create a new control system tag. For more details, see Define an
Instrument Type Profile, page 377
Related Topics
• Define a Standard Browser View for the Instrument Index, page 437

Rename a Control System Tag

1. In the I/O Assignment window, select the control system tag that you want to
rename.
Tip
• You can select the required control system tag in the Tag coupling
data window or in the Channel assignment pane.
• Click Actions > Rename Control System Tag.
• Click .
3. On the Control System Tag dialog box, type the new name of the control system
tag.
4. Click OK.
Related Topics
Couple an Instrument with a Control System Tag

1. In the I/O Assignment window, select a free instrument in the Tag Coupling
data grid.
2. Click Actions > Couple Tags.
3. Select the control system tag you want to couple with the instrument tag you have
selected.
4. Click OK.
Note
• The instrument tag and the control system tag appear coupled in the Tag
coupling data grid.
Related Topics

Decouple an Instrument and a Control System Tag

1. Open the I/O Assignment window.
2. In the Tag coupling pane, select a coupled instrument tag and control system tag.
• Click Actions > Decouple Tag No. from SC Tag.
• Click
Note
• The instrument tag and the control system tag appear separately in the Tag
coupling data grid.
Related Topics
Delete a Control System Tag

1. In the I/O Assignment window, select the control system tag that you want to
delete.
Tip
• You can select the required control system tag in the Tag coupling or
in the Channel assignment pane. If, in the Channel assignment
pane, you select a CS tag in the that is still coupled with an instrument,
the software informs you that the I/O assignment for that channel will
be canceled.
• Click .
• Click Actions > Delete Control System Tag.
3. Click Yes to confirm the deletion.
Related Topics

Filter the Display of Data in the I/O Assignment Window

1. In the I/O Assignment window, do one of the following to open the I/O
Assignment Filter dialog box:
• Click .
• Click Actions > Filter.
• From the Filter list, select a predefined filter for panels. Note that if
you select a predefined filter from this list, it overrides all the other
settings in this dialog box. If you do not have a predefined filter, open
the Browser Manager and define a filter for an appropriate view that
contains panels. For details, see View Filter Settings Common Tasks,
page 330.
• Define your filter using the options in the Filter for and Definition
group boxes.
3. Under Filter for, select the filter option to determine which instrument tags and
control system tags will be displayed in the I/O Assignment window. Select one
of the following:
• Unassigned tags coupled with control system tags— display the
instruments that have not yet been assigned to channels but have
already been coupled with control system tags. Then, you can
determine whether to display uncoupled CS tags, uncoupled
instruments, or both.
• Assigned tags coupled with control system tags— display only the
assigned instruments that have already been coupled with control
system tags. Selecting this option disables the other three options.
4. To further filter the display of unassigned instruments, uncoupled instruments, or
both, under Definition, define an appropriate filter expression. For details, see
Define a View Filter, page 331.
5. To use the current filter settings in subsequent sessions of the I/O Assignment
window, select the Apply filter settings in all sessions check box.
6. To display only the instruments that were retrieved from SmartPlant Electrical,
select the SmartPlant Electrical tags check box.
7. To limit the display of data to the current lowest plant group, select the Display
current unit data only check box.
8. Click OK.
Related Topics

Cancel I/O Assignment

1. In the I/O Assignment window, select a channel in the Channel assignment
pane.
• Click .
• Click Actions > Unassign from channel.
Note
• The selected channel becomes vacant as the instrument and its control
system tag move to the Tag list pane.
Related Topics

1. In the I/O Assignment window, under I/O assignment, select an I/O card or an
I/O termination from the list.
2. Select the required I/O card from the I/O card name list.
• Click .
• Click Reports > Tag assignment Report.
4. Click Yes to open the print preview of the report or click No to send the report to
your default printer.
Related Topics

View and Edit Channel Data

1. Do one of the following in the I/O Assignment window:
• Click Actions > Show I/O Data.
• Click .
2. To rename a control system tag, do the following:
a. Select the required row and click Edit CS Tag.
b. On the Control System Tag dialog box, type a new name as needed and click
OK.
3. To filter the display of data on the I/O Data dialog box, do the following:
a. Click Filter to open the Filter I/O Data dialog box.
b. In any data field, type the value according which to filter the channels on the
I/O Data dialog box.
Note that you can include any letter or number combination. You can include
letter or number combinations, as well as wildcards. For example, an
underscore (_) can substitute a single character and percent (%) can substitute
multiple characters. The search is not case-sensitive.
c. From the drop-down lists, select a value according which to filter the channels
on the I/O Data dialog box.
d. In the Show channels group box, choose a filtering option to determine which
channels to display on the I/O Data dialog box.
e. Select the Save check box to save the criteria specified for the next time you
open the I/O Data dialog box.
f. Click OK to accept your filter settings and return to the I/O Data dialog box.
4. To sort the displayed channels on the I/O Data dialog box, do the following:
a. Click Sort to open the Sort I/O Data dialog box.
b. In the Column Name list, select the column according which the channels
displayed on the I/O Data dialog box will be sorted.
c. Select Ascending to sort the channels displayed on the I/O Data dialog box in
ascending order; clear the check box to sort the channels in descending order.
d. To add a new sorting parameter, select an existing sorting parameter after
which you want to add the new sorting parameter and then click Insert.

e. To delete a sorting parameter, select the required sorting parameter and click
Delete.
f. Click Clear to discard all the sorting settings.
g. Select the Save check box if you want to save the current settings for the next
time you open the I/O Data dialog box. Note that deleting or clearing
parameters does not affect the sorting parameters that you have previously
saved (by selecting the Save check box).
h. Click OK to accept your settings and return to the I/O Data dialog box.
5. To print out the data on the I/O Data dialog box, click Report.
6. Click Close to return to the I/O Assignment window.
Notes
• If you open the I/O Assignment window without selecting anything in the
Domain Explorer, the I/O Data dialog box shows the control system tags
of the DCS/PLC cabinet you selected the last time you opened the I/O
Assignment window.
Related Topics
Find I/O Channels for Assignment

1. In the I/O Assignment window, do one of the following to open the Find
Channels dialog box:
• Click Actions > Find Channels.
• Click .
2. Under Search parameters, type values according to which SmartPlant
Instrumentation displays channels in the Search results data window. If you
leave a field blank, it will not limit the search. Leave all fields blank in order to
display all channels.
Tip
• You can include letter or number combinations, as well as wildcards.
For example, an underscore (_) can substitute a single character, and
percent (%) can substitute multiple characters. The search is not case-
sensitive.

3. Under Show channels, select one of the following search options:

• Spares only — show only spare channels in the Search results data
window.
• Exclude spares — do not display any spare channels in the Search
results data window.
• All — show all spare and assigned channels in the Search results
data window.
4. To save the current search parameters as the channel search default, select the
Save check box.
5. Click Find to search using the current settings.
6. In the Search results data window, select the I/O cards that you want to be
available in the I/O Assignment window, and click OK.
Tip
• If you select a channel rather than an I/O card, SmartPlant
Instrumentation displays the card to which the channel belongs in the
I/O Assignment window.
7. In the I/O Assignment window, under I/O card name, select the required card.
the software displays its channels in the Assignment details data window.
Related Topics

Cross Wiring: An Overview

Cross wiring in SmartPlant Instrumentation allows you to connect two terminal strips
by using a cross-wiring cable. You can cross wire two terminal strips that belong to
two different panels or the same panel.
The following cross-wiring options are available:
• Manual Cross Wiring– This is the default cross wiring mode, where you
select the terminals on the strips to be cross-wired.
• Semiautomatic Cross Wiring– SmartPlant Instrumentation
automatically finds potential targets for the signal that it will propagate.
You can accept the suggested terminals and carry out the cross wiring or
select different terminals to be cross-wired.
• Automatic Cross Wiring– SmartPlant Instrumentation automatically
finds matching signals and performs the cross wiring for you.
Related Topics
• Cross Wiring Connections Common Tasks, page 606

Cross Wiring Connections Common Tasks

The following tasks are used frequently when you make cross wiring connections in
Perform Manual Cross Wiring

Manual cross wiring is the default mode for cross wiring. In this mode, you select the
terminals that you want to cross wire, select the required cross-wiring cable and then
carry out the cross wiring. For more information, see Perform Manual Cross Wiring,
page 607.
Perform Semiautomatic Cross Wiring

Semiautomatic cross wiring enables you to find matching signals between two
terminal strips (primary and secondary). That is, SmartPlant Instrumentation can find
for you a potential target for the signal that the software propagates after you perform
cross wiring. You can then use this potential target to quickly effect the required
cross wiring. The terminal that SmartPlant Instrumentation finds for you in the
secondary terminal strip is a recommendation only and you are free to accept it or
select a different terminal, as you require. For more information, see Perform
Semiautomatic Cross Wiring, page 609.
Perform Automatic Cross Wiring

Automatic cross wiring enables you to instruct SmartPlant Instrumentation to
automatically find matching signals for you and cross-wire the relevant terminals in a
single operation. Two signals match if:
• The signals are between two terminal strips belonging to the same panel.
• Both signals are on the same signal level.
• The first signal comes to the first terminal from a device panel (the signal
sequence is less than 50) and the second signal comes from a control
system (the signal sequence is greater than 50.)
You can set the default definitions for matching signals by using the Preferences
dialog box.
For more information, see Perform Automatic Cross Wiring, page 611.
Set Cross Wiring Preferences

This procedure explains how to create a new cross-wiring cable and use it in your
current cross wiring operation. If you do not want to create your own cross-wing
cables and let SmartPlant Instrumentation create a cable for you, in the Cross Wiring
window, select CROSS WIRE from the Cross-wiring cable list. For more
information, see Set Cross Wiring Preferences, page 611.

Generate a Panel Strip Report from the Cross Wiring Window

This option enables you to generate a panel – strip report that displays the
connections and adjacent connections for the terminal strip you selected from the
Primary terminal strip list in the Cross Wiring window. For more information, see
Generate a Panel Strip Report from the Cross Wiring Window, page 614.
Related Topics
• Cross Wiring: An Overview, page 605
Perform Manual Cross Wiring

1. Press F7 open the Domain Explorer and select one or more terminal strips for
potential cross wiring. You can also select a panel or several panels if required.
2. Right-click the items you selected and then on the shortcut menu, click Actions >
Cross Wiring.
3. In the Cross Wiring window, select the required terminal strip from the Primary
terminal strip list.
Tip
• To add terminal strips that do not appear on the list, click beside the
Primary terminal strip list arrow, select the required terminal strips
in the Domain Explorer, then click OK to add them to the Primary
4. Under Primary connection side, click Left or Right to select the appropriate
side of the secondary terminal s trip that you want to connect.
Tip
• This option is not available if the current secondary terminal strip is a
terminal strip with channels (belonging to a DCS or PLC panel). In
this case, you can connect the left side only.
5. From the Secondary terminal strip list, select the required terminal strip that you
want to cross wire.
Tip
• To cross wire two terminal strips belonging to different panels where
you did not select one of the panels in Cross Wiring, click beside
the Secondary terminal strip list arrow, select the required terminal
strip in the Domain Explorer and click OK to add it to the Secondary
terminal strip list. Then, select that terminal strip from the
Secondary terminal strip list for cross wiring.

6. Under Secondary connection side, click Left or Right to select the appropriate
side of the secondary terminal strip that you want to connect.
Tip
7. From the Cross-wiring cable list, select one of the following to define a cross-
wiring cable:
• Select CROSS WIRE to cross wire the terminals with wires that the
software creates during the cross-wiring process.
• Select the required cross-wiring cable. If the cross wiring cable that
you need is not on this list, click beside the list arrow to open the
Wiring Explorer. Select a cable and click OK to add it to the list.
Note that you can also create a new cross wiring cable if the one you
need does not exist in the Domain Explorer.
8. Select the Prompt for cross operation message check box to be prompted by
SmartPlant Instrumentation to confirm the cross wiring. If you do not select this
check box, cross wiring of the selected terminals proceeds without messages and
SmartPlant Instrumentation propagates all the existing signals.
9. In the Primary Terminal Strip pane, click the required terminal to be cross-
wired.
10. In the Secondary Terminal Strip pane, click the required terminal to be cross-
wired.
11. If you selected the Prompt for cross operation message check box, click Yes to
confirm the cross wiring.
Notes
• For an example and information about the conventions used to represent
various items and connections in the Cross Wiring window, click the
Help icon on the main toolbar and then click the required link at the
bottom of the help page.
• In the Primary Terminal Strip pane, select the required cross-wired
terminal, and then click to open the Point-to-Point Wiring Diagram.
• Click to open the Terminal Connection window. You can also
double click to get the same result.
• Click to remove the cross wiring between two terminals after selecting
the cross-wired terminals (shown connected by a solid black line).
• Click to generate a report that shows all the wiring connections of the
primary strip on both sides.

Perform Semiautomatic Cross Wiring

2. Do one of the following to open the Cross Wiring window:
• Click Actions > Cross Wiring.
• Click
Tip
want to cross wire.
Tip
you did not select one of the panels in Domain Explorer, click
beside the Secondary terminal strip list arrow, select the required
terminal strip in the Domain Explorer and click OK to add it to the
Secondary terminal strip list. Then, select that terminal strip from
the Secondary terminal strip list for cross wiring.
Tip
wiring cable:
Domain Explorer. Select a cable and click OK to add it to the list.

8. In the Primary Terminal Strip pane, click the required terminal to be cross-
wired.
9. Do one of the following to find a matching target signal for potential cross wiring:
• Click View > Target Signal.
• Click .
SmartPlant Instrumentation searches for a matching signal in the
current <plant> and adds the terminals that it finds in the Secondary
Terminal Strip pane. SmartPlant Instrumentation indicates each of
the potential terminals by placing an arrow beside it in the
Secondary Terminal Strip pane.
10. Select the required terminal in the Secondary Terminal Strip pane to cross wire
with the selected terminal in the primary terminal strip.
Notes
Related Topics

Set Cross Wiring Preferences

2. Expand the Wiring hierarchy in the tree view and select Cross Wiring.
3. Under Automatic cross wiring, select one of the following options:
• Different strips, same panel— Automatically cross-wires two
signals between two different strips belonging to the same panel (this
is the default selection).
• Different panels (no DCS or PLC panels)— Automatically cross-
wires signals between two strips belonging to two different panels in
the current plant, except for strips with channels (that is, I/O cards).
• Different panels including DCS or PLC panels (terminal sequence
connection) — Automatically cross-wires signals between two strips
belonging to two different panels in the current plant, including strips
with channels where the connection will be done according to the
terminal sequence that is shown in the dialog box. Note that we do not
recommend using the third option unless you are absolutely certain
that this option will select matching signals. In any case, do not forget
to change the setting back to the default (Different strips, same
panel) when done.
4. From the Default wire color list select the required wire color. Selecting a
default wire color determines the cross-wire color in the Connection window.
The wire color data in the list is retrieved from the Wire Color dialog box.
5. Click OK.
Related Topics
Perform Automatic Cross Wiring

Important
• You can set the default definitions for matching signals by using the
Preferences dialog box. For details, see Set Cross Wiring Preferences,
page 611.
2. Do one of the following to open the Cross Wiring window:
• Click Actions > Cross Wiring.
• Click

Tip
4. Under Primary auto cross-wiring side, click Left or Right to select the
appropriate side of the primary terminal strip that you want to connect.
want to cross wire.
Tip
you did not select one of the panels in Domain Explorer, click
beside the Secondary terminal strip list arrow, select the required
terminal strip in the Domain Explorer and click OK to add it to the
Secondary terminal strip list. Then, select that terminal strip from
the Secondary terminal strip list for cross wiring.
Tip
wiring cable:
Domain Explorer. Select a cable and click OK to add it to the list.

9. Do one of the following to find matching signals:

• Click Actions > Auto
• Click .
SmartPlant Instrumentation finds and selects the matching signals and
the terminals that it can cross-wire automatically. The Secondary
Terminal Strip pane does not appear in the Cross Wiring window.
• Click to cross wire the selected terminals. SmartPlant

Instrumentation replaces the selection with a solid black line indicating
that the cross wiring has been done.
• Click to discard the selection made by the software and return to
manual mode.
11. After the software cross wired the terminals, click to return to manual mode.
Notes
Related Topics

Create a Cross Wiring Cable

1. In the Cross Wiring window, click beside the Cross-wiring cable list arrow
to open the Domain Explorer.
2. Right-click the Cross Cables folder, and on the shortcut menu, click New >
Cross Cable.
3. In the Cable Properties dialog box, enter the required values and then click OK.
4. Select the new cable in the Domain Explorer and click OK to add this cable to
the Cross-wiring cable list.
5. Select the new cable in the Cross-wiring cable list to be used in the cross wiring
operation.
Related Topics
Generate a Panel Strip Report from the Cross Wiring

Window
1. Do one of the following in the Cross Wiring window:
• Click Reports > Panel-Strip.
• Click on the module toolbar.
2. Click Yes to open the print preview or click No to print the report without
displaying it on your screen.
Related Topics

Auto-Wiring: An Overview
Auto-wiring allows you to make automatic batch connections between specified
terminal strips. This feature facilitates faster and more efficient wiring design
especially when working on a grass-root project where the required wiring items
already exist and you need to connect them. The essence of this feature is that you
create an auto-wiring routing task where you define a cable that will connect two
designated panels.
You can define an auto-wiring task for two different kinds of connection:
• A connection between two existing panels.

• A connection between a panel and a control system that will create cross
wires or cross cables.
There are two prerequisites for auto-wiring routing tasks:
• The required panels and terminal strips must already exist.

• The required reference cables and connection types must be defined and
ready for use.
Furthermore, for cross wiring auto-wiring routing tasks, you must also ensure the
following before you start defining your task:
• The required instrument tags and their device panels already exist and they
are connected to their junction boxes.
• There are instrument tags with pre-assigned I/O points – essential for
cross-wiring tasks.
• There are defined reference wiring profiles for the required instrument
types.
Notes
• For details about various auto-wiring tasks, see Defining and Executing
Auto-Wiring Tasks: An Overview, page 616.
• You cannot create an auto-wiring task for panels that are defined as
Fieldbus or Telecom panels.
Related Topics
• Auto-Wiring Connections Common Tasks, page 619
• Defining and Executing Auto-Wiring Tasks: An Overview, page 616

Defining and Executing Auto-Wiring Tasks: An

Overview
An auto-wiring task is a list of commands that SmartPlant Instrumentation runs
according to pre-selected parameters. You define the End 1 and End 2 connections as
well as the cable that SmartPlant Instrumentation uses to make the connection. The
cable that the software uses to make the connection is automatically created by the
software. The definition of this cable is based on the reference cable that you select.
The software checks whether a cable based on the selected reference cable exists in
the Domain Explorer and whether this cable has a sufficient number of unconnected
cable sets. If not, SmartPlant Instrumentation creates a new cable based on the
selected reference cable to accommodate the required connections. You can
customize the cable name as needed or accept the suggested names. The software
proposes cable end names based on the names of the panels to be connected to End 1
and End 2. Any additional cables that the software creates have identical names with
a numeric suffix that is incremented by one for each new cable; for example XYZ.1,
XYZ.2, and so forth.
You can define the following auto-wiring tasks:
• Connecting two junction boxes or marshaling racks— When defining

an auto-wiring task for two junction boxes, you need to define the End 1
and End 2 connections as well as the cable that SmartPlant
Instrumentation uses to connect the two panels.
• Connecting a junction box or a marshaling rack to a control system
— When defining this kind of auto-wiring task, you define the End 1
connection and the auto-wiring cable. The End 2 connection options are
not available as SmartPlant Instrumentation checks for available DCS or
PLC panels with matching signals. This means that you have to pre-
assign the required control system tags to the tag numbers (for details, see
I/O Assignment: An Overview, page 587). At this point, you also need to
select an appropriate cross wiring option to connect the control system.
After the software executes the task, open the Connection window for the
selected junction box and display the adjacent connection to make sure
that the software has executed the auto-wiring task correctly.

• Connecting a pre-assigned junction box to another junction box or a

control system— In this case, you need to make sure that you have
carried out the required I/O assignment for the control system you are
going to connect and that you pre-assigned the necessary junction box and
its terminal strip to the required field device. Then, you proceed to define
the End 2 connection or select to connect the pre-assigned junction box to
a control system.
Note that you define and execute auto-wiring tasks in the Auto-Wiring Browser
View window.
For detailed description of the various procedures, see Auto-Wiring Connections

Common Tasks, page 619.
Related Topics

Flow of Activities for Auto-Wiring

The following is a suggested flow of auto-wiring activities. The sequence in which
you perform these activities depends on your work preferences. In any case, make
sure that you perform the first four steps in the following list before proceeding
further.
1. Define a view profile for a new Auto-Wiring Routing Task browser in the
Wiring group of the Browser Manager. For details, see Define a View Profile,
page 289.
2. Add and define a new view for the Auto-Wiring Routing Task browser. For
details, see Add a New View, page 290.
3. If needed, define a view profile for the JB Pre-Assignment browser in the
Instrument Index group of the Browser Manager and then add and define a
new view for the JB Pre-Assignment browser.
4. Pre-assign the required junction boxes to tag numbers. For details, see Pre-Assign
Junction Boxes to Device Panels, page 620.
5. Connect the junction boxes to the device panels using one of the following
methods:
• Use the Device Cable Batch Connection feature. For details, see
Connect Device Cables to a Terminal Strip in Batch Mode, page 573.
• Execute the auto-wiring routing task. For details, see Defining and
Executing Auto-Wiring Tasks: An Overview, page 616.
• Connect the junction boxes manually.
6. Continue connecting the rest of the junction boxes.
7. Create and run a new auto-wiring routing task to connect the last junction box to
the control system (or another type of panel).
Related Topics
• Auto-Wiring: An Overview, page 615

Auto-Wiring Connections Common Tasks

The following tasks are used frequently when you make connections in SmartPlant
Instrumentation.

This pre-assignment makes it possible to define an Auto-Wiring routing task. For
details, see Pre-Assign Junction Boxes to Device Panels, page 620.
Auto-Wire Pre-Assigned Junction Boxes

This procedure explains how to define and execute an auto-wiring task for a pre-
assigned junction box. Note that you must pre-assign the required junction box and
make all the required preparations prior to defining and executing a task. For more
information, see Auto-Wire Pre-Assigned Junction Boxes, page 621.
Auto-Wire Two Panels

This procedure explains how to define and execute an auto-wiring task for two panels
(regardless of their signals). Note that you must make all the required preparations
prior to defining and executing a task. For more information, see Auto-Wire Two
Panels, page 623.
Auto-Wire Control Systems

You use this procedure to define and execute an auto-wiring task for a control system.
Note that prior to defining such a task, you must assign the required control system
I/O channels to specific tag numbers. For more information, see Auto-Wire Control
Systems, page 625.
Auto-Wire Control Systems Connected to Pre-Assigned Junction Boxes

This procedure explains how to define and execute an auto-wiring task for a control
system that is to be connected to a pre-assigned junction box. Note that prior to
defining such a task, you must assign the required control system to specific tag
numbers. For more information, see Auto-Wire Control Systems Connected to Pre-
Assigned Junction Boxes, page 627.
Change an Auto-Wiring Task Status

After you define an auto-wiring task, SmartPlant Instrumentation assigns it a status.
Tasks can have different statuses that are set according to the task definitions. You
can change certain task statuses if needed. For more information, see Change an
Auto-Wiring Task Status, page 630.
Related Topics
• Flow of Activities for Auto-Wiring, page 618


1. On the main toolbar, click to open the Browse Manager.
2. Expand the Instrument Index browser group.
Tip
• You can also click on the Auto-Wiring Browser View toolbar to

open the JB Pre-Assignment Browser View window.
3. Select the JB Pre-assignment browser and add a new browser view to this
browser.
Important
• Make sure that you select the Set as default view check box if you
want to use the new browser view for auto-wiring.
4. Click to open the new view.
5. In the Browser View window, highlight the required tag number to which you
want to assign a junction box.
6. Click in the Junction Box Name field and select an appropriate junction box that
will be pre-assigned to the highlighted instrument tag.
Tip
• If a junction box has already been connected to a device panel, the
Junction Box Name field displays the name of the connected junction
box and you cannot rename the junction box here.
7. Click in the Strip Name field and select the required strip in the pre-assigned
junction box.
8. Repeat steps 5 through 7 for each device panel to which you want to pre-assign a
junction box.
9. Edit the data in the Browser View window as required and close the Browser
View window. Save the data when prompted.
Notes
• You can now select the appropriate junction boxes and perform batch
connection of device cables in the Batch Device Cable Connection
window.
• You can define an Auto-Wiring routing task.
• You can filter the display of device cables in the Domain Explorer.
Related Topics
• Auto-Wire Pre-Assigned Junction Boxes, page 621

Auto-Wire Pre-Assigned Junction Boxes

Important
• You must pre-assign the required junction boxes and make all the required
preparations prior to defining and executing a task. For details, see Pre-
Assign Junction Boxes to Device Panels, page 620.
1. Start the Wiring module.
2. On the menu bar, click Actions > Auto-Wiring.
3. In the Browser View - New Auto-Wiring Routing Task window, select the new
task and do one of the following:
• Click Actions > Edit Task.
• Click .
Tip
• The Auto-Wiring Routing Task dialog box opens where all the End
1 connection properties except for the Connection type and Overall
shield terminal connection have been defined. You can accept the
displayed values or modify them as needed.
4. On the Auto-Wiring Routing Task dialog box, complete the End 1 connection
definition as follows:
a. Select the required connection type from Connection type list.
b. If required, select the appropriate overall shield terminal connection.
5. In the End 2 connection group box, select one of the following options:
• Select the Control system check box if you want to connect the pre-
assigned junction box to a DCS or PLC cabinet.
• Do not select the Control system check box to connect the pre-
assigned junction box to another junction box or marshaling rack.
6. If you did not select the Control system check box, define the end 2 connection
of the auto-wiring cable as follows:
a. Click next to the Panel field to select the required panel.
b. In the Domain Explorer, select a panel that contains at least one terminal
strip with unconnected terminals and then click OK.
c. Select a terminal strip from the Strip list.
d. Select a terminal that will serve as the first terminal.
e. Select a terminal side.
f. Select a connection type.
g. If required, select an appropriate overall shield terminal connection.

7. Use the options in the Cable group box to define the cable that SmartPlant
Instrumentation will use to connect the two panels:
a. From the Reference cable list, select the appropriate reference cable that
SmartPlant Instrumentation will use as the source for the creation of a cable
that will connect the two panels. The software duplicates the new cable in the
Domain Explorer.
b. In the Cable name data field, accept or type the name of the cable that
SmartPlant Instrumentation will create to connect the two panels. The cable
names suggested by the software are composed of the End 1 and End 2 panel
names. Additional cables have their names incremented by one, for example
XYZ.1, XYZ.2, and so forth.
8. Click OK to complete the task definition and return to the Auto-Wiring Browser
View - New Auto-Wiring Routing Task window.
9. In the Browser View - New Auto-Wiring Routing Task window, click .
Notes
• After notifying you that the task has been executed successfully, the task
status changes to Done. For details, see Auto-Wiring Task Statuses, page
630.
• You can open the Connection window for the selected junction box to
display the adjacent connection to make sure that the auto-wiring task has
been executed correctly.
Related Topics

Auto-Wire Two Panels

Important
• Make sure that you have made all the required preparations that are
specified in Auto-Wiring: An Overview, page 615.
• Click Actions > New.
• Click .
4. On the Auto-Wiring Routing Task dialog box, define the End 1 connection as
follows:
5. In the End 2 connection group box, do the following:

6. Use the options in the Cable group box to define the cable that SmartPlant
Instrumentation will use to connect the two panels:
a. From the Reference cable list, select the appropriate reference cable that
SmartPlant Instrumentation will use as the source for the creation of a cable
that will connect the two panels. The software duplicates the new cable in the
Domain Explorer.
b. In the Cable name data field, accept or type the name of the cable that
SmartPlant Instrumentation will create to connect the two panels. The cable
names suggested by the software are composed of the End 1 and End 2 panel
names. Additional cables have their names incremented by one, for example
XYZ.1, XYZ.2, and so forth.
7. Click OK to complete the task definition and return to the Auto-Wiring Browser
View - New Auto-Wiring Routing Task window.
8. In the Browser View - New Auto-Wiring Routing Task window, click .
Notes
630.
Related Topics

Auto-Wire Control Systems

Important
• Prior to defining such an auto-wiring task for a control system, you must
assign the required control system I/O channels to specific tag numbers.
For details, see I/O Assignment: An Overview, page 587.
• For auto-wiring tasks that connect pre-assigned junction boxes to control
systems, see Auto-Wire Control Systems Connected to Pre-Assigned
Junction Boxes, page 627.
• Click Actions > New.
• Click .
4. On the Auto-Wiring Routing Task dialog box, define the End 1 connection as
follows:
5. In the End 2 connection group box, select the Control system check box.
Tip
• Selecting the Control system check box disables all the options in the
End 2 connection group box (except for Connection type) so that
SmartPlant Instrumentation can search for an available DCS or PLC
panel with a matching signal.
6. From the Connection type list, select the required End 2 connection type.

7. In the Cross wiring group box, select an appropriate cross wiring option to
connect the control system to the junction box:
• Single cross wires– connects the control system using a single wire
created by SmartPlant Instrumentation automatically during the auto-
wiring process.
• Cables created from reference – connects the control system using
a cable that SmartPlant Instrumentation creates by duplicating the
reference cable that you select from the Reference cable list in the
Cable group box. The software checks whether such a cable exists in
the Domain Explorer and if so, whether this cable is connected to the
panel selected in the End 1 connection group box. If this cable has
unconnected cable sets, the software connects them and then creates
additional cables so that all the terminals are connected. Note that in
this case, the software connects all the cable sets whether they are
required or not. Therefore, for this option to work properly, you must
create appropriate reference cables and connection types before
starting auto-wiring.
• One cable per tag – connects the control system using a separate
cable for each tag number. The software creates each cable by
duplicating the reference cable that you select from the Reference
cable list in the Cable group box. SmartPlant Instrumentation creates
the required number of cables according to the number of tag signals it
detects. The software names each cable according to the signal name.
You can add a prefix and a suffix to the cable name by typing the
required string in the Cable name prefix and Cable name suffix
fields.
8. Use the options in the Cable group box to define the cable for connecting the pre-
assigned junction box to the control system (not available if you selected the
Single cross wires option):
a. From the Reference cable list, select an appropriate reference cable that
SmartPlant Instrumentation uses as a source for the creation of a cable that
will connect the two panels. The software duplicates the new cable in the
Domain Explorer.
b. In the Cable name data field, the software suggests a cable name composed
of the End 1 and End 2 panel names. Accept this name or type a name of your
choice for the cable that SmartPlant Instrumentation will create to connect the
two panels. Any additional cables that the software creates have identical
names with a numeric suffix that is incremented by one for each new cable;
for example XYZ.1, XYZ.2, and so forth.
9. Click OK to complete the task definition and return to the Browser View - New
Auto-Wiring Routing Task window.

10. Click .
Notes
630.
Related Topics
Auto-Wire Control Systems Connected to Pre-Assigned

Junction Boxes
Important
• You must pre-assign the required junction boxes and make all the required
preparations prior to defining and executing a task. For details, see Pre-
Assign Junction Boxes to Device Panels, page 620.
• Assign the required control system I/O channels to specific tag numbers.
For details, see I/O Assignment: An Overview, page 587.
• For auto-wiring tasks involving a connection to a junction box that has not
been pre-assigned, see Auto-Wire Control Systems, page 625.
• Click Actions > Edit Task.
• Click .
Tip
• The Auto-Wiring Routing Task dialog box opens where all the End
1 connection properties except for the Connection type and Overall
shield terminal connection have been defined. You can accept the
displayed values or modify them as needed.

4. On the Auto-Wiring Routing Task dialog box, complete the End 1 connection
definition as follows:
a. Select the required connection type from Connection type list.
b. If required, select the appropriate overall shield terminal connection.
5. In the End 2 connection group box, select the Control system check box.
Tip
• Selecting the Control system check box disables all the options in the
End 2 connection group box (except for Connection type) so that
SmartPlant Instrumentation can search for an available DCS or PLC
panel with a matching signal.
6. From the Connection type list, select the required End 2 connection type.
7. In the Cross wiring group box, select an appropriate cross wiring option to
connect the control system to the junction box:
• Single cross wires– connects the control system using a single wire
created by SmartPlant Instrumentation automatically during the auto-
wiring process.
• Cables created from reference – connects the control system using
a cable that SmartPlant Instrumentation creates by duplicating the
reference cable that you select from the Reference cable list in the
Cable group box. The software checks whether such a cable exists in
the Domain Explorer and if so, whether this cable is connected to the
panel selected in the End 1 connection group box. If this cable has
unconnected cable sets, the software connects them and then creates
additional cables so that all the terminals are connected. Note that in
this case, the software connects all the cable sets whether they are
required or not. Therefore, for this option to work properly, you must
create appropriate reference cables and connection types before
starting auto-wiring.
• One cable per tag – connects the control system using a separate
cable for each tag number. The software creates each cable by
duplicating the reference cable that you select from the Reference
cable list in the Cable group box. SmartPlant Instrumentation creates
the required number of cables according to the number of tag signals it
detects. The software names each cable according to the signal name.
You can add a prefix and a suffix to the cable name by typing the
required string in the Cable name prefix and Cable name suffix
fields.

8. Use the options in the Cable group box to define the cable for connecting the pre-
assigned junction box to the control system (not available if you selected the
Single cross wires option):
a. From the Reference cable list, select an appropriate reference cable that
SmartPlant Instrumentation uses as a source for the creation of a cable that
will connect the two panels. The software duplicates the new cable in the
Domain Explorer.
b. In the Cable name data field, the software suggests a cable name composed
of the End 1 and End 2 panel names. Accept this name or type a name of your
choice for the cable that SmartPlant Instrumentation will create to connect the
two panels. Any additional cables that the software creates have identical
names with a numeric suffix that is incremented by one for each new cable;
for example XYZ.1, XYZ.2, and so forth.
9. Click OK to complete the task definition and return to the Browser View - New
Auto-Wiring Routing Task window.
10. Click .
Notes
630.
Related Topics

Auto-Wiring Task Statuses

After you define an auto-wiring task, SmartPlant Instrumentation assigns it a status.
Tasks can have different statuses that are set according to the task definitions. You
can change certain task statuses if needed.
The following table defines the various task statuses and explains which statuses you
can change.
Status Description Can Be Changed

To
New A newly created task that has not yet been executed. Hold
Hold A task that has been put on hold. Execute
This task cannot be executed until you change its status
to Execute.
Execute A task whose status has been changed from Hold. Cannot be changed
This task can be executed.
Done A task that has already been executed. Cannot be changed
Such a task cannot be executed again.
Related Topics
Change an Auto-Wiring Task Status

1. In the Auto-Wiring Browser View window, right-click a task.
2. On the shortcut menu, click Task Status.
3. Click the option that you require.
Related Topics

Signal Propagation: An Overview

Signal propagation is a method used in SmartPlant Instrumentation to associate wires
with instruments. A signal or a tag signal is a software identifier that is associated
with a particular instrument tag, and is generated in a device panel or locally within
other types of panels. A tag signal can also be created as a result of I/O assignment.
When you connect or disconnect a cable, cable set, or wire, SmartPlant

Instrumentation automatically updates the wire tags and the signals that are carried by
the wires. Tag signal propagation takes place automatically, with consequent
updating of wire names, and signal sequences. Signal sequence values are sequential
numbers assigned consistently to all of the wires within a given wire group along the
signal path of the wire group. Automatic tag signal propagation also takes place after
you effect I/O assignment. For details of various tag signal propagation results, see
Possible Cases of Signal Propagation, page 632.
However, there may be situations in which tag signal propagation does not occur
automatically. In this case, SmartPlant Instrumentation offers you the two options for
semiautomatic propagation of a selected tag signal. You can re-propagating a tag
signal or force tag signal propagation. For details, see Tag Signal Propagation
Common Tasks, page 634.
Also, you can effect signal propagation at terminal strip level by manually entering or
changing a signal or its level at any point along the wiring path.
Tips
• Unlike wires, jumpers do not propagate signals. You can assign a wire
group to a jumper manually on the Terminal Connection dialog box.
• Tag signal propagation for a shield takes place automatically without
having to connect that shield to a device panel terminal.
• Tag signal propagation stops if it reaches a point where multiple optional
paths exist.
• You can re-propagate or force propagation of tag signals if required.
• You can intervene at any point of the wire path and change tag number
propagation manually.
You can generate a point-to-point wiring diagram and view the signal path after you
finish assigning an instrument tag to a channel in an I/O card. For information about
point-to-point diagrams, see Trace a Signal in a Point-to-Point Wiring Diagram, page
584.
Related Topics
• Possible Cases of Signal Propagation, page 632
• Tag Signal Propagation Common Tasks, page 634
• Trace a Signal in a Point-to-Point Wiring Diagram, page 584

Possible Cases of Signal Propagation

After you effect I/O assignment, the software automatically propagates the tag
signals. Four situations can exist:
Case 1
In this example, the signal sequence is from the device panel up to the PLC cabinet
with all the wiring:
Case 2
In this case the connection sequence starts from the device panel and continues to the
PLC cabinet, however, there is a discontinuity between Strip 1 and Strip 2 of the
marshaling rack:
Note that the wiring sequence can be different depending on the completeness of the
connection:
• From 1 to 8 (as in the first case) — connected from the device panel to
the PLC.
• From 1 to 4 and from 99 to 100 (as in the second case) — there is a break
in the middle of the connection.

Case 3
The signal sequence is from the device panel to the PLC cabinet however, there is a
discontinuity between the marshaling rack and the PLC cabinet.
Case 4
The connection sequence starts from the PLC cabinet and continues to the junction
box. The device panel is absent.
Related Topics

Tag Signal Propagation Common Tasks

The following tasks are used frequently when you work with signals in SmartPlant
Instrumentation.
Re-Propagate a Tag Signal

You use this feature when the software does not fully complete the automatic
propagation of a tag signal. This procedure explains how to propagate a tag signal
from a selected device panel, through all the connected cables and panels, until it
encounters a different signal. After it encounters a different signal, the software does
not make any further changes in the propagation. For details, see Re-Propagate a
Tag Signal, page 636.
Force Signal Propagation

You use this feature when the software does not fully complete the propagation of a
tag signal automatically. This procedure explains how to force the propagation of a
tag signal from a selected device panel, through all the connected cables and panels
so that the re-propagated signal overrides all the existing signals that it encounters.
For details, see Force Signal Propagation, page 636.
Propagate a Tag Signal Manually

During your wiring design, situations can arise in which the propagation of a tag
signal does not occur automatically. SmartPlant Instrumentation lets you effect
signal propagation at terminal strip level by manually entering or changing a signal or
its level at any point along the wiring path. You need to propagate tag signals
manually when:
• There is a split in the wiring path.

• There are terminal strips that emulate barriers.
• You cross-wire two terminals, one of which already receives a signal.
• You remove a signal that is stopping tag signal propagation.
• You add another signal level at an exit point of one of the terminal strips.
For more information, see Propagate a Tag Signal Manually, page 637.

Automatically Propagate a Signal from a Non-Wiring Instrument

This feature makes it possible to associate a conventional or electrical non-wiring
instrument with a connected wire, cable set, or cable. Dragging such an instrument
from the Instruments folder of the Domain Explorer to a connected wire, cable set,
or cable in the Connection window automatically creates a signal from that
instrument and propagates this signal along the connected wiring path. Note that non-
wiring instruments are instruments that were created based on instrument type
profiles that have no wiring. For details, see Automatically Propagate a Signal from
a Non-Wiring Instrument, page 638.
Create a Local Tag Signal

A local signal is a user-defined signal that does not originate from a device panel or
an I/O channel. You create a local signal within any other kind of panel. For
example, in an instrumentation electrical interface cabinet, a local signal starts at a
terminal relay or in a junction box, it starts at a terminal strip. Note that you can
apply tag signals (level and sequence) to wires when no device panel is connected.
You can use local signals as follows:
• You can create a local tag signal by assigning a local signal to a wiring tag
that does not yet have a signal of its own.
• You can create a general signal and link it to the signals that are wired
into the terminal strip.
For more information, see Create a Local Tag Signal, page 639.
Filter the Local Signal Dialog Box

This procedure enables you to filter the data window in the Local Signal dialog box
determining the tag numbers that SmartPlant Instrumentation displays in the Tag
Number column. This makes it easier to select the tag numbers that you can assign
to local signals. For more information, see Filter the Local Signal Dialog Box, page
640.
Create a General Signal

A general signal is a user-defined signal which is not characterized by any existing
process function and which does not carry any information from an instrument. You
link a general signal with tag signals and other general signals. You can use a
general signal to treat several tag signals as a group that share common wires. You
can use general signals for the following purposes:
• Combine signals into a wire group for transmitting multiple signals that
are multiplexed or de-multiplexed through it.
• Represent the common connection for single or multiple loop power
supply.
For more information, see Create a General Signal, page 641.

Link Tag Signals to a General Signal

This procedure allows you to link tag signals to a general signal that you create on a
given strip. You need this functionality to:
• Use a power supply to power tag signal circuits.

• Multiplex tag signals into a general signal.
• Recombine tag signals that you previously multiplexed.
For more information, see Link Tag Signals to a General Signal, page 642.
Multiplex Tag Signals

SmartPlant Instrumentation enables you to multiplex tag signals. That is, you can
combine tag signals into a general signal that you propagate. Also, you can combine
signals from incoming general signals with independent tag signals into a new general
signal that you propagate. For more information, see Multiplex Tag Signals, page
643.
De-Multiplex Tag Signals

SmartPlant Instrumentation enables you to separate tag signals from a general signal.
This is called de-multiplexing. Then, you can propagate the independent signals
manually. For more information, see De-Multiplex Tag Signals, page 644.
Related Topics
Re-Propagate a Tag Signal

2. Right-click a device panel from which a signal originates.
3. On the shortcut menu, click Actions > Re-Propagate Signal.
Related Topics
Force Signal Propagation

2. Right-click a device panel from which a signal originates.
3. On the shortcut menu, click Actions > Force Signal Propagation.

Propagate a Tag Signal Manually

• In the Connection window, from the Terminal Strip list, select the
terminal strip for which you want to effect signal propagation
manually.
• In the Cross Wiring window, from the Primary terminal strip list,
select the terminal strip for which you want to effect signal
propagation manually.
2. Double-click next to the required wired terminal.
3. On the Terminal Connection dialog box, under Signal, click and then select
from the list the signal that you want to propagate.
4. Under Signal Level, click and select from the list, a value for the signal level.
Tip
• You can also select zero to indicate that a signal does not have a signal
level setting. This means that all the wires in the current wire group
are propagated on the same level.
5. Under Sequence, click and select from the list a connection sequence.
6. Click Save to propagate the signal.
7. To navigate to other terminals for which you need to change propagation settings,
• Click Next or Previous.
• Under Terminal number, select a terminal that you require.
Notes
• Repeat the above procedure for each terminal strip that requires manual
signal propagation.
• If you remove a signal at any point of the wiring path, SmartPlant
Instrumentation stops the signal propagation at that point. However, if
there is an I/O card at the other end of that signal path, the SmartPlant
Instrumentation stops the tag signal propagation at the break point and
assigns a new connection sequence (100, 99, 98 …) starting from the I/O
card.
• If you replace one signal with another at any point along the wiring path,
the software stops the propagation of the old signal at the point where you
made the change and propagates a new signal from that point onward to
the end of the signal path.
Related Topics

Automatically Propagate a Signal from a Non-Wiring

Instrument
1. In the Instruments folder of the Domain Explorer, select a conventional or
electrical non-wiring instrument.
Tip
• Non-wiring instruments are instruments that were created based on
instrument type profiles that have no wiring or control system
selections but have the Include wiring check box selected.
2. Drag the selected instrument to a connected wire, cable set or cable in the
Connection window.
Notes
• SmartPlant Instrumentation propagates a signal from the selected
instrument along the wiring path based on whether you drag the
instrument to a cable, cable set or wire:
• Dragging an instrument to a cable or a cable set — a signal will be
propagated through each of the wires of the cable or the cable set.
Each wire will get a different signal level.
• Dragging an instrument to a single wire — a signal will be
propagated only through that wire.
• If the current panel in the Connection window is a device panel, the
software associates the instrument with the target device panel.
• If the target wires already carry other signals, the software stops these
signals and propagates new ones instead.
• The software automatically updates the signal levels based on whether you
dragged the instrument to a single wire, a cable, or a cable set. The signal
will start at level one and sequence one. However, if level one and
sequence one are occupied, the software will automatically look for the
next available signal level and sequence.
Related Topics

Create a Local Tag Signal

• In the Connection window, click Actions > Local Signal.
• In the Connection window, click
• On the Terminal Connection dialog box, click Signal.
2. On the Local Signal dialog box, select a wiring tag that has not been associated
with a signal (that is, a tag that has no signal name next to it.)
3. Click Create.
4. Click Close to create and propagate the new local tag signal.
Notes
• All propagation rules apply to local tag signals.
• For cross wiring with independent wiring from the local terminal strip and
I/O card ends, create local tag signals before assigning I/O channels.
• You can apply tag signals (level and sequence) to wires when no device
panel is connected.
Related Topics

Filter the Local Signal Dialog Box

1. On the Local Signal dialog box, click Filter to open the Signal Filter dialog box.
2. Define a conditional expression as follows:
a. From the Column Name list, select the appropriate tag number attribute
according to which you want to filter the data.
b. From the Operator list, select the required comparison operator to determine
how the tag number attribute selected in the Column Name field will relate to
the expression you enter in the Value field.
c. From the Value data list, select or type the required value to determine how
the tag number attribute selected in the Column Name field will be specified.
You can use wildcards such as % (percent) and _ (underscore) to set the value.
d. From the Logical list, select the required logical operator to determine how
the next filter expression will relate to the current one (if applicable).
3. Click New to add another data row for an additional filter expression if needed.
Make sure you select the appropriate logical operator (And, Or) at the end of the
previous row.
4. To retrieve tag numbers that were imported from SmartPlant Electrical, select
SmartPlant Electrical signals only.
5. To retrieve tag numbers that were imported from SmartPlant Electrical and that
already have an association with a specified power distribution board (PDB) in
SmartPlant Electrical, select Pre-assigned signals only. This option is available
only when you select SmartPlant Electrical signals only.
6. To save the filter condition settings so that the next time you open the Signal
dialog box SmartPlant Instrumentation filters the data accordingly, select Save
filter.
Tip
• Click Restore to revert to the filter condition that you saved the last
time.
7. Click Verify to check the correctness of your filter.
8. Click OK.
Related Topics

Create a General Signal

2. On the Local Signal dialog box, under General signal, click New in the group
box.
3. On the New General Signal dialog box, under Signal name, type a unique name.
4. To associate the new general signal with all the tag signals in the current terminal
strip, select Apply to all tag signals of the current strip.
5. Click OK to create and propagate the new general signal.
Notes
• The new general signal name appears in the Signal column with no tag
next to it. This indicates that this is a general signal that originated in the
current terminal strip.
• You can change the general signal name at any time by clicking Edit after
selecting the required general signal.
• If this general signal is used in a loop drawing, make sure that the general
signal name is changed in the loop macro definitions too.
Related Topics

Link Tag Signals to a General Signal

2. On the Local Signal dialog box, under Signal, select the general signal to which
you want to link tag signals.
3. Click Link.
4. On the Link Tag Signals to General Signal dialog box, under Link, select the
check boxes for the tag signals that you want to link to the general signal.
5. Click Close to return to the Local Signal dialog box.
Note
• Since a general signal does not directly connect to a tag, you need a
different way to find the data for the signal's tag numbers. In the drawing
block, the macros (tags / attributes) that contain the data for these signals
should start with a prefix that reflects the name of the signal.
Related Topics

Multiplex Tag Signals

Important
• Before you manage the signals within a given terminal strip, create and
connect the cables that serve the terminal strip.
• You can only multiplex tag signals that are wired into the terminal strip.
1. In the Domain Explorer, right-click a panel or a terminal strip.
3. In the Connection window, click next to a terminal in the wire group into
which you want to multiplex a signal.
4. On the Terminal Connection dialog box, click Signal to open the Local Signals
dialog box.
5. Create a unique general signal. For details, see Create a General Signal, page
641.
6. Link the general signal to the signals that you want to multiplex. For details, see
Link Tag Signals to a General Signal, page 642.
7. Do the following for each terminal in the wire group that you are associating with
the general signal:
a. Under Signal, select the general signal that you want to propagate.
b. Select a sequence and a signal level.
• Under Terminal number, select the terminal that you want to edit.
9. Click Save.
Related Topics

De-Multiplex Tag Signals

Important
• Before you manage the signals within a given terminal strip, create and
connect the cables that serve the terminal strip.
1. In the Domain Explorer, right-click a panel or a terminal strip.
3. In the Connection window, click next to a terminal in the wire group into
which you want to de-multiplex a signal.
4. On the Terminal Connection dialog box, do the following for each terminal in
the wire group that you are associating with one of the of the de-multiplexed
signals:
a. Under Signal, select the tag signal that you want to propagate.
b. Select a sequence as you require. Note that you should increment the
sequence according to the original tag signal, rather than according to the
general signal with which it was linked.
c. Select a signal level.
• Under Terminal number, select the terminal that you want to edit.
6. Click Save.
Related Topics

Intrinsic Safety Calculations Common Tasks

The following tasks are used frequently for calculating intrinsic safety in SmartPlant
Instrumentation.
Create an Intrinsically Safe Circuit Type

The first step in making an intrinsically safe calculation is to define a circuit type.
For more information, see Create an Intrinsically Safe Circuit Type, page 646.
Manage Intrinsic Safety Circuit Types

This option shows you how to maintain the contents of the IS (intrinsic safety) circuit
type supporting table from the Instrument Index module. You can also maintain this
supporting table from the Wiring module. For more information, see Manage
Intrinsic Safety Circuit Types, page 647.
Calculate Intrinsic Safety

Intrinsic safety calculation in SmartPlant Instrumentation allows you to calculate the
maximum permissible cable length between the hazardous and non-hazardous areas
based on three main criteria:
• Resistance
• Capacitance
• Inductance
The calculations are made at the domain level. For more information, see Calculate
Intrinsic Safety, page 647.
Define Tag Numbers for Intrinsic Safety Loop Calculation

When calculating intrinsic safety for a loop, you need to define the tag numbers that
belong to the relevant loop. You have to repeat this procedure for each and every tag
number in the loop For more information, see Define Tag Numbers for Intrinsic
Safety Loop Calculation, page 649.
Define Circuit Cables for Intrinsic Safety Loop Calculation

Before calculating intrinsic safety for a loop, you must perform this procedure for
each cable in the circuit.. For more information, see Define Circuit Cables for
Intrinsic Safety Loop Calculation, page 650.
Calculate Intrinsic Safety for a Loop

After you define loop tags and circuit cables as required, use this procedure to
perform the loop intrinsic safety calculation. For more information, see Calculate
Intrinsic Safety for a Loop, page 651.

Create an Intrinsically Safe Circuit Type

1. Start the Wiring module and do one of the following:
• Click Actions > Intrinsic Safety.
• Click .
2. On the Intrinsically Safe Circuit dialog box, click New.
3. Enter the following information:
a. Type the required circuit type in the Circuit Type data field and the circuit
type description in the Circuit Description data field.
b. From the I/O Type list, select the appropriate area I/O type.
c. From the Area Classification list, select the appropriate area classification.
4. Click Save.
5. On the Drawing Number dialog box, enter an appropriate drawing number name.
6. Click OK.
Note
• The new circuit type is saved and the Intrinsically Safe Circuit dialog
box opens. You can now select the newly created type from the Circuit
Type list.
Related Topics
• Intrinsic Safety Calculations Common Tasks, page 645

Manage Intrinsic Safety Circuit Types

1. Open the Instrument Index module by doing one of the following:
• Click Module > Instrument Index.
• Click .
2. Click Tables > Intrinsically Safe Circuit Types.
3. Click New, to create a new IS circuit type.
4. Under Intrinsically Safe Circuit Type, type the unique and required type name.
5. Under Intrinsically Safe Circuit Description, type the description.
6. Under Drawing Name, type the drawing name.
7. From the Area Classification list, select the area classification.
8. Click Properties.
9. On the Intrinsically Safe Data Input dialog box, under Non-hazardous area
loop components, enter the relevant data for the non-hazardous devices, such as
barrier, isolator, and so forth. You must define the R1, C2, and L2 values.
10. Under Hazardous area loop components, enter the relevant data for the
hazardous devices, such as transmitters, I/P converters, and so forth. You must
define the R1, C2, and L2 values.
11. Click OK to close the Intrinsically Safe Data Input dialog box.
12. Click OK to finish.
Calculate Intrinsic Safety

1. Start the Wiring module and do one of the following:
• Click Actions > Intrinsic Safety.
• Click .
2. On the Intrinsically Safe Circuit dialog box, from the Circuit type list, select
the appropriate circuit type.
Tips
• The remaining fields on the dialog box are filled in automatically with
the data for the circuit type you select.
• If the required circuit type is not on the list, create a new one or edit an
existing circuit type. For more information, see Calculate Intrinsic
Safety for a Loop, page 651.
3. Click OK.

4. On the Intrinsically Safe Data Input dialog box, under Non-hazardous area
loop components, enter the relevant data for the non-hazardous devices, such as
barrier, isolator, and so forth. Note that you must define the R1, C2, and L2
values.
5. Under Hazardous area loop components, enter the relevant data for the
hazardous devices, such as transmitters, I/P converters, and so forth. Note that
R1, C2, and L2 are required fields.
6. Define the cable parameters between the junction box and the marshaling rack.
7. Define the cable parameters between the device panel and the junction box (if the
cable exists). If the field instrument is connected directly to the marshaling rack,
specify the cable length (B) = 0.
8. Click Calculate to calculate the limit criteria (resistance, inductance, or
capacitance) and the maximum permissible cable length between the junction box
and the marshaling rack (Cable A) based on the values you entered.
Tip
• The Intrinsically Safe Calculation Results dialog box opens where
you can view the calculation results, change the units of measure, and
save the results with the different units.
• The maximum permissible length must be less than the actual length
of the cable used (Cable “A” - connecting the hazardous and non-
hazardous areas).
9. Click OK to return to the Intrinsically Safe Data Input dialog box.
10. If needed, you can do any of the following:
• View and enter revisions.
• Enter intrinsic safety notes.
• Click Print to generate and print a report that shows all the data that
you entered and the calculation results.
Related Topics

Define Tag Numbers for Intrinsic Safety Loop Calculation

1. In the Domain Explorer, right-click an instrument, and on the short-cut menu,
click Properties.
2. On the Tag Number Properties dialog box, beside the Intrinsically safe circuit
type list, click .
3. On the Intrinsically Safe Circuit Types dialog box, select the required row, and
then click Properties.
Tip
• You can also create a new intrinsically safe circuit type.
4. On the Intrinsically Safe Data Input dialog box, in both group boxes, make sure
that you express the following parameters in the following units of measure:
• Resistance — ohm
• Inductance — mH
• Capacitance — µF (microFarad)
• L/R — mH/ohm
5. Click OK to close the Intrinsically Safe Data Input dialog box.
6. Make sure that the row that you require is selected and then click OK to close the
Intrinsically Safe Circuit Types dialog box.
Related Topics

Define Circuit Cables for Intrinsic Safety Loop Calculation

1. In the Domain Explorer, right-click a cable, and on the short-cut menu, click
Properties.
2. On the Cable Properties dialog box, beside the Type list, click .
3. On the Cable Types dialog box, select the required row, and then click
Properties.
Tip
• You can also create a new intrinsically safe circuit type.
4. On the Cable Type Properties dialog box, make sure that you express the
following parameters in the following units of measure:
• Capacitance — nF (nanoFarad) /km
• Resistance — Ohm/km
• Inductance — mH/km
5. Click OK to close the Cable Type Properties dialog box.
6. Make sure that the row that you require is selected and then click OK to close the
Cable Types dialog box.
7. On the Cable Properties dialog box, under Unit of measure, select meter.
8. Under Length, define the cable length.
9. Select the Set as intrinsically safe check box, and then click OK.
Related Topics

Calculate Intrinsic Safety for a Loop

1. Start the Wiring module and click Actions > Intrinsic Safety Loop Calculation.
• Type the loop number in the data field.
• Click Find to search for a loop that requires intrinsic safety
calculation.
3. Click OK to open the Intrinsically Safe Loop Data dialog box.
Tips
• In the data window, if you select a tag for which you did not define an
intrinsically safe circuit type, nothing is displayed in the lower group
box.
• If you select a tag number for which you defined an intrinsically safe
circuit type, SmartPlant Instrumentation displays non-hazardous area
and hazardous area loop components below the data window.
4. On the Intrinsically Safe Loop Data dialog box, click Calculate.
5. In the Intrinsically Safe Calculation Results dialog box, select each tag number
for which you want to display intrinsic safety data.
6. To preview reports for all of the tags in the current loop, click Print.
Related Topics

Cable Routing: An Overview

The cable routing feature provides the ability to set up a flexible, modular model of
the cable routing in your <plant>. Cable routing sections are divided into several
categories that enable you to set up a complete cable routing sequence. These
categories match the different <plant> regions as follows:
Category Category Description and Location in the <Plant>

Trunk Standard sections that include all the cable routing that does not pass
through a built area. These sections are actually legs passing through
the <plant> junction points that function as ports, where cables enter
and exit the routing. Trunks contain trays conveying the positions
through which the cables pass.
Building Sections that pass through a built area. Building sections do not contain
trays or positions.
Panel - This in fact, is not a section category but a variable distance added to
Routing the total cable routing length. It is the distance between an instrument
Distance and the routing starting point.
Related Topics
• Cable Routing Common Tasks, page 654
• Cable Routing Flow of Activities, page 653

Cable Routing Flow of Activities

The cable routing feature allows you to create modular cable routing sections. The
sections convey the cables in your <plant>, and they subdivide into two main
categories:
• A Trunk is a standard section that can be utilized in all non-enclosed

plant areas. Trunks contain positions, fixed on trays.
• A Building is a section that passes through an enclosed area, and does not
contain positions
You plan your cable routing system according to the following flow of activities:
1. Set the cable routing options, such as cable length and position width units of
measure, cable spare length, and so forth. For details, see Set Cable Routing
Options, page 656.
2. Create named standard widths. You will use these later to create positions in the
trunk section. For details, see Manage Standard Widths, page 658.
3. Create standard positions. Positions convey the cables within the trunk sections.
For details, see Manage Standard Positions, page 658.
4. Define the maximum number of cables for each standard position, according to
the position width. This is how you assure that the number of cables does not
exceed the position cable capacity. For details, see Set the Maximum Number of
Cables for the Standard Positions, page 659.
5. Create the routing sections. For details, see Create a Routing Section, page 660.
6. Associate cables with sections. The association can be performed in single or
batch mode. The association includes the following activities:
• Selecting the cables to which you add the cable routing.
• Setting the order of the routing sections per cable.
• Selecting the active positions for each section.
Related Topics
• Cable Routing: An Overview, page 652

Cable Routing Common Tasks

The following tasks are used frequently when you manage the cable routing in your
plant.
Set Cable Routing Options

Use this procedure to set the options for the cable routing throughout a specific
<plant>. SmartPlant Instrumentation applies your selections to existing cables and
sections and to all future routing elements. When you change the Length unit of
measure, the software automatically recalculates values of routing elements that
currently exist in your plant and expresses them in the new units of measure. The
routing elements that SmartPlant Instrumentation recalculates after a change in the
Cable Routing Options dialog box are cable length, panel-routing distance, and
section length.
For more information, see Set Cable Routing Options, page 656.
Customize Cable Routing Terminology

Use this procedure to change cable routing terminology to terms that you define. You
can change any or all of the following terms: trunk section, building section, position,
section, and tray. Changes that you make are implemented in all relevant dialog
boxes and reports. For more information, see Customize Cable Routing Terminology,
page 657.
Manage Standard Widths

The standard width is a value that you enter and which SmartPlant Instrumentation
uses to define the width of the routing positions that the sections comprise. This
procedure explains how to add a standard width to your current <plant>, edit, or
delete an existing one. Note that a standard width is not necessarily associated with a
position. It only provides the ability to associate the width with positions. For more
information, see Manage Standard Widths, page 658.
Manage Standard Positions

Routing positions are the wiring elements that convey the cables in your <plant> and
separate the different cable groups inside the routing sections. You associate the
standard routing positions with the trunk sections in your <plant> and adjust their
widths to fit those positions. This way you do not have to define new positions for
every new trunk that you add. For more information, see Manage Standard
Positions, page 658.

Set the Maximum Number of Cables for the Standard Positions

The maximum number of cables is a value that you define to limit the number of
cables that you can associate with a position within a trunk section. You can add
positions to trunks only if you predefined a maximum number of cables per position.
That is, you define the number of cables for a standard position and only then the
position becomes available to include in a trunk. For more information, see Set the
Maximum Number of Cables for the Standard Positions, page 659.
Create a Routing Section

Routing sections are the wiring elements that convey the cables in your <plant>.
They subdivide into two main categories:
• Trunk— a standard section that can be utilized in all non-enclosed

<plant> areas. Trunks contain positions.
• Building— a section that passes in an enclosed area and does not contain
positions.
You define a standard position with a standard width to fit the section that includes it.
For more information, see Create a Routing Section, page 660.
Edit a Routing Section

This procedure explains how to edit the properties of a routing section. For more
information, see Edit a Routing Section, page 661.
Associate a Routing Section with Cables

The last stage in setting up cable routing is associating the different sections that you
have created with the cables in your <plant>. Once the association is completed,
SmartPlant Instrumentation calculates and sets the total length of the routing, and the
cable routing of your <plant> is ready. For more information, see Associate a
Routing Section with Cables, page 662.
Edit a Cable Routing

This feature allows you to change the sections associated with a cable, change their
order, or change the panel-routing distance. For more information, see Edit a Cable
Routing, page 663.
Copy Routing Data to Another Cable

After you create a cable routing, you can copy the routing data to other cables, thus
saving redefinition time for similar cables. Note that if you copy routing data to a
cable with existing routing, the new routing overwrites the existing routing data. For
more information, see Copy Routing Data to Another Cable, page 664.

Append Routing Data to a Cable

You can append the routing properties of an existing source cable to a destination
cable or cables. This can be an efficient way of adding sections to an existing
routing.
• A source cable is a trunk cable for which you have already defined cable
routing options, created the routing sections, and associated cables with
these sections.
• A destination cable is a trunk cable to which you want to add the routing
data of the source cable.
For more information, see Append Routing Data to a Cable, page 665.
Related Topics
Set Cable Routing Options

1. In the Wiring Module window, click Actions > Cable Routing Options.
2. On the Cable Routing Options dialog box, from the Length unit of measure
list, select a unit of measure.
3. In the message box that opens, click OK to confirm calculation in the new unit of
measure.
4. From the Position width unit of measure list, select the required unit of measure.
Tip
• Set the Position width unit of measure at initialization, and do not
change it. Although changing the length unit of measure recalculates
length values in the new unit of measure, changing the position width
unit of measure changes the label without recalculating the value of
the position width.
5. In the message box that opens, click OK to confirm the position width unit of
measure.
6. In the Cable spare length group box, to calculate the spare cable length for all
the cables in the <plant>, do one of the following:
• Select Fixed length and type its value in the box to the right.
• Select Fixed percentage, and type or select a percent value in the box
to the right.
7. Under Panel to routing distance, type the distance from a junction box or
marshaling rack to the beginning of a routing section.

8. To customize cable routing terminology, next to Customize terminology, select

the check box and then click . For details, see Customize Cable Routing
Terminology, page 657.
Note
• For cable drums with status Design or Purchased, if you change cable
spare length, SmartPlant Instrumentation recalculates the cable length, but
not for drums with status Locked.
Related Topics
Customize Cable Routing Terminology

1. In the Wiring Module window, click Actions > Cable Routing Options.
2. On the Cable Routing Options dialog box, select Customize terminology and
then click .
3. On the Cable Routing Custom Terminology dialog box, for each term that you
want to customize, do the following:
a. Click under Custom Name (Singular), and type the customized name.
b. Click under Custom Name (Plural), and type the customized name.
4. Click OK to close the Cable Routing Custom Terminology dialog box.
5. Click OK to close the Cable Routing Options dialog box.
Related Topics

Manage Standard Widths

1. In the Wiring Module window, click Tables > Cable Routing > Standard
Widths.
2. On the Standard Widths dialog box, do one of the following:
• To add a new standard width, click New.
• To edit an existing standard width, click the field that you want to edit.
• To delete a standard width, highlight the required standard width or in
the Find field, type the width that you want to delete, and click Delete.
3. Type the position name and description as required.
4. Click OK to save your changes and close the dialog box.
Related Topics
Manage Standard Positions

1. In the Wiring Module window, click Tables > Cable Routing > Standard
Routing Positions.
2. On the Standard Routing Positions dialog box, do one of the following:
• To add a new standard position, click New.
• To edit an existing standard position, click the field that you want to
edit.
• To delete a standard position, highlight the required standard position
or in the Find field, type the position that you want to delete, and click
Delete.
3. Type the required standard width value.
4. Repeat steps 1-3 for all the standard widths you want to enter.
Note
• A standard width is not necessarily associated with a position. It only
provides the ability to associate the width with positions.
Related Topics

Set the Maximum Number of Cables for the Standard

Positions
1. In the Wiring Module window, click Tables > Cable Routing > Maximum
Number of Cables.
2. On the Maximum Number of Cables dialog box, click a field and type the
maximum number of cables in the width column of the required position.
Tip
• The Maximum Number of Cables dialog box comprises a grid. The
grid displays the standard positions and standard widths that you have
added to your current <plant>.
Related Topics

Create a Routing Section

1. In the Wiring Module window, click Tables > Cable Routing > Routing
Sections.
2. On the Routing Sections dialog box, do one of the following:
• To base the new routing section on an existing routing section, click
Duplicate.
• To create a new routing section not based on an existing section, click
New.
3. In the Routing Section Properties dialog box, type the new section name or
accept the default in the Routing section field.
Tip
• The initial All or Trunk default is T-1, and the initial Building default
is B-1. Defaults for succeeding entries revise the previous name in a
given category by adding a 1 or incrementing the previous suffix by 1.
4. In the Length field, type the section length. (To change the unit of measure, see
Set Cable Routing Options, page 656.
5. From the Routing category list, select Trunk or Building.
6. If you selected Trunk, SmartPlant Instrumentation displays the Position and
widths grid. Select a defined width for each active position.
Tip
• When you define a maximum number of cables for a standard position,
the position at the specific defined width becomes available for
association with sections. In the Position – Width grid of the New
Section dialog box, the available positions and widths are marked with
a check box. Although a position can have more than one available
standard width, you can select only one standard width per position.
7. Click OK to enter the new section and close the dialog box.
Related Topics

Edit a Routing Section

1. In the Wiring Module window, click Actions > Cable Routing > Routing
Sections.
2. On the Routing Sections dialog box, filter the routing sections by selecting
Trunk or Building, or accept the default All.
3. Highlight a routing section and click Properties.
4. On the Routing Section Properties dialog box, you have the following options:
• To modify the routing section name.
• To modify the length (unless the cable assigned to this section is on a
locked drum).
• To change the section category, from the Routing category list, if the
section is not in use.
• For routing category Trunk, to select a width for each position from
the Position and widths grid (unless the cable assigned to this section
is on a locked drum).
5. Click OK to save your changes and close the Routing Section Properties dialog
box.
Related Topics

Associate a Routing Section with Cables

1. In the Domain Explorer, highlight the cables with which you want to associate
cable routing sections, and do one of the following:
• Right-click the highlighted cables, and then on the shortcut menu,
click Cable Routing.
• Click Actions > Cable Routing.
2. On the Cable Routing dialog box, from the Cable list, select a cable.
3. In the Available Sections window, highlight the available sections that you want
to associate with the selected cable, and do one of the following:
• Click
• Drag the sections to the Assigned sections pane.
4. From the Routing Position list of the required section, select the position that will
hold the cable.
Tip
• Change the order of the assigned sections by highlighting an assigned
section and clicking Move Up or Move Down.
5. Type the panel-routing distance, or accept the default.
6. Repeat steps 2 through 5 for each cable in the Cable list.
Related Topics

Edit a Cable Routing

1. In the Domain Explorer, highlight the cables whose routing you want to edit, and
click Cable Routing.
• Click Actions > Cable Routing.
2. On the Cable Routing dialog box, from the Cable list, select a cable.
3. To add additional sections to the selected cable, under Available sections,
highlight the available sections that you want to associate with the cable, and do
• Click
• Drag the sections to the Assigned sections pane.
4. To remove sections from the selected cable, under Assigned sections, highlight
the sections that you want to remove, and do one of the following:
• Click
• Drag the sections from the Assigned sections pane to the Assigned
sections pane.
5. Change the position of a section, as necessary, from the Routing Position list.
6. Change the order of assigned sections, as necessary, by highlighting a section and
clicking Move Up or Move Down.
7. Edit the panel-routing distance, as necessary, by changing the value in the Panel-
routing distance box.
8. Repeating steps 3 through 7 for each cable in the Cable Name list.
Related Topics

Copy Routing Data to Another Cable

1. In the Domain Explorer, select the cables from which you want to copy routing
data.
click Copy Cable Routing.
• Click Actions > Copy Cable Routing.
3. On the Copy Cable Routing dialog box, select a cable from the Source cable
list.
Tip
• A source cable is a trunk cable for which you have already defined
cable routing options, created the routing sections, and associated
cables with these sections. SmartPlant Instrumentation displays the
routing data for the source cable you select in the Source routing data
grid.
4. In Domain Explorer, highlight target cables, and drag them to the Destination
cables group box.
5. Select the cables to which you want to copy the routing data of the source cable in
one of the following ways:
• Select the check box to the left of each cable.
• Choose Select all cables without routing. Use this option to avoid
overwriting existing routing data.
• Choose Select all to enable overwriting of existing routing data on the
destination cables.
6. Click Copy.
Note
• To copy routing data to additional cables, repeat steps 3 through 6.
Related Topics

Append Routing Data to a Cable

1. In the Domain Explorer, select the cables that will be your source for appending.
click Append Cable Routing.
• Click Actions > Append Cable Routing.
3. On the Append Cable Routing dialog box, select a cable from the Source cable
list.
Tip
• In the Source routing data group box, SmartPlant Instrumentation
displays the routing data for the selected cable.
4. In Domain Explorer, highlight target cables, and drag them to the Destination
cables group box.
5. Select the cables to which you want to append the routing data of the source cable
in one of the following ways:
• Select the check box to the left of each cable.
• Choose Select all cables without routing. Use this option to avoid
overwriting existing routing data.
• Choose Select all to enable overwriting of existing routing data on the
destination cables.
6. Click Append.
Notes
• To append routing data to additional cables, repeat steps 3 through 6.
• SmartPlant Instrumentation appends the new sections after the original
sections of the destination cable, if there were any. You can change the
order of these sections by opening the destination cable in the Cable
Routing dialog box. For details, see Edit a Cable Routing, page 663.
Related Topics

Cable Drums: An Overview

The cable drum feature allows you to efficiently use cable drums, and setup an
organized method of cable drum assignment. The cable drum feature handles both
the optimization of existing cable drum allocations (purchased drums) and the
assignment of new cable drums when necessary (Design drums). The cable drum
feature allows you to perform cable drum assignment both automatically and
manually. The cable drum feature requires that you define pulling areas in your
<plant> where the cable drums are concentrated. From these areas you perform the
assignment of cable drums for the cables.
The pulling area that you define here does not have the same functionality as the
<area> in SmartPlant Instrumentation plant hierarchy. The pulling area is
designated for cables and cable drums only.
The steps required to set up a fully functional cable drum assignment are as follows:
1. Define the pulling areas where the cable drums are placed.
2. Associate cables with the predefined pulling areas.
3. Define drum attributes for cable types.
4. Create the cable drums that will eventually be assigned to your cables. This
includes both adding the cable drums that already exist in your <plant> and
adding the cable drums that you need to purchase to complete your required cable
drum inventory. You can also perform this automatically in a cable drum
assignment.
5. Select the cables that you want to assign to the cable drums that you have created
(even if the drums have not been purchased yet).
6. The last stage is to assign cables to cable drums. At this stage the cable drum
feature automatically adds new cable drums as required.
Related Topics
• Cable Drums Common Tasks, page 667

Cable Drums Common Tasks

The following tasks are used frequently when you manage the cable drums in your
plant.
Create and Manage a Pulling Area

The pulling area is the plant area where you concentrate cable drums. This procedure
explains how to add a new pulling area to your <plant>. Use this procedure to edit
existing pulling area data. For more information, see Create and Manage a Pulling
Area, page 669.
Associate Cables with a Pulling Area

Prior to assigning cables to drums, you have to associate your cables with a pulling
area. For more information, see Associate Cables with a Pulling Area, page 669.
Define Cable Drum Attributes for Cable Types

This procedure explains how to define cable drum attributes for cable types. This is
required because each cable type has its minimum and maximum length. The cable
drums that you will create will then be based on the cable drum attributes that you
define here. For more information, see Define Cable Drum Attributes for Cable
Types, page 670.
Manage Cable Drums Manually

This procedure explains how to create cable drums manually and set their attributes.
There are three categories of cable drums:
• Design— Cable drums that you intend to purchase in the future and you
want to design to fit your cables.
• Purchased— Existing cable drums that you want to include in a cable-
drum optimization.
• Locked— Existing cable drums that you do not want to include in a
cable-drum optimization.
For more information, see Manage Cable Drums Manually, page 671.

Assign Cables to Drums Automatically (with Optimization)

When assigning cables to cable drums, SmartPlant Instrumentation creates cable
drums automatically. You can perform this assignment and optimization in single or
in batch mode. The optimization process matches cables and the cable drums that fit
them with minimum waste of cable drum length, using the following algorithm:
• The highest priority is to utilize cable drums that are purchased but not yet
locked. Optimization may assign new cables to these drums.
• The second priority is to optimize the drum cable length for drums whose
status is design. The guiding parameters are minimum drum length and
maximum. drum length.
• The third priority is to create new cable drums of a given cable type.
For more information, see Assign Cables to Drums Automatically (with
Optimization), page 672.
Assign Cables to Drums Manually (Without Optimization)

This procedure explains how to assign a cable to a cable drum manually. This action
requires that you predefine the following for this cable:
• A cable type.
• At least one pulling area.
• A cable drum associated with the cable type and with the pulling area.
The manual cable drum assignment is performed without optimization, which means
that the designated cable drum is not necessarily the optimum for the selected cable.
For more information, see Assign Cables to Drums Manually (Without Optimization),
page 672.
Related Topics
• Cable Drums: An Overview, page 666

Create and Manage a Pulling Area

1. In the Wiring Module window, click Tables > Pulling Areas.
2. On the Pulling Areas dialog box, do one of the following:
• To create a new pulling area, click New.
• To edit a pulling area, click the field that you want to edit.
• To delete a pulling area, select a row and click Delete.
3. Type the pulling area name (required) and description in the respective fields.
4. Click OK.
Note
• The pulling area that you define here does not have the same functionality
as the <area> in SmartPlant Instrumentation plant hierarchy. The pulling
area is designated for cables and cable drums only.
Related Topics
Associate Cables with a Pulling Area

1. In the Domain Explorer window, select and right click the cable that you want to
associate with a pulling area.
3. On the Cable Properties dialog box, from the Pulling Areas list, select the
pulling area that you want the selected cable to be associated with.
Tip
• You can use the Pulling Areas dialog box to add new pulling areas or
edit existing.
4. Click OK to save your changes and close the Cable Properties dialog box.
Related Topics

Define Cable Drum Attributes for Cable Types

1. In the Wiring Module window, click Tables > Cable > Types.
2. On the Cable Types dialog box, select a cable type and click Properties.
3. On the Cable Type Properties dialog box, type the appropriate data in the
following fields:
• Maximum drum length— type the maximum cable drum length for
this cable type.
• Minimum drum length— type the minimum cable drum length for
this cable type.
• Length UOM— select the length unit of measure.
• Drum spare length percent— enter the percent of the used cable
drum length to allocate to spare cable length. (The spare and the used
length combine to the total length.)
4. Click OK to save your changes and close the Cable Type Properties dialog box.
5. Click OK to close the Cable Types dialog box.
Related Topics

Manage Cable Drums Manually

1. In the Wiring Module window, click Tables > Cable Drums.
2. On the Cable Drums dialog box, select a cable type to filter the data window.
• Click New to add a new cable drum.
• Select a cable drum row and click in the appropriate fields to edit the
data.
• Select a cable drum row and click Delete.
4. In the data window, type the data in the fields or select the data from the lists
according to the following table:
Column Name Column Description
Name Type the cable drum name.
Description Type the cable drum description if required.
Pulling Area Select the pulling area where the cable drum is located.
Length Type the total cable drum length (utilized + spare).
Utilized Length Displays the utilized cable length of the total drum length.
Length UOM Select the unit of measure used to measure the drum length.
Drum Status Select one of the following:
• Design— cable drum in the design stage
(not purchased yet); available for cable-drum
optimizations.
• Purchased— a purchased cable drum of
defined length that you want to include in cable-drum
optimizations.
• Locked— a purchased cable drum that
is assigned to a cable and locked against reassignment
(cable drum optimizations).
Spare Length Type the percent of the used cable drum length to allocate to spare
Percent cable length.
5. Click OK to save your changes and close the Cable Drums dialog box.
Note
• SmartPlant Instrumentation creates cable drums automatically when you
assign cables to cable drums and additional cable drums are required.

Assign Cables to Drums Automatically (with Optimization)

Important
• The procedure below only works if you created a cable and assigned a
pulling area.
1. In the Wiring Module window, click Actions > Cable-Drum Assignment.
2. On the Cable-Drum Assignment dialog box, select the following filtering
criteria:
• Cable type
• Pulling area
• Select Include assigned cables to display cables that are already
assigned to cable drums, in addition to those not yet assigned.
• Clear Include assigned cables not to display assigned cables.
4. Click Find.
5. Select the cables that you want to include in the cable drum assignment.
Tip
• If you selected Include assigned cables in step 3 above, optimizing
can change existing cable assignments.
6. Click Optimize.
Related Topics
Assign Cables to Drums Manually (Without Optimization)

1. In the domain Explorer, right-click a cable and then click Properties.
2. On the Cable Properties dialog box, do the following:
a. From the Pulling area list, select the pulling area that the designated cable
drum is associated with.
b. Make sure that the cable type is selected from the Type list.
c. From the Cable Drum list, select the cable drum to which you want to assign
the selected cable. Click to add a y required items that are not on the list.
3. Click OK to save your changes and close the Cable Properties dialog box.
Related Topics

Managing Panel Locations: An Overview

Panel location is a panel property that you define when creating or editing the
properties of a panel. You can set multiple location levels, for example, building –
floor – room. You can use each level to define a panel location.
Related Topics
• Managing Panel Locations Common Tasks, page 673
Managing Panel Locations Common Tasks

The following tasks are used frequently when you manage the panel locations in your
plant.
Define a New Panel Location

This option allows you to define a new panel location. You can then select this
location when defining panel properties.
Note that panel location is defined per domain; therefore, all the panel location
definitions that have been made in the Administration module are available
throughout the entire current domain.
For more information, see Define a New Panel Location, page 674.
Modify Panel Location Properties

This option allows you to modify the properties of a panel location. You can rename
a location and change its description. For more information, see Modify Panel
Location Properties, page 674.
Change the Location of a Panel

You can change the location of a panel either in the Domain Explorer by dragging a
panel to another location in the Panels by Location folder or in the Location
Manager. For more information, see Change the Location of a Panel, page 675.
Dissociate a Panel from a Location

While defining panel properties, you can dissociate a panel from a location. For more
information, see Dissociate a Panel from a Location, page 675.
Delete a Panel Location

This procedure explains how to delete a panel location in the Location Manager.
For more information, see Delete a Panel Location, page 676.
Related Topics
• Managing Panel Locations: An Overview, page 673

Define a New Panel Location

1. Do one of the following to open the Location Manager dialog box:
• In the Wiring module, click View > Location Manager.
• Click next to the Location list arrow in any appropriate Properties
dialog box.
2. Do one of the following in the Location Manager:
• To define a location on the highest hierarchy level, right-click
Location, and then on the shortcut menu, click New.
• To define a location under an existing location definition, expand one
of the existing location levels, then right-click a location and on the
shortcut menu, click New.
3. On the Location Properties dialog box, type the location name and description as
you require.
4. Click OK.
Note
• You can define a new location on the highest hierarchy level directly from
the Domain Explorer. Right-click the Panels by Location folder, and
then on the shortcut menu, click New > Location.
Related Topics
Modify Panel Location Properties

dialog box.
2. Right-click a location and then on the shortcut menu, click Properties.
3. On the Location Properties dialog box, type the location name and description as
you require.
4. Click OK.
Related Topics

Change the Location of a Panel

1. On the Properties dialog box of a panel, click next to the Location list arrow.
2. In the Location Manager, select a location and click OK.
Tip
• To dissociate a panel from a location without assigning another
location, click Dissociate.
3. Click OK on the Panel Properties dialog box.
Note
• Also, you can change the location of a panel in the Domain Explorer
without opening the Properties dialog box for a panel. Expand the
Panels by Location folder and select a panel. Drag it to another location,
as you require.
Related Topics
Dissociate a Panel from a Location

1. In the Domain Explorer, right-click a panel.
3. Click next to the Location list arrow.
4. In the Location Manager, click Dissociate.
Related Topics

Delete a Panel Location

dialog box.
2. Right-click a location.
3. On the shortcut menu, click Delete.
Note
• You can delete a location directly from the Domain Explorer without
opening the Location Manager. In the Domain Explorer, expand the
Panels by Location folder. Then, right-click a location and then on the
shortcut menu, click Delete.
Related Topics

Generating Wiring Reports Common Tasks

The following tasks are used frequently when you generate wiring reports in
List of Wiring Reports

This topic lists all the reports that you can generate in the Wiring module.. For more
information, see List of Wiring Reports, page 678.

You can follow a signal along a sequence of wires. SmartPlant Instrumentation uses
wire groups, group level and group sequence data to follow a signal along a series of
wires and check for any discontinuity. The wire group is the signal name
representing the tag number from which the signal originates. The result is displayed
in a point-to-point wiring diagram that you can print. For more information, see
Trace a Signal in a Point-to-Point Wiring Diagram, page 584.
Generate a Connection Report from the Connection Window

While in the Connection window, you can generate a connection report for the
current terminal strip. The report lists all the cables connected to the selected
terminal strip and shows all the cable-sets within each cable, the wire tags, their color,
and terminal number. This report does not show adjacent connections. For more
information, see Generate a Connection Report from the Connection Window, page
586.

This option enables you to generate a report showing I/O assignments for an I/O card
or I/O termination that you select in the I/O Assignment window. For more
information, see Generate an I/O Tag Assignment Report, page 601.
Generate a Panel Strip Report from the Cross Wiring Window

This option enables you to generate a panel – strip report that displays the
connections and adjacent connections for the terminal strip you selected from the
Primary terminal strip list in the Cross Wiring window. For more information, see
Generate a Panel Strip Report from the Cross Wiring Window, page 614.
Display Channels and Wiring Equipment in Panel-Strip Reports

When generating a Panel-Strip report, it is possible to specify whether or not to
display grouping of channels, wiring equipment, and I/O channels. To do so, you
need to specify a set of parameters in the Custom preferences for wiring. For more
information, see Display Channels and Wiring Equipment in Panel-Strip Reports,
page 684.

List of Wiring Reports

The following table lists all the reports that you can generate in the Wiring module.
Type Report Description

Cable Cable Layout (two styles) Shows a graphical representation of
cable layout for the selected cables.
Cable Schedule Provides cable schedule data for the
selected cables.
Cable Schedule with Provides cable schedule data with
Routing Data routing for the selected cables.
Cable Connector Take-Off Provides a list of connector types, their
descriptions, and quantity.
Cable Summary Take-Off Provides a list of cable types, their
descriptions, part numbers, and total
cable length per cable type.
Cable Gland Take-Off Provides a list of cable glands, their
descriptions, and quantity.
Reference Cable List Provides a list of reference cables.
Cable Harness Shows a graphical representation of
cable connections according selected
cable harnesses.
Cable Routing Routing Width Provides a list of trunks, their
positions, and widths.
Unused Trunks Provides a list of unused trunks, their
Used Trunks Provides a list of used trunks, their
Section List Provides a list of sections and their
lengths.
Cable Book Provides a list of cables, their types,
and panel routing distances.
Cable Book (Detailed) Provides a list of cables, their types,
sections, lengths, and panel routing
distances.
Cross Section List Provides a list of sections, their
lengths, and associated cables.
Cross Section List Provides detailed information about all
(Detailed) the existing sections in the current
domain.


Cable Drum Drum Schedule Provides detailed information about the
selected drums and their associated
cables.
Drums Summary Provides a list and summary
information about the selected drums
and their associated cables.
Cables Not Assigned to Provides a list of cables that are not
Drums assigned to drums.
Drum List (Unused Provides a list of drums not assigned to
Cables) cables.
<Plant> Cable Device Cables Provides a list of device cables and
List their associated device panels.
Non-Device Cables Provides a list of non-device cables and
their associated device panels.
Panel-Strip Panel-Strip with Adjacent Shows a graphical representation of
Connections terminal connections and their adjacent
connections.
Panel-Strip without Shows a graphical representation of
Adjacent Connections (two terminal connections without adjacent
styles) connections
Multi-Strip Multi-Strip with Adjacent Shows a graphical representation of
Connections terminal strip connections with
adjacent connections.
Multi-Strip without Shows a graphical representation of
Adjacent Connections terminal strip connections without
adjacent connections.
Signals Shows a graphical representation of a
multi panel-strip signals for selected
panels.


Panels Panel-Strip Signals Shows a graphical representation of
terminal strip signals with adjacent
connections.
I/O Tag Assignment Shows I/O tag assignment information
for selected terminal strips.
Wiring Equipment Shows a graphical representation of
Connection wiring equipment connections for
selected terminal strips.
Reference Panel List Provides a list of reference panels.
Device Panel Connection Provides a list of device panels, their
associated tag numbers, and device
cables.
Plug-and-Socket Provides a graphical representation of
Connections plug-and socket connections for
selected connectors.
<Plant> Panel Device Panel - Current Provides a list and summary
List <Plant> information of all device panels in the
current plant.
Device Panel - Current Provides a list and summary
<Unit> information of all device panels in the
current unit.
Junction Box Provides a list and summary
information of all the existing junction
boxes.
Marshaling Rack Provides a list and summary
information of all the existing
marshaling racks.
Cabinet Provides a list and summary
information of all the existing cabinets.
Distant DCS/PLC Provides a list and summary
information of all the existing distant
DCS and PLC cabinets.
Non-Distant DCS/PLC Provides a list and summary
information of all the existing non-
distant DCS and PLC cabinets.
Panel Network Class Provides a list of and summary
information of panels according to a
selected network class.


Telecom Communication Line Shows a graphical representation of a
Report communication line for a selected
telecom line.
Network Class Report Provides a list and summary
information of panels for a selected
network class.
Single Speaker Report Shows a graphical representation of the
connections for a selected speaker.
Actual Load Report Provides a list and actual load
summary information for a selected
terminal strip.
Speaker Load Report Provides a list and speaker load
summary information for a selected
terminal strip.
PA Amplifier Report Shows a graphical representation of a
PA amplifier connection for a selected
terminal strip.
Amplifier Actual Load Provides a list of actual loads for a
Report selected amplifier.
Amplifier Speaker Load Provides a list of speaker loads for a
Report selected amplifier.
Miscellaneous I/O Map Provides an I/O map report for a
selected DCS or PLC cabinet.
DCS I/O Card Summary Provides a summary of I/O cards and
their summary information.
Control System Tag List Provides a list of control system tags
and their summary information.
Related Topics

Generate a Connection Report from the Connection

Window
• On the menu bar, click Reports > Connection.
• Click .
2. In the Print Preview prompt, click Yes to display the report print preview or
click No to print out the report without displaying its print preview.
Related Topics
564
Generate a Panel Strip Report from the Cross Wiring

Window
1. Do one of the following in the Cross Wiring window:
• Click Reports > Panel-Strip.
2. Click Yes to open the print preview or click No to print the report without
displaying it on your screen.
Related Topics


1. In the I/O Assignment window, under I/O assignment, select an I/O card or an
I/O termination from the list.
2. Select the required I/O card from the I/O card name list.
• Click .
• Click Reports > Tag assignment Report.
4. Click Yes to open the print preview of the report or click No to send the report to
your default printer.
Related Topics
Generate Panel-Strip Reports as PDF Files

Important
• Set your .pdf generator preferences to prompt for a .pdf file destination.
• From the Windows Start menu, click Settings > Printers, and then define
your .pdf generator as the default printer.
• Select terminal strips and I/O cards for which you want to generate
panel-strip reports.
• Select panels for which you want to generate panel-strip reports.
2. Right-click on a selected item, and then on the shortcut menu, click Panel-Strip
Reports , and then click one of the following:
• With Adjacent Connections
• Without Adjacent Connections (Style 1)
•Without Adjacent Connections (Style 2)
3. When prompted to preview the printed documents, click No.
Related Topics

Display Channels and Wiring Equipment in Panel-Strip

Reports
1. In the Wiring module, click File > Preferences.
2. On the Preferences dialog box, under Wiring, click Custom.
3. In the Custom features for the Wiring module group box, under Parameter,
type DisplayChannels.
4. Under Value, type a string that consists of three digits made up of 0 and 1, for
example, 110.
In the string, the first digit refers to grouping of channels, the second digit refers
to wiring equipment, and the third digit refers to I/O channels. The digit "1"
instructs the software to display the channels and the wiring equipment. Zero
means not to display the channels or the wiring equipment. For example, if you
type 001, the software will display the I/O channels only. If you type 110, the
software will display the grouping of channels and the wiring equipment items but
it will not display the I/O channels. Note that the default setting is 010, which
displays wiring equipment items only.
Related Topics

Cable Block Diagrams: An Overview

Cable Block Diagrams (CBDs) provide a graphical representation of the
interconnection of the cables and the various junction boxes, marshalling racks,
cabinets, and so forth in your project. They show the project cable flow between the
various cables and cabinets of your project.
Cable Block Diagrams are ideal for use in the preliminary planning stages of your
plant to verify the destination panels for cables as no wiring connections or
terminations are needed at this early stage of your project. A CBD is also used for
ordering made to order (MTO) cables at the feed stage of your project, and later after
completion of your project, as part of the maintenance program to show the location
of all major cables, panels, junction boxes, and so forth.
SmartPlant Instrumentation allows you to drag and drop panels from the Domain
Explorer to your drawing and position them exactly where you want. The software
creates a representation of existing cables on the fly, or you can manually connect
cables between item connection points.
Related Topics
• Cable Block Diagram Common Tasks, page 686

Cable Block Diagram Common Tasks

The following tasks are used frequently when working with cable block diagrams in
Create a Cable Block Diagram

This procedure shows you how to create a new cable block diagram, add items, show
already connected cables, and connect cables between the items. Using symbols
supplied with the software you drag and drop items where you want to position them
within the drawing. When you connect cables between the different items of
equipment, the software checks that the connection point is valid, and makes the
connection. If no connection point is available the software does not allow the cable
to be connected. For more information, see Create a Cable Block Diagram, page
687.
View an Existing Cable Block Diagram

This procedure shows you how to view an existing cable block drawing. For more
information, see View an Existing Cable Block Diagram, page 690.
Add Cables and Objects to an Existing Cable Block Diagram

This procedure shows you how to add cables and items to an existing cable block
diagram. For more information, see Add Cables and Objects to an Existing Cable
Block Diagram, page 689.
Disconnect Cables from Items in a Cable Block Diagram

This procedure shows you how to disconnect cables from items on your drawing. For
more information, see Disconnect Cables from Items in a Cable Block Diagram, page
690.
Remove Items from a Cable Block Diagram

This procedure shows you how remove an item, such as a PDB, from your drawing.
For more information, see Remove Items from a Cable Block Diagram, page 691.
Related Topics
• Cable Block Diagrams: An Overview, page 685

Create a Cable Block Diagram

1. On the Domain Explorer, locate the Drawings folder.
2. In the Drawings folder, locate the Cable Block Diagram folder.
3. Right-click on the Cable Block Diagram folder, and from the shortcut menu
select New > Block Diagram.
4. On the Document Properties (New) dialog box, type a value for the Document
number and Description fields.
5. Click OK.
6. In the Cable Block Diagram folder, right-click your new document, and from the
shortcut menu select Reports > Generate Cable Diagram.
7. At the prompt, click Yes to preview your drawing, a new blank drawing opens in
the Enhanced Report Utility.
8. In the Enhanced Report Utility, open the Domain Explorer by doing one of the
following;
• Press F7
• Click Tools > Domain Explorer
• Click
9. From the Domain Explorer in the Enhanced Report Utility drag the panels you
require, and position them on the drawing.
Tip
• The order that you drag the panels onto the drawing will define the
sorting order that will be used in the generation process of the
connection, for example; if you drag the DCS panel first, then the JB,
and finally the device panel, the software will connect the DCS to the
JB and then the JB to the device panel.
10. Click to allow the software to automatically regenerate your drawing, and
show any cables and there connections between the physically wired items.

11. To make the connections between the items manually, do the following;
a. Select any item on the drawing and do one of the following:
• Click Activate Connection Mode .

• Click Edit > Activate Connection Mode.
b. On the Domain Explorer select the cable you want to connect between two
items.
c. Move the cursor over the drawing to view the available, valid connect points
of the items and cable category on your drawing.
d. Click the connect point of the item you want the cable to connect 'From'.
e. Click the connect point of the item you want the cable to connect 'To'.
f. Select another cable or click View > Refresh to view the drawing with the
cable attached.
Related Topics

Add Cables and Objects to an Existing Cable Block

Diagram
1. Open the CBD that you want to add items to. For further details, see View an
Existing Cable Block Diagram, page 690.
2. In the Enhanced Report Utility, open the Domain Explorer by doing one of the
following;
• Press F7
• Click Tools > Domain Explorer
• Click
3. From the Domain Explorer in the Enhanced Report Utility drag the objects you
want to add to the drawing, and position them on the drawing.
4. Click to allow the software to automatically regenerate your drawing, and
show any cables and there connections between the physically wired items.
5. To make the connections between the items manually, do the following;
a. Select any item on the drawing and do one of the following:
• Click Activate Connection Mode .

• Click Edit > Activate Connection Mode.
b. On the Domain Explorer select the cable you want to connect between two
items.
c. Move the cursor over the drawing to view the available, valid connect points
of the items and cable category on your drawing.
d. Click the connect point of the item you want the cable to connect 'From'.
e. Click the connect point of the item you want the cable to connect 'To'.
f. Select another cable or click View > Refresh to view the drawing with the
cable attached.
Related Topics

View an Existing Cable Block Diagram

1. On the Domain Explorer, locate the Drawings folder.
2. In the Drawings folder, locate the Cable Block Diagram folder.
3. In the Cable Block Diagram folder, right-click the drawing you want to view,
and from the shortcut menu select Reports > Generate Cable Diagram.
4. At the prompt, click Yes to preview your drawing, the drawing opens in the
Related Topics
Disconnect Cables from Items in a Cable Block Diagram

1. Open the CBD that you want to disconnect cables from. For further details, see
View an Existing Cable Block Diagram, page 690.
2. Select the cable you want to disconnect.
• Click .
• Click Edit > Disconnect.
• Right-click, and on the shortcut menu, click Disconnect Items.
4. At the prompt, select the required check box, and click OK.
Notes
• If the cable for disconnection is only connected to one item, no prompt
will appear and the cable is disconnected automatically.
• Disconnecting both sides of the cable results in the loss of any wiring
associated with the connection.
Related Topics

Remove Items from a Cable Block Diagram

1. Open the CBD that you want to disconnect cables from. For further details, see
View an Existing Cable Block Diagram, page 690.
2. On the drawing, select the item that you want to remove.
• Click .
• Click Edit > Remove.
• Press the Delete key.
Related Topics

Associate Cable with Panels: An Overview

You use the Associate Cable with Panels feature in conjunction with cable block
diagrams, to associate a specific cable to specific panels. When you use the cable in
your cable block diagram the panels that are associated with the cable are
automatically placed on your drawing along with the cable.
By dragging panels from the Domain Explorer to the Associate Cable with Panels
window you can associate the panel with either side of the cable. You can see which
panels are already associated or connected to the cable and to what side of the cable
the panel is associated. Also you can move a panel from one side of the cable to the
other.
Related Topics
• Associate Cable with a Panel, page 692
Associate Cable with a Panel

1. On the Domain Explorer, navigate to the Cables folder.
2. Open the Cables folder, and select the cable you want to associate with a panel.
Tip
• You can choose more than one cable at the same time by clicking on
the required cables in the Items pane in the Domain Explorer. In the
Associate Cable with Panels window, you choose the cable that you
want to associate to a panel from the Cable pick list in the window.
3. Right-click on the cable, and from the shortcut menu, click Actions > Associate
Panels, the Associate Cable with Panels window opens.
Tip
• The Associate Cable with Panels window shows the physically
connected panels as well as the associated panels. A cable that is
already associated to a panel, displays next to the panels
name. A cable that is physically connected to a panel, displays
next to the panels name.
4. On the Domain Explorer, navigate to the Panels by Category folder.
5. Locate the required panel you want to associate with the cable.

6. From Panels by Category folder, drag the required panel icon on to the Cable
End One or Cable End Two column of the Associate Cable with Panels
window.
Tips
• You can associate more than one panel with the required cable.
• To change a panels cable end association, drag the panel from one
cable end column to the other cable end column.
7. Close the Associate Cable with Panels window, click Yes at the prompt to save
the associations.
Notes
• Cable relationships which were manually associated with panels are not
removed or deleted by the software when physically connected with the
panels.
• The relationship between the physically connected panels and the cable
shown in the Associate Cable with Panels window can not be deleted.
They are removed when the cable is disconnected.
• The Associate Cable with Panels window does not display, or take into
consideration, pre-assigned panels or junction boxes that were assigned
using instrument connection pre-assignment browsers.
Related Topics
• Associate Cable with Panels: An Overview, page 692

Specifications: An Overview
The Specifications module provides the means to efficiently generate detailed
specification documents (often referred to as specs). This is helpful for engineering
and ordering procedures and provides a useful permanent record for checking
installed instruments. The Specifications module also incorporates data from the
Instrument Index, Process Data, and Calculation modules into generated documents.
You can generate any type of specification (that is, single-tag instrument spec,
composite spec, multi-tag spec, and so forth) in the Specifications module. Also, it is
possible to generate single-tag instrument specs in the Domain Explorer. Note,
however, that if you want to generate a spec in the Domain Explorer, you must first
assign a specific spec form to the instrument type profile. A generated specification
automatically appears in the Domain Explorer, under the items for which you
generated the specification. You can open an existing spec either from the Domain
Explorer, Specifications module, or Instrument Index Standard Browser view.
When printing a specification, we recommend that the print sheet size be either A4 or
Letter. Note, however, that if the title block assignment method in the current domain
is defined as Standard (used in all modules), you need to adjust your title block
before printing specs using the Letter size. For details, see Spec Title Blocks: An
Overview, page 801.
Related Topics
• Composite Specifications: An Overview, page 793
• Copying Specification Data Common Tasks, page 809
• Managing Spec Pages Common Tasks, page 705
• Multi-Tag Specs Common Tasks, page 770
• Non-Instrument Specs Common Tasks, page 790
• Principles of Generating Specifications, page 695
• Printing Specifications and Reports Common Tasks, page 854
• Save, Export, and Import Options Common Tasks, page 824
• Single-Tag Specs Common Tasks, page 760
• Spec Forms Common Tasks, page 743
• Spec Title Block Common Tasks, page 803
• Specification General Operations Common Tasks, page 697

Principles of Generating Specifications

SmartPlant Instrumentation generates a specification based on a pre-defined spec
form that you associate with the source item. Each form consists of one or more spec
pages, which, in turn can contain one or more sections. A spec page that does not
include sections you define in the Section Editor is considered a single-section page.
A spec page that contains sections you define in the Section Editor is referred to as
composite.
When you first create a specification for an item, you have to specify the form
number to create the item-form association. On subsequent occasions, you only need
to specify the item number to display the specification. It is only possible to generate
a spec in the Specifications module. On generating a spec, the software automatically
creates a unique document number for the spec.
Each specification is made up of data portions. For example: general data, process
data, construction data, purchase data, a note field, and a specification header, which
is the title block. The General Data portion of the spec includes details that were
entered in the Instrument Index module. The Process Conditions portion values are
derived from the Process Data module (if available) along with calculation results
from the Calculation module (if available). If you defined multiple cases for a given
tag, the specification displays the process data from the governing case.

You can generate the following types of specifications:
• Single-item specification — a document with details about a single item,

or a specific process data case of an instrument. The source form for such
a document can only contain single-section pages.
• Multi-tag instrument specification — a document with details about two
or more instruments. A multi-tag instrument specification includes
common pages with fields that are identical for all of the instruments, and
a SEE LIST page with values that differ from instrument to instrument. A
multi-tag specification is only available when the item type is instrument.
The source form for such a document can only contain single-section
pages.
• Loop composite specification — a document with details about a loop
and its instrument tags. The source form for such a document must
contain sections you define in the Section Editor: one loop section and
one or more instrument sections.
• Instrument composite specification — a document that integrates data
about several instruments or process data cases of an instrument. In
contrast to multi-tag instrument specifications, an instrument composite
specification does not have common pages and can include tags whose
process functions are not identical. The source form for such a document
must contain sections you define in the Section Editor. Each section in a
composite spec page contains data pertinent to a specific instrument tag or
process data case.
It is possible to generate specs either in the Specifications module, or in the Domain
Explorer. In the Specifications module, you can generate one spec at a time, and
open this spec on completing the generation. In the Domain Explorer, you can only
generate instrument specs but you can generate specs in batch mode, provided that
you defined the instrument type profile for the instruments you select in the Domain
Explorer.
Notes
• If you want to generate a non-instrument spec, for example, a panel spec, a
hook-up item spec, and so forth, you must first restore the appropriate
library forms.
• You cannot generate specifications for virtual tags.
• It is only possible to generate one spec at a time.
Related Topics
• Multi-Tag Specs: An Overview, page 769
• Non-Instrument Specs: An Overview, page 789
• Process Data Case Specs: An Overview, page 765
• Single-Tag Specs: An Overview, page 759

Specification General Operations Common Tasks

The following tasks deal with such operations as batch generation and deletion of
specs, describes the ways of defining spec document numbers and opening existing
specs, and also addresses other miscellaneous operations you can perform with specs
in SmartPlant Instrumentation.
Generate Instrument Specs in Batch Mode

Use this procedure to generate specs for instruments you select in the Domain
Explorer, or Instrument Index Standard Browser view. For more information, see
Generate Instrument Specs in Batch Mode, page 698.
Open a Spec from the Instrument Index Standard Browser View

You can open an existing specification from an Instrument Index Standard Browser
view. To open a spec, you must make sure that on the Preferences dialog box, under
Browser view, the Open specification sheet setting is either Always or Ask User.
For more information, see Open a Spec from the Instrument Index Standard Browser
View, page 699.
Open a Spec from the Specifications Module

Use this procedure to find an item and the form number on which the item
specification is based and open it the Specifications module. For details, see Open a
Spec from the Specifications Module, page 700.
Create a Tag Number in the Specifications Module

Use this procedure to create an instrument tag in the Specifications module. This
allows you to generate an instrument specification without having to create a new
instrument tag first in the Instrument Index module or the Domain Explorer. For
more information, see Create a Tag Number in the Specifications Module, page 701.
Delete Specs in Batch Mode

This procedure allows you to delete a batch of specifications. You can use the same
procedure if you need to delete only one specification. Using this procedure, you can
delete single-tag specs and multi-tag specs. It is only possible to delete specs from
the Specifications module. The software does not allow you to delete a spec that is
currently assigned to a Specification Binder package or revised in the Document
Binder module. For more information, see Delete Specs in Batch Mode, page 702.
Add Expanded Notes and Remarks

Use this procedure to add text in the Note tab of a specification if the space in the
note box in the specification data sheet is insufficient to enter all the text string. For
more information, see Add Expanded Notes and Remarks, page 701.

Ways of Defining a Spec Document Number

This topics lists the Specifications module options that allow you to define a
document number for a spec. If the Domain Administrator has set the document
number naming convention for specs, the software automatically creates a default
document number on generating a specification. You can either accept this number or
modify it as you require. For more information, see Ways of Defining a Spec
Document Number, page 703.
Related Topics
• Specifications: An Overview, page 694
Generate Instrument Specs in Batch Mode

• In the Instrument Index module, open the Instrument Index Standard
Browser view, and then, select one or more instruments.
• Press F7 to open the Domain Explorer and then, in the Items pane,
select the instruments you require.
2. Right-click the selected instruments, and then, on the shortcut menu, click
Actions > Generate a Specification.
Tip
• The software generates specs according to the profile settings defined
for the instrument type to which the selected instrument tags belong.
For example, if you want to add certain instruments to a see list of a
multi-tag spec, make sure that on the Instrument Type Profile dialog
box, you specified both the spec form number and the see list format.
3. On the Results dialog box, view the spec generation results, and then click Close.
Tip
• The software does not open the generated specs automatically because
you cannot open several specs at a time. If you want to open a spec,
select a specific instrument and then, on the shortcut menu, click
Reports > Specification.
Related Topics

Open a Spec from the Instrument Index Standard Browser

View
1. In the Instrument Index Standard Browser View, select an instrument.
2. On the main toolbar, click .
Note
• You can only perform this procedure if you have already generated a spec
for the selected tag in the Specifications module. Also, to open a spec,
you must make sure that on the Preferences dialog box, under Browser
view, the Open specification sheet setting is either Always or Ask User
Related Topics

Open a Spec from the Specifications Module

• On the Modules menu, click Specifications.
2. On the Actions menu, click Open Specification.
3. On the Open Specification dialog box, from the Item type list select the type of
the item whose spec you want to open.
4. If the item type is Instrument, from the Tag class list, select the appropriate tag
class.
5. With the mouse pointer in the Item number box, do the following:
a. Click Find to open the Find Items dialog box.
b. In the boxes in the upper part of the dialog box, type or select the parameters
for the properties that you want to find.
c. Click Find to display a list of items according to the search parameters that
you have selected.
d. Select the required item from the retrieved list.
e. Click OK to accept your choice and return to the Open Specification dialog
box.
6. With the mouse pointer in the Form number box, do the following:
a. Click Find to open the Select Specification Form dialog box.
b. Select the required form and click OK.
7. On the Open Specification dialog box, click OK to open the spec associated with
the item that you selected.
Related Topics
• Open a Spec from the Instrument Index Standard Browser View, page 699

Create a Tag Number in the Specifications Module

1. Click File > Preferences > Specifications, and on the General tab, under Tag
creation, select Allowed.
2. On the Specifications Module window menu bar, click Actions > Open
Specification.
3. On the Open Specification dialog box, from the Item type list, select
Instrument.
4. On the Item number box, type the number of the instrument that you want to
create and click Yes when prompted to create a new tag number.
5. If the Select Instrument Type dialog box opens, select the appropriate
instrument type and click OK.
6. On the Loop Number dialog box, accept the displayed loop number or type a
new one as required, and then click OK.
7. On the Tag Number Properties dialog box, define the tag properties as you
require, and then click OK.
Tip
• At this stage, you can define the spec form number and generate a
specification for the instrument tag that you have created.
Related Topics
• Open a Spec from the Specifications Module, page 700
Add Expanded Notes and Remarks

• In a given specification, do the one of the following:
• Click Actions > Expand Notes.
• Click the Notes tab in the specification.
Tip
• On SQL Server, the Note sheet can accept up to 255 characters; on
Oracle or Sybase Adaptive Server Anywhere, you can type up to 2000
characters.
• Non-English, special character ASCII code, used in a note, is not
displayed correctly in print preview.
Related Topics

Delete Specs in Batch Mode

1. With the Specifications window open, on the Actions menu, click Delete
Specifications.
2. In the Select Items dialog box, find and select the items whose specs you want to
delete.
Tips
• If you created instrument specifications per tag case, you can delete
specifications on a per-case basis. For example, if you applied three
process data cases to a tag, three records appear in the Search results
data window. The Case column values indicate whether instrument
tags have tag process data cases.
• If the tag number selection includes a master tag, the software prompts
whether you want to perform or cancel the deletion of the
specifications. You have an option to cancel the deletion because
when you delete a master tag, the software dissociates all the other
tags from the multi-tag specification to which the master tag belongs.
3. In the Delete Specifications dialog box, click Run.
Tips
• If the software could not delete a specification, the source item appears
in the Items skipped during deletion data window. You can print out
the item list, if needed. These records are not saved after you close the
Delete Specifications dialog box.
• When you delete a specification, the software automatically deletes all
the associated revisions as well, whether you saved them to the
database, or as files. The software removes revisions that were saved
as files form the Manage Spec Revisions dialog box, and also from
the folders to which they have been saved.
Note
• Deleting a spec does not affect process data. The software only deletes the
specification document, together with the document number and
associated revisions, whether you saved them to the database, or as files.
The software removes revisions that were saved as files form the Manage
Spec Revisions dialog box, and also from the folders to which they have
been saved.
Related Topics

Ways of Defining a Spec Document Number

In the Specifications module, you have the following ways of defining a spec
document number:
• When generating a new spec — On the New Specification dialog box, in

the Document number box, you can modify the default document
number as you require. The software always generates automatically a
document number for a specification, regardless of whether the document
number naming convention exists. If the domain Administrator has not
defined a naming convention for spec document numbers, the software
creates the document number using the item tag name as a source, and
append the – SP suffix.
• In the spec title block — You can open a spec and define the document
number in the Doc No. field of the title block.
• In the Revisions dialog box — With a spec displayed, you open the
Revisions dialog box and, in the Document number box, define the
document number.
Notes
• The document number string can contain up to 50 alpha-numeric
characters, including spaces.
• The document number must be unique.
• If you remove the document number, the current spec document does not
appear in the Document Explorer.
Related Topics

Specification Pages: An Overview

Specification pages are the primary templates for spec forms, on which you base
specs. Spec pages enable you to categorize data within a specification form. For
example, a specification form can contain a thermowell specification page, a control
valve specification page, and a large note page.
SmartPlant Instrumentation provides a default library of spec pages you can use in
spec forms. A spec is always associated with a specific process function. If needed,
you can select a different process function for a page, provided that this page is not in
use in specs. A spec page contains a number of data fields, which correspond to table
columns in the database, and also contains field headers, which correspond to column
headers in the database. You can customize the data fields and fields headers to fit
specific requirements. You cannot, however, create new pages in SmartPlant
Instrumentation.
All spec pages are based on the A4 print sheet size. It is also possible to use the
Letter print sheet size when printing specs. Note, however, that if the title block
assignment method in the current domain is defined as Standard (used in all
modules), you need to adjust your title block before printing specs using the Letter
size. For details, see Spec Title Blocks: An Overview, page 801.
You open and manage spec pages in the Page Editor of the Specifications module.
Then you can use the Edit Fields and Headers floating toolbar options to modify the
spec page field layout without having to use a third-party interface, such as
InfoMaker. Note, however, that if you want to assign new select lists or drop-down
data window to spec page fields, you must use InfoMaker.
Changes that you make on the page automatically take effect in all existing specs that
include this page, and also in the spec printout. These changes do not take effect in
specs saved as files. For example, if you change thickness of a specific line on a
page, and then save the page to the database, the software updates the line display in
all specs based on the form containing this page.
Related Topics
• Add a Select List in a PSR File, page 740
• Add a Unit of Measure Drop-Down Data Window in a PSR File, page 739
• Customizing Pages Common Tasks, page 726

Managing Spec Pages Common Tasks

These tasks deal with managing spec pages using the options available in the
Specifications module of SmartPlant Instrumentation. These tasks include opening
and saving spec pages, regeneration, process function selection, large note page
creation, and so forth.
Open a Page
Use this procedure to open a spec page in the Page Editor. You can open one page at
a time. For more information, see Open a Page, page 708.
Open a Page from an External File

Use this procedure to open in the Page Editor a spec page from a .psr file. For more
information, see Open a Page from an External File, page 708.
Display Data Field Names

Use this procedure to display the names of the data fields that a particular page
contains. For more information, see Display Data Field Names, page 709.
Display a List of Forms that Include the Current Page

You can use this procedure to check whether there are any spec forms that already
include a specific page that you open in the Page Editor. If you make any changes in
this page and save it, the software automatically updates all the forms that include this
page. For more information, see Display a List of Forms that Include the Current
Page, page 709.
Regenerate Pages
This procedure enables you to correct discrepancies that can occur on a page, and to
influence the display of various tables and table columns in the Table Column List
pop-up window in the Page Editor. When you implement this procedure, SmartPlant
Instrumentation automatically eliminates duplicate data fields on the current page and
updates the definition of the data fields included in the current page according to their
current table column definitions in the database. For more information, see
Regenerate Pages, page 709.
Save a Page to the Database

Use this procedure to save a page to the SmartPlant Instrumentation database. You
can save to the database any page, whether this is a page you open from an external
file, or a library page you modified. For more information, see Save a Page to the
Database, page 710.

Save a Page as an External File

Use this procedure if you need to save a page as an external file so that it can be used
with a third-party application, such as InfoMaker. You can save a page either as a
.psr (PowerSoft Report) file or a .wmf (Windows METAFILE) graphic. For more
information, see Save a Page as an External File, page 710.
Delete a Page
Use this procedure to delete a specific spec page that are not associated with forms,
that is, a page you opened from a file, or a new page that you created on the basis of
an existing page. Also, you can delete a page that was previously associated with a
library form but you decided to retain this page after deleting the form. After deleting
such a page, you can restore is automatically when restoring the library form that is
based on this page. If you want delete a page you saved to the database from an
external file, we recommend that you first save this page as a file. After deleting such
a page, you can restore it by opening it from the external file. For more information,
see Delete a Page, page 711.
Create a Large Note Page

Use this procedure to create a large note page on the basis of any existing page. A
large note page is a page that consists of a text area and a title block. A large note can
appear on a separate page. To create a large note on a separate page, you must use
only the spec_note_large column of the add_spec9 table. When creating or
modifying a specification form, you can add a large note page to display large note
text in the appropriate specifications.
SmartPlant Instrumentation provides a default page, Large Note, which you can add
to the required specification forms. The default large note page does not contain any
data apart from the title block. When adding a new page to a designated specification
form, you can use either the default Large Note page or create a new large note page
on the basis of any existing page.
In a print preview for a specification that contains a large note, the software displays a
large note on a separate page in which you can scroll up and down to view the note
text. When printing a specification with a large note page, the software automatically
counts the total number of sheets and divides the large note page into separate sheets,
depending on the note text length. For more information, see Create a Large Note
Page, page 712.
Select a Different Process Function for a Page

You can select a different process function for an existing page. In this way you can
use the same page for instrument tags with different process function types. You
cannot change the process function of a page that is already in use in specs. For more
information, see Select a Different Process Function for a Page, page 714.

Set the Tab Order of the Fields on a Page

You can set the sequence in which you move the cursor in the page you are editing.
This way you determine which fields the cursor moves to when you press the Tab
key. For more information, see Set the Tab Order of the Fields on a Page, page 715.
Switch to the Default Tab Order

You can switch from the tab order in the page you are currently editing to the default
tab order. This procedure is necessary if you imported a spec page you edited in
InfoMaker and this pace contains fields added in InfoMaker. After you set the tab
order of the fields on such a page, the fields added in InfoMaker are not editable
because the zero tab order number is assigned to them. Switching to the default tab
order enables you to remove the zeroes automatically and assign sequence numbers
for editing the fields. For more information, see Switch to the Default Tab Order,
page 715.
Retrieve Custom Pages as PSR Files

Use this procedure to retrieve one or more custom pages from the database as .psr
files. In the target folder that you specify, the software saves each page as a separate
.psr file with the name PAGE<page ID number>.psr. You can use this procedure if
you need to back up pages before editing them in the Page Editor, or if you need to
share pages with users outside of a given SmartPlant Instrumentation network. For
more information, see Retrieve Custom Pages as PSR Files, page 716.
Related Topics
• Open a Spec Page in InfoMaker, page 729
• Specification Pages: An Overview, page 694

Open a Page
1. In the Specifications Module window, do one of the following to open the Page
Editor:
• Click Edit > Page Editor.
• On the menu bar, click Actions > Open Page.
3. On the Select Specification Page dialog box, select a page.
Tips
• On the Select Specification Page dialog box, selected Custom check
boxes indicate pages that you have customized.
• You can click Properties to change the name and description of the
page you want to open.
4. Click OK to open the page in the Page Editor.
Related Topics
Open a Page from an External File

Editor:
• Click Actions > Open File.
3. Click Actions > Change Process Function.
4. On the Open File dialog box, navigate to the folder where your .psr file is located
and select the file.
5. Click OK to open the page in the Page Editor.
Related Topics

Display Data Field Names

1. Open a spec page in the Page Editor.
2. Do one of the following to display the Edit Fields and Headers floating toolbar:
• Click Actions > Edit Fields and Headers.
• On the Page Editor toolbar, click .
3. On the Edit Fields and Headers toolbar, click to display in the Field
Selection area all the field names which are used in the currently open page.
4. Click again to hide the display of the field names.
Related Topics
Display a List of Forms that Include the Current Page

1. In the Specifications Module window, do one of the following:
2. On the Page Editor menu bar, click Actions > Form List.
Related Topics
Regenerate Pages
2. On the menu bar, click Actions > Regenerate Page.
3. On the Regenerate Page dialog box, under Select tables and views, select a
check box for each table or view from which you want to display additional
columns in the Table Column List pop-up window.
4. Under Show Columns, click Show for each required table or view.
5. Under Select columns, select all or specific columns that you want to display in
the Table Column List pop-up window.
6. Click OK.
Related Topics

Save a Page to the Database

2. To save the page to the database under a new name, or to save a page opened
from an external file, click Actions > Save as Page.
3. On the Save as Page dialog box, click New.
4. On a dialog box that opens, type a unique name and an optional description, and
then click OK.
Tips
• Clicking Actions > Save also saves the page to the database (under the
same name as the currently open page). You cannot use the Actions >
Save option to save a page opened from an external file.
• After you save a library page whose data fields you modified, it is
considered a custom page.
Related Topics
Save a Page as an External File

• Click Actions > Save as File.
3. On the Save As dialog box, navigate to the required folder and type the target file
name.
Tip
• You can save the page as a .psr (PowerSoft Report) file or a .wmf
(Windows METAFILE) graphic.
4. Click OK to save the file.
Related Topics

Delete a Page
1. On the Page Editor menu bar, click Actions > Delete Page.
2. On the Select Specification Page dialog box, select the page you want to delete
and click OK.
Tips
• In the Page Editor, you can only delete a specific page, provided that
it is not in use in a spec form. If you want to delete all pages included
in a particular form, you need to delete the entire form. If this form is
a library form, you can restore the deleted pages automatically when
restoring this form. Note, however, that when restoring the form, the
software only restores the library pages, not pages you opened from an
external file and then included in this form.
Related Topics
• Delete a Form, page 751
• Restore Library Forms, page 752

Create a Large Note Page

Note
• Creating a large note page by starting with a page that contains field
values can be time-consuming. On a data page, you will have to delete all
the field values one by one. Therefore, we recommend that you use the
default page Large Note in the specification forms. The default large note
page does not contain any data apart from the title block. Also, if needed,
you can create a large note page in InfoMaker, and then open the page
from appropriate external .psr file in the Page Editor.
Editor:
• On the menu bar, click Actions > Open Page.
Tip
• We recommend that you use a page with the General process function.
You need to perform a separate procedure to change the page process
function to General. For details, see Select a Different Process
Function for a Page, page 714.
• On the menu bar, click Actions > Regenerate Page.
4. On the Regenerate Page dialog box, under Select tables, views, and columns,
select the check box for the add_spec9 table.
5. In the cell adjacent to the add_spec9 table cell, click Columns to display the
spec_note_large column in the Column Name data window.
6. Click OK to regenerate the page.

Important
• Before adding the spec_note_large column to the current page as a
data field, make sure that the page does not contain any other data
fields apart from the title block. If the page is not empty, you must
delete all of the data fields. For details, see Delete Data Fields, page
737.
8. On the Edit Fields and Headers floating toolbar, click .
9. In the Table Column List pop-up window, select spec_note_large.
10. Drag the spec_note_large column from the Table Column List pop-up window
and drop it anywhere on the page.
11. Click to close the Table Column List pop-up window.
12. For your convenience, if needed, resize the spec_note_large data field as follows:
a. Point to the spec_note_large field border so that the cursor changes to a
double-headed arrow.
b. Resize the spec_note_large field by dragging the field borders to either side so
that the field occupies the entire page area, apart from the title block
Tip
• You do not have to resize the spec_note_large data field exactly.
When printing a form that with a large note page the software resizes
the spec_note_large data field automatically so that the
spec_note_large data field occupies the entire area of the printed
specifications.
13. On the Actions menu, click Edit Fields and Headers to close the floating
toolbar.
14. Save the large note page to the database.
Note
• If required, you can use the spec_note_large field on a data page. By
default, a data page in SmartPlant Instrumentation is the first page in a
specification form and contains various field values.
Related Topics
• Regenerate Pages, page 709
• Save a Page to the Database, page 710

Select a Different Process Function for a Page

2. Click Actions > Change Process Function.
3. Select the target process function and click OK.
Tips
• You cannot change the process function of a page that is already in use
in specs. In this case you are prompted to save the page under a
different name.
• When changing the page process function, the software automatically
eliminates duplicate data field names in the current page, and also
updates the definition of the data fields included in the current page
according to their current table column definition in the database.
• Changing the page process function may prompt a warning, preceded
by SQL command error messages. These messages inform you that
the page for which you are changing the process function contains
undefined values, for example, specification custom fields.
• The data fields that caused SQL statement errors are not available in
the page after the process function change takes effect.
4. On the Regenerate Page dialog box, select a check box for each table or view
from which you want to change the display of table columns in the Table
Column List pop-up window.
Tip
• When you changed the process function, the software automatically
updated the table columns available to you in the Table Column List
pop-up window.
5. Under Show Columns, click Show for each required table or view.
6. Under Select columns, select all or specific columns that you want to display in
the Table Column List pop-up window.
7. Click OK.
Related Topics

Set the Tab Order of the Fields on a Page

2. Click Actions > Tab Order to display the tab numbers on the page.
3. Set the field order by typing in sequence numbers (20, 30, 40, and so forth) in the
fields that you want to sequence.
Tips
• Assigning a zero (0) to a field means that this field becomes non-
editable in a generated spec. Some fields are read-only by default and
not available for editing even if you assign a tab sequence to them.
• The zero number applies to all fields you added in the page using
InfoMaker. Therefore, in a spec page containing fields added in
InfoMaker, after defining the tab order, you must switch to the default
tab order. For details, see Switch to the Default Tab Order, page 715.
4. When done, click Actions > Tab Order once again, to clear the tab number
display.
Related Topics
Switch to the Default Tab Order

Caution
• This action overwrites the tab order in the currently open page with the
default tab order. After performing this procedure and saving the page, it
is not possible to revert to the original tab order.
1. With the specification page open for editing, click Actions > Tab Order to
display the tab numbers on the page according to the current tab order.
2. Click Actions > Default Tab Order.
3. Click Actions > Tab Order to clear the tab number display.
4. Save the spec page.
Related Topics

Retrieve Custom Pages as PSR Files

1. On the Specifications Module window menu bar, click Actions > Retrieve
Custom Pages as PSR Files.
2. Select one or more custom pages.
3. Under Target folder, accept the displayed folder path, or click Browse do specify
a target folder for saving the selected custom pages as .psr files.
Tip
The path displayed in the Target folder box is the path set for the PSR
working folder option on the Specifications > General page of the
Preferences dialog box.
4. Click OK.
Related Topics

Working with Page Graphics Common Tasks

These tasks deal with adding graphic objects in a spec page and modifying their
properties. These graphic objects include data fields, text boxes, computed fields,
grid lines, and so forth.
Add a Line to a Page

Use this procedure to add a graphic line to a specification page. For more
information, see Add a Line to a Page, page 718.
Modify Line Position and Length Using Arrow Keys

Use this procedure to modify the position and length of a single line on a page using
the arrow keys on the keyboard. For more information, see Modify Line Position and
Length Using Arrow Keys, page 719.
Modify Line Position and Length Using the Mouse

Use this procedure to modify the position and length of a single line on a page using
the mouse. For more information, see Modify Line Position and Length Using the
Mouse, page 720.
Set Precise Position and Length of a Line

Use this procedure to set the X and Y coordinates of a single line. For more
information, see Set Precise Position and Length of a Line, page 719.
Change Line Properties

Use this procedure to change color, style, and thickness properties of a single line you
select in a spec page. For more information, see Change Line Properties, page 721.
Duplicate Page Lines

This procedure enables you to duplicate a graphic line on a page. For more
information, see Duplicate Page Lines, page 722.
Add Graphics to a Page

Use this procedure to add graphic images to your specification pages. The graphic
files that you include in your pages must be in .bmp format. For more information,
see Add Graphics to a Page, page 723.
Set Precise Position and Size of Page Objects

Use this procedure to set the X and Y coordinates of a page object. You can set
precise size and position of data fields, text boxes, computed fields, and graphic
elements, for example, lines. For more information, see Set Precise Position and Size
of Page Objects, page 724.

Modify Position and Size of Page Objects Using Arrow Keys

Use this procedure to modify the position and size of a page object using the arrow
keys on the keyboard. You can modify size and position of data fields, text boxes,
computed fields, and graphic elements, for example, lines. For more information, see
Modify Position and Size of Page Objects Using Arrow Keys, page 725.
Modify Position and Size of Page Objects Using the Mouse

Use this procedure to modify the position and size of a page object using the mouse.
You can modify size and position of data fields, text boxes, computed fields, and
graphic elements, for example, lines. For more information, see Modify Position and
Size of Page Objects Using the Mouse, page 725.
Related Topics
Add a Line to a Page

3. On the Edit Fields and Headers toolbar, click .
4. In the Page Editor working area, do one of the following:
• For a horizontal line, click the location of the left end of the line that
you want to create.
• To prepare for a vertical line, click to the left of the location.
5. On the Line dialog box, under Line ID, accept the default ID or type a different
unique line ID number.
6. Accept the displayed line end coordinates or enter new coordinates as you require.
7. Under Line color, select the color that you need.
8. Under Line style, select the line display style that you need.
9. Under Line thickness, type the new value or use the spinners to set a value using
PowerBuilder units from one to five.
10. Click OK to display the new line on the page (the software displays small white
dots at the ends of the line that you just created).
Related Topics
• Working with Page Graphics Common Tasks, page 717

Set Precise Position and Length of a Line

3. In the Page Editor working area, double-click a line to open the Line dialog box.
4. Under Line end coordinates, enter type the appropriate values or use the
spinners.
Tip
• You enter the X and Y values using PowerBuilder units.
5. Click OK.
Related Topics
• Change Line Properties, page 721
• Modify Line Position and Length Using Arrow Keys, page 719
• Modify Line Position and Length Using the Mouse, page 720
Modify Line Position and Length Using Arrow Keys

2. In the Page Editor working area, click the line that you want to modify.
Tip
• The software displays small white dots at the ends of the line that you
select.
3. Using the keyboard arrows, move the line until you place it correctly.
4. Size the line as follows:
• To make the line shorter, press Shift + Left Arrow.
• To make the line longer, press Shift + Right Arrow.
• To change the line position from horizontal to diagonal or vertical,
press Shift + Up Arrow until you position the line correctly.
Related Topics
• Modify Line Position and Length Using the Mouse, page 720
• Set Precise Position and Length of a Line, page 719

Modify Line Position and Length Using the Mouse

3. In the Page Editor working area, select a line.
Tip
selected.
• To move the line, place the cursor over a line end so that the cursor
changes to cross-hairs, and then drag this end to a new location. The
other end of the line remains anchored.
• To move the line from one location to another, without changing
orientation or length, drag the line from the middle.
Related Topics
• Modify Line Position and Length Using Arrow Keys, page 719

Change Line Properties

4. In the Page Editor working area, click the line whose properties you want to
change.
Tip
selected.
5. Double-click the selected line to open the Line dialog box.
6. Under Line ID, accept or modify the line ID as you require.
Tip
• You need to define the line ID if you intend to save the current page in
.psr format and then customize it in InfoMaker. The line ID must be
unique.
7. Under Line color, select the color that you need.
8. Under Line style, select the option that you need.
9. Under Line thickness, type the new value or use the spinners to set a value using
PowerBuilder units from one to five.
10. Click OK to update the line properties on the page.
Related Topics

Duplicate Page Lines

4. In the Page Editor working area, click the line that you want to duplicate.
Tip
selected.
Tip
• The software displays the duplicated field a bit lower and towards the
right of the original line.
6. Select the duplicate line, and drag it to the location that you need.
Related Topics

Add Graphics to a Page

4. In the Page Editor working area, do one of the following:
• Click a free area of the page.
• Click a specific location on the page where you want to insert the
graphic.
5. On the Picture dialog box that opens, under Picture ID, accept the default value
or type a different unique picture ID number.
6. Under File name, do one of the following:
• Type the path and name of the .bmp file that you want to use for the
picture.
• Click and navigate to the .bmp file that you want to insert.
Tip
• You can only insert graphic files with the .bmp extension.
7. Click OK.
8. To move the graphic within the page, click on the graphic and do one of the
following:
• Use the arrow keys.
• Drag the graphic using the cursor.
9. To resize the selected graphic, do the following:
a. Move the cursor to the edge or to the corner that you want to resize, until a
two-headed arrow appears.
b. Drag the corner or the edge of the graphic to its new location.
10. To delete the selected graphic, on the Edit Fields and Headers toolbar, click .
11. When you are satisfied with the appearance of the graphic, on the Actions menu,
click Edit Fields and Headers to close this toolbar.

12. On the Actions menu, click the Save option that you require.
Tip
• You can save the page under the current or different name, or as an
external file. For more details, see Save a Page to the Database, page
710, and Save a Page as an External File, page 710.
Related Topics
Set Precise Position and Size of Page Objects

3. In the Page Editor working area, click the object whose X and Y coordinates you
want to set.
6. In the Field or Header Position pop-up window, enter the X and Y values as you
require.
Tip
• The X and Y values are PowerBuilder unit coordinates of the upper
left corner of the object.
7. In the Width and Height boxes, enter the appropriate values.
Related Topics
• Modify Position and Size of Page Objects Using Arrow Keys, page 725
• Modify Position and Size of Page Objects Using the Mouse, page 725

Modify Position and Size of Page Objects Using the Mouse

3. In the Page Editor working area, click the object whose X and Y coordinates you
want to set.
4. To move the object, place the cursor in the center of the object so that the cursor
changes to cross-hairs, and then drag the object to its new location.
5. To resize the object, place the cursor in an object edge or corner so that the cursor
changes to a double-headed resize arrow, and then drag the edge or corner to its
new location.
Related Topics
• Modify Position and Size of Page Objects Using Arrow Keys, page 725
• Set Precise Position and Size of Page Objects, page 724
Modify Position and Size of Page Objects Using Arrow Keys

2. In the Page Editor working area, click the object that you want to modify.
3. Using the keyboard arrows, move the page object until the upper left corner is
correctly placed.
4. Size the object as follows:
• To make the object narrower, press Shift + Left Arrow.
• To make the object wider, press Shift + Right Arrow.
• To make the object shorter, press Shift + Up Arrow.
• To make the object taller, press Shirt + Down Arrow.
Related Topics
• Modify Position and Size of Page Objects Using the Mouse, page 725
• Set Precise Position and Size of Page Objects, page 724

Customizing Pages Common Tasks

These tasks deal with customizing the display of the data fields and their headers
using SmartPlant Instrumentation or InfoMaker. Also, specific procedures in this set
of tasks enable you to assign drop-down data windows and select lists to spec page
fields. Note that on a spec page, you cannot select more than one field or header at a
time for customization.
Open a Spec Page in InfoMaker

Some customization procedures require that you InfoMaker. This procedure allows
you to open a spec page in InfoMaker. For more information, see Open a Spec Page
in InfoMaker, page 729.
Edit Field Headers

Use this procedure to modify the text that appears in the field headers. You can
change the text itself, change the font characteristics: bold or not bold, italic, rotated
(determine angle), text box size, text alignment, text color, and background color.
For more information, see Edit Field Headers, page 730.
Display Invisible Fields

This procedure enables you to display fields whose table column status in the
database is set as invisible. You can then modify these table columns using a
PowerSoft editor, such as InfoMaker. For more information, see Display Invisible
Fields, page 731.
Define Fields with Computed Values

This procedure allows you to define and modify an InfoMaker eligible expression for
a data field in the current form. Such an expression is referred to as a computed
value. The field containing such an expression is referred to as a computed field. For
more information, see Define Fields with Computed Values, page 731.
Display Revision Changes for Spec Properties

When you create a new revision for a specification sheet, you can show the revision
number next to properties for which the values were changed at the last revision. To
do this, you add a computed field for the property for which you want to indicate the
change. For more information, see Display Revision Changes for Spec Properties,
page 733.

Format Field Values

Use this procedure to format values of data fields. The format that you set for the
data field names is used by SmartPlant Instrumentation to display the field values in
the specs based on a form containing this page. To differentiate among various data
fields, you set left, center or right alignment, set font style and size, and set
combinations of text and background colors. For more information, see Format Field
Values, page 734.
Add Data Fields to a Page

Use this procedure to add data fields to a specification page that you open in the Page
Editor. The fields that you can add belong to one of the following types:
• Standard (non-custom) fields appropriate to the process function of the

open page (displayed by default in the Table Column List pop-up
window)
• Process data custom fields (displayed in the Table Column List pop-up
window after you regenerate the page)
• Specification custom fields (some displayed by default in the Table
Column List pop-up window, with option to select additional fields from
the Regenerate Page dialog box)
• Standard fields available for all process functions (displayed on the
Regenerate Page dialog box, with option to select additional fields for
display in the Table Column List pop-up window)
For more information, see Add Data Fields to a Page, page 734.
Associate User-Defined Views

This option enables you to associate a SmartPlant Instrumentation database view that
you created in an external application such as InfoMaker. After associating an
appropriate database view, you can use the data it contains in specifications. When
creating a user-defined database view, you can include in this view any combination
of SmartPlant Instrumentation table columns, with each column belonging to a
different SmartPlant Instrumentation table. Using database views, you can retrieve
data from the required tables and display this data in specification documents. For
example, a certain instrument is assembled on a line. You use your database view to
automatically retrieve data related to that line, for example, line process data, pipe
related material, and so forth. For more information, see Associate User-Defined
Views, page 735.
Duplicate Data Fields in a Page

This procedure enables you to duplicate a data field in a spec page. This way you
need enter data only once for several identical fields in a page. For more information,
see Duplicate Data Fields in a Page, page 736.

Delete Data Fields

Use this procedure to delete an existing data field from a particular page. You can
delete one data field at a time. Data fields that you delete reappear in the Table
Column List pop-up window. For more information, see Delete Data Fields, page
737.
Add Custom Fields of Wiring Equipment Items

This procedure allows you to add custom fields of wiring equipment items in a spec
page. Custom fields of wiring equipment items appear in the table APPARATUS.
You can use up to 30 fields in a specification. The custom fields in the
APPARATUS table are designated by column names from APPAR_UDF_C01 to
APPAR_UDF_C30. The custom fields that you add in a specification page hold
view-only values in an item specification that you create using this page as a source.
Each custom field holds a user-defined property value of a customized wiring
equipment category. For more information, see Add Custom Fields of Wiring
Equipment Items, page 737.
Add Function Block Custom Fields to a Fieldbus Spec

Use this procedure to add function blocks in spec pages of the forms that you can use
as a basis for fieldbus spec generation. Three specification forms are available for
fieldbus data: form 72 for instrument with the General process function, 73 for flow
instruments, and 74 for pressure instruments. These forms contain a fieldbus page
that includes data for shipped function blocks. In addition to these function blocks,
you can create your own function blocks and add data for them to the form page.
Before adding custom function blocks in the specification page, you have to define
them in the Instrument Index module. The order in which you define them
determines the sequence number that they are mapped to when dragging the table
columns onto the specification page. The shipped function blocks correspond to
sequence numbers 1 to 21. Sequence numbers 22 to 40 are available for custom
function block parameters. For more information, see Add Function Block Custom
Fields to a Fieldbus Spec, page 738.
Add a Unit of Measure Drop-Down Data Window in a PSR File

Use this procedure in InfoMaker to assign a unit of measure drop-down data window
to a custom field or a spec page saved as a .psr file. You can use this procedure as an
example if you want to assign any drop-down data window to a data field. All the
drop-down data windows appear in the shipped library file sp_style.pbl, which resides
in your SmartPlant Instrumentation home folder. After you open the .psr file in
SmartPlant Instrumentation, save it as a new page and associate with a spec form, all
specs based of this form are generated with the drop-down data window that you
added. For more information, see Add a Unit of Measure Drop-Down Data Window
in a PSR File, page 739.

Add a Select List in a PSR File

Use this procedure in InfoMaker to create a select list and assign it to a custom field
or a spec page saved as a .psr file. After you open the .psr file in SmartPlant
Instrumentation, save it as a new page and associate with a spec form, all specs based
of this form are generated with the select list that you added. For more information,
see Add a Select List in a PSR File, page 740.
Related Topics
• Guidelines for Customizing Pages for Save as Excel, page 834
Open a Spec Page in InfoMaker

• On the Page Editor menu bar, click Actions > Save as File.
3. On the Save As dialog box, navigate to the required folder and type the file name
of the target .psr file.
4. Click OK to save the file.
5. In InfoMaker, on the menu bar, click File > New.
6. On the New dialog box, select Grid.
7. In the Grid Report Generator wizard, select SQL Select and click Next.
8. On the Select Tables dialog box, select any table and click Open.
9. Under Selection list, click any table column.
10. On the menu bar, click File > Return to DataWindow Painter.
11. In the Grid Report Generator wizard, click Next and then Finish.
12. On the menu bar, click File > Open File.
13. When prompted to save changes to (Untitled), click No.
14. On the Select a File Name dialog box, select the .psr file and click Open.
Related Topics

Edit Field Headers

3. In the Page Editor working area, double-click a field header to open the Edit
Text dialog box.
4. On the Edit Text dialog box, do the following:
a. In the Name box, edit the field header text.
b. Select the text alignment option within the field text box.
c. Select Transparent if you want to display the current Windows background
color in the text box, or clear Transparent and then select the background
color that you need.
d. From the Text color list, select the text color that you need.
e. Under Font style, select Bold or Italic.
f. From the Rotate list, select an angle to rotate the text inside the text box.
Tip
• If you want to display an ampersand character & in the field header
text, in the Name box, enter &&. For example, to display the P&ID
header on the spec page, in the Name box, type P&&ID.
5. Click OK.
Related Topics

Display Invisible Fields

3. On the Edit Fields and Headers toolbar, click to display the invisible data
fields of the current page.
Tip
• If several data fields are positioned at the same spot (one on top of the
other), you can only see the top data field. You can display the data
fields underneath the top field simply by moving the fields aside.
Related Topics
Define Fields with Computed Values

You can enter any of the following data types, provided that they comply with the
conventions used in InfoMaker:
Data Type Example

Number 2210
String of characters 'AA' or "AA"
Field name cmpnt_name
Function upper(cmpnt_name)
Conditional if expression (pd_fluid_phase='S','Steam','Water')
1. Open a page in the Page Editor.


3. With the Edit Fields and Headers toolbar displayed, do one of the following to
open the Computed Field dialog box:
• On the Edit Fields and Headers toolbar, click and then click a
field in the Page Editor.
• In the Page Editor, select and double-click a field to open the
Computed Field dialog box showing the current computed value of
that field.
4. In the Name box, do one of the following:
• Type a new name to add a field with this name to the current page
• Type a field name which already exists in the current page or leave the
current value if you selected this field in the current page.
5. In the Expression box, type a value, function, or any other appropriate
expression.
6. Click Verify to verify that the expression you entered is a valid InfoMaker
expression.
7. Click OK.
Notes
• If you make changes to a field in the currently opened page, the software
displays the computed results automatically, using the settings you entered
on the Computed Field.
• See your InfoMaker User Guide for additional information about the data
types you can use as valid expressions for this procedure.
Related Topics

Display Revision Changes for Spec Properties

1. Open a page in the Page Editor.
3. On the Edit Fields and Headers toolbar, click and then click the page at the
position where you want to place the computed field.
4. On the Computed Field dialog box, type a name for the computed field.
5. In the Expression box, type the following expression:
f_changevalue(cmpnt_id,rev_id,dwg_id,"<field name>")
Tip
• For example, to show changes for the maximum pressure, the
expression is written as follows:
f_changevalue(cmpnt_id,rev_id,dwg_id,"pd_press_max")
6. Click Verify to verify that the expression you entered is a valid InfoMaker
expression.
7. Click OK.
8. To show the change in the specification, do the following:
a. Modify an existing value of a property for which you added a computed field
to display changes for the last revision.
b. Close the specification sheet and re-open it the following day.
c. Add a revision to the specification sheet and refresh the display.
Tips
• The indication appears only after the day advances on your computer's
clock.
• The indication appears only for existing values that were changed at
the last revision. If you enter a new value for a property that
previously did not have a value, no change is indicated.
Related Topics

Format Field Values

3. On the Edit Fields and Headers toolbar, click to display the data field names
in the page.
4. In the page, double-click a field name to open the Edit Field dialog box.
5. Under Alignment, accept the default alignment (left), or select the appropriate
alignment option.
6. Under Font style, select the font style (the available styles are bold and italic).
7. Under Font size, enter a font size between 3 and 24.
8. Select Transparent if you want to display the current Windows background color
in the text box, or clear Transparent and then select the background color that
you need.
9. Click OK.
Related Topics
Add Data Fields to a Page

2. On the menu bar, click Actions > Regenerate Page.
3. On the Regenerate Page dialog box, under Select tables and views, select a
check box for each table or view whose columns you want to display table in the
Table Column List pop-up window, from which you can then add data fields to
your page.
Tip
• If you want to add a user-defined view to a spec page, you must first
add this view in the Specification Views dialog box. For details, see
Associate User-Defined Views, page 735.
4. Under Show columns, click Show for each required table or view.
5. Under Select columns, select all or specific table columns that you want to
display in the Table Column List pop-up window.
6. Click OK to return to the Page Editor.
7. On the menu bar, click Actions > Edit Fields and Headers.

8. On the Edit Fields and Headers toolbar, click to open the Table Column
List pop-up window.
9. From the Table Column List pop-up window, drag table columns to the
appropriate location on the page.
• To save the page under the current name, on the menu bar, click
Actions > Save.
• To save the page under a different name, on the menu bar, click
Actions > Save as Page.
Related Topics
Associate User-Defined Views

Important
• Before using this procedure, make backups of all your user-defined views.
When upgrading your SmartPlant Instrumentation version, note that in the
new version, some tables or columns might have been modified. If you
have upgraded your database after associating user-defined views, you
cannot use the views in which the table records do not match the new table
records of the new database. To enable the use of these views, you must
run a set of SQL statements to recreate the user-defined views.
1. On the Specifications Module window menu bar, click Actions > Specification
Views.
2. On the Specification Views dialog box, click New.
3. In the new row, type the appropriate view name.
Tip
• The name of the new view must be exactly the same as the name
defined in your external application (the name is not case-sensitive).
The software validates the name and checks whether the view
complies with the SmartPlant Instrumentation-specific conditions.

4. Under Item Type, from the list, select the item type you want to associate with
the current view.
Tip
• For a user-defined view, you can select an item type from a list. For
the default views, the item type is fixed. The displayed item type
indicates that you can only use the current view in a specific item
specification. For example, you can only use the default view
cable_type_view in a cable specification.
5. Click OK.
Note
• When associating a user-defined view with SmartPlant Instrumentation,
the system recognizes the view under the following conditions:
• The view must contain the CMPNT_ID column.
• The CMPNT_ID value must be unique.
• The number of rows in the created view must match the number of
rows in the COMPONENT table of SmartPlant Instrumentation. The
COMPONENT table contains the appropriate instrument tags that
must appear in the view.
Related Topics
Duplicate Data Fields in a Page

3. On the Edit Headers and Fields toolbar, click to display the data field names
in the page.
4. In the Page Editor working area, click the data field that you want to duplicate.
Tip
• The software displays the duplicated data field as superimposed on the
original field and skewed downwards to the right.
6. Drag the new field to the location that you need.
Related Topics

Delete Data Fields

3. With the Edit Fields and Headers toolbar displayed, in the page, click the data
field that you want to delete.
5. Repeat this procedure top delete another data field.
Related Topics
Add Custom Fields of Wiring Equipment Items

1. Create a wiring equipment item in the Reference Explorer.
2. In the Specifications module, restore a form associated with the Wiring
Equipment item type.
3. In the Page Editor, open a spec page based on the form that you restored.
4. Regenerate the page, and from the APPARATUS table, add the appropriate
APPAR_UDF columns as data fields in the page.
5. In the page, name the column headers to match the headers that you defined for
wiring equipment properties in the Wiring module.
Tips
• To display a list of headers, you need to open an external .psr file
WIRING_EQUIPMENT_UDF.PSR, which is located in the path
<SmartPlant Instrumentation home folder> \PSR. You can open the
file WIRING_EQUIPMENT_UDF.PSR using InfoMaker, or from the
Browser module.
• After adding custom fields in a spec page, you have to change the
column headers in the page so that they match the user-defined
property names in the Wiring Equipment Category Properties
dialog box, which you access for the Wiring module (with the Wiring
module main window open, click Tables > Wiring Equipment >
Categories).
Related Topics
• Regenerate Pages, page 709

Add Function Block Custom Fields to a Fieldbus Spec

1. In the Instrument Index module, create a new function block.
2. In the Specifications module, open the Page Editor.
3. On the Page Editor toolbar, click .
4. On the Select Specification Page dialog box, select Fieldbus Page.
6. On the Edit Fields and Headers floating toolbar, click to view the names of
the data field on the specification page.
7. On the Edit Fields and Headers floating toolbar, click .
8. In the Table Column List pop-up window, select a table column starting with the
string fb and containing a value between 22 and 40, for example, fb22_exists.
For each custom function block, the following column types are available:
• fb<number>_name — Displays the text string used for the function
block label as defined in the Function Blocks supporting table.
• fb<number>_count — Allows you to specify the number of function
blocks of the particular type that are used in the instrument if the
Multiple check box is selected in the Function Blocks dialog box.
• fb<number>_ex_time — Allows you to specify the execution time
for the function block type if the Execution time check box is selected
in the Function Blocks dialog box.
• fb<number>_exists — Displays a text box that you can select to
indicate that the function block is required for the instrument.
Tip
• The <number> value corresponds to the order in which you add
custom function blocks in the Function Blocks supporting table, and
not their alphabetic sequence.
9. Drag the table column value that you selected from the Table Column List pop-
up window to the desired location on the currently open page.
10. Drag other custom function block values onto the page as desired.
Related Topics

Add a Unit of Measure Drop-Down Data Window in a PSR

File
1. In InfoMaker, to define the sp_style.pbl library as your working library, do the
following:
a. On the menu bar, click Tools > Library Painter.
b. Right-click sp_style.pbl and then, on the shortcut menu, click Set as working
library.
Tip
• The sp_style.pbl file is a shipped library containing all drop-down data
windows of SmartPlant Instrumentation. The file resides in your
SmartPlant Instrumentation home folder.
2. Open the target spec page that you saved as a .psr file. For details, see Open a
Spec Page in InfoMaker, page 729.
3. In the Report window, right-click the target table column that is used as a custom
field in the spec page, and then, click Properties.
4. In the Properties window, click the Edit tab, and then, do the following:
a. From the Style Type list, select DropDownDW.
b. Select Always Show Arrow to display in the spec page an arrow box inside
the field to indicate that this field is assigned to a drop-down data window or
select list.
c. Select V ScrollBar to display a vertical scroll bar when the drop-down data
window contains a long list values.
d. Beside the DataWindow box, click .
e. On the Select Report dialog box, select a unit of measure drop-down data
window you want to assign to the field. For details about the available drop-
down data windows that retrieve units of measure, see Drop-Down Data
Windows Retrieving Units of Measure, page 741
f. From the Display Column list, select uom_code.
g. From the Data Column list, select uom_code.
5. Save the .psr file.
6. Test your drop-down data window assignment in SmartPlant Instrumentation,
open the .psr file in the Page Editor, save it as a new regenerated page, assign to
a spec form, and generate a spec based on this form.
Related Topics

Add a Select List in a PSR File

1. Open the target spec page that you saved as a .psr file. For details, see Open a
2. In the Report window, right-click the table column (spec page data field) to
which you want to assign a drop-down data window, and then, click Properties.
3. In the Properties window, click the Edit tab, and then, do the following:
a. From the Style Type list, select DropDownListBox.
b. Select Allow Editing if you want to be able to enter a text string instead of
selecting a list value when defining specification data in SmartPlant
Instrumentation. This does not affect the values on the list box itself.
c. Select Sorted to displays the values alpha-numerically in descending order
(values starting with a numeric character will be displayed at the top of the
select list).
d. Select Always Show Arrow to display in the spec page an arrow box inside
the field to indicate that this field is assigned to a select list or drop-down data
window.
e. Select V ScrollBar to display a vertical scroll bar when the select list is long.
f. Under Code Table, in the Display Value column, define unique values.
These values will appear in the select list in a generated spec.
g. In the Data Value column, define unique values to associate with the display
values. These values will appear in the database as the table column values.
Tip
• In the Limit box, decrease the displayed value if needed. This is
required to prevent value truncation in the spec. Value truncation can
occur if the data field width in the spec is smaller than the table
column length in the database.
4. Save the .psr file.
5. Test your select list definition in SmartPlant Instrumentation by opening the .psr
file in the Page Editor, saving it as a new regenerated page, assigning to a spec
form, and generating a spec based on this form.
Related Topics

Drop-Down Data Windows Retrieving Units of Measure

All drop-down data windows in SmartPlant Instrumentation reside in the sp_style.pbl
file, which is located in the SmartPlant Instrumentation home folder. The following
table lists and describes all drop-down data windows containing SQL Select
commands that retrieve units of measure from the SmartPlant Instrumentation
database.
Drop-Down Data Window Description

d_dddw_uom Retrieves all units of measure that exist in
SmartPlant Instrumentation
dw_uom_dn Retrieves density units of measure
dw_uom_fl Retrieves flow units of measure
dw_uom_ln Retrieves length units of measure
dw_uom_pr Retrieves pressure units of measure
dw_uom_tm Retrieves temperature units of measure
dw_uom_vs Retrieves viscosity units of measure
Related Topics

Spec Forms: An Overview

Forms serve the basis for creating specifications. Forms can consist of one or more
data pages and always contain a note page. A form must contain at least one data
page. You might design a form based on more than one page, for example, for a field
device that has both electrical and mechanical connections, requiring separate pages
for wiring connections and line-related fields. SmartPlant Instrumentation is
delivered with a library of predefined forms bearing the names of their default pages.
You can manage spec forms in the Specifications module, using the Form Editor
options. You can you change form properties, such as name, description, and
number, save a form either as a new form or as a spec page to fit your own
conventions.
After defining the form pages, you can create specs on the basis of this form. If you
want to generate a multi-tag spec containing a page where you can display values of
individual instruments, you must first create a multi-tag spec format on the basis on a
particular form. You can create other types of specs by assigning a SmartPlant
Instrumentation item directly to the number of the appropriate spec form. When you
assign a form to an item and generate a spec, the software creates the spec pages
according to the pages that the source form contains. You cannot modify the data
fields in the form itself, only in the form pages, which you can open in the Page
Editor.
It is possible to create multiple templates for a specific form and then, when
generating a spec, assign the item to the form data template rather than to the form.
You can then copy data from any other template based on the same form to the
current spec, and even copy data from the spec to any of these templates.
Related Topics
• Form Data Template Common Tasks, page 756

Spec Forms Common Tasks

You use the following tasks to manage you spec forms, restore library forms, add or
remove spec pages, and so forth.
Create a Form
Use this procedure to create a form comprising one spec page. You can only create
and manage spec forms in the Specifications module. For more information, see
Create a Form, page 745.
Edit Form Properties

Use this procedure to edit number, name and note defined for a spec form. After you
edit the form properties, the software automatically updates these properties in all the
specifications that are assigned to this form. For more information, see Edit Form
Properties, page 746.
Add Pages to an Existing Form

Use the following procedure to add pages to existing forms and create a multi-page
form that you can associate with an item. By adding pages to a form, you can achieve
greater flexibility and accuracy in specifications based on that form. For more
information, see Add Pages to an Existing Form, page 747.
Remove a Page from a Form

You can remove a page from an existing multi-page form. This procedure only
applies to the current form and does not remove the page from the list of pages
available as templates for other forms. If you need to permanently delete a particular
page, you can do so in the Page Editor. For more information, see Remove a Page
from a Form, page 748.
Sort Pages Within Forms

Use this procedure to open a specific form and sort the pages included in the form.
This way you set the print preview and print order of the pages in a spec that you
generate on the basis of this form. For more information, see Sort Pages Within
Forms, page 749.
Define Form Browser Fields

Use this procedure to define fields for a form browser you can add in the Browser
module based on the current form. The fields that you select in the Spec Data
Dictionary become available for inclusion in the browser view (in the Style settings
section of the Browser Manager). You can edit the field names only in the Spec
Data Dictionary. This procedure does not affect the on-screen display of
specifications based on a form that you edit in the Spec Data Dictionary, nor does it
influence printed specifications. For more information, see Define Form Browser
Fields, page 750.

Display a List of Pages Included in a Form

Use this procedure to open a form and display a list of spec pages that this form
includes. You might need to display a list of pages of you want to modify fields in a
specific form page (you cannot modify fields on the form itself). For more
information, see Display a List of Pages Included in a Form, page 751.
Delete a Form
This procedure enables you to delete a form that is not in use in any spec. You can
either delete the form together with all of the pages included in the form, or just the
form itself, and then delete the pages manually, from the Page Editor. If the form
that you are about to delete is a library form, you can restore this form at any stage,
together with the library pages. However, you cannot restore custom pages included
in the form. For more information, see Delete a Form, page 751.
Restore Library Forms

Use this procedure if you need to perform any of the following activities:
Activate a library form that is not available in the Select Specification Form
dialog box. After you restore a form, this form becomes available in the Select
Specification Form dialog box, and you can associate this form with items that
belong to a specific item type. You must restore all forms whose item type is not
Instrument if you want to create specifications using these forms. For example, to
create hook-up specifications, you must restore a form assigned to the Hook-Up
item type.
• Restore a library form after deleting it. You can only restore library forms
provided with SmartPlant Instrumentation. You can only restore a library
form that was saved as an .isf file.
For more information, see Restore Library Forms, page 752.
Regenerate Library Forms

You might need to use this procedure after you r System Administrator has initialized
a new domain from a source, or after upgrading your SmartPlant Instrumentation
database. Some form data may not be copied correctly to the target domain. For this
reason, it is recommended that you regenerate the library forms to avoid any
problems at a later stage. If you are using the workflow options in the Instrument
Specifications Browser, regeneration is essential after initialization or upgrade. For
more information, see Regenerate Library Forms, page 752.
Change Form Assignment for a Batch of Specs

Use this procedure to change the form assignment for a group of specs that share a
common form. The new form must have the same process function as the currently
assigned form, or belong to the General process function. For more information, see
Change Form Assignment for a Batch of Specs, page 754.

Change the Form Assignment of a Spec

Use this procedure to change the form assignment for a particular spec. The new
form must have the same process function as the currently assigned form. When the
spec item type is Instrument, you can also select a form whose process function is
defined as General. For more information, see Change the Form Assignment of a
Spec, page 753.
Related Topics
• Spec Forms: An Overview, page 742
Create a Form
• Click Edit > Form Editor.
2. In the Form Editor, click .
3. Select a page for the new form.
Tip
• A form must contain at least one page. You can add other pages in the
form after creating the form.
4. On the toolbar, click to save the form to the database.
Related Topics

Edit Form Properties

Note
• Before performing this procedure, make sure that you have close all
specifications that are assigned to the form whose properties you want to
edit.
2. In the Form Editor, do one of the following:
• Click Actions > Open Form.
• Click .
3. On the Select Specification Form dialog box, select the form whose properties
you want to edit.
4. Click Properties and modify the form number, name, or note as you require.
5. Click OK and then save the form.
Related Topics

Add Pages to an Existing Form

Note
• If you want to use large notes in a form, you need to add a large note page
to this form. Since it is possible to scroll the large note page area, you do
not need to add more than one large note page to a form. When printing
forms containing a large note page, the software divides the page into
separate sheets automatically, depending on the note text length.
• A form that contains a composite page cannot contain any other pages
because you can only include one composite page in a form.
1. In the Form Editor, do one of the following:
• On the menu bar, click Actions > Open Form.
2. On the Select Specification Form dialog box, select the form to which you want
to add pages, and click OK.
3. In the Form Editor, do one of the following to add a page:
• On the menu bar, click Actions > New Page.
4. On the Select Specification Page dialog box, select the page that you want to
include in the form.
Tips
• To edit the page name and description, click Properties and type the
required modifications.
• The process function of the form is determined by the pages in the
form. If the process function of all the pages within a form is General,
the form process function is also General. If an added page has a
different process function, the form process function changes to the
new page process function. In this case, adding a new page is
available only for pages with General or the same process function as
the form.
5. Click OK.
6. Sort the pages within the form as you require.


• To save the changes that you made, on the menu bar, click Actions >
Save.
• To save the form under a new name, on the menu bar, click Actions >
Save as Form.
Notes
• If you are building a form incorporating pages with identical custom field
names, (for example, Page 1 and Page 2) the following scenario can occur:
On Page 1, the spec_udf_c13 field value is A, whereas, on Page 2, the
value is B. When adding Page 2 to the form, the software changes the
spec_udf_c13 value to B on Page 1, according to the value on Page 2.
• In a multi-page form, you should use a given specification custom field
name on more than one page only for a field that you design for constancy
across all of the form pages.
Related Topics
• Create a Large Note Page, page 712
• Sort Pages Within Forms, page 749
Remove a Page from a Form

1. In the Form Editor, open a form that has more than one page.
2. Click a tab of a specific page.
• On the menu bar, click Actions > Remove Page.
• To save the form under the existing name, click Actions > Save.
• To save the form under a new name, click Actions > Save as Form.
Related Topics

Sort Pages Within Forms

1. In the Form Editor, open a form that has more than one page.
• On the menu bar, click Actions > Sort Pages.
3. Select a page and click Move Up or Move Down to change the page order within
the form.
4. Click OK to set the new page order and update the form.
Related Topics

Define Form Browser Fields

1. On the Specifications Module window menu bar, click Edit > Spec Data
Dictionary.
2. On the Select Specification Form dialog box, select a form and click OK.
3. On the toolbar, click .
4. To edit the headers for the form browser, if you need, do one of the following:
• On the Field Properties tab, change individual field headers by typing
a text string instead of the displayed header.
• Change field headers in batch mode using another form as a source.
To do so, click Copy From, and then, select a source form..
5. To apply existing headers of the current form, do the following:
a. In the form or on the Field Properties tab, under Header, move the cursor to
the field header.
b. After the cursor changes its shape to , click the header.

c. In the form, double-click the header to display it on the Field Properties tab.
Tips
• When you apply existing headers of the current form, in the form
display, the form fields are marked with the cyan background color.
The background color of the currently selected field, for which you are
editing the header, changes to magenta.
• The icon on the Field Properties tab points to the corresponding
field header, which is now available for editing.
6. To define the fields for the form browser, do one of the following:
• To make all of the fields from one or more tables available for the
form browser, click the Tables tab, and then, under Browser Fields,
click All for the tables that you require.
• To define individual fields, on the Field Properties tab, select the
appropriate check boxes in the Browser column.
7. On the toolbar, click to save the form browser field definitions.
Related Topics

Display a List of Pages Included in a Form

2. On the Form Editor menu bar, do one of the following:
• Click Actions > Page List to view the page list.
• Click Reports > Spec Pages per Form to generate an d print a report
of the form pages.
Related Topics
Delete a Form
1. On the Form Editor menu bar, click Actions > Delete Form.
Tips
• You can only delete a form that is not in use in any specs.
• You can delete one form at a time.
• If the form has pages, and it is not in use in any spec, you are
prompted to delete all of the form pages as well. If the form that you
are about to delete is a library form, you can restore this form at any
stage, together with the library pages. However, you cannot restore
custom pages included in the form. Therefore, before deleting the
form, we recommend that you save the appropriate pages as external
files. You can save pages as files in the Page Editor.
2. On the Select Specification Form dialog box, select the form you want to delete
and click OK.
Related Topics
• Delete a Page, page 711

Restore Library Forms

2. On the Form Editor menu bar, click Actions > Restore Form.
3. Select the form you want to restore and click OK.
Tip
• If the form with the same name you are restoring already exists, the
software displays the Restore Options dialog box, where you can
overwrite the existing form or recreate the library form as a new form.
Related Topics
• Regenerate Library Forms, page 752
Regenerate Library Forms

1. In the Specifications Module window, click Actions > Regenerate Library
Forms.
2. On the Regenerate Library Forms dialog box, click Run.
3. On completion of the process, click Close.
Related Topics

Change the Form Assignment of a Spec

1. In the Specifications module open a specification.
2. On the menu bar, click Actions > Change Spec Form.
3. Select the new form for your specification and click OK.
4. When prompted to change the form assignment and close the current spec, click
Yes, and then reopen the spec, which is now assigned to the new form.
Tips
• SmartPlant Instrumentation does not allow you to change the form
assignment of a spec assigned to a Specification Binder package,
unless you first remove the specification from the Specification Binder
package.
assignment of a multi-tag spec.
Related Topics

Change Form Assignment for a Batch of Specs

1. In the Specifications Module window, on the menu bar, click Actions > Change
Spec Form.
2. Under Search parameters, from the Current form list, select the form type of
the specifications that you want to change.
3. Click Find.
Tip
• Select Find typical tags only to limit your search to specifications of
typical tags.
• Select Find telecom tags only to limit your search to specifications of
telecom tags.
4. Under Search results, select the specifications for which you want to change the
form.
5. Under Change parameters, from the New form box, select the new form type,
and click Apply.
Tips
• In the New form box, the software displays forms of the same process
function as the current form. When the spec item type is Instrument,
the software also displays forms whose process function is defined as
General.
• Specifications for which forms were successfully changed no longer
appear among the search results.
• The software does not allow you to change the form assignment of an
instrument specification assigned to a Specification Binder package,
unless you first remove the specification from the Specification Binder
package.
assignment of multi-tag specs.
6. Repeat the procedure for other specification forms if required, or click Close to
return to the Specifications Module window.
Related Topics

Form Data Templates: An Overview

Form data template allows you to store data that you can copy to existing specs.
Using a form data template eliminates the need to repeat data entry for similar specs.
Also, you can set the software to copy data from a template when generating a new
instrument spec. This is possible after you assign an existing form data template to
the profile of a specific instrument type. You manage form data templates only in the
Specifications module, in the Form Data Template Editor.
You base form data templates on a specific spec form. You can create multiple
templates for each form. The form data template name does not have to be unique
and can contain up to 50 alpha-numeric characters. After generating a spec based on
the form for which you defined data templates, you can select a template and copy its
data to the spec. Also, you can copy data to a form data template from a spec based
on the same form.
Related Topics
• Copy Data to a Form Data Template from a Spec, page 810
• Copy Data to a Spec from a Form Data Template, page 812

Form Data Template Common Tasks

You use the following tasks to manage you form data templates .
Create and Modify a Form Data Template

Use this procedure to create and modify form data templates, from which you can
copy a batch of data to your new or existing specifications. For more information,
see Create and Modify a Form Data Template, page 756.
Delete a Form Data Template

Use this procedure to delete one or more form data templates if they are no longer
required as data sources for specs. For more information, see Delete a Form Data
Template, page 758.
Related Topics
• Copy Data to a Form Data Template from a Spec, page 810
• Copy Data to a Spec from a Form Data Template, page 812
• Form Data Templates: An Overview, page 755
Create and Modify a Form Data Template

1. With the Specifications Module window open, click Edit > Form Data
Template Editor.
2. On the Select Specification Form dialog box, select the form for which you want
to create or modify a form data template, and then click OK.
3. On the Select Form Data Template dialog box, do one of the following:
• If this is the first form data template for the current form, type a
meaningful name instead of UNDEFINED.
• To add an additional form data template for the current form, click
New and type a name.
• To modify an existing form data template, select the template from the
list.
4. Click OK to open the template in the Form Data Template Editor.

5. Do one of the following to enter data in the form template:

• Enter data manually in the fields that are available for editing.
• Copy data from a spec based on the same form as your form data
template. For details, see Copy Data to a Form Data Template from a
Spec, page 810.
Tip
• If the form data template has fields that are not accessible, these fields
are protected in the Spec Data Dictionary. You cannot enter values
in protected fields. When copying data, the software ignores protected
fields. For details, see Protect Fields from Overwriting When Copying
Data, page 810.
6. On the toolbar, click to save the changes.
7. If needed, on the toolbar, click to define and open another form data template
in the Form Data Template Editor.
Tips
• If you opened several templates in the Form Data Template Editor,
you can display the template that you require by selecting it on the
Window menu.
• We recommend that you define unique and meaningful names for your
form data templates. The software does not check whether the
template names are unique.
Related Topics

Delete a Form Data Template

1. In the Specifications module, click Actions > Delete Form Data Template.
2. In the Select Specification Form dialog box, select the form for which you want
to delete a form data template and click OK.
Tip
• The Select Specification Form dialog box only displays those forms
for which you have defined data templates.
3. In the Select Form Data Template dialog box, select one or more data templates
that you want to delete.
Tip
• To select multiple records, use the mouse while holding down the Ctrl
or Shift key, or select the Select all check box.
4. Click OK
5. Click Yes when prompted to confirm the deletion.
Tip
• Deleting a form a data template does not affect the source spec form or
specs to which you copied data from the template.
• Deletion of a form data template is irreversible.*
Related Topics

Single-Tag Specs: An Overview

A single-tag spec is a specification you can generate for a single instrument. A
single-tag can only contain data defined for one specific instrument. If you want to
use this tag in a multi-tag spec, you need to delete the single-tag spec first. A single
tag spec consists of a note page, and one or more data pages, depending on the form
on which you base the spec.
In the specification, you can edit some of the fields by clicking inside the field and
typing the required data. Other fields, such as Tag Number or Process Conditions
receive their data from the Instrument Index, Process Data or Calculation modules
and thus do not allow a direct editing. However, you can edit the process data and
calculation fields if you have been granted the appropriate access rights to do so. The
unit of measure fields allow you to select values from a predefined list of units. All
tag number property changes that are made not in the spec itself automatically take
effect in the spec generated for this tag.
It is possible to export single-tag specs to External Editor, where other users can edit
the appropriate data settings, and then import the edited data back to SmartPlant
Instrumentation.
Note
• If a single-tag spec has fieldbus columns, you can set preferences to allow
you to edit the fieldbus column values in the spec. However, you can only
make the fieldbus columns editable if the instrument type of the spec tag
number is Fieldbus.
Related Topics

Single-Tag Specs Common Tasks

Use the following tasks to generate and manage single-tag specs.
Generate a Single-Tag Spec

This procedure describes how to generate a single-tag spec for an existing instrument
using the Specifications module options. For more information, see Generate a
Single-Tag Spec, page 761.
Generate a Spec for a Complex Analyzer

Use this procedure to generate a specification for a complex analyzer. For more
information, see Generate a Spec for a Complex Analyzer, page 764.
Notes for Editing a Single-Tag Spec

This topic provided information on the editing options you can use if you need to
update or define data in the columns of a given single-tag spec. For more
information, see Notes for Editing a Single-Tag Spec, page 762.
Edit Manufacturers and Models in a Spec

Use this procedure to edit the instrument manufacturer and model in a spec. With a
spec open, you can display the instrument manufacturer supporting table and define
the manufacturers and models as you require. For more information, see Edit
Manufacturers and Models in a Spec, page 763.
Related Topics

Generate a Single-Tag Spec

1. In the Specifications Module window, click Actions > Open Specification
2. From the Item type list, select Instrument.
3. From the Tag class list, select a tag class.
4. In the Item number box, enter the exact instrument tag number.
Tips
• If you do not remember the instrument tag number, leave the Item
number box empty and click Find.
• If you are creating a specification for a specific process data case of an
instrument, the value in the Form number box might be view-only. If
the value is view only, you have already created previously a
specification for a different case of the same instrument. After
creating a spec for a process data case, the software assigns the same
spec form to all other cases of the same instrument.
• If the instrument process function is General, the available forms are
only those whose process function is also General. However, if the
instrument process function is not General, both General forms and
forms that have the same process function as the tag has are available
for association with the instrument.
5. In the Form number box, enter the spec form number.
Tip
• If you do not remember the form number, leave the Form number
box empty and click Find.
6. In the Open Specification box, click OK.
Tip
• If you receive a message that the specified instrument tag does not
exist, you can create a new instrument tag on the fly, provided that you
set preferences accordingly. To be able to create instrument tags in the
Specifications module, on the Preferences dialog box, on the
Specifications > General page, under Tag creation, select Allowed.

7. In the New Specification dialog box, do one of the following:

a. Select Create single-item specification.
b. In the Document number box, accept the default document number or
modify it as you require.
Tip
• You do not have to define the document number at this stage. If you
leave the Document number box empty, you can define the document
number in the spec title block of the spec, after you open the spec.
8. Click OK to generate and open the specification.
Related Topics
• Generate Instrument Specs in Batch Mode, page 698
Notes for Editing a Single-Tag Spec

Field Values
Some field values can be edited by clicking inside the field and typing the required
data. Some of the fields require that you select a value from a list. Other fields, such
as Tag Number or Process Conditions receive their data from the Instrument Index,
Process Data, or Calculation modules and thus do not allow a direct editing. You can
only edit process data and calculation values if you the appropriate access rights to do
so.
Units of Measure
The Units of Measure (UOM) fields allow you to select a unit from a predefined list
of units. After selecting a pressure unit, you are prompted to choose the pressure
reading method. When you select volumetric flow units, you are prompted to select
the measurement conditions (at flow or at base).
Spec Sheet Number

At the foot of the specification, you can enter the sheet number and total number of
sheets manually. You can leave these fields blank to complete them automatically
when you print the sheets.
Document Binder Status

When you edit and save an instrument specification that is part of a Specification
Binder package in the Document Binder module, you are prompted to define its
Document Binder status.

Edit Manufacturers and Models in a Spec

1. Open a spec.
• Click Actions > Instrument Models.
3. To add or change a manufacturer, in the Instrument Manufacturers dialog box,
under Manufacturer, select a manufacturer from the list or click to add a new
manufacturer.
4. To change the instrument model, in the data window of the dialog box, select the
new model.
5. To add a new model for the current manufacturer, do the following:
a. In the Instrument Manufacturers dialog box, click New to add a new data
row.
b. Type the instrument model values in the appropriate boxes, and also select the
process function.
c. Click OK.
Note
• The software automatically copies the defined instrument
manufacturer and model to the appropriate fields in the current spec.
6. Save the specification.
Related Topics
Move a Single-Tag Spec to a Multi-Tag Spec

Important
• When moving a single-tag spec to a multi-tag spec, the software only
copies the data that appear in the current see list. If the single-tag spec
contains data that appears on the main pages of the current multi-tag spec
(not in the see list), the software ignores these values, and automatically
deletes the single-tag spec and its document number.
1. Open a multi-tag spec.
2. Click the Multi-Tag List tab.
3. Click Actions > Move from Single.
4. In the Add Tag dialog box, click Find.

5. In the Find Items dialog box, search for the tags whose spec form is the same as
the form in the current multi-tag spec.
6. Under Search results, select one or more tags, and then click OK.
Tips
• In the Find Items dialog box, the Process function and Form
number boxes are view-only because all the target single-tag specs
must be based on the same form as the format of the current multi-tag
spec and share the same process function.
• If you know the target spec tag number, you can type it in the Add
Tag dialog box, and click OK to add this tag in the current see list.
• All the target single-tag specs must be based on the same form as the
format of the current multi-tag spec.
Related Topics
• Move a Tag to Another See List, page 777
Generate a Spec for a Complex Analyzer

1. Make sure that you have a specification form appropriate for an analyzer.
Tips
• The library form #77 is an example of a form designed for an analyzer.
If this form is not displayed in the Select Specification Form dialog
box, restore the supplied library forms.
• You can also generate a multi-tag spec for each stream of a complex
analyzer.
• You can also use this procedure to generate a spec for a simple
analyzer.
2. Generate a single-tag spec based on the analyzer form.
Related Topics
• Generate a Single-Tag Spec, page 761
• Generate a Spec for an Analyzer Stream, page 780

Process Data Case Specs: An Overview

A process data case specification is a single-section specification generated for a
particular process data case of an instrument tag. You can create an individual
specification for each case of an instrument tag, including the governing case. Each
process data case spec has its own revisions. Process data case specifications do not
have to share the same document number (as for other specifications).
You create process data case specifications in the same way that you create
specifications for other items. Since all process data case specifications share the
same tag number, creation of a process data case specification involves an additional
step, that is selecting the desired tag case. After you specify a tag number for creating
a new spec, the software automatically detects whether this tag number has multiple
cases and prompts you to select one of those cases.
Since all process data case specifications for a given instrument share the same spec
form, after creating the first specification for a particular case, you need to use the
same spec form for all subsequent process data case specifications that you create for
the instrument.
Note
• It is possible to generate a composite (multi-section) specification that
displays more than one process data case of an instrument. For details, see
Composite Spec for Instrument with Cases: Generation Workflow, page
796.
Related Topics
• Process Data Case Specifications Common Tasks, page 766

Process Data Case Specifications Common Tasks

The following tasks deal with generating single-section specs for a particular process
data case, or generate a hybrid case spec.
Generate a Spec for Multiple Process Data Cases

Use this procedure to generate a spec for a specific process data case defined for an
instrument that contains case. For more information, see Generate a Spec for
Multiple Process Data Cases, page 766.
Generate a Hybrid Case Spec

For a control valve for which you defined multiple process data cases, you can create
a hybrid case from the minimum, normal, and maximum flow coefficient values
(Cv/Kv) that you calculated for the various cases. Use this procedure to generate a
specification for this tag based on its hybrid case. Make sure that you have a form
designed for the control valve hybrid case. For more information, see Generate a
Hybrid Case Spec, page 767.
Related Topics
• Process Data Case Specs: An Overview, page 765
Generate a Spec for Multiple Process Data Cases

1. In the Specifications module, click Actions > Open Specification.
2. On the Open Specification dialog box, from the Item type list select
Instrument.
c. Click Find to display a list of instruments according to the search parameters
that you have selected.
d. Select the instrument tag for which you have calculated a hybrid case in the
Calculation module.
Tip
• Under Search parameters, the Case list displays all the available
cases defined in the Process Data module.
4. On the Find Items dialog box, click OK to accept your selection and return to the
Open Specification dialog box.

b. Select the appropriate form (not form #76, which designed for the control
valve hybrid case), and then click OK.
Tip
• If the value in the Form number box is view-only, this means that
you have already created previously a specification for a different case
of the same tag. After creating a spec for a tag case, the software
assigns the same spec form to all other cases of the same tag.
6. On the Open Specification dialog box, click OK to open the New Specification
dialog box, and then proceed with spec creation.
Related Topics
Generate a Hybrid Case Spec

2. On the Open Specification dialog box, from the Item type list select
Instrument.
c. Click Find to display a list of instruments according to the search parameters
that you have selected.
d. Select the instrument tag for which you have calculated a hybrid case in the
Calculation module.
Tip
• Under Search parameters, the Case list displays all the available
cases defined in the Process Data module. However, the software does
not indicate in the interface those instruments for which you calculated
a hybrid case.
4. On the Find Items dialog box, click OK to accept your selection and return to the
Open Specification dialog box.

b. Select the form #76, which designed for the control valve hybrid case, and
then click OK.
Tip
• The library form #76 is the library form supplied with SmartPlant
Instrumentation. This form contains columns that display minimum,
normal, and maximum flow coefficient values (Cv/Kv) you calculated
for the various cases in the Calculation module. If this form is not
displayed in the Select Specification Form dialog box, restore the
supplied library forms.
6. On the Open Specification dialog box, click OK to open the New Specification
dialog box, and then proceed with spec creation.
Related Topics

Multi-Tag Specs: An Overview

A multi-tag specification is a specification you can generate for a group of
instruments. Multi-tag specifications are frequently required because instruments of
the same type have many identical parameters. A multi-tag specification contains a
group of instrument tags that you can add, one by one, to the same spec sheet. A
multi-tag specification is based on a specification format, which is, in turn, is based
on the form that you set for assigning with multiple tags. Such a form can comprise
one or more spec pages.
Instrument tags in a multi-tag spec must have identical process functions except for
the following case: if the spec form process function is General but the form pages do
not include any data fields from the PD_NOT_ASSIGN or PD_GENERAL tables,
such a spec can contain instruments whose process functions are not identical, for
example, such a spec can contain both Flow and Temperature instruments.
A multi-tag specification always contains one Notes page, one Multi-Tag List page,
and one or more common pages with fields that are identical for all of the tags. The
Tag Number field, and other specification fields that appear on the Multi-Tag List
page, show the words SEE LIST instead of data. The SEE LIST label indicates that
the values in the fields appear on the Multi-Tag List tab of the spec. The Multi-Tag
List page contains fields whose values can differ from tag to tag. You can change the
SEE LIST label to any other text using the appropriate option on the Preferences
dialog box.
It is possible to export multi-tag specs to External Editor, where other users can edit
the appropriate data settings, and then import the edited data back to SmartPlant
Instrumentation. Also, you can move tags to another multi-tag spec (to another see
list), or, on removing a tag, automatically generate a single-tag spec for this tag. You
cannot remove the master tag.
Notes
• You can include fieldbus instruments in a multi-tag spec. However, the
software does not support editing of fieldbus data fields in a multi-tag
spec.
• You cannot include composite pages in a multi-tag spec. For details of
composite specs, see .
Related Topics
• Formats Common Tasks, page 782
• Title Block in a Multi-Tag Spec, page 802

Multi-Tag Specs Common Tasks

The following tasks enable you to manage multi-tag specs, search for instrument tags
in the see list, edit see list data, move instrument tags from one see list to another, or
to a single-tag spec, and so forth.
Generate a Multi-Tag Spec

Use this procedure to generate and open a multi-tag spec in the Specifications
module. To generate such a spec, you need to select a specific instrument and a form
for which you created a multi-tag spec format. After generating the spec, you can add
other instrument tags to the spec see list. For more information, see Generate a
Multi-Tag Spec, page 772.
Add a Single Instrument Tag to a Multi-Tag Spec

Use this procedure to add an instrument tag to the see list of an existing multi-tag
spec without opening the spec. For more information, see Add a Single Instrument
Tag to a Multi-Tag Spec, page 773.
Add Instrument Tags to a Multi-Tag Spec in Batch Mode

Use this procedure to add one or more instrument tags to the see list of an existing
multi-tag spec. To add instrument tags in batch mode, you must first open the target
spec. For more information, see Add Instrument Tags to a Multi-Tag Spec in Batch
Mode, page 774.
Edit See List Data in a Multi-Tag Spec

Use this procedure to edit data in the see list of a multi-tag spec. For more
information, see Edit See List Data in a Multi-Tag Spec, page 774.
Change the Master Tag Definition

In a multi-tag specification, several instrument tags have one common master page,
which is generated according to one of the instrument tags sharing this specification.
The master page is associated with a master tag which links to the information
common to all instrument tags that belong to the multi-tag specification. You can
change the master tag definition by selecting a different instrument tag to serve as the
master tag. The master tag definition also changes if you delete the current master
tag. In this case, the instrument tag that appears first in the see list becomes the
master tag. For more information, see Change the Master Tag Definition, page 775.
Search for a Specific Tag in a Multi-Tag Spec

Use this procedure to find a specific instrument tag within a multi-tag specification.
For more information, see Search for a Specific Tag in a Multi-Tag Spec, page 775.

Move a Tag to Another See List

Use this procedure to move instrument tags from the see list page of the currently
spec to a see list in another spec. You can either create a new multi-tag spec on the
fly and move instrument tags from the currently open see list to the target see list in
another specification, or move tags to the see list of an existing multi-tag
specification. For more information, see Move a Tag to Another See List, page 777.
Move a Tag from See List to a Single-Tag Spec

Use this procedure to remove an instrument tag from a multi-tag spec and create a
single-tag spec for this instrument. For more information, see Move a Tag from See
List to a Single-Tag Spec, page 778.
Move a Single-Tag Spec to a Multi-Tag Spec

Use this procedure to move single-tag specifications into the currently open multi-tag
spec. For more information, see Move a Single-Tag Spec to a Multi-Tag Spec, page
763.
Remove a Tag from a Multi-Tag Spec

Use this procedure to remove instrument tags from a multi-tag (see list) specification.
When removing a tag, it is possible to retain in the database or delete the tag spec data
defined in the see list. For more information, see Remove a Tag from a Multi-Tag
Spec, page 779.
Generate a Spec for an Analyzer Stream

To generate a specification for an analyzer stream, you need a special type of multi-
tag specification, which functions as follows:
• You generate a multi-tag specification, with the stream tag as the more
master tag.
• You then add the instrument tags associated with this stream to the multi-
tag specification.
• Fields that relate to the stream are displayed on the common page or pages
(not in the see list).
• The fields that vary — the tag names and tag-specific values — are
displayed in the in the see list on the Multi-Tag List tab.
For more information, see Generate a Spec for an Analyzer Stream, page 780.
Related Topics

Generate a Multi-Tag Spec

Note
• Before you can perform this procedure, make sure you created a multi-tag
spec format for a spec form you need to associate with the instrument for
which you want to create the spec.
1. In the Specifications Module window, click Actions > Open Specification
2. From the Item type list, select Instrument.
3. In the Item number box, enter the exact instrument tag number that you want to
define as the master tag in your multi-tag spec.
Tips
• If you do not remember the instrument tag number, leave the Item
number box empty and click Find.
• If you are creating a specification for a specific process data case of an
instrument, the value in the Form number box might be view-only. If
the value is view only, you have already created previously a
specification for a different case of the same instrument. After
creating a spec for a process data case, the software assigns the same
spec form to all other cases of the same instrument.
• If the instrument process function is General, the available forms are
only those whose process function is also General. However, if the
instrument process function is not General, both General forms and
forms that have the same process function as the tag has are available
for association with the instrument.
4. In the Form number box, enter the spec form number of the form for which you
created a multi-tag list format.
Tip
• If you do not remember the form number, leave the Form number
box empty and click Find.
5. In the Open Specification box, click OK.
6. In the New Specification dialog box, do one of the following:
a. Select Create multi-tag specification.
b. In the Document number box, accept the default document number or
modify it as you require.
Tip
• The document number that you define applies to the entire multi-tag
specification, regardless of the number of instruments you
subsequently add in the current spec see list.

7. Click OK to generate and open the specification.

Tip
• After generating the multi-tag spec, you can add other instrument tags
to the spec directly from the spec see list, without having to perform
the current procedure again.
Related Topics
• Generate Instrument Specs in Batch Mode, page 698
• Multi-Tag Spec Formats: An Overview, page 781
Add a Single Instrument Tag to a Multi-Tag Spec

1. In the Specifications Module window, the menu bar, click Actions > Open
Specification.
2. Select an instrument tag that is not yet associated with a specification by doing
• In the Item number box, type the tag number.
• Click Find to search for the tag number that you require.
3. Select the spec form by doing one of the following:
• In the Form number box, type the form number.
• Click Find to search for the form that you require.
4. Click OK.
5. In the New Specification dialog box, select Add tag to existing multi-tag
specification.
6. In the Document numbers pane, select the document number of the target multi-
tag spec, with which you want to associate the current instrument tag.
Tips
• To display the selected multi-tag specification, click View.
• All the documents in all of the existing lowest level plant groups are
displayed in the Document numbers pane. Therefore, you can select
a document to add the instrument tag to a multi-tag spec belonging to
any of the existing plant groups.
7. Click OK to open the specification.
8. On the toolbar, click to save the specification.
Related Topics

Add Instrument Tags to a Multi-Tag Spec in Batch Mode

2. Click the Multi-Tag List tab to display the instrument tags that exist in the
current see list.
• To add instrument tags that currently are not associated with any spec,
on the menu bar, click Actions > Add Tag.
• To move instrument tags from existing single-tag specs, on the menu
bar, click Actions > Move from Single.
4. On the Add Tag Number dialog box, click Find and then, search for the
instrument tags that you can add to the current spec.
5. Under Search results, select the tags that you require, and then, click OK to
return to the Add Tag Number dialog box.
6. On the Add Tag Number dialog box, click OK.
7. On the toolbar, click to save the specification.
Related Topics
Edit See List Data in a Multi-Tag Spec

2. Click the cell in which you want to add or edit data.
3. Modify the existing value or define a new value.
4. Save the spec.
Tips
• You can only edit or define the see list values per specific cell.
• On main data pages of a multi-tag spec, you can edit spec fields that
are common to all the tags, in the same way that you edit a single-tag
spec.
Related Topics
• Notes for Editing a Single-Tag Spec, page 762

Change the Master Tag Definition

1. In the Specifications module, click Actions > Change Master Tags.
2. In the Change Master Tags dialog box, under Document numbers, select a
document number.
3. In the Tag numbers pane, beside the tag number you want to set as the muster
tag, select the Master check box.
4. Click Apply to set the selected tag as the new master tag.
Tips
• If you cannot find the document number in the Change Master Tags
dialog box, this means that the spec you are looking for does not
contain a document number. You need to open the target spec and
define the document number in the spec title block.
• The master tag definition also changes if you delete the current master
tag. In this case, the instrument tag that appears first in the see list
becomes the master tag.
Related Topics
• Ways of Defining a Spec Document Number, page 703
Search for a Specific Tag in a Multi-Tag Spec

1. In a multi-tag spec, click the Multi-Tag List tab to display the see list.
2. Accept the default sort order or define a new ascending sort order by double-
clicking the header on any column in the see list to set a new ascending.
Tips
• The default sort order is by tag number in ascending direction. When
you double-click a column heading, the arrow indicates the sort key
and direction. You can click the same column already change the
sorting direction.
• The master tag definition also changes if you delete the current master
tag. In this case, the instrument tag that appears first in the see list
becomes the master tag.
3. If you have not yet found your tag, on the toolbar, click and do one of the
following:
• Type the target tag number.
• Click Find to open a dialog box where you search for the tag.

Change the Font Size of See List Column Headers

1. With the Specifications module window open, do one of the following:
• On the Edit menu, click Format Editor.
2. Click Actions > Customize Format.
3. In each of the spin boxes, set the values as appropriate.
Tips
• The Sample header font size and Sample header height boxes allow
you to add values in PowerBuilder units (1 PowerBuilder unit is
equivalent to 1/32 of the current system font height used in Windows).
• The Sample field font size and Sample field height boxes allow you
to add values in pixels.
4. Click OK.
Tip
• The changes you made in the font size will take effect only after you
reopen the multi-tag list format you are currently editing.
Related Topics

Move a Tag to Another See List

2. Click the Multi-Tag List tab to display the see list.
3. Select the instrument tags you want to move to another multi-tag spec.
4. On the menu bar, click Actions > Move to Another Multi-Tag List.
5. On the dialog box that opens, under Select target format, select a format.
Tips
• The Select target format displays all the formats that you can use to
create multi-tag specs. You can select either the format of the
currently open specification and then create a new specification, or
select a different format.
• If a format appears without the icon, this means that there are no
multi-tag specs assigned to this format, or that this is the format of the
current spec. In this case, you can only create a new multi-tag spec,
and move the instrument tags from the current see list to the see list of
the new spec.
• If you want to move instrument tags to an existing spec, select a
format that already has a multi-tag spec (that is, a format that has a
icon to the left of the format name).
6. Depending on the format that you selected, do one of the following:
• If the selected format is different from the current format, and already
has a multi-tag spec, select either Move to new multi-tag instrument
specification or Move to existing multi-tag instrument
specification.
• If you selected the current format or a format that does not have multi-
tag specs, select Move to new multi-tag instrument specification,
enter a document number for the new spec, and also, from the Master
tag list, select a tag number which you want to set as the master tag in
the new spec.
Related Topics
• Move a Tag from See List to a Single-Tag Spec, page 778

Move a Tag from See List to a Single-Tag Spec

2. Click the Multi-Tag List tab.
3. Select one or more tags and click Actions > Move to Single.
Tips
• If you selected multiple tags, on the Specifications tab of the
Preferences dialog box, you can select Skip individual confirmation.
• You cannot move the master tag.
• The form number of the created single-tag specs is the same as the
form number of the current multi-tag spec.
• The software automatically creates individual document numbers for
each single-tag spec. The created tag numbers depend on whether the
spec document number naming convention exists. If it does not exist,
the software creates spec document numbers as follows: <item tag>-
SP.
Related Topics
• Move a Tag to Another See List, page 777

Remove a Tag from a Multi-Tag Spec

1. In a multi-tag specification, on the Multi-Tag List tab, select the instrument tags
that you want to remove from the see list.
2. On the Actions menu, click Remove Tag.
3. In the message that opens, click Yes when prompted to remove the tags.
4. When prompted to clear the specification data, do one of the following:
• Click Yes to delete from the database the see list values defined for the
tag.
• Click No to preserve the tag see list values in the database.
Tip
• If you clicked No, and then generate a specification for the tag that you
removed, the software retrieves the see list values from the database
and displays them in the generated spec. To display the values, it is
only crucial that the spec form on which you base the new spec
contains the columns that appeared in the see list of the tag that you
removed. This means that the form of the new spec does not have to
be the same as the form of the spec from which you removed the tag,
and that the type of the new spec can be either single-tag or multi-tag.
Notes
• You cannot remove the master tag unless you redefine it as a standard tag.
• The software does not allow you to remove tags that are currently assigned
to a Specification Binder package or that were revised in the Document
Binder module.
Related Topics
• Change the Master Tag Definition, page 775

Generate a Spec for an Analyzer Stream

1. Make sure that you have created a multi-tag format based on an analyzer stream
form.
Tip
• The library form #78 is an example of a form designed for an analyzer
stream. If this form is not displayed in the Select Specification Form
dialog box, restore the supplied library forms. You can then create a
multi-tag spec format for the form #78.
2. Based on such a format, generate a multi-tag spec for the stream tag that you want
to set as the master tag.
3. In the Multi-Tag List of the generated spec, add other tags belonging to the
current analyzer stream.
4. Click Actions > Save.
Related Topics
• Add Instrument Tags to a Multi-Tag Spec in Batch Mode, page 774
• Create a Format, page 783
• Generate a Spec for a Complex Analyzer, page 764

Multi-Tag Spec Formats: An Overview

A multi-tag spec format is a template that contains see list columns where you can
define instrument-specific values on the Multi-Tag List tab of a multi-tag spec. You
create a specification format using a specification form as a source, and can build an
unlimited number of formats based on a single form.
Related Topics

Formats Common Tasks

You use the following tasks to manage multi-tag spec formats in the Specifications
module.
Create a Format
Use this procedure to create a formats for multi-tag specs. You create a format based
on a spec form, which in turn is based on a spec page. You can build an unlimited
number of formats based on a given form. When creating a format, you can edit the
headers of the columns that appear in the spec see list, and also fine-tune the order
and width of columns. For more information, see Create a Format, page 783.
Modify a Format
You can modify an existing format so that it fits the needs of your multi-tag specs.
The modification process is similar to creating a new format. Changes that you make
to a specification format affect multi-tag specs that are already associated with that
format. You modify formats in the Format Editor, in the Specifications module.
For more information, see Modify a Format, page 784.
Change the Font Size of See List Column Headers

This procedure allows you to modify the font size and height of the see list column
headers used in all multi-tag specs based on a specific format. You can customize the
column header font size and height, and also the column name font size and height.
For more information, see Change the Font Size of See List Column Headers, page
776.
Delete a Format
This procedure enables you to select a specific form, display its format, and then
delete a format that is not in use in multi-tag specs. For more information, see Delete
a Format, page 786.
Regenerate Formats
Use this procedure if you encounter problems with opening or printing a multi-tag
spec after upgrading your SmartPlant Instrumentation version. These problems occur
because certain format properties are not applied to a form. Format regeneration can
fix these problems. For more information, see Regenerate Formats, page 786.
Change the Format for a Multi-Tag Spec

You use this procedure if more than one format exists for a form. For more
information, see Change the Format for a Multi-Tag Spec, page 787.

Define Multi-Tag Spec Print Layout

You use this procedure to define a custom print layout for a specific format. This
feature is useful if the default print layout causes data display problems in the
printout. For more information, see Define Multi-Tag Spec Print Layout, page 787.
Related Topics
Create a Format
1. On the Specifications Window module menu bar, click Edit > Format Editor.
2. On the Format Editor menu bar, click Actions > Open Format.
4. On the Select Format dialog box, under Format, type the name of the new
format and click OK.
Tip
• If the form that you selected on the Select Specification Form dialog
box has existing formats, click New before typing the new format
name.
5. Do the following for each field that you want to appear on the spec see list:
a. In the field selection area of the form (usually on the right), double-click the
field.
b. To display the original form header in the active row of the Edit Headers
pop-up window, click the form header after the cursor changes its shape to
.
c. In the Edit Headers pop-up window, edit the header as necessary.
Tips
• The background color of the active field changes to magenta.
• Fields already added to the Edit Headers pop-up window are
highlighted in cyan.
• The icon in the left column of the Edit Headers pop-up window
points to the header input box for the active field. If you are working
from a library form, the form header was automatically copied to this
field.
6. On the Format Editor toolbar, click to generate the format.

7. To change the see list column position of a header and its field, do the following
in the Edit Headers pop-up window:
a. Select the header for which you want to change the column position.
b. Click Move Up or Move Down as necessary.
Tip
• The order of the headers in the Edit Headers pop-up window
determines the left-to-right column order on the Multi-Tag List tab
the spec.
8. To change the width of columns as they appear in the spec see list, do the
following on the Format dialog box:
a. Select portrait or landscape print preview.
b. Set the cursor on the border between two headers.
c. Drag the border to the left or to the right as necessary.
9. Click to save the new format.
Related Topics
Modify a Format
1. On the Specifications Window module menu bar, click Edit > Format Editor.
2. On the Format Editor module menu bar, click Actions > Open Format.
4. Select a format that you want to modify, and click OK.
5. To edit headers that currently appear in the Edit Headers pop-up window, do the
following:
a. In the field selection area of the form (usually on the right), double-click the
field for which you want to edit the header.
b. In the Edit Headers pop-up window, edit the header as necessary.
Tips
• When you double click the field, the background color of the field
changes to magenta.
• The icon in the left column of the Edit Headers pop-up window
points to the Header input box for the active field.
• To copy the original form header into the active Header input box,
click the form header after the cursor changes its shape to .

6. To remove a field and its header from the multi-tag list, do the following:
a. In the field selection area of the form, double-click the field that you want to
delete.
b. In the Edit Headers pop-up window, click Remove.
7. To add a field and header to the multi-tag list, do the following:
a. In the field selection area of the form, double-click the field that you want to
add.
b. To display the original form header in the active row of the Edit Headers pop-
up window, click the form header after the cursor changes its shape to .
c. In the Edit Headers pop-up window, edit the header as necessary.
8. To change column position of a header and its field, do the following in the Edit
Headers pop-up window:
a. Select the header for which you want to change the column position.
b. Click Move Up or Move Down as necessary.
Tip
• The order of the headers in the Edit Headers pop-up window
determines the left-to-right column order on the Multi-Tag List tab
the spec.
9. To change the width of columns as they appear in the spec see list, do the
following on the Format dialog box:
a. Select portrait or landscape print preview.
b. Set the cursor on the border between two headers.
c. Drag the border to the left or to the right as necessary.
10. Click to regenerate and save the modified format
Related Topics

Delete a Format
1. With the Specifications module window open, do one of the following:
• On the Edit menu, click Format Editor.
2. Click Actions > Delete Formats.
3. On the Select Specification Form dialog box, select a form whose format you
want to delete, and then click OK.
4. On the Select Format dialog box, select the required format from the list.
Tips
• You can only select and delete one format at a time.
• The software prevents you from deleting a format that is in use in
specs.
5. Click OK to delete the selected format.
Related Topics
Regenerate Formats
1. In the Specifications Module window, click Actions > Regenerate Formats.
2. On the Regenerate Formats dialog box, click Run.
3. On completion of the process, click Close.
Related Topics

Change the Format for a Multi-Tag Spec

2. Click Actions > Change Format.
3. On the Select Format dialog box, select the required format from the list.
Tip
• After changing the format, the software only shows see list columns
that appear in the format that you selected. As a result, if the current
see list columns do not appear in the selected format, the software
retains the column values in the database but does not display them in
the spec after you change the format.
4. Click OK to change the format.
Related Topics
Define Multi-Tag Spec Print Layout

1. On the Specifications Module window menu bar, click Edit > Format Editor.
2. On the Format Editor menu bar, click Actions > Open Format.
3. Select the target spec form and click OK.
4. Select the target format or create a new one and click OK.
5. On the form that opens, add field headers to the Edit Headers dialog box. For
details, see Create a Format, page 783.
6. On the toolbar, click to save the format.

7. On the menu bar, click Actions > Define Print Layout.
8. From the Column Header pop-up window, drag the field headers to the Define
Print Layout dialog box.
Tip
• The number of the columns on the Define Print Layout dialog box
corresponds to the number of the headers in Column Header pop-up
window. You can drag up to five headers under the same column on
the Define Print Layout dialog box.
9. Click Generate.
10. On the Generate Print Layout dialog box, select the appropriate printout
orientation and click OK.

11. Test the defined print layout as follows:

a. Click File > Preferences > Specifications > General and clear the Use
default print layout check box.
b. Open a multi-tag spec assigned to the format for which you defined the print
layout.
c. Print the spec.
Tips
• The only supported spec page size is A4.
• If you want modify the print layout, for example by adding more
column headers, you must regenerate the print layout and then save it.
• The defined print layout applies to all existing and new multi-tag specs
assigned to the form that uses the current format.
Related Topics

Non-Instrument Specs: An Overview

A non-instrument specification is a specification whose item type is not Instrument.
A spec page associated with a non-instrument spec form contains various properties
of the source item. If needed, you can regenerate the spec page and add more
columns from the tables <item type>, udf_<item type>, spec_sheet_data, and
add_spec1..9. For example, in a cable specification, you can add columns from the
tables CABLE, UDF_CABLE, and so forth. SmartPlant Instrumentation allows you
to generate the non-instrument specifications for the following item types:
• Cable — Allows you to create a specification for a single reference cable

defined in the Reference Explorer.
• Panel — Allows you to create a specification for a single reference panel
in the Reference Explorer.
• Wiring Equipment — Allows you to create a specification for a single
reference wiring equipment item. A wiring equipment item can be an I/O
card, I/O termination, fieldbus brick, or any other user-defined wiring
equipment in the Reference Explorer.
• Hook-Up Item — Allows you to create a specification for a single hook-
up item defined in the Reference Explorer.
• Loop — Allows you to create a functional requirement specification.
This specification consists of the main page with the loop number data,
individual pages associated with the loop tags, and the note page, which is
created automatically and refers to the loop number only. The form
associated with the loop number page is the form that you defined for the
Loop item type. The forms associated with the functional requirement tag
pages can be different, depending on the form number that you associate
with each functional requirement tag.
Important
• If you need to create a specification for a loop and its tags, we recommend
that you create a loop composite spec instead of a functional requirement
spec. For details, see Loop Composite Spec: Generation Workflow, page
798 It is planned to discontinue support of functional requirement spec
after Version 2007 of SmartPlant Instrumentation.
SmartPlant Instrumentation does not support saving non-instrument specifications as
.isf files. Therefore, you cannot use the export or import options to work with these
specifications in External Editor. Saving non-instrument specifications in Excel
format is not supported either.
Related Topics

Non-Instrument Specs Common Tasks

The following tasks deal with generating specs for items whose item type is other
than Instrument.
Prerequisites for Generating a Non-Instrument Spec

This topic lists prerequisites for generating a non-instrument spec. For more
information, see Prerequisites for Generating a Non-Instrument Spec, page 790.
Generate a Non-Instrument Spec

Use this procedure to create a specification for a hook-up item, reference cable,
reference panel, or reference wiring equipment. In this procedure, cable spec
generation steps are shown as an example. Procedures of creating other non-
instrument specifications follow the same pattern. For more information, see
Generate a Non-Instrument Spec, page 791.
Generate a Functional Requirement Spec

This procedure explains how to generate a functional requirement specification. You
can use this procedure after defining a functional requirement for a loop using the
appropriate options in the Instrument Index module. For more information, see
Generate a Functional Requirement Spec, page 792.
Related Topics
Prerequisites for Generating a Non-Instrument Spec

General Prerequisites
In the Form Editor, you must restore a form for the item type you want to assign
with the specification. For example, to generate a specification for a specific cable,
you must first restore the library form 80.
Cable Spec Generation Prerequisite

In the Reference Explorer, create a reference cable.
Panel Spec Generation Prerequisite

In the Reference Explorer, create a reference panel.
Wiring Equipment Generation Prerequisite

In the Reference Explorer, create an I/O card, I/O termination, fieldbus brick, or any
other user-defined wiring equipment.

Hook-Up Item Spec Generation Prerequisite

In the Reference Explorer, create a hook-up item and assign it to an item library.
Related Topics
• Generate a Non-Instrument Spec, page 791
Generate a Non-Instrument Spec

Note
• Before you perform this procedure, restore the appropriate library forms.
2. On the Open Specification dialog box, from the Item type list, select Cable.
3. Enter a name of a reference cable, or click Find to find the required reference
cable or form.
4. After specifying the cable name and the form number, on the Open Specification
dialog box, click OK.
5. On the New Specification dialog box, accept or modify the document number
associated with the new specification.
Tips
• The software automatically creates the document number using the
cable name as a source, and append the – SP suffix. There is no
naming convention for a non-instrument spec document number.
• You can leave the Document number box empty if you want to
specify the document number manually, after opening the
specification. In the specification, you can enter the document number
in the title block.
• You can only create a single-cable specification. The software does
not support a see list for non-instrument specs.
6. Click OK to generate a specification.
Tips
• If you want to save the cable specification as a .psr file, click Actions
> Save As, and select Original.
• You can edit various cable properties in the cable spec in two ways: in
the cable spec itself, or on the Properties dialog box, which you can
open for the cable in the Reference Explorer.
Related Topics

Generate a Functional Requirement Spec

2. On the Open Specification dialog box, from the Item type list, select loop.
3. Enter a loop number and the form number, or click Find to find the appropriate
loop number or form.
4. After specifying the loop number and the form number, on the Open
Specification dialog box, click OK.
5. On the Functional Requirement Specification dialog box, enter a new document
number to be associated with the new specification.
Tip
• Leave the Document number box empty if you want to specify the
document number manually, after opening the specification. In the
specification, you can enter the document number in the title block.
6. Under Functional requirement tags, for each functional requirement tag, from
the Spec Form Number column, select the compatible form number to be
associated with the specification, and then click OK.
Tips
• You must select forms for all of the functional requirement tags
because on generating the specification, the software creates individual
pages for each tag that is displayed in the Functional requirement
tags data window.
• The forms associated with the functional requirement tag pages can be
different, depending on the form number that you associate with each
functional requirement tag.
• After creating a functional requirement specification, it is not possible
to change the form number of a tag in the functional requirement
specification or the form number of the loop. If you do need to change
the form number, you have to delete the entire specification, and then
create a new functional requirement specification again.
Related Topics

Composite Specifications: An Overview

A composite specification is a specification that contains more than one section. You
can either define loop composite specs or instrument composite specs. A loop
composite spec includes a loop and its instrument tags. A composite instrument spec
can include tags belonging to the same or different loops. In contrast to multi-tag
instrument specifications, which contain pages of common properties in addition to
the SEE LIST page, such composite specs do not have common pages and can
include tags whose process functions are not identical. Each section in a composite
spec page contains data pertinent to a specific instrument tag. Also, it is possible to
create a composite spec that includes process data cases of a particular instrument.
Unlike other specs you create in SmartPlant Instrumentation, a composite spec does
not have a Notes page. If you want to use notes, you must manually add a note box
in the appropriate section.
In the Domain Explorer, document numbers of loop composite specs appear under
loop numbers and document numbers of instrument composite specs appear under
each instrument included in the spec. When duplicating an instrument tag associated
with a composite spec, the software never duplicates the composite spec. When
duplicating a loop, the software always duplicates the loop composite spec.
Generating and Printing Composite Specs

When generating a composite spec, if you assigned more than one instrument to a
particular section, the software multiplies this section on the spec as many times as
the number of assigned instruments. You can set the software to multiply sections
from left to right or from top to bottom. When more than one instrument is assigned
to the same section, the instruments are sorted automatically in ascending order
according to tag number. In a composite spec that contains process data cases of an
instrument, the cases are sorted in ascending order according to case sequence
defined in the Process Data module (governing case is always the left-most section).
When printing a composite specification, we recommend that the print sheet size be
either A4 or Letter. Note, however, that if the title block assignment method in the
current domain is defined as Standard (used in all modules), you need to adjust
your title block before printing specs using the Letter size. For details, see Spec Title
Blocks: An Overview, page 801.

Managing Composite Spec Sections

SmartPlant Instrumentation comes shipped with several spec forms that already
include composite pages with predefined sections (for example, forms 88, 89, 90).
You must restore these forms before you start working with the sections included in
the composite pages of these forms. A form with a composite page cannot include
any other pages. In SmartPlant Instrumentation, you can create new sections on the
basis of existing ones but it is not possible to create a section from scratch.
You manage spec sections in the Sections Editor. Spec section editing options are
the same as for spec pages, which you manage in the Page Editor. Therefore, before
modifying data fields in a spec section, it is recommended that you familiarize
yourself with spec page management options. For details, see Specification Pages:
An Overview, page 694 and the related topics. The Section Editor has a limited
number of editing options. It is possible, however, to export spec sections to
InfoMaker, edit them as you require, and then import them back to SmartPlant
Instrumentation.
Features not Supported for Composite Specs

The following features of SmartPlant Instrumentation are not supported for composite
specs:
• Exporting data to External Editor (IEE)

• Save as Excel options
• Claim or merge options (only relevant in an Operating owner domain)
• Copying data from a form data template or another spec
• Multi-tag list format options or inclusion of composite pages in a multi-tag
spec
• Spec Data Dictionary options
• Browser options
• Data comparison and history options
• Changing the section process function
• Custom title block assignment options available in the Specifications
module (you must use the Standard custom title block assignment method
if you want to display a custom title block in composites specs)
• Retrieving composite specs from Intergraph IDEAL
• Using InfoMaker with composite specs saved as .psr files.
Related Topics
• Composite Spec for Instrument with Cases: Generation Workflow, page
796
• Composite Spec for Multiple Instruments: Generation Workflow, page 795
• Loop Composite Spec: Generation Workflow, page 798

Composite Spec for Multiple Instruments: Generation

Workflow
In this scenario, you create an instrument composite spec containing two sections:
one for a control valve and the other for an I/P transducer. Such a spec can include
multiple control valves and I/P transducers belonging to different loops. You use the
library form Control Valve/I/P Transducer as a source for creating a new form and
assigning a new composite spec page to this form.
1. In the Instrument Index module, or using the Domain Explorer, create a control
valve and I/P transducer.
2. On the Specifications Module window menu bar, click Edit > Form Editor.
3. On the Form Editor menu bar, click Actions > Restore Form and then restore
form Control Valve/I/P Transducer (form number 90).
Tip
• When restoring the form, the software restores its page and enables
you to work with sections that this page includes.
4. On the Specifications Module window menu bar, click Edit > Section Editor
and modify the fields of the following sections as you require:
• Control Valve Style3 (item type Instrument)
• I/P Transducer Style3 (item type Instrument)
5. On the Specifications Module window menu bar, click Edit > Page Editor.
6. On the Page Editor menu bar, click Actions > New Composite Page.
7. On the New Composite Page dialog box, select Data sections with headers.
8. On the Select Sections for Composite Page dialog box, under Multiply sections
in generated spec, select From top to bottom, and then select the following
sections:
• Control Valve Style3
• I/P Transducer Style3
Tip
• When you select a section multiplying option, you determine how the
software multiplies sections in a generated composite spec. In a
generated spec, if you assigned more than one instrument to a section,
the software multiplies this section on the spec as many times as the
number of assigned instruments. You set a section multiplying option
only once and cannot change it after you open and save the current
spec page in the Page Editor. This setting applies to all the sections
you add in the current spec page.

9. In the Page Editor working area, position the sections one under the other, within
the page borders.
10. Save the page with the name CV/I/P Transducer Test.
11. Open the Form Editor and click Actions > New Form, select the Control
Valve/I/P Transducer page for the form, and then name the new form as CV/I/P
Transducer Test and specify a form number.
Specification and do the following:
a. From the Item type list, select Instrument.
b. In the Item number box, enter the tag number of the control valve you
created.
c. In the Form number box, enter the number of the CV/I/P Transducer Test
form and click OK.
d. On the New Composite Specification dialog box, beside I/P Transducer
Style1, click Assign and assign your I/P transducer to the I/P Transducer
Style1 section.
e. Click OK to generate and open an instrument composite specification.
Related Topics
Composite Spec for Instrument with Cases: Generation

Workflow
In this scenario, you create an instrument composite spec containing three process
data cases of an instrument with the Flow process function. You use the library form
Orifice Plate Composite as a source for creating a new form and assigning a new
composite spec page to this form.
1. In the Instrument Index module, or using the Domain Explorer, create a flow
instrument.
2. In the Process Data module, create three cases for the instrument and define
process data for each case.
form Orifice Plate Composite (form number 88).
Tip
• When restoring the form, the software restores its page and enables
you to work with sections that this page includes.

• Flow Orifice Header (header section)
• Flow Orifice Data (data section)
8. On the New Composite Page dialog box, select Header section and data
section.
9. On the Select Sections for Composite Page dialog box, select the following
sections:
• Flow Orifice Header
• Flow Orifice Data
10. In the Page Editor working area, position the sections one under the other.
11. Save the page with the name Orifice Plate Composite Test.
12. Open the Form Editor and click Actions > New Form, select the Orifice Plate
Composite page for the form, and then name the new form as Orifice Plate
Composite Test and specify a form number.
a. From the Item type list, select Instrument.
b. In the Item number box, enter the tag number of the flow instrument that has
cases.
c. In the Form number box, enter the number of the Orifice Plate Composite
Test form and click OK.
d. Select a case to assign it to the instrument composite spec you are creating and
click OK.
e. On the New Composite Specification dialog box, beside Flow Orifice Data,
click Assign and assign the two remaining cases to the Flow Orifice Data
section.
f. Click OK to generate and open an instrument composite specification.
Tip
• In the composite spec, the sections that show case data appear from
left to right. The sections are sorted in ascending order according to
case sequence defined in the Process Data module (governing case is
always the left-most section).
Related Topics

Loop Composite Spec: Generation Workflow

In this scenario, you create a loop composite spec containing three sections: a loop
section and two instrument sections. The two instrument sections include one for a
control valve and the other for an I/P transducer. You use the library form Flow
Loop Composite Style1 as a source for creating a new form and assigning a new
composite spec page to this form.
1. In the Instrument Index module, or using the Domain Explorer, create a loop
with a control valve and I/P transducer.
form Flow Loop Composite Style1 (form number 91).
Tip
• When restoring the form, the software restores its page and the seven
sections that this page includes. In this scenario, you need three of
these sections to generate the current composite loop spec.
• Flow Loop Composite Style1 (item type Loop)
• Control Valve Style1 (item type Instrument)
• I/P Transducer Style1 (item type Instrument)
7. On the New Composite Page dialog box, select Loop composite page.

8. On the Select Sections for Composite Page dialog box, under Multiply sections
in generated spec, select From top to bottom, and then select the following
sections:
• Flow Loop Composite Style1
• Control Valve Style1
• I/P Transducer Style1
Tip
• When you select a section multiplying option, you determine how the
software multiplies sections in a generated composite spec. In a
generated spec, if you assigned more than one instrument to a section,
the software multiplies this section on the spec as many times as the
number of assigned instruments. You set a section multiplying option
only once and cannot change it after you open and save the current
spec page in the Page Editor. This setting applies to all instrument
sections you add in the current spec page.
9. In the Page Editor working area, position the sections one under the other, with
the loop section placed at the top.
10. Save the page with the name Flow Loop Test.
11. Open the Form Editor and click Actions > New Form, select the Flow Loop
Test page for the form, and then name the new form as Flow Loop Test and
specify a form number.
a. From the Item type list, select Loop.
b. In the Item number box, enter the number of the loop you created.
c. In the Form number box, enter the number of the Flow Loop Test form and
click OK.
d. On the New Composite Specification dialog box, beside Control Valve
Style1, click Assign and assign the current loop control valve to the Control
Valve Style1 section.
e. Beside I/P Transducer Style1, click Assign and assign the current loop I/P
transducer to the I/P Transducer Style1 section.
f. Click OK to generate and open a loop composite specification.
Related Topics

Remove an Instrument from a Composite Spec

1. In a composite specification, do one of the following:
• On the Actions menu, click Remove Tags from Composite Spec.
• On the toolbar, click
2. In the dialog box that opens, select one or more tags and click OK.
3. On the toolbar, click to refresh the spec.
Tips
• When removing tags from a loop composite spec, you can remove all
the instruments.
• When removing tags from an instrument composite spec, you cannot
remove the last remaining tag because such a spec must include at
least one instrument tag.
• After removing instruments, the sections remain displayed in the spec.
If you want to remove these sections from the spec, you must remove
them in the Page Editor. For details, see Remove a Section from a
Composite Page, page 800.
Related Topics
Remove a Section from a Composite Page

1. Open a composite spec in the Page Editor.
2. In the working area, select and right-click a section you want to remove from the
current page.
3. On the shortcut menu, click Remove Current Section.
Tip
• If a composite spec including the selected section already exists, the
software does not allow you to remove the section. You must first
open such a spec and dissociate all the instruments that are assigned to
the current section. For details, see Remove an Instrument from a
Composite Spec, page 800.
Related Topics

Spec Title Blocks: An Overview

A specification title block is a shipped or custom .psr file that combines revision
rows, database fields, and a logo. You assign a title block to a spec form to display
the relevant information in specifications based on that form. If a form contains
several pages, the title block is common to every page of the form. In a generated
single-section spec, the software displays the same title block on every spec page,
including the Notes page. In a generated composite (multi-section) spec, the software
does not display the title block; you need to open a spec print preview to display the
title block.
The System Administrator, when making or modifying domain definitions in the

Administration module, can select a custom title block assignment method. The
following title block assignment methods are available:
Standard (used in all modules)
This method allows you to associate one default title block with all the specs you
generate. When using this method, the software hides all the title block assignment
options that are available in the Specifications module. In this case, you need to
associate your title block with SmartPlant Instrumentation on the Title Blocks dialog
box. The Domain Administrator, when managing reports, can then define your title
block as the default title block that appears automatically in all specifications that you
generate.
Notes
• If you print specs using the A4 sheet size, we recommend that you use the
Specs Default TB with PB Units.psr title block with specs, which is fully
compatible with all the library forms and does not require any manual
adjustments. This is a template title block that is shipped with SmartPlant
Instrumentation. This title block is created using PowerBuilder units.
• If you print specs using the Letter sheet size, you must first customize the
Specs Default TB with PB Units.psr title block in InfoMaker by
reducing the title block height. Removing two revision rows from the title
block is enough to make it appear correctly in a printout of any spec based
on a library form.
• If you want to use a custom title block, you need to place the title block
correctly in a spec page layout. To do so, on the Preferences dialog box,
Specifications > Custom page, under Parameter, enter
TitleFooterHeight, and under Value, enter 798, which is the optimal
value for specifications created using SmartPlant Instrumentation options.
For a spec page created in InfoMaker, you may need to enter a different
value, depending on the page layout settings.

Special (used in the Specifications module only)
This method allows you to assign various title blocks to spec forms. If this method is
defined in the current domain, the Domain Administrator does not assign any default
title block to your specs, so you need to make title block assignments by yourself,
using the Specifications module options. You can create multiple custom title blocks
and associate then with SmartPlant Instrumentation using the Title Block Styles
dialog box. Depending on your database platform, you must only use one of the
following title blocks as a source for creating custom title blocks: tb_mss.psr (when
using SQL Server), tb_ora.psr (when using Oracle, or Tbsample.psr (when using
Sybase Adaptive Server Anywhere).
Note
• When working with composite specs, you cannot use the title block
assignment options that are available in the Specifications module.
Therefore, if the selected block assignment method is Special, the
software automatically assigns the default title block to a composite spec
even though the module-specific option are available in the Specifications
module. This title block is supplied with SmartPlant Instrumentation and
is associated by default with all SmartPlant Instrumentation reports.
Related Topics
• Customize a Title Block in InfoMaker, page 804
• Title Block in a Multi-Tag Spec, page 802
Title Block in a Multi-Tag Spec

A multi-tag specification does not require any special procedure for associating a title
block. The software associates a title block with a multi-tag page through the spec
form that it belongs to. That is, when a multi-tag spec form has an associated title
block, this title block appears automatically on all pages of the spec. When you open
a multi-tag spec, the Multi-Tag List (see list) page appears without a title block.
However, if you open a print preview or print the specification, the software displays
the same title block on all of the spec pages.
Related Topics

Spec Title Block Common Tasks

The following tasks deal with customizing, assigning, and modifying spec title blocks
if the System Administrator, when making the current domain definitions, defined the
custom title block assignment method as Special. If the method is defined as
Standard, you only need to associate a title block with SmartPlant Instrumentation
using the Title Blocks dialog box options. Then, your Domain Administrator can
define this title block as the title block that appears in any spec you generate,
regardless of the spec form or spec type.
Customize a Title Block in InfoMaker

This procedure allows you to customize a title block using Sybase InfoMaker. After
performing this procedure, you can insert the customized report layout into
SmartPlant Instrumentation so that it becomes a custom title block. For more
information, see Customize a Title Block in InfoMaker, page 804.
Assign a Title Block to a Form

Use this procedure to assign a title block that you created or edited in InfoMaker to a
spec form. You then set the block position and size within the form. For more
information, see Assign a Title Block to a Form, page 805.
Modify a Custom Title Block

Use this procedure to modify a custom title block that you have already imported into
SmartPlant Instrumentation from a .psr file. The software automatically updates the
title block in all spec forms that use this title block. For more information, see
Modify a Custom Title Block, page 806.
Update Custom Title Blocks After Version Upgrade

After upgrading SmartPlant Instrumentation, you must manually update all of your
custom title blocks based on the title block files Tb_ora.psr, Tb_mss.psr,
Tbsample.psr. Then, you need to reassign the title blocks to your spec forms. For
more information, see Update Custom Title Blocks After Version Upgrade, page 807.
Related Topics
• Spec Title Blocks: An Overview, page 801

Customize a Title Block in InfoMaker

Note
• If, in SmartPlant Instrumentation, a Standard title block assignment
method is defined, and you use the A4 sheet size to print specifications,
you do not have to perform this procedure. Instead, you can use the title
block Specs Default TB with PB Units.psr file, that is supplied with
SmartPlant Instrumentation. However, if you want to print specs using the
Letter size, you still need to make some adjustments even to the Specs
Default TB with PB Units.psr title block.
1. Start InfoMaker and a .psr file created on the basis of one of the following files:
Tb_ora.psr (for use on Oracle), Tb_mss.psr (for use on SQL Server), or
Tbsample.psr (for use in Sybase Adaptive Server Anywhere
2. When adding other design-related items, such as internal lines, text boxes, and so
forth, to the title block, add the tb segment to the names of the new items. For
example, if you want to add a new line, name the line as <Line>_tb_<1>. This is
required to distinguish between items that belong to the title block and items that
belong to the rest of the report outside the title block.
3. Modify the report layout using the following guidelines:
• When you edit the logo field, do not change the value logo under
Name, on the General tab of the Properties dialog box. This is
crucial if you intend to use Save as Excel options of SmartPlant
Instrumentation to save specifications based on a form that
incorporates this title block.
• All the objects in the report layout, such as lines, text, field, and so
forth must be defined as the Background Layer. If you are creating a
new object, make sure you change it from the default band layer to the
Background Layer.
• Objects that appear in the report layout one below another, such as
revision rows, must be defined as Detail Band Layer.
• If you add revision rows, make sure you decrease the row height so
that the title block height is not greater than the default height of the
title block you customize. A custom title block whose height is greater
than the default height causes display problems on the Note page of a
SmartPlant Instrumentation specification.
• Do not make any changes to SQL statements.
• Do not include left or right borders since the border of the page will be
used for the title block.

• If you move any report layout items while working on the report
layout, make sure you reposition those items exactly in their original
locations.
Tips
• You cannot insert a new field in the report layout. You can only
modify existing fields.
• If you want to use the Specs Default TB with PB Units.psr in your
specs and print specs using the Letter size, we recommend that you
remove two revision rows from this title block in InfoMaker to adjust
the title block height for the Letter size.
4. Save the report layout under a different name and close InfoMaker.
Related Topics
• Spec Title Blocks: An Overview, page 801
Assign a Title Block to a Form

1. On the Specifications Module window menu bar, click Actions > Title Block
Styles.
2. On the Title Block Styles dialog box, click New.
3. On the Title Block Definition dialog box, select the appropriate .psr file, and
click OK.
Tip
• You must select a file created on the basis of one of the following
files: Tb_ora.psr (for use on Oracle), Tb_mss.psr (for use on SQL
Server), or Tbsample.psr (for use in Sybase Adaptive Server
Anywhere).
4. Under Style name, type the new title block name.
5. Under Number of revisions, accept the displayed number of revision lines.
6. Set the new title block size by using the four-directional arrows.
Tips
• The red line outlines the title block border.
• Under Units per click, type a numeric value to set how far the jump
will take the red line when clicking on one of the four-directional
arrows.
7. Click OK, and on the Title Block Styles dialog box, click Close.

8. Set the location of the title block in the specification as follows:

a. On the Specifications Module window menu bar, click Actions > Associate
Title Block.
b. On the Select Specification Form dialog box, select a form, and click OK.
c. On the Associate Title Block dialog box, under Style Name, select the title
block that you imported.
d. Under Choose location, select Detail.
e. Drag the title block to the required location in the specification page and when
done, click OK.
Related Topics
Modify a Custom Title Block

Styles.
2. On the Title Block Styles dialog box, select the title block that you want to edit,
and click Properties to open the Title Block Definition dialog box.
Tip
• If you have made any changes to the title block in InfoMaker, click
Open File, and then, select the title block .psr file and click OK.
3. Under Style name, type the new title block name if needed.
4. Under Number of revisions, set the number of revision lines to be displayed in
the title block according to the revision lines that the title block contains.
Tip
• If the number of revisions that you set is greater than the number of the
revision rows, you might have display problems in the title block.
5. Set the new title block size by using the four-directional arrows.
Tips
• The red line outlines the title block border.
• Under Units per click, type a numeric value to set how far the jump
will take the red line when clicking on one of the four-directional
arrows.
6. Click OK, and on the Title Block Styles dialog box, click Close.
Related Topics

Update Custom Title Blocks After Version Upgrade

Styles.
2. On the Title Block Styles dialog box, select a title block based on Tb_ora.psr,
Tb_mss.psr, or Tbsample.psr file, and click Properties.
3. On the Title Block Definition dialog box, click Export File, and then, save this
file as a .psr file, for example, Update.psr.
4. Close SmartPlant instrumentation, and then, in InfoMaker, open the source .psr
file, on which the Update.psr is based. For example, if the source title block file
is Tbsample.psr, you must open this file in InfoMaker. For details, see Open a
5. Redraw the title block in InfoMaker according to the Update.psr title block
requirements.
6. Save this file as Update.psr to overwrite the current Update.psr file.
7. Reopen SmartPlant instrumentation, and then, on the Specifications Module
window menu bar, click Actions > Title Block Styles.
8. On the Title Block Styles dialog box, select a title block, and click Properties.
9. On the Title Block Definition dialog box, click Open File, and then, select the
Update.psr file and click OK.
10. On the Title Block Definition dialog box, click OK, to update the title block
definition in the database and re-assign the updated title block to all the spec
forms that use it.
11. On the Title Block Styles dialog box, click Close.
Related Topics

Copying Specification Data: An Overview

The automated data copying options are useful when you need to create a number of
specifications with similar data. You can use the following sources for copying
specification data:
• Form data template— You can copy data to any spec whose form is the
same as the template form.
• Specification — You can copy data either to another spec or to a form
data template, provided that the source and target form is the same. When
you copy data to a form data template, the software does not affect data of
existing specs that are based on this template.
Data copying options are only available in the Specifications module. You cannot
copy specification data in batch mode.
You can protect all or certain fields from being overwritten when you copy
specification data. You can protect the appropriate fields in the Spec Data
Dictionary. Also, you can set preferences for copying specification data. The
following options are available on the Preferences dialog box (File > Preferences >
Specifications > General):
• Copy without overwriting existing data— Copies data to empty fields

only. This option does not overwrite data that already exists in the target
form data template or spec.
• Copy excluding blank fields in source— Copies data from source fields
except for those source fields that have no data.
• Copy all fields— Overwrites all data fields in the target form data
template or spec.
Related Topics

Copying Specification Data Common Tasks

The following tasks enable you to copy spec data from one spec to another, or to use
form data templates.
Protect Fields from Overwriting When Copying Data

Use this procedure to protect fields from overwriting of data when you copy
specification data or import data from an external spec to a spec that exists in
SmartPlant Instrumentation. You perform this procedure at the form level. The
fields that you protect for a given form apply to all new form data templates you
create for this form. For more information, see Protect Fields from Overwriting
When Copying Data, page 810.
Copy Data from One Spec to Another

Use this procedure to copy data from one spec to another. You can copy data from a
spec belonging to any plant group of the current <plant>. The source and target spec
form number must be the same. For more information, see Copy Data from One Spec
to Another, page 813.
Copy Data to a Spec from a Form Data Template

Use this procedure to automate entry of common data to your specification by using a
form data template that you created for the form upon which the current spec is based.
For more information, see Copy Data to a Spec from a Form Data Template, page
812.
Copy Data to a Form Data Template from a Spec

Use this procedure to copy a batch of data to a form data template from a
specification. This can be an efficient way of building the template, which you can
then use to transfer common data to other specs based on the same form. When you
copy data to a form data template, the software does not affect data of existing specs
that are based on this template. For more information, see Copy Data to a Form Data
Template from a Spec, page 810.
Related Topics
• Copying Specification Data: An Overview, page 808

Protect Fields from Overwriting When Copying Data

1. On the Specifications Module window toolbar, click to open the Spec Data
Dictionary.
2. On the Select Specification Form dialog box, select a form, and click OK.
3. On the toolbar, click (Properties).
4. To protect the fields in the correct form, do one of the following:
• To protect all of the fields from one or more tables, click the Tables
tab, and then, under Template Fields, click All for the appropriate
tables.
• To protect individual fields, on the Field Properties tab, in the
Template column, select the appropriate check boxes.
Related Topics
• Create and Modify a Form Data Template, page 756
Copy Data to a Form Data Template from a Spec

1. Click File > Preferences > Specifications > General.
2. Under Data copying options, select one of the following:
• Copy without overwriting existing data— Copies data to empty
fields only. This option does not overwrite data that already exists in
the target form data template.
• Copy excluding blank fields in source— Copies data from source
spec fields except for those source spec fields that have no data. This
means that if a certain field in the source spec does not have any value
or only has spaces, the software ignores this field when copying data.
• Copy all fields— Overwrites all data fields in the form data template.
A source field that only has spaces is considered blank.
Tip
their preferences. Therefore, you can find that the data copying
options are disabled. If you want to enable these options, contact your
Domain Administrator, who can manage preferences from the

3. On the Specifications Module window menu bar, module, click Edit > Form
Data Template Editor.
4. On the Select Specification Form dialog box, select a form that has a data
template, and click OK.
5. On the Select Form Data Template dialog box, select a form data template from
the list.
6. Click OK to open the form data template.
Tip
• If the form data template has fields that are not accessible, these fields
are protected in the Spec Data Dictionary. When copying data, the
software ignores protected fields. For details, see Protect Fields from
Overwriting When Copying Data, page 810.
7. On the menu bar, click Actions > Copy From.
8. On the Find Item dialog box, under Form number, select the form of the spec
you want to use for copying data, and click Find.
9. Under Search results, select the item whose spec you want to use as a source for
copying data.
10. Click OK to copy the spec data.
Related Topics

Copy Data to a Spec from a Form Data Template

the target spec.
• Copy excluding blank fields in source— Copies data from template
fields except for those template fields that have no data. This means
that if a certain field in the form data template fields does not have any
value or only has spaces, the software ignores this field when copying
data.
• Copy all fields— Overwrites all data fields in the spec. A source
field that only has spaces is considered blank.
Tip
3. In the Specifications module, open the spec to which you want to copy data.
4. On the menu bar, click Actions > Copy from Template.
5. On the Select Form Data Template dialog box, select a form data template from
the list.
6. Click OK to copy the data from the selected form data template to the
specification.
Related Topics

Copy Data from One Spec to Another

the target spec.
• Copy excluding blank fields in source— Copies data from source
spec fields except for those source spec fields that have no data. This
means that if a certain field in the source spec does not have any value
or only has spaces, the software ignores this field when copying data.
• Copy all fields— Overwrites all data fields in the target spec. A
source field that only has spaces is considered blank.
Tip
3. In the Specifications module, open the spec to which you want to copy data.
4. On the menu bar, click Actions > Copy from Specification.
5. On the Find Item the dialog, under Form number, select the form upon which
your specification is based, and click Find.
6. Under Search results, select the item whose specification you want to use as a
source for copying data.
Tip
• When you copy data to a spec, be careful when overwriting existing
data. In the Spec Data Dictionary, you can define fields that you do
not want to overwrite. For more details, see Protect Fields from
Overwriting When Copying Data, page 810.
7. Click OK to copy the data.
Related Topics

Spec Revisions: An Overview

You use revisions to keep track of changes in your specifications. If the Domain
Administrator has set the software to archive revisions, you can view, print, and
compare previous revisions of specifications with the current versions.
You can manage spec revisions in the following ways:
• Locally — managing revisions that belong to a currently open spec.

When managing revisions locally, you open a particular spec and then
open the Revisions dialog box, where you can add, edit, or delete current
spec revisions. In this dialog box, when you first select a revision
numbering method, several options are available to you, including
preliminary revisions (designated by P0, P1, P2…). After you select one
of the other revision methods, you can no longer return to the preliminary
revision method and this option becomes disabled. When using
SmartPlant Foundation revisions, the revision numbering methods are not
available for selection. Only the last five revisions appear in the
Revisions dialog box or in the spec title block.
• Globally — managing revisions that belong to any number of existing
specs. You do not need to open the Specifications module to manage
revisions globally, only the Global Revisions dialog box. Also, if you
want to view all revisions belonging to all existing specs, in the
Specifications module, you need to click Actions > Manage Spec
Revisions. If you want to print out revisions belonging to various specs,
you can click Actions > Spec Revisions.
In the Specifications module, you cannot revise instrument specifications that you
assigned to a Specification Binder package in the Document Binder module.
Therefore, the software prevents you from adding new revisions to these specs, or
delete these spec revisions.
Related Topics
• Revision and Data Comparison Common Tasks, page 815

Revision and Data Comparison Common Tasks

The following tasks deal with managing spec revisions and comparing spec data.
Manage Spec Revisions Locally

Use this procedure to add, edit, and delete specification revisions locally. For more
information, see Manage Spec Revisions Locally, page 816.
Manage Spec Revisions Globally

Use this procedure to maintain specification revisions in batch mode, using global
revision options. For more information, see Manage Spec Revisions Globally, page
817.
View and Print Spec Revisions

Use this procedure to view and print archived revisions belonging to existing specs.
By default, the dialog box displays all archived revisions in the more <plant>. For
more information, see View and Print Spec Revisions, page 818.
Compare Current Data with a Saved Revision

Use this procedure to compare data in the current specification with a specification
that was archived as a previous revision. This option enables you to generate a report
that shows the data changes. You can also set fonts and color to display the changes.
For more information, see Compare Current Data with a Saved Revision, page 818.
Compare Current Data with a Saved Spec

Using this option you can compare data in the current specification with a
specification that you saved as an .isf file. This option enables you to generate a
report that shows the data changes. You can also set fonts and color to display the
changes. For more information, see Compare Current Data with a Saved Spec, page
819.
View Data History

SmartPlant Instrumentation can indicate specification data changes by comparing
current data with the data stored in the audit trail repository for the date range that
you specify. You can set a color to mark changes, set a shade of gray to emphasize
the changed data in printed reports and their previews, and also set bold and italic font
style for emphasis on the screen and in print. History indication is available only if
the System Administrator has activated the audit trail functionality. When the audit
trail functionality is activated, each time that you save data after making changes, the
data is recorded in the audit trail repository. For more information, see View Data
History, page 820.

Change Storage Method of Specification Revisions

Use this procedure to convert specification revisions from one storage format to
another. By default, the software stores spec revisions in the database and
compresses the revision data automatically to save space. You can save revisions to
the SmartPlant Instrumentation database or as external .psr files, or compress them
and save as a single .zip file. You can only perform this procedure after the Domain
Administrator, in the Report Management dialog box, specifies the folder for saving
spec revisions as .psr or .zip files. Saving revisions in .zip or .psr format is useful
when you have made a large number of revisions, and want to reduce the size of your
database. For more information, see Change Storage Method of Specification
Revisions, page 821.
Delete Spec Revisions

Use this procedure to delete one or more spec revisions in batch mode. You can
select and delete revisions that belong to different specs. For more information, see
Delete Spec Revisions, page 822.
Related Topics
• Spec Revisions: An Overview, page 814
Manage Spec Revisions Locally

1. Open a spec.
• Click Actions > Revisions.
3. In the Revisions dialog box, select one of the revision numbering methods (use
P0, P1, P2... for preliminary revisions or 0, 1, 2 /A, B, C, and so forth for normal
serial revisions).
Tips
• When you first select a revision numbering method, several options
are available to you, including preliminary revisions (designated by
P0, P1, P2…). After you select one of the other revision methods, you
can no longer return to the preliminary revision method and this option
becomes disabled.
• When working with revisions in an integrated environment, the
revision numbering methods are not available for selection.
• Only the last five revisions appear in the Revisions dialog box, or in
the revision title block. To view all revisions of the current spec, click
Actions > Compare with Revision.

4. Click New to add new revision data or update the existing data as desired.
Tips
• SmartPlant Instrumentation automatically adds a new line with the
next logical character and date each time you click New after you
select the initial method.
5. Add or edit the revision data in the appropriate boxes.
Tip
• The By box contains the current user's initials by default, if previously
defined by the System Administrator in the Administration module.
You can also edit this setting if required.
6. To delete revisions locally you no longer require, select the revisions and click
Delete.
Related Topics
Manage Spec Revisions Globally

1. In the main SmartPlant Instrumentation window, click Tools > Global
Revisions.
2. On the Settings tab, under Activity, do one of the following:
• Select Add Revision to add revisions to instrument tags without
checking the current revision settings.
• Select Upgrade Revision to add revisions to instrument tags
according to defined criteria.
3. Enter the required revision information.
4. Click the Specifications tab.
5. Select all or particular specs that you want to revise.
Tips
• To select multiple specs, use the Shift or Ctrl key.
• Multi-tag specs only appear at the end of the list when you select the
Select all check box. The Tag Number box displays the text SEE
LIST with the number of the master tag enclosed in parentheses.

6. Click Apply to add the revisions to the specs of the selected instrument tags.
Tips
• If any of the specs selected for revision is assigned to a Specification
Binder package, that spec does not undergo a revision and the software
displays an appropriate message. Afterwards, a list of the specs that
were not revised is displayed, and the reason appears in the Comment
field.
• You can click Print to print the list of specs for which the revision
failed, or click Save As to save the list to a file. These buttons appear
after the software could not revise certain specs.
Related Topics
View and Print Spec Revisions

1. In the Specifications module, click Actions > Spec Revisions.
2. Under Revision filter, define filter parameters as needed and then select Apply.
Tips
• By default, the dialog box displays all archived revisions in the
<plant>. You can select a specific plant group to filter the revisions
accordingly. To revert to the default display, in the Plant group box,
select the empty row. Also, you can filter revisions by spec form
number, or type a specific number in the Revision box.
• You can also search for a revision by tag number or document number
by entering the appropriate values under Find.
3. In the data window, select one or more revisions that you want to view or print
out, and click OK.
Related Topics
Compare Current Data with a Saved Revision

1. Open a spec.
2. Click Tools > Data Comparison Display Options and set font and color settings
for comparison as you require.
3. On the Actions menu, click Compare with Revisions to open a dialog box with a
list of available revisions for the current spec.
4. Select a revision and click OK.

5. In the dialog box that opens, click Yes to preview the report, or No to print the
report without previewing.
Tips
• If you clicked Yes to preview the report, close the preview window to
see the specification with the changes indicated.
• The report shows the names of the columns that were changed: Spec
Report Value shows the current data, and External Spec Value
shows external file data.
• SmartPlant Instrumentation displays your specification with changed
fields indicated according to your settings in the Data Comparison
Display Options dialog box.
Related Topics
Compare Current Data with a Saved Spec

1. Open a spec.
2. Click Tools > Data Comparison Display Options and set font and color settings
for comparison as you require.
3. On the Actions menu, click Compare with External.
4. In the Select File for Comparison dialog box, navigate to the required .isf file
and click OK.
5. In the dialog box that opens, click Yes to preview the report, or No to print the
report without previewing.
Tips
• If you clicked Yes to preview the report, close the preview window to
see the specification with the changes indicated.
• The report shows the names of the columns that were changed: Spec
Report Value shows the current data, and External Spec Value
shows external file data.
• SmartPlant Instrumentation displays your specification with changed
fields indicated according to your settings in the Data Comparison
Display Options dialog box.
Related Topics

View Data History

Note
• History indication is available only if the System Administrator has
activated the audit trail functionality. When the audit trail functionality is
activated, each time that you save data after making changes, the data is
recorded in the audit trail repository.
1. Open a spec.
2. Click Options > History Options.
3. Do one of the following to select the date range for data history comparison:
• In the From and To boxes, type the appropriate dates or use the
spinners.
• To set the To data field value as today's date, click Today.
4. To set a font style to emphasize changes on the screen and in print, select Bold or
Italic, or both check boxes.
5. To change the color used to display changes on the screen, do the following:
b. On the Color dialog box, choose the color that you require.
dialog box.
and their previews, do the following:
b. On the Grayscale dialog box, slide the bar to the required position.
c. Click OK to save your new grayscale settings and return to the History
Options dialog box.
dialog box.
8. On the Options menu, click Mark Changes to mark changes in the current
specification for the dates that you specified in the History Options dialog box.
Tips
• To refresh the history indication in an open specification, on the
Options menu, clear Mark Changes and then select this option again.
• The software does not mark changes in a spec note, or in a large note
page.
Related Topics

Change Storage Method of Specification Revisions

1. Open the Specifications module.
2. On the Actions menu, click Manage Spec Revisions.
Tip
• To display specifications of one revision only, under Revision filter,
type the revision number and click Apply
3. Under Select spec revisions, select one or more revisions whose storage method
you want to change.
4. Under Change storage method, do one of the following:
• Select PSR files to save each revision as an external .psr file in the
location specified in the Administration module. This option is only
available after the Domain Administrator, in the Report Management
dialog box, specifies the folder for saving spec revisions as .psr or .zip
files.
• Select ZIP file to save all the selected revisions as a single external
.zip file in the location specified in the Administration module. This
option is only available after the Domain Administrator, in the Report
Management dialog box, specifies the folder for saving spec revisions
as .psr or .zip files.
• Select Database to save the revision to the SmartPlant Instrumentation
database. For this option, the data is automatically compressed to save
disk space.
5. Click Change method.
Related Topics
• Spec Revisions: An Overview, page 814

Delete Spec Revisions

1. In the Specifications module, click Actions > Manage Spec Revisions.
2. Filter revisions as you require.
Tip
• If you want to display revisions defined for all specs that exist in all of
your plant groups, under Plant group, select the empty row.
3. Select one or more revisions.
4. Click Delete.
Tip
• When you delete a revision, the software does not delete the spec
itself. Deleting a spec, however, always deletes all of the spec
revisions automatically.
Related Topics

Save, Export, and Import Options: An Overview
Save, Export, and Import Options: An

Overview
SmartPlant Instrumentation supports saving spec data in the following formats:
• .isf (only specs whose item type is Instrument)

• .psr (any single-tag spec, multi-tag spec, or a non-instrument spec)
• .xls (only specs whose item type is Instrument)
To edit a specification in an external application, you need to save the specification in
a format that the external application supports. You can export specifications
individually or in batch mode. You can export specification data to the following
specifications:
• External Editor (supplied with the SmartPlant Instrumentation software

package) — Supports working with spec data saved in .isf format, allows
you to convert .psr files to .isf format, and import data from .isf files to
• InfoMaker — Supports working with spec data saved in .psr format, does
not allow you to import data from .psr files. You first need to convert .psr
files to .isf format in External Editor.
• Excel — Supports working with spec data saved in .xls format., does not
allow you to import data from Excel files back to SmartPlant
Instrumentation.
Related Topics
• Save as Excel: An Overview, page 831

Save, Export, and Import Options Common Tasks

Use the following tasks to save specs in .isf, .psr, or .xls format one by one or in batch
more. Also, these tasks enable you to import data to specs using External Editor.
Save a Spec in PSR Format

Use this procedure to save a single specification in .psr format for opening in
InfoMaker. You cannot work with .psr files in External Editor. However, in External
Editor, you can then convert .psr files to .isf format, and edit the specification data as
you require. For more information, see Save a Spec in PSR Format, page 825.
Save an Instrument Spec in ISF Format

Use this procedure to save an instrument specification document in .isf format so that
you can open it in External Editor, which is supplied with SmartPlant
Instrumentation. You can use External Editor to view and edit specifications. After
editing, you can import the changed data back into your specs in SmartPlant
Instrumentation. For more information, see Save an Instrument Spec in ISF Format,
page 826.
Save Instrument Specs in Batch Mode

Use this procedure to save a group of selected instrument specifications. You can
save a batch of instrument specs either as .psr files or .isf files. If you choose to the
.psr format, you can then open the .psr files in InfoMaker. Saving specs in .isf format
allows you to edit the specs in External Editor, which is supplied with SmartPlant
Instrumentation. For more information, see Save Instrument Specs in Batch Mode,
page 826.
Save an Instrument Spec in Excel Format

Use this procedure to save a currently open instrument specification in Excel format.
For more information, see Save an Instrument Spec in Excel Format, page 827.
Batch Save of Instrument Specs in Excel Format

Use this procedure to select a group of instrument tags and save their specifications in
Excel format. For more information, see Batch Save of Instrument Specs in Excel
Format, page 827.
Protect Fields Before Exporting Specs to External Editor

Use this procedure to protect all or specific fields whose values you do not want to be
available for editing in External Editor. After you save the spec as an .isf file, and
open it in External Editor, the fields that you protected appear as view-only. For
more information, see Protect Fields Before Exporting Specs to External Editor, page
828.

Import Data to a Specification from an External File

Use this procedure to import data from an external specification file in .isf format to
the current specification. If the format of the external specification is .psr, you can
use External Editor to convert the files to .isf format. The external specification must
be based on the same form as the target specification. If you attempt to copy data
from a specification based on a different form, the software displays an appropriate
message. For more information, see Import Data to a Specification from an External
File, page 829.
Import Data to Instrument Specs in Batch Mode

You can import data from external files to instrument specifications in batch mode.
You need to specify a source file folder and then select the .isf files from which you
want to import data. The software imports data to instrument specifications by
matching the tag numbers in the source .isf files and target specifications that exist in
SmartPlant Instrumentation. SmartPlant Instrumentation does not support importing
data in batch mode to multi-tag (see list) specs. For more information, see Import
Data to Instrument Specs in Batch Mode, page 830.
Related Topics
• Save, Export, and Import Options: An Overview, page 823
Save a Spec in PSR Format

1. Open a specification.
2. Click Actions > Save As.
3. Select Original, and click OK.
4. In the dialog box that opens, under Save as type, select PowerSoft Report (PSR)
format (*.PSR).
5. Select the folder where you want to save the files, type the name of the target .psr
file, and click Save.
Related Topics

Save an Instrument Spec in ISF Format

1. Open an instrument specification that you want to save in .isf format.
2. Click Actions > Export Data.
3. In the Save to File dialog box, select the folder where you want to save the files.
4. Enter the target file name, and click Save.
Note
• SmartPlant Instrumentation does not support saving non-instrument
specifications in .isf format.
Related Topics
Save Instrument Specs in Batch Mode

1. Open the Specifications module, and click Actions > Save as Files.
2. In the Save as Files dialog box, under Select file format, do one of the following:
• Select ISF to save the files in .isf format for opening in External
Editor.
• Select PSR to save the files in .psr format for opening in InfoMaker.
3. Click Browse.
4. In the Select Folder dialog box, specify a desired folder, and click Save.
5. Click Find.
6. In the Find Items dialog box, define search parameters as you require and click
Find to display a list of tags according to the search parameters.
7. Select one or more tags and click OK to return to the Save as Files dialog box.
8. In the Save as Files dialog box, click OK.
Note
• Saving specifications as .psr or .isf files in batch mode is only available
when the specification item type is Instrument.
Related Topics

Save an Instrument Spec in Excel Format

1. Open an instrument specification.
2. Click Actions > Save as Excel.
Tip
• In the generated Excel files, graphic elements within title blocks
display as designed. SmartPlant Instrumentation does not support
export of other graphic elements to Excel format.
Related Topics
• Batch Save of Instrument Specs in Excel Format, page 827
Batch Save of Instrument Specs in Excel Format

1. In the main window of the Specifications module, click Actions > Save as Excel.
2. In the dialog box that opens, find specs that you want to save in Excel format.
3. In the Search results data window, select the instrument tags whose specs you
want to save in Excel format.
Tips
• After you install a new SmartPlant Instrumentation version or service
pack, if you previously saved specifications in Excel format, rename
the previous result files or move them from the target folder. You can
change the default settings for the target folder, on the Preferences >
Specifications > Save as Excel tab.
• If you previously saved specs in Excel format, and do not want to
overwrite existing result files, you should rename the previous files or
move them from the target folder.
• If you previously saved multi-tag specifications in Excel format and
then made changes to the format upon which these specifications are
based, you should rename the previous result files or move them from
the target folder before exporting further specifications based on that
format.

4. Click OK to start exporting the spec data to Excel.

Tips
• In the generated Excel files, graphic elements within title blocks
display as designed. SmartPlant Instrumentation does not support
export of other graphic elements to Excel format.
• Specifications sharing a common form are saved in a common Excel
file. For example, specs based on form 11 might be saved in file
T_Form11_0.xls. To set the preferences to create an individual Excel
file for each spec, on the Preferences > Specifications > Save as
Excel tab, under Saving method, select Separate file for each tag.
Related Topics
• Save an Instrument Spec in Excel Format, page 827
Protect Fields Before Exporting Specs to External Editor

1. On the Specifications module toolbar, click to open the Spec Data
Dictionary.
2. In the Select Specification Form dialog box, select the form for which you want
to set field protection, and click OK.
3. On the Spec Data Dictionary toolbar, click to open the Field Properties tab.
• To protect individual fields, on the Column Headers tab, under
Editable in IEE, clear the check boxes for the fields you want to
protect.
•To protect all of the fields belonging to a given database table, click
the Tables tab, and then, under Editable in IEE, click No.
Note
• You perform this procedure at the form level. This means that the fields
that the field protection applies to any instrument specification based on
this form. Field protection does not apply to existing specs saved as .isf
files.
Related Topics

Import Data to a Specification from an External File

Important
• When you importing data to an existing spec, the software can overwrite
existing data. To prevent all automated overwriting of existing
specification data, in the Preferences dialog box, under Data copying
options, select Copy without overwriting existing data. Also, in the
Spec Data Dictionary, you can set fields as unavailable for editing in the
form data template or in specs based on the current form.
1. Open a specification in the specifications module.
2. Click Actions> Import Data.
3. In the Open File dialog box, select the source .isf file.
4. Click Open to import the data from the source file to the specification.
Tip
• If the imported data includes manufacturers and models that do not
appear in the Instrument Manufacturer or Instrument Model supporting
tables, the software automatically adds them during the import
process.
5. Edit the specification as necessary and then click to save the changes.
Related Topics

Import Data to Instrument Specs in Batch Mode

1. In the Specifications module, click Actions > Import Data.
2. Beside Source folder, click Browse to specify the folder where the source .isf
files are located.
Tip
• In the Log file name and path box, the software displays the default
path of the log file IMPORT_ISF.LOG. SmartPlant Instrumentation
creates this file after importing data. If you previously imported data,
this log file already contains records of the previous import session. If
you do not change the log file path for the current import session, the
software adds new records of the current import session in the same
file. To create a new file IMPORT_ISF.LOG, you can click Browse
and specify a different log file path.
3. Under Select source files, select the desired .isf files.
Tips
• When you importing data to an existing spec, the software can
overwrite existing data. To prevent all automated overwriting of
existing specification data, in the Preferences dialog box, under Data
copying options, select Copy without overwriting existing data.
Also, in the Spec Data Dictionary, you can set fields as unavailable
for editing in the form data template or in specs based on the current
form.
• If you select Ignore form ID in database, the software imports data
into specifications even when in the source and target specifications,
the internal ID numbers of the specification form are different.
4. Click Import.
Related Topics

Save as Excel: An Overview

You can use SmartPlant Instrumentation Save as Excel options to save specifications
in Microsoft Excel format. You can then use any of the Excel functionalities to edit
the exported specifications. The software allows you to save all specs that share a
common spec form to a single Excel file. For example, you can save specifications
based on form 11 in file T_Form11_0.xls. If needed, you can set the Save as Excel
preferences so that you can create an individual Excel file for each specification. The
default target folder is <SmartPlant Instrumentation home
folder>\SaveAsExcel\ResultFiles. You can specify a different path and folder by
changing the Save as Excel preferences.
The Excel workbook opens displaying the specification with the lowest tag number.
If the file that you opened contains multi-page specs, each page is displayed on a
separate Excel worksheet. If you exported multi-tag specifications, the multi-tag list
is displayed on the Excel See List worksheet. The notes are displayed on the Excel
Notes worksheet.
Note
• In Excel XP, you need to set macro security to Medium.
Supported Spec Types
You can only use Save as Excel options with specs whose item type is Instrument
(single-tag or multi-tag specs). SmartPlant Instrumentation does not support Save as
Excel options for specs whose item type is other than instrument, or whose form
contains page sections.
Note
• If you previously saved multi-tag specifications in Excel format and then
made changes to the format upon which these specifications are based,
you should rename the previous result files or move them from the target
folder before exporting further specifications based on that format.
Font Style
Regardless of the font of the original specification, SmartPlant Instrumentation
selects the Arial font in the Excel target file.
Graphics and Other Embedded Objects

In general, graphic elements within title blocks like those in library forms display as
designed when saved for Excel. SmartPlant Instrumentation does not support export
of other graphic elements to Excel format. SmartPlant Instrumentation does not
support export of embedded objects to Excel, for example, equations.
Related Topics
• Save as Excel Troubleshooting, page 842

Customizing Specs for Save as Excel Common

Tasks
Before you save a specification in Excel format, you need to check the source spec
for elements that can cause various display problems in Excel. The following topics
describe how to customize your spec page to avoid display some of possible displays
problems in Excel.
Guidelines for Customizing Pages for Save as Excel

In general, specs based on SmartPlant Instrumentation library pages export accurately
to Excel. However, if you want to save specs in Excel format, you might need to
familiarize yourself with the following guidelines, that enable you to fine-tune you
spec pages and save specs accurately in Excel format. After you create forms and
specifications based on such pages, you can then save these specs accurately in Excel
format. For more information, see Guidelines for Customizing Pages for Save as
Excel, page 834.
Guidelines for Customizing PSR Files for Save as Excel

In general, specs based on SmartPlant Instrumentation library pages export accurately
to Excel. When you customize .psr pages in InfoMaker, use these guidelines for
compatibility with Excel. After you import such pages into SmartPlant
Instrumentation, include them in a form, and generate specs based on this form, you
can then save these specs accurately in Excel format. For more information, see
Guidelines for Customizing PSR Files for Save as Excel, page 836.
Create an Invisible Vertical Zero Line

Use this procedure to open a spec page in InfoMaker and create an invisible vertical
grid line for which the X values are 0. If a form upon which specifications are based
contains vertical fields, it must fulfill one of the following two conditions for correct
export to Excel:
• The X values of the left-hand vertical grid line must be 0.

• You create an invisible line for which the X values are 0.
Modifying a form to fulfill either of these conditions can also improve the display of
other features, for example, select lists. For more information, see Create an
Invisible Vertical Zero Line, page 838.

Replace Double Lines with Thick Single Lines

There are several situations in which a particular choice of line elements within a
form yields non-standard Excel spreadsheets following a Save as Excel operation.
Use this procedure if your specification is based on a form that contains double grid
lines. Use of double lines instead of single thick lines can cause a display problem in
Excel. For more information, see Replace Double Lines with Thick Single Lines,
page 839.
Correct a Line Discontinuity

In general, a spec page is divided into three side-by-side components — parameter
categories, field headers, and field values. For correct translation to Excel, perform
this procedure so that a horizontal row line that spans more than one vertical
component becomes a continuous line rather than separate lines with imprecise
continuity. For more information, see Correct a Line Discontinuity, page 839.
Correct Horizontal and Vertical Divergence of Grid Lines

Use this procedure to correct horizontal and vertical divergence of grid lines. Lines
that are not exactly horizontal or lines that are not exactly vertical can be sources of
display problems when you save SmartPlant Instrumentation specifications in Excel
format. For more information, see Correct Horizontal and Vertical Divergence of
Grid Lines, page 840.
Set Value Display Precision for Save as Excel Globally

Use this procedure to set the number of decimal digits that you want to display in the
Excel cells after saving specs in Excel format. The default global Save as Excel
precision is two decimal places. In general, process data and calculation values that
SmartPlant Instrumentation stores in the database are of greater precision than the
values that Excel displays in the cells of generated specs. You perform this procedure
in SmartPlant Instrumentation. For more information, see Set Value Display
Precision for Save as Excel Globally, page 840.
Set Value Display Precision for Individual Fields

Use this procedure to override the global precision for individual fields in a particular
spec page. In general process data and calculation values that SmartPlant
Instrumentation stores in the database are of greater precision than the values that
Excel displays in the cells of generated specs. When you save a specification as an
Excel file, SmartPlant Instrumentation reformats the display precision for Excel. The
default global Save as Excel precision is two decimal places. You perform this
procedure in InfoMaker. For more information, see Set Value Display Precision for
Individual Fields, page 841.
Related Topics

Guidelines for Customizing Pages for Save as Excel

Graphic Limitations of the Excel Environment
The Page Editor of SmartPlant Instrumentation allows you freedom in designing
specification pages, with few limitations on the layout of data fields, fields with
computed values, text fields, and lines. But when designing pages for Excel
compatibility, it is important to keep in mind that an Excel worksheet is basically a
grid of cells. Although a standalone Excel spreadsheet supports random placement of
text, value, and line objects, Save as Excel works best if you imagine an Excel grid
underlying your page.
Fine-Tuning the Grid and Lines

Although you can use the mouse to create and place lines, you must fine-tune the grid
by referring to the Line Position pop-up window for each line object. After you set
the major lines of the page grid, you can insert database fields, computed fields, text
fields, and lines. Verify the following:
• All lines are either exactly vertical lines or exactly horizontal.

• For every vertical line, BeginX = EndX.
• For every horizontal line, BeginY = EndY.
• Left/right external border lines share common BeginY (top) and EndY
(bottom) values.
• Top/bottom external border lines share common BeginX (left end) and
EndY (right end) values.
• When one line ends by running into another, make sure that they share an
X value or a Y value. This prevents overshooting and undershooting.
• Create as much of the grid as possible before creating text and value
objects.
• Although there is no requirement for every line to run the entire length or
width of the page, imagine an Excel grid underlying your page. For
example, if you inserted a vertical line near the top of the page at X = 500
PBU, if your mouse placement of a vertical line near the bottom of the
page ended up at X = 505, make the X values consistent for both lines.
• Similarly, if you inserted a horizontal line towards the left of the page at Y
= 700 PBU, if your mouse placement of a horizontal line towards the right
of the page ended up at Y = 705, make the Y values consistent for both
lines.

Left-Aligning Fields to Lines

During the process of export from SmartPlant Instrumentation to Excel, the software
associates each field with a vertical line to the left of the field. To display the lines
accurately, make sure the BeginX value of a field should equal the X values of the
line to its left.
Fine-Tuning Adjacent Fields

• To prevent text cut-off, leave at least 5 PBU between adjacent fields. The
requirement to left-align fields to lines also applies to fields to the right of
other fields.
• For multiple fields between horizontal lines, set constant BeginY and
EndY values for all of the fields. The BeginY value should be several
PBU greater than the Y values of the line above, and the End2 value
should be several PBU less than the Y values of the line below.
Related Topics
• Customizing Specs for Save as Excel Common Tasks, page 832
• Guidelines for Customizing PSR Files for Save as Excel, page 836

Guidelines for Customizing PSR Files for Save as Excel

Graphic Limitations of the Excel Environment
InfoMaker allows you to modify existing SmartPlant Instrumentation spec pages,
with few limitations on the layout of text, value, line, and other objects. When
designing InfoMaker pages for Excel compatibility, it is important to keep in mind
that an Excel worksheet is basically a grid of cells. Although a standalone Excel
spreadsheet supports random placement of text, value, and line objects, Save as Excel
works best if you imagine an Excel grid underlying your InfoMaker page. You
cannot create an entirely new page in InfoMaker.
Fine-Tuning the Grid and Lines

Although you can use the mouse to create and place lines, you must fine-tune the grid
by referring to the Properties > Position tab for each line object. Verify the
following:
• All lines are either exactly vertical lines or exactly horizontal.

• For every vertical line, X1 = X2.
• For every horizontal line, Y1 = Y2.
• Left/right external border lines share common Y1 (top) and Y2 (bottom)
values.
• Top/bottom external border lines share common X1 (left end) and X2
(right end) values.
• When one line ends by running into another, make sure that they share an
X value or a Y value. This prevents overshooting and undershooting.
• Create as much of the grid as possible before creating text and value
objects.
• Although there is no requirement for every line to run the entire length or
width of the page, imagine an Excel grid underlying your InfoMaker page.
For example, if you inserted a vertical line near the top of the page at X =
500 PBU, if your mouse placement of a vertical line near the bottom of the
page ended up at X = 505, make the X values consistent for both lines.
• Similarly, if you inserted a horizontal line towards the left of the page at Y
= 700 PBU, if your mouse placement of a horizontal line towards the right
of the page ended up at Y = 705, make the Y values consistent for both
lines.

Left-Aligning Fields to Lines

After you set the major lines of the page grid, you can insert data fields and field
headers, computed fields, fields displayed as select lists, check boxes, or option
buttons. During the process of export from SmartPlant Instrumentation to Excel, the
software associates each field with a vertical line to the left of the field. To ensure
accurate display, the X1 value of a field should equal the X values of the line to its
left. The following lines are acceptable:
• A visible vertical line on the left edge of the field

• A visible vertical line, with X value equal to the X1 value of the field, but
on a higher or lower part of the page
• A vertical grid line, with X value equal to the X1 value of the field, and on
the Properties > General tab, the Visible check box is cleared. Even for
such an invisible line, imagine an Excel grid underlying your InfoMaker
page. For example, if you inserted an invisible vertical line in one part of
the page at X = 500 PBU, if your field placement at another part of the
page ended up at X1 = 505, make the X values consistent for both lines.
For each invisible line, make sure that the icon to the right of Visible is
displayed as . If the icon is displayed as , click it, and in the dialog
box that opens, delete the contents of the Expression pane, and then click
OK.
Fine-Tuning Adjacent Fields
• To prevent text cut-off, leave at least 5 PBU between adjacent fields. The
requirement to left-align fields to lines also applies to fields to the right of
other fields.
• For multiple fields between horizontal lines, set constant Y1 and Y2
values for all of the fields. The Y1 value should be several PBU greater
than the Y values of the line above, and the Y2 value should be several
PBU less than the Y values of the line below.
Related Topics
• Guidelines for Customizing Pages for Save as Excel, page 834

Create an Invisible Vertical Zero Line

1. In SmartPlant Instrumentation, save the spec page as a .psr file and then open the
.psr file in InfoMaker. For details, see Open a Spec Page in InfoMaker, page 729.
2. On the menu bar, click Insert > Control > Line.
3. On the General tab of the Properties dialog box, do the following:
a. Under Name, type l_coordinator.
b. Clear the Visible check box.
4. Make sure that the icon to the right of Visible is displayed as . If the icon is
displayed as , click it, and in the dialog box that opens, delete the contents of
the Expression pane, and then click OK.
5. On the Position tab, type the following settings:
a. X1: 0
b. Y1: 0
c. X2: 0
d. Y2: Type a value equal to or greater than the highest Y2 value on the form.
6. On the menu bar, click File > Save.
7. Import the page back into SmartPlant Instrumentation.
8. Regenerate the spec page and specification, and save the specification again in
Excel format.
Related Topics
• Open a Page from an External File, page 708
• Save a Page as an External File, page 710

Replace Double Lines with Thick Single Lines

2. Click the duplicate line, and then press the Delete key.
3. Right-click the remaining line, and on the shortcut menu click Properties.
4. On the General tab of the Properties dialog box, under Pen Width, use the
spinners to set the new width of the line.
Excel format.
Related Topics
Correct a Line Discontinuity

2. Right-click the right-most line segment, and on the shortcut menu, click
Properties.
3. On the Position tab, under X2, copy the value to the Clipboard, using a standard
Microsoft shortcut (for example, Ctrl+C).
4. For each line segment to the right of the left-most segment, click the line segment,
and then press Delete.
5. Right-click the left-most line segment, and on the shortcut menu, click
Properties.
6. On the Position tab, under X2, paste the Clipboard value, using a standard
Microsoft shortcut (for example, Ctrl+V).
Excel format.
Related Topics

Correct Horizontal and Vertical Divergence of Grid Lines

2. To correct a horizontal divergence, do the following:
a. Right-click the divergent line, and on the shortcut menu click Properties.
b. On the Position tab of the Properties dialog box, set the value under X1
equal to the value under X2.
3. To correct a vertical divergence, do the following:
a. Right-click the divergent line, and on the shortcut menu click Properties.
b. On the Position tab of the Properties dialog box, set the value under Y1
equal to the value under Y2.
Excel format.
Related Topics
Set Value Display Precision for Save as Excel Globally

1. In SmartPlant Instrumentation, click File > Preferences > Specifications > Save
as Excel.
2. Under Accuracy level, enter the number of decimal digits that you want to
display in specs you save in Excel format.
3. Regenerate the Excel files for specs that you require.
Tips
• If you want to set value display precision for a specific field, you need
to open the spec page in InfoMaker, and then reformat the appropriate
field as needed. For details, see Set Value Display Precision for
Individual Fields, page 841.
• You can also reformat individual fields in the Excel sheet, setting the
appropriate number of decimal places. However, you need to reformat
these fields each time after saving this SmartPlant Instrumentation
specification in Excel format.
Related Topics

Set Value Display Precision for Individual Fields

2. For each field that you want to format, do the following to set the number of
decimal places that are displayed in SmartPlant Instrumentation and later in
Excel:
a. Click in the field.
b. On the Format tab of the Properties dialog box, under Format, type 0.
followed by pound signs (#) to indicate the required number of decimal
places. For example, 0. indicates no decimal places, 0.# indicates one decimal
place, 0.### indicates three decimal places, and so forth.
3. On the menu bar, click File > Save as File.
4. On the Select File Name dialog box, type the file name that you require.
Excel format.
Related Topics

Save as Excel Troubleshooting

After saving a specification in Excel format, scan the resulting file for display errors.
The following list describes how to troubleshoot some of the possible errors. .
Resolve Spec Accessing Problem in a Common Excel File

Use this procedure to be able to access every spec successfully after saving multiple
specs in a common Excel file. The procedure deals with changing Excel macro
security to Medium. If you are running Excel XP, macro security is set to High by
default. For more information, see Resolve Spec Accessing Problem in a Common
Excel File, page 844.
Remove the Protection from a Spec Saved as Excel

Use this procedure to remove the protection from a spec; For more information, see
Remove the Protection from a Spec Saved as Excel, page 845.
Resolve a Data Saving Problem

Use this procedure if you receive an error message stating that you "cannot save
data... incorrect syntax" when you try to save specs in Excel format. This problem
can occur if your specifications are based on pages arranged with the text headers
above the fields, rather than in separate vertical groupings. You can use a headers-
above-fields style, and avoid the error message by editing the x-coordinates of either
the text headers or the fields to creating microscopic misalignment. This procedure
deals with editing the text headers. After editing in InfoMaker, your pages can
support specifications that you save in Excel format. For more information, see
Resolve a Data Saving Problem, page 845.
Resolve Grid Line Overlap Problems

This topic provides a solution you need to implement in InfoMaker when labels and
values overlap lines above or below. For more information, see Resolve Grid Line
Overlap Problems, page 845.
Correct Undershooting and Overshooting of Grid Lines

Use this procedure to correct grid line display problems caused by correcting
imperfect meeting of the outermost grid lines in the source spec page. You can use
this procedure to correct undershooting, when the lines do not meet, and
overshooting, when at least one of the lines extends beyond the meeting point. For
more information, see Correct Undershooting and Overshooting of Grid Lines, page
846.
Prevent Truncation of Labels and Values

This topic provides a troubleshooting solution you need to implement in InfoMaker
when the right end of labels and values is displayed cut off. For more information,
see Prevent Truncation of Labels and Values, page 847.

Fix Displaced Labels

When you save specifications in Excel format, you may find displaced labels in the
categories column — by default at the left of the page — or in the title block. This
problem can be caused by lack of coordination between the SmartPlant
Instrumentation spec page upon which the specification is based and the row division
in the Excel spreadsheet. You have two options to assign the displaced label to a
row: extend an existing horizontal line to pass above or below the displaced label, or
normalize label coordinates, which you do by assigning to the displaced label the Y-
coordinate of a row that spans the rest of the form. For more information, see Fix
Displaced Labels, page 848.
Fix Text Display in Excel Cells

Use this procedure to fix incomplete display of text in a spec saved as Excel. You
can perform this procedure either in Excel or InfoMaker. Cell content can be
improperly displayed due to the width of the Excel columns. This can occur in the
following situations:
• If the text string in a cell is longer than the width of the cell, and the cell to
the right is empty, the text extends into the adjacent cell.
• If the text string in a cell is longer than the width of the cell, and the cell to
the right is not empty, the overlapping text is cut off.
• If the cell is very narrow, no data appears in the cell. By inserting the
mouse pointer in the cell, you can view the cell contents in the formula
bar.
For more information, see Fix Text Display in Excel Cells, page 849.
Fix Function Conversion Problems

Use this procedure to convert manually those SmartPlant Instrumentation functions
used in the spec into Excel functions if automatic conversion was not successful.
When you save a specification in Excel format, SmartPlant Instrumentation converts
its functions into Excel functions. Where the conversion does not succeed,
SmartPlant Instrumentation enters the calculated result into the relevant cell of the
Excel spreadsheet, and does not display a formula in the formula bar. This problem is
likely to occur if you created your own specification function in InfoMaker. For
more information, see Fix Function Conversion Problems, page 849.

Set Value Display Precision

Use this procedure if you encounter problems in process data or calculation value
display precision in the Excel cells after saving specs in Excel format. In general,
process data and calculation values that SmartPlant Instrumentation stores in the
database are of greater precision than the values that Excel displays in the cells of
generated specs. The default global Save as Excel precision is two decimal places.
Therefore, if you need to display in Excel a precise SmartPlant Instrumentation value,
you need to increase the number of decimal digits for Save as Excel. You can either
set values display precision globally, or for individual fields. For more information,
see Set Value Display Precision, page 850.
Fix Display of Vertical Fields

Use this procedure if vertical fields are not displayed correctly the Excel file. If a spec
page upon which specifications are based contains vertical fields, it must fulfill one of
the following two conditions for correct export to Excel:
• The X values of the left-hand vertical grid line must be 0.

• You create an invisible line for which the X values are 0.
If aligning the page grid lines to X = 0 does not solve the problem, you need to trim
and center vertical form fields in InfoMaker. For more information, see Fix Display
of Vertical Fields, page 850.
Fix Display of Select Lists

Use this procedure if select lists are not displayed correctly the Excel file. For more
information, see Fix Display of Select Lists, page 851.
Prepare Problematic Excel Files for Intergraph Support

Use this procedure if you encounter problems that you are unable to solve, and then
contact Intergraph Support. For more information, see Prepare Problematic Excel
Files for Intergraph Support, page 851.
Related Topics
Resolve Spec Accessing Problem in a Common Excel File

1. In Excel, on the menu bar, click Tools > Options.
2. On the Security tab, click Macro Security.
3. On the Security Level tab, click Medium.
4. Click OK to close the Security dialog box.
5. Click OK to close the Options dialog box.

Remove the Protection from a Spec Saved as Excel

• With the spec open in Excel, on the menu bar, click Tools > Protection >
Unprotect sheet.
Related Topics
Resolve a Data Saving Problem

1. Save the spec page upon which the specification is based in .psr format and then
open the .psr file in InfoMaker. For details, see Open a Spec Page in InfoMaker,
page 729.
2. Right-click the required text header, and then, on the shortcut menu click
Properties.
3. On the Position tab, under X, increase the previous value by 0.1
4. Repeat this step for every header that is located precisely above its field.
Excel format.
Related Topics
Resolve Grid Line Overlap Problems

1. Open the appropriate spec page in InfoMaker. For details, see Open a Spec Page
in InfoMaker, page 729.
2. In InfoMaker, make sure that lines that intersect near problematic fields do not
overshoot. Overshooting occurs when grid lines meet imperfectly, and at least
one of the lines extends beyond the meeting point. If overshooting occurs, see
Correct Undershooting and Overshooting of Grid Lines, page 846
3. If there is no overshooting, make sure that you set constant Y1 and Y2 values for
all of the objects between the lines. The Y1 value should be several PBUs
(PowerBuilder units) greater than the Y values of the line above, and the Y2 value
should be several PBUs less than the Y values of the line below.
Excel format.
Related Topics

Correct Undershooting and Overshooting of Grid Lines

2. To correct undershooting or overshooting on the left border, do the following:
a. Right-click the top line or on the bottom line, and on the shortcut menu click
Properties.
b. On the Position tab, under X1, copy the value to the Clipboard, using a
standard Microsoft shortcut (for example, Ctrl+C).
c. Right-click the required horizontal line, and on the shortcut menu, click
Properties.
d. On the Position tab, under X1, paste the Clipboard value, using a standard
Microsoft shortcut (for example, Ctrl+V).
3. To correct undershooting or overshooting on the right border, do the following:
a. Right-click the top line or the bottom line, and on the shortcut menu click
Properties.
standard Microsoft shortcut.
c. Right-click the required horizontal line, and on the shortcut menu, click
Properties.
Microsoft shortcut.
4. To correct undershooting or overshooting on the top border, do the following:
a. Right-click the left-most line or the right-most line, and on the shortcut menu
click Properties.
b. On the Position tab, under Y1, copy the value to the Clipboard, using a
standard Microsoft shortcut.
c. Right-click the required vertical line, and on the shortcut menu, click
Properties.
d. On the Position tab, under Y1, paste the Clipboard value, using a standard
Microsoft shortcut.

5. To correct undershooting or overshooting on the bottom border, do the following:

a. Right-click the left-most line or the right-most line, and on the shortcut menu
click Properties.
b. On the Position tab, under Y2, copy the value to the Clipboard, using a
standard Microsoft.
c. Right-click the required vertical line, and on the shortcut menu, click
Properties.
d. On the Position tab, under Y2, paste the Clipboard value, using a standard
Microsoft shortcut.
Excel format.
Related Topics
Prevent Truncation of Labels and Values

2. For accurate export to Excel, fine-tune problematic areas of the page in
InfoMaker according to plumb line principles:
• The X positions of vertical lines and X1 and X2 object positions
should not be used randomly.
• For considerations of graphic design and for compatibility with Excel,
set close values equal.
3. Save the file.
Excel format.
Related Topics

Fix Displaced Labels

1. Open the problematic spec in the Page Editor in SmartPlant Instrumentation.
2. Save the spec page as a .psr file and then open the .psr file in InfoMaker. For
details, see Open a Spec Page in InfoMaker, page 729.
3. To normalize label coordinates, do the following:
a. Right-click the field to the right of the displaced label, and on the shortcut
menu, click Properties.
b. On the Position tab, under Y, copy the value to the Clipboard, using a
standard shortcut (for example, Ctrl+C).
c. Right-click on the displaced label, and on the shortcut menu, click Properties.
d. On the Position tab, under Y, paste the Clipboard value, using a standard
shortcut (for example, Ctrl+V).
Tip
• The value of the Height field on the Position tab can also influence
the appearance of the text in Excel. You must enter a height value that
is in proportion to the font size that you set in the Font tab folder.
4. On the File menu, click Save.
Tip
• You only need to perform the following steps if you want to fix
displaced labels by extending an existing horizontal line above or
below the displaced label. These steps deal with extending a line that
runs through the right-hand and the middle column into the left-hand
(categories) column. You can adapt this procedure for other
configurations as well.
5. To extend an existing horizontal line above or below the displaced label, do the
following:
a. Right-click the left-most line (vertical), and on the shortcut menu click
Properties.
standard shortcut (for example, Ctrl+C).
c. Right-click the horizontal line that you want to extend, and on the shortcut
shortcut (for example, Ctrl+V).
e. Click in the main window to view your changes.

Excel format.
Related Topics
Fix Text Display in Excel Cells

1. If you want to fix text display directly in Excel, do one of the following:
• In Excel, drag the column borders to accommodate the text.
• In Excel, on the Excel Format Cells dialog box, on the Alignment
tab, select Wrap text.
2. If you want to fix text display directly in InfoMaker, do the following:
a. Open the problematic spec in the Page Editor in SmartPlant Instrumentation.
b. Save the spec page as a .psr file and then open the .psr file in InfoMaker. For
details, see Open a Spec Page in InfoMaker, page 729.
c. and increase the width of this column as necessary.
d. On the File menu, click Save.
e. Import the page back into SmartPlant Instrumentation.
f. Regenerate the spec page and specification, and save the specification again in
Excel format.
Related Topics
Fix Function Conversion Problems

1. Open the problematic Excel file.
2. Copy the value of the unknown function from the original cell to a temporary cell.
3. Copy the unknown function from the log file to the original cell.
Tip
• The log files are located in <SmartPlant Instrumentation home
folder>\SaveAsExcel\ResultFiles\. The filenames are created
according to the convention LogFileFormXXX_#.txt, where XXX is
the form number and # relates to the internal change made to the form.
4. In the original cell, modify the exported function to convert it into an Excel
function.
5. Move the mouse pointer outside the cell to display the value of the function.

6. Compare the value displayed in the Excel cell with the value in the source
specification. If the values are identical, this is an indication (but not a proof) that
you have accurately converted the formula.
7. If you succeed in converting the function, delete the contents of the temporary
cell.
Tips
• If you resave the same specification in Excel format, to prevent the
software from overwriting your new function, you must rename the
corrected Excel file. You can then copy the formula to future Excel
versions of this specification.
• If the converted formula does not work, restore the original cell
contents from the temporary cell, and then contact Intergraph Support.
Related Topics
Set Value Display Precision

• To set value display precision globally, see Set Value Display Precision
for Save as Excel Globally, page 840.
• To set value display precision for individual fields and override the global
value precision settings, see Set Value Display Precision for Individual
Fields, page 841.
Related Topics
Fix Display of Vertical Fields

2. Right-click a vertical field, and then, on the shortcut menu, click Properties.
3. To verify that a given field diverges from the horizontal, on the Font tab, click the
icon to the right of the Escapement box or . On the dialog box that opens,
in the Expression box, a value of 900, for example, indicates a vertical field.
4. On the General tab of the Properties dialog box, under Alignment, select
Center.
5. If the field is wider than the text, do one of the following to trim the field:
• On the Position tab, under Width, change the value to the minimum
value needed to display the actual text.
• In the Design view, use the mouse to change the field width.


Excel format.
Related Topics
Fix Display of Select Lists

• To fix the display of select lists in Excel, you need to create an invisible
vertical zero line in the problematic spec page. For details, see, Create an
Invisible Vertical Zero Line, page 838.
Related Topics
Prepare Problematic Excel Files for Intergraph Support

1. In SmartPlant Instrumentation, click File > Preferences > Specifications > Save
as Excel.
2. Select Delete temporary Excel files, and click OK.
3. Save the problematic specifications in Excel format.
4. For each problematic specification, send the following files to Intergraph Support:
• From the <SmartPlant\Instrumentation home
folder>\SaveAsExcel\ResultFiles folder send T_Form*.xls and
LogFileForm*.txt (or the <tag number>.xls)
• From the <SmartPlant\Instrumentation home
folder>\SaveAsExcel\DataFiles folder, send Data*.xls and Form*.xls.
Related Topics

Specification Report List

The following table shows a description of each Specifications module report that is
available for displaying and printing.
Report Description Note

Specifications Allows you to print all For loop spec or instrument spec report
by Item Type specs belonging to generation, you can select the current plant
items of a particular group or all plant groups available in your
item type, or print plant structure.
specs according to
your item selection..
Specifications Allows you to print For loop spec or instrument spec report
by Form specs according to generation, you can select the current plant
specific forms on group or all plant groups available in your
which the plant structure.
specifications are
based.
Specifications Allows you to print This option allows you print all existing
by Document specifications spec belonging to any item type.
Number according to specified
document numbers.
Form Data Allows you to select None
Templates form data templates
and print a report
showing the form data
template data.
Spec Forms Allows you to print You can set the software to generate the
specific forms. report with or without field names. The
software generates the report as the
specprn.psr file and saves this file to the
folder you specified in the Temporary
folder path box, on the General page of
the Preferences dialog box. If you leave
this box blank, the software saves the
specprn.psr file to the SmartPlant
Instrumentation home folder.
Specifications Allows you to print For loop spec or instrument spec report
by Date specs belonging to generation, you can select the current plant
items of a particular group or all plant groups available in your
item type according to plant structure.
specified date range.

Report Description Note

Spec Form Displays the field The field headers are displayed as they
Field Report – names and their appear in the Spec Data Dictionary. You
Per Form respective headers for can select a specific form or all available
the forms. forms.
Spec Form Contains spec form You can select a specific field name or all
Field Report – names where a selected available field names.
Per Field field appears.
Spec Form Contains a list of fields None
Select List that appear as select
lists in the form, with
all the possible values
for each field.
Spec Form Lists Contains a list of You can select one or more process
by Process specification forms and functions. Forms belonging to a particular
Function instrument types process function appear on a separate
associated with the sheet.
specified process
functions.
Spec Pages by Contains a list of pages This report only shows a list of pages in
Form associated with the the form, not the fields that are used in the
forms that you select. page. Pages used in a particular form
appear on a separate sheet.
Print Specs into Allows you to print the Before printing specifications into a .pdf
PDF Files specifications that you file, you must install GNU Ghostscript or
select into a common Adobe Acrobat Distiller and set it as your
.pdf file. report generator.
Related Topics

Printing Specifications and Reports Common Tasks

The following tasks enable you to generate and print various spec-related reports.
Print a Specification Report

Use this procedure to print a report of specifications that are based on the same spec
form. In the procedure topic, the report for specifications according to selected forms
is shown as an example. You need to have access to the Specifications module to
print spec reports. The steps involved in printing most of the Specifications module
reports are similar. For more information, see Print a Specification Report, page 855.
Generate Reports by Date

Use this procedure to set a date range and then generate a report of all spec forms that
underwent changes within this date range. For more information, see Generate
Reports by Date, page 856.
Generate a Report for a Selected Field Name

Use this procedure to generate a Spec Form Field Report for a certain data field that is
in use in spec forms. This report indicates the forms that use this data field, and also
indicates the headers that you assigned to this field in the Spec Data Dictionary for
the various forms. For field headers that you did not edit in the Spec Data
Dictionary, this report prints the headers that appear in the pages that the form
contains. For more information, see Generate a Report for a Selected Field Name,
page 856.
Assign User-Defined Headers for Spec Form Field Reports

Use this procedure to edit form headers or to assign user-defined headers to the data
fields in a selected form. The header changes affect Spec Form Fields reports and
Form Browser views that you create in the Browser module. This procedure does not
affect the display of specifications based on a form that you edit in the Spec Data
Dictionary, nor does this procedure influence printed specifications. For more
information, see Assign User-Defined Headers for Spec Form Field Reports, page
857.
Print the Currently Open Specification

Use this procedure to print out the currently open specification. The Specifications
module preferences that you set on the Preferences dialog box determine how the
software prints specification notes. For more information, see Print the Currently
Open Specification, page 858.

Print Specs into PDF Files

Use this procedure specifications into a single .pdf file, or to individual .pdf files.
Before printing specifications into a .pdf file, you must install GNU Ghostscript or
Adobe Acrobat Distiller. For more information, see Print Specs into PDF Files, page
859.
Related Topics
• Specification Report List, page 852
Print a Specification Report

1. Click File > Preferences > General, and make sure you set the SmartPlant
Instrumentation temporary folder path correctly, for example,
C:\Program Files\SmartPlant\Instrumentation\TEMP.
2. On the Specifications Module window menu bar, click Reports > By Forms.
• Click Current Plant Group if you want to print reports for specs
belonging to the current <unit> plant group only.
• Click All Plant Groups to be able to print reports for specs that exist
in all of the available plant groups in the current plant structure.
4. Select one or more forms and click OK.
5. If prompted, click Yes to preview the report, or click No to print the report
without opening the print preview.
Tips
• By default, the software prompts you to open a print preview. You
can also change this setting on the Preferences dialog box, on the
General page.
• By default, the software prints specification notes on a separate sheet.
You can change this setting on the Preferences dialog box, on the
Specifications > General page.
Related Topics

Generate Reports by Date

1. On the Specifications Module window menu bar, click Reports > By Date.
• Click Current Plant Group if you want to print reports for specs
belonging to the current <unit> plant group only.
• Click All Plant Groups to be able to print reports for specs that exist
in all of the available plant groups in the current plant structure.
3. Type or select the required date range in the From and To boxes.
Tip
• Click Today to display the current date in the To box.
4. Click OK to save the date range settings for current report generation.
5. If prompted, click Yes to preview the report, or click No to print the report
without opening the print preview.
Tips
• By default, the software prompts you to open a print preview. You
can also change this setting on the Preferences dialog box, on the
General page.
• By default, the software prints specification notes on a separate sheet.
You can change this setting on the Preferences dialog box, on the
Specifications > General page.
Related Topics
Generate a Report for a Selected Field Name

1. On the Specifications Module window menu bar, click Reports > Spec Form
Field Report – Per Field > Selected Field Name.
2. On the Select Field Name dialog box, select the required data field and click OK.
Tip
• If the list of data fields is long, start typing a field name in the Find
box and the software selects the field name automatically as you type.
3. Click OK and then, if prompted to preview the report, click Yes to open the
report print preview, or No to print the report without opening the print preview.
Related Topics

Assign User-Defined Headers for Spec Form Field Reports

1. On the Specifications Module window menu bar, click Edit > Spec Data
Dictionary.
2. In the Select Specification Form dialog box, select a form and click OK.
4. To edit the field headers for Spec Form Field reports, do one of the following:
• On the Field Properties tab, change individual headers by typing a
text string instead of the displayed header.
• Change headers in batch mode using another form as a source. To do
so, click Copy From, and then, select a source form.
5. To apply existing headers of the current form, do the following:
a. In the form, or on the Field Properties tab, under Header, move the cursor to
the header, and after the cursor changes its shape to , click the header.
b. In the form, double-click the header to display it on the Field Properties tab.
Tips
• If you apply existing headers of the current form, in the form display,
the form fields are marked with a background the cyan background
color. The background color of the currently selected field, for which
you are editing the header, changes to magenta.
• The icon in the Field Properties tab points to the corresponding
header, which is now available for editing.
Related Topics

Print the Currently Open Specification

1. On the Specifications > General page of the Preferences dialog box, do one of
the following:
• Select Show notes to include spec notes on the first page of the spec.
• Clear Show notes to omit spec notes from the first page of the spec.
2. On the Specifications > General page of the Preferences dialog box, do one of
the following:
• Select Print notes on a separate sheet to print the spec notes section
on a separate print sheet.
• Clear Print notes on a separate sheet to print the spec notes section
as displayed on the spec.
3. Open a spec and, do one of the following:
• Click Actions > Print.
Related Topics

Print Specs into PDF Files

Important
• Before printing specifications into a .pdf file, you must install GNU
Ghostscript or Adobe Acrobat Distiller. You then open the Preferences
dialog box and on the General tab, select the appropriate application from
the PDF generator list.
1. On the Specifications Module window menu bar, click Reports > Print Specs
into PDF Files.
2. On the Print Specs into PDF Files dialog box, do one of the following:
• Click Print all into one file and then specify the target file name and
path. This allows you to create one .pdf file shared for all
specifications.
• Click Print into individual files and then specify the target folder for
the software to create an individual .pdf file for each specification.
Tip
• When creating individual .pdf file names for item specifications, the
software uses the names of the items as a source. If the item name
includes characters other than alphanumeric characters (that is, \-/(#)
and so forth), the software converts them to underscores. The software
retains hyphens and spaces. For example, if the item name is 101-FT-
100\B, the created .pdf file name is 101-FT-100_B.pdf. If the item
name is 12P#20 TYPE E I/OAS (CUSTOM), the created .pdf file
name is 12P_20 TYPE E I_OAS _CUSTOM_.pdf.
3. Click Find.
4. On the Find Items dialog box, find items for which you want to print to
specifications to a .pdf file.
Tip
• On the Find Items dialog box, the software only displays items for
which specifications already exist.
5. Under Search results, select items whose specifications you want to print into
one or several .pdf files, and then click OK.
6. On the Print Specs into PDF Files dialog box, click OK.
Related Topics

Pipe Specs: An Overview

Pipe spec is a specification that defines pipe properties for various process conditions.
In SmartPlant Instrumentation, the term pipe spec denotes a set of requirements for
materials and construction of the pipelines and their components. You can include
this information in a specification that defines various process conditions for a
specific pipe. In SmartPlant Instrumentation, pipe specs are used for references and
as a guideline for design in the areas affected by direct contact with process. These
references include pipeline information in the Process Data module and installation
item details you can display in hook-up drawings.
In a hook-up drawing, you can display all instrument you associate with a particular
pipe spec. You make pipe spec definitions using the Pipe Specs supporting table,
available either from the Instrument Index or Process Data module. After making
your pipe spec definitions, you can assign a pipe spec to one or more lines in the
Process Data or Instrument Index module. Also, you can assign a pipe spec to one or
more instruments in the Browser or Instrument Index module. You do not use the
Specifications module options to generate or manage pipe specs.
You then assign pipe specs to user-defined hook-up item sub-libraries and affect
instrument – hook-up assignment. After assigning a pipe spec to a user-defined sub-
library, when making instrument – hook-up associations, you can only use
instruments that have the source pipe spec data. You cannot use the default sub-sub-
library for pipe spec assignment.
Related Topics
• Pipe Specs Common Tasks, page 861

Pipe Specs Common Tasks

The following tasks deal with pipe spec management. Pipe spec is a specification
that defines various process conditions for a specific pipe.
Define or Modify Pipe Specs

Use this procedure to define pipe specs in the Pipe Specs supporting table. You can
perform this procedure either in Instrument Index or process data module. For more
information, see Define or Modify Pipe Specs, page 862.
Assign Pipe Specs to Instruments

You can assign pipe specs to instrument tag numbers in the Browser module or in the
default view of the Instrument Index Standard Browser accessed from the Instrument
Index module. You have to assign pipe specs to tag numbers if you want to use pipe-
spec sub-libraries in the Hook-Ups module and assign the tag numbers to hook-ups.
Prior to assigning pipe specs to instrument tag numbers, you make pipe spec
definitions in the Pipe Specs supporting table, which you can access either from the
Instrument Index or from the Process Data module. In these modules, you can also
assign pipe specs to line numbers. For more information, see Assign Pipe Specs to
Instruments, page 863.
Assign Pipe Specs to Lines

Use this procedure to can assign pipe specs to lines. You can then display the pipe
spec definition in the line process data sheet. For more information, see Assign Pipe
Specs to Lines, page 864.
Associate Pipe Specs with Sub-Libraries

Use this procedure to associate one or more pipe specs with user-defined sub-
libraries. After the association, when assigning instruments to hook-ups, you can
only use instruments that have the source pipe spec data. You cannot use the default
sub-library for pipe spec assignment. For more information, see Associate Pipe
Specs with Sub-Libraries, page 865.
Display Pipe Specs Assigned to a Hook-Up Item Sub-Library

Use this procedure to displays pipe specs associated with a specific user-defined
hook-up item sub-library. For more information, see Display Pipe Specs Assigned to
a Hook-Up Item Sub-Library, page 866.
Dissociate a Pipe Spec from Lines

Use this procedure to dissociate a pipe spec from a line. You must perform this
procedure if you need to delete this pipe spec from the Pipe Specs supporting table.
For more information, see Dissociate a Pipe Spec from Lines, page 867.

Delete Pipe Specs

Use this procedure to delete a pipe spec from the Pipe Specs supporting table. You
can perform this procedure either in the Instrument Index or Process Data module.
For more information, see Delete Pipe Specs, page 868.
Related Topics
• Pipe Specs: An Overview, page 860
Define or Modify Pipe Specs

Lines.
• On the Process Data Module window toolbar, click to open the
Select Line dialog box..
2. From the Line type list, select a line type.
5. Do one of the following.
• To create a new pipe spec, click New and type the pipe spec name and
description.
• To edit an existing pipe spec, click a field in a selected row and
modify the existing pipe spec name and description as needed.
Related Topics

Assign Pipe Specs to Instruments

1. Open the Browser Manager, and then, for the Instrument Index Standard
Browser, define a view that includes the Tag Number and Pipe Spec fields.
2. In the Pipe Spec column, from the select list, select a pipe spec for association
with the instrument whose tag number is displayed in the same row, in the Tag
Number column.
Tips
• You can assign the same pipe spec to more than one instrument but
only one pipe spec per instrument.
• To dissociate a pipe spec from an instrument, from the select list in
Pipe Spec column, select a blank field.
• After you assign tags to hook-ups in the Hook-Ups module, you can
open a view for the Hook-Up Tag List browser. This browser displays
only those tags that are associated with hook-ups. In this browser
view, you can also change the pipe spec associations as you require.
Related Topics
• Assign Pipe Specs to Lines, page 864

Assign Pipe Specs to Lines

Lines.
3. Select a line and click Properties.
4. On the Line Properties dialog box, beside the Pipe spec list, click to open the
Pipe Specs dialog box.
5. Select a pipe spec and click OK to assign it to the line.
Tips
• You can now open a process data sheet for this line to display the
assigned pipe spec. If you defined more than one pipe spec in the Pipe
Specs supporting table, you can assign a different pipe spec to the line
from the process data sheet.
• The pipe spec becomes a property of the process data sheet. This
means that you can assign this pipe spec to other lines by copying line
data to other lines. Note, however, that when you copy line data to
instruments, the software does not copy line pipe spec definition to the
instruments.
Related Topics
• Assign Pipe Specs to Instruments, page 863

Associate Pipe Specs with Sub-Libraries

1. In the Hook-Up Item Libraries folder of the Reference Explorer, do one of the
following:
• In the tree view pane, expand the hierarchy of an item library and
right-click a user-defined sub-library.
• In the tree view pane, select an item library and then, in the Items
pane, select one or more user-defined sub-libraries.
2. On the shortcut menu, click Actions > Associate Pipe Specs with Sub-
Libraries.
Tips
• On the dialog box that opens, the software displays all the pipe specs
defined in the Pipe Specs supporting table.
• In the dialog box panes, you can double-click the Pipe Specs column
header in the to sort the items in ascending order. Double-click the
header again to sort the items in descending order.
3. Under Available pipe specs, select one or more pipe specs and do one of the
following:
• Click Associate.
• Drag the selected items to the Associated pipe specs pane.
4. If you selected more than one user-defined sub-library in the Reference
Explorer, click Next to display another sub-library and associate pipe specs as
you require.
Tip
• You can associate the same pipe specs with more than one user-
defined sub-library.
Related Topics

Display Pipe Specs Assigned to a Hook-Up Item Sub-

Library
1. Press F7 to open the Domain Explorer, and expand the hierarchy to the hook-up
type level in the Hook-Ups folder.
• In the tree view pane, select a specific hook-up.
• In the tree view pane, select a hook-up type, and then, in the Items
pane, select and right-click one or more hook-ups.
4. On the Hook-Up Properties dialog box, from the Hook-up sub-library list,
select a user-defined hook-up item sub-library.
5. Click Pipe Specs to display pipe specs associated with the user-defined sub-
library that you selected.
Tips
• The Pipe Specs button is only available when the sub-library that you
selected is user-defined.
Related Topics

Dissociate a Pipe Spec from Lines

Lines.
3. Select a line and click Properties.
4. On the Line Properties dialog box, in the Pipe Spec column of the data window,
click the pipe spec definition and press the Delete key.
5. Click OK to return to the Select Line dialog box.
Tips
• This procedure only allows you do dissociate a pipe spec from one line
at a time. If you want dissociate this pipe spec from all lines, you can
open the process data sheet for a specific line, make sure that the Pipe
spec box is empty, and then copy line data to other lines.
• You do not delete the pipe spec itself, only dissociate it from the line.
The dissociated pipe spec remains in the Pie Specs supporting table. If
you want to delete a pipe spec permanently, you must delete it from
the supporting table.
• Dissociating a pipe spec from a line does not dissociate this pipe spec
from instruments.
Related Topics
• Delete Pipe Specs, page 868

Delete Pipe Specs

Lines.
Select Line dialog box.
5. Select the pipe spec that you want to delete, and click Delete.
6. Repeat the previous step for each pipe spec that you want to delete.
Tip
• You cannot delete a pipe spec that is currently assigned to lines. First,
dissociate the pipe spec from the lines.
Related Topics
• Dissociate a Pipe Spec from Lines, page 867

Foundation Fieldbus Design: An Overview

SmartPlant Instrumentation supports the creation and maintenance of Foundation
Fieldbus systems.
Foundation Fieldbus technology has rapidly established itself as a viable process

industry networking methodology. Of the different protocols available currently on
the market, Foundation Fieldbus is the leading product in the process industry. The
SmartPlant Instrumentation fieldbus solution is based on H1 Intrinsically Safe Low
Speed, 31.25 kb/sec Fieldbus, and supports topologies such as star, trunk/drop, and
daisy chain.
The software provides the following features for creating and managing Fieldbus
projects:
• Fieldbus device tags, which you create in the Instrument Index module,
include Fieldbus properties such as identification references, address,
electrical properties, associated function blocks, and so forth.
• The Fieldbus Tag Numbers browser, where you create and manage
fieldbus instruments and associate them with appropriate segments. Also,
you can generate a validation report for a selected segment.
• Fieldbus connection apparatus and Fieldbus bricks, which you create in
the Wiring module. You can quickly and easily create fieldbus junction
boxes and device panels using the Plug-and-Socket Box Wizard.
• As you build segments, the software verifies that you are following basic
connection rules. Later, you can generate reports to verify that you built
the segments according to further connection rules, and according to the
segment-wide parameter profiles that you applied to each segment.
• Segment wiring diagrams and Fieldbus Loop enhanced reports.
Note
• Note that whenever Fieldbus is mentioned in the subsequent topics of the
documentation, we refer to Foundation Fieldbus.
Related Topics
• Flow of Activities for Foundation Fieldbus Design, page 870
• Profibus Design: An Overview, page 931

Flow of Activities for Foundation Fieldbus Design

The following is a suggested flow of activities for Foundation Fieldbus design in
SmartPlant Instrumentation. Note that you can carry out some of the procedures in a
different order, depending on your preferences or requirements.
1. Define the Segment-Wide Parameters for the current site
Segment-wide parameters allow you to define default settings that serve as design
rules and limitations for the various Foundation Fieldbus and Profibus PA
segments. These parameters affect the function and performance of your fieldbus
system in the following ways:
• If you exceed cable lengths, or hook too many devices to the same pair
of wires, this can cause attenuation and reduction in the voltage
reaching the instruments. These voltage drops can result in instrument
malfunction and bandwidth problems.
• If you create a spur cable that is too long, the signal propagated along
that spur cable can become attenuated and too weak for the DCS to
read.
• If you create a segment whose total capacitance exceeds the
maximum, you may reduce effective bandwidth.
For more information, see Define Segment-Wide Parameters, page 875.
2. Define Foundation Fieldbus instrument type profiles
• Prior to creating new fieldbus instruments, you need to customize
wiring reference items and then define appropriate instrument type
profiles in the Instrument Index module so that new tag numbers
acquire fieldbus properties. This results in automatic assignment of
the required properties to the new tag numbers. For more information,
see Define Foundation Fieldbus and Profibus Instrument Type
Profiles, page 885.
3. Add a new browser view
• In the Browser module, create a browser view with the required fields
for the Fieldbus Tag Numbers browser. This facilitates the
assignment of tag numbers to segments. You can create multiple
Browser views with different Style, Sort, and Filter functions. For
example, by using the filter function you may create independent
views for each segment, so that only tags of that segment will be
displayed in its corresponding view.

4. Create user-defined function blocks

• Since the software does not allow you to modify or delete the shipped
function blocks, you can create your own function blocks which you
can modify or delete as you see fit. The function blocks that you
define here are available for the current site. You can define function
blocks as multiple with or without execution time. Instruments can be
associated with several function blocks of the same type if that
function block is defined as Multiple. Using the Execution Time
feature allows you to set the time for the function block execution.
You set the number of function blocks and the execution time in the
Function Block – Instrument Type Association dialog box. You
can create a virtual tag and associate it with an existing function block.
Only one virtual tag can be associated with a function block. For more
information, see Create a User-Defined Function Block, page 880.
5. Associate function blocks with instrument types
• Associating function blocks with instrument types enables you to
instruct the software to create and associate a particular function block
when creating a fieldbus instruments. When you create a fieldbus
instrument tag, SmartPlant Instrumentation automatically assigns the
function blocks associated with the instrument type that you select for
the new tag. Note that you can associate a function block with as
many instrument types as required. For more information, see
Associate Function Blocks with Instrument Types, page 881.
6. Create Foundation Fieldbus instruments
• Create your fieldbus device tags based on the instrument types that
you defined, and edit the tag number properties as required, including
function block properties. The software allows you to create various
types of instruments that can be associated with the Foundation
Fieldbus system in your plant. In other words, you can create
instruments that are compatible with Foundation Fieldbus, Profibus
DP, and Profibus PA segments. You add new instruments in the
Instrument Index module, exactly the same way that you create other
tags. Once you define an instrument type for the new tag number and
associate a function block with the new tag's instrument type, the new
instrument automatically acquires all of the appropriate properties that
you set for that tag number. You can then create virtual tags for this
instrument.
For more information, see Create Foundation Fieldbus and Profibus

7. Associate your function blocks with fieldbus instruments

•This feature enables you to associate a function block with a particular
instrument. You use this feature if for some reason, the current tag
number has not been associated with any function block through the
tag's instrument type or if you need to change some of the associations.
Note that the association or any changes made to the association will
affect the current tag number only. For more information, see
Associate Function Blocks with Instruments, page 889.
8. Create your fieldbus segments and associate them with fieldbus
instruments
• Now you are ready to create your fieldbus segments, associate the
appropriate instruments with their respective segments, and create the
necessary virtual tags. For more information, see the following:
• Create a Foundation Fieldbus Segment, page 891
• Associate an Instrument with a Segment, page 892
• Enable a Function Block for I/O Assignment, page 894
9. Design your wiring and termination equipment
• At this stage you need to create your fieldbus I/O cards and if you are
going to use the plug-and-socket communication system, create your
fieldbus plug-and-socket boxes. For more details, see the following:
• Create a Fieldbus I/O Card, page 924
• Fieldbus Plug-and-Socket Boxes: An Overview, page 897
10. Add your home-run cables and spurs.
• For details, see Managing Fieldbus Cables Common Tasks, page 895.
11. Make the required connections and associations
• At this stage you are ready to make the required connections and
associations. However, before you can associate a segment with a
home-run cable or connect a home-run cable to a plug-and-socket box,
you need to configure various connector types assign connector pins to
wires. For more information, see Making Connections and
Associations for Fieldbus Common Tasks, page 914.
12. Effect the I/O assignment
• For details, see Effect Fieldbus I/O Assignment, page 925.

13. Generate fieldbus validation reports

• As you build the segments, and make connections and effect I/O
assignments, the software verifies that you are following basic fieldbus
rules. Later, you can generate reports to verify that you built the
segments according to additional connection rules and according to the
segment-wide parameter profiles that you applied to each segment.
For details, see Fieldbus Validation: An Overview, page 926.
14. Generate a segment wiring report
• You can generate an enhanced segment wiring drawing to view the
completed segment. For details, see Generate a Segment Wiring
Report, page 930.
15. Generate a specification
• In the Specifications module you can associate tags with fieldbus
forms to generate specifications.
• If you encounter difficulty in activating a library form for fieldbus, you
should restore the form.
• Also, you can add function block custom fields to fieldbus
specifications.
16. Generate a hook-up drawing
• You can also generate a hook-up drawing for your fieldbus
instruments just like for conventional instruments. For details see
Hook-Up Drawing Generation: An Overview, page 1139.

Preliminary Definitions for Foundation Fieldbus

Common Tasks
The following tasks are used frequently when you make preliminary Foundation
Fieldbus definitions.
Define Segment-Wide Parameters

Segment-wide parameters allow you to define default settings that serve as design
rules and limitations for the various Foundation Fieldbus and Profibus PA segments.
These parameters affect the function and performance of your fieldbus system in the
following ways:
• If you exceed cable lengths, or hook too many devices to the same pair of
wires, this can cause attenuation and reduction in the voltage reaching the
instruments. These voltage drops can result in instrument malfunction and
bandwidth problems.
• If you create a spur cable that is too long, the signal propagated along that
spur cable can become attenuated and too weak for the DCS to read.
• If you create a segment whose total capacitance exceeds the maximum,
you may reduce effective bandwidth.
For more information, see Define Segment-Wide Parameters, page 875.
Create a User-Defined Function Block

You use this feature to add new user-defined function blocks, delete redundant ones,
or modify the definition of existing user-defined function blocks. The function
blocks that you define here are available for the current site. You can define function
blocks as multiple with or without execution time. Instruments can be associated
with several function blocks of the same type if that function block is defined as
Multiple. Using the Execution Time feature allows you to set the time for the
function block execution. You set the number of function blocks and the execution
time in the Function Block – Instrument Type Association dialog box. You can
create a virtual tag and associate it with an existing function block. Only one virtual
tag can be associated with a function block.
For more information, see Create a User-Defined Function Block, page 880

Associate Function Blocks with Instrument Types

Associating function blocks with instrument types enables you to instruct the
software to create and associate a particular function block when creating a fieldbus
instruments. When you create a fieldbus instrument tag, SmartPlant Instrumentation
automatically assigns the function blocks associated with the instrument type that you
select for the new tag. Note that you can associate a function block with as many
instrument types as required.
For more information, see Associate Function Blocks with Instrument Types, page
881.
Manage the Functions Blocks Supporting Table

This option shows you how to use this supporting table to add new user-defined
function blocks to your instrument index, delete the redundant ones, or modify the
definition of existing user-defined function blocks. You can also enable the Multiple
and Execution Time features for any existing function block. For more information,
see Manage the Functions Blocks Supporting Table, page 882.
Related Topics
• Foundation Fieldbus Design: An Overview, page 869
Define Segment-Wide Parameters

2. On the main menu bar, click Tables > Segment-Wide Parameter Profiles.
3. In the Segment-Wide Parameter Profiles dialog box, click New.
4. In the Segment-Wide Parameter Profiles Properties dialog box, click the
General tab, and do the following:
a. In the Name box, type a unique name for the profile.
b. In the Description box, type a description for the profile.
5. Select the profile as Default, or leave it unselected.
Tip
• If selected, when you add a new segment, this profile will be the
default setting associated with the new segment.

6. In the Maximum number of devices group box, do the following:

a. Per spur— Type the maximum number of tag numbers that can be connected
with one spur.
b. Per segment— Type the maximum number of tag numbers that can be
associated with one segment.
c. Per intrinsically safe (IS) segment— Type the maximum number of tag
numbers that can be associated with one intrinsically safe segment.
7. In the Maximum number of assigned function blocks group box, do the
following:
a. Per I/O card— Type the maximum number of function blocks that can be
associated with one I/O card.
b. Per segment— Type the maximum number of function blocks that can be
associated with one segment.
8. In the Electrical parameters group box, do the following:
a. Power supply— Type the available voltage source value, in volts.
b. Minimum receiver voltage— Type the minimum receiver voltage value that
can be read by a DCS, in volts.
c. Allowable current per non IS segment— Type the maximum allowable
value for the current consumption in the non-intrinsic safety segments, in
milliamperes.
d. Allowable current per IS segment— Type the maximum allowable value
for the current consumption in the intrinsic safety segments, in milliamperes.
e. Maximum capacitance— Type the maximum allowable segment
capacitance in the unit of measure selected at right.
9. Click the Cable Lengths tab.
10. In the Recommended spur cable lengths group box, define the rules for spur
cables connecting instruments to home-run cables. Do the following:
a. Select the required unit of measure (meters or feet).
b. In the Number of devices per segment columns, type the number of devices
per segment for which you want to set the spur lengths. Make sure that you
do not exceed the number of devices that you defined in the Maximum
number of devices group box.
c. In the Number of devices per spur columns, type the maximum allowable
length of the spur cables for each definition.
d. You can click New to add a row, or Delete to delete the row marked by .
See Spur Cable Lengths Example, page 878.

11. Click OK to confirm your creation of this profile and return to the Segment-
Wide Parameter Profiles dialog box.
Tip
• You can return to Step 3 to create an additional segment-wide
parameter profile.
12. Click OK to close the Segment-Wide Parameter Profiles dialog box and return
to the main window of the Wiring module.
Related Topics
• Fieldbus Validation: An Overview, page 926
• Preliminary Definitions for Foundation Fieldbus Common Tasks, page
874
• Profibus Design Common Tasks, page 934

Spur Cable Lengths Example

The following example shows the rules that are set for the lengths of individual spur
cables connecting a junction box to instruments in a variety of fieldbus topologies.
For example, as shown in row 3, where 15 to 18 devices are associated per segment,
and one instrument is associated per spur, the cable can be up to 60 meters long. If
we allow 2 instruments per spur with the same number of associated devices per
segment, each cable can run up to 30 meters, and so forth.
In this example, the recommended spur cable lengths are:
• 120 meters for 1 to 12 devices per segment and one device per spur;
• 90 meters for 1 to 12 devices per segment and two devices per spur;
• 60 meters for 1 to 12 devices per segment and three devices per spur;
• 30 meters for 1 to 12 devices per segment and four devices per spur;
• 90 meters for 13 to 14 devices per segment and one device per spur; and
so forth.
Related Topics
• Define Segment-Wide Parameters, page 875

Working with Function Blocks: An Overview

Function blocks are smart devices that hold control software on fieldbus instruments.
These smart devices or microprocessors enable fieldbus instruments to perform
control functions independently of a DCS. There are many types of function blocks.
Each function block has a specific purpose. SmartPlant Instrumentation provides a
set of the most common function blocks, with properties defined by Fieldbus
Foundation. You cannot delete these shipped function blocks or rename them, but
you can modify their definitions if needed. You can also create user-defined function
blocks, which you can modify and delete, as you need.
Profibus PA function blocks are shipped with the software and you cannot add, delete
or modify any of them.
Function blocks are associated with a particular instrument type. This association
then allows you to create new tag numbers that are automatically associated with
those particular function blocks. The software allows you to associate multiple
function blocks with a single instrument type. For example, a basic flow transmitter
will have one AI (analog input) block associated with it. However, a similar
instrument may be used to measure also pressure and temperature (required for gas
flow compensation), and may be further equipped with one or more alarm functions.
An AI function block is required for each additional process measurement and an AA
(analog alarm) block for each alarm function. You can also associate existing
instruments with function blocks, or modify associations as needed.
Note
• You cannot create virtual tags for an instrument that is not associated with
at least one function block.
Related Topics
• Associate Function Blocks with Instrument Types, page 881
• Associate Function Blocks with Instruments, page 889
• Create a User-Defined Function Block, page 880
• Create Foundation Fieldbus and Profibus Instruments, page 886
874

Create a User-Defined Function Block

2. On the Instrument Index module menu bar click Tables > Function Blocks.
3. In the Function Blocks dialog box, do one of the following:
• To add a new function block, click New.
• To modify the definition of a highlighted function block, click the field
that want to modify.
4. In the Function Block field, type the function block name.
5. In the Description field, type a short description as appropriate.
6. To define the function block as a multiple function block, select Multiple.
Tip
• This will enable you to associate multiple copies of a given functional
block with an instrument type or a specific instrument.
7. To enable entry of an execution time value, select Execution Time.
8. Click OK.
Related Topics
874
• Working with Function Blocks: An Overview, page 879

Associate Function Blocks with Instrument Types

2. On the Instrument Index module menu bar click Tables > Instrument Types.
3. In the Instrument Types dialog box, select a process function type and an
instrument type.
4. Click Profile.
5. In the Instrument Type Profile dialog box, on the General tab, make sure that
the Include I/O type check box is selected, and that you selected Fieldbus from
the list below.
6. In the Function Block – Instrument Type Association dialog box, to assign a
function block to an instrument type, do one of the following:
• In the Unassociated function blocks data window, select the function
block that you want to associate, and click Associate.
• Drag the required function block from the Unassociated function
blocks data window to the Associated function blocks data window.
7. If the required function block is not available in the Function Block –
Instrument Type Association dialog box, add or modify the function blocks in
the Function Blocks dialog box. (For details, see Manage the Functions Blocks
Supporting Table, page 882.)
8. If you customized a given function block in the Function Blocks dialog box, do
the following as needed:
a. To set the maximum number of instruments that can be associated with the
current function block, in the Associated function blocks data window, under
Multiple, type the value.
b. To set the execution time, under Execution Time, type the time value (in
milliseconds).
9. Click OK.
Related Topics
• Define Foundation Fieldbus and Profibus Instrument Type Profiles, page
885
• Manage the Functions Blocks Supporting Table, page 882
874

Manage the Functions Blocks Supporting Table

1. On the Instrument Index module menu bar, click Tables > Function Blocks.
2. Click New to append a new data row or click in a field of a selected row to edit
the data.
3. Type the function block values in the appropriate fields as follows:
• Function Block– enter the required function block name.
• Description– type a description for the function block if required.
• Multiple– select the check box to define this function block as a
multiple function block. This will enable you to create multiple
function blocks of the same type when adding or editing a instrument
associated with this function block.
• Execution Time– select the check box to enable execution time
definition for the current function block. You will be able to set the
execution time when associating this function block with an
instrument type or an instrument tag.
4. Click OK.
Note
• You cannot delete or rename shipped function blocks.
Related Topics

Working with the Fieldbus Tag Numbers Browser:

An Overview
The Fieldbus Tag Numbers browser provides for the creation and management of
fieldbus instrument tags and their association with appropriate segments. Also, you
can generate a validation summary report for a selected segment.
The browser displays all the instruments that exist in your fieldbus system. The
instrument properties are displayed in various columns, such as Tag Number, Loop
Number, Service, Segment Name, and so forth. The columns, their sequence, and
row sorting in this pane depend on the Browser view currently selected in the
Browser Manager. The default display is the New Fieldbus Tag Number List view
in the Browser Manager.
To open the Fieldbus Tag Numbers browser, do the following:

1. In the Domain Explorer, expand the Fieldbus Segments folder.
2. Right-click a segment.
3. On the shortcut menu, click Actions > Fieldbus Tag Numbers Browser.
Related Topics
• Change Instrument / Segment Association, page 893
• Delete a Fieldbus Segment, page 894

Managing Fieldbus Instruments Common Tasks

The following tasks are used frequently when you manage instruments for your
Foundation Fieldbus and Profibus systems.
Define Foundation Fieldbus and Profibus Instrument Type Profiles

Prior to creating new fieldbus instruments, you need to customize wiring reference
items and then define appropriate instrument type profiles in the Instrument Index
module so that new tag numbers acquire fieldbus properties. This results in automatic
assignment of the required properties to the new tag numbers. For more information,
see Define Foundation Fieldbus and Profibus Instrument Type Profiles, page 885.
Create Foundation Fieldbus and Profibus Instruments

Create fieldbus device tags based on the instrument types that you defined, and edit
the tag number properties as required, including function block properties.
The software allows you to create various types of instruments that can be associated
with the Foundation Fieldbus or Profibus system in your plant. In other words, you
can create instruments that are compatible with Foundation Fieldbus, Profibus DP,
and Profibus PA segments. You add new instruments in the Instrument Index
module, exactly the same way that you create other tags. Once you define an
instrument type for the new tag number and associate a function block with the new
tag's instrument type, the new instrument automatically acquires all of the appropriate
properties that you set for that tag number. You can then create virtual tags for this
instrument.
For more information, see Create Foundation Fieldbus and Profibus Instruments,
page 886.
Associate Function Blocks with Instruments

This feature enables you to associate a function block with a particular instrument.
You use this feature if for some reason, the current tag number has not been
associated with any function block through the tag's instrument type or if you need to
change some of the associations. Note that the association or any changes made to
the association will affect the current tag number only. For more information, see
Associate Function Blocks with Instruments, page 889.
Related Topics

Define Foundation Fieldbus and Profibus Instrument Type

Profiles
2. In the Instrument Types dialog box, from the Process function list, select an
appropriate process function.
• Click New to create a new instrument type.
• In the data window, select an existing instrument type.
4. Click Profile.
5. In the Instrument Type Profile dialog box, on the General tab, under
Specification, select an appropriate fieldbus specification.
6. Select Include I/O type, and then from the list, select one of the following:
• Foundation Fieldbus
• Profibus DP
• Profibus PA
7. On the Wiring and Control System tab, select the appropriate reference device
panel and reference cable.
8. Click the Fieldbus tab.
Tip
• This tab is available only when you select Foundation Fieldbus from
the Include I/O type list. For Profibus instruments, click OK to
complete the procedure.
9. On the Fieldbus tab, select the Include fieldbus check box.
10. Type a fieldbus tag name.
11. Type a fieldbus device address.
12. Type a device identification.
13. Type a DC consumption value in milliamperes.
14. Enter a capacitance setting and select the required unit of measure.
15. Enter a minimum transmit level value.
16. Set a default operating voltage value.
17. Select the Backup link master check box to set new fieldbus instruments as
backup link masters that will take over control functions for the loop in case of
DCS failure.

18. Click Function Block to associate function blocks with instrument types. For
details, see Associate Function Blocks with Instrument Types, page 881.
19. Click OK in the Instrument Type Profile dialog box.
Related Topics
• Managing Fieldbus Instruments Common Tasks, page 884
Create Foundation Fieldbus and Profibus Instruments

1. Press F7 to open in the Domain Explorer.
the Instruments folder, and then click New > Instrument.
expand the Loops folder, right-click a loop, and then click New >
Instrument.
Tip
• To create new fieldbus tag numbers from the Fieldbus Tag Numbers
browser, right-click somewhere in the browser, and then click New
Fieldbus Tag. Continue as described below.
4. On the New Tag Number dialog box, from the Tag class list select one of the
following:
• Foundation Fieldbus— an instrument that can be associated with a
Foundation Fieldbus segment.
• Profibus DP— an instrument that can be associated with a Profibus
DP segment.
• Profibus PA— an instrument that can be associated with a Profibus
PA segment.
5. Under Tag number, type the name of the new tag number, and then, click OK.
to associate with the current tag number, and then, click OK.

7. Click OK.
Tips
• If the tag number does not correspond to an existing loop name,
the tag number you have entered. If the loop identifier already
matches an existing loop, the software will automatically associate the
new tag number with the loop.
number.
If a profile exists for the selected instrument type, any new tags for
that instrument type will be created with the selected reference items.
• For DeltaV compatibility, you must select an instrument type that you
associated with a DeltaV device type during the downloading process.
• Type the loop number that the new tag is associated with.
Note that if a loop with the same name exists, the tag number is
automatically associated with it, without creating a new loop.
9. Click OK to create the loop number.
or modify them as you require and then click OK.
11. On the Tag Number Properties dialog box, on the General tab, enter the tag
number attributes that you require.
Tip
• For DeltaV compatibility, make sure that the value that you select
from the Manufacturer list is among the acceptable values for the
instrument type that you selected for the current tag.
12. On the Fieldbus tab, to define the fieldbus properties for the new instrument, type
the fieldbus tag name.
13. Type the field device address if necessary.
14. Type the device ID if necessary.
15. If the new tag functions as a backup that takes over DCS functions in case of DCS
failure in the current segment, select Backup link master.

16. Type the manufacturer's fieldbus device revision number if necessary.

Tips
• If your DeltaV interface preferences are set for fieldbus mode, the
Fieldbus device revision field is a list, from which you must select a
revision.
• SmartPlant Instrumentation uses the values that you enter below to
validate fieldbus segments. For details, see Generate a Validation
Report for One Segment, page 928.
17. Type the DC current consumption of the current instrument, for example, 35 mA.
18. Type the capacitance and the capacitance unit of measure, for example 5 pF.
19. Type the minimum transmit level of the current instrument, for example, 2.5
volts.
20. Type the operating voltage range, for example, 9 – 35 volts.
21. To modify the function block association of the new instrument, in the Function
blocks association group box, under Unassociated function blocks, select a
function block that you want to associate with the instrument, and click
Associate.
Tips
• If your DeltaV interface preferences are set for fieldbus mode, your
selection of manufacturer and of fieldbus device revision determine
function block association for the current tag.
• The following two options are available only if you enabled them in
the Function Blocks dialog box.
22. To change the number of copies of the function block, in the Associated function
blocks data window, under Multiple, type the value.
23. To set the execution time, under Execution Time, type the time value (in
milliseconds).
24. Enter power supply properties.
25. Click OK.
Related Topics

Associate Function Blocks with Instruments

1. In the Domain Explorer, expand the Instruments folder and then right-click a
tag number.
3. In the Tag Number Properties dialog box, click the Fieldbus tab.
4. Under Unassociated function blocks, select the function block that you want to
associate, and click Associate.
5. To set the maximum number of instruments that can be associated with the
current function block, in the Associated function blocks data window, under
Multiple, type the value. (The Multiple field is editable only if it was enabled in
the Function Blocks dialog box.)
6. To set the execution time, under Execution Time, type the time value (in
milliseconds). (The Execution Time field is editable only if it was enabled in the
Function Blocks dialog box.)
7. Click OK.
Related Topics
• Define Foundation Fieldbus and Profibus Instrument Type Profiles, page
885

Managing Segments Common Tasks

The following tasks are used frequently when you manage segments for your
Create a Foundation Fieldbus Segment

A Foundation Fieldbus segment is a group of devices physically connected by a
single pair of wires to a host control device. This procedure explains how to add a
new segment to your fieldbus system. For more information, see Create a
Foundation Fieldbus Segment, page 891.
Edit the Properties of a Foundation Fieldbus Segment

This feature allows to edit the properties of a Foundation Fieldbus segment. You can
rename a segment, select another segment-wide parameter profile, and set the
segment as intrinsically safe. For more information, see Edit the Properties of a
Foundation Fieldbus Segment, page 892.
Delete a Fieldbus Segment

Use this feature to delete a segment. For more information, see Delete a Fieldbus
Segment, page 894.
Associate an Instrument with a Segment

This feature enables you to associate a segment with a particular instrument. You use
this feature if for some reason, the current tag number has not been associated with
any segment or if you need to change some of the associations. Note that the
association or any changes made to the association will affect the current tag number
only. For more information, see Associate an Instrument with a Segment, page 892
Dissociate an Instrument from a Segment

You use this procedure when you need to dissociate a particular instrument from its
segment. For more information, see Dissociate an Instrument from a Segment, page
893.
Change Instrument / Segment Association

You use this procedure when you need to dissociate a particular instrument from its
segment. For more information, see Change Instrument / Segment Association, page
893.
Enable a Function Block for I/O Assignment

This procedure shows how to enable a function block for I/O assignment. You can do
this after associating an instrument with a segment. Note that without enabling
function blocks, segment I/O assignment cannot be effected. For more information,
see Enable a Function Block for I/O Assignment, page 894.

Change the View in the Fieldbus Tag Numbers Browser

This option allows you to change the current view of the Fieldbus Tag Numbers
browser. The view, (that is, the available fields) depends on the current view in the
Fieldbus Tag Number List browser. For more information, see Change the View in
the Fieldbus Tag Numbers Browser, page 894.
Related Topics
Create a Foundation Fieldbus Segment

1. In the Domain Explorer, right-click the Fieldbus Segments folder.
2. On the shortcut menu, click New > Fieldbus Segment.
3. On the Foundation Fieldbus Segment Properties dialog box, under Segment,
type a unique name for the new segment.
4. Select a profile from the Segment-wide parameter profile list. If necessary,
click to open the Segment-Wide Parameter Profile dialog box to edit or
define a new segment-wide parameter profile. For details, see Define Segment-
Wide Parameters, page 875.
• Select Intrinsically safe for this segment. SmartPlant Instrumentation
warns you if any instruments currently associated with this segment
are not intrinsically safe. The software also warns you if an instrument
you try to associate with this segment in the future is not intrinsically
safe.
• Clear Intrinsically safe. SmartPlant Instrumentation warns you if any
instruments currently associated with this segment are intrinsically
safe. The software will also warn you if an instrument you try to
associate with this segment in the future is intrinsically safe.
6. Click OK to create the new segment.
Related Topics
• Connect a Home-Run Cable to a Plug-and-Socket Box, page 921
• Managing Segments Common Tasks, page 890

Edit the Properties of a Foundation Fieldbus Segment

1. In the Domain Explorer, double-click the Fieldbus Segments folder.
2. Right-click a segment and then on the shortcut menu. click Properties.
3. In the Foundation Fieldbus Segment Properties dialog box, under Segment,
type a unique name for the new segment.
4. Select a profile from the Segment-wide parameter profile list. If necessary,
click to open the Segment-Wide Parameter Profile dialog box to edit or
define a new segment-wide parameter profile. For details, see Define Segment-
Wide Parameters, page 875.
• Select Intrinsically safe for this segment. SmartPlant Instrumentation
warns you if any instruments currently associated with this segment
are not intrinsically safe. The software also warns you if an instrument
you try to associate with this segment in the future is not intrinsically
safe.
• Clear Intrinsically safe. SmartPlant Instrumentation warns you if any
instruments currently associated with this segment are intrinsically
safe. The software will also warn you if an instrument you try to
associate with this segment in the future is intrinsically safe.
Related Topics
Associate an Instrument with a Segment

1. On the Wiring module menu bar, click Actions > Fieldbus Tag Numbers
Browser.
2. In the Fieldbus Tag Numbers browser, select an appropriate tag number.
3. Drag the highlighted instrument to the required segment in the Fieldbus
Segments folder of the Domain Explorer.
Notes
• The associated instrument appears under the selected segment in the
Fieldbus Segments folder of the Domain Explorer.
• A fieldbus instrument can be associated only with one fieldbus segment.
However, you can associate multiple tag numbers with a given fieldbus
segment.

Dissociate an Instrument from a Segment

2. Expand the hierarchy of a segment.
3. Right-click an instrument and then on the shortcut menu, click Actions >
Dissociate Item.
Note
• The Segment Name field in the Instruments
Related Topics
Change Instrument / Segment Association
Browser.
2. In the Domain Explorer, double-click the Fieldbus Segments folder and expand
the appropriate segments.
3. Right-click an instrument tag, and then, on the shortcut menu, click Actions >
Dissociate Item from Segment.
4. In the Fieldbus Tag Numbers browser, select the dissociated tag and drag it to
the target segment in the Fieldbus Segments folder.
Notes
• You cannot change the segment association of a connected instrument
before disconnecting its wiring.
• The Segment Name field in the Fieldbus Tag Numbers
Related Topics

Delete a Fieldbus Segment

2. Select a segment you want to delete, and do one of the following:
• Press the Delete key.
• Right-click a segment and then on the shortcut menu, click Delete.
3. Click Yes to confirm the segment deletion.
Note
• After deleting a segment, the software dissociates all the associated
instruments and deletes the relevant virtual tags.
Related Topics
Enable a Function Block for I/O Assignment

1. In the Domain Explorer, under Fieldbus Segments, expand the appropriate
segment to display the associated instruments.
2. Right-click the required function block under the highlighted tag number.
3. On the shortcut menu, click Actions > Enable.
Related Topics
Change the View in the Fieldbus Tag Numbers Browser

1. Predefine the required Fieldbus Tag Number List Browser views in the Index
Browser Group of the Browser Manager.
2. In the Fieldbus Tag Numbers browser, do one of the following:
• Click Actions > Select Browser View for Segments.
• Click
3. In the Segment Views dialog box, select the required view and then click OK.

Managing Fieldbus Cables Common Tasks

The following tasks are used frequently when you manage fieldbus cables for your
Create a Home-Run Cable

A home-run cable is the main communication highway between devices on a fieldbus
network. A home-run cable serves the spurs in a given segment, and has a terminator
at either end. For more information, see Create a Home-Run Cable, page 895.
Create a Spur Cable

A spur is a part of a segment that drops off from the main segment (home-run) trunk.
A spur may contain one or more instruments and cables that connect them to the
home-run segment. For more information, see Create a Spur Cable, page 896.
Related Topics
Create a Home-Run Cable

2. Right-click the Cables folder and then on the shortcut menu, click New > Home-
Run Cable.
3. In the Cable Configuration dialog box, do one of the following:
• From the Cable configuration list, select an appropriate cable
configuration (for example, Fieldbus cable).
• Define a new cable configuration.
4. Click Create.
5. In the Cable Properties dialog box, under Cable, type a unique name.
Tip
• In the Cable Properties dialog box, make sure that you select
Fieldbus home-run from the Cable class list.
6. Complete the creation of the home-run cable using the general procedure for
creating a new cable.
Related Topics
• Associate a Segment with a Home-Run Cable, page 922
• Managing Fieldbus Cables Common Tasks, page 895

Create a Spur Cable

2. Right-click the Cables folder and then on the shortcut menu, click New > Cable.
3. In the Cable Configuration dialog box, do one of the following:
• From the Cable configuration list, select an appropriate cable
configuration (for example, Fieldbus cable).
• Define a new cable configuration.
4. Click Create.
5. In the Cable Properties dialog box, under Cable, type a unique name.
Tip
• In the Cable Properties dialog box, make sure that you select
Conventional from the Cable class list.
6. Complete the creation of the home-run cable using the general procedure for
creating a new cable.
Related Topics
• Managing Fieldbus Cables Common Tasks, page 895

Fieldbus Plug-and-Socket Boxes: An Overview

You need plug-and-socket boxes to connect Foundation Fieldbus instruments to a
spur or a home-run cable that has a plug-and-socket connection.
SmartPlant Instrumentation supports active plug-and-socket junction boxes, that is,

plug-and-socket junction boxes that require power supply. You can define the current
consumption, open circuit voltage, and short-circuit protection for an active plug-and-
socket junction box. When generating a segment validation report, the software takes
these values into account when calculating the total segment current consumption and
voltage drop for a particular segment.
You use the Plug-and-Socket Box Wizard to create the required plug-and-socket
boxes or reconfigure the existing ones.
Plug-and-socket boxes can be device panels or junction boxes.
Related Topics
• Managing Fieldbus Panels (Plug-and-Socket Boxes) Common Tasks, page
898

Managing Fieldbus Panels (Plug-and-Socket Boxes)

Common Tasks
The following tasks are used frequently when you manage panels for your Foundation
Fieldbus and Profibus systems.
Create a Plug-and-Socket Device Panel

This procedure explains how to create a new plug-and-socket device panel. For more
information, see Create a Plug-and-Socket Device Panel, page 899.
Edit the Properties of a Plug-and-Socket Device Panel

This procedure explains how to modify the properties of a plug-and-socket device
panel. For more information, see Edit the Properties of a Plug-and-Socket Device
Panel, page 901.
Create a Plug-and-Socket Junction Box

This feature allows to create a plug-and-socket junction box. For more information,
see Create a Plug-and-Socket Junction Box, page 900.
Edit the Properties of a Plug-and-Socket Junction Box

This feature explains how to modify the properties of a plug-and-socket junction box.
For more information, see Edit the Properties of a Plug-and-Socket Junction Box,
page 902.
Related Topics
• Connect a Home-Run Cable to a Plug-and-Socket Box, page 921

Create a Plug-and-Socket Device Panel

then on the shortcut menu click New > Device Panel (Plug-and-
Socket).
• Double-click the Panels by Category folder, right-click the Device
Panels folder and then on the shortcut menu click New > Device
Panel (Plug-and-Socket).
3. In the Plug-and-Socket Box wizard, follow all the instructions carefully and then
click Next until you complete the wizard.
Notes
• You can click next to a list arrow to access the appropriate supporting
table. This allows you to add, edit, or delete select list items.
• When defining the plug-and-socket box connectors, under Connector
type definition display, SmartPlant Instrumentation displays the
connector sequence, the appropriate pin number, and the pin polarities
according to the configuration of the connector than you selected.
Related Topics
898

Create a Plug-and-Socket Junction Box

then on the shortcut menu click New > Device Panel (Plug-and-
Socket).
• Double-click the Panels by Category folder, right-click the Device
Panels folder and then on the shortcut menu click New > Device
Panel (Plug-and-Socket).
3. In the Plug-and-Socket Box wizard, follow all the instructions carefully and then
click Next until you complete the wizard.
Notes
Related Topics
898

Edit the Properties of a Plug-and-Socket Device Panel

• Double-click the Panels by Location folder, right-click a device panel
and then on the shortcut menu click Properties.
• Double-click the Panels by Category folder, right-click a device panel
3. In the Plug-and-Socket Box wizard, follow all the instructions carefully and click
Next until you complete the wizard.
Notes
• The software does not allow you to modify port and connector
configurations of an existing plug-and-socket device panel.
Related Topics
898

Edit the Properties of a Plug-and-Socket Junction Box

• Double-click the Panels by Location folder, right-click a junction box
• Double-click the Panels by Category folder, right-click a junction box
Notes
• The software does not allow you to modify port and connector
configurations of an existing plug-and-socket junction box.
Related Topics
898

Working with Terminators: An Overview

Terminators are used to terminate and provide impedance compensation at a segment
end. Two terminators are needed for each segment — one on the DCS/PLC
terminal side (beginning of the segment) and the other on its other end.
There are two types of terminators — internal terminators (in relation to a

terminating block) and external (fitted on as a separate accessory).
You can create internal or external terminators as required, whether it is a terminal

apparatus strip or a plug-and-socket termination block.
You create internal terminators using the configuration tools when creating plug-and-
socket boxes or termination blocks. External terminators are added to the termination
block (an apparatus or a plug-and-socket box) during the wiring design phase.
Related Topics
• Managing Terminators Common Tasks, page 904

Managing Terminators Common Tasks

The following tasks are used frequently when you manage terminators for your
Create an External Terminator in a Plug-and-Socket Box

This feature enables you to create an external terminator in an existing plug-and-
socket box. For more information, see Create an External Terminator in a Plug-and-
Socket Box, page 905.
Create an External Terminator on a Terminal Strip

You can place an external terminator on a terminal in an apparatus or a conventional
terminal strip, i.e., a junction box, marshaling rack, and so forth. For more
information, see Create an External Terminator on a Terminal Strip, page 905.
Move an External Terminator to Another Port in a Plug-and-Socket Box

Usually, an external terminator is added when you create a plug-and-socket box. You
can disconnect a terminator or move it to another port in a plug-and-socket box if
required. For more information, see Move an External Terminator to Another Port in
a Plug-and-Socket Box, page 906.
Create an Internal Terminator

Internal terminators are usually added when creating plug-and-socket boxes and
termination blocks. You can also add an internal terminator to an existing plug-and-
socket box or termination block if it hasn't been done during the creation process. If a
plug-and-socket box does not contain an internal terminator, edit the properties of the
required box in the Plug-and-Socket Box wizard. For more information, see Create
an Internal Terminator, page 906.
Terminator (Plug-and-Socket Box) — Segment Association

After creating an external terminator, you need to associate it with an existing
segment. This option enables you to associate an external terminator with an existing
segment where the terminator is located in a plug-and-socket box. For more
information, see Terminator (Plug-and-Socket Box) — Segment Association, page
907.
Terminator (Terminal Strip) — Segment Association

After creating an external terminator, you need to associate it with an existing
segment. This option enables you to associate an external terminator with an existing
segment where the terminator is located on a terminal strip. For more information,
see Terminator (Terminal Strip) — Segment Association, page 907.
Related Topics
• Fieldbus Bricks: An Overview, page 908

Create an External Terminator in a Plug-and-Socket Box

1. In the Domain Explorer select a plug-and-socket box.
2. Right-click the selected plug-and-socket box and then on the shortcut menu, click
3. In the Plug-and-Socket Box Connection window, right-click the required port
and then on the shortcut menu, click New Terminator.
4. In the Plug-and-Socket Box Terminator dialog box, make sure the correct port
is displayed in the Port list. Select the required port if needed.
5. Click Create to add the new terminator and close the dialog box.
Note
• You can now associate this terminator with a segment. Right-click the
selected terminator and then on the shortcut menu, click Associate
Segment.
Related Topics
• Working with Terminators: An Overview, page 903
Create an External Terminator on a Terminal Strip

1. In the Domain Explorer, select a panel.
2. Right-click the selected panel and then on the shortcut menu, click Actions >
Connection.
3. In the Connection window, make sure that the required terminal strip is selected
in the Terminal Strip list.
4. Right-click the required terminal and then on the shortcut menu, click New
Terminator.
5. In the New Terminator dialog box, make sure the correct first terminal is
displayed in the First terminal list.
Select the required first terminal if needed.
6. Select an appropriate terminal side.
7. Enter the required number of terminals that you want to terminate.
The new terminator appears in pink next to the selected terminal. You can now
associate the terminal with a segment.
Related Topics

Create an Internal Terminator

1. In the Domain Explorer, select a plug-and-socket box.
Properties.
3. In the Plug-and-Socket Box wizard, click Next twice till you open the Modify
the Plug-and-Socket Layout page in the Plug-and-Socket Box wizard.
4. Select the Internal Terminator check box and click Next.
5. Continue configuring the plug-and-socket box as needed.
Related Topics
Move an External Terminator to Another Port in a Plug-and-

Socket Box
3. In the Plug-and-Socket Box Connection window, right-click the required port
and then on the shortcut menu, click Disconnect Selected Items.
4. Right-click the required port and on the shortcut menu, click New Terminator.
5. In the Plug-and-Socket Box Terminator dialog box, make sure the correct port
is displayed in the Port list. Select the required port if needed.
Note
• You can now associate this terminator with a segment. Right-click the
selected terminator and then on the shortcut menu, click Associate
Segment.
Related Topics

Terminator (Plug-and-Socket Box) — Segment Association

3. In the Plug-and-Socket Box Connection window, click the required connected
home-run cable to select it.
4. Right-click the highlighted home-run cable and on the shortcut menu, click
Associate Segment to open the Segment Association dialog box.
5. From the Associate segment list, select a segment with which you want to
associate the current terminator.
Tip
• If the required segment is not available on the Associate segment list,
select the Include all segments option button in the Segment filter
group box.
6. Click OK to make the association.
Related Topics
Terminator (Terminal Strip) — Segment Association

1. In the Domain Explorer, expand the hierarchy of a panel.
2. Right-click an appropriate fieldbus strip and then on the shortcut menu, click
3. In the Connection window, make sure that the required terminal strip is selected
in the Terminal strip list.
4. Right-click the required terminator and on the shortcut menu, click Associate
Segment to open the Segment Association dialog box.
5. From the Associate segment list, select a segment with which you want to
associate the current terminator.
Tip
• If the required segment is not available on the Associate segment list,
group box.

Fieldbus Bricks: An Overview

When designing your Foundation Fieldbus or Profibus system, you need to create a
Fieldbus brick assembly. A fieldbus brick assembly is a composite object that
consists of a wiring equipment item (fieldbus brick) and an apparatus group. An
apparatus group constitutes an apparatus strip (that is, a terminal strip) with a number
of apparatuses created according to a selected apparatus configuration.
When creating a fieldbus brick, you can define power supply requirements and
current consumption. Adding an apparatus to a fieldbus brick, entails the definition
of an apparatus configuration and the number of apparatuses that you need. Note that
the power supply requirements and current consumption values are common to all the
existing apparatuses belonging to the apparatus group that exists under a fieldbus
brick. Therefore, changing an electric property values affects all the apparatuses that
exist under that fieldbus brick.
When generating a segment validation report, the software takes into account the
fieldbus brick electric properties and validates the total current of a segment.
We recommend that first you create your equipment in the Reference Explorer so
that you have as many typical configurations as possible. Then, you can copy these
typical configurations to the Domain Explorer and this way create numerous
fieldbus bricks on the fly.
Related Topics

Managing Fieldbus Brick Assemblies and

Apparatuses Common Tasks
The following tasks are used frequently when you manage fieldbus brick assemblies
and apparatuses for your Foundation Fieldbus and Profibus systems.
Create a Fieldbus Brick Assembly

When designing your Foundation Fieldbus or Profibus system, you need to create a
fieldbus brick assembly. A fieldbus brick assembly is a composite object that
consists of a wiring equipment item (fieldbus brick) and an apparatus group. An
apparatus group constitutes an apparatus strip (that is, a terminal strip) with a number
of apparatuses created according to a selected apparatus configuration. When
creating a fieldbus brick, you can define power supply requirements and current
consumption. Note that if there are several apparatuses under a fieldbus brick, the
power supply requirements and current consumption values are common to all the
existing apparatuses belonging to that fieldbus brick. Therefore, changing an electric
property values affects all the apparatuses that exist under that fieldbus brick.
We recommend that first you create your equipment in the Reference Explorer so
that you have as many typical configurations as possible. Then, you can copy these
typical configurations to the Domain Explorer and this way create numerous
fieldbus bricks on the fly.
For more information, see Create a Fieldbus Brick Assembly, page 910.

To create a fieldbus brick assembly, you must have a predefined apparatus group
configuration An apparatus group constitutes an apparatus strip (that is, a terminal
strip) with a number of apparatuses created according to a selected apparatus
configuration. When defining an apparatus configuration, you define the apparatus
profile (name, description, manufacturer, and model), the number of apparatuses, the
apparatus terminal configuration, and the position numbering. For more information,
see Configure a Fieldbus Apparatus, page 912.
Related Topics

Create a Fieldbus Brick Assembly

2. Double-click the Panels folder, and select a panel.
3. Right-click the selected panel and then on the shortcut menu, click New > Wiring
Equipment.
4. On the New Wiring Equipment dialog box, from the Category list, select
Fieldbus brick.
5. Under Name, type the name of the new fieldbus brick and click OK.
6. In the Wiring Equipment Properties - Fieldbus Brick dialog box, on the
General tab, type the name of the new fieldbus brick.
7. Select the Double width check box if the fieldbus brick occupies a double width
slot or position.
b. Select a type, model, and manufacturer. If the required value is not available
on the list, click to define a new one.
c. Enter a sequence if you need to define the card sequence.
9. Click the Category Properties tab to enter the power supply requirement and
current consumption values for the reference fieldbus brick.
Tip
• Fieldbus brick is a wiring equipment category that is shipped with
category properties that have been shipped with the software.
However, you can add user-defined properties which you can rename
or delete as you wish. Note that the software uses the Current
consumption and the User-defined current consumption values in
segment validation reports.
10. Click the Associated Symbols tab to associate a symbol with this item . The
Utility.
12. In the Reference Explorer, right-click the new fieldbus brick, then on the

13. In the Apparatus dialog box, select the required configuration from the
Configuration name list. Make sure that this is configuration is compatible with
fieldbus and that the Fieldbus apparatus check box is selected.
Tip
• If you do not have an appropriate apparatus configuration, create one.
(For details, see Configure a Fieldbus Apparatus, page 912).
14. Enter the number of apparatuses that you require.
15. Click Create.
Tip
• SmartPlant Instrumentation automatically assigns sequential position
numbers to each apparatus. You can edit them later if required.
16. In the Terminal Strip Properties dialog box, define the new apparatus strip as
required click OK.
17. Click Close in the Apparatus dialog box.
Tip
• The new apparatus appears in the Reference Explorer under the
current fieldbus brick.
18. Drag the new fieldbus brick to a panel in the Domain Explorer.
Tip
• The software copies the fieldbus brick assembly that includes the
fieldbus brick and the apparatus.
19. In the Terminal Strip Properties dialog box, rename the fieldbus brick, modify
the other properties as you require, and then click OK.
20. Connect the apparatus to the appropriate cables. Select the apparatus strip you
want to connect and click . The Connection window opens displaying the
apparatus terminals in yellow:
Related Topics
• Managing Fieldbus Brick Assemblies and Apparatuses Common Tasks,
page 909


and select a panel.
and select a panel.
a panel.
3. Right-click a panel to which you want to add a fieldbus termination block and
then on the shortcut menu, click New > Apparatus Group.
4. In the Apparatus dialog box, click New.
6. Select the Fieldbus apparatus check box.
7. Select the Internal terminator check box if you need to add an internal
terminator on the new termination block.
8. In the Description field, type a short description for the new configuration.
9. From the Manufacturer list, select the appropriate termination block
to add or edit values for this list.
10. From the Model list, select the appropriate termination block model. If the
for this list.
termination blocks to be added. This way you can have a block of more than one
termination block to a strip.
12. In the Apparatus numbering group box, type the apparatus name in the Prefix
field if required.
Tip
• Apparatus names can be 15-character long. This name will appear in
the Domain Explorer within the new strip (only the first four
characters), in the Connection window, and in the appropriate reports.

13. Select the Numbered check box to number the apparatuses.

14. In the Apparatus configuration group box, from the Orientation list, select one
of the following apparatus terminal patterns:
• Left / Right— a termination block that has two sides: input and
output (that is, left and right).
• Left— a termination block that has wires on the left side only.
• Right— a termination block that has wires on the right side only.
• Regular— a termination block that has a conventional terminal that
functions as a single unit.
15. Do the following to define the apparatus terminal name and color:
a. Click in the left and/or right terminal side text box and type the required
terminal name, for example 1A:
b. Select a color of the terminal side from the list, for example red:
16. Repeat steps 17 and 18 for the other terminal side if appropriate. Note that the
line between the two terminal list arrows represents the internal relation between
the input and output terminals.
17. Click Add Terminal to add another terminal to this apparatus configuration if
needed and then repeat steps 14 through 16.
18. Click Delete Terminal if you need to delete a selected terminal from the current
configuration.
19. Click Save and then Close. You can now add the required termination block as
needed.
Related Topics
page 909

Making Connections and Associations for Fieldbus

Common Tasks
The following tasks are used frequently when you make connections and associations
in you fieldbus system. Before you can associate a segment with a home-run cable or
connect a home-run cable to a plug-and-socket box, you need to configure various
connector types assign connector pins to wires.
Define or Edit a Connector Type

A connector type contains pin configuration and other properties for a connector
model of a specific manufacturer. When you create a connector for a specific cable,
selecting a connector type copies these properties for the cable connector. For more
information, see Define or Edit a Connector Type, page 916.
Define or Edit a Connector Type Pin Configuration

This topic explains how to define or edit a pin configuration for a connector type. For
more information, see Define or Edit a Connector Type Pin Configuration, page 916.
Delete a Connector Type

This topic shows how to delete a connector type. For more information, see Delete a
Connector Type, page 917.
Create a Connector

Assign Connector Pins to Cable Wires

This procedure shows how to assign connector pins to cable wires. For more
information, see Assign Connector Pins to Cable Wires, page 919.

Associate a Pin or a Terminal with a Channel

SmartPlant Instrumentation enables you to associate terminals and pins with wiring
equipment channels. Note that these terminals and the terminal strip must belong to
the same parent wiring equipment. Also, if you want to associate pins, the pins must
belong to a connector which is a child item of the parent wiring equipment.
After you drag a terminal or a pin to a wiring equipment channel, the software retains
it in its original place from which you dragged it. However, after expanding the
destination hierarchy, the software also shows the terminal or pin that you dragged.
This means that the terminal or pin is physically located in its original place but it is
associated with the item to which it was dragged.
For more information, see Associate a Pin or a Terminal with a Channel, page 920.
Delete a Connector
This topic shows how to delete a connector. For more information, see Delete a
Connector, page 920.
Connect a Home-Run Cable to a Plug-and-Socket Box

After creating the required plug-and-socket boxes and home-run cables with
connectors, you can start connecting the your home-run cables to plug-and socket
boxes. For more information, see Connect a Home-Run Cable to a Plug-and-Socket
Box, page 921.
Associate a Segment with a Home-Run Cable

After connecting a home-run-cable to a plug and socket box or a fieldbus brick, you
can associate the home-run cable or its cable-set with a segment. For more
information, see Associate a Segment with a Home-Run Cable, page 922.
Related Topics

Define or Edit a Connector Type

1. On the Wiring module menu bar, click Tables > Connector > Types.
2. In the Connector Types dialog box, do one of the following:
• To create a new connector type, click New.
• To edit an existing connector type, click in the field that you want to
edit.
3. Under Connector Type, type a unique name.
4. To specify the connector type for a specific manufacturer, model, and part
number, do any of the following:
• Under Manufacturer, select an appropriate connector manufacturer.
• Under Model, select an appropriate model.
• Under Part Number, type the part number you require.
Note
• You can now define a pin configuration for this connector type. For
details, see Define or Edit a Connector Type Pin Configuration, page 916.
Related Topics
• Making Connections and Associations for Fieldbus Common Tasks, page
914
Define or Edit a Connector Type Pin Configuration

2. In the Connector Types dialog box, select the connection type that you want to
configure, and click Configure.
3. In the Connector Type Configuration dialog box, do one of the following for
each pin that you want to configure:
• To add a new pin, click New.
• To delete a pin, select the row that you want to delete and click Delete.
• To edit a pin field, click the field.
4. To change the displayed pin sequence, under Sequence, type the new unique
number.
5. To set the pin name, under Name, type the unique name.
6. To set the pin polarity, under Polarity, select the value that you require.

Delete a Connector Type

2. In the Connector Types dialog box, select the connector type that you want to
delete.
3. Click Delete.
Note
• SmartPlant Instrumentation removes the item that you delete from the
Connector Types dialog box from the Connector type list.
Related Topics
914

Create a Connector
•Right-click an existing cable, and on the shortcut menu click
Properties.
2. Modify cable properties as needed.
the End 1 tab.
the End 2 tab.
5. In the Connector Assignments dialog box, click New.
6. In the Connector Properties dialog box that opens, under Connector, type the
name of the new connector.
• From the list, select a connector type as configured.
• To modify or create a connector type, click . For details, see Define
or Edit a Connector Type, page 916.
Note
• You can now assign. For details, see Define or Edit a Connector Type Pin
Configuration, page 916.
Related Topics
914

Assign Connector Pins to Cable Wires

•Right-click an existing cable, and on the shortcut menu click
Properties.
2. Modify cable properties as needed.
the End 1 tab.
the End 2 tab.
• To validate that pin polarities that you set for this cable end are
consistent with wire polarities, select the Polarity validation check
box.
• To skip polarity validation, clear the Polarity validation check box.
6. For each connector pin, under Wires per Pin, select the number of wires that you
want to assign to the pin.
7. Under Cable Set, select the Cable Set from which you are assigning a wire to the
current pin. (Repeat this for each connector pin.)
8. Under Wire, select the wire that you assign to the pin. (Repeat this for each
connector pin.)
Notes
• The value that you enter under Wires per Pin determines the number of
rows displayed for a given pin.
• The software does not allow you to edit pin-wire assignment properties of
a connector that is connected (in the Connection window).
Related Topics
914

Associate a Pin or a Terminal with a Channel

Important
• After you drag a terminal or a pin to a wiring equipment channel, the
software retains it in its original place from which you dragged it.
However, after expanding the destination hierarchy, the software also
shows the terminal or pin that you dragged. This means that the terminal
or pin is physically located in its original place but it is associated with the
item to which it was dragged.
2. Expand a hierarchy to display the terminal or pin that you want to associate.
3. Drag your selection to the required wiring equipment channel.
Related Topics
914
Delete a Connector
1. In the Domain Explorer or Reference Explorer, right-click a cable, and on the
shortcut menu click Properties.
2. In the Cable Properties dialog box, click Connectors.
the End 1 tab.
the End 2 tab.
4. In the Connector Assignments dialog box, select the connectors that you want to
delete.
5. Click Delete.
Note
• The software does not allow you to delete a connector that is already
connected (in the Connection window).
Related Topics

Connect a Home-Run Cable to a Plug-and-Socket Box

2. Expand the Cables folder and select a home-run cable.
3. Right-click the selected cable and then on the shortcut menu, click Actions >
Connection.
4. In the Domain Explorer, expand the hierarchy of the fieldbus cable that you want
to connect to the current plug-and-socket box.
5. Drag the connectors to their ports in the current plug-and-socket box in the Plug-
and-Socket Box Connection window.
Tip
• Before you start dragging a connector, make sure that the cable
connector matches the port type on the plug-and-socket box.
6. In the Cable Connection Options dialog box, select the cable end that you want
to connect and click OK.
7. Repeat the above to connect other cables as needed.
Note
• To disconnect a home-run cable from the current plug-and-socket box,
highlight the cable that you want to disconnect and click .
Related Topics
• Create a Home-Run Cable, page 895
914
898
• Terminator (Plug-and-Socket Box) — Segment Association, page 907
• Terminator (Terminal Strip) — Segment Association, page 907

Associate a Segment with a Home-Run Cable

2. Select and then right-click a fieldbus plug-and-socket box or a fieldbus brick.
4. In the Connection or the Plug-and-Socket Box Connection window, click the
required connected home-run cable or a home-run cable-set to select it. For
example:
5. Right-click the highlighted home-run cable and on the shortcut menu, click
Associate Segment to open Segment Association dialog box.
6. From the Associate segment list, select the segment with which you want to
associate the current home-run cable.
Tip
• If the required segment is not available in the Associate segment list,
group box.
Note
• The name of segment you just associated is propagated along the entire
home-run cable.
Related Topics
• Create a Home-Run Cable, page 895
914

Managing Fieldbus I/O Cards and I/O Assignment

Common Tasks
The following tasks are used frequently when you manage fieldbus I/O cards and
effect I/O assignment for your Foundation Fieldbus and Profibus systems.
Create a Fieldbus I/O Card

You need to create fieldbus I/O cards so that you can associate segments and effect
I/O assignment.
You can create new I/O cards either in the Domain Explorer or the Reference
Explorer. If you are creating an I/O card that is going to have a frequently used
Reference I/O cards facilitate fast creation of plant I/O cards by copying an existing
I/O card configuration from the Reference Explorer to the Domain Explorer.
However, if you want to create an I/O card that does not have a configuration that you
intend to use frequently, we recommend that you create this card in the Domain
Explorer and in the <unit> where it is to be physically located. This is helpful when
filtering the I/O cards in the current <unit>.
For more information, see Create a Fieldbus I/O Card, page 924.
Effect Fieldbus I/O Assignment

You can effect I/O assignment after you make the required connections. For more
information, see Effect Fieldbus I/O Assignment, page 925.
Related Topics

Create a Fieldbus I/O Card

1. In the Domain Explorer or Reference Explorer, right-click a DCS or PLC panel
where you want to create a fieldbus I/O card.
2. On the shortcut menu, click New > Wiring Equipment.
3. In the New Wiring Equipment dialog box, under Category, select I/O card.
4. In the Wiring Equipment Properties - I/O Card dialog box, on the General tab,
do one of the following to name the new I/O card:
Naming Conventions.
5. Select the Double width check box if the card occupies a double width slot or
position.
6. In the Details group box, type a description as needed.
7. Select an I/O card type, model, and manufacturer. If the required value is not
8. Enter a sequence if you need to define the card sequence.
10. In the Control system details group box, under I/O type, select one of the
following I/O types to determine the actual function of the new I/O card:
• Fieldbus
• Profibus DP
• Profibus PA
11. Under Module, type the software address that the current card is assigned to.
Tip
manufacturer.


Tip
• A category property is a wiring equipment category property that you
can define yourself.
15. Click the Associated Symbols tab to associate a symbol with this item . The
Utility.
Related Topics
page 909
Effect Fieldbus I/O Assignment

1. In the Domain Explorer, select the DCS and PLC cabinets for which you want to
effect I/O assignment.
2. Right-click the panel that you selected and then on the shortcut menu, click
Actions > I/O Assignment.
3. In the Segment I/O Assignment window, under I/O card details, do the
following for each I/O card that requires I/O assignment.
a. Under I/O card, select the required I/O card.
b. For each segment for which you want to effect I/O assignment, drag it from
the Segments data window to the appropriate channel in the data window of
the I/O card details pane.
4. To cancel fieldbus I/O assignment for a given segment, drag it from the data
window of the I/O card details pane back to the Segments data window.
Notes
• To rename a selected control system tag, click , and in the dialog box
that opens, edit the tag properties.
• To view input/output information for the current I/O card, click .
• To generate an I/O Tag Assignment report, click .
Related Topics

Fieldbus Validation: An Overview

SmartPlant Instrumentation validates that you design fieldbus segment according to
basic connection rules and according to parameters that you set for a given segment:
On-the-Fly Connection Validations
Upon attempting to connect, the software verifies that:
• An instrument to be connected is not associated with another segment.

• A home-run cable to be connected is not already connected to another
segment.
• You are not associating or wiring a non-intrinsically-safe instrument to an
intrinsically safe segment. In this case, SmartPlant Instrumentation will
warn, but allow.
Segment-Report Validations
You perform other validations by running a report from the Fieldbus Tag Numbers
browser. SmartPlant Instrumentation notifies you in the report of a failed validation
in the following cases:
• There are fieldbus tags that are associated with a segment but not wired.
• There are fieldbus tags that have wiring, but are not yet connected to a
segment.
• There is a connection discontinuity between the field and a DCS or an I/O
terminal strip.
• The number of instruments in a segment exceeds the maximum specified
for that segment.
• The number of devices on a given spur exceeds the segment-wide
parameter profile.
• A spur length is exceeds the maximum set for that spur.
• Total cable length exceeds the maximum you defined for the segment
profile.
• There are less than two terminators in a segment.
• Actual voltage at instrument terminals is below the minimum operating
voltage.
• Total segment current consumption exceeds the maximum specified value.
• Total capacitance exceeds segment maximum specified capacitance.

Notes
• To define a cable type that supports fieldbus validation, make sure that in
the Cable Type Properties dialog box, you enter the required values for
capacitance, capacitance UOM (unit of measure), cable resistance, cable
resistance UOM, length UOM, and maximum fieldbus length.
• To define an instrument tag that supports fieldbus validation, make sure
that in the Tag Number dialog box you enter valid information under
Fieldbus Tag Number Properties Create Foundation Fieldbus and
Profibus Instruments, page 886).
• SmartPlant Instrumentation validation supports basic fieldbus networks
consisting of a single segment with no parallel branches and no repeaters.
Related Topics
• Define Segment-Wide Parameters, page 875
• Fieldbus Validation Common Tasks, page 928

Fieldbus Validation Common Tasks

The following tasks are used frequently when you generate validation reports for your
Generate a Validation Report for One Segment

This procedure shows you how to generate a validation report for one fieldbus
segment. Such a report allows you to verify that you created this segment according
to general connection rules and the specific segment-wide parameter profile
associated with each section. Note that SmartPlant Instrumentation will formulate
this type of report in the unit of measure set on the Cable Lengths tab of the
Segment-Wide Parameter Profile Properties dialog box. For more information,
see Generate a Validation Report for One Segment, page 928.
Generate a Validation Report for Multiple Segments

This procedure shows you how to generate a validation report for one of more
fieldbus segments. Such a report allows you to verify that you created fieldbus
segments according to general connection rules and the specific segment-wide
parameter profile associated with each segment. For more information, see Generate
a Validation Report for Multiple Segments, page 929.
Generate a Segment Wiring Report

Use this procedure to generate an enhanced report for a fieldbus segment. Note that
you must install the Enhanced Report Utility on your local machine to be able to
generate the communication line report. For more information, see Generate a
Segment Wiring Report, page 930.
Related Topics
Generate a Validation Report for One Segment

2. Select a segment and then on the shortcut menu, click Reports > Validation
Report.
Note
• SmartPlant Instrumentation formulates this type of report in the unit of
measure set on the Cable Lengths tab of the Segment-Wide Parameter
Profile Properties dialog box.
Related Topics

Generate a Validation Report for Multiple Segments

1. In the Domain Explorer, click the Fieldbus Segments folder.
2. In the Items pane of the Domain Explorer, select the segments that you require.
3. Right-click the selected segments and then on the shortcut menu, click Reports >
Validation Report.
Note
• You can also generate a validation report from the Fieldbus Tag
Numbers browser. For details, see Generate a Validation Report for
Multiple Segments from the Fieldbus Tag Numbers Browser, page 929.
Related Topics
Generate a Validation Report for Multiple Segments from

the Fieldbus Tag Numbers Browser
Browser.
2. Click .
3. On the Validation Reports dialog box, under Segment list, select the segments
that you require or click Select all to include all segments in the validation report.
4. Under Unit of measure for the report, select Feet or Meters.
5. Click Print.
Note
• You can also generate a validation report from the Fieldbus Tag
Numbers browser. For details, see Generate a Validation Report for
Multiple Segments, page 929.
Related Topics

Generate a Segment Wiring Report

2. Right-click on a segment, and then on the shortcut menu, click Reports >
Enhanced Segment Wiring.
3. At the print preview prompt, do one of the following:
• Click Yes to open the print preview of the generated report. Choose
this option if you want to modify or annotate the report.
• Click No to start printing the report without displaying its print
preview.
Notes
• You must install the Enhanced Report Utility on your local machine to be
able to generate the communication line report. For details, see Enhanced
Report Utility Installation Guide.
• In the General tab folder of the Preferences dialog box, you can set
SmartPlant Instrumentation to display a print preview always, never or
with your approval.
• If you select not to preview a report, and you are using Acrobat Distiller as
your default printer, make sure that Distiller is configured to enable report
generation without prompting for the output file location. To do this, open
the Distiller Preferences dialog box and under Output Options, clear the
check boxes Ask for PDF file destination and Ask to replace existing
PDF file.
Related Topics

Profibus Design: An Overview

SmartPlant Instrumentation supports the creation and maintenance of a Profibus
system.
SmartPlant Instrumentation supports Profibus technology which is based on a two-

level bus hierarchy, DP and PA Profibus segments. Each DP bus can connect
multiple addressable link hardware devices that link various types of input and output
devices. Every link device has a unique node number. The DP link devices that you
can connect to a DP bus can belong to one of the following types:
• Motor drive (connecting a VFD to a DP bus).

• PLC or DCS panel that connects a conventional I/O system of analog and
discrete field devices to a DP bus.
• DP/PA type that connects a lower PA (Process Automation) bus along
with its PA field devices to the DP bus (similar to Foundation Fieldbus
segments).
Profibus PA
Profibus PA segments and Profibus instruments have the same characteristics as

Foundation Fieldbus segments and Foundation Fieldbus instruments.
Related Topics

Flow of Activities for Profibus Design

The following is a suggested flow of activities for Profibus design in SmartPlant
Instrumentation. Note that you can carry out some of the procedures in a different
order, depending on your preferences or requirements.
1. Set the basic definitions as follows:
a. Define Profibus instrument type profiles – Prior to creating new Profibus tag
numbers, you need to customize wiring reference items and then define
appropriate instrument type profiles in the Instrument Index module so that
new tag numbers acquire Profibus properties. This results in automatic
assignment of the required properties to the new tag numbers. For details, see
Define Foundation Fieldbus and Profibus Instrument Type Profiles, page 885.
b. Add a new browser view – In the Browser module, create a browser view
with the required fields for the Fieldbus Tag Numbers browser. This
facilitates the assignment of tag numbers to segments. You can create
multiple Browser views with different Style, Sort, and Filter functions. For
example, by using the filter function you may create independent views for
each segment, so that only tags of that segment will be displayed in its
corresponding view.
2. Create the required DP segments.
• For details, see Create a Profibus DP Segment, page 935..
3. Create your PLC and/or DCS panels that are compatible with Profibus.
• For details, see Create a DP-Compatible PLC or DCS Panel, page
936.
4. Associate the PLC and DCS panels with the DP segments.
• For details, see Associate a PLC or DCS Panel with a Profibus DP
Segment, page 937.
5. Create the required Profibus DP multi-input instruments.
• Create these multi-input instruments with their connected I/O's. For
example, create a motor drive and insert it in an MCC cabinet. For
details, see Create a Multi-Input Instrument with Terminal
Connections for a Fieldbus Segment, page 950 and Create a Multi-
Input Instrument with Terminal Connections for a Fieldbus Segment,
page 950.
6. Associate the DP motor drives with the DP segments.
• For more information, see Associate Profibus DP Instruments with a
DP Segment, page 936.
7. Effect the DP segment I/O assignment.

8. Create the required PA segments.

• For more information, see Create a Profibus PA Segment, page 935.
9. Create the Profibus PA instruments.
• You create these tags based on the instrument types that you defined,
and edit the tag number properties as required. For more information,
see Create Foundation Fieldbus and Profibus Instruments, page 886.
10. Associate the PA instruments with the PA segments.
• For details, see Associate Profibus PA Instruments with a PA Segment,
page 935.
11. Generate a Profibus layout report.
• For details, see Generate an Enhanced Profibus Layout Report, page
937.

Profibus Design Common Tasks

The following is a suggested flow of activities for Profibus design in SmartPlant
Instrumentation. Note that you can carry out some of the procedures in a different
order, depending on your preferences or requirements.
Create a Profibus DP Segment

You need to create a DP bus prior to creating PA segments or any instruments that are
associated with Profibus. This procedure explains how to create a DP bus.. For more
information, see Create a Profibus DP Segment, page 935.
Create a Profibus PA Segment

This procedure explains how to create a Profibus PA segment. Note that you can
create a Profibus PA segment only if you already have an existing DP bus. For more
information, see Create a Profibus PA Segment, page 935.
Associate Profibus PA Instruments with a PA Segment

This procedure outlines the steps required to associate PA instruments with a PA
segment. Note that an instrument can be associated with one segment only. For more
information, see Associate Profibus PA Instruments with a PA Segment, page 935.
Associate Profibus DP Instruments with a DP Segment

Use this procedure to associate a Profibus DP device or an instrument (for example, a
motor drive) with a DP segment. For more information, see Associate Profibus DP
Instruments with a DP Segment, page 936.
Create a DP-Compatible PLC or DCS Panel

You need DP-compatible panels for your Profibus system. For more information, see
Create a DP-Compatible PLC or DCS Panel, page 936.
Associate a PLC or DCS Panel with a Profibus DP Segment

This procedure explains how to associate a PLC or a DCS panel with a DP segment.
For more information, see Associate a PLC or DCS Panel with a Profibus DP
Segment, page 937.
Generate an Enhanced Profibus Layout Report

This report allows you to view a schematic drawing of a Profibus segment. The
report includes one page per segment and shows all the associated devices and their
node numbers. For more information, see Generate an Enhanced Profibus Layout
Report, page 937.

Create a Profibus DP Segment

1. In the Domain Explorer, right-click the Fieldbus Segments folder.
2. On the shortcut menu, click New > Profibus DP Segment.
3. In the Profibus DP Segment Properties dialog box, under Segment, type a
unique name for the new segment.
Related Topics
Create a Profibus PA Segment

2. Right-click a DP segment and then on the shortcut menu, click New > Profibus
PA Segment.
3. In the Profibus PA Segment Properties dialog box, type the segment name.
4. Select a segment-wide parameter profile if needed. You can click to define a
new segment-wide parameter profile if you need one. For details, see Define
Segment-Wide Parameters, page 875.
5. Select the Intrinsically safe check box if you want to define the new segment as
intrinsically safe.
Related Topics
Associate Profibus PA Instruments with a PA Segment

Browser.
2. In the Fieldbus Tag Numbers browser, select one or more PA instruments.
3. Drag the instruments you selected to a PA segment in the Fieldbus Segments
folder of the Domain Explorer.
Note
• To dissociate a PLC or DCS panel from a DP segment, in the Domain
Explorer, right-click a panel in the Fieldbus Segment folder, then on the
shortcut menu, click Actions > Dissociate Item from Segment.

Associate Profibus DP Instruments with a DP Segment

Browser.
2. Select the required instruments in the browser.
• Click on the browser toolbar, select an unassociated instrument in

the Profibus DP Instruments pop-up window and drag it to a DP
segment in the Domain Explorer.
• In the Fieldbus Tag Numbers browser, select an unassociated
instrument and drag it to a DP segment in the Domain Explorer.
Note
• To dissociate an instrument from a DP segment, in the Domain Explorer,
right-click an instrument in the Fieldbus Segments folder, and then on the
Related Topics
Create a DP-Compatible PLC or DCS Panel

You can connect several different types of devices to a DP segment. As DP segments
are Ethernet buses, you can connect PLC or DCS panels to a DP segment via a
special I/O card.
You create a PLC or DCS panel compatible with a DP segment exactly the same way
you create any other PLC or DCS panel. While creating such a panel, make sure that
you select the Enable DP Profibus check box so that you can associate this panel
with a DP Profibus segment.
Related Topics

Associate a PLC or DCS Panel with a Profibus DP Segment

Browser.
2. In the Fieldbus Tag Numbers browser, do one of the following to open the
Profibus DP PLC/DCS Panels pop-up window:
• On the main menu, click View > Panels.
• Click on the browser toolbar.

Note
• To dissociate a PLC or DCS panel from a DP segment, in the Domain
Explorer, right-click a panel in the Fieldbus Segment folder, then on the
Related Topics
Generate an Enhanced Profibus Layout Report

2. Right-click a Profibus segment.
3. On the shortcut menu, click Reports > Enhanced Profibus Layout.
Related Topics

Working with HART Instruments: An Overview

HART (Highway Addressable Remote Transducer) technology is one of the first
fieldbus digital communication techniques that were implemented in instrumentation.
HART is a widely acceptable and recognized standard for digitally enhanced 4-20
milliamp smart instrumentation communication. This technology extends the 4-20
mA standard analog transmission with a superimposed digital signal that contains
process and instrument data.
The advantage of HART instruments is that they can be connected to standard 4-20
milliamperes systems and, at the same time; make use of digital communication to
collect additional data.
Related Topics
• Flow of Activities for HART Instrumentation, page 939

Flow of Activities for HART Instrumentation

The following is a suggested flow of activities for HART instrumentation in
SmartPlant Instrumentation. Note that you can carry out some of the procedures in a
different order, depending on your preferences or requirements.
1. Define the appropriate instrument types for HART instruments. When defining
the profile for HART instrument types you must select HART AI or HART AO as
the I/O type. For more information, see Define Instrument Type Profiles for
HART Instruments, page 940.
2. Create your HART instruments. HART instruments can be HART transmitters,
HART IP converters, and so on. For details, see Create a HART Instrument, page
940.
3. Create a virtual digital tag. Each HART instrument has a different set of digital
signals. The digital signals depend on the I/O type (AI or AO) and on the
instrument manufacturer who supplies the HART instruments with a specified
variety of possible digital signals. For more information, see Create a Virtual
Digital Tag, page 942.
4. Create I/O cards compatible with HART instruments. For details, see Create an
I/O Card Compatible with HART Instruments, page 943.
5. Connect the HART instruments to the appropriate HART I/O cards. You make
this connection by right-clicking an I/O card in the Domain Explorer and then
clicking Actions >Connection.
6. Effect I/O assignment for HART instruments. For details, see Effect I/O
Assignment for HART Instruments, page 943.

Define Instrument Type Profiles for HART Instruments

2. In the Instrument Types dialog box, from the Process function list, select an
• Click New to create a new instrument type.
• In the data window, select an existing instrument type.
4. Click Profile.
5. In the Instrument Type Profile dialog box, on the General tab, under
Specification, select an appropriate fieldbus specification.
6. Select Include I/O type, and then from the list, select one of the following:
• HART AI
• HART AO
7. On the Wiring and Control System tab, select the appropriate reference device
panel and reference cable.
8. Click OK in the Instrument Type Profile dialog box.
Related Topics
• Working with HART Instruments: An Overview, page 938
Create a HART Instrument

1. Press F7 to open in the Domain Explorer.
the Instruments folder, and then click New > Instrument.
expand the Loops folder, right-click a loop, and then click New >
Instrument.
a. From the Tag class list, select HART.
b. Type the name of the new tag number.
c. Click OK.

to associate with the current hart instrument, and then, click OK.
6. Click OK.
Tips
• Remember that you need to define appropriate instrument type profiles
for your HART instruments prior to creating them. These instrument
type profiles must include an I/O type which is either HART AI or
HART AO. For details, see Define Instrument Type Profiles for HART
• If the tag number does not correspond to an existing loop name,
the tag number you have entered. If the loop identifier already
matches an existing loop, the software will automatically associate the
new tag number with the loop.
number.
If a profile exists for the selected instrument type, any new tags for
that instrument type will be created with the selected reference items.
• For DeltaV compatibility, you must select an instrument type that you
associated with a DeltaV device type during the downloading process.
• Type the loop number that the new tag is associated with.
Note that if a loop with the same name exists, the tag number is
automatically associated with it, without creating a new loop.
8. Click OK to create the loop number.
or modify them as you require and then click OK.
10. On the Tag Number Properties dialog box, on the General tab, enter the tag
number attributes that you require.
Tip
• For DeltaV compatibility, make sure that the value that you select
from the Manufacturer list is among the acceptable values for the
instrument type that you selected for the current tag.
11. Enter power supply properties.
12. Click the HART tab to define the instrument parameters and create virtual digital
tags.

13. Select a signal type and linearity type values if needed.

14. From the Analog signal parameter list, select a parameter that is appropriate for
the analog signal of the current HART instrument.
Tip
• This selection is available only if the I/O type of the current instrument
is HART AI.
15. Enter the required DC consumption, capacitance, minimum transmit level, and
operating voltage.
16. Create the required virtual digital tags. For details, see Create a Virtual Digital
Tag, page 942.
Related Topics
Create a Virtual Digital Tag

1. In the Tag Number Properties dialog box, click the HART tab.
2. From the Analog signal parameter list, select an appropriate signal parameter.
3. In the Virtual tags group box, click New.
4. Click Yes in the prompt to save the changes to the tag properties.
5. In the New Virtual HART Tag Number dialog box, select a signal parameter,
enter the tag number name.
6. Click OK.
Note
• The signal parameter depends on whether the I/O type of the current
HART instrument is HART AI or HART AO.
Related Topics

Create an I/O Card Compatible with HART Instruments

To make an I/O card compatible with a HART instrument, you must select one of the
following I/O types when defining the control system properties of a new I/O card:
• HART AI
• HART AO
• AI
• AO
• MIXED
Related Topics
Effect I/O Assignment for HART Instruments

You effect I/O assignment for your HART instruments like with any other
instruments that require I/O assignment. In the Domain Explorer, right-click the
required I/O card and then click Actions > I/O Assignment.
Instruments Cards
AI AO HART AI HART AO
AI Yes No Yes (see note 1) No
AO No Yes No Yes (see note 1)
HART AI Yes (see note 2) No Yes No
HART AO No Yes (see note 2) No Yes
Mixed Yes Yes Yes (see note 3) Yes (see note 3)
Notes
• When assigning "non-HART" analog instruments to HART-compatible
I/O cards, the software assigns only the analog signals. (DI or DO are not
allowed anyway).
• You can assign HART instruments to conventional I/O cards (AI to
HART AI, AO to HART AO), but the software assigns only the analog
signals and not the virtual digital tags.
• You can assign HART instruments to I/O cards with MIXED I/O type, but
the software assigns only the analog signals and not the virtual digital tags.

Fieldbus and Conventional Multi-Input Devices: An Overview
Fieldbus and Conventional Multi-Input

Devices: An Overview
Many modern fieldbus or conventional digital instruments support more than one
input, for example, temperature transmitters and Bentley Nevada vibration monitors.
SmartPlant Instrumentation supports various configurations for instrument tags with
multi-input device panels. Note that multi-input devices can recognize input signals
from distant device panels.
For details, see Managing Multi-Input Devices Common Tasks, page 945.
Related Topics
• Managing Multi-Input Devices Common Tasks, page 945

Managing Multi-Input Devices Common Tasks

The following tasks are used frequently when you create and mange the fieldbus and
conventional multi-input devices in your plant.
You can create new multi-input devices either in the Domain Explorer or the
Reference Explorer. If you are creating a multi-input device that is going to have a
frequently used configuration, we recommend that you create it in the Reference
Explorer. Reference multi-input devices facilitate fast creation of plant multi-input
devices that are based on the configuration of an item in the Reference Explorer.
However, if you want to create a multi-input device that does not have a
configuration that you intend to use frequently, we recommend that you create this
multi-input device in the Domain Explorer and in the <unit> where it is to be
physically located. This is helpful when filtering the panels in the current <unit>.
Create a Multi-Input Device Panel with Terminal Connections

This procedure explains how to create a multi-input device panel that has terminal
connections. For more information, see Create a Multi-Input Device Panel with
Terminal Connections, page 947.
Create a Plug-and-Socket Multi-Input Device Panel

This procedure shows you how to create a plug-and-socket multi-input device panel.
For more information, see Create a Plug-and-Socket Multi-Input Device Panel, page
946.
Create a Multi-Input Instrument with Plug-and-Socket Connections for a

Fieldbus Segment
You use this procedure to create a multi-input instrument with plug-and-socket
connections for a fieldbus segment and then assign the signals to fieldbus I/O card
channels. For more information, see Create a Multi-Input Instrument with Plug-and-
Socket Connections for a Fieldbus Segment, page 948.
Create a Multi-Input Instrument with Terminal Connections for a

Fieldbus Segment
This procedure explains how to create a multi-input instrument with terminal
connections for a fieldbus segment. Also, you can assign the signals to fieldbus I/O
card channels. For more information, see Create a Multi-Input Instrument with
Terminal Connections for a Fieldbus Segment, page 950.

Create a Multi-Input Instrument with Terminal Connections for a Serial

Loop Interface
This procedure explains how to create a multi-input instrument with terminal
connections for a serial interface loop. Also, you can assign the signals to fieldbus
I/O card channels and generate an enhanced report for the wiring loop. For more
information, see Create a Multi-Input Instrument with Terminal Connections for a
Serial Loop Interface, page 953.
Related Topics
• Fieldbus and Conventional Multi-Input Devices: An Overview, page 944
Create a Plug-and-Socket Multi-Input Device Panel

• In the Domain Explorer, expand the Panels by Category folder.
• In the Reference Explorer, expand the Panels folder.
2. Right-click the Device Panels folder and then on the shortcut menu, click New >
Multi-Input (Plug-and-Socket).
3. In the Plug-and-Socket Box Wizard – Multi-Input Device, read the
instructions carefully and then click Next to open the Define the New Panel
page.
4. Under Panel name, type a unique device panel name.
5. Define the new panel by entering the panel type, manufacturer, model, area class,
location, mounting, dimensions, and backplane as needed.
6. To define the device panel as intrinsically safe, select Intrinsic safety.
7. Click Next, and on the Define the Plug-and-Socket Layout page, enter the
number of ports that you need on the left and on the right sides of the panel.
8. Click Next, and on the Define the Ports page, for each port that you created, type
the name and select In or Out.
Tip
• You must define one and only one out port.
9. Click Next, and on the Define the Plug-and-Socket Box Connectors page, for
each connector, do the following:
a. From the Connector type list, select the required connector, or click to
open the Connectors dialog box.
b. From the Male/female list, define the connector as Male or Female.
c. If these settings are constant for all of the connectors in the panel, select
Apply to all after you set the above.

10. Click Next and then click Finish.

Note
• You can delete the terminals that were created after completing the wizard
only when you delete the multi-input device panel.
Related Topics
• Create a Plug-and-Socket Device Panel, page 899
Create a Multi-Input Device Panel with Terminal

Connections
• In the Domain Explorer, expand the Panels by Category folder.
• In the Reference Explorer, expand the Panels folder.
2. Right-click the Device Panels folder and then on the shortcut menu, click New >
Multi-Input (Conventional).
3. In the Conventional Box Wizard – Multi-Input Device, read the instructions
carefully and then click Next to open the Define the New Panel page.
4. Under Panel name, type a unique device panel name.
5. Define the new panel by entering the panel type, manufacturer, model, area class,
location, mounting, dimensions, and backplane as needed.
6. To define the device panel as intrinsically safe, select Intrinsic safety.
7. Click Next, and on the Define the Multi Input Layout page, enter the number of
inputs and outputs that you need on the left and on the right sides of the panel.
8. Click Next, and on the Define the Multi Input page, for each multi input that
you created, type the name and select In or Out.
Tip
• Only one of the input/outputs can be defined as an output.
9. Click Next, and on the Define the Input / Output Configuration page, for each
connector, do the following:
a. From the Input/Output list, select the required input or output.
b. From the Configuration list, select an appropriate configuration.
c. Under First terminal, enter the first terminal as you require.
d. If these settings are constant for all of the inputs and outputs in the panel,
select Apply to all after you set the above.

10. Click Next and then click Finish.

Note
• You can delete the terminals that were created after completing the wizard
only when you delete the multi-input device panel.
Related Topics
Create a Multi-Input Instrument with Plug-and-Socket

Connections for a Fieldbus Segment
1. In the Reference Explorer, create reference panels that feed into the multi-input
device panel.
2. In the Reference Explorer, create a reference multi-input device panel with plug-
and-socket connections.
3. In the Reference Explorer, create reference spur cables.
Tips
• Use the same connector type required for the device panels.
• Set the male/female property for coupling with the device panels.
• In the Cable Properties dialog box, under Cable class, select
Conventional.
4. In the Instrument Index module, create instrument type profiles for multi-input
plug-and-socket socket fieldbus instruments and instruments that feed into the
multi-input instrument.
Tips
• For each instrument type, on the Wiring and Control System tab,
select the reference device panel and reference cable that you created
for each type.
• For the instrument type upon which you base the multi-input device
panel, make sure that you select the Fieldbus I/O type in the
Instrument Type Profile dialog box and that you associate enough
function blocks for the inputs. For details, see Define Foundation
Fieldbus and Profibus Instrument Type Profiles, page 885.

5. In the Instrument Index module, create the following, based on the instrument
types that you defined:
• Create the instrument tags that feed into the multi-input instrument tag.
• Create the multi-input instrument tag. Make sure that in the New Tag
Number dialog box, you select Fieldbus from the Tag class list.
6. In the Domain Explorer, right click the multi-input device panel that was
created, and on the shortcut menu, click Actions > Connection.
7. In the Plug-and-Socket Connection window, do the following to connect the
input device cables to the multi-input device panel.
a. In the Domain Explorer, expand the device cables that feed into the multi-
input device panel.
b. Drag the appropriate cable connectors to the in-ports of the multi-input device.
8. Do the following to route the multiplexed signal through a plug-and-socket
junction box:
a. In the Domain Explorer, right click the junction box, and on the shortcut
menu, click Actions > Connection.
b. In the Domain Explorer, expand the multi-input device cable.
c. Drag the appropriate cable connector to the desired in-port of the junction box
in the Plug-and-Socket Connection window.
9. Do the following to associate the multi-input tag signal with the available function
blocks in the target fieldbus segment:
a. In the Wiring Module window, click Actions > Fieldbus Tag Numbers
Browser.
b. Drag the multi-input device tag from the Instruments pane to the target
segment in the Fieldbus Segments folder of the Domain Explorer.
c. In the Fieldbus Segments pane, right click the multi-input device tag, and on
the shortcut menu, click Associate Multi-Input Device Tag.
d. Drag each tag from the Connected tags available for association pane to the
Function Block – Tag Association pane.
e. Click Close.

10. Do the following to assign the demultiplexed signals to the segment I/O card:
a. In the Domain Explorer, right-click the desired DCS, then on the shortcut
menu click Actions > I/O Assignment.
b. If the I/O Assignment dialog box opens, select Segment I/O assignment,
and click OK.
c. In the Segment I/O Assignment window, in the Segment list pane, select the
desired segment.
d. In the I/O card details pane, select the channel to which you want to assign
the demultiplexed signals.
e. Click Actions > Assign to a Channel.
Related Topics
Create a Multi-Input Instrument with Terminal Connections

for a Fieldbus Segment
device panel.
2. In the Reference Explorer, create a reference multi-input device panel with
terminal connections.
Tip
• In the Cable Properties dialog box, under Cable class, select
Conventional.
plug-and-socket socket fieldbus instruments and instruments that feed into the
Tips
for each type.
panel, make sure that you select the Fieldbus I/O type in the

7. In the Plug-and-Socket Connection window, connect the input device cables to
the multi-input device panel.
8. Do the following to route the multiplexed signal through a unction box:
a. In the Domain Explorer, right click the junction box, and on the shortcut
menu, click Actions > Connection.
b. In the Connection window, connect the multi-input device cable to the
junction box.
9. Do the following to associate the multi-input tag signal with the available function
blocks in the target fieldbus segment:
a. In the Wiring Module window, click Actions > Fieldbus Tag Numbers
Browser.
b. Drag the multi-input device tag from the Instruments pane to the target
segment in the Fieldbus Segments folder of the Domain Explorer.
c. In the Fieldbus Segments pane, right click the multi-input device tag, and on
the shortcut menu, click Associate Multi-Input Device Tag.
d. Drag each tag from the Connected tags available for association pane to the
Function Block – Tag Association pane.
e. Click Close.
10. Do the following to assign the demultiplexed signals to the segment I/O card:
a. In the Domain Explorer, right-click the desired DCS, then on the shortcut
menu click Actions > I/O Assignment.
b. If the I/O Assignment dialog box opens, select Segment I/O assignment,
and click OK.
c. In the Segment I/O Assignment window, in the Segment list pane, select the
desired segment.
d. In the I/O card details pane, select the channel to which you want to assign
the demultiplexed signals.
e. Click Actions > Assign to a Channel.
Related Topics

Create a Multi-Input Instrument with Plug-and-Socket

Connections for a Serial Loop Interface
device panel.
2. In the Reference Explorer, create a reference multi-input device panel with plug-
and-socket connections.
Tips
• For both types, in the Cable Properties dialog box, under Cable class,
select Conventional.
• Use the same connector type required for the device panels.
• Set the male/female property for coupling with the device panels.
• For the instrument type that you will use with the multi-input device
panel, create one connector only (for the device panel end). Leave the
second end without a connector, for terminal connection to the DCS
I/O card.
4. In the Instrument Index module, create instrument type profiles for instruments
with plug-and-socket multi-input serial interface and instruments that feed into the
Tips
for each type.
panel, make sure that you select the Serial Interface I/O type in the


input device panel.
8. In the Domain Explorer, right-click the DCS panel to which you connect the
output of the multi-input device panel, then on the shortcut menu, click Actions >
Connection.
Tip
• Make sure that the I/O type of the I/O card to which you connect the
multi-input device is SI.
9. In the Connection window, connect the output cable of the multi-input device
panel to the DCS.
10. To view the I/O assignment of the signals, click Actions > I/O Assignment.
Related Topics
Create a Multi-Input Instrument with Terminal Connections

for a Serial Loop Interface
device panel.
2. In the Reference Explorer, create a reference multi-input device panel with
Tips
• For both types, in the Cable Properties dialog box, under Cable class,
select Conventional.
• Do not create connectors for this reference cable.

instruments with terminal connections for a serial interface and instruments that
feed into the multi-input instrument.
Tips
for each type.
panel, make sure that you select the Serial Interface I/O type in the
• Create the instrument tags that feed into the multi-input instrument.
input device panel.
8. In the Domain Explorer, right-click the DCS panel to which you connect the
output of the multi-input device panel, then on the shortcut menu, click Actions >
Connection.
Tip
• Make sure that the I/O type of the I/O card to which you connect the
multi-input device is SI.
9. In the Connection window, connect the output cable of the multi-input device
panel to the DCS.
10. To view the I/O assignment of the signals, click Actions > I/O Assignment.
Related Topics

Telecom Design: An Overview

SmartPlant Instrumentation provides the ability to efficiently define and manage most
commonly used telecommunication equipment.
Here are a few examples of telecom equipment that you can create and manage:
• Field equipment (speakers, intercoms, telephones, and so forth)

• Public announcement (PA) equipment and amplifiers
• Switchboards
• Network equipment (hubs, switches, routers, and so forth)
• Miscellaneous equipment (video and entertainment equipment)
The software provides the means to define all the connections and the internal
equipment configuration. Furthermore, you can define and create the logical
structures (for example, channels, port, and so forth) as well the physical structures,
such as racks and cards.
You can generate appropriate reports, such as telecommunication field lists,

communication line diagrams (telecom point-to-point diagrams), network class
diagrams (network area maps), and so forth.
Note
• Telecom functionality is available only if it is included in the software
license that you purchased from Intergraph.
Related Topics
• Arrangement of Telecom Items in the SmartPlant Instrumentation
Explorer, page 958
• Flow of Activities for Telecom Design, page 956
• Working with Old Equipment, page 960

Flow of Activities for Telecom Design

The following is a suggested flow of activities that will help you design the
telecommunication system in your <plant>.
The first step in your telecom design is to create the reference telecommunication
equipment.
Then, in the Instrument Index module, you define telecommunication device types
(similar to instrument types for non-telecommunication devices). You can also define
telecom line numbers, field equipment (that is, equipment classification), and signal
levels. Now you can create your telecom tag numbers based on the telecom device
type that you defined. At this stage, you can generate various Instrument Index
reports as needed.
Once all the supporting table data is entered and all the telecom tags are created, you
start creating your telecom panels and telecom equipment based on the reference
equipment and reference panels you created previously. Make the required
connections among the your telecom equipment. You can then generate telecom
wiring reports as needed.
We recommend the following flow of activities:

1. In the Reference Explorer, create the following reference equipment:
a. Telecom cables with appropriate configurations
b. Telecom device panels
c. Telecom equipment panels with or without their internal equipment
d. Telecom equipment items such as amplifiers, switchboards, hubs, and so forth
that serve as the internal equipment of telecom panels
2. Start the Instrument Index module and define the following:
a. A telecom device panel type and device type profile defaults for telecom tags
b. Communication line numbers
c. Field equipment classification
d. Signal levels
3. Generate Instrument Index telecom reports if needed (telecom devices and various
telecom table reports).

4. In the Domain Explorer, do the following:

a. Create the telecom tag numbers that you require.
b. Create plant equipment panels with the necessary hardware shelves or racks.
c. Create the telecom equipment items that you require by copying the reference
items.
d. Define network classes.
e. Make all necessary connections.
5. Generate the Telecom reports in the Wiring module.
Related Topics
Explorer, page 958
• Telecom Design: An Overview, page 955

Arrangement of Telecom Items in the SmartPlant

Instrumentation Explorer
You use the Domain Explorer to access telecom panels and equipment. Typical
telecom equipment, that is, telecom reference equipment, is organized in the
Reference Explorer.
Telecom equipment is organized in several different folders in the Domain Explorer

and Reference Explorer. In the Domain Explorer, the following folders hold
telecom equipment:
• Telecom Panels— contains telecom panels arranged according to their

types:
• Field Devices— holds plug-and-socket as well as conventional field
device panels.
• Junction Boxes
• Splice Panels
• Patch Panels
• Distribution Frames
• Equipment Cabinets— holds PA cabinets, PABX cabinets, hub
cabinets, intercom cabinets, and miscellaneous cabinets for video and
entertainment systems)

• Old Equipment— contains telecom panels created prior to Version 7.

Note that you cannot create additional panels in this folder, but you
can add new child items, modify the properties of the existing items,
and delete the old equipment items, as you require.
• Panels by Manufacturer— arranges telecom panels according to
their manufacturers.
• Telecom Equipment— lists telecom panels and equipment classified
according to their types. Note that the items in this folder are for viewing
only.
Related Topics
Supporting Tables for Telecom

The following table lists all the available Telecom supporting tables and the
description of their functions. You can access these supporting tables by clicking
next to a list arrow or by clicking Tables > Telecom and then an appropriate
command in the Instrument Index and Wiring modules.
Table
Telecom Allows you to create and manage telecom device types. You define
Device Types the required telecom device type profile for your telecom tag numbers
so that new tags that you create can acquire the necessary properties.
SmartPlant Instrumentation provides a number of predefined telecom
device types, such as AL (alarm), CAM (camera), and so forth. You
can add new telecom device types and modify the shipped ones as
desired. You can also delete a telecom device type that is not in use,
but the software does not let you delete a telecom device type that you
already used to create a tag number.
Telecom Line Allows you to maintain the contents of the Telecom line list when
Numbers creating a telecom field device in the Plug-and-Socket Box wizard
and the Line number list on the Tag Number Properties dialog box.
Telecom Field Allows you to maintain the contents of the Field equipment select list
Equipment on the Tag Number Properties dialog box.
Telecom Allows you to maintain the contents of the Signal level select list on
Signal Levels the Tag Number Properties dialog box.
Panel Sub- Allows you to maintain the contents of the Sub-system select list on
Systems the Equipment Panel Properties dialog box.
Telephone Allows you to define new telephone numbers that you can associate
Numbers with existing switch channels in PABX cabinets.

Table
Telephone Allows you to manage the contents of the Telephone number status
Statuses
Telephone Allows you to manage the contents of the Telephone number usages
Usages
Intercom Allows you to define new intercom numbers that you can later
Numbers associate with amplifiers.
PA Zones Allows you to manage the PA zone definitions which are available for
selection on the Category Properties tab of the Wiring Equipment
Properties (Amplifier) dialog box.
Alarm Zones Allows you to manage the alarm zone definitions which are available
for selection on the Category Properties tab of the Wiring
Equipment Properties (Amplifier) dialog box.
PABX Allows you to manage the contents of the PABX categories select list
Categories on the PABX Cabinet Properties dialog box.
Working with Old Equipment

SmartPlant Instrumentation partially supports telecom panels created prior to Version
7. These panels and their child items are organized in the Old Equipment folder.
Note that you cannot create additional panels in this folder, but you can add new child
items, modify the properties of the existing items, and delete the old equipment items,
as you require.
Related Topics
Explorer, page 958

Creating and Managing Telecom Devices and

Cables Common Tasks
The following tasks are used frequently when you define and manage various
Telecom devices and cables.
Set Telecom Device Type Profile Defaults

You define a telecom device type profile for your telecom devices so that new
telecom tag numbers that you create acquire the necessary properties. SmartPlant
Instrumentation provides a number of predefined telecom device types, such as AL
(alarm), CAM (camera), and so forth. You can add new telecom device types and
modify the shipped ones as required. You can delete a telecom device type that is not
in use. However, SmartPlant Instrumentation does not let you delete a telecom
device type that you already used to create a tag number.
SmartPlant Instrumentation uses standard function identifier acronyms to identify

telecom device types. If some acronyms are not unique and are used for more than
one device type, the Select Telecom Type dialog box opens where you select the
appropriate device type.
After defining a device type, you set device type profile defaults for new telecom tag
numbers. As result, SmartPlant Instrumentation will create your new tag numbers
with certain predefined properties based on the telecom device type you select for the
new tag number. You set profiles for every telecom device type that you use.
For more information, see Set Telecom Device Type Profile Defaults, page 963.
Create a Telecom Field Tag

This procedure explains how to create new telecom tag numbers. Note that the new
tag numbers will be based on the telecom profile default that you defined. For more
information, see Create a Telecom Field Tag, page 964.

Create a Telecom Conventional Field Device

This procedure explains how to create a conventional telecom field device.
Conventional field devices are not plug-and- socket boxes. Conventional field
devices are connected to regular terminals.
You can create a new telecom field device panel in the Domain Explorer or the
Reference Explorer. If you are creating a panel that is going to have a frequently
For more information, see Create a Telecom Conventional Field Device, page 966.
Create a Telecom Plug-and-Socket Field Device

You use plug-and-socket boxes to connect telecom objects that have connectors. The
Plug-and-Socket Box Wizard enables you to create plug-and-socket boxes or
reconfigure the existing ones.
You can create a new telecom plug-and-socket box field device in the Domain
Explorer or the Reference Explorer. If you are creating a plug-and-socket box that
is going to have a frequently used configuration, we recommend that you create it in
the Reference Explorer. Reference plug-and-socket boxes facilitate fast creation of
plant plug-and-socket boxes by copying required configurations from the Reference
Explorer to the Domain Explorer. However, if you want to create a plug-and-
socket box that does not have a configuration that you intend to use frequently, we
recommend that you create it in the Domain Explorer and in the <unit> where it is
to be physically located. This is helpful when filtering the panels in the current
<unit>.
For more information, see Create a Telecom Plug-and-Socket Field Device, page 967.
Duplicate a Telecom Field Tag

This procedure explains how to create a new telecom field tag by duplicating the
properties of an existing one. You can then edit the new telecom field tag properties
as required. You can create the new duplicated telecom field tag in any <unit> of the
current domain. For more information, see Duplicate a Telecom Field Tag, page 965.

Create a Telecom Cable

This procedure explains how to create a telecom cable. When creating a cable, you
select an existing cable configuration that includes a particular arrangement of cable
sets (pairs, triads, and so forth within a cable) and wires to be built with the cable.
You can then add additional cable sets and wires to that cable if required.
If you are creating a cable that is going to have a frequently used configuration, we
recommend that you create it in the Reference Explorer. Reference cables facilitate
fast creation of plant cables by copying an existing cable configuration from the
Reference Explorer to the Domain Explorer. However, if you want to create a
cable that does not have a configuration that you intend to use frequently, we
recommend that you create this cable in the Domain Explorer and in the <unit>
where it is to be physically located. This is helpful when filtering the cables in the
current <unit>.
For more information, see Create a Telecom Cable, page 967.
Set Telecom Device Type Profile Defaults

1. On the Instrument Index Module window menu bar, click Tables > Telecom >
Telecom Device Types.
2. On the Telecom Device Types dialog box, do one of the following:
• Select an existing device type and click Profile.
• Click New and define a device type that you need and then click
Profile.
3. On the Telecom Device Type Profile dialog box, define the general default
settings for new telecom devices.
4. Click the Wiring tab if you need to define wiring default settings.
5. On the Wiring and Control System tab, select the Include wiring check box.
6. To define new device tags as control-system-enabled, select the Control system
check box. This enables the corresponding tag numbers for tag assignment.
7. To enable automated creation of coupled control system tags, select Automatic
CS tags.
8. From the Reference device panel list, select an appropriate reference panel for
this instrument type. These are device panels that were created in Reference
Explorer.

9. If your reference device panel settings enable the Conventional connections

on the Conventional Connection Properties dialog box, define the
settings that you require, and click OK.
10. If your reference device panel settings enable the Plug-and-socket connections
on the Plug-and-Socket Connection Properties dialog box, define
the settings that you require, and click OK.
Related Topics
Explorer, page 958
• Creating and Managing Telecom Devices and Cables Common Tasks,
page 961
Create a Telecom Field Tag

• In the Domain Explorer, right-click the Instruments folder and then
click New.
• On the Instrument Index Module window menu bar, click Edit >
Tag Number > New Tag Number.
2. On the New Tag Number dialog box, from the Tag class list, select Telecom.
3. Under Tag number, type the name of the new tag number.
Tip
• If more than one function identifier exists for the current telecom type
acronym, select an appropriate telecom device type on the Select
Telecom Type dialog box and then click OK.
4. On the New Tag Number dialog box, click OK.
to associate with the current telecom instrument, and then, click OK.

6. On the Tag Number Properties dialog box, enter appropriate values on the
General tab.
7. Click the Telecom tab and enter your values as needed.
8. If the current field tag requires power supply definitions, click the Power Supply
tab and enter your values as needed. Make sure that you have selected the
Requires power supply check box on the General tab.
9. Click OK to accept all the values that you have entered and to create the field tag.
Related Topics
Explorer, page 958
page 961
Duplicate a Telecom Field Tag

1. In the Domain Explorer, double-click the Instruments folder to display the
existing instruments.
2. Right-click a telecom field tag and then click Duplicate.
3. On the Duplicated Tag Number dialog box, under Tag number, type the name
of the new tag number.
4. To create the new field tag in the another <unit> of the current domain, select the
Create in another unit check box and do the following:
a. On the Open dialog box, select the target <unit> for the new field tag.
b. Click OK.
5. Click OK to duplicate the field tag and close the Duplicated Tag Number dialog
box.
Tip
• In SmartPlant Instrumentation, a device field segment of a telecom
field tag, for example, HO, is associated with an existing device type
acronym and description, for example, HO HOODS, ACOUSTIC. If
you have changed the telecom device field segment in the telecom tag
number and the system cannot recognize its association with the
existing device field, you must select a telecom device field from the
Select Telecom Device dialog box, and then click OK.
6. On the Tag Number Properties dialog box, modify the values as you require and
click OK.

Create a Telecom Conventional Field Device

1. In the Domain Explorer, double-click the Panels by Category folder and expand
the Telecom Panels folder.
2. Right-click the Field Devices folder and then on the shortcut menu click New >
Field Device (Conventional).
3. On the Device Panel Properties dialog box, on the General tab, under Panel,
type a name of the new panel.
6. Select the Set as intrinsically safe check box if this field device panel has
intrinsic safety certification.
8. Click OK to accept your definitions for the new field device panel and close this
dialog box.
Related Topics
Explorer, page 958
page 961

Create a Telecom Plug-and-Socket Field Device

2. Right-click the Field Devices folder and then on the shortcut menu click New >
Field Device (Plug-and-Socket).
Notes
• When defining plug-and-socket box connectors, under Connector type
definition display, SmartPlant Instrumentation displays the connector
sequence, the appropriate pin number, and the pin polarities according to
the configuration of the connector than you selected.
Related Topics
Explorer, page 958
page 961
Create a Telecom Cable

1. In the Domain Explorer, right-click the Cables folder.
2. On the shortcut menu click New > Cable.
3. On Cable Configuration dialog box, select an existing telecom cable
configuration or create a new one.
4. Click Create.
5. On the Cable Properties dialog box, under Cable, type a unique cable name.
6. Under Cable class, select Telecom.
7. Enter the rest of the cable properties as you require and click OK.
Related Topics
Explorer, page 958
page 961

Creating and Managing Telecom Panels Common

Tasks
The following tasks are used frequently when you define and manage various telecom
panels such as patch panels, junction boxes, and distribution frames.
You can create a telecom panel in the Domain Explorer or the Reference Explorer.
If you are creating a panel that is going to have a frequently used configuration, we
recommend that you create it in the Reference Explorer. Reference panels facilitate
fast creation of plant panels by copying an existing panel configuration from the
Reference Explorer to the Domain Explorer. However, if you want to create a
panel that does not have a configuration that you intend to use frequently, we
recommend that you create this panel in the Domain Explorer and in the <unit>
where it is to be physically located. This is helpful when filtering the panels in the
current <unit>.
Create a Telecom Junction Box

This procedure explains how to create a Telecom junction box. For more
information, see Create a Telecom Junction Box, page 969.
Create a Splice Panel

This procedure explains how to create a splice panel. For more information, see
Create a Splice Panel, page 970.
Create a Patch Panel

This procedure explains how to create a patch panel. For more information, see
Create a Patch Panel, page 972.
Create a Distribution Frame

This procedure explains how to create a distribution frame. For more information,
see Create a Distribution Frame, page 971.

Create a Telecom Junction Box

2. Right-click the Junction Boxes folder and then on the shortcut menu click New >
Telecom Junction Box.
3. On the Telecom Junction Box Properties dialog box, on the General tab, under
Panel, type the name of the new junction box.
5. Under Dimensions, type a value for the junction box dimensions if needed.
racks that will be possible to create in this junction box.
Tip
• Type zero if you want to have an unlimited number of racks.
9. Select the Set as intrinsically safe check box if this junction box has intrinsic
10. Click the Associate Symbols tab to associate a symbol with the current junction
box. The software will use this symbol when generating a report in the Enhanced
Report Utility.
12. Click OK to accept your definitions for the new panel and close this dialog box.
Related Topics
Explorer, page 958
• Creating and Managing Telecom Panels Common Tasks, page 968

Create a Splice Panel

2. Right-click the Splice Panels folder and then on the shortcut menu click New >
Splice.
3. On the Splice Panel Properties dialog box, on the General tab, under Panel,
type the name of the new panel.
5. Under Dimensions, type a value for the splice panel dimensions if needed.
racks that will be possible to create in this splice.
Tip
9. Select the Set as intrinsically safe check box if this splice panel has intrinsic
10. Click the Associate Symbols tab to associate a symbol with the current splice.
Report Utility.
11. Click Revisions to manage the revisions of the new splice panel if needed.
12. Click OK to accept your definitions for the new splice panel and close this dialog
box.
Related Topics
Explorer, page 958

Create a Distribution Frame

2. Right-click the Distribution Frames folder and then on the shortcut menu click
New > Distribution Frame.
3. On the Patch Panel Properties dialog box, on the General tab, under Panel, type
the name of the new panel.
5. Under Dimensions, type a value for the distribution frame dimensions if needed.
racks that will be possible to create in this distribution frame.
Tip
9. Select the Set as intrinsically safe check box if this distribution frame has
intrinsic safety certification.
10. Click the Associate Symbols tab to associate a symbol with the current
distribution frame. The software will use this symbol when generating a report in
the Enhanced Report Utility.
12. Click OK to accept your definitions for the new distribution frame and close this
dialog box.
Related Topics
Explorer, page 958

Create a Patch Panel

2. Right-click the Patch Panels folder and then on the shortcut menu click New >
Patch Panel.
3. On the Patch Panel Properties dialog box, on the General tab, under Panel, type
the name of the new panel.
5. Under Dimensions, type a value for the patch panel dimensions if needed.
racks that will be possible to create in this panel.
Tip
9. Select the Set as intrinsically safe check box if this panel has intrinsic safety
certification.
Report Utility.
12. Click OK to accept your definitions for the new panel and close this dialog box.
Related Topics
Explorer, page 958

Managing Equipment Cabinets and Equipment

Items Common Tasks
The following tasks are used frequently when you define and manage telecom
equipment cabinets in your plant.
SmartPlant Instrumentation allows you to create a number of equipment cabinets that

you can use for various purposes. Once you have created the cabinets you require,
you can create the appropriate equipment for each cabinet.
You can create an equipment cabinet in the Domain Explorer or the Reference
Explorer. If you are creating an equipment cabinet that is going to have a frequently
Reference equipment cabinets facilitate fast creation of plant equipment cabinets by
copying an existing cabinet configuration from the Reference Explorer to the
Domain Explorer. However, if you want to create an equipment cabinet that does
not have a configuration that you intend to use frequently, we recommend that you
create it in the Domain Explorer and in the <unit> where it is to be physically
located. This is helpful when filtering the panels in the current <unit>.
Create a PA Cabinet
This procedure explains how to create a PA cabinet. For more information, see
Create a PA Cabinet, page 975.
Create an Amplifier
The software allows you to add amplifiers to an existing PA cabinet. Once you have
created an amplifier, you can create strips and connectors under this amplifier. For
more information, see Create an Amplifier, page 976.
Add a Connector to an Amplifier

This procedure explains how to add a connector to an amplifier. In the SmartPlant
Instrumentation Explorer, connectors are child items of amplifiers and switches.
For more information, see Add a Connector to an Amplifier, page 977.
Create a PABX Cabinet

This procedure explains how to create a private automatic branch exchange (PABX)
cabinet. Then, you can add PABX racks and terminal strips to the new PABX
cabinet. For more information, see Create a PABX Cabinet, page 978.
Create a PABX Rack

This procedure explains how to create a rack in a private automatic branch exchange
(PABX) cabinet. For more information, see Create a PABX Rack, page 979.

Create a Switch
The software allows you to create switches after adding a rack to a PABX cabinet.
Once you have created a switch, you can add a switch port and a connector. For more
information, see Create a Switch, page 980.
Add a Switch Port

This procedure explains how to add a port to an existing switch. For more
information, see Add a Switch Port, page 981.
Add a Connector to a Switch

This procedure explains how to add a connector to a switch. In the SmartPlant
Instrumentation Explorer, connectors are child items of switches and amplifiers.
For more information, see Add a Connector to a Switch, page 981.
Create a Switch Channel

After creating a switch port, you can add a channel to this port. For more
information, see Create a Switch Channel, page 982.
Create and Associate a Telephone Number

This option allows you to create a telephone number in a PABX cabinet and
automatically associate it with a switch channel. For more information, see Create
and Associate a Telephone Number, page 982.
Associate a Telephone Number with a Channel

The software allows you to associate a telephone number with a switch channel.
Note that a switch channel can be associated with many telephone numbers. For
more information, see Associate a Telephone Number with a Channel, page 983.
Create a Miscellaneous Cabinet

Miscellaneous cabinets are intended for video equipment, entertainment systems, and
so forth. After creating a miscellaneous cabinet, you can add a rack and a terminal
strip. For more information, see Create a Miscellaneous Cabinet, page 984.
Create a Hub Cabinet

This procedure explains how to create a hub cabinet. After creating a hub cabinet,
you can add hub equipment. For more information, see Create a Hub Cabinet, page
985.
Create Hub Equipment

You can add hub equipment to a hub cabinet. Hub equipment is a type of wiring
equipment. After creating hub equipment, you can add a port and a hub connector.
For more information, see Create Hub Equipment, page 986.

Create a Hub Connector

This procedure explains how to add a hub connector to a hub.. For more information,
see Create a Hub Connector, page 987.
Add a Port to a Hub

This procedure explains how to add a port to a hub. For more information, see Add a
Port to a Hub, page 987.
Create an Intercom Cabinet

This procedure explains how to create an intercom cabinet. After creating an
intercom cabinet, you can add intercom equipment and a terminal strip. For more
information, see Create an Intercom Cabinet, page 988.
Add Intercom Equipment

This procedure explains how to add intercom to an intercom cabinet. For more
information, see Add Intercom Equipment, page 989.
Add an Intercom Connector

This procedure explains how to a connector to an intercom. For more information,
see Add an Intercom Connector, page 990.
Create a PA Cabinet
2. Right-click the Equipment Cabinets folder and then on the shortcut menu click
New > PA Cabinet.
3. On the PA Cabinet Properties dialog box, on the General tab, under Panel, type
the name of the new cabinet.
racks that will be possible to create in this cabinet.
Tip

certification.
10. Click the Associate Symbols tab to associate a symbol with the current cabinet.
Report Utility.
Related Topics
Explorer, page 958
• Managing Equipment Cabinets and Equipment Items Common Tasks,
page 973
Create an Amplifier
2. Expand the Equipment Cabinets folder and then right-click a PA cabinet to
which you want to add an amplifier.
3. On the shortcut menu click New > Amplifier.
4. On the New Wiring Equipment dialog box, type a name for the new amplifier
and click OK.
5. On the Wiring Equipment Properties - Amplifier dialog box, on the General
tab, under Name, accept or type a name of the new amplifier.
6. Select the Double width check box if the amplifier occupies a double width slot
or position.
b. Select an amplifier type, model, and manufacturer. If the required value is not
c. Enter a sequence if you need to define the amplifier sequence.

Tip
Related Topics
Explorer, page 958
page 973
Add a Connector to an Amplifier

1. In the Domain Explorer, right-click an amplifier to which you want to add a
connector.
2. On the shortcut menu click New > Connector.
3. On the Connector Properties dialog box, type a connector name.
4. Select a connector type. Click to add new connector types to this list.
5. Define the connector as male or female.
6. Select a panel side for the connector.
7. Click OK.
Related Topics
Explorer, page 958
page 973

Create a PABX Cabinet

New > PABX Cabinet.
3. On the PABX Cabinet Properties dialog box, on the General tab, under Panel,
type the name of the new cabinet.
Tip
certification.
Report Utility.
Related Topics
Explorer, page 958
page 973

Create a PABX Rack

1. In the Domain Explorer, expand the Telecom Panels folder, which is located
within the Panels by Category folder.
2. Expand the Equipment Cabinets folder and then right-click a PABX cabinet
where you want on create a rack.
3. On the shortcut menu click New > PABX Rack.
4. On the Rack Properties dialog box, on the General tab, under Rack, type the
name of the new rack
5. Type a brief description as you require.
6. Enter the rack sequence in its parent cabinet.
7. Click Slots to add slots to the current rack.
8. On the Batch Slot Creation dialog box, type the number of new slots that you
want to add in the new rack.
9. Do the following to define the slot numbering:
a. Type a prefix for the slot name.
b. Enter a value in the Start from number and Increment by fields.
10. Click OK to add the new slots and to return to the Rack Properties dialog box.
Tip
• On the Rack Properties dialog box, the software now displays the
number of slots that you added.
11. Click the Associate Symbols tab to associate a symbol with the current rack. The
Utility.
12. Click OK to accept your definitions for the new rack and close this dialog box.
Related Topics
Explorer, page 958
page 973

Create a Switch
2. Expand the Equipment Cabinets folder to display the existing PABX cabinets.
3. Double-click a PABX cabinet to display the existing PABX racks.
4. Right-click a PABX rack to which you want to add a new switch and then on the
shortcut menu, click New > Switch.
5. On the New Wiring Equipment dialog box, type a name for the new switch and
click OK.
6. On the Wiring Equipment Properties - Switch dialog box, on the General tab,
under Name, accept or type a name of the new switch.
7. Select the Double width check box if the amplifier occupies a double width slot
or position.
b. Select an amplifier type, model, and manufacturer. If the required value is not
c. Enter a sequence if you need to define the switch sequence.
Tip
Related Topics
Explorer, page 958
page 973

Add a Connector to a Switch

3. Double-click a PABX cabinet and then a PABX rack to display the existing
switches.
4. Right-click a switch to which you want to add a new connector and then on the
shortcut menu, click New > Connector.
7. Define the connector as male or female.
9. Click OK.
Related Topics
Explorer, page 958
page 973
Add a Switch Port

3. Double-click a PABX cabinet and then a PABX rack to display the existing
switches.
4. Right-click a switch to which you want to add a new port and then on the shortcut
menu, click New > Switch Port.
5. On the General tab of the Switch Port Properties dialog box, type a name for
the new switch port.
6. Click the Associate Symbols tab to associate a symbol with the current switch
port. The software will use this symbol when generating a report in the Enhanced
Report Utility.
7. Click OK.

Create a Switch Channel

3. Expand the hierarchy of a PABX cabinet and then double-click a PABX rack,
switch, and then a switch port.
4. Right-click a switch port to which you want to add a new channel and then on the
shortcut menu, click New > Switch Channel.
5. On the General tab of the Channel Properties dialog box, type a name for the
new channel.
6. Type a brief description if required.
7. Enter an appropriate sequence of the current channel in its parent switch port.
8. Click the Associate Symbols tab to associate a symbol with the current channel.
Report Utility.
9. Click OK to accept your settings and close this dialog box.
Related Topics
Explorer, page 958
page 973
Create and Associate a Telephone Number

3. Expand the hierarchy of a PABX cabinet and then double-click a PABX rack,
switch, and then a switch channel.
4. Right-click a switch channel and create a terminal if there is there is no terminal
under the current switch channel.
5. Right-click the Telephone folder and then on the shortcut menu, click New >
Telephone.
6. On the Telephone Properties dialog box, type a telephone number and
description as you require.

7. Select an appropriate telephone state and usage. If the values that you need do not
exist on the Telephone state and Telephone usage lists, you can add them in the
Telecom supporting tables in the Wiring module. To do this, in the Wiring
module, click Tables > Telecom > Telephone State or Telephone Usage.
8. Click OK.
Related Topics
Explorer, page 958
page 973
Create an Unassociated Telephone Number

1. In the Wiring module, click Tables > Telecom Telephone Numbers.
2. On the Telephone Numbers dialog box, click New.
3. Type an appropriate number, description, telephone state, and telephone usage as
you require.
4. Click OK.
Related Topics
Explorer, page 958
page 973
Associate a Telephone Number with a Channel

1. In the Domain Explorer, expand the hierarchy of a PABX panel to display the
existing racks, switches, switch ports, and terminals.
2. Right-click a channel, then on the shortcut menu, click Actions > Associate
Telephone Numbers.
3. On the Associate Telephone Numbers dialog box, select an available telephone
number and click Associate.
4. Click Close when done.

Create a Miscellaneous Cabinet

New > Miscellaneous Cabinet.
3. On the Miscellaneous Cabinet Properties dialog box, on the General tab, under
Panel, type the name of the new cabinet.
Tip
certification.
Report Utility.
Related Topics
Explorer, page 958
page 973

Create a Hub Cabinet

New > Hub Cabinet.
3. On the Hub Cabinet Properties dialog box, on the General tab, under Panel,
type the name of the new cabinet.
Tip
certification.
Report Utility.
Related Topics
Explorer, page 958
page 973

Create Hub Equipment

1. In the Reference Explorer or Domain Explorer, expand the Telecom Panels
folder.
2. Expand the Equipment Cabinets folder to display the existing hub cabinets.
3. Right-click a hub cabinet and then on the shortcut menu, click New > Hub
Equipment.
4. On the New Wiring Equipment dialog box, type a name for the new hub
equipment and then click OK.
5. On the General tab of the Wiring Equipment Properties - Hub dialog box, type
the name of the new hub.
6. Select the Double width check box if the hub occupies a double width slot or
position.
b. Select a hub type, model, and manufacturer. If the required value is not
c. Enter a sequence if you need to define the hub sequence.
Tip
Related Topics
Explorer, page 958
page 973

Create a Hub Connector

1. In the Domain Explorer or Reference Explorer, expand a hub cabinet hierarchy
to display the existing hub equipment and hub ports.
• Right-click a port to which you want to add a hub connector.
• Right-click the Hub Connectors folder.
3. On the shortcut menu, click New > Hub Connector.
6. Set whether the connector is male or female.
8. Click OK.
Related Topics
Explorer, page 958
page 973
Add a Port to a Hub

1. In the Domain Explorer or Reference Explorer, navigate to a hub cabinet.
2. Double-click a hub cabinet to display the existing hub equipment.
3. Right-click a hub equipment item and then on the shortcut menu, click New >
Port.
4. On the General tab of the Port Properties dialog box, type a name for the new
port.
5. Type a brief description if necessary.
6. Enter the port sequence in the hub if needed.
7. Click the Associate Symbols tab to associate a symbol with the current port. The
Utility.
8. Click OK.

Create an Intercom Cabinet

New > Intercom Cabinet.
3. On the Intercom Cabinet Properties dialog box, on the General tab, under
Panel, type the name of the new cabinet.
Tip
certification.
Report Utility.
Related Topics
Explorer, page 958
page 973

Add Intercom Equipment

1. In the Reference Explorer or Domain Explorer, expand the Telecom Panels
folder.
2. Expand the Equipment Cabinets folder to display the existing intercom cabinets.
3. Right-click an intercom cabinet and then on the shortcut menu, click New >
Intercom Equipment.
4. On the New Wiring Equipment dialog box, type a name for the new intercom
equipment and then click OK.
5. On the General tab of the Wiring Equipment Properties - Intercom dialog box,
type the name of the new intercom.
6. Select the Double width check box if the hub occupies a double width slot or
position.
b. Select a intercom type, model, and manufacturer. If the required value is not
c. Enter a sequence if you need to define the intercom sequence in the cabinet.
Tip
Related Topics
Explorer, page 958
page 973

Add an Intercom Connector

1. In the Domain Explorer or Reference Explorer, expand a hub cabinet hierarchy
to display the existing intercom equipment.
3. Right-click an intercom to which you want to add a connector.
4. On the shortcut menu, click New > Connector.
7. Set whether the connector is male or female.
9. Click OK.
Related Topics
Explorer, page 958
page 973

Generating Telecom Reports Common Tasks

The following tasks are used frequently when you generate telecom reports.
Generate a Telecommunication Device List

This option enables you to generate a report that lists all the existing
telecommunication devices in the current <unit> or all the <units> in the current
<plant>. The report lists all tag numbers (telecom devices), their service, device
types and line numbers, location layouts, field equipment and signal levels,
manufacturers and models, as well as the fire areas and load data. You generate this
report in the Instrument Index module. For more information, see Generate a
Telecommunication Device List, page 993.
Generate a Communication Line Report

You can generate a report that displays the connection path of all field device panels
on a selected communication line. The connection path includes all the connected
panels, their terminals and ports. For more information, see Generate a
Communication Line Report, page 992.
Generate a Speaker Load Report

This option allows you to generate a report that displays all the field device panels
connected to a specific channel in a selected equipment card. For more information,
see Generate a Speaker Load Report, page 993.
Generate a Telecom Device Type Report

This option allows you to generate a report that lists the existing telecom device
types. You can generate a standard list report or a detailed list report depending on
your needs. The standard report lists all the existing telecom device type acronyms
and their definitions. The detailed report provides additional information for every
telecom device type such as specification form number, reference panel and cable,
connection type, and so forth. For more information, see Generate a Telecom Device
Type Report, page 994.
Generate a Telecom Line Number Report

Telecom Line Numbers report lists all the existing line numbers, their descriptions,
origins and destinations, their types, and so forth. For more information, see
Generate a Telecom Line Number Report, page 994.
Generate a Telecom Field Equipment Report

This option enables you to generate a list of all the existing telecom field equipment.
The report lists the equipment ex-code, IS code gas group, temp. class, frequency
code, effect, and the telecom ID number. For more information, see Generate a
Telecom Field Equipment Report, page 994.

Generate a Telecom Signal Level Report

Signal level report lists all the existing telecom signals, their descriptions, and
capacity. For more information, see Generate a Telecom Signal Level Report, page
995.
Generate an Actual Load Report

This option enables you to generate an actual load report per channel for a selected
equipment card. This report includes the sum of all field device panels connected to a
specific channel. For more information, see Generate an Actual Load Report, page
995.
Generate a Communication Line Report

Important
• You must install the Enhanced Report Utility on your local machine to be
able to generate the communication line report. For details, see Enhanced
Report Utility Installation Guide.
1. In the Wiring Module window, click Reports > Telecom > Communication
Line Report.
2. On the Communication Line Selection dialog box, select a communication line
Click OK.
3. At the print preview prompt, do one of the following:
• Click Yes to open the print preview of the generated report. Choose
this option if you want to modify or annotate the report.
• Click No to start printing the report without displaying its print
preview.
Note
• On the General tab of the Preferences dialog box, you can set SmartPlant
Instrumentation to display a print preview always, never or with your
approval.
• If you select not to preview a report, and you are using Acrobat Distiller as
your default printer, make sure that Distiller is configured enable report
generation without prompting for the output file location. To do this, open
the Distiller Preferences dialog box and under Output Options, clear the
check boxes Ask for PDF file destination and Ask to replace existing
PDF file.
Related Topics
• Generating Telecom Reports Common Tasks, page 991

Generate a Speaker Load Report

1. In the Wiring Module window, click Reports > Telecom > Speaker Load
Report.
2. On the Panel – Strip Selection dialog box, click Find.
3. Select a card and click Print.
4. On the Print Preview Request, click Yes to display the report before printing it
or click No to print out the report without displaying it first.
Note
• You can also generate this report from the Domain Explorer. Expand the
hierarchy of a PA panel. Then, after right-clicking an amplifier, click
Reports > Speaker Load Report.
Related Topics
Generate a Telecommunication Device List

1. Switch to the Instrument Index module.
2. In the Instrument Index window, click Reports > Telecom Devices.
3. On the Report Selection Options, select one of the following options:
• Current <Unit> — include the telecom devices belonging to the
current <plant> only.
• Current <Area> — include the telecom devices belonging to the
current <area> only.
• All <Units> — include the telecom devices belonging to all the
<unit> in the current <plant>.
4. When prompted to preview the new report, click Yes. Click No to print out the
report without opening its print preview.
Related Topics

Generate a Telecom Device Type Report

2. In the Instrument Index window, do one of the following:
• Click Reports > Telecom Tables > Standard Telecom Type List.
• Click Reports > Telecom Tables > Detailed Telecom Type List.
Related Topics
Generate a Telecom Line Number Report

2. In the Instrument Index window, click Reports > Telecom Tables > Telecom
Line Numbers.
Related Topics
Generate a Telecom Field Equipment Report

Field Equipment.
Related Topics

Generate a Telecom Signal Level Report

Signal Level.
Related Topics
Generate an Actual Load Report

1. In the Wiring Module window, click Reports > Telecom > Actual Load
Report.
2. On the Panel – Strip Selection dialog box, click Find.
3. Select a card and click Print.
4. On the Print Preview Request, click Yes to display the report before printing it
or click No to print out the report without displaying it first.
Note
• You can also generate this report from the Domain Explorer. Expand the
hierarchy of a PA panel. Then, after right-clicking an amplifier, click
Reports > Actual Load Report.
Related Topics

Document Binder Module: An Overview

The Document Binder module is used to gather specifications and other related
SmartPlant Instrumentation documents that need to be maintained together. Each
collection of documents is known as a binder package. You can perform a collective
update for all the documents in a single binder package and assign them the same
revision number. You can specify two types of binder package: Specification Binder
packages and General Document Binder packages.
Important
• The software does not allow you to perform revisions for Specification
Binder packages when working in an integrated environment.
You can group documents according to any criteria you require. However, for
instrument specification sheets, a given instrument specification may only be
assigned to one Specification Binder package or to any number of General Document
Binder packages, but not to both types of binder packages.
For details of the options available in the tree for each binder package type, see:
• Specification Binder Packages, page 997

• General Document Binder Packages, page 998

Specification Binder Packages

You use Specification Binder packages to create groups of instrument specifications
for whatever purpose you require; for example, when requesting a price quotation
from a vendor for several instruments, you can group the instruments together in a
Specification Binder package and include other relevant documents.
The following folders are available:
• Specification List— This is a cover sheet with instrument tag data for all
the specifications included in the Specification Binder package.
• Form Notes— This contains user notes that apply to specific form
numbers. There must be at least one specification associated with a
particular form number in the Specification Binder package in order for
you to be able to add form notes.
• General Notes— General notes provide a means of adding user
comments that are associated with the Specification Binder package as a
whole.
• Specification Sheets— This category shows the specifications included
in the Specification Binder package, and provides you with the options to
access and edit individual sheets, to totally or partially revise the sheets in
the list, and to print all or some of the sheets.
• Change Summary Report— This shows details of the changes that were
made to the specifications since the last revision.
When the documents are created, each document type is numbered sequentially using
the following method:
• Specification Sheets: S-1, S-2, S-3, and so forth. The pages of a multi-tag
specification are identified by a number with a different suffix for each
page, for example, S-2.1, S-2.2, S-3.1, S-3.2, and so forth.
• Form Notes— G-1, G-2, G-3, and so forth.
• Change Summary Report— C-1, C-2, C-3, and so forth.
• General Notes— N-1, N-2, N-3, and so forth.
Page numbers are calculated from the relative position of the document in the
Specification Binder package. To recalculate the page numbers after modifying
specifications, click Actions > Repaginate.
Related Topics
• Document Management Common Tasks, page 999

General Document Binder Packages

You use General Document Binder packages to create groups of documents for
whatever purpose you require; for example, when requesting a price quotation from a
vendor for several items, you can group the items together in a General Document
Binder package and include other relevant documents.
The following folders are available:
• Document List— This is a cover sheet with data for all the documents
included in the General Document Binder package.
• Document Notes— This contains user notes that apply to specific
document numbers. There must be at least one document associated with
a particular document number in the General Document Binder package in
order for you to be able to add document notes.
• General Notes— General notes provide a means of adding user
comments that are associated with the General Document Binder package
as a whole.
• Documents— This category shows the documents included in the
General Document Binder package, and provides you with the options to
access and edit individual documents, to totally or partially revise the
documents in the list, and to print all or some of the documents.
Related Topics

Document Management Common Tasks

The following tasks are used when you work with a document binder package to
gather specifications and other related SmartPlant Instrumentation documents that
need to be maintained together.
Start the Document Binder Module

This procedure shows how you open the Document Binder module where you work
with document binder packages.
For more information, see Start the Document Binder Module, page 1001.
Create a New Binder Package

This procedure shows you how to create a new binder package. A binder package is
a group of documents or instrument specifications, and may include additional
general notes and form notes. On creation of a new binder package, the software
creates a complete set of folders. The software updates these folders as you assign
documents to the binder package.
For more information, see Create a New Binder Package, page 1001.
Assign an Instrument Specification to a Specification Binder Package

This procedure shows you how after creating a Specification Binder package, you can
assign instrument specifications to it. On assigning a specification, the software
automatically updates the Instrument Specification List. Furthermore, in the
browser view, the software sets the value in the Item Status column to Added for the
instrument tags associated with the newly assigned specification.
For more information, see Assign an Instrument Specification to a Specification

Binder Package, page 1002.
Edit Binder Package Properties

This procedure shows how you can edit the properties of a binder package. You can
rename a binder package and edit its description until the first time you add a revision
to it. After that you can only edit the purchase order number and requisition number.
For more information, see Edit Binder Package Properties, page 1003.
Remove Selected Instrument Specifications From a Specification Binder

Package
This procedure show how to remove selected instrument specifications from a
Specification Binder package when those specifications are no longer required.
For more information, see Remove Selected Instrument Specifications From a

Specification Binder Package, page 1004.

Remove a Single Instrument Specification From a Specification Binder

Package
This option shows how you can remove a single instrument specification from a
Specification Binder package when the specification is no longer required.
For more information, see Remove a Single Instrument Specification From a

Specification Binder Package, page 1005.
Remove All Instrument Specifications From a Specification Binder

Package
This option shows how you can remove all the instrument specifications from a
Specification Binder package when the specifications are no longer required.
For more information, see Remove All Instrument Specifications From a Specification
Binder Package, page 1006.
Delete a Binder Package

This procedure shows you how to delete a binder package. You can only delete a
binder package if it has not yet been saved as a revision. In this case, if the binder
package includes specifications, these must be removed first.
For more information, see Delete a Binder Package, page 1006.
Associate External Files with a Binder Package

These procedures show you how to manage external files that you associate with a
binder package. You can associate a new file with the binder package, dissociate a
file, or open an associated file. Associated files can be .doc, .txt, .bmp, .wav, .psr
files, or any file formats that are supported by your Windows system.
For more information, see Associate External Files with a Binder Package, page
1007.
Related Topics
• Document Binder Module: An Overview, page 996
• General Document Binder Packages, page 998
• Specification Binder Packages, page 997

Start the Document Binder Module

Note
• Before starting this module, check with the Domain Administrator that
you have been granted appropriate access rights for the tasks you will
carry out.
• To open the main Document Binder window, do one of the following:
• On the main toolbar, click .
• Click Modules > Document Binder.
Related Topics
Create a New Binder Package

1. Open the Document Binder module. For details, see Start the Document Binder
Module, page 1001.
2. In the Document Binder window, at the top of the left frame, select Binder
Packages.
3. Click Actions > New Binder Package.
4. On the New Binder Package dialog box, enter the following data:
• The binder package type (required)
• The binder package name (required)
• Description (optional)
• Purchase order number (optional)
• Requisition number (optional)
Tip
• For Specification Binder packages only, if you select Apply purchase
order and requisition number to all tags, the software adds this data
to all tags currently associated with the Specification Binder package.
As long as this checkbox is selected, the software adds this data to
every tag that you associate with the Specification Binder package.
5. Click OK.
Related Topics
• Assign a General Note to a Binder Package, page 1013
• Assign an Instrument Specification to a Specification Binder Package,
page 1002

Assign an Instrument Specification to a Specification

Binder Package
1. In a Specification Binder package, select the Specification Sheets folder.
2. Click Actions > Assign Specification. The Find Items dialog box opens, from
which you can retrieve tags. To filter the retrieved tags, enter values in the
selection fields.
3. Click Find to retrieve the list of tags.
4. From the list, select tags to be included in the Specification Binder package and
click OK. The list of tags appears under the Specification Sheets folder for the
5. To open a specification for viewing or editing, select a sheet from the list and do
• Click Actions > Open.
• Double-click the sheet.
Note
• To view information in the right area of the window in greater detail, in
the tree of the Preferences dialog box, expand the hierarchy Document
Binder > Specification Binder and under Select instrument
specification list display, select User-defined columns from Browser
module. When you display detailed data in the right area of the screen,
the software determines the layout according to the default view in the
Spec Binder Package Browser (under the Document Binder group).
You can customize this view in the Browser module.
Related Topics
• Create a New Binder Package, page 1001

Edit Binder Package Properties

1. In the Document Binder window, in the left frame, right-click the binder package
that you want to edit.
2. On the shortcut > Properties.
3. On the General tab, edit the following data as needed:
• Binder package name — after you save at least one revision, this
field is not available.
• Description — after you save at least one revision, this field is not
available.
• Purchase order number.
• Requisition number.
Note
• If you select Apply purchase order and requisition number to all
tags, the software updates all tags currently associated with the binder
package. As long as this checkbox is selected, the software adds this
data to every tag that you associate with the binder package.
4. Click OK.
Related Topics

Remove Selected Instrument Specifications From a

Specification Binder Package
1. In the Document Binder window, in the Binder Packages tree, do the following:
a. Expand the Specification Binder package from which you want to remove a
specification.
b. Select Specification Sheets.
2. Right-click the desired specification sheets, and on the shortcut > Remove
Selected Items.
3. On the Remove Selected Items dialog box, under Select, select the check box
beside each specification that you want to remove.
Tip
• You can select the Select all check box if you want to remove all the
specifications.
Notes
• You can choose whether SmartPlant Instrumentation keeps or deletes
revisions that you saved while the specification was part of the
• On removing a specification, the way in which the specification list is
updated depends on the following:
• If the specification was originally assigned prior to saving the last
revision of the Specification Binder package, the instrument tag still
appears in the specification list browser view, with the Tag Number
column set to Deleted.
• If the specification was originally assigned after saving the last
revision of the Specification Binder package, its tag does not appear in
the specification list.
Related Topics

Remove a Single Instrument Specification From a

Specification Binder Package
a. Expand the Specification Binder package from which you want to remove an
instrument specification.
2. In the right pane, select the specification that you want to remove.
3. Click Actions > Remove.
Notes
Related Topics

Remove All Instrument Specifications From a Specification

Binder Package
a. Expand the Specification Binder package from which you want to remove a
specification.
2. Click Actions > Remove All.
Notes
Related Topics
Delete a Binder Package

1. Remove any specifications from the binder package you want to delete, for details
see Remove All Instrument Specifications From a Specification Binder Package,
page 1006.
Tip
• If all specifications with a particular form number are deleted, the form
note associated with that form is automatically deleted.
2. Delete the binder package by doing one of the following:
• Click the right mouse button and on the shortcut > Delete.
Related Topics

Associate External Files with a Binder Package

For all of the procedures, do the following to open the Associated Documents dialog
box:
1. In the Document Binder window, select the binder package for which you want
to manage external files.
2. Click Actions > Associated Documents.
From the Associated Documents dialog box, you can perform the following
procedures:
Associate an External File With a Binder Package

1. In the Associated Documents dialog box, click Associate.
2. In the Associate External Document dialog box, navigate to the file, and click
Open.
3. In the Associated Documents dialog box, under Description, type a short
description for the associated file.
Open an External File That You Associated With a Binder Package
• On the Associated Documents dialog box, select the file that you want to
open, and click Open.
Dissociate an External File From a Binder Package
• In the Associated Documents dialog box, select the file that you want to
dissociate from the binder package, and then click Dissociate.
Related Topics
• Assign an Instrument Specification to a Specification Binder Package,
page 1002

Notes
There are three classes of notes that you can add to a binder package:
• Form Notes — A form note is associated with a particular form in a

Specification Binder package, and is used, for example, to indicate the
purpose of certain fields in the form.
• Document Notes— A document note is associated with a particular
document type in a General Document Binder package, and can be used,
for example, to indicate the purpose of certain fields in the document.
• General Notes — A general note can appear in a Specification Binder
package or in a General Document Binder package and is associated with
the binder package as a whole.
Notes
• On SQL Server, the General Note sheet can accept up to 255 characters;
on Oracle or Sybase Adaptive Server Anywhere, you can type up to 2000
characters.
Related Topics
• Create a Form Note, page 1011
• Notes Common Tasks, page 1009

Notes Common Tasks

The following tasks are used when you work with notes in the Document Binder
module.
Create a Form Note Template

This procedure shows you how to create a Form Note Template. Form note templates
are source forms used to create form notes.
For more information, see Create a Form Note Template, page 1010.
Edit a Form Note Template

This procedure shows you how to edit form note templates. Form note templates are
source forms used to create form notes in the Document Binder module.
For more information, see Edit a Form Note Template, page 1010.
Delete a Form Note Template

This option shows you how to delete form note templates.
For more information, see Delete a Form Note Template, page 1011.
Create a Form Note

This procedure shows you how to create a a form note. Form notes are notes that are
attached to a particular form. They can be used, for example, to indicate the purpose
of certain fields in the form where this is not clear to the user. They can also be used
to provide vendors with your standard company specifications. Form notes may only
be added for the forms with which the specification is associated. Consequently, if
you remove all the specifications associated with a particular form from the
Specification Binder package, the form notes for that form are deleted.
For more information, see Create a Form Note, page 1011.
Assign a General Note to a Binder Package

This option shows you how to create a general note to a binder package. General
notes apply to an entire binder package, which can be either a Specification Binder
package or a General Document Binder package.
For more information, see Assign a General Note to a Binder Package, page 1013.
Edit a Note
This procedure shows you how, after creating a note, you can edit the name,
description, and note text if desired.
For more information, see Edit a Note, page 1014.

Create a Form Note Template

1. Click Actions > Form Note Templates.
2. On the Form Note Templates dialog box, click New.
3. On the New Form Note Template dialog box, enter a name for the note template
(required) and description (optional) as follows:
a. Select a form from the Form list or click Select and select a form from the list
that appears.
The Template and Description fields are automatically filled with the
form or template name and description (if one exists).
b. If desired, overwrite the name displayed in the Template field. (a required
field.)
c. Enter text in the Description field if desired.
Note
• Form note template names must be unique.
4. Click OK.
Related Topics
• Delete a Form Note Template, page 1011
• Edit a Form Note Template, page 1010
Edit a Form Note Template

1. On the Form Note Templates dialog box, select the desired template.
2. Click Edit Text.
3. In the Note Editor window, edit the note name, description, and note text as you
desire.
Caution
• The text editor only allows you to paste text from the clipboard. You
can copy text from other text editors or word processing applications,
for example, Notepad or Microsoft Word. However, any formatting in
the original document will be lost when you paste the text into this
field. You should not attempt to paste graphics images, as this may
cause problems in the file later.
4. When done, click .
Related Topics

Delete a Form Note Template

1. Click Actions > Form Note Templates.
2. On the Form Note Templates dialog box, select the required template and click
Delete.
3. Click Yes to delete the note.
4. Click Close to close the window.
Related Topics
• Create a Form Note Template, page 1010
Create a Form Note

1. In the left pane, select the Form Notes folder.
2. Click Actions > New Form Note.
3. On the New Form Note dialog box, enter a name for the form note (required) and
description (optional) as follows:
a. Create a form note based on a form by selecting a form from the drop-down
list in the Form field or by clicking Select and selecting a form from the list
that appears.
• If any form note templates have been defined for the form you
selected, you can base the form note on one of these templates if
desired.
b. To base the form note on a template, select it from the Template list or click
Select and select the desired template.
Tip
• Selecting a form note template not only copies the name and
description to the form note but also uses the note text in the
template as default. For details of defining form note templates.
• The Form note and Description fields are automatically filled
with the form or template name and description (if one exists),
which overwrite the previous entries.
c. If desired, overwrite the name displayed in the Form note field (required
field).

d. Enter text (optional) in the Description field if desired.

Tip
• The names of form notes must be unique.
e. Click OK to open the Form Note Editor dialog box.
Tip
• If you selected to create a form note from a template, any note text
that was entered for the template will appear by default in the note
field.
f. Make any changes as required to the note name, the description, and the note
text itself.
Caution
•The text editor only allows you to paste text from the clipboard.
You can copy text from other text editors or word processing
applications, for example, Notepad or Microsoft Word, however,
any formatting in the original document will be lost when you
paste the text into this field. You should not attempt to paste
graphics images as this may cause problems in the file later.
g. When done, click .
Related Topics
• Edit a Note, page 1014

Assign a General Note to a Binder Package

1. Click the General Notes folder.
2. Click Actions > New General Note.
The Note Editor window opens, with the default general note name [New].
3. Change the name of the note from the default, enter a description (optional), and
type the desired note text.
Caution
•The text editor only allows you to paste text from the clipboard. You
field. You should not attempt to paste graphics images as this may
Notes
• On SQL Server, the Note sheet can accept up to 255 characters; on Oracle
or Sybase Adaptive Server Anywhere, you can type up to 2000 characters.
Related Topics
• Create a Form Note Template, page 1010
• Create a Form Note, page 1011

Edit a Note
1. Select one of the following folders:
• Form Notes.
• Document Notes.
• General Notes.
• Click Actions > Open to open the Note Editor window. (Continue at
step 3.)
• Expand the folder by double-clicking it. (Continue at step 4.)
3. Select the desired note from the list in the dialog box and click OK.
The Note Editor window opens. (Continue at step 5.)
4. Open the Note Editor window as follows:
a. Select the required note in the tree.
b. Do one of the following:
• Double-click the note.
• Click Actions > Open.
5. Edit the note name, description, and note text as required.
Caution
• The text editor only allows you to paste text from the clipboard. You
field. You should not attempt to paste graphics images as this may
Related Topics

Specification Binder Package Revisions

You can revise a set of specifications and notes in a Specification Binder package, for
example, before printing a request for quotation from a vendor. Once you assign a
specification to a Specification Binder package you may only create revisions to that
specification as part of the Specification Binder package from the Document Binder
module.
Important
Binder packages when working in an integrated environment (on the
Revisions dialog box, the OK, New, and Delete commands are disabled).
In general, the software allows you to save a revision only for documents that you
have changed and saved. You are also allowed to save a revision in the following
situations:
• If a specification has been newly-assigned to the binder package or if you

have modified a specification for which a revision was already generated
in the binder package.
• If you manually modified the Changed status of a document from No to
Yes. For details, see Modify the Change Notification of a Specification,
page 1024.
• If you removed an instrument specification from a Specification Binder
package.
On creating a new revision for a Specification Binder package, documents in the
binder package (Specification List, Form Notes, General Notes, and Change
Summary report) are revised automatically, provided a change notification is set for
at least one specification. Other document revisions are displayed in the title block of
a printed version of these documents.
Notes
• To be able to generate revisions, a Specification Binder package must
have at least one specification assigned to it (if the binder package
contains only general notes, for example, you cannot generate a revision
for it).
• You cannot delete or rename a Specification Binder package once a
revision has been performed on it.
• Before performing a revision in the Document Binder module, verify that
none of the designated documents are open for editing in any other
SmartPlant Instrumentation modules.

• When you perform a revision on a Specification Binder package, the

specifications it contains may be assigned revision numbers that are
actually lower than the number of any revisions that were performed for
the individual specifications before they were assigned to the binder
package.
• The software does not include in the Document Binder module revisions
or documents that you created from the Properties dialog box for an item,
for example, in the Terminal Strip Properties dialog box.
• You can set the preferences to allow for independent viewing of
specification revisions made before and after incorporation into a
• Before saving a revision, you must first release all instrument tags
associated with the designated specifications from any workflow
assignments. If the System Administrator selected to implement a
workflow option, one of the following conditions applies:
• If Full was selected (which includes workflow for the Document
Binder module), all the specifications in the Specification Binder
package must have the status Release to Spec.
• If Without Document Binder was selected, only those specifications
in the Specification Binder package whose status is PD not required
or Locked from PD can be revised.
Related Topics
• Add a Revision to a Binder Package, page 1021
• Binder Package Revision Archive, page 1019
• Print Documents in a Binder Package, page 1027
• Revisions Common Tasks, page 1020

Change Summary Report

The change summary report allows you to view all the changes that were made to
binder packages since the last time a revision was made. To generate such a report,
you double-click the Change Summary Report folder in the left area of the main
Document Binder window. The report shows a list of the instrument tags that were
modified and are associated with the specifications in the selected binder packages.
For example, in the case of a multi-tag specification, a tag may have been added to
the specification, or deleted from it.
If the tag data was modified, the report will display the following:
• Tag number
• The column where the change was made
• The old and new values for the specific column
• The person who made the change
• The date of change
Notes
• The Change Summary Report uses data stored in the Audit Trail
repository, therefore to enable generation of this report, in the
Administration module Domain Definition window, the Domain
Administrator has to select the Audit trail options check box.
• If changes were made to the main page of a multi-tag spec, each item in
the list will be displayed separately in the report, along with its changes.
• Before a revision is saved for the first time or if no changes were made to
items in the binder package after a certain revision, a report will not be
generated.
• On SQL Server, the Note sheet can accept up to 255 characters; on Oracle
or Sybase Adaptive Server Anywhere, you can type up to 2000 characters.
• Non-English, special character ASCII code used in a note, is not displayed
correctly in print preview.
Related Topics
• Specification Binder Package Revisions, page 1015

Enabling Specification Changes Notification

When you edit a specification in the Specifications module after adding a revision,
you can set whether to notify the changes in the Document Binder module.
When a notification of the changes to a specification is enabled:
• The revision number of the specification will be incremented the next time
a revision is made to the Specification Binder package to which it is
assigned.
• Changes to the specification appear in the Change Summary Report.
Note
• The Change Summary Report uses data stored in the Audit Trail
repository, therefore to enable generation of this report, in the
Administration module Domain Definition window, the Domain
Administrator has to select the Audit trail options check box.
After a Specification Binder package has undergone a revision, the changes
notification is removed (on the Specification Change Notification dialog box, No
appears under the Changed column for all the specifications), and any documents
associated with it (Specifications, Form Notes, and General Notes) are saved.
Following a revision in the Document Binder module, if you modify a specification in

the Specifications module, when saving the changes, a prompt appears enabling you
to decide whether to notify the changes in the Document Binder module (this prompt
does not appear if the change is already notified for the specification).
The available options are:
• Mark this item as changed — When this option is selected, the change
you made in the Specifications module will also be indicated in the
Document Binder module. In the Specification Change Notification
dialog box, the Changed column for the specification will display Yes.
Consequently, the specification revision number will be updated the next
time you revise the Specification Binder package to which it is assigned. If
any change was made to the specification, the instrument tags associated
with the specification will appear in the Change Summary Report.
• Do not change existing notification — When this option is selected, the
change will not be notified in the Document Binder module. In the
Specification Change Notification dialog box, the Changed column for
the specification will display No. It is recommended that you select this
option only when the change is minor and you do not want it to be
included in the next saved revision.

Binder Package Revision Archive

When you create a new revision for a binder package in the Document Binder
module, a view-only archive copy is made of the information contained in the
Specifications, Notes, and Change Summary Report.
The revision archive data can be saved in the database or in a file, depending on the
setting that the Domain Administrator selects in the Administration module.
Related Topics
• Convert Binder Package Revisions to .Zip Format Files, page 1023

Revisions Common Tasks

The following tasks are used when you making revisions to documents in the
Document binder module.
Add a Revision to a Binder Package

This option shows you how to revise the documents in a binder package. There are a
number of conditions restricting adding a new revision. For details, see Specification
Binder Package Revisions, page 1015.
For more information, see Add a Revision to a Binder Package, page 1021.
Delete a Revision From a Binder Package

This procedure shows you how to delete revisions from a given binder package.
For more information, see Delete a Revision From a Binder Package, page 1022.
Convert Binder Package Revisions to .Zip Format Files

This procedure describes how to remove binder package revisions from the database
into .zip format files.
When you save revisions to the database, the software compresses the data
automatically to save space. To further streamline your database, you can also
remove specification, binder package, and construction revisions from the database
by converting them to .psr or .psr-within-.zip format files, which you save in folders
external to the database. This feature is useful when you have made a large number
of revisions, and want to reduce the size of the active and backup databases.
For more information, see Convert Binder Package Revisions to .Zip Format Files,
page 1023.
Modify the Change Notification of a Specification

This procedure shows you how to modify the change notation of specifications in a
For more information, see Modify the Change Notification of a Specification, page
1024.
Related Topics

Add a Revision to a Binder Package

Important
1. Select the desired binder package.
• Click the right mouse button and on the shortcut > Revisions.
3. On the Revisions dialog box, select one of the revision numbering methods (use
serial revisions).
Tips
P0, P1, P2...). Once you select one of the other revision methods, you
will not be able to return to the preliminary revision method and this
option will be disabled.
• Only the last five revisions appear in the Revisions dialog box.
4. Click New to add new revision data.
5. Add the revision data in the appropriate data fields.
Tip
• The By field contains the current user's initials by default, if
previously defined by the SmartPlant Instrumentation System
Administrator. You can also edit this field. Today's date appears in
the Revision Date field, by default, but you can change it if desired.

6. Click OK to save the revision and close the dialog box.

Tip
• After the revision is saved, the change notifications for all the specs
are set to No. In the browser view, the Tag Status column for
instrument tags associated with specs assigned to or deleted from the
binder package prior to the last revision is cleared.
Notes
• An instrument specification that is added to a Specification Binder
package becomes a part of that package and is revised according to the
new Specification Binder package revision number, and not the previous
revision number that applied to the individual instrument specification.
• If you add a document to a General Document Binder package, and a
revision is made for the package as a whole, you can still add revisions for
the individual drawings in the package without any relation to the revision
number of the package.
Related Topics
• Delete a Revision From a Binder Package, page 1022
Delete a Revision From a Binder Package

Important
1. In the Document Binder window, highlight the binder package from which you
want to delete a revision.
3. On the Revisions dialog box, select the revision you want to delete, and click
Delete.

4. Confirm the deletion by clicking Yes.

Tip
• Repeat steps 1 – 3 for each revision that you want to delete.
Note
• You can set the module preferences for automatic deletion of revisions
when removing a specification from a binder package.
Related Topics
Convert Binder Package Revisions to .Zip Format Files

1. Click Actions > Manage Revisions.
2. To display binder packages of one revision only, under Revisions filter, type the
revision number and click Apply.
• In the data window, select the revisions that you want to convert.
• To select all of the displayed revisions for conversion, click Select all.
4. Under Convert revisions to, click ZIP files.
Tips
• To convert revisions to uncompressed .psr format, click PSR files.
• To restore .psr or .zip format files to the database, click Database.
5. Click Convert.
Notes
• The Domain Administrator sets the default revision storage method in the
Administration module. This gives you the option of storing binder
package revisions directly to .zip files external to the database.
• You can vary this procedure to convert binder package revisions back-
and-forth among .psr, .zip, and SmartPlant Instrumentation database
format.
Related Topics
• Binder Package Revision Archive, page 1019
• Save From a Binder Package to a .Zip File, page 1029

Modify the Change Notification of a Specification

1. Select a Specification Binder package.
2. Click Actions > Spec. Change Notification.
3. On the Specification Change Notification dialog box, for the desired
specifications, select the desired option in the Changed column:
• Yes— Notify that the specification has changed.
• No— Notify that the specification has not changed.
Tip
• Where Yes is selected, the specification is revised when the
Specification Binder package is next revised. You can view the
changes in the Change Summary Report.
Related Topics
• Enabling Specification Changes Notification, page 1018

Printing from a Binder Package: An Overview

When printing documents from a binder package you first choose between current
documents on the one hand, and previous revisions on the other hand, and then
specify what to print as follows:
• All the specifications and associated documents of the binder package.

• Changed documents only.
• Only the documents that you select.
Related Topics
• Printing from a Binder Package Common Tasks, page 1026

Printing from a Binder Package Common Tasks

The following tasks are used when you print document from a Document Binder.
Print Documents in a Binder Package

This procedure shows you how to print documents in a binder package.
For more information, see Print Documents in a Binder Package, page 1027.
Print From a Binder Package to a PDF File

This procedure shows you how to print a set of documents in a binder package as .pdf
files. After setting the path and file name, you choose between current documents on
the one hand, and previous revisions on the other hand. You then specify what to
print as follows:

All the documents that you select are saved together in a single .pdf file. When you
open the file — in Adobe Acrobat® for example — you can navigate easily from
one document to the next.
For more information, see Print From a Binder Package to a PDF File, page 1028.
Save From a Binder Package to a .Zip File

This procedure shows you how to save a set of documents from a binder package to a
.zip (compressed) file. The documents within the .zip file are in the .psr format that
the software uses for saving reports.
After setting the path and file name, you choose between current documents on the
one hand, and previous revisions on the other hand. You then specify what to save as
follows:

For more information, see Save From a Binder Package to a .Zip File, page 1029.
Related Topics
• Printing from a Binder Package: An Overview, page 1025

Print Documents in a Binder Package

1. Select the binder package for which you want to print documents.
• Click Actions > Print.
• Click the right mouse button and on the shortcut > Print.
3. On the Print dialog box, under Select revision, do one of the following:
• Click Working issue for current files.
• For a previous revision, click Formal issue and select the desired
revision from the Revision list.
4. Under Print what, do one of the following:
• Click All documents in binder package to print all the documents of
the revision you selected, or of the working issue.
• Click Changed documents only to print documents associated with
specifications marked as changed since the previous revision. This
option is available only if you selected Working issue above.
• Click Selected documents to print the specifications and notes of your
choice from the revision you selected, or from the working issue.
5. Select Show print preview to view the documents prior to printing.
6. Click OK.
7. If you clicked Selected documents, the Select Documents dialog box opens.
Highlight the documents that you want to print and click OK.
Notes
• Your Specifications module preferences also determine preferences for
specifications that you print within binder packages.
• You can set font and color for report comparison.
Related Topics

Print From a Binder Package to a PDF File

Important
• Before printing binder package documents to a .pdf file, you must install
GNU Ghostscript or Acrobat Distiller. You specify the active .pdf
generator on the Preferences dialog box.
1. Select the binder package for which you want to print documents to a file.
2. Click Actions > Print to File.
3. On the Print to File dialog box, do one of the following:
• Accept the file path displayed under Path. In this case, the software
will create a unique file name in the currently displayed folder.
• Click and navigate to the folder where you want the software to
save your .pdf files. After selecting this folder, you have the following
File name options:
• Type a file name.
• Select an existing file name from the current folder.
• Leave the File name box blank to let the software create a unique
file name.
4. On the Print to File dialog box, under Select revision, do one of the following:
revision from the Revision name list.
5. Under Print what, do one of the following:
• Click All documents in binder package to print to file all the
documents of the revision you selected, or of the working issue.
• Click Changed documents only to print to file documents associated
with specifications marked as changed since the previous revision.
This option is available only if you selected Working issue above.
• Click Selected documents to print to file the specifications and notes
of your choice from the revision you selected, or from the working
issue.
6. Click OK to print the documents to a .pdf file.
Highlight the documents that you want to print and click OK.
Related Topics

Save From a Binder Package to a .Zip File

1. Select the binder package for which you want to save documents into a .zip file.
2. Click Actions > Save to File.
3. On the Save to File dialog box, do one of the following:
• Accept the file path displayed under Path. In this case, the software
will create a unique file name in the currently displayed folder.
• Click to open the Save As dialog box. Navigate to the folder where
you want the software to save your .zip files. After selecting this
folder, you have the following File name options:
• Type a file name.
• Select an existing file name from the current folder.
• Leave the File name box blank for the software to create a unique
file name.
• Click Save to return to the Save to File dialog box.
4. Under Select revision, do one of the following:
revision from the Revision name list.
5. Under Save what, do one of the following:
• Click All documents in binder package to save all the documents of
the revision you selected, or of the working issue.
• Click Changed documents only to save documents associated with
specifications marked as changed since the previous revision. This
option is available only if you selected Working issue above.
• Click Selected documents to save the specifications and notes of your
choice from the revision you selected, or from the working issue.
6. Click OK to save the documents into a .zip file.
Highlight the documents that you want to save and click OK.
Related Topics

Displaying Binder Package Properties

You can display the properties of a particular binder package to show general details
and a record of the revisions that were made.
Display the Properties of a Binder Package

1. Select the desired binder package.
• Click Actions > Properties.
• Click the right mouse button and on the shortcut > Properties.
3. On the Binder Package Properties dialog box, click the General tab to show
general details of the binder package.
4. Click the Revisions tab to show details of revisions made to the binder package.
5. When done, click Close.

Troubleshooting
Errors may occur when you are working in the Document Binder module. This
section describes the common ones, with recommendations for solving the problems.
Binder package problems

Problem Description Suggested Reason Recommended Solution
Cannot rename the binder Binder package has
package already undergone a
revision.
Cannot delete the binder Binder package has If binder package has not yet
package already undergone a undergone a revision, remove
revision or if not, it still all the specifications from the
has specs assigned to it. binder package.
When selecting detailed Default View deleted or Create a View in the Package
view of specification list, not defined in Browser and define a style for
a message appears: Document Binder it. Ensure that the Set as
"Failed to retrieve Style Browser. default view check box is
Setting." selected.
No forms available for No specification has
selection when you try to been assigned to the
add a note to the Form binder package.
Notes folder
Revision problems
Problem Suggested Reason Recommended Solution
Description
Cannot revise the One or more of the documents in Close the edit location
binder package the binder package are being (specification or note editor).
edited.
One or more of the instrument tags Release all instrument tags
associated with the specification from any workflow
are locked for process data. assignments.
Cannot save Target is not defined for the Your Domain Administrator
revised revision. needs to define the path or
documents location.

Printing problems
Problem Suggested Reason Recommended Solution
Description
Cannot prepare Open specifications or Close all specifications and notes, then
pages for printing notes. re-select the print option.
The binder One or more of the Search for the missing reports according
package includes documents in the to the names displayed in the error
blank reports binder package is messages, and move them to the
missing. appropriate document location.
Cannot print Binder package Assign a spec to the binder package, or
binder package contains no documents. add a General Note.
Cannot repaginate A problem exists with Open the specification in the
before printing the specification, the Specifications module and follow the
form, or the format. instructions.

Loop Drawings Module: An Overview
Loop Drawings Module: An Overview

You use the Loop Drawings module to retrieve predefined instrumentation data and
generate appropriate loop drawings. Each component in the loop drawing is assigned
the necessary drawing blocks that represent its functionality and wiring routing. The
drawings display information about the loops and their instruments, wiring routing,
line data, DCS data, document references, approvals, revisions, and general
information.
The Loop Drawings module generates loop drawings by means of a fast build
process. By configuring typical drawing blocks for key instrument types, the loop
components can be automatically initialized with their corresponding graphical
elements. The Loop Drawings module enables you to create loop drawings that
include data retrieved from the database and if required, from an external file.
You can generate loop drawings in one of the following ways:
• Using the Enhanced Report Utility.

• Using an external CAD application (SmartPlant Instrumentation supports
Intergraph SmartSketch, Autodesk AutoCAD, or Bentley Systems
MicroStation for Windows).

Blocks in SmartPlant Instrumentation: An Overview
Blocks in SmartPlant Instrumentation: An

Overview
In SmartPlant Instrumentation, a block is considered as a template CAD drawing file
(with or without macros) that is assigned to a loop or instrument. The software uses
blocks in CAD loop drawing generation. You can use similar blocks to represent
identical components in different drawing positions by defining several blocks that
use the same drawing file.
A block is a term that is used in SmartPlant Instrumentation. Depending on the CAD

application that you use, the following equivalent terms apply.
SmartPlant Instrumentation SmartSketch AutoCAD MicroStation

Term
Block Symbol Drawing Cell
Macro Text element Attribute Tag
element
There must be a correlation between the file formats supported by your CAD
application and the file format in which you save a new drawing block. Standard
drawing blocks exist for each of the following CAD applications (shown with the
appropriate file extension):
• Intergraph SmartSketch — .sym

• AutoCAD — .dwg
• MicroStation — .cel
SmartPlant Instrumentation is shipped with several examples of blocks that are used
in the demonstration database (IN_DEMO.DB). The wiring methodology behind
these blocks includes the use of an overall shield with single cables and multiple pair
cables. After the installation, these blocks can be found in the path <SmartPlant
Instrumentation home folder>\CAD\Blocks. For details, see Shipped Block Files,
page 1039.

Block Organization and Management

SmartPlant Instrumentation requires that each drawing block belongs to a particular
block type. Therefore, after you define block files in your CAD application, you need
to assign these blocks to the appropriate block types in SmartPlant Instrumentation.
You define and manage blocks in the Drawing Block Types folder of the Domain
Explorer. After you define blocks and organize them according to their block types,
you can perform block association procedures, which depend on the block type of the
source block. Blocks that are already associated with specific loops or instruments
appear in the Loops folder of the Domain Explorer. For details of the available
block types, see Block Types: An Overview
Block Assignment Methods

After defining the blocks and their macros, it is necessary to assign your instrument
tag numbers to the drawing blocks that represent the instruments graphically. The
following is the description of the available assignment methods:
• Automatic block assignment method — In the Loops folder of the

Domain Explorer, these blocks are shown under instruments as .
Also, you must use this method if you want to assign user-defined general
blocks to your loop drawings. After assigning such a block to an
instrument type, the software displays this block in every loop drawing
whose source loop contains an instrument with the same instrument type.
The assigned user-defined general blocks do not appear in the Domain
Explorer.
• Manual block assignment method — In the Loops folder of the Domain
Explorer, these blocks are shown under instruments as . In the Domain
Explorer, it is possible to change the block assignment method from
automatic to manual.
Related Topics
• Block Types: An Overview, page 1036
• Loop Blocks: An Overview, page 1038
• Managing CAD Drawing Blocks Common Tasks, page 1041

Block Types: An Overview

SmartPlant Instrumentation requires each drawing block to belong to a specific block
type. This is because blocks in SmartPlant Instrumentation function according to the
block type they are assigned to. For example, if a block belongs to the Loop Block
type, you can only assign this block to a loop; if a block belongs to an Instrument
Block type, you can only assign this block to a specific instrument of the loop but not
to the loop itself.
You organize blocks according to block types in the Drawing Block Types folder of
the Domain Explorer. At this level, the software displays all the block types that
exist in the current domain and allows you to add general and instrument block types
and manage block type properties. All block types that appear in the current <plant>
also appear in all <plants> that exist in the domain.
The following drawing block types are available in the Drawing Block Types folder
of the Domain Explorer:
• Loop Block ( ) — A shipped block type that allows you to define, edit
or duplicate a block that you can associate with a loop number. The Loop
Block folder is the only folder of the Domain Explorer where you can
define and manage loop blocks. Loop blocks are shown as . After
defining a loop block, you can assign it directly to a loop number in the
Loops folder of the Domain Explorer. When generating a CAD loop
drawing using a loop block, the generation is based on a single template
block file that can include references to all tags in the loop. For more
details, see Loop Blocks: An Overview, page 1038.
• Instrument Block ( ) — A user-defined block type that allows you to
define, edit, or duplicate a block that you can associate with an instrument.
Instrument blocks are shown as . Blocks that you assign to instruments
appear at the instrument level in the Loops folder of the Domain
Explorer. When generating a CAD loop drawing using instrument
blocks, the generation is based on template CAD blocks that contain
macros specific to each instrument tag of the loop. This requires
assignment of individual drawing block files to instruments whose data
you want to display in the loop drawing (one block file per instrument). In
the generated drawing, the software displays the instrument blocks
according to their insertion points that you defined. The macros the
blocks contain retrieve data from SmartPlant Instrumentation for all the
associated instruments. You can create as many instrument block types as
you require. After defining instrument blocks, you can choose a block
assignment method to associate your blocks with specific instruments.
therefore you must define at least one instrument block type before you
can add a new block (apart from the default general block types and the
Loop Block type).

• Border ( ) — A shipped block type that allows you to define a border

block for use in all loop drawings or hook-up drawings. You can also
modify properties of an existing loop or hook-up drawing border block.
Border blocks are shown as . After defining border blocks, you can
assign one border block to all loop drawings or hook-up drawings using
the Default General Blocks dialog box.
• Logo ( ) — A shipped block type that allows you to define a logo
block for use in all loop drawings or hook-up drawings. You can also
modify properties of an existing loop or hook-up drawing logo block.
Logo blocks are shown as . After defining logo blocks, you can assign
one logo block to all loop drawings or hook-up drawings using the
Default General Blocks dialog box.
• User-Defined General Block ( ) — A user-defined block type that
allows you to define, edit, or duplicate a block that you want to use in all
loop drawings in addition to the border and logo blocks. This block does
not contain any macros. User-defined general blocks are shown as .
You can assign any number of user-defined general blocks to loop
instruments using the Automatic block assignment method. The software
automatically displays all the assigned user-defined general blocks in
every CAD loop drawing that you generate, regardless of the CAD
application you use. User-defined general blocks cannot be assigned to
hook-up drawings.
Notes
• The software always places in the drawing one block belonging to the
Logo type and one block belonging to the Border type regardless of
whether you add user-defined general blocks in the drawing. For a
complete list of the shipped logo and border blocks, see Shipped Block
Files.
• You can specify the coordinates of user-defined general blocks to prevent
overlapping with other drawing elements, such as the border or the logo.
• In hook-up drawings, you can only use the blocks created in the default
Border and Logo general block types.
Related Topics
• Blocks in SmartPlant Instrumentation: An Overview, page 1034

Loop Blocks: An Overview

A loop block is a CAD drawing block with macros that retrieve data from all
instrument tags of a specific loop. Since a loop block is a single template block file,
you do not need to specify insertion points for this block. You need to create loop
blocks in your CAD application and modify the macros as appropriate. Then, in
SmartPlant Instrumentation, in the Drawing Block Types > Loop Block folder of the
Domain Explorer, you define loop blocks you want to make available for association
with loop numbers. After that, you can associate the loop blocks with loop numbers
displayed in the Loops folder of the Domain Explorer.
You define loop blocks and manage their properties in the same way as you do with
instrument blocks. You can only assign one loop block to a particular loop.
However, in contrast to instrument blocks, you cannot assign the same loop block to
more than one loop. Therefore, when duplicating a loop that already has a loop block
assigned, the software ignores the loop block for the duplicated loop.
In loop drawing generation, the loop block has the highest generation priority. The
software ignores the instrument blocks when generating a loop drawing if the source
loop has a loop block and also blocks assigned to the loop instruments via the
instrument type using the automatic block assignment method.
The loop block macro structure is MACRO.<macro function>.<instrument

type>.<tag suffix>, where each segment of the macro structure is described as
follows:
• MACRO— This segment denotes an existing macro used by SmartPlant

Instrumentation in CAD loop drawing generation. A loop block macro
definition can be either MACRO, MACRO.X, or MACRO.X.Y if the
macro requires additional parameters.
• Macro function— This is an optional segment displaying the macro
function name, for example, TRIM.
• Instrument type— This is a required segment that denotes the
instrument type abbreviation of a loop tag, for example, FT, FE, and so
forth.
• Tag suffix— This segment denotes the suffix identification defined in the
instrument naming convention. This segment is only required if a loop
includes more than one instrument with the same instrument type.

The following are examples of loop block macros:
• TAG_MOD_DESC.FE — The instrument model description for the flow

element in the loop.
• TERM_NUM.1.3.FT.B — The terminal name of the first termination of
the wire level 3 for the second (Suffix B) flow transmitter in the loop.
• TAG_NUM.s54.LSHH — Four characters of the level switch name
starting from the fifth character, as defined in the s54 macro function. For
example, if the tag number is 101-LSHH -100, the macro retrieves
LSHH.
Related Topics
Shipped Block Files

Border and Logo Block Files
The files in the list are the predefined drawing blocks that you can use to represent the
border / title (one of which should be defined as the default border) and the logo (one
of which should be defined as the default logo).
File Name Description Available Formats

BORD_DEF Border and title. .dwg, .sym
BORD_DEM Border and title. .dwg
BORDER Border and title. .cel
BRDDEM Border and title. .cel
TITLE Border and title. .cel
INGR Intergraph logo. .cel
LOGO_DEF Intergraph logo. .dwg, .sym
LOGO_DEM Intergraph logo. .dwg, .sym
LOGO_IN Intergraph logo. .dwg
LOGOIG Intergraph logo. .cel
DCS and Control Block Files
File Name Description Available Formats

CTRL1 Analog input control. .dwg
CTRL2 Analog input and analog output control. .dwg

Field Device Block Files
File Name Description Available

Formats
CV2 Control valve. .dwg, .sym
ORIF_1 Orifice on a steam traced line. .dwg
ORIF_2 Orifice. .dwg
PLOC_IND.DWG Parallel connection of an indicator. .dwg
PT_1 Pressure element. .dwg
SLOC_IND.DWG Series connection of an indicator. .dwg
TC_1 Skin temperature controller (welded). .dwg
TC_2 Temperature element. .dwg
TE Temperature element wired to a temperature .dwg
transmitter.
Wiring Routing Block Files
File Name Description Available

Formats
AIT_ROUT Typical analog input routing; field device, junction .dwg
box, marshaling rack, and an analog input I/O card.
AOT_ROUT Typical analog output routing; I/P transducer, junction .dwg
box, marshaling rack, and an analog output I/O card.
PAIT1 Use for parallel indicator and transmitter. .dwg
SAIT Use for serial indicator and transmitter. .dwg

Managing CAD Drawing Blocks Common Tasks

The following tasks are used when you create and manage CAD drawing blocks.
Add a Block Type

Use this procedure to add a new instrument block type or a user-defined general
block type in the Drawing Block Types folder of the Domain Explorer.
For more information, see Add a Block Type, page 1042.
Add a Block to a Block Type

Use this procedure to add a block to a block type.
For more information, see Add a Block to a Block Type, page 1042.
View a Drawing Block in a CAD Application

Use this procedure to display a block it in your CAD application — SmartSketch,
MicroStation or AutoCAD — depending on the settings you made on the
For more information, see View a Drawing Block in a CAD Application, page 1043.
Define Insertion Points for Blocks

In SmartSketch, AutoCAD or MicroStation, you can define the insertion point for
individual blocks relative to the drawing origin (lower left corner). This enables you
to use the same block in different positions in different loop drawings.
For more information, see Define Insertion Points for Blocks, page 1044.
Copy Blocks to Another <Plant>

Use this procedure to copy one or more blocks that you select in the Drawing Block
Types folder of the Domain Explorer to another <plant> that exists in the current
domain.
For more information, see Copy Blocks to Another <Plant>, page 1045.
Related Topics

Add a Block Type

1. In the Domain Explorer, right-click the Drawing Block Types folder and, on the
shortcut menu, click New.
• Click General Block Type to create a user-define general block type.
• Click Instrument Block Type to create a block type whose blocks
you can then assign to instrument tags in the Loops folder of the
Domain Explorer.
3. In the Block Type Properties dialog box, type the new block name and
description in the appropriate boxes.
Tips
• Block types are defined at the domain level; therefore, a block type
that you add in the current <plant> automatically appears in all the
<plants> that exist in the current domain.
• You cannot add a new block type for loop blocks.
Related Topics
Add a Block to a Block Type

1. In the Domain Explorer, double-click the Drawing Block Types folder to
expand its hierarchy.
2. Right-click a block type and on the shortcut menu click New > Block.
3. On the Block Properties dialog box, enter information as follows:
a. In the Block field, enter the name to be used for the block by SmartPlant
Instrumentation.
b. In the Description field, type in a description for the block.
c. Under Block type, select a block type from the list.
d. Under Drawing block file, navigate to the block source file by clicking
Browse.
e. Specify the file path.

f. Under Origin, enter the required X and Y parameters to position the new
block on the drawing.
Tips
• You can enter decimal numbers as well as whole numbers.
• Blocks that you add under the Border, Logo, or a user-defined general
block type appear on the Default General Blocks dialog box, which
you open from the Actions menu of the Loop Drawings Module
window menu bar. In the Domain Explorer, general blocks only
appear in the Drawing Block Types folder and are shown as .
• Loop blocks that you add become available for association with loops
in the Loops folder of the Domain Explorer. These blocks are shown
as .
• Instrument blocks that you add become available for association with
instrument tag numbers in the Loops folder of the Domain Explorer.
In the Drawing Block Types folder, instrument blocks are shown as
. In the Loops folder, blocks assigned to instruments using the
automatic block assignment method are shown as and blocks
assigned to instruments using the manual block assignment method are
shown as .
Related Topics
View a Drawing Block in a CAD Application

Note
• The difference between viewing and generating is that viewing only shows
the code fields of blocks and macros while generating actually retrieves
the data and displays it on the drawing layer.
1. Press F7 to open the Domain Explorer and then expand the hierarchy to the loop
level in the Loops folder.
2. In the tree view pane, expand the loop hierarchy to the tag level and select a tag.
3. In the Items pane, right-click a block.
4. On the shortcut menu, click Reports > View Block in CAD Application.
Related Topics

Define Insertion Points for Blocks

2. Expand the loop-tag-block hierarchy and then do one of the following:
• In the tree view pane, right-click a desired block.
• In the Items pane, select and right-click several blocks.
Tip
• You can only define insertion points for blocks shown as . These
blocks are assigned to instruments using the manual block assignment
method. If your block selection in the Items pane includes
automatically assigned blocks, (shown as ), you need to redefine
your selection.
3. On the shortcut menu, click Actions > Define Block Origin.
4. On the Define Block Origin dialog box, select a block.
Tip
• If there is a large number of blocks in the data window, under Find,
select a column heading and then type a value. For example, if you
select Tag Number as a column heading and type a specific tag
number, in the data window, the software finds the block assigned to
this tag number.
5. Under Tag assignments, enter the required values (in the CAD application units)
for the block new insertion point X- and Y-coordinates.
Tip
• The block origin can consist of numbers that include decimal values,
for example, 9.85.
Related Topics

Copy Blocks to Another <Plant>

1. In the Domain Explorer, double-click the Drawing Block Types folder to
expand its hierarchy.
2. Double-click a block type whose blocks you want to copy.
• In the tree view pane, right-click a specific block.
• In the Items pane, select and right-click blocks you want to copy.
4. On the shortcut menu, click Actions > Copy Blocks to Another <Plant>.
5. In the Items pane, select and right-click the blocks that you want to copy to other
tag numbers.
6. On the shortcut menu, click Copy Blocks to Tag Numbers.
7. On the dialog box that opens, select a target plant and click OK.
Tips
• The blocks that you copy appear in the appropriate block type of the
target plant. The block types you define in the source plant
automatically appear in all the plants in the current domain because
block types are defined at the domain level.
• When copying blocks, the software does not copy any associations you
made for the blocks in the source plant.
Related Topics

Assigning Blocks Common Tasks

The following tasks are used when you assign blocks to instrument loops or tags.
Associate a Loop Block

Use this procedure to associate a loop block with one or more loop numbers. You
can only assign a loop block if the loop that you selected does not have any
instrument blocks assigned using the manual block assignment method. Such blocks
are shown under the loop tags as . The software, however, does not prevent you
from assigning a loop block to the loop is the loop tags have instrument blocks
assigned using the automatic block assignment method. Such blocks are shown under
the loop tags as . After associating a block with a loop, when generating a loop
drawing, the software always uses the loop block and ignores instrument blocks this
loop might contain. For more information, see Associate a Loop Block, page 1048.
Associate Instrument Blocks Automatically (via Instrument Type)

In an instrumentation design setup with a very large number of control loops, similar
tag numbers are represented repeatedly using the same drawing block, the only
difference being the data that is retrieved by the macros in the drawing. Therefore,
instead of having to associate each block with an instrument manually, you can use
this procedure to associate typical blocks with a specific instrument type. For more
information, see Associate Instrument Blocks Automatically (via Instrument Type),
page 1049.
Change the Block Assignment Method from Automatic to Manual

This procedure enables you to change the assignment method of instrument blocks
from automatic to manual. Blocks assigned to tag numbers using the manuals block
assignment method become available for selection in the Generate Loop Drawings
dialog box, where you can set the software to generate loop drawings only for those
loops that use a specific manually assigned instrument block. For more information,
see Change the Block Assignment Method from Automatic to Manual, page 1050.
Associate Instrument Blocks Manually

You can manually associate one or more blocks with tag numbers belonging to the
same loop number. In this case, that the software draws blocks after you select a loop
number in the Domain Explorer. For more information, see Associate Instrument
Blocks Manually, page 1051.
Update Block Assignments

This procedure enables you to update block assignments that might have been
changed during your <plant> life cycle. You can update block assignments in batch
mode, for one or more instrument tags belonging to the same loop or to a group of
loops. For more information, see Update Block Assignments, page 1052.

Copy Associated Blocks to Other Instrument Tags

Use this procedure to copy one or more blocks that are associated with a particular
instrument to other instrument tags displayed in the Domain Explorer. For more
information, see Copy Associated Blocks to Other Instrument Tags, page 1053.
Copy Automatically Assigned Blocks to Tags of Other Loops

Use this procedure to copy blocks from all instrument tags of a specific loop to all
instruments of one or more target loops. The software only copies those blocks that
are assigned to the source loop instruments using the automatic block assignment
method. In the Domain Explorer, these blocks are indicated with the icon. The
software validates the instrument tag assignments and the drawing type of the target
loops before copying the blocks. For more information, see Copy Automatically
Assigned Blocks to Tags of Other Loops, page 1054.
Assign an Instrument Block to a Drawing Page

Use this procedure to assign a CAD drawing block to a specific page in the generated
loop drawing when the loop drawing multi-page drawing or multi-drawing. You
must perform this procedure if the drawing block is assigned to the loop instrument
using the automatic block assignment method. Such blocks are shown under the loop
tags as . For more information, see Assign an Instrument Block to a Drawing
Page, page 1055.
Dissociate Blocks from Instruments

Use this procedure to dissociate blocks from instruments belonging to the same or
different loops. For more information, see Dissociate Blocks from Instruments, page
1056.
Specify Border and Logo Blocks for Loop Drawings

This procedure allows you to set SmartPlant Instrumentation to use a specific border
block and logo block every time you generate a CAD loop drawing. Blocks that you
set as default general blocks must belong to the shipped general block types, that is,
Border and Logo. You define and manage blocks in the Drawing Block Types
folder of the Domain Explorer. For more information, see Specify Border and Logo
Blocks for Loop Drawings, page 1056.
Assign General Blocks to All Loop Drawings via Instrument Type

Use this procedure to assign user-defined general blocks to a specific instrument type.
This procedure allows you to display general blocks in all loop drawings
automatically if the source loops have tags belonging to the instrument type to which
you assigned the blocks. The software displays such blocks in addition to the default
border and logo blocks that you specify on the Default General Blocks dialog box.
For more information, see Assign General Blocks to All Loop Drawings via
Instrument Type, page 1057.

Associate a Loop Block

Note
• You must first define loop blocks in the Drawing Block Types folder of
the Domain Explorer. In the Domain Explorer, loop blocks are shown
as . For details, see Add a Block to a Block Type, page 1042.
1. Press F7 to open the Domain Explorer and then expand the hierarchy to the tag
• In the tree view pane, right-click a specific loop number.
• In the Items pane, select and right-click several loop numbers.
3. On the shortcut menu, click Actions > Associate Loop Block.
Tips
• If there is a large number of blocks in the data window, under Find
block, select a column heading and then type a value. For example, if
you select Block as a column heading and type block name Control,
in the data window, the software selects the block whose name starts
with Control.
• If you want to display only specific blocks in the data window, click
Filter and specify a filter parameter.
4. In the data window, select the loop block and then click OK.
Tips
• You can only assign one loop block per loop.
• To dissociate loop block, right-click it and then, on the shortcut menu,
click Actions > Dissociate Loop Block.
Related Topics
• Assigning Blocks Common Tasks, page 1046

Associate Instrument Blocks Automatically (via Instrument

Type)
1. In the Loop Drawings Module window, do one of the following:

• On the menu bar, click Actions > Block – Instrument Type
Assignment.
2. On the Block – Instrument Type Assignment dialog box, in the Type data
window column, select an instrument type.
Tip
• If there is a large number of instrument types in the data window,
under Find instrument type, select a column heading and then type a
value. For example, if you select Description as a column heading
and type Control, in the data window, the software locates the
instrument types whose description starts with Control.
3. Click Assign.
4. If you defined several instrument block types in the Drawing Block Types folder
of the Domain Explorer, from the Block type list, select the appropriate
instrument block type.
5. Select blocks that you want to assign to the instrument type.
Tips
• If you select Show blocks of all types, the software displays all blocks
belonging to all the instrument block types that you defined n the
Drawing Block Types folder of the Domain Explorer. In addition to
instrument blocks, the software displays all user-defined general
blocks. If you assign a user-defined blocks to the instrument type, the
software displays this block in all loop drawings that include an
instrument belonging to the current instrument type.
• Click View to open a block in your CAD application.
6. Click OK and then check the block assignment in the Loops folder of the
Domain Explorer.
Tip
• In the Loops folder of the Domain Explorer, the instrument blocks
that you assigned appear under the tag numbers belonging to the
instrument type that you selected. These blocks are indicated with the
icon .

Change the Block Assignment Method from Automatic to

Manual
Note
• You cannot use this procedure if the source loop contains a loop block
(shown as under the loop number).
1. Press F7 to open the Domain Explorer and then expand the hierarchy to the
instrument level in the Loops folder.
• In the Items pane, select and right-click one or more loops.
• In the tree view pane, select a specific loop and then in the Items pane,
select and right-click instruments whose blocks are assigned using the
automatic block assignment method.
Tip
• In the Loops folder, blocks associated with tags using the manual
method are marked with the icon . Blocks associated with tags
using the automatic block assignment method are marked with the icon
.
3. On the shortcut menu, point to Actions and click Change Block Assignment
Method.
4. Click Yes when prompted.
Tips
• In the Domain Explorer, the block icons change accordingly.
• After changing the block assignment method from automatic to
manual, these blocks are no longer associated with an instrument type,
and therefore are not affected by any changes you or other users can
make to the block – instrument type association.
• Manually associated blocks become available for selection in the
Generate Loop Drawings dialog box, where you can generate a CAD
loop drawing per block.
Related Topics

Associate Instrument Blocks Manually

Note
• If you have a large number of loops with tag numbers that have identical
properties, you can assign block using the automatic block assignment
method. For details, see Associate Instrument Blocks Automatically (via
Instrument Type), page 1049.
1. Press F7 to open the Domain Explorer and then expand the hierarchy to the tag
2. In the Items pane, select and right-click tag numbers to which you want assign
blocks.
3. On the shortcut menu, click Actions > Associate Instrument Blocks.
Tips
• If there is a large number of blocks in the data window, under Find
block, select a column heading and then type a value. For example, if
you select Block as a column heading and type block name Control,
in the data window, the software locates the block whose name starts
with Control.
• If you want to display only specific blocks in the data window, click
Filter and specify a filter parameter.
4. In the data window, select the blocks that you want to associate and then click
OK.
5. In the Specify Drawing Pages for Blocks Assignment dialog box, under Page,
use spinners to specify pages on which you want the selected blocks to appear
after loop drawing generation.
Tips
• The Specify Drawing Pages for Blocks Assignment dialog box
opens when the source loop number is assigned to a multi-page
drawing or multi-drawing.
• In the Loops folder of the Domain Explorer, the instrument blocks
that you assigned appear under the tag numbers that you selected.
These blocks are indicated with the icon .
Related Topics

Update Block Assignments

1. In the Domain Explorer, expand the Loops folder hierarchy.
• In the Items pane, select and right-click one or more loops.
• In the tree view pane, select a specific loop and then in the Items pane,
select and right-click tag numbers.
3. On the shortcut menu, point to Actions, and click Update Block Assignments.
4. On the Update Block Assignments dialog box, select an update option as you
require.
Important
• When selecting the Overwrite option, any existing blocks associated
manually with the current tag number are dissociated.
• To update block assignments for the displayed tag number only, click
Apply and then click Next to display another tag number.
• To update block assignments for the all the tag numbers you selected
in the Domain Explorer, click Apply to All.
Related Topics

Copy Associated Blocks to Other Instrument Tags

Notes
• You can only copy blocks to those tags that belong to loops you assigned
to the CAD generation method. In the Domain Explorer, the icons of
such loops appear with the C indicator.
• This procedure only allows you to copy blocks assigned to a specific
instrument. If you want to copy all instrument blocks that all of the loop
instrument contain, you need to perform a different procedure. For details,
see Copy Automatically Assigned Blocks to Tags of Other Loops, page
1054.
2. In the tree view pane, expand the loop hierarchy to the tag level and select a
source tag.
3. In the Items pane, select and right-click the blocks that you want to copy to other
tag numbers.
4. On the shortcut menu, click Copy Blocks to Tag Numbers.
5. In the dialog box that opens, do one of the following to find tags belonging to the
loops whose generation method is CAD:
• Click Find to find all the tag numbers.
• Set search parameters and then click Find to display tag numbers that
match the search parameters.
6. Under Search results, select tag numbers to which you want to copy the blocks.
7. Click OK.
Tip
• If any of the source blocks is associated with an instrument type, when
copying the blocks, the software changes the block assignment method
from automatic to manual. In the Loops folder of the Domain
Explorer, under the target instrument tags, the block icons change
from to .
Related Topics

Copy Automatically Assigned Blocks to Tags of Other

Loops
Notes
• You can only copy blocks to those tags that belong to loops you assigned
to the CAD generation method. In the Domain Explorer, the icons of
such loops appear with the C indicator.
• Using this procedure, you copy blocks at the <plant> level, that is, your
target loops belong to different <units> of the current plant. If you only
want to copy blocks that belong to a specific instrument or copy blocks at
the <unit> level, you need to perform a different procedure. For details,
see Copy Associated Blocks to Other Instrument Tags, page 1053.
2. In the tree view pane, right-click a loop.
3. On the shortcut menu, click Copy Blocks to Tags of Other Loops.
4. On the dialog box that opens, under Target loop number, select one or more
loops.
Tip
• You can select all the target loops or find a specific loop. The
software finds and selects the loop number as you type its name in the
Find target loop box.
5. Click OK to validate the target blocks and create the copy_block.txt log file in the
temporary folder path of SmartPlant Instrumentation.
6. When prompted to copy the blocks, do one of the following::
• Click Yes to start copying the blocks and skip problematic loops
automatically.
• Click No if you only want to view the target loop validation problems
in the log file.
7. In the temporary folder path of SmartPlant Instrumentation, view the
copy_block.txt log file.
Related Topics

Assign an Instrument Block to a Drawing Page

1. In the Domain Explorer, expand the Loops folder hierarchy.
2. In the tree view pane, expand the hierarchy to the instrument level and then select
an instrument tag.
3. In the Items pane, right-click a block.
Tips
• You can only select one block at a time.
• For a block shown as , you might have already specified the
drawing page when assigning the block to the instrument using the
following procedure: Associate Instrument Blocks Manually, page
1051. It is possible to specify a different page for such a block.
4. On the shortcut menu, click Actions > Select Drawing Page.
5. On the Select Drawing Page dialog box, select a page number.
6. Double-click the selected number or click OK and then repeat this procedure to
assign another block to a drawing page.
Related Topics

Dissociate Blocks from Instruments

Use this procedure to dissociate blocks from instruments belonging to the same or
different loops.
1. On the Loop Drawings Module window menu bar, click Dissociate Instrument
Blocks.
2. Under Select blocks, select one or more blocks and also select the specific
instruments form which you want to dissociate the blocks.
3. Click OK to dissociate the blocks.
Tips
• When dissociating blocks assigned to instruments using the automatic
block assignment method, the software does not dissociate these blocks
from the instrument type. You can reassign these blocks automatically
whenever you require. In the Domain Explorer, these blocks are
shown as . For details, see Update Block Assignments, page 1052.
• You can also dissociate instrument blocks from the Loops folder of
the Domain Explorer. However, it is only possible to dissociate
blocks belonging to one specific instrument. After you select an
instrument in the Loops folder, the software displays the associated
blocks in the Items pane. You can right-click one or more blocks and
then, on the shortcut menu, click Actions > Dissociate Instrument
Blocks.
Related Topics
Specify Border and Logo Blocks for Loop Drawings

Notes
• You can only perform this procedure after you have assigned blocks to the
Border and Logo general block types in the Drawing Block Types folder
of the Domain Explorer.
• In addition to the shipped general block types, you might have created
user-defined general block types. All blocks belonging to the block types
appear automatically in every CAD loop drawing that you generate.
1. In the Loop Drawings Module window menu bar, click Actions > Default
General Blocks.
2. In the Default General Blocks dialog box, select the border and logo blocks to be
used in all the loop drawings.

Assign General Blocks to All Loop Drawings via Instrument

Type
1. In the Domain Explorer, right-click the Drawing Block Types folder.
2. On the shortcut menu, click New > General Block Type and define a block type.
3. Right-click the block type you created and then, on the shortcut menu, click New
> Block.
4. Define one or more blocks as you require.
5. In the Loop Drawings Module window, do one of the following:

• On the Actions menu, click Block – Instrument Type Assignment.
6. On the Block – Instrument Type Assignment dialog box, in the Type data
window column, select an instrument type.
Tip
• If there is a large number of instrument types in the data window,
under Find instrument type, select a column heading and then type a
value. For example, if you select Description as a column heading
and type Control, in the data window, the software locates the
instrument types whose description starts with Control.
7. Click Assign.
8. From the Block type list, select the user-defined general block type that you
created in the Drawing Block Types folder.
9. Select one or more blocks that you want to assign to the instrument type.
10. Click OK and then generate the appropriate loop drawing to display the assigned
blocks.
Tip
• User-defined general blocks are only shown in the Drawing Block
Types folder of the Domain Explorer.
Related Topics

Updating Loop Drawing Properties: An Overview
Updating Loop Drawing Properties: An

Overview
In the Loop Drawings module, you can specify a drawing type for every loop drawing
that you want to generate.
The following drawing types are available:
• Single-page — A loop drawing type used to display all the drawing

blocks and the title block on a single drawing page. Property updates for
this drawing type take effect in both CAD loop drawings and drawings
you generate by the Enhanced Report Utility.
• Multi-page — A loop drawing type used to display drawing blocks on
more than one page, where all the pages share the same document number,
description, and title block. Property updates for this drawing type only
take effect in CAD loop drawings.
• Multi-drawing — A loop drawing type used to display blocks on more
than one page, where each page has an individual document number,
description, and title block. Property updates for this drawing type only
take effect in CAD loop drawings.
By default, all drawings belong to the single page drawing type.
Loop drawing properties appear in the title block fields. These fields contain
identifying information about the document number, page number, and file name, and
also information about revisions, approvals, and references to other documents.
Properly completed identifying information ensures that each drawing is uniquely

identifiable. You can maintain your loop drawing properties by keeping the revision,
document reference and client / vendor approval information up to date.
Related Topics
• Loop Drawing Types and Drawing Properties Common Tasks, page 1059

Loop Drawing Types and Drawing Properties

Common Tasks
The following tasks are used when defining the properties of loop drawing types and
drawings.
Set the Date Format in CAD Loop Drawings

Use this procedure to set a date format in your CAD loop drawings. You set the date
format when customizing your CAD loop drawing preferences on the Preferences
dialog box.
For more information, see Set the Date Format in CAD Loop Drawings, page 1061.
Define a Drawing as a Multi-Drawing

Use this procedure to define a CAD drawing as a multi-drawing.
For more information, see Define a Drawing as a Multi-Drawing, page 1062.
Define a Drawing as a Multi-Page Drawing

Use this procedure to define a CAD drawing as a multi-page drawing.
For more information, see Define a Drawing as a Multi-Page Drawing, page 1063.
Modify Properties of a Single-Page Drawing

Use this procedure to modify properties of a CAD drawing to be generated as a
single-page drawing.
For more information, see Modify Properties of a Single-Page Drawing, page 1064.
Maintain CAD Loop Drawing Revisions

Use this procedure to maintain CAD loop drawing revisions. Revisions enable you to
keep track of the changes made to the CAD loop drawing during its lifetime. It is
important and useful to have a chronological description of the changes, dates of
change, and a list of persons who approved them. Use the following procedure to
add, edit, or delete revisions.
For more information, see Maintain CAD Loop Drawing Revisions, page 1064.

Maintain Document References

Use this procedure to maintain document references that you include in title blocks of
CAD loop drawings. You can manually add a new document reference, or you can
edit or delete an existing document reference.
Title blocks can display the following document references:
• Automatic references to P&ID drawings

• Manual references to loop drawings
• Automatic references to reports generated in the Wiring module
For more information, see Maintain Document References, page 1066.
Make CAD Drawing Approvals

Use this procedure to make client and vendor approvals for CAD loop drawings.
For more information, see Make CAD Drawing Approvals, page 1067.
Modify Loop Drawing Identifying Information

Use this procedure to set or modify loop drawing identifying information.
For more information, see Modify Loop Drawing Identifying Information, page 1067.
Update Paths for CAD Drawings and Block Files

Use this procedure to update in the SmartPlant Instrumentation database paths for
existing drawings and block files. You can update paths globally for block files
associated with instruments and loops, for general block files, and for generated
CAD drawings.
For more information, see Update Paths for CAD Drawings and Block Files, page
1067.
Associating an External CAD Drawing

This option enables you to associate an external CAD drawing with one or more
loops you have selected in the Domain Explorer. An external CAD drawing is a
drawing you have created outside the SmartPlant Instrumentation environment, using
SmartSketch, AutoCAD, or MicroStation. After associating an external CAD
drawing, you can open it in a compatible CAD application using the View External
CAD Drawing option of the Domain Explorer. External CAD drawings are only
used for viewing from within SmartPlant Instrumentation. They are nether included
in loop drawing generation, nor referenced in any item properties or settings.
For more information, see Associating an External CAD Drawing, page 1069.

View an External CAD Drawing

This option allows you to view an external CAD drawing that has been associated
with one or more loops the Domain Explorer. An external CAD drawing is a
drawing you have created outside the SmartPlant Instrumentation environment, using
SmartSketch, AutoCAD, or MicroStation.
For more information, see View an External CAD Drawing, page 1069.
Set the Date Format in CAD Loop Drawings

2. In the tree view, click Loop Drawings > General.
3. In the Date format box, enter the date format using the syntax in the following
table:
Date Format Example
mm-dd-yy 01-30-07
mm-dd-yyyy 01-30-2007
dd-mm-yy 30-30-07
dd-mm-yyyy 30-30-2007
d-mmm-yy 30-Jan-07
mmm-yy Jan-07
Tips
• SmartPlant Instrumentation only support date formats that are listed in
this table.
• You can use one of the following characters as separators: dash (-),
slash (/), space, comma, semicolon, colon, or dot.
Related Topics

Define a Drawing as a Multi-Drawing

3. On the shortcut menu, click Actions > Loop Drawing List.
4. On the Loop Drawing List dialog box, select the loop, and then click Properties.
5. On the Loop Drawing Properties dialog box, under Drawing type, click Multi-
drawing.
6. Click New and then enter the values as you require.
Tips
• You cannot change the loop number value.
• In the Page column, you can type any alphanumeric character that
designates a specific loop drawing page.
• You can specify an individual source path for any drawing page by
clicking to the right of the selected drawing file. A source path is a
path which software uses to locate the source file when generating a
CAD drawing that belongs to the multi-drawing type. The path that
you specify does not overwrite the path setting specified in the
Preferences dialog box. The software saves all generated loop
drawings in a designated folder that you define on the Preferences
dialog box.
Related Topics

Define a Drawing as a Multi-Page Drawing

4. On the Loop Drawing List dialog box, select the loop, and then click Properties.
5. On the Loop Drawing Properties dialog box, under Drawing type, click Multi-
page.
6. Click New and then enter the values as you require. Repeat this action as many
times as you need.
Tips
• You cannot change the loop number value.
• In the Page column, you can type any alphanumeric character that
designates a specific loop drawing page.
• You can specify an individual source path for any drawing page by
clicking to the right of the selected drawing file. A source path is a
path which software uses to locate the source file when generating a
CAD drawing that belongs to the multi-page type. The path that you
specify does not overwrite the path setting specified on the
Preferences dialog box. The software saves all generated loop
drawings in a designated folder that you define on the Preferences
dialog box.
Related Topics

Modify Properties of a Single-Page Drawing

4. On the Loop Drawing List dialog box, select the loop number, and then click
Properties.
Tip
• If the drawing belongs to the single page type, the Single page button
under Drawing type is selected automatically. You can change the
type of the drawing to multi-page or multi-drawing. For more
information, see Define a Drawing as a Multi-Page Drawing, page
1063 or Define a Drawing as a Multi-Drawing, page 1062.
5. Modify the values as you require.
Related Topics
Maintain CAD Loop Drawing Revisions

2. In the Items pane, select and right-click one or more loops.
3. On the shortcut menu, point to Actions and click Loop Drawing List.
4. On the Loop Drawing List dialog box, click Revisions.
P0, P1, P2... for preliminary revisions or 0, 1, 2 /A, B, C and so forth for normal
serial revisions).
Tips
P0, P1, P2…). Once you select one of the other revision methods, you
can no longer return to the preliminary revision method and this option
becomes disabled.
• When working with revisions in an integrated environment, the
revision numbering methods are not available for selection.

6. Click New to add new revision data or update the existing data as desired.
Tips
• SmartPlant Instrumentation automatically adds a new line with the
next logical character and date each time you click New after you
select the initial method.
7. Add or edit the revision data in the appropriate data fields.
Tips
• The By column contains the current user initials by default, if
previously defined by the System Administrator. You can edit this
value as you require.
• You can delete obsolete revisions by clicking Delete.
• You can also maintain revisions in batch mode.
• Each revision is represented by a numbered macro and the revisions
are displayed in the order of the macro numbering, beginning with the
first revision (ascending order) or the last revision (descending order).
If the total number of revisions is greater than the number of lines
available for display in the drawing and you want to see the latest
revisions, you should set your preferences to display the revisions in
descending order so that the latest revision is displayed first.
Related Topics

Maintain Document References

4. On the Loop Drawing List dialog box, click References.
5. On the Document References dialog box, do one of the following:
• Select a row in the data window and click Properties to update the
existing document reference name and description of a manually
inserted reference.
• Click New to define properties of a new document reference.
Tips
• You can view document references to reports generated in the Wiring
module only if you have selected the Display references to wiring
reports automatically check box in the Loop Drawings > General
page of the Preferences dialog box. You cannot edit properties of
these document references.
• The time of reference creation determines the order of the references
in the title block. In the title block, the software displays the
references in descending order, according to the time of creation. This
means that the reference you create first appears in the title block at
the top of the reference list.
• If an instrument in the selected loop has a reference in a P&ID
drawing, this reference automatically appears on the Document
References dialog box. It is possible, you can edit a P&ID drawing
reference in the Instrument Index module.
Related Topics

Make CAD Drawing Approvals

4. On the Loop Drawing List dialog box, click Approvals.
5. On the Approvals dialog box, set data for client and vendor approvals as you
require.
Related Topics
Modify Loop Drawing Identifying Information

2. In the Items pane, select and right-click loops.
4. On the Loop Drawing List dialog box, click Properties.
5. Modify the data as you require.
Tips
• Properties that you can edit are determined by the specified drawing
type.
• The document number does not have to be unique.
• Properties that only apply to CAD drawings are indicated as such.
Other properties, such as document number and loop drawing
description, are used in both CAD loop drawings and in loop drawings
generated by the Enhanced Report Utility.
Related Topics
Update Paths for CAD Drawings and Block Files

Note
• The paths that you specify do not overwrite the preferences settings
specified for new block files and output drawings.

Update Paths for Existing CAD Drawings And Block Files

1. In the Loop Drawings Module menu bar, click Actions > Update Paths for
Existing Drawings and Blocks.
2. Under Path for associated block, do one of the following:
• Click Apply to drawings in the domain/project to apply the new
path to all the plants in the current domain, or to the current project
when the domain type is Operating owner.
• Click Apply to drawings in the current <plant> only to apply the
new path to the current plant only.
3. Type the full path to the folder where you keep your drawing blocks files or click
Browse to navigate to the desired folder.
4. Under Path for generated drawings, do one of the following:
• Click Apply to blocks in the domain/project to apply the new path to
all the plants in the current domain, or to the current project when the
domain type is Operating owner.
• Click Apply to blocks in the current <plant> only to apply the new
path to the current plant only.
5. Type the full path to the folder where you keep your generated drawings or click
Related Topics

Associating an External CAD Drawing

3. On the on the shortcut menu, click Actions > Associate External CAD Drawing.
4. On the Select File dialog box, select the desired SmartSketch, AutoCAD or
MicroStation file.
Tip
• You can associate the following file types: .dwg, .dxf, .dgn, .cgm.
5. Click Open to associate the selected drawing.
Tips
• If there is already an external CAD drawing associated with the
current loop or loops, the new CAD drawing overwrites the existing
one.
• To dissociate the external CAD drawing, the on the shortcut menu,
click Actions > Dissociate External CAD Drawing.
Related Topics
View an External CAD Drawing

3. On the on the shortcut menu, point to Reports and click View External CAD
Drawing to open the CAD drawing associated with the selected loop or loops.
Related Topics

Loop Drawing Generation Methods: An Overview
Loop Drawing Generation Methods: An

Overview
SmartPlant Instrumentation allows you to assign a loop number to one of the
following generation methods: CAD, Enhanced Reports, and manual. Methods are
marked by designated symbols attached to loop numbers in the Loops folder of the
Domain Explorer. By default, loop numbers are not assigned to any generation
method.
Loop drawing generation is traditionally done using a CAD application such as

SmartSketch, AutoCAD, or MicroStation. You must specify the CAD application
paths and other CAD file locations on the Loop Drawings > CAD File Locations
page of the Preferences dialog box.
In addition to using a CAD method, you can also use the Enhanced Report Utility,
which is supplied with SmartPlant Instrumentation. This utility enables you to
generate, view, modify, and annotate loop drawings as needed. The Enhanced Report
Utility has an advantage over CAD as a loop drawing generation method in that it
requires no extra work in creating CAD drawing blocks. The report comes directly
from the database and does not necessarily require additional modifications
You can either assign each loop number to a specific method or apply the same
method to all loop numbers when generating loop drawings in batch mode. In the
Domain Explorer, for the intended method of generation, the software assigns an
appropriate generation indicator to the loop number icons.
The available indicators are:
• C— Loop drawing to be generated by a CAD application (SmartSketch,

AutoCAD, or MicroStation).
• M— Loop drawing to be generated manually, without using SmartPlant
Instrumentation options. When generating loop drawings, the software
always skips loops assigned to the Manual method.
• For loop drawings where the selected generation method is Enhanced
Report, the following symbols are available:
• E — By Loop
• ES — By Signal
• CL — Custom by Loop
• CS — Custom by Signal
Related Topics
• CAD Loop Drawing Generation Common Tasks, page 1077
• CAD Loop Drawing Generation: An Overview, page 1071

CAD Loop Drawing Generation: An Overview

SmartPlant Instrumentation allows you to generate loop drawings using external CAD
applications. The same generation principles are valid for any of the listed CAD
applications. The following CAD applications are supported:
• Intergraph SmartSketch
• AutoCAD
• MicroStation
In the generation process, SmartSketch (.sym), AutoCAD (.dwg), or MicroStation
(.dgn) type drawings are created from the selected loops.
Prerequisites
• Before generating loop drawings, make sure that CAD application paths
are set up correctly on the Preferences dialog box. For details, see CAD
Settings for SmartPlant Instrumentation, page 1073.
• If you use SmartSketch, prior to starting the generation process, in the
Preferences dialog box, you must select the check box Use macro
symbol (&) to retrieve data because in SmartSketch all macros have the
`&' prefix. If you clear the check box, the software displays only macro
attributes in the drawings.
• If you use AutoCAD, to ensure that the software displays macro captions,
on the Custom tab of the Preferences dialog box, in the Parameter box,
type TagAsMacroName and in the Value field, type Y.

Basic Principles of CAD Loop Drawing Generation

The following diagram illustrates a (schematic) flow control loop. The loop drawing
includes five drawing blocks for the following components: monitoring system,
control valve, each set of wiring connections to the DCS, and the DCS itself. The
wiring routing and control systems are conceptually the same for both tags (but with
different data), so in this example, the blocks for these items are identical.
Tag A is a monitoring system

consisting of a flow transmitter and flow element.
Tag B consists of a control valve with an I/P transducer.
Related Topics
• CAD Settings for SmartPlant Instrumentation, page 1073
• Loop Drawing Generation Methods: An Overview, page 1070
• Sample Loop Drawing (After Generation), page Error! Bookmark not
defined.

CAD Settings for SmartPlant Instrumentation

The table below contains the CAD interface parameters together with the appropriate
values for SmartSketch, MicroStation, and AutoCAD. You can modify these
parameters on the Loop Drawings > CAD File Locations page of the Preferences
dialog box. The Preference column of the table below shows the label that appears
on the Preference dialog box.
Preference Possible Default Value Description

for
SmartSketch
CAD folder C:\Program\ The path to the
draft.exe for
SmartSketch.
CAD C:\Program\ There is no
configuration configuration file
folder for SmartSketch.
However, the
default value for
the path does
exist.
Temporary C:\Program The path to the
folder path Files\SmartPlant\Instrumentation\TEMP\ SmartPlant
Instrumentation
temporary folder
where the
software stores
temporary logo
and custom style
files.
Drawing file C:\Program The path to the
folder Files\SmartPlant\Instrumentation\CAD\DWG\ location of the
loop drawing that
was last generated.
Drawing C:\Program The default path
block folder Files\SmartPlant\Instrumentation\CAD\Blocks\ for new drawing
block files.


for
AutoCAD
CAD folder C:\Acadwin\ The path to the
acad.exe file for
AutoCAD.
CAD C:\Acadwin\ The path to the
configuration AutoCAD
folder configuration file
ACAD.CFG.
CAD C:\Program The path to the
function Files\SmartPlant\Instrumentation\CAD\CADfunc AutoCAD
folder \ function files (.lsp
file format).
Instrumentation
temporary folder
where the
software stores
temporary logo
and custom style
files.
loop drawing that
was last generated.
block files.


for
MicroStation
CAD folder C:\Win32appl\Ustation The path to the
ustation.exe file
for MicroStation
95.
CAD C:\Win32appl\Ustation\Config\ The path to the
configuration MicroStation 95
folder configuration file
MSCONFIG.CFG
.
CAD C:\Program The path to the
function Files\SmartPlant\Instrumentation\CAD\CADfunc MicroStation 95
folder \ function files (.ma
file format).
Instrumentation
temporary folder
where the
software stores
temporary logo
and custom style
files.
loop drawing that
was last generated.
block files.
Notes for AutoCAD Users

• SmartPlant Instrumentation uses the shipped LISP function plote.lsp for
plotting generated drawings. If this function is not suitable for the specific
current AutoCAD plotter, you can select the Current Systems Plotter
option from the AutoCAD Plotter Configuration menu of AutoCAD, or
modify the plote.lsp file. If you do the latter, you should be aware that the
last Enter for the AutoCAD plot command is supplied automatically; you
do not need to press Enter manually.

Notes for MicroStation Users

• The MicroStation version preference setting SE stands for either
MicroStation Version SE or J.
• To enable MicroStation SE to work with long file paths, open the
Intools.ini file, and under the [LOOP] section, change the value of the
MicroStation parameter from 95 to SE or J.
• When defining a new CAD drawing block for MicroStation, the files you
select represent cell libraries. To specify a particular cell in the library,
you must type its name manually in the appropriate field.
• Make sure the temporary folder path string does not exceed fifty two
characters. A longer path prevents MicroStation from generating or
displaying drawings or cells from SmartPlant Instrumentation.
Related Topics

CAD Loop Drawing Generation Common Tasks

The following tasks are used when you generate CAD loop drawings.
Apply Loop Drawing Generation Method

You can specify the desired method for one or more selected loops in the Domain
Explorer. You can also specify in the Preferences dialog box which generation
method to use by default and whether to display each signal on a separate drawing
sheet when you select By Signal or Custom by Signal as the generation method.
For more information, see Apply Loop Drawing Generation Method, page 1078.
Generate CAD Loop Drawings

You use this procedure to generate CAD loop drawings.
For more information, see Generate CAD Loop Drawings, page 1079.
Show the Latest Generated CAD Drawing

This option enables you to display the latest loop drawing that was generated in
SmartPlant Instrumentation using an external CAD application. The drawing opens
in the CAD application you set as default on the Preferences dialog box.
For more information, see Show the Latest Generated CAD Drawing, page 1081.
Display CAD Loop Drawing Generation History

You can keep track of all the macro data changes in your CAD drawings. You
choose this option when generating a loop using an external CAD engine. You can
access the loop generation history from the print preview of loop drawings and the
relevant reports.
The loop generation history feature compares the retrieval values of macros from
different generations. Therefore, the history data is available when you have already
generated at least one loop drawing for a selected loop.
For more information, see Display CAD Loop Drawing Generation History, page
1082.
Delete CAD Loop Drawing Generation History

You use this procedure to improve performance when comparing generated data
values in CAD loop drawings, by deleting the history of obsolete CAD loop drawing
generations. Before deleting the values of previous CAD loop drawing generations,
you select the required loops, and then set the period within which you want to delete
the selected history records.

For more information, see Delete CAD Loop Drawing Generation History, page
1083.
Clear Previous Macro Result Records

Use this procedure to clear macro result records of generated loop drawings. The
software saves the macro results in the database for the next time you want to
generate a loop drawing for the same loop. The saved data accumulates and at a
certain stage might affect the generation performance.
For more information, see Clear Previous Macro Result Records, page 1083.
Related Topics
• CAD Loop Drawing Generation: An Overview, page 1071
• CAD Settings for SmartPlant Instrumentation, page 1073
• Loop Drawing Generation Methods: An Overview, page 1070
• Sample Loop Drawing (After Generation), page Error! Bookmark not
defined.
Apply Loop Drawing Generation Method

• In the tree view pane, right-click a target loop.
• In the Items pane, select and right-click several loops.
3. On the shortcut menu, click Apply Generation Method and then select a
generation method.
Tips
• In the Domain Explorer, the icons of the loop numbers to which you
applied a generation method appear with method indicators. For
method indicator descriptions, see Loop Drawing Generation
Methods: An Overview, page 1070.
• To clear the current loop generation method for one or more loops, on
the shortcut menu, click Clear Generation Method.
Related Topics

Generate CAD Loop Drawings

2. In the Items pane, select and right-click one or more loop numbers.
Tip
• If among the loops that you selected there are loops assigned to the
Manual method (symbol M in the Explorer), the software skips these
loops when generating drawings in batch mode.
3. On the shortcut menu, click Reports > Generate Loop Drawings.
4. On the Generate Loop Drawings dialog box, from the Generation method list,
select CAD.
5. Under Automatic save options, select Save drawing automatically and do one
of the following:
• In the Output drawing path data field, type the exact folder path to
which you want to save the generated drawing.
• Click Browse to navigate to the desired path for saving the file.
6. Click CAD Options, and then, from Save file in format list, specify the CAD file
format in which to save the generated drawings (if your CAD application supports
more than one file format).
7. Select the following check boxes:
• Send to plotter or printer— Sends the generated drawing to the
current CAD plotter.
• Use macro functions — Applies macro functions associated with the
macros.
• Save output data to database— Enables you to compare drawing
data of the current generation to data of a subsequent generation made
for the same loop.

8. Under Generation criteria, do one of the following:

• Click Per loop to generate drawings for all the loops you selected.
• Click Per page and then type the desired page number to generate
only a specific drawing page for the drawings you selected.
• Click Per block to select a block from the list and generate drawings
only for the loops that to which you assigned this block.
Tip
• The Per block option is useful when you select several loops in the
Items pane of the Domain Explorer. If your selection includes loops
that do not contain the block that you selected, the software does not
generate loop drawings for those loops. For the loops that do contain
the selected block, the software includes all of the blocks when
generating loop drawings. For example, if you selected five loops and
each of them has the block that you selected and also has three other
different blocks, the software includes all of these blocks in the
generated loop drawings. The blocks displayed in the lists are blocks
associated with instruments using the manual block assignment
method. In the Loops folder of the Domain Explorer, these blocks
are shown as are shown with the icon.
9. Under Create report about, select which reports you want to generate:
• Null data— Displays macro strings in the drawing for which
SmartPlant Instrumentation data is unavailable.
• Invalid macros— Displays macro strings in the drawing which are
not defined in SmartPlant Instrumentation.
Tip
• You can select to generate both reports if needed.
10. Under Mark drawing using, select the options for which you want to display a
text string, specified in the adjacent text box:
• String for null data— Allows you to type a string that indicates in
the drawing those macros for which SmartPlant Instrumentation data is
unavailable.
• String for invalid macros— Allows you to type a string that
indicates in the drawing those macros which are not defined in
11. If you need to use macros from an external source during the current loop drawing
generation, under External data, select the Use external macro source check
box, and then click Define.

12. Click OK to start the loop drawing generation process in your CAD application.
Tip
• If your CAD application is SmartSketch, by default, all drawings that
you generate have the A3 Wide print sheet size. This print sheet size
is defined in the template file pid.igr, which comes shipped with
SmartPlant Instrumentation. This file appears in the CADFunc folder,
for which you specified the path setting on the Preferences dialog
box, Loop Drawings > CAD File Locations page. If you want to
generate loop drawings using a different print sheet size, you must
open the pid.igr file in SmartSketch and modify the sheet settings as
you require. Note, however, that changes that you make in the pid.igr
file affect both loop drawings and hook-up drawings you generate in
SmartSketch. If you want the print sheet size of loop drawings not to
affect the print sheet size of hook-up drawings, duplicate the
CADFunc folder with all its content and define a different path setting
preference for hook-up drawings on the Hook-Ups > CAD File
Locations page.
Related Topics
Show the Latest Generated CAD Drawing

This option enables you to display the latest loop drawing that was generated in
SmartPlant Instrumentation using an external CAD application. The drawing opens
in the CAD application you set as default on the Preferences dialog box.
• In the Loop Drawings module, click Actions > Show Latest Generated
Drawing.
Related Topics

Display CAD Loop Drawing Generation History

1. On the Generate Loop Drawings dialog box, in the CAD Options tab, select the
Save output data to database check box.
2. On the CAD History tab, select the Compare outputs check box if this is not the
first generation to make the additional options available.
• Click Set date range and then, in the From and To boxes, specify the
history date range you need for the comparison.
• Click Select specific generation, and then, from the data window,
select a specific generation to which you want to compare the current
generation.
4. Under History data, select one of the following check boxes or both check boxes:
• Select Display in the drawing to display history data in the generated
drawing.
• Select Display in the report to display the Data Changes Report
before proceeding with the loop generation. The report includes the
tag number, block name, macro name and description, old value and
the new value.
• Click Show data from previous generation to display the old history
value from the previous generation.
• Click Mark with user-define value and type a new value in the box
below. This marks the drawing or the report with the new value
instead of the old history value from the previous generation.
Tips
• In the generated drawing or report, the software displays the old value
in parentheses.
• If you selected Display in the report, the software displays the Data
Changes Report before proceeding with the loop generation. After
printing or viewing the report, click OK to return to the Generate
Loop Drawings dialog box.

6. Click OK to start the generation process.

Notes
• When comparing a loop drawing that you have just generated with an
older one, you have to set the comparison date range to include both
generations. If that date includes more than one loop drawing, select the
exact loop drawing to which you want to compare the currently generated
one.
• The results show a comparison of the current data in the loop drawing
with the data stored in the history for the specified date range or
generation.
Related Topics
Delete CAD Loop Drawing Generation History

1. In the Domain Explorer, right-click loops that you select, and then, on the
shortcut menu, click Actions > Delete Generation History Records.
2. In the From and To boxes, specify the date range of the generation history
records that you want to delete.
3. Click Show Records.
4. Under Select records for deletion, select history records that you want to delete.
Tip
• Select the Select all check box to be able to delete all the displayed
records at once.
5. Click Delete.
Related Topics
Clear Previous Macro Result Records

2. In the Items pane, select and right-click loops whose temporary generation data
table you want to clear.
3. On the shortcut menu, click Actions > Clear Temporary Data.
Related Topics

Loop Drawing Reports

The following reports are associated with loop drawings that you can generate in
SmartPlant Instrumentation:
• CAD Loop Drawing Generation Errors — Available on the shortcut

menu in the Domain Explorer. This report lists a summary of errors that
occurred during the last loop drawing generation using your CAD
application. Data that appears in this report depends on specific loop
numbers that you select. For details, see Generate a Report of CAD Loop
Drawing Generation Errors, page 1084.
• Macros — Available in the Loop Drawings module, on the Reports
menu of the main window. Lists all the SmartPlant Instrumentation
macros. This report provides you with information about every macro
name, description, database name, and function description (if it exists).
This report displays macros for all loop numbers existing in your database.
For details, see Generate a Macro Report, page 1093.
• User-Defined Macro Functions — Available in the Loop Drawings
module, on the Reports menu of the main window. Lists all the macro
functions you created on the basis of SmartPlant Instrumentation standard
macro functions. The macro function affects the value which the macro
returns after generation. For example, you can specify a user-defined
function that removes all the spaces in the retrieved values and displays
the remaining characters as upper case. This report displays user-defined
macro functions for all loop numbers in your database.
Generate a Report of CAD Loop Drawing Generation Errors

Use this procedure to create a CAD loop drawing generation error report for loop
numbers for which you generated CAD loop drawings.
2. In the tree view pane, right-click a loop for which you want to generate the CAD
loop generation error report.
3. On the shortcut menu, point to Reports and click CAD Loop Drawing
Generation Errors.

Macros in SmartPlant Instrumentation: An Overview
Macros in SmartPlant Instrumentation: An

Overview
A macro is a text string that is recognized by SmartPlant Instrumentation and is used
to extract data from a given item such as a loop, instrument, panel, strip, and so forth.
Each macro corresponds to specific information available in SmartPlant
Instrumentation database, for example, the color of a wire. SmartPlant
Instrumentation provides you with easy ways to search for the macros that need to be
placed on a drawing block or a symbol. The software also comes with a standard set
of macros that you can customize according to your needs
The type of data that the software can retrieve depends on whether you are working
with loop drawings or hook-up drawings. For loop drawings, you can retrieve data for
the following item types:
• Domain definitions
• Plant hierarchy items
• Documents
• Revision information
• Loop data and instrument tag numbers
• Wiring data (including connection information)
• Process data
• Specifications data
• Loop drawing data
• Hook-up drawing data
For hook-up drawings, you can retrieve data for the following item types:
• Domain definitions
• Plant hierarchy items
• Documents
• Revision information
• Instrument tag numbers
• Process data
• Hook-up drawing data

All of the standard SmartPlant Instrumentation macros are displayed on the Macro
Definitions dialog box.
You can use SmartPlant Instrumentation macros in:
• Enhanced reports — You can add macros to the various symbols used to
represent items that appear in enhanced reports using the Symbol Editor,
or you can add macros directly in an enhanced report after generation. For
further details, see Using Macros: An Overview in the Enhanced Report
Utility User's Guide.
• CAD drawings — To display data in CAD drawings, you must add them
to the blocks that are used in generating the drawings. For further details,
see Using Macros in CAD Blocks: An Overview, page 1094.
Related Topics
• Customizing Macro Definitions: An Overview, page 1097
• SmartPlant Instrumentation Macro Structure, page 1087
• Standard Functions, page 1102
• Working with User-Defined Macro Functions: An Overview, page 1100

SmartPlant Instrumentation Macro Structure

You select the SmartPlant Instrumentation macros that you want the software to
recognize in hook-up drawings or in loop drawings by defining custom macro names
on the Macro Definitions dialog box for the appropriate drawing type. To see the
entire list of SmartPlant Instrumentation macros, you can generate a macro report in
the Loop Drawings module. For details, see Generate a Macro Report, page 1093.
Certain SmartPlant Instrumentation macros that include a group level have the
following structure:
[Macro_name.x]
The letter `x' designates the group level. The group level depends on the number of
macros in a group. The software creates a group when several macros of the same
macro type are associated with a tag number. For example, when associating several
tag categories with a tag number, the system combines all the TAG_CAT macros into
a TAG_CAT.x group so that you set a separate level for each macro: TAG_CAT.1,
TAG_CAT.2, TAG_CAT.3, and so forth.
For CAD drawings only, if desired, you can associate each macro with a macro
function, which determines how the software performs string manipulation on the
target data. For example, a macro function can retrieve the entire target data string or
just part of the data string and display it on the generated drawing. Associating a
macro function with a macro is optional. For details, see Working with User-Defined
Macro Functions: An Overview, page 1100.
The structure of a macro including a user-defined macro function is as follows:

[Macro_name.F1]
where F1 is the macro function abbreviation. If you set a macro function as a default,
the software automatically adds the abbreviation of the function to the macro in the
actual CAD drawings (SmartSketch, AutoCAD and MicroStation). If you do not set
a macro function as default, you need to add the macro function abbreviation
manually on the drawing.
Notes
• The separator in a macro string is a period (.), therefore within a macro
name segment, periods are not allowed.
• Some of the wiring macros have a different structure. For details, see
Wiring Module Macros - Conventions, page 1091.

Loop Title Block Macros

This topic lists and describes macros used in a loop drawing title block.
Macro Name Description

DWG_NAME Document number
DWG_DESC Drawing description
Revisions
These macros have the structure [MACRO_NAME.XX.F1] where XX is the revision
number (max. value =5), and F1 is the abbreviation for a user-defined function
(optional).

DWG_REV_NUM Drawing revision number
DWG_REV_DESC Revision description
REV_DRAWN_BY Revision by
REV_APPR_BY Approved by
REV_CHK_BY Checked by
DWG_REV_DATE Revision approval date
CURR_REV_NUM Last active revision

Approvals
VEN_PROP_BY Proposed by (vendor)
VEN_PROP_DATE Proposal date (vendor)
VEN_DSGN_BY Designed by (vendor)
VEN_DSGN_DATE Designed date (vendor)
VEN_DRWN_BY Drawn by (vendor)
VEN_DRWN_DATE Drawn on date (vendor)
VEN_CK_BY Checked by (vendor)
VEN_CK_DATE Check date (vendor)
VEN_APPR_BY Approved by (vendor)
VEN_APPR_DATE Approval date (vendor)
CL_CK_BY Checked by (client)
CL_CK_DATE Check date (client)
CL_ENGR_BY Instrument Eng. check (client)
CL_ENGR_DATE Inst. Eng. check date (client)
CL_APPR_BY Approved by (client)
CL_APPR_DATE Approval date (client)
Document References
You can display references to documents in the title block using the macros
REF_NAME and REF_DESC. It is possible to retrieve to the loop up to ten
references.
To extract the references, use the formats:
[REF_NAME.XX.F1] to get the document number, and [REF_DESC.XX.F1] to get

the document description. The XX segment denotes a two digit number ranging from
1 to 10 and F1 is the abbreviation for a user-defined function (optional).
If you have more than one document number, in the title block, the software sorts the
document numbers by name and displays them in ascending order. For example, if
you have document numbers Document A, Document C, Document B, and Document
A1, the software sorts them as follows:
Document A, Document A1, Document B, Document C
If you need to display only a specific document number , in the macro name
REF_NAME.XX.F1, substitute the XX segment with 01 to display the first number
sorted by name, 03 to display the third number, and so forth.

Drawing Generation Time and Date

DATE Date of generation
TIME Time of generation

Wiring Module Macros - Conventions

To retrieve wiring information, SmartPlant Instrumentation uses macros that are
identified by their macro name, together with appropriate parameters needed to
retrieve specific tag data.
When you create a tag number and a matching device panel, the software creates a
group that includes all the wires associated with that specific tag. Each wire can
belong to one group only. Once you connect a cable with the device panel, the
software sorts the wires into different group levels. Every connection of a wire to a
terminal is assigned a group sequence that maps and numbers the connections
starting with the value `1' that is usually on the device panel side.
The following diagram is an example that explains the meaning of wire groups.
Before you can start to build typical wiring drawing blocks, you need to know:
• How to identify typical wiring routing.

• The number of routing levels, usually determined by the number of wires
connected to the device-panel, but this may be different if, for example, a
power supply is involved.
• The group sequence that each wire and terminal connection has in the
current typical routing.

Syntax
The syntax used for wiring macros is as follows:
[Macro_name.x.y]
where the letter `x' designates the group level and the letter `y' designates the group
sequence.
Examples
The following examples show how the wiring macro syntax is used to retrieve
specific data for a terminal and for a wire:
• To retrieve the number of the terminal at Group Level 1 and Group

Sequence 3, the required macro is TERM_NUM.1.3.
• To retrieve the color of the wire at Group Level 2 and Group Sequence 2,
the required macro is W_CLR.2.2.
Notes
• When retrieving data for a wire, you may use the group sequence
corresponding to either of the wire ends, so for example, to extract the
wire name for the wire at Group Level 2 whose ends have sequence
numbers 3 and 4, you may use either macro W_TAG.2.3 or W_TAG.2.4.
• Control system macros do not require the 'y' (group sequence) parameter.
• If you generate a loop drawing with tag numbers that have incomplete
wiring, the macros will not be able to retrieve all the needed wiring
information since propagation is bi-directional: from the field device and
from the Control System.
• The software does not order wire sequence numbers sequentially until the
propagation process finds signal continuity between the field device and
the Control System.
• Special macros exist to extract data related to an overall shield. The
macro for a wire that is used as an overall shield has the format
[OSHW_TAG.x.y.] and the macro for a terminal to which an overall shield
is connected has the format [OSHT_NUM.x.y.]. For these macros to
function properly, the following conditions must be met:
• The polarity of the wire must be designated as Shield.
• The level and sequence of at least one of the wires in the cable must be
defined.

• For CAD drawings only, if desired, you can associate each macro with a
macro function, which determines how the software performs string
manipulation on the target data. For example, a macro function can
retrieve the entire target data string or just part of the data string and
display it on the generated drawing. Associating a macro function with a
macro is optional.
The general format of a wiring macro that includes a user-defined macro
function is [Macro_name.x.y.F1].
For further details, see Working with User-Defined Macro Functions: An
Overview, page 1100.
Generate a Macro Report

1. Start the Hook-Ups or Loop Drawings module.
2. Click Reports > Macros.
3. On the Macro Report Print Request dialog box, do one of the following:
• Click No grouping if you want to generate a report in which all the
macros are displayed in alphabetical order.
• Click Group by item type if you want to generate a report in which
the macros are grouped alphabetically by item type.
Tip
• When you group the macros by item type, the software organizes the
report pages according to the module titles.
4. Click OK to generate the report.

Using Macros in CAD Blocks: An Overview

A macro enables you to perform a number of automated actions in a predefined order.
When using a CAD application, macros are used to retrieve data from the database to
a predefined location on the drawing layer. The macros are assigned per block and
the text that they retrieve is eventually displayed as part of the block.
You can assign one or more macros to each block. Some macros are used for
retrieving data for instruments with the same function. For example, flow
transmitters, flow elements, and I/P transducers have a common function. Therefore
the same macros are used to retrieve the data for each of these instruments. The
macros required for each of these instruments are the tag prefix (TAG_PRFX),
instrument type (FUNC_ID), tag number (TAG_NUMC), and tag suffix
TAG_SUFF).
The diagrams below display a loop drawing that was generated along with its related
macros. This example illustrates how the same macros can be used to extract the
same or different data for different tag numbers - the Tag Prefix and Tag Number are
identical for each of the three instruments. However, the instrument type is different,
although represented by the same macro.
Note
• For the instruments in this example, the tag suffix was not used.
Loop Drawing with Macros Generated Loop Drawing

If you have used the standard drawing blocks supplied with SmartPlant
Instrumentation, or if you created your own drawing blocks with the predefined
macros, SmartPlant Instrumentation recognizes these macros when generating the
loop drawings, and you do not need to make any modifications to them. However,
you may want to modify macros in the following circumstances:
• If your drawings include macro names other than the predefined ones, you
can customize the default macro definitions as required. For details, see
Customizing Macro Definitions: An Overview, page 1097.
• If you want to modify certain display formatting of the macros, you can
specify user-defined macro functions. For details, see Working with User-
Defined Macro Functions: An Overview, page 1100.
• If you want to use an external data source other than the SmartPlant
Instrumentation database for displaying information defined by a macro,
you can connect to the appropriate database and use the macros defined in
that database. For details, see Using External Macro Data Sources: An
Related Topics
• Macros in SmartPlant Instrumentation: An Overview, page 1085

Insert Macros in an AutoCAD Drawing Block

1. Draw an image using the appropriate CAD application.
2. Perform the following actions for each command line prompt. If you have
finished drawing and want to perform these actions immediately, use the
supported ATT AutoLISP function or do the following:
a. Set AutoCAD system variable AFLAGS = 8
b. For AutoCAD 2000, 2000i, 2002, or 2004, make sure that the AutoCAD
system variable SDI=0.
c. Perform the following actions at the command line prompts:
Command line Action
prompt
ATTDEF Press Enter
Attribute modes Press Enter
Attribute Tag: Type in [macro name] and press Enter
Attribute prompt: Press Enter.
Default attribute value Type in [macro name] and press Enter
Justify/Style/<Start Position cursor and click once to define the bottom left
point>: position of the string.
Height: Position cursor and click once to determine the height of the
macro text. (The height of the macro text is also dependent on
the current font size.)
Rotation angle <0>: Type in a number to represent the angle of rotation of the
macro text from the horizontal (the default is 0).
Tip
• You can have AutoCAD automatically enter most of the above
parameters by using the ATT AutoLISP application. This application
is automatically installed if you select AutoCAD as your default CAD
interface. By using the ATT application you only need to enter the
macro name once, and enter the start point, height and rotation
parameters.
Related Topics
• Define Insertion Points for Blocks, page 1044

Customizing Macro Definitions: An Overview

The database contains a number of default macros predefined for convenience of use
and uniformity. If needed, for any default macro, you can assign one or more custom
macro names or change the macro description on the Macro Definitions dialog box.
You can also associate a macro function with a particular macro name.
Notes
• Other users working in the same domain or in the same project (when the
domain type is Operating owner) can use your customized macro
definitions.
• A macro name can contain a maximum of 30 characters.
• If you want to assign a macro function to a macro directly on a drawing,
you can add a function abbreviation of up to 4 characters to the macro.
The total number of allowed characters, including separators (periods) is
50.
• To see the entire list of SmartPlant Instrumentation macros, you can
generate a macro report for the type of drawings you are working with
(hook-ups or loop drawings). For more details, see Generate a Macro
Report, page 1093.
Related Topics
• Create a New Macro Definition, page 1098
• Delete a Macro Definition, page 1099
• Using Macros in CAD Blocks: An Overview, page 1094

Create a New Macro Definition

1. From the Hook-Ups or Loop Drawings module, do one of the following:
• Click Tables > Macro Definitions.
• Click .
2. Select the desired macro by choosing the item type and property, and where
applicable, the relation between a specified item type and its parent. To do this,
make a selection from each of the lists at the top of the dialog box.
3. In the Macro definition details data window, select the desired macro definition.
Tip
• If there are a large number of macro definitions in the Macro
definition details data window, under Find macro definition, select a
column heading and then type a value. For example, if you select
Function as a column heading and type a macro function value, in the
data window, the software locates the macro definition to which that
macro function belongs.
4. To create a customized macro definition, do one or more of the following:
a. Under Macro Name, type the desired user name for your macro.
b. Click in the Description field and change the description as desired.
c. Under Function, select a function to modify the appearance of the retrieved
data.
5. To add another customized macro definition, click New and repeat the previous
step.
6. Click Apply to accept your customized macro definitions.
Related Topics

Delete a Macro Definition

• Click .
3. In the Macro definition details data window, select the row containing the macro
definition that you want to delete.
Tip
4. Click Delete.
Related Topics

Working with User-Defined Macro Functions: An

Overview
You can perform string manipulation on retrieved data by assigning user-defined
functions to the macro that retrieved the data. You create user-defined macro
functions on the basis of SmartPlant Instrumentation standard macro functions.
The macro function affects the display formatting of the data which the macro returns
after generation. For example, you can specify a user-defined function that removes
all the spaces in the retrieved values and displays the remaining characters as upper
case.
You can apply functions to macros directly on the CAD drawing or in the database.
Priority for Macro Functions

The order of priority for macro functions is as follows:
1. CAD drawing level — A macro function that you specify at the CAD drawing
level has the highest priority for execution. In this case, you type the macro
function abbreviation directly in the generated drawing in your CAD application.
At this level, you can define one function per macro.
2. Database level — The next highest level of priority for execution is when you
define a function with a specific macro.
3. Database level — The lowest priority for execution is given when you define a
default function. To learn how to set a macro function as default, see Create a
User-Defined Macro Function, page 1103.
Macro Function Syntax
If you want to apply the highest macro function priority do the data retrieval, you can
associate a function with a macro directly on the CAD drawing block using the
function abbreviation. The function abbreviation is a string with maximum of 4
characters, the first of which must be a letter. The general structure of a macro with a
function is:
[Macro_name.F1]
where F1 is the macro function abbreviation.
The general format of a wiring macro that includes a user-defined macro function is:
[Macro_name.x.y.F1]

Example
The following is an example of a macro with a function:
W_CLR.1.1.RS
In this example, the macro name is W_CLR.1.1 and the macro function is RS
(remove spaces).
Notes
• Use a period (.) as the separator to separate the individual macro segments.
• The software uses the macro function parameters.
• When using a macro function at the database level, you should not define
that macro function on the drawing block or in the generated drawing. For
the software to recognize macro functions defined at the database level, on
the Preferences dialog box, under Loop Drawings > General, select the
Use macro functions check box. If you set a macro function as default,
the software automatically adds the abbreviation of the function to the
macro in the actual CAD drawings, and you do not need to add it with
every block and macro. If you do not set a macro function as default, you
need to add the macro function abbreviation manually on the drawing.
Related Topics
• Macros in SmartPlant Instrumentation: An Overview, page 1085

Standard Functions
A standard macro function is a function that is supplied with the software and
contains a set of predefined commands. You can associate a standard function with
SmartPlant Instrumentation macros or specify a combination of standard functions to
create a user-defined macro function.
SmartPlant Instrumentation has six standard macro functions. The following table
shows how each of the standard functions modifies the macro string.
Function Description Resulting String Comments

None Original string FT - 100
a[space][space]
Trim Trims trailing spaces FT - 100 a Does not affect internal
spaces
Upper Changes characters to FT - 100
upper case A[space][space]
Lower Changes characters to ft - 100
lower case a[space][space]
Substr Returns a substring of - 10 In this example, the
(3,5) the original string substring starts from 3rd
character and extends to 5
characters including the
starting character
RemSpace Clears internal FT – 100 In this example, where
(1) spaces when a[space][space] internal spaces exist, a
exceeding the maximum of 1 space is
maximum number of allowed. Does not affect
allowed spaces. trailing spaces.
RemSpace FT- No internal spaces
(0) 100a[space][space] allowed

Standard Function Parameters

Some standard functions require additional parameters in their definitions:
Function Parameters Explanation

Substr Start position
Length The position of the first character of the sub-string from
the start of the string to be displayed, and the number of
characters to be displayed in the sub-string
RemSpace Max. Maximum number of internal spaces allowed in the
contiguous string
spaces
Note
• You cannot change the code of standard macro functions.
Related Topics
• Working with User-Defined Macro Functions: An Overview, page 1100
Create a User-Defined Macro Function

1. In the Loop Drawings or Hook-Ups module, click Tables > User Defined Macro
Functions.
2. On the User-Defined Macro Functions dialog box, click New to open the User-
Defined Macro Function Properties dialog box.
3. Type a name and macro function abbreviation for the new macro function, and, if
needed, a description.
Caution
• If you want to use macro function abbreviations in loop block macros,
make sure the macro function abbreviation is different from an
instrument type abbreviation, which is a required segment in the loop
macro function string. For details about loop blocks and loop block
macro structure, see Loop Blocks: An Overview, page 1038.

4. To superpose a standard function, do the following:

a. Click Insert to open the Standard Macro Functions dialog box.
b. Select a standard function and click OK.
c. If you selected a standard function that can accept parameters, specify
appropriate values in the fields. For details, see Standard Functions, page
1102.
Tip
• The user-defined macro function operates in the macro string
according to the order of the standard functions superposition. Use
Move Up and Move Down to change the order of the standard
functions.
5. Click OK to confirm your changes and close the User-Defined Macro Function
• Select Set macro function as default to apply the specified macro
function to all existing macros.
• Clear Set macro function as default to be able to associate the
specified macro function with a specific macro.
Related Topics
• Delete a User-Defined Macro Function, page 1105
• Modify a User-Defined Macro Function, page 1105

Modify a User-Defined Macro Function

Functions.
2. On the User-Defined Macro Functions dialog box, select the row with the macro
function you want to modify, and click Properties to open the User-Defined
Macro Function Properties dialog box.
3. Modify the macro function properties as desired.
4. To superpose or change a standard function, do the following:
a. Click Insert to open the Standard Macro Functions dialog box.
b. Select a standard function and click OK.
c. If you selected a standard function that can accept parameters, specify
appropriate values in the fields. For details, see Standard Functions, page
1102.
Tip
• The user-defined macro function operates in the macro string
according to the order of the standard functions superposition. Use
Move Up and Move Down to change the order of the standard
functions.
5. Click OK to confirm your changes and close the User-Defined Macro Function
• Select Set macro function as default to apply the specified macro
function to all existing macros.
• Clear Set macro function as default to be able to associate the
specified macro function with a specific macro.
Related Topics
• Create a User-Defined Macro Function, page 1103
• Delete a User-Defined Macro Function, page 1105
Delete a User-Defined Macro Function

Functions.
2. On the User-Defined Macro Functions dialog box, select the row with the macro
function you want to delete.
3. Click Delete.

Using External Macro Data Sources: An Overview

You can use macros from an external source with the macros in your domain. This
means that macro sources that are both external and internal in relation to SmartPlant
Instrumentation are used when you generate a loop drawing.
Working with external macro sources includes the following steps:

1. Establishing a connection to an external data source from which SmartPlant
Instrumentation can retrieve macro data.
2. In the Domain Explorer, assigning the connected external data source to the loop
numbers for which you want to generate loop drawings.
Important
• Before you start working with external macro data sources, make sure that
the external source data naming and structure conventions comply with the
SmartPlant Instrumentation macro conventions. For details, see External
Macro Structure Conventions, page 1108 and External Macro Naming
Related Topics
• Assigning an External Macro Data Source, page 1113
• Connecting to an External Data Source, page 1109

External Macro Naming Conventions

The macro names for external macros in a drawing must be identical to the names in
the external database file or table.
Notes
• To be able to use an external macro source, you need to establish a
connection to the macro source in the Define External Macro Source
dialog box.
• In your target drawing blocks or symbols, you need to add the E_ prefix to
the name of the macro that you want to use to retrieve data from the
external macro source.
For example, if a drawing contains an external macro named PROCESS which is
used to retrieve the string Flow, the macro label must be written as E_PROCESS.
This means that after generation, every occurrence of the label E_PROCESS in the
drawing will be replaced with the value Flow.
Related Topics
• External Macro Structure Conventions, page 1108

External Macro Structure Conventions

SmartPlant Instrumentation has set a few basic requirements regarding the structure
of external data sources from which you add macros to your loop drawings.
Therefore, before you use an external macro make sure that its structure complies
with SmartPlant Instrumentation conventions. The structure has to include the tag
number (cmpnt_name) as the first (leftmost) column, and occupying the rest of the
columns, the desired macros and their retrieval values.
The following table is an example of an external source structure (the table headers
below exemplify column names):
cmpnt_name macro1 macro2 macro3

108-PI -2212 Pressure Bar Indicator
108-FE -2225 Flow Ft3/s Element
In the above example, using the macro macro1 in a loop drawing generated for
instrument tag 108-PI-2212, will display the retrieved value Pressure instead of the
macro1 string. You can create the above structure by using any text editing
application (for Text format files), dBase (*.dbf) editing tools, or any other
appropriate database editing utility. For further details, see the user's guide for your
database platform.
Important
• The name of the first (leftmost) column name must always be
cmpnt_name (representing the tag number).
Related Topics
• External Macro Naming Conventions, page 1107

Connecting to an External Data Source

The first stage is connecting to the appropriate source data form whose macro data
you want to use. After connecting to the database or the database file you can
generate CAD drawings using the retrieved macros as required.
You can connect to any of the following database platforms and files:
• Oracle (only if you have selected Oracle as your current database platform
during Setup or you installed an Oracle client manually)
• Microsoft SQL Server (only if you have select SQL Server as your current
database platform during Setup or you installed a SQL Server client
manually)
• Sybase Adaptive Server Anywhere (only if you have selected Sybase
Adaptive Server Anywhere as your current database platform during Setup
or you installed a Sybase Adaptive Server Anywhere client manually)
• Microsoft Access
• *.dbf
• ASCII delimited files
• Excel worksheets
• Text files
Important
• The external database file with source macros must not reside in the
SmartPlant instrumentation home folder.
Note
• You can connect to database platforms (Oracle, SQL Server or Sybase
Adaptive Server Anywhere) other than your current database platform but
you have to comply with the external database platform requirements. For
example, if your current database platform is Sybase Adaptive Server
Anywhere and you want to import data from Oracle, you must have an
Oracle client installed and running on your computer. See Internal Setup
Utility to learn how to configure your environment to connect to database
platforms other than your current database platform.
Related Topics
• Connecting to an ODBC Profile, page 1111
• Connecting to Database Platforms Other Than ODBC, page 1112
• External Macro Structure Conventions, page 1108
• Prerequisites for Connecting to a dBase ODBC Profile, page 1110

Prerequisites for Connecting to a dBase ODBC

Profile
You can generate loop drawings in SmartPlant Instrumentation using your dBase
(.dbf) external macro source. Prior to connecting to dBase (.dbf) external macro
source, you need to create a dBase ODBC profile in accordance with the driver
requirements of your Windows system.
The following prerequisites apply:
• In your ODBC Data Source Administrator, select the ODBC driver in

accordance with your Windows system:
• For Windows XP — use Microsoft dBase Driver
• For Windows 2000 — use PB Intersolv 2.12 32-BIT dBASEFILE
(*.dbf)
• Create an ODBC profile using your Windows ODBC Data source
Administrator. For further details, see the user's guide for your database
platform.
Related Topics
• Connecting to an ODBC Profile, page 1111

Connecting to an ODBC Profile

This procedure describes the steps required to connect to a database file (for example,
.dbf, ASCII, and so forth) using the ODBC profile. This way you can generate your
CAD drawings using macros from an external macro source.
The following file types are available:
• dBase (.dbf)
• Text files
Note
• If you want to connect to dBase (.dbf file), you must create an ODBC
profile in accordance with your Windows system. For more details, see
Prerequisites for Connecting to a dBase ODBC Profile, page 1110.
Connect to an ODBC Profile

1. Click Actions > Define External Macro Source.
2. On The Define External Macro Source dialog box, from the Database type list,
select ODBC.
3. From the Data source list, select the source database file profile, for example,
.dbf, ASCII files, and so forth.
4. Click Browse and select macro source file.
Related Topics

Connecting to Database Platforms Other Than

ODBC
This procedure describes the steps required to connect to a database platform such
as Oracle or SQL Server. To connect to an external database platform, you must have
access rights to the database server as well as the appropriate database drivers. You
must also have the appropriate settings in the configuration files (for example, .ini
files) and in the Windows registry.
Connect to Database Platforms Other Than ODBC

1. Click Actions > Define External Macro Source.
2. In The Define External Macro Source dialog box, from the Database type list,
select the source database platform: Oracle or SQL Server.
3. In the Server box, type the name of the server that you use to connect to the
database server:
• <alias name> — if you connect to Oracle
• <server name> — if you connect to SQL Server
4. In the Database schema logon name box, type the logon name required to
connect to the source domain in the database server.
5. In the Database schema logon password box, type the logon password required
to connect to the source domain in the database server.
Related Topics

Assigning an External Macro Data Source

This procedure enables you to assign an external macro data source to one or more
loop numbers.
Notes
• To be able to use an external macro source, you need to establish a
connection to the macro source in the Define External Macro Source
dialog box.
• In your target drawing blocks or symbols, you need to add the E_ prefix to
the macros which you want to use to retrieve data from an external macro
source.
Assign an External Macro Data Source to One or More Loop

Numbers
• In the tree view pane, right-click a desired loop.
• Items pane, select and right-click several loops.
3. On the shortcut menu, point to Actions and click Assign External Macro
Source.
4. Under the Macro Source column, do one of the following:
• If your macro source is an ODBC profile, type the exact path and the
file name of the source database file.
• If your macro source is a specific table on Oracle or SQL Server, you
need to type the exact table name.
Tip
• If you want to assign the same macro source to all the loop numbers
displayed in the Assign External Macro Source dialog box, select a
row with the desired macro source and then select Apply same source
to all displayed loop numbers.
Related Topics
• Using External Macro Data Sources: An Overview, page 1106

Hook-Ups in SmartPlant Instrumentation: An Overview
Hook-Ups in SmartPlant Instrumentation: An

Overview
In SmartPlant Instrumentation, you can create, view and edit installation details for all
prepared instrument drawings (hook-ups) within a domain. You can perform various
actions using the Hook-Ups module, in the Reference Explorer, and the Domain
Explorer.
In the Hook-Up Item Libraries folder of the Reference Explorer, you define your
item libraries, create and manage hook-up items. You need to set one specific library
as the active item library, which becomes your <plant> default library. The
completeness of this library is up to the user.
In the Hook-Ups folder of the Domain Explorer, which depicts the hierarchy of
hook-up data, you can organize hook-ups in hook-ups types and associate hook-ups
with instrument tags and hook-up items. You can determine the name of each hook-
up and hook-up type based on your specific requirements. After that, you can
generate hook-up drawings using the Enhanced Report Utility or your CAD
application.
Using the Hook-Ups module options, you generate various hook-up reports and a Bill
of Material, define hook-up item manufacturers, make hook-up macro definitions,
and so forth.
Related Topics
• Hook-Up Drawing Generation: An Overview, page 1139
• Hook-Up Reports: An Overview, page 1158
• Managing Hook-Up Drawings Common Tasks, page 1142
• Managing Hook-Up Items and Libraries Common Tasks, page 1117
• Managing Hook-Ups Common Tasks, page 1126

Hook-Up Items: An Overview
Hook-Up Items: An Overview

A hook-up drawing is made up of individually marked parts called items. These
items have to be purchased. The service that a Bill of Material provides you with
depends upon how completely you fill in the hook-up item library. The minimum
amount of data required to provide is the item number. Entering more data is left to
your discretion.
SmartPlant Instrumentation allows you to define a large number of hook-up items and
group them in item libraries and sub-libraries. You create and manage item libraries
in the Reference Explorer. A new item library that you create automatically
contains a default sub-library, which you can use for assigning hook-up items if you
do not work with pipe specs. When defining a new item in SmartPlant
Instrumentation, you can enter a number of hook-up item properties, such as item
size, model, material, storage number, unit of measure, and so forth. Also, it is
possible to define hook-up item manufacturers in the Item Manufacturers the
supporting table and then assign the appropriate manufacture to the item.
You must set one item library as the active item library for your <plant>. After you
create hook-up items in this library, you can use the Domain Explorer options to
associate the appropriate sub-library with hook-ups, and then, associate specific items
with these hook-ups. After making the associations, you can generate Hook-Up Item
List reports and a Bill of Material. In the Bill Of Material, you can sort the items by
the item order. After associating hook-up items with a hook-up, the software
generates new sequence numbers automatically and allows you to sort the items by
their order of their assignment to a hook-up.
In the Reference Explorer, hook-up items are displayed in the Hook-Up Item
Libraries folder, under sub-libraries. In the Domain Explorer hook-up items are
displayed in the Hook-Ups folder, under hook-ups. Hook-up items are indicated with
the icon.
Related Topics
• Calculating the Total of Hook-Up Items for a Bill of Material, page 1160
• Hook-Up Item Libraries and Sub-Libraries: An Overview, page 1116

Hook-Up Item Libraries and Sub-Libraries: An Overview
Hook-Up Item Libraries and Sub-Libraries: An

Overview
An item sub-library is a term which refers to a part of an item library and contains a
specific set of hook-up item data and associations. You create and manage item
libraries in the Reference Explorer, where item libraries are indicated with the
icon. An item library can contain any number of user-defined sub-libraries that you
can use when working with pipe specs. A new item library that you create
automatically contains a default sub-library, which you can use for assigning hook-up
items if you do not work with pipe specs. Sub-libraries are indicated with the
icon.
You must set one item library as the active item library for your <plant>. After you
create hook-up items in this library, you can associate the appropriate sub-library with
hook-ups, and then, associate specific items with these hook-ups. In the Reference
Explorer, the active item library is indicated with the icon.
Related Topics
• Hook-Up Items: An Overview, page 1115

Managing Hook-Up Items and Libraries Common

Tasks
These tasks deal with creating and managing hook-up item libraries, sub-libraries,
and hook-up items in the Reference Explorer.
Create an Item Library

This procedure describes how to create a new item library. An item library contains
fittings and associations created on a domain level. Therefore, when you enter a
domain, you can have any number of relevant libraries. The number of libraries,
names, and completeness are all up to your requirements. An item library can also
contain any number of user-defined sub-libraries that you can use when working with
pipe specs. A new item library that you create automatically contains a default sub-
library, which you can use for assigning hook-up items if you do not work with pipe
specs. For more information, see Create an Item Library, page 1118.
Create User-Defined Sub-Libraries

Use this procedure to create user-defined sub-libraries in the library set as the active
item library. You can also assign pipe specs to user-defined sub-libraries. For more
information, see Create User-Defined Sub-Libraries, page 1119.
Set an Item Library As the Active Item Library

The active item library is the <plant> default item library. You must set a specific
library as the active item library to be able to assign the library items to hook-ups.
The information is filled in to pick out parts of a specific hook-up. You can also enter
description, material, rating, and so forth, to provide as much information as possible
for the Bill of Material that the software creates based on this data. For more
information, see Set an Item Library As the Active Item Library, page 1119.
Create a Hook-Up Item

Use this procedure to create a hook-up item under the default or user-defined sub-
library. For more information, see Create a Hook-Up Item, page 1120.
Create Hook-Up Items in Batch Mode

Use this procedure to create several hook-up items in the default sub-library of a
specific hook-up library. For more information, see Create Hook-Up Items in Batch
Mode, page 1120.
Sort Hook-Up Items in a Sub-Library

Use this procedure to sort the hook-up items defined in a specific sub-library. For
more information, see Sort Hook-Up Items in a Sub-Library, page 1122.

Associate Items with User-Defined Sub-Libraries

Use this procedure to assign items that exist in the default sub-library to a user-
defined sub-library. For more information, see Associate Items with User-Defined
Sub-Libraries, page 1123.
Remove Items from a User-Defined Sub-Library

Use this procedure to remove one or more items from a user-defined sub-library.
When removing the items, the software only dissociates them from that sub-library
but does not delete them from the parent hook-up item library. For more information,
see Remove Items from a User-Defined Sub-Library, page 1124.
Delete Hook-Up Items

Use this procedure to delete one or more hook-up items from a specific hook-up item
library. For more information, see Delete Hook-Up Items, page 1125.
Delete Hook-Up Sub-Libraries

Use this procedure to delete an empty user-defined sub-library from the parent hook-
up item library. For more information, see Delete Hook-Up Sub-Libraries, page
1125.
Related Topics
• Hook-Ups in SmartPlant Instrumentation: An Overview, page 1114
Create an Item Library

1. Press F8 to open the Reference Explorer, and right-click the Hook-Up Item
Libraries folder.
2. On the shortcut menu, click New > Item Library.
3. Type a unique name for the item library and an optional description.
4. Click OK.
Tips
• On creating the item library, the software automatically creates the
default sub-library under the library.
• You can create a hook-up library by duplicating an existing library.
When duplicating the library, the software also duplicates all the sub-
libraries and the items that are associated with the sub-libraries. If a
library contains a large number of sub-libraries and hook-up items, the
duplication process might take time.
Related Topics

Create User-Defined Sub-Libraries

1. Press F8 to open the Reference Explorer, and expand the hierarchy to the item
library level in the Hook-Up Item Libraries folder.
2. Right-click the item library.
3. On the shortcut menu, click New > Item Sub-Library.
4. Type a unique name for the item sub-library and an optional description.
Tip
• You can click Pipe Specs and assign pipe specs to the sub-library you
are creating. If you have not defined pipe specs yet, you can create the
sub-library first and assign pipe specs at a later stage.
5. Click OK to create the sub-library.
Tip
• It is possible to create more than one sub-library by duplicating several
existing user-defined sub-libraries that you can select in the Items
pane. To display the sub-libraries in the Items pane, in the tree view
pane, select the parent item library. When duplicating a user-defined
sub-library, the software also duplicates all of the hook-up items that
exist in that sub-library. You cannot duplicate the default sub-library.
Related Topics
Set an Item Library As the Active Item Library

1. In the Reference Explorer, expand the Hook-Up Item Libraries folder.
2. Right-click a library that you require.
3. On the shortcut menu, click Actions > Set As Active item Library.
Tips
• You can only set one library as the active item library for your
<plant>. If another item library has been set as the active item library,
the software dissociates the hook-ups from the previous active library
and assigns the default sub-library of the new active library to all the
hook-ups in your <plant>.
• In the Reference Explorer, the library icon changes from to .

Related Topics
Create a Hook-Up Item

2. Double-click the item library to display the item sub-libraries.
Tip
• The default sub-library exists in every library that you create. In
addition, you can create user-defined sub-libraries if you want to
associate pipe specs to hook-ups.
3. Right click the default or user-defined sub-library.
4. On the shortcut menu, click New > Hook-Up Item.
5. Type a unique name for the hook-up item and define other properties as needed.
6. Click OK to create the hook-up item.
Tip
• If you created a new item in a user-defined sub-library, this item
automatically appears in the default sub-library too.
Related Topics
• Create Hook-Up Items in Batch Mode, page 1120
Create Hook-Up Items in Batch Mode

2. Double-click the item library to display the item sub-libraries.
Tip
• The default sub-library exists in every library that you create. In
addition, you can create user-defined sub-libraries if you want to
associate pipe specs to hook-ups.
3. Right click the default sub-library.
4. On the shortcut menu, click Actions > Batch Item Creation.
5. Under Number of items to create, use the spinner to enter the number of the
hook-up items you want to create under the default sub-library.

6. In the Prefix box, type an optional prefix you want to assign to the batch of the
items you are about to create.

7. In the Start from number box, type the starting number you want to append to
the name of the first item in the batch.
Tip
• If you leave the Start from number box empty, after you click OK,
the software automatically appends 0 (zero) to the name of the first
item in the batch.
8. In the Increment by box, use the spinner to change the incrementing value as
needed.
Tip
• The default value in the Incremented by box is 1. When using the
default value, to ensure item name uniqueness within the current
default sub-library, the software increments every subsequent item
number in the batch of items by one digit. you can change this value
as needed. For example, if your want to create three items with prefix
MyItem, the Start from number value 5, and the Increment by
value 2, the software creates the following items: MyItem5,
MyItem7, and MyItem9.
9. Click OK to open the Hook-Up Item Properties dialog box, where you can
define properties for each item and complete the item creation.
Related Topics
Sort Hook-Up Items in a Sub-Library

1. In the tree view of the Reference Explorer, select and right-click a sub-library.
2. On the shortcut menu, click Sort.
3. From the Item type list, select Hook-Up Item.
4. Under Available Property, select a property you want to use for sorting hook-up
items, for example Item Number.
5. Drag this property to the Sort Property pane, select the check box and click OK.
Tip
• The software sorts the items that start with a numeric character first.
For example, if you sort by item number items whose numbers are
5,1,A,4,AA,BB,A,AB,2,3, these items appear in descending order as
follows: 1,2,3,4,5,A,AA,AB,B.
Related Topics

Associate Items with User-Defined Sub-Libraries

following:
2. On the shortcut menu, click Actions > Associate Items with Sub-Libraries.
Tips
• On the dialog box that opens, the software displays all the items
available in the default sub-library of the library you selected. You
can set a filter to display only those items that you require for
association. In the filter that you require in not available in the Filter
available items list, you can click and define a new filter.
• In the dialog box panes, you can double-click a column header in the
to sort the items in ascending order. Double-click again to sort the
items in descending order.
• In the dialog box panes, there is a vertical bar that you can drag to the
right and view your data in a split display. To find the vertical bar,
place the cursor to the left of the left scroll box arrow so that the cursor
changes its shape as shown:
.
3. Under Available items, select one or more hook-up items and do one of the
following:
• Drag the selected items to the Associated items pane.
Explorer, click Next to display another sub-library and associate hook-up items
as you require.
Tip
• You can associate the same items with more than one user-defined
sub-library.
Related Topics

Remove Items from a User-Defined Sub-Library

following:
2. On the shortcut menu, click Actions > Associate Items with Sub-Libraries.
Tips
available in the default sub-library of the library you selected. You
can set a filter to display only those items that you require for
association. In the filter that you require in not available in the Filter
available items list, you can click and define a new filter.
.
3. Under Associated items, select one or more hook-up items and do one of the
following:
• Click Dissociate.
• Drag the selected items to the Available items pane.
Explorer, click Next to display another sub-library and dissociate hook-up items
as you require.
Related Topics

Delete Hook-Up Items

sub-library level in the Hook-Up Item Libraries folder.
2. In the tree view pane, do one of the following:
• Double-click the default sub-library from which you want to delete a
specific item, and then, select and right-click a specific item you want
to delete.
• Select the default sub-library from which you want to delete one or
more items, and then, in the Items pane, select and right-click items
you want to delete.
Tips
• The software only allows you to delete those items that are not
associated with hook-ups.
• If you created user-defined sub-libraries, the software automatically
deletes the items from all the sub-libraries that exist in the library.
You can also perform item deletion from a user-defined sub-library.
Related Topics
Delete Hook-Up Sub-Libraries

1. Press F8 to open the Reference Explorer, and double-click the Hook-Up Item
Libraries folder.
2. Select an item library to display its sub-libraries in the Items pane.
3. In the Items pane, select and right-click one or more user-defined sub-libraries.
Tip
• You can only delete empty user-defined sub-libraries that exist in the
library.
Related Topics

Managing Hook-Ups Common Tasks

These tasks deal with creating and managing hook-ups and hook-up types in the
Domain Explorer. Also, these tasks describe various association procedures you
need to perform, for example, association of instrument tags to hook-ups, association
of items to hook-ups, and so forth.
Create a Hook-Up Type

This procedure describes how create a hook-up type. A hook-up type is a common
name of group of hook-ups that share distinguishing characteristics common to one
kind of instrument. These characteristics set one hook-up type apart from another
type, for example Flow, Temperature, Level, and so forth. You can only create one
hook-up type at a time. For more information, see Create a Hook-Up Type, page
1128.
Create Hook-Ups
Use this procedure to add one or more hook-ups to existing hook-up types. A hook-
up is a graphical representation of an assembly drawing — a drawing prototype.
Adding a hook-up to a hook-up type is a prerequisite for assigning instruments tags to
hook-ups. For more information, see Create Hook-Ups, page 1128.
Associate Hook-Up Types with Instrument Types

Use this procedure to assign one or more hook-up types an instrument type. Your
database can contain a seemingly endless number of tag numbers. To make the task
of attaching multiple instruments to a specific hook-up type manageable, use a filter
that allows you to assign any instrument type in the current domain to your hook-up
type.. For more information, see Associate Hook-Up Types with Instrument Types,
page 1130.
Associate Instrument Tag Numbers with Hook-Ups

Use this procedure to assign one or more tag numbers to one or more hook-ups. The
hook-ups can belong to the same or different hook-up types. For more information,
see Associate Instrument Tag Numbers with Hook-Ups, page 1131.
Move Hook-Ups to Another Hook-Up Type

This procedure enables you to move all hook-ups from one or more hook-up types to
another existing hook-up type. For more information, see Move Hook-Ups to Another
Hook-Up Type, page 1132.

Associate Hook-Ups with a Sub-Library

Use this procedure to associate a hook-up with a user-defined sub-library or to
change the existing hook-up sub-library assignment.
You can associate a hook-up with a sub-library when performing the following
activities:
• Adding a new hook-up to a hook-up type — You can assign any new
hook-up to any sub- library.
• Editing properties of an existing hook- up
• Duplicating a hook-up
When editing or duplicating hook-up properties, you can change the existing
association of a hook- up sub-library under the following conditions:
• If the hook-up has associated instrument tags with pipe spec data, the
target user-defined sub-library must also have pipe specs suitable for
association of these tags.
• The target user-defined sub-library must contain all hook-up items that are
associated with the hook-ups.
For more information, see Associate Hook-Ups with a Sub-Library, page 1133.
Associate Items with Hook-Ups

This procedure enables you to associate one or more items with hook-ups. You can
only associate those items that exist in the sub-library assigned to the hook-ups that
you select in the Domain Explorer. In hook-up drawings that you generate, the
associated items are displayed as the identifying. For more information, see
Associate Items with Hook-Ups, page 1134.
Dissociate Items from Hook-Ups

Use this procedure to dissociate one or more items from a hook-up. You must
dissociate an item from a hook-up prior to deleting this item from the active item
library. For more information, see Dissociate Items from Hook-Ups, page 1136.
Dissociate Tag Numbers from Hook-Ups

Use this procedure to dissociate one or more instrument tags from a hook-up. You
must dissociate all instruments from a hook-up prior to deleting this hook-up. For
more information, see Dissociate Tag Numbers from Hook-Ups, page 1137.
Delete Hook-Ups
This option enables you to delete a hook-up which is not associated with any tag
numbers. If an association exists, first dissociate the tag numbers from this hook-up
and then delete the hook-up. For more information, see Delete Hook-Ups, page 1138.

Delete Hook-Up Types

This option enables you to delete one or more hook-up types which are not associated
with any hook-ups. To delete a hook-up type that contains hook-ups, first delete the
hook-ups or move them to another hook-up type. For more information, see Delete
Hook-Up Types, page 1138.
Related Topics
Create a Hook-Up Type

1. Press F7 to open the Domain Explorer, expand the hierarchy and right-click the
Hook-Ups folder.
2. On the shortcut menu, point to New and click Hook-Up Type.
3. In the Hook-Up Type Properties dialog box, type a unique hook-up type name
and an optional description.
4. Click OK.
Related Topics
Create Hook-Ups
1. Press F7 to open the Domain Explorer and do one of the following:
• Right-click the Hook-Ups folder.
• Double-click the Hook-Ups folder and then, in the Items pane, select
and right-click the hook-up type to which you want to add a new hook-
up.
2. On the shortcut menu, click New > Hook-Up.
3. If you right-clicked the Hook-Ups folder, from the Hook-up type list, select the
target hook-up type.
4. In the appropriate boxes, enter a unique name for the new hook-up and an
optional description.
5. Type a unique name for the item sub-library and an optional description.

6. From the Item sub-library list, select a sub-library to which you want to assign
the hook-up.
Tip
• If you do not work with user-defined sub-libraries, the software
assigns the hook-up to the default sub-library automatically. If you
work with user-defined sub-libraries, we recommend that you read the
topic Associate Hook-Ups with a Sub-Library, page 1133.
7. Beside Drawing block file name and path, click Browse to navigate to the
drawing block file name and path.
Tips
• Click View to open the selected drawing in the CAD application
installed on your computer.
• The path setting that appears in the Generation output path box is the
path that you specified in the Generate Hook-Up Drawings dialog
box. The software only displays the path if you already generated a
hook-up drawing for the source hook-up.
8. Click OK to create the hook-up.
Tip
• It is possible to create more than one hook-up by duplicating several
existing hook-ups that you can select in the Items pane. To display
the hook-ups in the Items pane, in the tree view pane, select the parent
hook-up type or the Hook-Ups folder. When duplicating a hook-up,
the software also duplicates all of the hook-up items that are associated
with the source hook-ups.
Related Topics

Associate Hook-Up Types with Instrument Types

2. In the tree view pane, do one of the following:
• Select and right-click a specific hook-up type.
• Select the Hook-Ups folder and then, in the in the Items pane, select
and right-click one or more hook-up types.
3. On the shortcut menu, click Actions > Associate with Instrument Types.
Tips
• On the dialog box that opens, the software displays all the instrument
types defined in the current domain. You can associate the same
instrument type with more than one hook-up type.
4. Under Available instrument types, select one or more instrument types and do
• Drag the selected items to the Associated instrument types pane.
5. If you selected more than one hook-up type in the Domain Explorer, click Next
to display another hook-up type and associate instrument types as you require.
Related Topics

Associate Instrument Tag Numbers with Hook-Ups

type level in the Hook- Ups folder.
• In the tree view pane, select a hook-up and then, In the Items pane,
select and right-click one or more hook- ups.
• In the tree view pane, select the hook- up hierarchy root node to
display all the existing hook-up types in the Items pane, and then, in
the Items pane, right-click one or more hook-up types.
Tip
• When selecting a hook-up type or several hook-up types, you can
associate tags with multiple hook-ups that belong to different hook-up
types. If you select a specific hook-up, you can only assign tag
numbers to the selected hook- up.
3. On the shortcut menu, click Actions and click Associate Tag Numbers with
Hook-Ups.
4. Under Instrument type assigned to hook-up type, select an instrument type by
which you want to filter tag numbers in the Available tag numbers pane.
Tips
.
• Under Available tag numbers, tags displayed in italics indicate tags
that are already assigned to another hook-up. You can still associates
these tags with the current hook-up. Click the Hook-Ups button above
the Available tag numbers pane to display tag numbers available for
association with hook-ups and also display existing hook-up
associations.
• If the specified hook-up is assigned to a user-defined sub-library with
pipe specs, the software filters the tag numbers so that only tag
numbers with the appropriate pipe spec data are displayed. The
software only displays tag numbers whose pipe spec data fits the pipe
specs assigned to the sub-library to which the hook-up belongs.

• You can display the available tag numbers either on the highest or
lowest level of your plant hierarchy defined by the Domain
Administrator. The default highest level is Plant. The default lowest
level is Unit.
5. Under Available tag numbers, select one or more tags and do one of the
following:
• Drag the selected tags to the Associated tag numbers pane.
6. If you selected more than one hook-up or hook-up type in the Domain Explorer,
click Next and make associations for another hook-up.
Related Topics
• Generate a Hook-Up Tag List Report, page 1164
Move Hook-Ups to Another Hook-Up Type

1. Press F7 to open the Domain Explorer, and double-click the Hook-Ups folder to
display all the existing hook-ups types and hook-ups in the Items pane.
2. In the Items pane, select and right-click hook-ups that you want to move to
another hook-up type.
3. On the shortcut menu, click Actions > Move Hook- Ups.
4. On the dialog box that opens, select the target hook-up type and click OK.
Related Topics

Associate Hook-Ups with a Sub-Library

1. Press F7 to open the Domain Explorer, and double-click the Hook-Ups folder.
• In the tree view pane, right-click a specific hook-up.
• In the Items pane, select and right-click one or more hook-ups.
4. On the Hook-Up Properties dialog box, from the Item sub-library list, select a
desired sub-library.
Tips
• The Item sub-library contains all sub-libraries you defined in the
active item library in the Reference Explorer, where the active library
is indicated with the icon. If you set another library as the active
item library, the software automatically assigns the default sub-library
of the new active item library to all the existing hook-ups.
• If you assigned the hook-up to one of the user-defined sub-libraries,
you can click Pipe Specs to display the pipe specs you associated with
the selected user-defined sub-library in the Reference Explorer.
Related Topics

Associate Items with Hook-Ups

• In the tree view pane, select a hook-up type and then, in the Items
pane, select and right-click one or more hook- ups.
• In the tree view pane, select the Hook-Ups folder to display all the
existing hook-up types and hook-ups in the Items pane, and then, in
the Items pane, right-click one or more hook-up types or hook-ups.
3. On the shortcut menu, click Actions > Associate Items with hook-Ups.
Tips
available in the library you set in the Reference Explorer as the active
item library.
.
4. Under Items available for association, select one or more hook-up items and do
• Drag the selected items to the Associated items pane.
5. In the Quantity column, type a value for the quantity of items for a Bill of
Material. For example, if you associated a male connector and the current hook-
up requires twenty male connectors, type 20.

6. In the Spares Percentage column, type or modify the percentage of total units of
measure specified for the current hook-up item on the Hook-Up Item Properties
dialog box.
Tips
• The software uses the values that you add in the Quantity and Spares
Percentage columns when calculating the total quantity of items for a
Bill of Material. For details, see Calculating the Total of Hook-Up
Items for a Bill of Material, page 1160
• After associating hook-up items with a hook-up, the software
generates new sequence numbers automatically and displays the
numbers in the Order column, where you can sort the items by their
order of their assignment to a hook-up. You can type a new sequence
number if needed. You can open a Bill Of Material and sort the items
by the item order. For more information, see Sort Data in a Bill of
Material, page 1163.
Related Topics
• Generate a Hook-Up Item List Report, page 1163

Dissociate Items from Hook-Ups

• In the tree view pane, select a hook-up type and then, in the Items
pane, select and right-click one or more hook- ups.
3. On the shortcut menu, click Actions > Associate Items with hook-Ups.
Tips
• On the dialog box that opens, under Associated items, you can
double-click a column header in the to sort the items in ascending
order. Double-click again to sort the items in descending order.
• In the Associated items pane, there is a vertical bar that you can drag
to the right and view your data in a split display. To find the vertical
bar, place the cursor to the left of the left scroll box arrow so that the
cursor changes its shape as shown:
.
4. Under Associated items, select one or more hook-up items and do one of the
following:
• Click Dissociate.
• Drag the selected items from the Associated items pane to the Items
available for association pane.
Related Topics

Dissociate Tag Numbers from Hook-Ups

type level in the Hook- Ups folder.
• In the tree view pane, select a hook-up and then, In the Items pane,
select and right-click one or more hook- ups.
• In the tree view pane, select the hook- up hierarchy root node to
display all the existing hook-up types in the Items pane, and then, in
the Items pane, right-click one or more hook-up types.
3. On the shortcut menu, click Actions and click Associate Tag Numbers with
Hook-Ups.
Tips
.
4. Under Associated tag numbers, select one or more tags and do one of the
following:
• Drag the selected tags to the Available tag numbers pane.
5. If you selected more than one hook-up or hook-up type in the Domain Explorer,
click Next and dissociate tag numbers from another hook-up.
Related Topics

Delete Hook-Ups
• In the tree view pane, select a specific hook-up you want to delete.
• In the tree view pane, select a hook-up type, and then, in the Items
Tip
• When deleting hook-ups, the software automatically dissociates all the
hook-up items and instrument tags.
Related Topics
Delete Hook-Up Types

• In the tree view pane, right-click a hook-up type that does not have
hook-ups.
• In the Items pane, select and right-click several hook-up types that do
not have hook-ups.
Related Topics

Hook-Up Drawing Generation: An Overview

You can generate a hook-up drawing using either the Enhanced Report Utility or an
external CAD application such as SmartSketch, AutoCAD, or MicroStation.
Generated drawings contain the hook-up block drawing, the list of assigned tag
numbers, and hook-up items associated with the current hook-up.
CAD Hook-Up Drawing Generation Scenario

1. On the Preferences dialog box, on the Hook-Ups > File Locations page, define
the CAD paths for hook-up drawings.
2. If you require a global border and logo, in your CAD application, prepare a
drawing border and logo, and then, enable the use of it in SmartPlant
Instrumentation. For details, see Assign Border and Logo Blocks to Hook-Up
Drawings, page 1149.
3. In your CAD application, create a general drawing (optional). You only need to
create such a drawing if you intend to use the General drawing option of
SmartPlant Instrumentation when generating a hook-up drawing that contains
more than one page. Then, on the SmartPlant Instrumentation Preferences dialog
box , on the Hook-Ups > General page, specify the general drawing that you
want to appear on the second and all other subsequent pages of the hook-up
drawing you will generate.
Tip
• A generated hook-up drawing contains more than one page if the
number of tag numbers associated with the selected hook-up is greater
than the number of macros that can be accommodated on the first
hook-up drawing page. Your general drawing will appear on the
second and all other subsequent pages of the hook-up drawing
generated from SmartPlant Instrumentation.
4. On the Preferences dialog box, on the Hook-Ups > General page, set the
revision display order.
Tip
• You can display a number of revisions in the title block of a hook-up
drawing. Each revision is represented by a numbered macro and the
revisions are displayed in the order of the macro numbering, beginning
with the first revision (ascending order) or the last revision
(descending order). If the total number of revisions is greater than the
number of lines available for display in the drawing and you want to
see the latest revisions, you should select to display the revisions in

5. In your CAD application, create a hook-up drawing template using your CAD
application so that this template includes the tag number and hook-up item macros
as well as the title block.
Important
• Make sure the macro names you enter in the drawing template match
the macro names you defined on the Macro Definitions dialog box in
the Hook-Ups module.
6. If you want to edit the hook-up drawing identifying fields, associate the document
and revision numbers, in the Domain Explorer, open the Hook-Up Drawing
List dialog box and define data accordingly.
7. In the Domain Explorer, open the Generate Hook-Up Drawings dialog box and
set the generation options as you require.
8. Generate a hook-up drawing from the Generate Hook-Up Drawings dialog box.
Enhanced Hook-Up Drawing Generation Scenario
1. On the Preferences dialog box, on the Enhanced Reports > Hook-Up > View
page, select the options you want to see in your drawing.
2. On the Enhanced Reports > Hook-Up > File Locations page, set the file paths
for the various options.
3. If required, change the text appearance by changing the settings on the Fonts
page.
4. On the Enhanced Reports > Hook-Up > Title Block page, select the title block
you require for your drawing.
5. On the Enhanced Reports > Hook-Up > Pagination and Revisions page, set the
revision display order.
Tip
• You can display a number of revisions in the title block of a hook-up
drawing. Each revision is represented by a numbered macro and the
revisions are displayed in the order of the macro numbering, beginning
with the first revision (ascending order) or the last revision
(descending order). If the total number of revisions is greater than the
number of lines available for display in the drawing and you want to
see the latest revisions, you should select to display the revisions in
6. If you want to edit the hook-up drawing identifying fields, associate the document
and revision numbers, in the Domain Explorer, open the Hook-Up Drawing
List dialog box and define data accordingly.

7. Assign the required hook-up symbol file to the hook-up. For more information,
see Assign an Enhanced Symbol to a Hook-Up, page 1149
8. In the Domain Explorer, open the Generate Hook-Up Drawings dialog box and
set the generation options as you require.
9. Generate a hook-up drawing from the Generate Hook-Up Drawings dialog box.

Managing Hook-Up Drawings Common Tasks

These tasks deal with generating hook-up drawings using a CAD application or the
Enhanced Report Utility, maintaining revisions, editing hook-up drawing identifying
fields that appear in the title block, and so forth. For a complete list of hook-up
reports, see Hook-Up Reports: An Overview, page 1158.
Apply a Drawing Generation Method to Hook-Ups

Use this procedure to apply a drawing generation method to one or more hook-ups
manually. This feature is useful if you intend to generate hook-up drawings in a
mixed mode, that is, generate several CAD hook-up drawings and several enhanced
hook-up drawings in one generation session. You generate CAD hook-up drawings
using your CAD application (SmartSketch, AutoCAD, or MicroStation), whose paths
you specified on the Preferences dialog box. You generate enhanced hook-up
drawings using the Enhanced Report Utility, which comes with the SmartPlant
Instrumentation software package. For more information, see Apply a Drawing
Generation Method to Hook-Ups, page 1144.
Set Default Generation Method for Hook-Up Drawings

Use this procedure to set the default generation method that the software can use
automatically when your hook-up selection contains hook-ups that do not have a
generation method applied manually. For more information, see Set Default
Generation Method for Hook-Up Drawings, page 1145.
Edit Hook-Up Drawing Identifying Fields

Hook-up drawing properties appear in the title block fields. These fields contain
identifying information about the drawing name, page number, and file name, and
also information about revisions, approvals, and references to other documents. You
can modify the property information using the options in the Hook-Up Drawing List
dialog box.
For each hook-up drawing, SmartPlant Instrumentation displays the hook-up name
and hook- up description. You can use this procedure to edit the hook-up name,
description, and the output file name. For more information, see Edit Hook-Up
Drawing Identifying Fields, page 1145.
Make Approvals for Hook-Up Drawings

This procedure enables you to make client and vendor approvals for hook-up
drawings. For more information, see Make Approvals for Hook-Up Drawings, page
1146.

Maintain Hook-Up Drawing Revisions

The revision feature is used to keep track of the changes made to the hook-up
drawing during its lifetime. It is important and useful to have a chronological
description of the changes, dates of change, and a list of persons who approved them.
Using this procedure, you can add, edit, and delete revisions.
The revision feature is used to keep track of the changes made to the hook-up
drawing during its lifetime. It is important and useful to have a chronological
description of the changes, dates of change, and a list of persons who approved them.
Using this procedure, you can add, edit, and delete revisions. For more information,
see Maintain Hook-Up Drawing Revisions, page 1147.
Add Document References in Hook-Up Drawings

This procedure enables you to make a reference to a drawing and add this reference to
the title block of the hook-up drawing. For more information, see Add Document
References in Hook-Up Drawings, page 1148.
Assign Border and Logo Blocks to Hook-Up Drawings

This procedure allows you to set SmartPlant Instrumentation to use a specific border
block and logo block every time you generate a CAD hook-up drawing. Blocks that
you set as default general blocks must belong to the shipped general block types, that
is, Border and Logo block types available in the Drawing Block Types folder of the
Domain Explorer. For more information, see Assign Border and Logo Blocks to
Hook-Up Drawings, page 1149.
Update Paths for Hook-Up Drawings and Block Files

Use this procedure to update in the database paths for existing hook-up drawings and
block files. You can update paths globally for block files associated with hook-ups,
for logo and border blocks, and for hook-up drawings that you generated. For more
information, see Update Paths for Hook-Up Drawings and Block Files, page 1150.
Generate CAD Hook-Up Drawings

Use this procedure to generate one or more hook-up drawings using you CAD
application. For more information, see Generate CAD Hook-Up Drawings, page
1151.
Generate Enhanced Hook-Up Drawings

Use this procedure to generate one or more hook-up drawings using the Enhanced
Report Utility. For more information, see Generate Enhanced Hook-Up Drawings,
page 1153.
Generate Hook-Up Drawings in Mixed Mode

Use this procedure to generate several hook-up drawings according to the generation
method applied to the source hook-ups. For more information, see Generate Hook-
Up Drawings in Mixed Mode, page 1154.

Shipped Enhanced Hook-Ups Symbols

SmartPlant Instrumentation supplies two symbols for use with enhanced hook-ups;
• HookUp_CV.sym
• HookUp_DPtransit.sym
They are located in the SmartPlant Instrumentation home folder > RAD >
Symbols > Custom.
These shipped files can be used, as is, to produce enhanced hook-ups drawings for
control valves, or data process transmitters. They can also be customized to produce
enhanced hook-up drawings for other hook-up items. For more information on
editing and customizing symbols, see the Symbol Editor or Catalog Manager User
Guides.
Related Topics
• Assign an Enhanced Symbol to a Hook-Up, page 1149
Apply a Drawing Generation Method to Hook-Ups

1. Press F7 to open the Domain Explorer and then double-click the Hook-Ups
folder.
2. In the Items pane, select and right-click one or more hook-ups.
3. On the shortcut menu, click Apply Generation Method.
4. Select one of the following:
• CAD— Allows you to and assigns the indicator to the selected hook-
ups.
• Enhanced Report— Allows you to and assigns the indicator to the
selected hook-ups.
Tips
To view an existing generation method assignment, you can right-click the
appropriate hook-up and click Properties to open the Hook-Up Properties
dialog box.
• To clear the current generation method for one or more hook-ups,

select and right-click the required hook-ups, and then, on the shortcut
menu, click Actions > Clear Generation Method.
Related Topics

Set Default Generation Method for Hook-Up Drawings

2. Click Hook-Ups > General.
3. From the Default generation method list, one of the following methods:
• CAD — Generates hook-up drawings using your CAD application
and allows you to use the CAD Options tab.
• Enhanced Report— Generates hook-up drawings using the
Tip
• The default generation method that you set appears on the Generate
Hook-Up Drawings dialog box.
Related Topics
Edit Hook-Up Drawing Identifying Fields

• In the tree view pane, select a hook-up type and then, In the Items
3. On the shortcut menu, click Actions > Hook-Up Drawing List.
4. On the Hook-Up Drawing List dialog box, select a row and click Edit.
5. In the Document field, type a name for the drawing document.
Tip
• If you type an existing document name, the software prompts you to
confirm the multiple use of the name.
6. In the Document Description field, type a description.

7. To change the default output file name, do one of the following:

• In the Output File Name field, type a different file name over the
default name.
• Beside the output file name string, click to set a name of an
existing file as the output file name for the current hook-up drawing.
Tip
• The default output file name is the same as the hook-up name. If there
are any spaces in the hook-up name, the software replaces the space
with an underscore (_). The file name ends with an underscore (_) and
a two-digit sequence number representing the page number of a multi-
page drawing. For example, flow_transmitter_03.dwg. When the
drawing consists of a single page, the file name ends with _01.
8. Repeat the appropriate steps of this procedure for any other hook-up drawing.
Related Topics
Make Approvals for Hook-Up Drawings

4. On the Hook-Up Drawing List dialog box, click Approvals and then enter the
client and vendor data as needed.
Related Topics

Maintain Hook-Up Drawing Revisions

4. On the Hook-Up Drawing List dialog box, select a desired row and click
Revisions.
P0, P1, P2... for preliminary revisions or 0, 1, 2 /A, B, C, and so forth. for normal
serial revisions).
Tip
• Click a field of an existing row to update the existing revision data.
• Click New to add new revision data, and then type new revision data
values.
Tip
• As a time saver and a forget-me-not precaution, take advantage of
using a default revision method. The software automatically adds a
new line with the next logical character and date each time you click
New after you select the initial method.
7. If necessary, click Delete to delete any previous revisions that are no longer
needed.
Tip
• You can also maintain revisions in batch mode using global revisions.
Related Topics

Add Document References in Hook-Up Drawings

4. On the Hook-Up Drawing List dialog box, click References open the Document
References dialog box.
5. To insert a new document reference, do the following:
a. Click New to open the Drawing Reference Properties dialog box.
b. Select a value from the References list.
c. Type the name and description in the appropriate boxes.
d. Click OK to return to the Document References dialog box.
6. To edit a manually inserted drawing reference, do the following:
a. Select a desired row and click Properties to open the Drawing Reference
b. Edit the name and description.
c. Click OK to return to the Document References dialog box.
Tip
• To delete a reference, select a row, and click Delete.
Related Topics

Assign Border and Logo Blocks to Hook-Up Drawings

1. In the Domain Explorer, expand the hierarchy of the Drawing Block Types
folder.
2. Right-click the Border block type, and then, on the shortcut menu, click New >
Block.
3. Define the new border block as you require.
4. Right-click the Logo block type, and then, on the shortcut menu, click New >
Block.
5. Define the new logo block as you require.
Tip
• In hook-up drawings, you can only use the blocks created in default
Border and Logo general block types. Blocks belonging to user-
defined general block types, which you create for loop drawings, do
not appear in hook-up drawings.
6. On the File menu, click Preferences > Hook-Ups > General.
7. Select Use global border/logo.
8. In the Hook-Ups module menu bar, click Associations > Default General
Blocks.
9. On the Default General Blocks dialog box, select the border and logo blocks
from the lists.
Related Topics
Assign an Enhanced Symbol to a Hook-Up

1. In the Domain Explorer, open the Hook-Up folder
2. Right-click the required hook-up, and from the shortcut menu click Properties.
3. On the Hook-Up Properties dialog box, locate the Drawing block file name
and path list, and click Browse.
4. On the Select File dialog box, navigate to, and select the .sym file you want to
associate with the hook-up.
Tip
• If you want to view the symbol before assigning it to the hook-up, on
the Hook-Up Properties dialog box, click View to display the symbol
in your default symbol editor.
5. Click OK.

Update Paths for Hook-Up Drawings and Block Files

Note
• The paths that you specify do not overwrite the settings specified for new
block files and output drawings on the Hook-Ups > File Locations page
of the Preferences dialog box.
1. Open the Hook-Ups module.
2. Click Actions > Update Paths for Existing Drawings and Blocks.
3. Under Path for associated block files, do one of the following:
• Click Apply to drawings in the domain or project to apply the new
path to all the <plants> in the current domain, or to the current project
• Click Apply to drawings in the current <plant> only to apply the
new path to the current <plant> only.
4. Type the full path to the folder where you keep your drawing blocks files or click
5. Under, Path for generated hook-up drawings do one of the following:
• Click Apply to blocks in the domain or project to apply the new
path to all the <plants> in the current domain, or to the current project
• Click Apply to blocks in the current <plant> only to apply the new
path to the current <plant> only.
6. Type the full path to the folder where you keep your generated hook-up drawings
or click Browse to navigate to the desired folder.
Related Topics

Generate CAD Hook-Up Drawings

Note
• A complete hook-up drawing generation scenario is described in the Help
topic Hook-Up Drawing Generation: An Overview, page 1139
hook-up type level in the Hook-Ups folder.
2. In the tree view pane, select a hook-up type.
Tip
• In the Domain Explorer, you can also select hook-up types instead of
hook- ups. In this case, you can generate hook-up drawings that
belong to all the hook-ups that are assigned to the selected hook-up
types.
4. On the shortcut menu, click Reports > Generate Hook-Up Drawings to display
the General tab of the Generate Hook-Up Drawings dialog box.
5. From the Generation method list, select CAD.
6. Click the CAD Options tab.
7. If you want to save the generated hook-up drawing as external CAD files, select
the Save file in format check box, and then beside the Target folder path box
click Browse to specify the folder. To select a folder, you have to select any file
that exists in that folder.
Tips
• In the Target folder path box, the software displays the default folder
you specified on the Preferences dialog box, in the Hook-Ups > CAD
File Locations page, in the Output drawing folder box.
• The file format that the software uses when saving a hook-up drawing
depends on your CAD application. If you use AutoCAD, the software
saves the drawing file in .dwg format. If you select MicroStation, the
software saves the drawing file in .dgn format.
• When using SmartSketch, you can save the drawings in any format
available in the list. From the box below Save file is format, select a
desired format. If you select SmartSketch, the software saves the
drawing file in .sym format.

• The output filename is the same as the hook-up name. If there are any
spaces in the hook-up name, the software replaces the space with an
underscore (_). The filename ends with an underscore (_) and a two-
digit sequence number representing the page number of a multi-page
drawing. For example, flow_transmitter_03.dwg.
8. If needed, select Send to plotter or printer to send the generated drawings to the
current CAD plotter or printer.
9. If you want to apply the macro functions associated with macros, select Use
macro functions.
10. For a multi-page hook-up drawing generation, under Drawing for subsequent
pages, select one of the following:
• Same as first— Allows you to display the generated hook-up
drawing on the first page as well as on all the subsequent pages as
well.
• General drawing — Allows you to display the generated hook-up
drawing on the first page and the general drawing on all the
subsequent pages. The general drawing is a predefined drawing that
you specified on the Preferences dialog box.
Tips
• The software generates a multi-page drawing automatically if the
drawing contains more than one page if the number of tag numbers
associated with the selected hook-up is greater than the number of
macros that can be accommodated on the first hook-up drawing page.
For a multi-page drawing, you can enter the page number of the first
generated page of the hook-up drawing in the Generate from page
box. For example, if you enter the value 2 and then generate a hook-
up drawing, the first page of the hook-up drawing displays the value 2.
A multi-page drawing is a drawing in which the number of tags
associated with the current hook-up is larger than the number of
macros that can be accommodated in the generated hook-up drawing.

• If your CAD application is SmartSketch, by default, all drawings that

you generate have the A3 Wide print sheet size. This print sheet size
is defined in the template file pid.igr, which comes shipped with
SmartPlant Instrumentation. This file appears in the CADFunc folder,
for which you specified the path setting on the Preferences dialog
box, Hook-Ups > CAD File Locations page. If you want to generate
hook-up drawings using a different print sheet size, you must open the
pid.igr file in SmartSketch and modify the sheet settings as you
require. Note, however, that changes that you make in the pid.igr file
affect both hook-up drawings and loop drawings you generate in
SmartSketch. If you want the print sheet size of hook-up drawings not
to affect the print sheet size of loop drawings, duplicate the CADFunc
folder with all its content and define a different path setting preference
for loop drawings on the Loop Drawings > CAD File Locations
page.
Related Topics
Generate Enhanced Hook-Up Drawings

Note
topic Hook-Up Drawing Generation: An Overview, page 1139
Tip
types.
4. Assign the required hook-up symbol file to the hook-up. For more information,
see Assign an Enhanced Symbol to a Hook-Up, page 1149

6. From the Generation method list, select Enhanced Report.

Tip
• Under Automatic save options for enhanced hook-up drawings,
you can select Save drawings automatically to overwrite the default
folder specified on the Preferences dialog box, Enhanced Report >
Hook-Ups > File Locations page. You can click Browse and specify
a different folder for saving the hook-up drawings automatically as
files at the time of generation.
7. Click OK to generate the drawings for the selected hook-ups.
Note
• Generating an Enhanced Hook-Up drawing with a Tag List and /or an
Associated Item List, results in the lists being randomly positioned on
your drawing. You can drag the lists and position them on the drawing as
required. Each time you regenerate the drawing, the lists are randomly
repositioned. You have to save the Enhanced Hook-Up drawing as an
external document to save the lists current position, using Save Custom.
Related Topics
Generate Hook-Up Drawings in Mixed Mode

Notes
• When generating hook-up drawings in mixed mode, you use the As
previously applied option of the Generate Hook-Up Drawings dialog
box. Mixed mode enables you to generate CAD hook-ups drawings and
enhanced hook-up drawings altogether: CAD hook-up drawings for hook-
ups whose generation method in the Domain Explorer is indicated as C
and enhanced hook-up drawings for hook-ups whose generation method in
the Domain Explorer is indicated as E. You must first assign your hook-
ups to the appropriate generation methods. For details, see Apply a
Drawing Generation Method to Hook-Ups, page 1144.
topic Hook-Up Drawing Generation: An Overview, page 1139.


Tips
types.
• For hook-up drawing generation in mixed mode, you selection can
include hook-ups assigned to the CAD generation method, hook-ups
assigned to the Enhanced Reports method, and also hook-ups that are
not assigned to any generation method.
5. Click the CAD Options tab and define options for CAD hook-up drawings as you
require.
Tip
• You must first set generation options for CAD hook-up drawings
because after you select As previously applied on the General tab,
the CAD Options tab becomes disabled. For example, on the CAD
Options tab, you can select the Send to plotter or printer check box
if you want to print out the generated CAD hook-up drawings at the
time of generation. This check box is cleared by default.
6. Click the General tab.
7. From the Generation method list, select As previously applied.
Tips
• After you select As previously applied, the CAD Options tab and the
Automatic save options for enhanced hook-up drawings become
disabled. When generating the drawings, the software saves the output
files to the default folders whose paths you specified on the
Preferences dialog box individually for CAD drawings and enhanced
hook-up drawings, which are generated by the Enhanced Report
Utility.
• If you hook-up selection in the Domain Explorer includes hook-ups
that are not assigned to any method, the software applies the method
displayed in the Default generation method box. You define the
default generation method on the Hook-Ups > General page of the
8. Click OK to generate the hook-up drawings for the selected hook-ups.
Related Topics

Create a New Macro Definition

• Click .
3. In the Macro definition details data window, select the desired macro definition.
Tip
4. To create a customized macro definition, do one or more of the following:
a. Under Macro Name, type the desired user name for your macro.
b. Click in the Description field and change the description as desired.
c. Under Function, select a function to modify the appearance of the retrieved
data.
5. To add another customized macro definition, click New and repeat the previous
step.
6. Click Apply to accept your customized macro definitions.
Related Topics

Delete a Macro Definition

• Click .
3. In the Macro definition details data window, select the row containing the macro
definition that you want to delete.
Tip
4. Click Delete.
Related Topics

Hook-Up Reports: An Overview

The following hook-ups reports are available in SmartPlant Instrumentation:
• Bill of Material — Displays data used in a Bill of Material.

• Hook-Up Tag List — Displays instrument tag numbers assigned to hook-
ups.
• Hook-Up Item List — Displays hook-up items assigned to hook-ups.
• Library Items — Displays items defined in the item libraries. If an item
library contains user-defined sub-libraries, the items are displayed in the
report per sub-library.
• Hook-Up Macros — Displays all SmartPlant Instrumentation macros
used in hook-up drawings. The report displays the macro name,
description, name used in SmartPlant Instrumentation and, if applicable,
the macro function.

According to the report type, you can generate reports either using the Reports menu
of either Domain Explorer, the Reference Explorer, or the Hook-Ups window.
The following table lists the report-specific options:
Access to Bill of Hook-Up Hook-Up Library Hook-Up

Report Material Tag List Item List Items Macros
Domain Allows you Allows you Allows you N/A N/A
Explorer to select all to select all to select all
or selected or selected or selected
hook-up hook-up hook-up
types, or types, or types, or
hook-ups in hook-ups in hook-ups in
the Hook- the Hook- the Hook-
Ups folder. Ups folder. Ups folder.
Reference N/A N/A N/A Allows N/A
Explorer you to
select all or
specific
libraries or
sub-
libraries in
the Hook-
Up Item
Libraries
folder
Hook-Ups Allows you Allows you Allows you Allows Allows you to
Module to open to open to open you to click Reports
window previously previously previously click > Hook-Up
generated generated generated Reports > Macros and
Bills of Hook-Up Hook-Up Library group the
Materials Tag List Item List Items to macros by
Bill of reports by reports by generate a module to
Material by selecting the selecting the report of organize the
selecting the document document all existing report pages
document number of number of hook-up according to
number of the existing the existing items. the module
the existing reports. reports. titles. If you
Bills of do not group
Materials. the macros, the
report displays
all the macros
in alphabetical
order.

Calculating the Total of Hook-Up Items for a Bill of Material

When you generate a Bill of Material, SmartPlant Instrumentation calculates the total
quantity of hook-up items according to the following formula: (number of associated
instrument tags + number of additional tags for the Bill of Material) × quantity of
items of the same type × (item spares percentage + 100) / 100. For example, if the
total number of control valves associated with the hook-ups in the Bill of Material is
5, the number of additional instruments is 2, the quantity of male connector items is 2,
and spares percentage is 20%, the total quantity is calculated as (5 + 2) × 2 × (20
+100) / 100 and the Total Qty column in the Bill of Material displays 12.
Notes
• If the unit of measure of the hook-up item is either Item or Piece, the
software rounds up the calculated total quantity value so that no fraction
remains.
• You define the number of the additional tags on the Associate Tag
Numbers with Hook-Ups dialog box.
• You define the item quantity and spares percentage on the Associate
Items with Hook-Ups dialog box. It is also possible to define item spares
percentage on the Hook-Up Item Properties dialog box.
Related Topics
• Generate a Bill of Material, page 1162

Hook-Up Reports Common Tasks

These tasks deal with generating and opening a print preview of a Bill of Material and
reports that show hook-up data, the associated instruments, and hook-up items. For a
complete list of hook-up reports, see Hook-Up Reports: An Overview, page 1158.
Generate a Bill of Material

This procedure describes how to generate a Bill of Material (BOM), which is the
main purpose of the Hook-Ups module. Prior to generating a Bill of Material, you
need to define hook-up types and hook-ups in the Domain Explorer, and then,
associate hook-up items and instruments to the hook-ups. For more information, see
Generate a Bill of Material, page 1162.
Sort Data in a Bill of Material

Use this procedure to sort data in a Bill of Material print preview. For more
information, see Sort Data in a Bill of Material, page 1163.
Generate a Hook-Up Item List Report

Use this procedure to generate a report that displays hook-up items associated with
the hook-ups you select in the Domain Explorer. For more information, see
Generate a Hook-Up Item List Report, page 1163.
Generate a Hook-Up Tag List Report

Use this procedure to generate a report that displays instrument tag numbers
associated with the hook-ups you select in the Domain Explorer. For more
information, see Generate a Hook-Up Tag List Report, page 1164.
Open Reports by Selecting Document Numbers

Use this procedure to open reports by selecting document numbers you created for the
current report type. To use this procedure, you must first generate reports and define
a document number for each report you want to make available for selection. For
example, you can generate five Hook-Up Item List reports for hook-ups belonging to
the FLOW hook-up type and define the Flow Hook-Up document number for each
report. Furthermore, you can generate four Hook-Up Item List reports for hook-ups
belonging to the LEVEL hook-up type and define the Level Hook-Up document
number for each report. You can then use this procedure to select all or some of the
defined document numbers and open the report print preview. For example, you can
select five Flow Hook-Up document numbers and open the print preview of five
Hook-Up Item List reports. For more information, see Open Reports by Selecting
Document Numbers, page 1164.
Related Topics

Generate a Bill of Material

Tip
hook-ups. In this case, you can generate a Bill of Material for all
hook-ups that belong to the selected hook-up types. If you select all
the hook-up types, you generate a Bill of Material for all the existing
hook-ups.
4. On the shortcut menu, click Reports > Bill of Material.
5. Click Yes to open the print preview of the new Bill of Material or click No to
send it to your default printer.
Tips
• In the Bill of Material header area, some of the headers are not
displayed if you generated a Bill of Material for more than one hook-
up or hook-up type.
• In the Print Preview window, you can sort the Bill of Material data as
you need and group the Bill of Material data by hook-up item
manufacturer.
• If you select the Edit mode check box, you can enter values in the For
Order field, which appears under the Total Qty field. The For Order
values are not saved in the database and only appear in the current
printout. For details about the calculation formula, see Calculating the
Total of Hook-Up Items for a Bill of Material, page 1160.
• You can select Print BOM together with the tag list to print out the
instrument tags associated with the hook-ups when printing the Bill of
Material. The Print Preview window does not show the instrument
tags.
• On the Print Preview window toolbar, clicking the revision icon
enables you to create the Bill of Material revision and define the
document number. After you define the document number, you can
then open the same report using the Reports > Reports by Document
Numbers option of the main Hook-Ups Module window.
• Clicking on the Print Preview window toolbar, allows you to save
the Bill of Material to an external file and see the changes in the Bill of
Material the next time you generate it.

Sort Data in a Bill of Material

1. In the Bill of Material print preview, from the Sort by list, select an option to
arrange the fields as you require.
Tip
• Each option in the Sort by list corresponds to a column header in the
print preview.
2. Select the Ascending order check box to display the fields in ascending order or
clear the Ascending order check box to display the fields in descending order.
Related Topics
Generate a Hook-Up Item List Report

Tip
hook- ups. In this case, you can generate a report for all hook-ups that
belong to the selected hook-up types. If you select all the hook-up
types, you generate a report of all the hook-up items associated with
for the existing hook-ups.
4. On the shortcut menu, point to Reports and click Hook-Up Item List.
5. Click Yes to open the report print preview or click No to send it to your default
printer.
Tip
enables you to create the report revision and define the document
number. After you define the document number, you can then open
the same report using the Reports > Reports by Document Numbers
option of the main Hook-Ups Module window.
Related Topics
• Hook-Up Reports Common Tasks, page 1161

Generate a Hook-Up Tag List Report

Tip
hook- ups. In this case, you can generate a report for all hook-ups that
belong to the selected hook-up types. If you select all the hook-up
types, you generate a report of all the tags associated with for the
existing hook-ups.
4. On the shortcut menu, point to Reports and click Hook-Up Tag List.
5. Click Yes to open the report print preview or click No to send it to your default
printer.
Tip
enables you to create the report revision and define the document
number. After you define the document number, you can then open
the same report using the Reports > Reports by Document Numbers
option of the main Hook-Ups Module window.
Related Topics
• Hook-Up Reports Common Tasks, page 1161
Open Reports by Selecting Document Numbers

Note
• To use this procedure, you must first generate the appropriate hook-up
report in the Domain Explorer.
1. On the Hook-Ups module menu bar, click Reports > Reports by Document
Numbers, and then, select the appropriate report.
2. On the dialog box that opens, select one or more document numbers and click OK
to open the print preview of the reports.
Related Topics
• Generate a Hook-Up Item List Report, page 1163
• Generate a Hook-Up Tag List Report, page 1164

Maintenance Module: An Overview

The Maintenance module provides you with all the tools required to plan, carry out,
and document the breakdown and preventive maintenance associated with the
instruments in your plant.
Breakdown Maintenance
Breakdown maintenance features deal with the malfunction of equipment. You can
deal with problems on two levels:
• Work Requests
A work request can be initiated by most of the technical staff. A work request
describes a possible malfunction or repair that may be required in the future.
The work requests are then examined by the maintenance supervisor or
foreman who can approve them and then create an actual work order (repair).
• Repair Forms
A repair form is the actual repair or work that has been approved by the
maintenance supervisor or foreman. It indicates the repair date and describes
the nature of the problem as well as the work group that is assigned to carry
out the job. The repair form also includes, in a different section, the
information that is filled in by the person who performed the work,
malfunction cause and action taken, as well as the down and repair time.
Preventive Maintenance
Preventive maintenance features enable you to maintain and schedule periodic
maintenance activities that contain tasks and procedures.
Notes
• The Maintenance module is available only if it is included in the software
• You can issue new work requests, repairs, or preventive maintenance work
orders only from the Instrument Index module. Once you have added
maintenance records, you need to access the Maintenance Activities
Summary window for further handling of these activities.
Related Topics
• Maintenance Event Records: An Overview, page 1189
• Performing Breakdown Maintenance, page 1171
• Performing Preventive Maintenance, page 1182

Access Rights in the Maintenance Module

There are several different access right levels in the Administration module that
control the data input for the Maintenance module. The access right levels are
arranged by the form types:
Level Item Description

<Plant> Supporting tables Ability to access, edit and delete items from the
supporting tables of the module which controls the
forms.
<Unit> Module Access Ability to allow or deny access to this module.
<Unit> Work Request – Ability to add new work request Forms from the
Technician Index module. This option should be enabled to all
technical staff.
<Unit> Repair – Technician Ability to convert and schedule the work request
into an actual work order.
<Unit> Repair – Supervisor Technician's option includes filling in the repair
data.
<Unit> Preventive Preventive Maintenance supervisor's option to
Maintenance – schedule PM activities, assign a work group and
Supervisor schedule dates.
<Unit> Preventive Preventive Maintenance technician options include
Maintenance – filling out test results.
Technician

Starting the Maintenance Module

Note
• The Maintenance module is available only if it is included in the software
license that you purchased from Intergraph. Before starting this module,
check with the Domain Administrator to ensure that you have been
granted appropriate access rights for the tasks you will carry out.
Start the Maintenance Module From Any SmartPlant

Instrumentation Module
• Do one of the following:
• Click Modules > Maintenance.
Start the Maintenance Module From an Instrument Index

Browser View
2. In the browser view, select and then right-click the tag numbers that require
maintenance.
3. On the shortcut menu, point to Maintenance and then click one of the following
options:
• Schedule Preventive Maintenance Activities
• Work Request Form
• Repair Form
Related Topics
• Filtering Maintenance Activities, page 1168

Filtering Maintenance Activities

Use this procedure to filter the maintenance records of the current domain displayed
in the Maintenance Activities Summary window. These include the following
types of records:
• Preventive maintenance
• Repair forms
• Work requests
Filter Maintenance Activities

1. Open the Maintenance Activities Summary window.
2. Under Process function, do one of the following:
• To display records for tags of all process functions, select the blank
row.
• To limit the records to tags of one process function, select the process
function of interest.
3. To limit the display of preventive maintenance records to a given preventive
maintenance code, select the code under Preventive maintenance code.
4. To limit the display of maintenance records to a given date range, do the
following:
a. Under From, enter the starting date.
b. Under To, enter the ending date.
5. Do one of the following under Data level:
• To limit the records displayed, select Plant, Area, or Unit.
• To not limit the records displayed, accept the default setting of
Domain.
6. To limit the display of maintenance records by tag category, select a value from
the Category list.
7. In the Maintenance records pane, do one of the following:
• To display records for all of the tags that have maintenance data, select
All Activities.
• To display records for selected tags, click to open the tree, and then,
select the tag for which you want to display maintenance records
Tip
• To clear all filter settings, click Reset.

Generating Maintenance Reports

This option enables you to select and generate a maintenance report. You can
generate the following reports:
• Scheduled Preventive Maintenance Report

• Summary of Failure Reason Report
• Summary of Repair Action Report
• Summary of Outcome Report
• Repair Details Report
Generate a Maintenance Report

1. Start the Maintenance module.
2. In the Maintenance Activities Summary window, on the Reports menu, click
the report that you want to generate.
3. In the Report Properties dialog box, in the Date range group box, do one of the
following to set the date range for the report:
• Select the User defined option and set a specific period by typing or
selecting the required dates from the From and To lists.
• Select the Predefined option to generate a report for the last, current
or next week, month, or year.
4. To filter the data level of the report, select Plant, Area, or Unit.
5. Click OK.

Preventive Maintenance Preliminary Activities

You have to define certain preliminary settings before you can start scheduling
preventive maintenance activities or issuing work requests and repair forms. These
preliminary settings include the following three definitions:
• Defining Preventive Maintenance Attachments, page 1173

• Defining Preventive Maintenance Tasks, page 1174
• Defining Preventive Maintenance Activities, page 1175
These definitions then serve as references for the actual maintenance procedures
carried out by the field maintenance personnel.

Performing Breakdown Maintenance

You create new work requests or repair forms from the Instrument Index module.
These procedures depend on the level of access rights granted to you (for details, see
Access Rights in the Maintenance Module, page 1166). Once a new work request or a
repair form has been created, it can only be accessed from the Maintenance module
Maintenance Activities Summary window. The maintenance supervisor can review
the work requests and use them to create repair forms. The repair form indicates the
work request number that was used to create it. The repair form also includes the
problem description. At this stage, it is also possible to indicate that calibration is
required. The supervisor then schedules this work for a certain date and assigns the
work group that will deal with it. The status of the job at that point is Scheduled.
After the maintenance work is carried out, the technician responsible for it can fill in
the rest of the repair information, and change its status to Done or close it. You can
customize additional statuses such as Hold, Turnaround, and so forth to cope with
situations and that comply with the conventions at your plant.
Note
• It is recommended to set the required quality system and criticality prior to
starting the Maintenance module.
The following is the recommended flow of activities for breakdown maintenance:
1. Start the Instrument Index module and open an Instrument Index Standard
Browser view.
2. Select the desired instruments (tag numbers) for which you want to enter work
requests and start the Calibration module.
3. If the instruments require calibration, enter the required calibration settings for the
selected tag numbers (for details, see Defining Calibration Settings, page 1203).
Caution
• Failure to define the calibration settings prior to starting the
Maintenance module results in the inability to enter the calibration
values when completing a Repair Form. (The Calibration As
Found/As Left dialog box will not be accessible.) Therefore, it is
essential that you enter the calibration settings for the selected tags
before you open Work Requests from the Instrument Index Standard
Browser view.

4. Go back to the Instrument Index Standard Browser view and right-click the
selected tags.
5. Associate the tag category and criticality as needed (for details, see ).
6. In the browser view, right-click the selected tags and on the Maintenance menu,
click the Repair Form or the Work Request Form option.
7. Enter the desired repair or work request values.
8. Start the Maintenance module to complete the entry of the required repair or work
request values.
Related Topics
• Creating Repair Forms, page 1187
• Filling Out Repair Forms, page 1188
• Opening a Work Request, page 1185

Defining Preventive Maintenance Attachments

This is the very first procedure that you have to carry out before you can schedule
preventive maintenance. An attachment is an external document that is provided to
the maintenance crew. An attachment can be a text document, a drawing, a sketch,
and so forth.
Here you define the preventive maintenance attachments, enter their descriptions and
associate them with an external file (a .doc file, a drawing, and so forth) that then
serves as a reference for the field maintenance personnel.
Define a Preventive Maintenance Attachment

2. In the Maintenance Activities Summary window, do one of the following:
• On the Tables menu, click Attachments.
• Click .
3. In the Attachments dialog box, click New to define a new attachment.
4. Click in the Name field and type the attachment name or code that will then serve
as a reference for the task.
5. In the Description field, type an appropriate description.
6. Click Browse to associate the current attachment with an external file which can
be a drawing, a text file, or a vendor's document, and so forth.
7. Click View to view the external file to make sure it is the correct one.
8. Click Save and then Close to return to the Maintenance Activities Summary
window.
Related Topics

Defining Preventive Maintenance Tasks

After defining the preventive maintenance attachments, you have to define the
appropriate maintenance tasks that will be carried out. The tasks are associated with
the attachments you have defined and then they will be included in the appropriate
maintenance activities.
Define a Preventive Maintenance Task

• Click Tables > Preventive Maintenance Tasks.
• Click .
3. In the Preventive Maintenance Tasks dialog box, click New to define a new
task.
4. Click in the Task field and type the new task name.
5. Click in the Attachment field and select the appropriate attachment with which
new task is to be associated.
6. Click in the Note field and type any note you deem fit for the current task.
window.
Related Topics

Defining Preventive Maintenance Activities

Defining the preventive maintenance activities is the last preliminary activity that you
have to carry out before you can start scheduling a PM job. You define the
preventive maintenance activities after defining the preventive maintenance tasks and
attachments. Each activity can hold a number of tasks which are in turn associated
with the defined attachments. You select the defined tasks in the sequence they are to
be performed. The defined activity also contains other default scheduling
information, such as the down/repair time, the interval and frequency for the current
PM activity, the required calibration values, and so forth.
Define a Preventive Maintenance Activity

• On the Tables menu, click Preventive Maintenance Activities.

3. In the Preventive Maintenance Activities dialog box, click New to define a new
activity.
4. Click in the PM code field and type a new preventive maintenance code for the
current activity.
5. Click in the Typical Instrument field and select the appropriate typical
instrument from the list. If the required option is not available, click Typical
Instrument.
6. Click in the Description field and type an appropriate description for the current
activity.
7. Click in the Note field and type any appropriate note if necessary. Use the
horizontal scroll bar to make the Note field visible.
8. In the Associated preventive maintenance tasks section, click Add to include a
task with the activity.
9. Click in the Task field and select the appropriate task from the list. You can
assign more than one task to the same activity. Click Add to add more tasks as
required. Note that each task must be unique. If the required task is not available,
click Tasks.
The software assigns the new task a sequence number. The appropriate
attachment is selected and it appears in the Attachment field.

10. Enter the default scheduling data as needed by selecting the appropriate
scheduling settings from the Default scheduling and Estimated maintenance
time sections.
Tip
• Selecting the Calibration Required check box enables you to enter
calibration values when filling out the Preventive Maintenance details.
This option becomes available in the Preventive Maintenance
Activity Details dialog box if you have defined the required
calibration settings for the current tag before you started the
Maintenance module.
window.
Related Topics

Scheduling Maintenance
Now that you have defined all your required maintenance attachments, tasks, and
activities, you can select a tag or a number of tags and schedule them for
maintenance. As the Maintenance module is closely connected with the Instrument
Index module, you schedule tag maintenance activities from an Instrument Index
Standard Browser view and then return to the Maintenance Activities Summary
window to continue your maintenance operations.
Schedule Maintenance
1. With the Maintenance Activities Summary window open, click on the Main
toolbar to start the Instrument Index module.
2. On the Actions menu, click Browse Index or click on the Instrument Index
module toolbar.
3. In the Instrument Index Standard Browser view, select the instrument for
which you want to schedule maintenance. You can select multiple tag numbers if
needed.
4. Right-click the selected tags to open a shortcut menu, point to Maintenance and
select Schedule Preventive Maintenance Activities.
5. From the PM code list, select the appropriate preventive maintenance code to
associate the selected instruments with the required PM code, or click .
6. From the Assigned workgroup list, select the work group to which the
preventive maintenance activity will be assigned. If the required work group is
not available in the list, click .
7. From the Priority list, select the required job priority.
8. Set the starting date, frequency, and the PM interval. By default, these values are
taken from PM definition.
9. In the Limit by section, select either the Date or the Number of PM Activities
option button to choose whether you want to set the number of times this PM
activity to be carried out or be limited by a time period.
10. In the Scheduling Options section, select how you want to fine-tune the
scheduling:
• No changes — the scheduling will remain as you defined it in the
Start date, Frequency, Interval, and Limit by options.
• Schedule jobs for— fine-tune the scheduling by selecting a specific
day of the week, for example every Tuesday of the month.
• Schedule jobs for each— fine-tune the scheduling by selecting a
specific day of the month, for example every 15th of the month.

11. Click Preview to display the scheduling in the Preview data window.
Tip
• You can also fine-tune the scheduling by editing the PM dates in the
Preview data window. Click on the required PM date and modify the
date as needed. All the changes will be implemented after you click
Generate.
12. Click Generate and then click Close.
13. Go back to the Maintenance Activities Summary window by selecting it from
the Window menu.
14. In the Maintenance Activities Summary window, click to display the new
PM records that you have just scheduled for selected instruments.
Related Topics
• Entering Preventive Maintenance Details, page 1180
• Extending Existing Scheduling, page 1179

Extending Existing Scheduling

This option allows you to extend the existing scheduling of maintenance for a
selected tag.
Extend the Existing Scheduling of Maintenance

2. In the Maintenance Activities Summary window, filter the records as needed.
3. Highlight the required row in the Preventive Maintenance data window and do
• On the Actions menu, click Extend.
• Click .
4. In the Extend Scheduling dialog box, do the following:
a. In the Take scheduling data from group box, select one of the following:
• Last preventive maintenance activity— fetch the scheduling
data from the last PM activity.
• Preventive maintenance code defaults— fetch the scheduling
data from the PM codes.
b. In the Limit scheduling by group box, select one of the following:
• Date— Sets the scheduling limited by date. Use the spinner to set
the required date.
• Number of activities— Sets the scheduling limited by the number
of activities. Enter the number of activities in the field provided.
5. Click Generate.
6. Click Close after the record generation is complete.
Related Topics
• Scheduling Maintenance, page 1177

Entering Preventive Maintenance Details

Once preventive maintenance has been scheduled, the repair technician can enter the
PM details and create a work request if that activity has failed. The technician can
indicate the starting and the completion dates, the service and the down time, enter
the maintenance results, failure reason if needed, and the repair action. Note that if a
value is not available in any of the lists in the Work Activity Details window, you
can access the required supporting table on the Tables menu.
Enter Preventive Maintenance Details

2. In the Maintenance Activities Summary window, filter the records that you
want to display.
3. Highlight the required row in the Preventive Maintenance pane and do one of
the following:
• On the Actions menu, click Open.
• Click .
4. In the Work Activity Details window, from the Work Status list, select the
required work status if you need change the displayed one.
Tip
• The following parameters in this window are not accessible to the
repair technician and can be modified only by the maintenance
supervisor:
• PM code
• Priority
• Created by
• Creation Date
• Last preventive maintenance
• Interval
• Frequency.
5. Assign the required work group by selecting the required option from the
Maintenance staff (scheduled) list.
6. Modify the automatically generated work order number if required.
7. Modify the scheduled date if needed.
8. Enter the start and completion dates, service, and down time.

9. From the Maintenance staff (actual) list, select the repair technician.
10. Select the required PM result from the Results list.
11. If the maintenance result is Failed, select the failure reason and repair action.
Tip
• The Failure reason and Repair action lists are available only if the
maintenance result is Failed.
12. Type any additional notes you might require in the Note data window.
13. Select the Calibration Required check box and click to open the Calibration
Data Entry window where you enter the required calibration values. Note that
the Calibration Data Entry window is accessible only if you have entered
appropriate calibration settings for the selected instrument before entering PM
activity details.
14. To change the work status, select the required option from the Work status list.
15. Click and create a work request if needed.
16. Click Yes when prompted for SmartPlant Instrumentation to create a work request
automatically.
Tip
• SmartPlant Instrumentation prompts you to create a work request
when a maintenance activity fails. This happens when you select
Failed from the Results list in the Work Activity Details window.
17. Click Close in the Work Activity Details window to return to the Maintenance
Activities Summary window.
Related Topics

Performing Preventive Maintenance

Before scheduling new preventive maintenance (PM) activities, you have to predefine
preventive maintenance attachments, tasks, and activities.
Scheduling new preventive maintenance work orders is done only from the
Instrument Index module (unless you are extending an already assigned PM job).
Once a PM work order has been scheduled, you open the Maintenance Activities
Summary window for further handling of these activities where you fill in the
maintenance details or reports.
To define the raw PM activities, tasks and attachments, you need to access the
Maintenance module and start to define the tasks from the lowest level – the
àttachment'. An àttachment' describes a set of instructions to the technical staff. An
attachment can be associated with any external document (a `Word' file, a scanned
image, or manufacturer maintenance document). Typical attachments define safety
precaution instructions, technical instructions for bypassing a process, the actual set
of instructions required to carry out the activity itself, restoring the process back to its
operational status, and so forth.
A task is a set of instructions associated with an attachment. You can associate a

single attachment with multiple PM activities. A task can include the attachment and
a description.
Once you define the attachments and tasks, you can introduce a new PM activity.
Each PM activity can hold several tasks in the sequence they were added. At this
stage, it is also advisable to associate a PM code with a particular typical instrument
(for example, transmitter, transducer, control valve, switch, and so forth.) This is very
useful for report generation and other statistics. Moreover, a PM activity contains
additional default information, such as the required calibration values, the
down/repair time that an average maintenance job will take, the interval and
frequency for each PM job.
Once all the required attachments, tasks, and activities have been defined, the
preventive maintenance supervisor can schedule these activities to the selected tags
from an Instrument Index Standard Browser view. At this stage, the PM activities are
ready to be further processed and be filled in by the maintenance crew in due time.

The following is the recommended flow of activities for preventive maintenance:

1. Start the Maintenance module and define the raw PM activities, tasks, and
attachments.
2. Start the Instrument Index module and open an Instrument Index Standard
Browser view.
3. Select the required tag numbers for which you want to schedule a PM job and
start the Calibration module.
4. If the instrument requires calibration, enter the appropriate calibration settings for
the selected tags.
Caution
• Failure to define the calibration settings prior to starting the
Maintenance module result in the inability to enter the calibration
values when entering preventive maintenance details. (The
Calibration As Found/As Left dialog box will not be accessible.)
Therefore, it is essential that you enter the calibration settings for the
selected tags before you schedule a PM job from the browser view.
5. Go back to the Instrument Index Standard Browser view and right-click the
selected tags.
6. Associate the tag category and criticality as needed (for details, see ).
7. On the shortcut menu, click Maintenance > Schedule Preventive Maintenance
Activities.
8. Create the new schedule for the PM activity.
9. Start the Maintenance module and fill out the PM activity details as desired.
10. At this stage, you can also issue work requests and open repair forms for the
required instrument if needed.
Tip
• When saving PM activity details, SmartPlant Instrumentation prompts
you to create a work request if the result of the PM activity is Failed.
Clicking Yes creates the Preventive Maintenance record and opens the
Work Request dialog box where you can create a repair form.
Related Topics
• Preventive Maintenance Preliminary Activities, page 1170

Issuing a New Work Request

You can issue new work requests only from the Instrument Index Standard Browser
view or from the Work Activity Details window if the activity result was Failed.
This option is on the lowest access rights level and there are no restrictions on its
access. Note that some options are not available (for details, see Access Rights in the
Maintenance Module, page 1166).
Issue a New Work Request

2. Select the required tag number for which you want to issue a work request.
Caution
• Do not select multiple tag numbers in the browser view. This option is
available for single instruments only.
3. Right-click the selected tag to open a shortcut menu. Point to Maintenance and
click Create Work Request.
4. In the Create Work Request dialog box, modify the work request number if
needed – the software fills in the values automatically.
5. Select the Typical Instrument and the Work Request Reason from the lists.
6. Type the required work request title.
7. Type the appropriate problem description if needed.
8. Click Save and then Close to return to the browser view.
Tip
• You cannot generate a repair form in this case.
Related Topics

Opening a Work Request

You can open work requests from an Instrument Index Standard Browser view or
from the Maintenance Activities Summary window. However, you can issue new
work requests only from the Instrument Index Standard Browser view or from the
Work Activity Details window if the activity result was Failed. It is recommended
that you create a new work request from the browser view and then open this new
work request record in the Maintenance Activities Summary window. Due to the
access rights restrictions, some of the work request features are disabled if accessed
from the browser view.
If you have been granted full access rights and you are the maintenance supervisor,
you can first issue a new work request in the Instrument Index Standard Browser
view and then open it in the Maintenance Activities Summary window. This
enables you to create a repair form. Repair form creation is not available when
issuing a new work request, which is only possible from the Maintenance Activities
Summary window. It is not possible to create a repair form from the work request
because all work requests have to be reviewed by the supervisor.
When you issue or open a work request, SmartPlant Instrumentation automatically

assigns this record a work request number that you can modify if needed.
Open an Existing Work Request

2. In the Work requests pane, select the required records and click .
Tip
• All work requests have the WR notation preceding the work request
number.
3. In the Work Request window, modify the work request number and title if
needed these are filled in automatically by SmartPlant Instrumentation. If you
leave the Word request title field blank, the software fills it after you select a
typical instrument and a work request reason.
4. Modify or select the typical instrument and the work request reason from the lists.
If the required option is not on the list, on the Tables menu, click Typical
Instruments or Work Request Reasons as needed.
5. Type the appropriate problem description if needed.

6. To generate a repair form, on the Actions menu, click Repair Form.

Tips
• This option is not available if you opened the Work Request dialog
box from an Instrument Index Standard Browser view.
Tip
• This option is accessible only if you have been granted the appropriate
access rights (for details, see Access Rights in the Maintenance
Module, page 1166).
window.
Related Topics
• Issuing a New Work Request, page 1184

Creating Repair Forms

You can issue a new repair form from an Instrument Index Standard Browser view.
This can be done by a repair supervisor with appropriate access rights (for details, see
Access Rights in the Maintenance Module, page 1166). Note that the repair options
are not available at this stage. Subsequently, you can open this repair form from the
Maintenance Activities Summary window where you can fill out the repair options.
Also, it is possible to create a new repair form from the Work Request window when
opening a work request from the Maintenance Activities Summary window. You
can then open the newly created repair form from the Maintenance Activities
Summary window.
Create a New Repair Form

2. Select the required tag number for which you want to issue a work request.
3. Right-click the selected tag to open a shortcut menu. Point to Maintenance and
click Repair Form.
4. In the Repair (scheduled) group box of the Repair Form window, modify the
scheduled date and the work order number if necessary.
Tip
• The Repair (actual) options are not available at this stage. The
Repair options contain the actual work order information.
5. Select a work request reason from the list. If the required option is not available
in the list, click the required option on the Tables menu.
6. Type the work request title and the problem description.
7. Set the repair priority by selecting the required option from the Priority list.
8. From the Maintenance staff (scheduled) list, select the appropriate work group
from the list or accept the displayed one. If the required option is not available,
click the required option on the Tables menu.
window.
In due time, a repair technician can open this repair form from the Maintenance
Activities Summary window and fill out the information under Repair (actual).
Note
• A repair form that you create from a work request retains WR
identification number.

Filling Out Repair Forms

The following procedure describes how to fill out a repair form.
Note
• To add entries to supporting tables that you need below, on the Tables
menu, click the relevant menu command.
Fill Out a Repair Form

2. In the Repairs pane, select the required records and click .
3. In the Repair (scheduled) group box of the Repair Form window, do the
following:
a. Update the work status from the Work Status list.
b. Modify other values as needed.
4. In the Repair (actual) group box, set the start and completion dates.
5. Set the down and repair time.
6. To perform calibration, do the following:
a. Select the Calibration required check box.
b. On the Actions menu, click Calibration.
c. Follow the calibration flow of activities (for details, see Calibration Flow of
Activities, page 1195).
7. From the Maintenance staff (actual) list, select the person who is assigned to
carry out the repair.
8. From the Failure reason list, select the failure reason of the instrument
9. From the Outcome list, select the required item that describes the effect of the
current failure, for example partial or complete unit shutdown, and so forth.
10. From the Repair Action list, select the value that describes what action has been
taken to repair the failure.
11. In the Comments data window, type a brief comment if needed.
12. When done, click Save and then Close to return to the Maintenance Activities
Summary window.
Related Topics
• Issuing a New Work Request, page 1184

Maintenance Event Records: An Overview

For an instrument existing in As-Built or in an Engineering company domain it is
possible to create records of repairs, tests, inspections, calibrations, and so forth.
These records are called maintenance event records. It is possible to associate several
maintenance event records with a particular instrument, provided that this instrument
belongs to one of the following tag classes: Conventional, Fieldbus, HART, or
Profibus. A user with full Calib. & Maint. Events access rights can create
maintenance event records. After a record is created, it is considered active until a
supervisor user with. full Calib. & Maint. Event Supervisor rights marks the record as
complete. Completed records are automatically saved to the database. Only a
supervisor can delete completed maintenance event records.
Maintenance event record creation and management is performed in the Domain

Explorer. In the Domain Explorer, all maintenance event records appear under
instruments, in the Maintenance Events folder. Active records are indicated with the
icon . Completed records are indicated with the icon
When creating a record, the software specifies a name for the record automatically,
according to the preferences that you set on the Preferences dialog box. The
maximum length of the record name can be sixty characters. Before a record is
complete, a user with full Calib. & Maint. Events access rights can update the record
name by changing the event date.
When creating a maintenance event record, you must select a form whose process
function is the same as the process function of the source instrument. You need to
familiarize yourself with various options of the Specifications module to be able to
define and manage forms compatible with maintenance event records. There is one
shipped form designed for displaying maintenance event records for level
instruments: Displacer Level Switch (form number 93). You need to restore this form
first. This form page contains non-editable fields from the Component table. When
regenerating a page for such a form, you can add editable fields from the
Work_Activity table, and also add non-editable fields from the Calibration_Setting,
Component, PD_General, and Spec_Sheet_Data tables. If you want to create
maintenance event records for instruments whose process function is other than
Level, you need to use the Change Process Function options of the Page Editor.
A page on which you base maintenance event records does not have a title block and,
therefore, does not contain any revision data or document number. You cannot use
comparison options with maintenance event records. You can create, open and
complete one record at a time. It is possible to open and print out several completed
records at a time.
Related Topics
• Flow of Activities for Defining and Managing Maintenance Event
Records, page 1190

Flow of Activities for Defining and Managing

Maintenance Event Records
This topic describes the flow of activities for defining and managing maintenance
event records in SmartPlant Instrumentation.
1. Grant Access Rights for Opening and Completing Maintenance Event

Records
The Domain Administrator needs to define access rights for users working with
maintenance event records in As-Built or in an Engineering company domain. These
access rights allow a regular user to create maintenance event records and update the
record names. Such a user must have full Calib. & Maint. Events access rights. After
a record is created, it is considered active until a supervisor user marks this record as
complete. A supervisor user can delete the record if it becomes obsolete. Such a user
must have full Calib. & Maint. Event Supervisor access rights. Before granting
access rights, the Domain Administrator needs to assign these users to different user
groups because access rights in SmartPlant Instrumentation are granted per group.
For details about access rights, see the Administration module Help, Access Rights
Common Tasks in the Administration Module User's Guide, Domain and Project
Administration, Access Rights.
2. Set a Date Format for Maintenance Event Record Names

Use this procedure to set a date format that the software applies to names of
maintenance event records when you create such records in the Domain Explorer.
This procedure can be only be performed by a user that have rights to set or modify
preference settings of SmartPlant Instrumentation. For details, see Set a Date Format
for Maintenance Event Record Names, page 1191.
3. Create a Maintenance Event Record

Use this procedure to create a maintenance event record. This procedure can only be
performed by a user with full Calib. & Maint. Event Supervisor access rights. For
details, see Create a Maintenance Event Record, page 1192.
4. Complete a Maintenance Event Record

Use this procedure to mark a maintenance event record as completed. This procedure
can only be performed by a user with full Calib. & Maint. Events access rights. For
details, see Complete a Maintenance Event Record, page 1193.
Related Topics

Set a Date Format for Maintenance Event Record Names

2. In the tree view, click Calibration and Maintenance > General.
3. In the Maintenance event date format box, enter a valid date format using one
of the following examples:
4.
Date Format Example
mm-dd-yy 01-30-07
mm-dd-yyyy 01-30-2007
dd-mm-yy 30-30-07
dd-mm-yyyy 30-30-2007
d-mmm-yy 30-Jan-07
mmm-yy Jan-07
Tips
• SmartPlant Instrumentation only support date formats that are listed in
this table.
• You can use one of the following characters as separators: dash (-),
slash (/), space, comma, semicolon, colon, or dot.
Related Topics
Records, page 1190

Create a Maintenance Event Record

instrument level in the Instruments folder.
2. Click an instrument for which you want to create a maintenance event record.
Tip
• The instrument that you select must belong to one of the following
classes: Conventional, Fieldbus, HART, or Profibus.
3. Right-click the Maintenance Events folder and on the shortcut menu click New
> Maintenance Event Record.
Tip
• You can create one maintenance event record at a time.
4. Under Maintenance event date, define the date of the event.
Tip
• When you define the date, the software automatically displays the
record name in the Record name box, according to the preferences
you set.
5. In the Maintenance event description box, type and optional description.
Tip
• The description does not appear automatically on the record sheet. To
display the description on the record sheet, you need to regenerate the
form page on which the record is based and add the wa_prob_desc
field in the page.
6. Under Form number, select a form whose process function is the same as the
process function of the source instrument.
7. Click OK to create the record and display it in the Maintenance Events folder
with the icon .
Related Topics
Records, page 1190

Complete a Maintenance Event Record

instrument level in the Instruments folder.
2. Click an instrument containing active maintenance event records, which are
indicated with the icon .
3. Click the Maintenance Events folder to display the existing records.
4. Right-click a specific record and then, on the shortcut menu, click Actions >
Open Document.
5. On the Maintenance Event Record window menu bar, click Actions > Mark as
Complete.
Tips
• In the Domain Explorer, completed records are indicated with the
icon .
• After a record is marked as completed, you cannot update any settings
for the record, only open a record print preview or delete the record.
• To delete obsolete records, right-click one or more records in the
Domain Explorer and then, on the shortcut menu, click Delete.
Alternatively, click Properties and then delete the selected records
one by one from the Maintenance Event Properties dialog box. All
records in your selection must be either active or completed.
Related Topics
Records, page 1190

Calibration Module
Calibration Module
The Calibration module allows you to keep track of the calibrations made to the
instruments in your plant. This way you can monitor the calibration history of each
instrument and compare it with new calibration values.
You can specify a large variety of calibration parameters such as calibration ranges,
trip point values, and alarms. You can also keep a history record of tag calibration
values. The calibration user interface allows you to easily compare current measured
values with the appropriate specifications. This interface also enables you to
simultaneously maintain the calibration data of a group of selected tags.
You can also calculate the error of tags in a given loop.
Note
• The Calibration module is available only if it is included in the software
Related Topics
• Calibration Flow of Activities, page 1195

Calibration Module
Calibration Flow of Activities

The flow of activities is as follows:
Defining Calibration Settings, page 1203

The first step in creating the tag calibration history is to define calibration settings,
which determine the calibration points for the selected instrument tags.
Entering Calibration Data, page 1214

Having specified the calibration settings, you can enter calibration data — the
parameter values before the calibration (As Found) and after the calibration (As Left).
Maintaining Calibration History, page 1224

The calibration history options allows you to browse through the calibration entry list
of a selected tag. This option also allows you to view the selected calibration entry
data, modify it, or add a new calibration entry for the selected tag.
Generating Calibration Reports, page 1227

You can view and print out reports of calibration settings, calibration data, and
calibration history.

Calibration Module
Starting the Calibration Module
Start the Calibration Module

• Click Modules > Calibration or on the Main toolbar, click .
• Open an Instrument Index Standard Browser view, select the tag
numbers that require calibration, and do one of the following:
• Click Modules > Calibration.

Calibration Module
Accessing Calibration Windows

When you start the Calibration module, you can access the following calibration
windows:
• Calibration Settings
• Calibration Data Entry
• Calibration History
You can also open the Calibration Reports dialog box for defining filter conditions
when generating a calibration report.
Access a Calibration Window

1. Start the Calibration module and do one of the following:
• On the Calibration toolbar, click the appropriate icon.
• On the Actions menu, select the desired option.
2. On the Enter Tag Number dialog box, type the tag number of the desired
instrument or click Find to search for specific instrument tags.
Related Topics
• Defining Calibration Settings, page 1203
• Entering Calibration Data, page 1214
• Maintaining Calibration History, page 1224

Calibration Module
Searching for Tag Numbers in the Calibration

Module
This option enables you to find tag numbers in the Calibration module using search
parameters in the Find Tag dialog box. Entering search parameters enables you to
narrow down your search. You can narrow your search to the maximum by entering
all the search parameters. It is up to you what search parameters to specify. You can
use wildcards in the fields where you type values: underscore ( _ ) for single
characters, and percent ( % ) for multiple characters.
Leaving some of the search parameter fields empty widens the search. If you do not
specify any search parameters, the software finds all the existing tag numbers.
After the search is complete, the software displays the tag numbers that match your
search parameters in the Search results data window of the Find Tag dialog box.
Note
• The following procedure describes how to find tags using search
parameters. If needed, you can also find tag numbers without defining any
search parameters.

Calibration Module
Search For Tag Numbers In The Calibration Module

1. With the Calibration Module window open, do one of the following:
• On the Actions menu, do one of the following:
• Click Settings to find the required tag numbers and display them
in the Calibration Settings window.
• Click Data Entry to find the required tag numbers and display
them in the Calibration Data Entry window.
• Click History to find the required tag numbers and display them in
the Calibration History window.
• On the Calibration module toolbar, click , , or .
2. On the Enter Tag Number dialog box, click Find.
3. If needed, select Search by category to find only tag numbers that you have
associated with tag categories in the Instrument Index module (for details, see ).
Tips
• Search tag numbers by category if you have created user-defined tag
categories and associated tag numbers with these categories. You can
also type a category in the Category field to narrow your search to
tags associated with this category only. Use wildcards and not case-
insensitive characters if needed.
• When searching for tag numbers by tag category, you can narrow
down your search by typing a specific tag category or loop name, or by
selecting the required instrument type and process function. Note that
you cannot use certain search parameters together with the tag
category parameter. These fields become view-only.

Calibration Module
4. Define you search criteria using the required combination of the following search
parameters:
Parameter
Tag number Type the whole tag number you are looking 101-FT – 2225/1 or
for. Include any prefix, suffix, and separator use a wildcard: 101-
characters. You can use wildcards if needed. FT%
Process Select a process function to narrow your Flow Pressure
function search to tags belonging to this process
function.
Instrument Select an instrument type to narrow your D/P Type Flow
type search to tags belonging to this instrument Element (FE), Mass
type. Flow Transmitter
(FT)
Status Select a tag status to narrow your search to An existing device, a
tags associated with this status. new instrument, a
relocated device
Location Select a tag location, for example: Field, to Equipment room,
narrow your search to tags for which you have junction box
defined this location.
I/O Type Select an I/O type to narrow your search to AO (analog output)
tags for which you have defined this I/O type. DI (Digital input)
Prefix Type the tag number prefix to find all the tag 101
numbers that contain this prefix in their names.
Do not include the separator characters. The
unit number segment in the tag number name
is usually the tag number prefix. You can also
use wildcards if needed.
Number Type the numeric segment of a tag number to 2315
find all the tag numbers that contain this
numeric segment. You can also use wildcards
if needed.
Suffix Type the suffix segment of the tag number to 1 ( the number
find all the tags that contain this suffix. Do not following the slash
type the slash character before the suffix. You (/) in tag number
can also use wildcards if needed. 101-FT – 2225/1)
Equipment Select the equipment to narrow your search to
tags for which you have defined this
equipment.
Line Select a line to narrow your search to tags with
which you have associated this line.

Calibration Module
5. If desired, select Look in all units to look for the defined search criteria in all the
units of the current plant.
6. Click Find to display the tag numbers in the Search results data window.
Tip
criteria fields and enlarge the Search results data window to display
more tag rows. Clear this check box to return to normal view.
7. Select the required tag numbers in the Search results data window.
Tip
• You can also select the Select all check box to select all the displayed
tag numbers.
8. Click OK to open the appropriate window (Calibration Settings, Calibration
Data Entry, or Calibration History) and proceed with the Calibration module
activities.

Calibration Module
Copying Existing Process Data

If you are defining calibration settings for a tag number associated with process data,
you can copy existing maximum and minimum process data range values into the
Variable Min and Variable Max fields in the Ranges section; you can also copy
existing alarm and trip data into the appropriate Alarms / Trips section.
Copy Existing Process Data

1. Open the desired instrument tag in the Calibration Settings window.
Tip
• It is not possible to copy process data for control valves.
2. Click Options > Copy Process Data.
3. On the Copy Process Data dialog box, click OK.
Tips
• You can edit the data in the Process Data module only.
• The copied data overwrites your previous settings in the Calibration
Settings window.
Notes
• If you defined multiple process data cases for the current tag, the data
displayed in the Process Data pop-up window is determined by the
governing case. For details, see Multiple Process Data Cases, page 1260.
• The software copies the Min and Max values beside Required range to
the Variable minimum and Variable maximum fields in the Ranges
section as well as the alarm and trip data in the calibration settings Alarm
/ Trips section.
Related Topics
• Defining Alarm / Trip Settings, page 1205
• Defining General Calibration Settings, page 1204
• Defining the Set Point, page 1206

Calibration Module
Defining Calibration Settings

The calibration settings for an instrument tag are the prerequisite of the calibration
procedure. They serve as a reference for the calibrations performed on the selected
tag. If settings already exist for an instrument tag, you can modify them. You enter
parameter values such as range, alarm settings, and trip point settings. These values
will later serve as reference values for any calibrations you will perform on the device
associated with that tag.
Define Calibration Settings

1. Start the Calibration module.
• Click Actions > Settings.
• Click .
3. On the Enter Tag Number dialog box, type the desired tag number or click Find
to search instrument tags.
Tip
• If you selected multiple tag numbers, click (on the Actions menu,
click List Tags) and then click a tag number to define the settings for
that instrument.
4. Define the general calibration settings.
5. Define the alarm / trip settings.
6. Define the set point.
7. Click Save to save the settings.
Related Topics
• Copying Existing Process Data, page 1202

Calibration Module
Defining General Calibration Settings

General calibration settings include the instrument calibration ranges, errors/points
settings, custom settings, and the display scale definition.
Define General Calibration Settings

• Click .
3. In the Calibration Settings window, click the General Settings tab and enter
values in each section by typing or selecting from the lists.
Tips
• If you are defining calibration settings for a tag number associated
with process data, you can copy existing process data minimum and
maximum range values (for details, see Copying Existing Process
Data, page 1202).
• The Measuring Point parameter is available for calibration types that
require a single calibration point only.
• The fields in the Set values group box are available only if under
Error calculation type you selected Switch set point.
4. To define custom fields, click the Custom Fields tab.
Tips
• The Domain Administrator can enable or disable the use of custom
fields in the Calibration module.
• The custom fields in the Calibration Settings window are
independent of the custom fields in the Calibration Data Entry
window.
5. When done, click Save .
Tip
• You are now ready to define the alarm / trip settings for the current tag
number.
Related Topics
• Clearing the Calibration Ranges, page 1207

Calibration Module
Defining Alarm / Trip Settings

You enter the required alarm / trip settings in the appropriate Point data window.
You can specify up to six trip or alarm indication points. For each point, you select a
unit of measure, enter the point values and direction, and type a brief description.
Define the Alarm / Trip Settings

• Click .
3. In the Calibration Settings window, click the General Settings tab and scroll to
the Alarm / Trips section.
4. In the First Point region, type the desired values or select them from the lists.
When done, define other calibration points as needed.
Tip
• If you are defining calibration settings for a tag number associated
with process data, you can copy existing process data minimum and
maximum range values (for details, see Copying Existing Process
Data, page 1202).
5. Click Save to save all your calibration settings.
Related Topics

Calibration Module
Defining the Set Point

After defining the alarm and trip settings, you can also define the set point of the
selected instrument. You can either define the set point to be identical to one of the
alarm / trip points that you have already defined, or you can define the set point
manually.
Define the Set Point

1. Open the desired instrument tag in the Calibration Settings window.
2. In the Set Point section, from the Point list, select one of the following:
• 1st Point, 2nd Point, 3rd Point, and so forth (any defined calibration
point up to the 6th point): The set point will be identical to the selected
alarm/trip point and the rest of the fields in this data window become
unavailable. Note that this option is possible only after making your
alarm/trip definitions.
• Free: You can define the set point yourself.
• None: You can make no set point definitions.
3. Type the rest of the values as desired or select them from the lists.
4. Click Save to save all your calibration settings.
Related Topics

Calibration Module
Clearing the Calibration Ranges

This option is useful if you discontinue calibration of an instrument or if you need to
clear the values of the input ranges. Note that this option does not clear the output
signal values.
Clear the Calibration Ranges

1. In the Calibration Settings window, click Options > Clear Calibration Settings
.
2. When prompted to confirm the deletion, click Yes.

Calibration Module
Managing Action Codes

An action code is a code associated with a description of a solution of a calibration
failure. You can customize your own action codes that will become available for
selection on the Data Entry tab from the Action code list in the Codes section.
Manage Action Codes

1. In the Calibration Data Entry window, click Tables > Action Codes.
2. On the Action Codes dialog box, do one of the following:
• Click New to add a new value.
• Highlight an existing action code.
Tip
• If you have a large number of result code values, and you want to find
one of them quickly, in the Find an action code box, start typing an
action code string. The software finds and highlights the matching
row in the data window as you type.
3. Type the desired action code and its description in the appropriate columns.
Tip
• You can permanently delete a customized action code by highlighting
a row and clicking Delete. The software subsequently removes the
deleted action code from the Action code list in the Codes section.
4. Click OK to accept the values and close the dialog box.
Related Topics
• Deleting a Calibration Result Entry, page 1225
• Managing Diagnostic Codes, page 1210
• Managing Result Codes, page 1211
• Viewing and Modifying Calibration Results, page 1226

Calibration Module
Managing Damage Codes

A damage code is a code associated with a description of a calibration failure. You
can customize your own damage codes that will become available for selection from
the Diagnostic code list in the Codes section.
Manage Damage Codes

1. In the Calibration Data Entry window, click Tables > Damage Codes.
2. On the Damage Codes dialog box, do one of the following:
• Highlight an existing damage code.
Tip
• If you have a large number of damage code values, and you want to
find one of them quickly, in the Find a damage code box, start typing
a damage code string. The software finds and highlights the matching
row in the data window as you type.
3. Type the desired damage code and its description in the appropriate columns.
Tip
• You can permanently delete a customized damage code by
highlighting a row and clicking Delete. The software subsequently
removes the deleted damage code from the Diagnostic code list in the
Codes section.
Related Topics
• Managing Action Codes, page 1208

Calibration Module
Managing Diagnostic Codes

A diagnostic code is a code associated with a description of a calibration failure
cause. You can customize your own diagnostic codes that will become available for
selection from the Diagnostic code list in the Codes section.
Manage Diagnostic Codes

1. In the Calibration Data Entry window, click Tables > Diagnostic Codes.
2. On the Diagnostic Codes dialog box, do one of the following:
• Highlight an existing diagnostic code.
Tip
• If you have a large number of diagnostic code values, and you want to
find one of them quickly, in the Find a diagnostic code box, start
typing a diagnostic code string. The software finds and highlights the
matching row in the data window as you type.
3. Type the desired diagnostic code and its description in the appropriate columns.
Tip
• You can permanently delete a customized diagnostic code by
highlighting a row and clicking Delete. The software subsequently
removes the deleted diagnostic code from the Diagnostic code list in
the Codes section.
Related Topics
• Managing Damage Codes, page 1209

Calibration Module
Managing Result Codes

A result code is a code associated with a description of a calibration result.
SmartPlant Instrumentation provides three predefined standard result codes Passed,
Failed, and None. You can customize your own result codes in addition to the
standard ones if required. The customized result codes will then become available for
selection on the Data Entry tab from the Result code list in the Codes section.
Note
• The standard result codes Passed, Failed, and None cannot be edited or
deleted and, therefore, do not appear in the Result Codes dialog box.
Manage Result Codes

1. In the Calibration Data Entry window, click Tables > Result Codes.
2. On the Result Codes dialog box, do one of the following:
• Highlight an existing result code.
Tip
• If you have a large number of result code values, and you want to find
one of them quickly, in the Find a result code box, start typing a
result code string. The software finds and highlights the matching row
in the data window as you type.
3. Type the desired result code and its description in the appropriate columns.
Tip
• You can permanently delete a customized result code by highlighting a
row and clicking Delete. The software subsequently removes the
deleted result code from the Result code list in the Codes section.
Related Topics
• Managing Diagnostic Codes, page 1210

Calibration Module
Managing Test Equipment Data

Use this option to define, edit, and delete your test equipment data. Test equipment is
equipment you use for calibrating and recalibrating instrument tags.
After you define your test equipment, it becomes available in the Test Equipment
data window, where you can select the equipment used for calibration of a particular
instrument tag.
Then, in the Calibration History window, you can track the calibration history
results for the tag that has been calibrated using this equipment and view detailed
information of test equipment history data for each calibration record. This
information is retrieved from the Test Equipment supporting table.
Manage Test Equipment Data

1. In the Calibration Data Entry window, click Tables > Test Equipment.
2. On the Test Equipment dialog box, do one of the following:
• Highlight an existing test equipment value.
Tip
• If you have a large number of test equipment values, and you want to
find one of them quickly, in the Find a test equipment box, start
typing a string for the test equipment name. The software finds and
highlights the matching row in the data window as you type.

Calibration Module
3. In the appropriate columns, type the following:

a. Type the required equipment name, description and serial number in the
appropriate fields.
b. In the Test Date field, select or type the date of testing this equipment.
c. In the Tested By field, type the name of the employee who tested this
equipment.
d. In the Accuracy field, type the accuracy of this equipment, and from the
UOM field, select the accuracy unit of measure.
Tip
• You can permanently delete an item of test equipment by highlighting
a row and clicking Delete. The software subsequently removes the
deleted test equipment from the lists in the Test equipment section.
Caution
• After you delete a record, it is permanently deleted from the Test
Equipment supporting table and will no longer be available in the Test
Equipment data window lists.
4. Click OK to save the settings and close the dialog box.
Related Topics
• Selecting Test Equipment, page 1216

Calibration Module
Entering Calibration Data

This is the second stage in building a tag's calibration history. When you record the
calibration results, you add a new calibration result entry to the tag's calibration
history.
You can record the calibration results for a selected tag only after you have defined
that tag's calibration settings.
Note
• You can specify that the software validates mandatory data values and
displays warning messages if any values are missing. To activate this
feature, on the Preferences dialog box, click Calibration and
Maintenance > Custom, and enter the value:
ActivateMandatoryFields = 1
Enter Calibration Data

1. In the Calibration Settings window, do one of the following:
• Click Actions > Data Entry.
• Finish entering the tag's calibration settings and click Save . You
are prompted to open the Calibration Data Entry window for the
current tag.
2. In the Calibration Data Entry window, on the module toolbar, click Refresh
.
3. Click the Data Entry tab and enter values in each section by typing or selecting
from the lists.
4. Do the following for each of the points that you defined for the current tag in the
Calibration Settings window:
a. In the Calibration Data Entry window, in the Alarms / Trips section, click
First Point, Second Point, Third Point, Fourth Point, Fifth Point, or Sixth
Point.
b. Under As Found, type the value before calibration.
c. Under As left, type the value after calibration.
d. In the Codes section, enter general calibration information as you require.
e. From the Result Code list, select the desired standard result code, or custom
result code predefined in the Result Code dialog box.

Calibration Module
f. If from the Result code list you selected Failed or any other option that
indicates a calibration result failure, from the Diagnostic code list, select a
calibration diagnostic code for this kind of failure.
g. If from the Result code list you selected Failed or any other option that
indicates a calibration result failure, from the Action code list, select an action
code associated with a solution description for this kind of failure.
h. If from the Result code list you selected Failed or any other option that
indicates a calibration result failure, from the Damage code list, select a
damage code associated with a solution description for this kind of failure.
Tip
•If a desired Result, Diagnostic, Damage, or Action code is not
available from the list, you can define additional codes by selecting
the appropriate item on the Options menu.
i. Enter additional values, and a short note if needed.
5. Click the Result Points tab and type the pre-calibration values in the As Found
column.
Tips
• Values highlighted in red exceed the permissible error.
• Values highlighted in light blue exceed the intermediate error
tolerances, but do not exceed the permissible error.
6. After calibration of the instrument, type the values in the As Left column.
Tips
• Any As Found or As Left values still highlighted in red show that this
instrument's calibration failed. When you save the updated data, the
software prompts you to create a Work Request (Performing
Breakdown Maintenance, page 1171).
• To enter data for custom fields, click the Custom tab.
• The Domain Administrator can enable or disable the use of custom
fields. Note that the custom fields in the Calibration Settings
window are independent of the custom fields in the Calibration Data
Entry window.
7. Click Save .
8. To browse through the tags that you selected, click or .
Related Topics
• Calibration Error Calculations, page 1219
• Managing Test Equipment Data, page 1212

Calibration Module
Selecting Test Equipment

Test equipment is equipment you use for calibrating and recalibrating instrument tags.
Selecting test equipment enables you to view its detailed information in the
Calibration History window. You will be able to see this information when viewing
calibration history results for this instrument tag. Selecting test equipment also
allows including test equipment detailed information in the Instrument Calibration
Results report.
For the current instrument tag, you are allowed to select the same equipment up to
four times (you may need to do so when using the same equipment for different
calibration purposes). Then, in the Calibration History window, you can see
detailed information about the test equipment that has been used for each calibration
entry. This information is retrieved from the Test Equipment supporting table.
Note
• If the Test Equipment lists contain no data, you can customize test
equipment data in the Test Equipment dialog box. (for details, see
Managing Test Equipment Data, page 1212).
Select Test Equipment

2. In the Calibration Data Entry window, in the Test equipment section, select the
required predefined test equipment from the First test equipment, Second test
equipment, Third test equipment, and Fourth test equipment lists.
Tip
• The data in all the lists is identical. Therefore, if you have used the
same test equipment for calibrating the current tag, you can select this
equipment from these lists up to four times.
3. Click Save .
Tip
• You can now open the Calibration History window to view the
instrument tag history with detailed test equipment information, or
generate a report that will contain detailed information about the
selected test equipment.
Related Topics
• Managing Test Equipment Data, page 1212

Calibration Module
Loop Error Calculation: An Overview

The loop error feature offers you three different methods to calculate the total error of
a selected loop: normal, absolute, and root mean square. The calculation is performed
per loop based on one or more instrument tags belonging to the loop.
The error is measured at several points that you predefine in the Calibration Settings
window. The error is calculated at the default point that you define in the
Preferences dialog box. The loop error is measured relative to the largest tolerance
value of all the calibration data for the tags that are included in the loop error
calculation.
Related Topics
• Calculating Loop Error, page 1222
• Setting Tags for Loop Error Calculation, page 1220

Calibration Module
Loop Error Calculation Common Tasks

When performing a loop error calculation, you need to perform the tasks indicated in
this section.
Caution
• To make a valid loop error calculation, make sure that your calibration and
calculation have been time stamped on the same day.
• Set the value of the loop error calculation method and the loop calculation
point on the Preferences dialog box.
• Define the calibration settings for the selected tags. Tags have their
predefined settings which you enter in the Calibration Settings window.
When you calculate the loop error of a specific loop you should use the
settings to include at least one tag that belongs to the designated loop
(Setting Tags for Loop Error Calculation, page 1220).
• Enter calibration data for the selected tags in the loop (Entering
Calibration Data, page 1214.
• Select the desired calculation method and perform the actual calculation
(Calculating Loop Error, page 1222).
• Generate a loop error report (Generating Calibration Reports, page 1227).

Calibration Module
Calibration Error Calculations

This section describes how the software calculates the calibration errors.
As Found and As Left Errors (% of Span) Calculation

The following formula is used to calculate the As Found and the As Left errors (% of
Span):
Where i = calibration point number
As Found and As Left Errors (% of Reading) Calculation

The following formula is used to calculate the As Found and the As Left errors (% of
Reading):
Where i = calibration point number
Error Calculation of Square Root Extraction

Calibration errors for differential pressure flow instruments that require a square root
extraction are calculated according to the following formula:
Example:
out.signalmin = 4 mA
out.signalmax = 20 mA
out.signal range = out.signalmax – out.signalmin = 16mA
% of Input Output Value

0 4 + (16 * 0) = 4
25% 4 + (16 * 0.5) = 12
50% 4 + (16 * 0.707) = 15.3137
75% 4 + (16 * 0.866) = 17.8564
100% 4 + (16 * 1) = 20

Calibration Module
Setting Tags for Loop Error Calculation

This procedure explains how to set tags associated with a certain loop for inclusion in
the loop error calculation.
Important
• You must calibrate the tags before you perform the actual loop error
calculation.
• You can also set the tags for inclusion from a view that you create in the
Browser module. If you use a browser view to set the tags, make sure that
you include the Tag Number, Loop Number, and Calibration Required
columns.
Set Tags for Loop Error Calculation

2. On the Preferences dialog box, do the following:
a. In the tree view, click Calibration > General.
b. From the Calculation method list, select the desired loop calculation method.
Select Ask user if you want the software to prompt the user for the method at
the time of performing the loop error calculation.
c. Beside Calculate at point, enter a value between 1 and 100.
Tip
• The value is set by default to 75%.
• Click .
5. On the Enter Tag Number dialog box, type a tag number or click Find to find
the required instrument tags.
Tips
• You must select at least one tag for each loop that you want to
calculate.
• If you selected more than one tag, click Actions > List Tags and then
click the desired tag number to define the settings for that instrument.
6. In the Calibration Settings window, in the Errors / Points section, from the
Include in loop error list, select Yes.

Calibration Module
7. Define all the remaining settings as needed.

8. Click Save to save the settings.
Tip
• You can now start entering calibration data by selecting Yes when
prompted after saving the data. Click No when prompted to start the
data entry to continue to define calibration settings for another tag
number.
Related Topics

Calibration Module
Calculating Loop Error

After you set tags for loop error calculation, use this procedure to do the following:
• Select tags from a given loop for loop error calculation

• Select a loop error calculation method
• Perform the loop error calculation
Calculate the Loop Error

1. In the Calibration Module window, do one of the following:
• Click .
• Click Actions > Data Entry.
2. On the Enter Tag Number dialog box, click Find to open the Find Tag dialog
box.
3. Under Search parameters, set conditions to filter the tag display as necessary
and click OK.
Important
• To ensure that an instrument tag is included in a loop error calculation,
in the Calibration Settings window, you must set Include in loop
error for that tag to Yes (for details, see Setting Tags for Loop Error
Calculation, page 1220).
• For all instrument tags that are included in a loop error calculation,
you must specify the Tolerance units of measure value as %.
4. Under Search results, select the tags that you want to include in the loop error
calculation, and click OK.
5. In the Calibration Data Entry window, enter the calibration data for the tags that
you selected.

Calibration Module
6. To navigate among the tags that you selected for error calculation, do one of the
following :
• On the module toolbar, click to open the Tag List pop-up window,
and click the tag for which you want to enter calibration data.
• On the module toolbar, click Next to display the next tag or click
Previous to display the previous tag.
Tip
• You have to enter the calibration data for all the tags that you want to
include in a loop error calculation on the same day that you intend to
perform the calculation. If you enter tag calibration data more than
once on a calculation day, the calculation is performed using the
results that deviated the most from the predefined tolerance.
7. Click Options > Loop Error.
8. If a message appears with a list of tag numbers that are not yet calibrated, do the
following:
a. In the Calibration Data Entry window, enter the calibration data for the
desired tag numbers.
b. Click Options > Loop Error.
9. On the Loop Error Calculation Method message box, select the desired
calculation method.
Caution
• The calculation method that you set here cannot be changed later.
Make sure that you set the optimal calculation method for the selected
loop.
10. Click OK.
11. On the Loop Error Result dialog box, after you view the results, click Close.
Related Topics
• Setting Tags for Loop Error Calculation, page 1220

Calibration Module
Maintaining Calibration History

This option allows you to view a tag calibration entry settings and results. Using this
option, you can easily browse through the displayed entries and select a calibration
record to view or delete.
You can view calibration history for a specific instrument tag Calibration History
window, which has the following tabs:
• Data History– contains the existing calibration history records for the
current tag.
• Result Points History– displays the result points for the selected record.
• Custom Fields – allows you to define custom fields for the history.
Tips
• The Domain Administrator sets the custom field names in the Calibration
module, if no names are set then the default names are displayed.
• The custom fields in the Calibration History window are independent of
the custom fields in the Calibration Settings and Calibration Data
Entry windows.
Related Topics

Calibration Module
Deleting a Calibration Result Entry

Use the following procedure to delete a calibration result entry. Note that you cannot
delete the calibration settings even if you delete all the calibration result entries.
Delete a Calibration Result Entry

1. Open the desired instrument tag in the Calibration History window.
2. If more than one history record exists for the selected instrument tag, click
Previous or Next to navigate to the desired record.
3. Click Delete .
4. At the prompt, click OK to delete the selected calibration history entry from the
database.
5. Click Save .
Related Topics

Calibration Module
Viewing and Modifying Calibration Results

You can modify the calibration results when viewing a selected calibration history
record in the Calibration History window.
View Or Modify the Calibration Results

1. Open the desired instrument tag in the Calibration History window.
2. In the Calibration History data window, click the Result Points History tab.
3. Click to allow editing of the As Found and As Left result code values.
4. When done, click Save .
Related Topics
• Generating Calibration History Reports, page 1228
• Generating Calibration Reports, page 1227

Calibration Module
Generating Calibration Reports

Use the following procedure to generate calibration reports.
Generate Calibration Reports

1. In the appropriate Calibration module window, on the Reports menu, click the
menu option for the report that you want to generate.
2. If a filter dialog box opens, do the following, as available:
a. In the Date range group box, do one of the following to set the date range for
the report:
• To set a specific date range, select Specified dates, and then in the
From and To lists enter the date range.
• To generate a report for the [previous, current, or next] [week,
month, or year], select Predefined period, and then in the lists to
the right, select the options that you need.
b. In the Filter by group box, use the options to set a filter condition for the
report that you are generating.
3. Click OK.
Notes
• For reports by tag or by loop, click to search for the items that you
want.
• The loop error report can be displayed even if a loop error calculation was
not performed on that day; however, the report is only of an earlier
calculation date. The default calculation method that the report depends
upon is Normal values. However, if you select a calculation method other
than Normal for a certain loop the calculation report changes respectively.
• To generate a calibration equipment report, type the name of the
equipment, with or without wildcards, in the Calibration equipment
field. If you do not enter a value for calibration equipment, you can click
OK and select the desired item from the Select Test Equipment dialog
box.
Related Topics
• Generating Calibration History Reports, page 1228

Calibration Module
Generating Calibration History Reports

The following calibration reports are available only from the Calibration History
window:
Report Name Description

Instrument A summary of calibration settings, calibration results, a graphic
Calibration presentation of the error percentage for the selected tag, and test
Results equipment used for calibrating this tag.
Alarm / Trip A summary of trip and alarm point data of all instruments.
Points Summary
Generate Calibration History Reports

1. Open the Calibration History window.
• Click Reports > Calibration Results
• Click Reports > Alarm / Trip Points Summary
3. At the Print Preview Request prompt, do one of the following:
• To display the report preview, click Yes.
• To print the report without preview, click No.
Related Topics
• Generating Calibration Reports, page 1227

Working with the Fluke Interface

This interface allows you to exchange calibration data with the Fluke Documenting
Process Calibrator models 743B and 744. By means of wizards, you can download
(export) tag number data to the calibrator, and after collecting the calibration data,
you can upload (import) calibration data into SmartPlant Instrumentation for all of the
calibrated tag numbers.
Note
• If you are working on a Citrix console to which a Fluke Calibrator is
connected, to enable the software to detect the calibrator on the serial port
located on the client machine, you must first map the serial port to the
client machine as follows:
1. Within the Citrix console, at the server location, click Start > Run.
2. On the Run dialog box, in the Open box, type: cmd
3. At the command prompt, type: net use
A summary of the mapping between local and remote ports similar to the
following should appear:
4. If the desired port, for example COM 1, does not appear in the summary, then
type: net use COM1: \\Client\COM1:
5. At the command prompt, type net use again and check that the desired serial
port is now included in the mapping.

Downloading Data from SmartPlant Instrumentation

1. Connect the Fluke Documenting Process Calibrator to your computer's COM port
and switch on as described in the Fluke Users Manual.
2. Open the Calibration module and from the Calibration Settings window, define
the source and output value ranges and units of measure for the desired tag
numbers.
Tip
• When performing a calibration for a thermocouple using the Fluke
calibrator as an external power supply, you must enter the following
data using the custom fields indicated:
3.
Custom Field Property Acceptable Value
CALIB_SET_UDF_C16 Loop power 24V / 28V
CALIB_SET_UDF_C17 Thermocouple type E/N/J/K/T/B/R/S/C/
L/U
CALIB_SET_UDF_C18 Thermocouple source Linear MV / Linear T
mode
4. Click Actions > Fluke Interface.

5. Click Next.
6. On the Connection Options page, define your connection setting and click Test.
Tip
• If the connection test is successful, an appropriate message appears in
the Connection result box. If the connection fails, check the physical
connections and if necessary, select a different communication port
and retry.
7. Click Next to go to the Activity Selector page.
Tip
• If you first want to clear the calibrator, click Flush calibrator
memory, ensure that the Upload default memlist and procedures
check box is selected, and then click Next. On completion of the
process click Back.
8. Click Download data from SmartPlant Instrumentation to the calibrator.
9. On the Tag Selection for Download page, select the Export check box beside
each tag that you want to download to the calibrator, and then click Next.

10. On the Download Data page, click Start to begin the download.
Tip
• The progress bars indicate the current activity. You will also see an
indication on the calibrator that data is uploading to it.
Note
• This procedure downloads the following data to the Fluke calibrator:
• Tag number.
• Component_ID value – this is a unique value that SmartPlant
Instrumentation automatically generates on creation of a tag number.
This number is displayed in the Fluke calibrator interface as the tag
serial number. Do not modify this number, either from the calibrator
or from the SmartPlant Instrumentation database.
• Source maximum and minimum range values and their units of
measure.
• Output measurement maximum and minimum range values and their
units of measure.
• Calibration strategy.
• Tolerance.
The following table shows a sample set of downloaded data values:
Tag Range Range Range Output Output Output Strategy Tolerance
Number Min. Max. UOM Signal Signal Signal (Calibration
Min. Max. UOM error type)
101-TT 100 200 °C 4 20 mA 3 ↑↓ 1
-100
101-PT 0 10 Bar 4 20 mA 5↑ 1.5
-200 (G)
101-LT 0 1000 mm 4 20 mA 3↑ 2
-300

Uploading Data from the Fluke Calibrator

1. After calibrating your instruments, connect the Fluke Documenting Process
Calibrator to your computer's COM port and switch on as described in the Fluke
Users Manual.
2. Open the Calibration module.
3. Click Actions > Fluke Interface.
4. Click Next.
5. On the Connection Options page, define your connection setting and click Test.
Tip
• If the connection test is successful, an appropriate message appears in
the Connection result box. If the connection fails, check the physical
connections and if necessary, select a different communication port
and retry.
6. Click Next to go to the Activity Selector page.
7. Click Upload data into SmartPlant Instrumentation from the calibrator.
8. Click Next.
9. On the Upload Data page, click Start to begin uploading data from the
calibrator.
Tip
• The progress bars indicate the current activity. You will also see an
indication on the calibrator that data is downloading from it.
10. On completion of the upload process, click Next.
11. On the Upload Summary page, view the tags for which the interface has
uploaded calibration data into SmartPlant Instrumentation.
12. Click Finish to complete the operation.
13. In SmartPlant Instrumentation, open the Calibration module and from the
Calibration History window, view the tag calibration data.

Process Data Module
Process Data Module

The Process Data module enables you to efficiently define process conditions for a
particular instrument or line. These process conditions then become the reference
point for the system. Process data for instruments relates to seven process functions:
Flow, Temperature, Pressure, Level, Analyzer, Control Valve, and Relief Valve. The
data - including the process units of measure - can be modified at any time when
desired.
Batch creation of process data sheets can be done by adapting existing instruments
and lines using an interface that allows process characteristics to be simultaneously
assigned to several instrument groups, thus ensuring system-wide integrity.
The Process Data module shares data with loop components that are associated with a
given process. Data is also shared with the Specifications, Calculations, and
Instrument Index modules, allowing all the data from these modules to be
incorporated into generated reports.

Process Data Module
Process Data Principles

SmartPlant Instrumentation enables you to store and manage process data for lines
and instruments.
To view process data for instruments, enter the tag number directly when prompted,
or use the search utility. To view lines, select the desired line in the Select Line
dialog box.
If instruments or lines have none or partial process data attached, you can do either of
the following:
• Enter new data.

• Modify existing data (including automatic conversion of units as desired).
Notes
• When the Workflow option is activated, only instrument tags marked
Process Data Required are visible in process data sheets.
• Saving process data modifications makes them accessible to other
modules. When you generate a report that includes process data, you can
set SmartPlant Instrumentation to prompt you that the relevant process
data has been changed.
• You cannot generate process data sheets for virtual tags.
Related Topics
• Adding a New Line, page 1252
• Modifying Line Properties, page 1253

Process Data Module
Starting the Process Data Module

Note
• Before starting this module, check with the Domain Administrator to
ensure that you have been granted appropriate access rights for the tasks
you will carry out.
Start the Process Data Module

• In any main SmartPlant Instrumentation window, do one of the following:
• Click Modules > Process Data.

Process Data Module
Working With Instrument Tags in the Process Data

Module
These procedures explain how to create, open, and define basic process data for an
instrument tag in the Process Data module. Although you usually create tags in the
Instrument Index module, the ability to create tags in the Process Data module allows
for efficient creation of complex analyzers, for example, stream and component tags.
Create an Instrument Tag in the Process Data Module

1. In the Process Data window, on the module toolbar, click .
2. In the Enter Tag Number dialog box, type the name of the new tag number, and
click OK.
record for a given instrument type acronym), select the desired instrument type
and click OK.
• Accept the displayed loop number and click OK.
• Type the loop number that you need and click OK.
• To create the tag number without a loop association, click Cancel.
5. In the Tag Number Properties dialog box, on the General tab, enter the
appropriate values.
Tip
• If you are creating a complex analyzer, do NOT at this point select a
line from the Line list.
6. Click OK.
Open an Instrument Tag in the Process Data Module

1. On the module toolbar, click .
2. In the Enter Tag Number dialog box, do one of the following:
• Type the desired tag number.
• Click Find to open the Find Tag dialog box and find a desired tag
number.
• Click OK.

Process Data Module
Define Basic Process Data for an Instrument Tag

1. Do one of the following to open a tag in the Process Data module:
• Create a tag.
• Open a tag that you created previously.
2. In the Process Data dialog box, do the following:
a. Select a fluid state.
b. If you are creating an analyzer, do one of the following from the Analyzer
type list:
• To create a simple analyzer, select Simple.
• To create a complex analyzer, select Complex.
c. Click OK.
Important
• Simple analyzers belong to the Conventional Tag Class.
3. If the Complex Analyzer Tag Manager dialog box opens, define the complex
analyzer. For details, see Defining a Complex Analyzer, page 1268.
4. In the process data sheet for the tag that you opened, under Line number, select
the line number to which the tag is connected.
Tips
• If you confirm the prompt to copy the line data, all relevant line
properties and data are copied to the tag process data sheet that you are
editing.
• If you selected a line that you configured for a complex analyzer,
SmartPlant Instrumentation copies the data from the Line Component
table for that line into the ANALYZER / COMPONENT
PROPERTIES section of the data sheet.
5. Enter the remaining process data as needed.
6. If you are defining a complex analyzer, link analyzer stream component tags with
line components, see Linking Analyzer Stream Components with Line
Components, page 1269.
7. If you are defining a simple or a complex analyzer, in the ANALYZER
COMPONENT / PROPERTY section, enter values and units of measure in the
Repeatability, Accuracy, Minimum detection limit, and Range fields as
needed.
Related Topics
• Adding a New Line, page 1252
• Process Analyzers, page 1265

Process Data Module
Editing Instrument Process Data

This procedure explains how to edit the process data associated with an instrument
tag. You can edit instrument process data from the Process Data module or from the
Calculation module.
Edit Instrument Process Data

1. Open the process data sheet for an instrument tag from the Process Data module
or the Calculation module.
2. In the Process Data window, modify the process data values as desired.
Tips
• If you are creating a multi-case tag, you can enter values for each case
that you create (for details, see Multiple Process Data Cases, page
1260).
• If the Domain Administrator enabled the use of process data custom
fields, the above sections can display such fields.
3. On the module toolbar, click to save the values.
Related Topics
• API 2540 Standard for Liquid Density Calculation, page 1275
• Fluid Definition, page 1293
• Modifying Instrument Base Conditions, page 1239
• Multiple Process Data Cases, page 1260

Process Data Module
Modifying Instrument Base Conditions

Use this procedure to modify base condition values when entering data for Control
Valve, Relief Valve, or Flowmeter calculations, from the Process Data or Calculation
modules.
Modify Base Conditions for an Instrument Tag

2. Scroll to the BASE CONDITIONS section.
3. Select a base pressure unit of measure, and beside Pressure type the base
pressure.
4. Select a temperature scale, and beside Temperature, type the base temperature.
5. According to the state that you selected under Fluid, select the desired basic
property as follows:
• If the state is solid/powder, do one of the following:
• Select Density @base, select a unit of measure, and type the
density value.
• Select Specific Gravity @base, and type the specific gravity
value.
• If the state is liquid, do one of the following:
density value.
value.
• If the state is water, do one of the following:
density value.
value.

Process Data Module
• If the state is gas/vapor, do one of the following:

density value.
• Select Compressibility @base, and type the compressibility
value.
• If the state is steam, beside Compressibility @base, type the desired
value.
6. To save your changes, on the module toolbar, click .
Related Topics
• Performing Calculations, page 1295

Process Data Module
Copying Instrument Process Data from Another

Instrument
This option allows you to copy instrument process data from any existing instrument
to the currently selected instrument.
Copy Instrument Process Data From Another Instrument

1. Open the target process data sheet.
2. In the Process Data window, on the Edit menu, point to Copy and click From
Instrument.
3. In the Enter Tag Number dialog box, do one of the following:
• In the text box, type the source tag number.
• To search for the source tag, click Find.
Tip
• You can only copy data from a tag number of the same instrument
type.
4. To select a source case other than the governing case, do the following:
a. Click Change.
b. In the Select Case dialog box, from the Available cases list, select the source
case.
c. Click OK.
5. In the Enter Tag Number dialog box, click OK.

Process Data Module
Propagating Line Process Data to an Instrument

Tag
These procedures allow you to propagate relevant process data from a line to the
current tag. Before you perform either of these procedures, you can set a filter that
limits the fields that you propagate (for details, see Setting the Line-to-Tag Filter,
page 1244.
Notes
• The current procedures propagate line process data to a single tag. For
details of how to propagate line data to more than one tag, see Batch
Propagation of Line Data to Instrument Tags, page 1243.Preventive
Maintenance technician options include filling out test results.<Unit>
• Use the current procedures to propagate multi-case process data from a
line to a tag, since the batch procedure propagates process data from the
governing case only.
Propagate Process Data From the Current Line to the

Current Instrument
1. Open and edit the process data sheet for the instrument to which you want to
propagate process data from a line.
2. On the Edit menu, point to Copy and then click From Line.
Propagate Process Data From Any Line to the Current

Instrument
1. Open and edit the process data sheet for the instrument to which you want to
propagate process data from a line.
2. In the GENERAL section of process data sheet, from the Line number list,
select the line from which you want to propagate the process data to the current
tag.
Tip
• SmartPlant Instrumentation automatically propagates the relevant
process data from the line that you select to the current tag.
Related Topics
• Batch Propagation of Line Data to Instrument Tags, page 1243
• Setting the Line-to-Tag Filter, page 1244

Process Data Module
Batch Propagation of Line Data to Instrument Tags

This procedure allows you to propagate process data from a particular line to tags that
you select. Before you perform this procedure, you can set a filter that limits the
fields that you propagate (for details, see Setting the Line-to-Tag Filter, page 1244.).
Note
• This procedure propagates the governing case only. For details of how to
propagate all cases from a given line to a given tag, see Propagating Line
Process Data to an Instrument Tag, page 1242.
Propagate Line Data to a Batch of Instrument Tags

• Open the Process Data Module window.
• Open a process data sheet for a line.
2. On the Actions menu, click Propagate Line Data.
3. In the Propagate Line Data dialog box, from the Line number list, select the
source line from which you want to propagate the data to the tags.
4. Select the target tags by doing one of the following:
• To select a group of target tags, select one of the following options
from the Propagation method list:
• Include all tags
• Include all tag numbers with process data
• Include all tag numbers without process data
• To select target tags individually, click Find to open the Find Tag
dialog box, where you select the specific target tags.
5. In the Propagate Line Data dialog box, click Propagate.
Tip
• The propagated results are shown in the Processed tags data window
(a selected box in the Done column signifies successful processing of
data).
6. Click Close.
Related Topics
• Propagating Line Process Data to an Instrument Tag, page 1242
• Setting the Line-to-Tag Filter, page 1244

Process Data Module
Setting the Line-to-Tag Filter

This procedure enables you to set a process data line-to-tag filter. When you
propagate process data from lines to instruments, only the selected properties are
propagated. The current filter settings affect both of the following procedures:

Select Line Properties

1. In the Process Data Module window, on the Edit menu, click Select Line
Properties for Copying.
2. In the data window, clear the selection of fields that you do not want to copy from
lines to tags.
Tip
• If you want to select a few fields only for copying, select and then
clear the Select all check box to clear all the fields first.
3. Click OK.
Related Topics

Process Data Module
Process Data for Differential Pressure Instruments

Note
• After setting the default units of measure for the current unit in the Units
of Measure and Accuracy dialog box, you can select the desired default
unit of measure for Differential Pressure (DP instrument).
Define Process Data for a Differential Pressure Instrument

1. Open the desired pressure instrument process data sheet.
2. From the Pressure type list, select Differential Pressure.
Tips
• The Pressure property label changes to Differential pressure.
• From the unit of measure flag lists throughout the process data sheet,
you can select the Differential unit of measure flag.
3. Under PROPERTIES and ADDITIONAL PROPERTIES, enter the appropriate
process data values.
4. Under ALARM, define the alarm and trip settings as needed.

Process Data Module
Deleting Instrument Process Data

This option enables you to delete instrument process data. Note that you cannot
delete any tags in the Process Data module. Tag numbers are deleted in the
Important
• The deletion process is irreversible. Once you have deleted the process
data, you cannot restore it!
Delete an Instrument Process Data Sheet

1. With the Process Data Module window open, on the Edit menu point to Delete
Process Data and click Instrument.
2. In the Enter Tag Number for Deletion dialog box, do one of the following:
• In the text box, type tag for which you want to delete process data.
• To search for the tag, click Find.
3. Click OK.

Process Data Module
Calculating Physical Properties

The Fluid Properties Database allows you to calculate the properties of the chosen
material according to its pressure and temperature.
The calculated properties are:
For Liquid For Gas

Density and Specific Gravity Density and Specific Gravity
Vapor pressure Compressibility
Viscosity Viscosity
Liquid Heat Capacity Specific Heat Ratio
Note
• This option is not available for materials where the state is solid/powder,
nor for 2-phase flow.
Calculate the Properties of a Selected Material

1. Open the desired process data sheet.
2. In the Process Data window, from the Fluid name source list, select Database.
3. From the Fluid list, select the desired fluid.
4. In the PROPERTIES section, enter the appropriate pressure and temperature
values.
Notes
• SmartPlant Instrumentation calculates and displays changed values.
• SmartPlant Instrumentation uses the AIChE databank to calculate physical
properties; therefore your values must comply with the AIChE
temperature limits. Note that AIChE data does not provide accurate
calculation of density, compressibility, and specific gravity for ethylene
and propylene at critical pressure and temperature. For this reason, the
software implements the procedure described in William C. Reynolds, SI,
Department of Mechanical Engineering, Stanford University.
• To calculate liquid density, on the Options menu, click Calculate Liquid
Compressibility.
• To calculate the steam properties, on the Options menu, click Saturated
Steam.

Process Data Module
Adding a New Line Type

This option enables you to add a new line type to the Line Type list in the Select
Line dialog box.
Add a Line Type

1. In the Process Data Module window, on the module toolbar, click .
2. In the Select Line dialog box, next to the Line Type list, click .
3. In the Line Types dialog box, click New.
4. Type the new line type name and description in the appropriate fields.
5. Click OK.
Related Topics
• Changing the Line Type, page 1250
• Deleting a Line Type, page 1251
• Editing a Line Type, page 1249

Process Data Module
Editing a Line Type

This procedure explains how to edit a line type.
Edit a Line Type

2. In the Select Line dialog box, beside the Line type list, click .
3. In the Line Type dialog box, make the necessary changes.
4. Click OK.
Related Topics
• Adding a New Line Type, page 1248
• Changing the Line Type, page 1250

Process Data Module
Changing the Line Type

This procedure explains how to change the line type for a specific line.
Change the Type of a Selected Line

2. In the Select Line dialog box, do one of the following:
• To display lines of all line types, select Show all line types.
• From the Line type list, select the current line type of the desired line.
3. In the data window, select the desired line, and click Change Type.
4. Select the new line type and click OK.
Related Topics
• Adding a New Line Type, page 1248

Process Data Module
Deleting a Line Type

This option enables you to delete a line type. You cannot delete a line type if it
includes a record, i.e., if it is associated with a line.
Delete a Line Type

2. In the Select Line dialog box, next to the Line Type list, click .
3. In the data window, select the line type that you want to delete, and click Delete.
4. Click OK.
Note
• Line numbers cannot be deleted in the Process Data module — only
process data. You can delete a line only in the Instrument Index module.
Related Topics

Process Data Module
Adding a New Line

Use this procedure to add a new line from the Process Data module.
Add a New Line

1. In the Process Data Module window, do one of the following:
• On the process data toolbar, click .

• On the Edit menu, point to Open Process Data, and click Line.
2. In the Select Line dialog box, from the Line type list, select a line type.
Tip
• To create a new line type, click beside the Line type list.
3. Click New.
4. In the Line Properties dialog box, complete the data fields of the left column as
follows:
a. In the Line number box, type the desired value.
b. From the P&ID list, select the drawing associated with this line.
c. In the Stream name box, type the optional stream name.
d. From the Pipe material list, select the pipe material.
e. From the Pipe spec list, select the pipe spec, or click to open a dialog box
where you manage pipe specs.
5. To complete the data fields of the right column, do one of the following:
• If under Pipe standard you select ANSI or DIN, this opens the Pipe
Data dialog box. Select one of the predetermined sets of values, and
click OK to transfer these values back to the Line Properties dialog
box.
• If under Pipe standard you select Other, enter the remaining right
column values manually.
6. In the Line Properties dialog box, click OK.
7. In the Select Line dialog box, click OK.
8. If the Process Data dialog box opens, select a fluid state and click OK.
9. In the Process Data for Line window, enter process data for the new line.
10. On the Actions menu, click Save Process Data.
Related Topics
• Managing Line Component Tables, page 1267

Process Data Module
Modifying Line Properties

You can edit line data in either the Process Data or the Instrument Index modules.
This procedure applies to the Process Data module.
Modify Line Properties

• On the process data toolbar, click .

• On the Edit menu, point to Open Process Data and click Line.
2. In the Select Line dialog box, select the row containing the line data you want to
edit.
3. Click Properties to open the Line Properties dialog box.
4. Modify the appropriate values in the Line Properties dialog box as follows:
• Edit the line number name.
• Select another pipe material.
• Select another pipe standard.
• Select another pipe spec.
5. When done, click OK to return to the Select Line dialog box.
Duplicate a Line
Lines folder.
2. Double-click the Lines folder to display the existing lines.
3. Right-click the loop you want to duplicate, and on the shortcut menu, click
Duplicate.
4. On the Line Properties dialog box, type the new line number.
Tip
• The data field on the Line Properties dialog box displays the line
name template which is based on the line naming convention defined
by the Domain Administrator. In the alphanumeric and the numeric
parts of the name, you can type any character (letters, digits, spaces,
and so forth).
5. If required, do the following to create the duplicated line in a different <unit> in
the current domain:

Process Data Module
6. On the Line Properties dialog box, click OK.

7. The duplicated line has the same piping data as the line it was duplicated from,
however, you can change the pipe associated with the line as follows:
a. On the Line Properties dialog box, click Pipe Data.
b. Select the appropriate line and click OK.
Viewing Line Process Data

This procedure allows you to view a line process data before editing it.
View Line Process Data

2. In the Select Line dialog box, select the desired line type from the Line type list
to filter the data screen. Select All Line Types check box to display all available
lines.
3. Highlight the desired line number and click OK.
4. If the Process Data dialog box opens, select a fluid state and click OK.
5. In the Process Data for Line window, click .
Related Topics
• Editing Line Process Data - Fluid, page 1256
• Editing Line Process Data - Selecting Pipe Standards, page 1255

Process Data Module
Editing Line Process Data - Selecting Pipe

Standards
Use this procedure to edit the pipe and line properties section of the Process Data for
Line window. There are parameters that you set directly, and others that you set from
the Pipe Data dialog box.
• For all pipe standard options — ANSI, DIN, and Other— you edit the
following parameters directly: pipe material, pipe spec, and wall thickness.
• If your current selection from the Pipe Standard list is Other, you can
also edit Line size and its unit of measure, and Line Int. diameter
• If your current selection from the Pipe standard list is ANSI or DIN,
SmartPlant Instrumentation allows you to set additional fields from the
Line Properties dialog box that opens. If you closed this dialog box and
want to reopen it, on the Options menu, click Pipe Data.
• The method and effects of changing the pipe standard, and the impact of
these changes on the current parameters, are summarized in the table
below:
Change Action Result
ANSI DIN: ANSI / Select ANSI or DIN See the first and fourth notes. See
DIN to Other: Other to Select Other Select the second and third notes. See
ANSI / DIN: ANSI or DIN the first and third notes.
Notes
• The Pipe Data dialog box opens for new parameter selections.
• If you change your Pipe standard selection from ANSI or DIN to Other,
the parameter fields become editable.
• If you change from ANSI or DIN to Other, SmartPlant Instrumentation
hides the Line schedule field. If you change from Other to ANSI or
DIN, this field appears.
• If you change from ANSI to DIN or from DIN to ANSI, your selection in
the Pipe Data dialog box changes all parameters except for pipe material
and pipe spec.

Process Data Module
Editing Line Process Data - Fluid

A fluid is a material characterized according to state, name, and phase.
• Fluid state: Indicates whether the fluid is a generic liquid, water, a generic
gas, steam, or solid/powder. Selecting the fluid opens the properties
section with the appropriate parameters for selection.
• Fluid name: When the User-defined option is selected from the list, you
can type the name of the fluid in the text box.
• Fluid phase: The phase indicates whether the fluid is single or 2-phase.
This selection is for information only.

Process Data Module
Copying Line Data from One Line to Another

This option allows to copy line data from a selected line to another line or to a group
of lines. If you are creating a complex analyzer with multi-stream analysis for a
given physical line, you need to create multiple virtual lines, each representing a
stream. You can use this procedure to copy settings from one instance of such a line
to the others.
Copy Line Data From One Line to Another

1. In the Process Data Module window, on the Actions menu, click Copy Line
Data.
2. Under Source lines, do one of the following from the Line types list:
• Select All Line Types.
• Select a specific line type.
3. Under Line number, select the source line.
4. Under Target lines, do one of the following from the Line types list:
• Select All Line Types.
• Select a specific line type.
5. In the data window, select the target lines.
Tips
• You can use the filter data field to locate a specific line. Type the
name of the desired line / P&ID / stream in the respective field and
click the Apply Filter button. SmartPlant Instrumentation highlights
the line you were looking for. Another possibility is to select the As
typed check box and then type the line/P&ID/Stream name in the
respective field. The data is filtered as you type.
• You can sort the rows according to a column by double clicking the
column's header.
6. Click Copy to copy the data to the selected target lines.

Process Data Module
Deleting Line Process Data

This procedure enables you to delete process data for a given line.
Important
• Before deleting process data, note that deleted process data cannot be
restored.
Delete Line Process Data

1. With the Process Data Module window open, on the Edit menu, point to Delete
Process Data and select Line.
2. In the Select Line to Delete Process Data dialog box, do one of the following to
display in the data window those lines whose process data has been defined:
• From the Line type list, select the desired line type.
• Select the Show all line types check box to display all the existing
lines with process data.
3. Highlight the desired line in the data window.
4. Click OK.

Process Data Module
Line Fluid Velocity

SmartPlant Instrumentation calculates the line fluid velocity according to the line
internal diameter and volumetric fluid flow at flow conditions.
If you enter fluid flow as mass or volumetric flow at standard / normal / base
conditions, SmartPlant Instrumentation will calculate volumetric flow at flow
conditions first (using density values) and then the line fluid velocity.
Note
• For flowmeters, fluid velocity at operating conditions is calculated
automatically according to fluid flow and line internal diameter. If the
mass flow value has been entered, density is required for fluid velocity
calculation.

Process Data Module
Multiple Process Data Cases

A given instrument or line is often used for more than one operating service. For
example, a dual-fuel control system might use a single supply line and control valve
to carry various fuels, gas or liquid. Each group of process data settings that you
enter for a given instrument or line is called a case.
Note
• Each case has a separate drawing with its own revisions. Each drawing
includes the case name as part of the drawing name.
In the Process Data or Calculation modules, use the following procedures to
implement multiple process data cases:
• Creating Process Data Cases, page 1261.

• Setting a Governing Case, page 1262.
• Deleting a Process Data Case, page 1264.
• Managing the Cases Supporting Table, page 1263.

Process Data Module
Creating Process Data Cases

Use these procedures to do the following:
• Enable cases for a tag or a line by assigning a case name to the current
process data
• Add additional cases to the tag or the line, thus creating multiple cases
Note
• Case names that you assign to a given line or tag can be duplicates of
names that you assign to cases in other lines and tags.
For either of these procedures, do one of the following:
• Open the process data sheet for an instrument tag from the Process Data
module or the Calculation module.
Enable Cases for the Current Tag Or Line

1. On the Actions menu, click Enable Case.
2. In the Enable Case dialog box, do one of the following to select a case name for
the current data:
• Select an existing case name from the Available cases list.
• To create a new case name, click to open a dialog box where you
can create new case names.
3. Click OK.
Add a Case for the Current Tag Or Line

1. On the Actions menu, click Add Case.
2. In the Add Case dialog box, do one of the following to select a name for the new
case:
• Select an existing case name from the Available cases list.
• To create a new case name, click to open a dialog box where you
can create new case names.
3. Click OK.
4. Enter and save process data for the case that you created.

Process Data Module
Setting a Governing Case

A governing case is the set of process data values for a line or a tag that you select as
the active case. If for a given line or a tag you create more than one case, SmartPlant
Instrumentation requires that you select a governing case. If you define a single case,
the software automatically sets it as the governing case.
Use this procedure to select a governing case for a line or a tag.
Note
• Once you have enabled cases for line or a tag, if there is only one case,
SmartPlant Instrumentation automatically defines it as the governing case.
If you subsequently enable additional cases, the first case still remains the
governing case until you set a new governing case.
Set a Governing Case

• Open the process data sheet for an instrument tag from the Process
Data module or the Calculation module.
2. In the GENERAL section of the process data sheet, from the Case list, select the
case that you want to be the governing case.
3. On the Actions menu, click Set as Governing.
Related Topics
• Creating Process Data Cases, page 1261
• Deleting a Process Data Case, page 1264
• Managing the Cases Supporting Table, page 1263

Process Data Module
Managing the Cases Supporting Table

You use cases to enable multiple sets of process data for a given instrument or line.
Use these procedures to create, edit and delete case names and their descriptions.
You can manage the Cases supporting table from the Process Data module or the
Calculation module.
Note
• Case names that you assign to a set of process data for a given line or tag
can be duplicates of names that you assign to cases in other lines and tags.
Manage the Cases Supporting Table

1. To open the Cases supporting table do one of the following:
• In the Process Data Module window menu bar, click Edit > Cases.
• In the Calculation module, create a case for a tag and do one of the
following:
• In the Enable Case dialog box, click .
•In the Add Case dialog box, click .
2. To add a new case name, click New, and then type a unique case name and an
optional description.
3. To edit an existing case name, click a value that you want to edit, and modify
values as needed.
4. To delete a case name, select the record that you want to delete, and click Delete.
Tip
• SmartPlant Instrumentation does not allow you to delete a case name
that is currently used on any process data sheet.
Related Topics
• Deleting a Process Data Case, page 1264
• Setting a Governing Case, page 1262

Process Data Module
Deleting a Process Data Case

Use this procedure to delete a process data case that you created for a line or a tag.
Important
• Deletion of a case is irreversible.
Delete a Process Data Case

• Open the process data sheet for an instrument tag from the Process
Data module or the Calculation module.
2. Click Actions > Delete Case.
Related Topics
• Managing the Cases Supporting Table, page 1263
• Setting a Governing Case, page 1262

Process Data Module
Process Analyzers
Process analyzers measure physical or chemical properties of a process flow.
SmartPlant Instrumentation supports two types of process analyzers — simple and
complex.
Simple Analyzers
A simple analyzer measures one physical or chemical property of a process fluid at
the point of measurement or fluid sampling.
Important
• Simple analyzers belong to the Conventional Tag Class.
Complex Analyzers
A complex analyzer also measures physical and chemical properties of a process flow
at the point of measurement or fluid sampling. However, you have the following
elements of flexibility in a complex analyzer:
• You can create multiple stream tags.

• For each stream tag, you can create multiple component/property tags.
You can use the complex analyzer methodology even where only a single component
/ property is measured, if the data sheet information requires specifying the complete
process fluid composition for all components.
Although the application determines whether you define some analyzers as simple or
complex, gas chromatographs are by their nature complex. Even if you consider one
stream only, in general you will want to utilize the ability of a gas chromatograph to
analyze various components/properties in the stream.
For procedures related to complex analyzers, see Flow of Activities for Complex
Analyzers, page 1266.
Related Topics
• Flow of Activities for Complex Analyzers, page 1266

Process Data Module
Flow of Activities for Complex Analyzers

To implement a complex analyzer, for example a gas chromatograph, use the
following flow of activities:
1. Adding a New Line, page 1252.
Tip
• For multi-stream analysis in a single physical line, create multiple
virtual lines, each representing a stream.
2. Managing Line Component Tables, page 1267. for the line or multiple virtual
lines.
3. Defining an instrument type of process function type Analyzer for your complex
analyzer.
4. Working With Instrument Tags in the Process Data Module, page 1236.
5. Defining a Complex Analyzer, page 1268.
6. Linking Analyzer Stream Components with Line Components, page 1269.

Process Data Module
Managing Line Component Tables

For each line that you defined for a complex analyzer tag, you need to create a line
components table. This table lists the fluid components of this line, together with
their minimum, normal, and maximum concentrations.
The Line Components table that you create individually for each line is based on a
Fluid Components supporting table — which you also manage — that is available
for all lines.
For both procedures, open a process data sheet for the line for which you want to
create a Line Components table.
Manage the Fluid Components Supporting Table

Note
• You can also perform this procedure from the Process Data window.
1. On the Edit menu, click Fluid Components.
2. To create a new fluid component, click New.
3. Click a value that you want to edit and modify the value as needed.
Create A Line Components Table For The Current Line

1. On the Edit menu, click Line Components.
2. For each fluid component that you want to enable for the current line, do the
following:
a. Click New to add a new row.
b. Under Fluid Component, select an available fluid component.
c. Under Concentration Units, accept the default % or select the unit of
measure that you need.
d. Type values for minimum, normal, and maximum concentration.
3. Click OK.
Related Topics
• Defining a Complex Analyzer, page 1268
• Linking Analyzer Stream Components with Line Components, page 1269

Process Data Module
Defining a Complex Analyzer

You use this procedure in the course of creating a complex analyzer tag. Before you
perform this procedure, do the following:
• Adding a New Line, page 1252.

• Managing Line Component Tables, page 1267 for each line.
• Defining an instrument type of process function Analyzer for your
complex analyzer.
Define a Complex Analyzer

1. In the Process Data module, create a complex analyzer tag.
2. In the Complex Analyzer Tag Manager dialog box, do the following for each
stream tag that you want to define:
a. To the right of the Analyzer stream list, click Add.
b. In the Add Tag Number dialog box, type the number of the stream tag that
you want to create.
c. In the dialog boxes that open, define properties as needed.
Tip
• Associate a line with the stream tag either in the Tag Number
Properties dialog box or in the process data sheet for the given stream
tag.
3. For each stream that you added to the Analyzer stream list, do the following to
create component tags that correspond to every component of the stream:
a. To the right of Analyzer component/property, click Add.
b. In the Add Tag Number dialog box, type the number of the component tag
that you want to create.
c. In the dialog boxes that open, define properties as needed.
4. In the Complex Analyzer Tag Manager dialog box, click OK.
Related Topics
• Linking Analyzer Stream Components with Line Components, page 1269

Process Data Module
Linking Analyzer Stream Components with Line

Components
Use this procedure to link analyzer component tags with line components. You must
perform this procedure for every stream of a complex analyzer.
Link Analyzer Stream Components With Line Components

1. In the Process Data module, open the stream tag.
2. In the GENERAL section, from the Line number list, select the desired line.
3. In response to the prompt, click Yes to copy data from the line to the process data
sheet.
4. In the ANALYZER COMPONENT / PROPERTY section, do the following for
each tag in the Analyzer/component list:
a. Select the analyzer component tag.
b. From the Line component list, select the fluid component that you want to
link with the analyzer component tag.
c. Enter values and units of measure in the Repeatability, Accuracy, Minimum
detection limit, and Range fields as needed.
d. On the Actions menu, click Save Process Data.
Related Topics
• Defining a Complex Analyzer, page 1268

Process Data Module
Adding an Insulation Type

You can add a new insulation type if the desired one is not available in the Insulation
list of the ADDITIONAL LINE PROPERTIES section of the Process Data for
Line window.
Add a New Insulation Type

1. In the Process Data Module window, on the Edit menu, click Insulation Types.
2. In the Insulation Types dialog box, click New to add a new data line, where you
type the new insulation type name and description.
3. Click OK.

Process Data Module
Entering and Editing a Pipe or Orifice Material

This option enables you to enter additional pipe and orifice materials as well as
modify the existing ones. You can select the desired ANSI group and enter or modify
the linear expansion coefficients. It is possible to define linear expansion coefficients
in different ways:
• One linear expansion coefficient for all temperatures.

• One linear expansion coefficient with a limitation on the minimum
temperature (Tmin) or maximum temperature (Tmax).
• Two linear expansion coefficients and border temperature. This option
allows you to use the first linear expansion coefficient for temperatures
lower than the border temperature and the second linear expansion
coefficient for temperatures higher than the border temperature.
• Two linear expansion coefficients, border temperature, and
minimum/maximum temperature. This option allows you to use the first
linear expansion coefficient for temperatures between minimum and
border temperature and the second linear expansion coefficient for
temperature between border and maximum temperature.
Note
• This option is also available in the Calculation module.
Edit Or Enter Additional Pipe/Orifice Materials

1. In any Process Data module window, on the Edit menu, click Pipe/Orifice
Material.
2. In the data window, click fields that you want to edit, and type or select the
desired values from the lists.
3. To enter a new material, click New, and then type or select the desired value from
the respective lists.
4. To delete a material, select the desired data row and click Delete.
5. Click OK to apply changes and close this dialog box.

Process Data Module
Defining or Modifying Pipe Specs

Pipe spec is a specification that defines various process conditions for a specific pipe.
Use this procedure to define a pipe spec to the Pipe Specs supporting table from the
Process Data module, or to modify properties of an existing pipe spec.
Create a New Pipe Spec Or Modify an Existing One

1. In the Process Data Module window, click to open the Select Line dialog
box.
• To create a new pipe spec, click New and type entries in the Pipe Spec
and Description boxes.
• To edit an existing pipe spec, click a field in a highlighted row and
modify the existing entry as needed.
Related Topics
• Deleting Pipe Specs, page 1273

Process Data Module
Deleting Pipe Specs

Use this procedure to delete a pipe spec from the Pipe Specs supporting table.
Note
• You cannot delete a pipe spec that is currently assigned to lines. First edit
the lines to which the pipes spec that you want to delete is assigned.
Delete a Pipe Spec

1. In the Process Data Module window, click to open the Select Line dialog
box.
5. Select the pipe spec that you want to delete, and click Delete.
6. Repeat the previous step for each pipe spec that you want to delete.
Related Topics
• Defining or Modifying Pipe Specs, page 1272

Process Data Module
Setting the Default Units of Measure

This option enables you to set the desired default units of measure for the currently
active <unit>. The units of measure and accuracy will appear on the process data or
calculation sheets and the specification forms of the selected tags. Remember that
you have to set default units of measure and accuracy separately for each <unit> in
the <plant>.
Set the Default Units of Measure

1. In the main Process Data window, on the File menu, click Units of Measure and
Accuracy.
2. For each desired parameter, select from the appropriate lists:
a. The level of accuracy.
b. The unit of measure, if applicable.
3. Type the appropriate default values for Ambient Temperature, Base Temperature,
Barometric Pressure, and Base Pressure.
4. Click OK.
Related Topics
• Converting Engineering Units of Measure Automatically, page 1276
• Copying Default Units of Measure from Another <Unit>, page 1277

Process Data Module
API 2540 Standard for Liquid Density Calculation

This feature enables you to calculate liquid density at operating and base conditions
in accordance with the API 2540 standard. You can select one of the five product
groups:
• Crude Oils and JP 4.

• Jet Fuels, Kerosenes, and Solvents.
• Gasolines and Naphthenes.
• Lubricating Oils.
• Diesel Oil, Heating Oils, and Fuel Oils.
Calculate Liquid Density According to the API 2540

Standard
2. In the process data sheet, make sure that the Liquid fluid state is selected.
3. Select the API 2540 option from the Fluid name source list.
4. Select the desired product group from the Fluid name list.
5. In the API 2540 STANDARD section, select one of the following:
• Density at reference temperature.
• Specific gravity at reference temperature.
• API settings for: minimum / normal / maximum
6. Enter the desired values in the appropriate fields according to the selected option.
7. If you selected Density at reference temperature or Specific gravity at
reference temperature, do one of the following:
• Type the reference temperature value in the Reference temperature
field.
• Click Default to enter the default reference temperature.
8. Click Calculate Density to calculate the density.
Tip
• The calculated values for Density and Specific Gravity are entered in
the Properties @Minimum, @Normal, and @Maximum fields.

Process Data Module
Converting Engineering Units of Measure

Automatically
Three steps convert one engineering unit to another: first, click on the designated
Units field drop-down list. Then, select the new unit of measure. Finish by choosing
the new unit of measure. After the calculations are over, the results are displayed in
the property record item fields.
Note
• When converting from one engineering unit to another, the data value
changes in accordance with the new engineering unit.
Convert Engineering Units Automatically

1. With a process data sheet open, on the Options menu, click Automatic Unit
Conversion.
2. Click in the Units field of the engineering units you want to convert and select the
new engineering unit of measure.
Tip
• If you convert to Volumetric Flow engineering units, a dialog box
opens where you specify the measuring condition.
3. Select a condition, and click OK to display the results.
Tip
•If you convert to engineering units other than Volumetric Flow, results
are directly displayed in the property record item fields.
4. When finished, click to save the changes.
Related Topics
• Setting the Default Units of Measure, page 1274

Process Data Module
Copying Default Units of Measure from Another

<Unit>
You can define the default units of measure and accuracy by copying the definitions
from another existing unit. You can then make any modification. This shortens the
process of setting new default units of measure.
Copy Default Units of Measure From Another <Unit>

1. In the Units of Measure and Accuracy dialog box, click Copy From.
2. In the Open dialog box, navigate to the source <unit> from which you want to
copy the default data.
3. Click OK to copy the default unit of measure settings.
Related Topics
• Setting the Default Units of Measure, page 1274

Process Data Module
Importing Process Data Files

You can import process data sheets for lines or instruments in .ipd (SmartPlant
Instrumentation process data) format after editing in the Process Data Editor,
provided the line or instrument exists in the SmartPlant Instrumentation database.
The .ipd format allows you to include multiple tags in a single file.
Note
• Use this procedure to import back into SmartPlant Instrumentation process
data for a tag that already exists in your SmartPlant Instrumentation
database.
Import Instrument Process Data Files

1. In the Process Data Module window, on the Actions menu, click External
Process Data.
2. Under Item type, select Instrument.
3. Under Action, select Import.
4. Click Open.
5. In the dialog box that opens, navigate to the folder from which you want to import
the file.
6. Select the desired file and click Open.
Tip
• The software only accepts .ipd files that contain instrument data.
7. Under Search results, select the Select check box beside the instruments that you
want to import.
Tip
• The software only displays instruments that already exist in your
SmartPlant Instrumentation database.
8. Click Apply or OK.

Process Data Module
Import Line Process Data Files

Process Data.
2. Under Item type, select Line.
3. Under Action, select Import.
4. Click Open.
5. In the dialog box that opens, navigate to the folder from which you want to import
the file.
6. Select the desired file and click Open.
Tip
• The software only accepts .ipd files that contain line data.
7. Under Search results, select the Select check box beside the lines that you want
to import.
Tip
• The software only displays lines that already exist in your SmartPlant
Instrumentation database.
8. Click Apply or OK.
Related Topics
• Exporting Process Data Files, page 1280

Process Data Module
Exporting Process Data Files

You can export process data sheets for lines or instruments in .ipd (SmartPlant
Instrumentation process data) format for use with the Process Data Editor. In this
way, you can allow an external party (contractor, engineering company, and so forth)
to modify your process data outside of SmartPlant Instrumentation. The .ipd format
allows you to include multiple tags in a single file.
Export Instrument Process Data Files

Process Data.
2. Under Item type, select Instrument.
3. Under Action, select Export.
4. Click Find, and in the Find Tag dialog box, under Search parameters, from the
Process function list, select a process function other than General, and then click
Find.
5. Select one or more of the tag numbers displayed, or click Select all.
6. Click OK.
7. In the External Process Data dialog box, under Search results, select the Select
check box beside the instruments that you want to export, and click Apply or OK.
8. In the dialog box that opens, navigate to the folder to which you want to export,
type a filename, and click OK.

Process Data Module
Export Line Process Data Files

Process Data.
2. Under Item type, select Line.
3. Under Action, select Export.
4. Click Find, and in the Select Line for Export dialog box, do one of the
following:
• From the Line Type list, select a line type.
• Select the Show all line types check box.
5. Select one or more of the lines displayed, or click Select all.
6. Click OK.
7. In the External Process Data dialog box, under Search results, select the Select
check box beside the lines that you want to export, and click Apply or OK.
8. In the dialog box that opens, navigate to the folder to which you want to export,
type a filename, and click OK.
Related Topics
• Importing Process Data Files, page 1278

Process Data Module
Principles of Generating Process Data Reports

SmartPlant Instrumentation generates process data reports by utilizing eight pre-
defined report templates with which the data of a SmartPlant Instrumentation item is
associated (one for line, and seven for instruments). A SmartPlant Instrumentation
item may be an Instrument or a Line. This is done through the association of a
SmartPlant Instrumentation item, (and its process function - if it is an instrument) to
its pre-defined template.
Each report is made up of a number of sections depending on the process function.

For example: General, Quality of Fluid, Operating Data, Instrument Data, Properties
Flow, Alarm and Trip Settings (for example, pressure & temperature instruments), a
Notes field, and Internal and External Revision fields.
Related Topics
• Generating a Process Data Report for One Instrument or Line, page 1283
• Generating Instrument Reports, page 1285
• Generating Line Reports, page 1284

Process Data Module
Generating a Process Data Report for One

Instrument or Line
You can generate a process data report from an open process data sheet for the
current instrument or line only.
Note
• If you are generating a report for a multi-case instrument tag, this option
prints the current case.
Generate a Process Data Report for the Current Instrument

Or Line
• Open a process data sheet for an instrument.
2. On the Actions menu, click Report.
3. If you open a print preview, do any of the following:
• Click to select a pre-set magnification, or enter a customized one to

fit your needs.
• Click to print the report, or to print all available reports.
Selecting the Printer Setup option from the File menu will allow you
to select the default printer.
• Click to save the report as an external file.
• Click to create or edit local revisions and drawing numbers.
Related Topics
• Generating Instrument Reports, page 1285
• Principles of Generating Process Data Reports, page 1282

Process Data Module
Generating Line Reports

This option allows you to generate process data reports for more than one line and
case.
Generate Line Reports

1. In the Process Data Module window, on the Reports menu, point to Line, and
• To print one process line per page, click Single Line.
• To print three process lines per page, click Three Lines.
Tip
• For lines that are multi-case, this option prints the governing case.
2. In the Select Line for Report dialog box, do one of the following:
• From the Line Type list, select a line type.
• Select the Show all line types check box.
3. Select the lines you want to include in the report.
4. Click OK.
Related Topics

Process Data Module
Generating Instrument Reports

This option allows you to generate process data reports for more than one instrument
and case.
Generate Instrument Reports

1. Start the Process Data module.
2. In the Process Data Module window, on the Reports menu, point to
Instrument, and do one of the following:
• To print one tag per page, click Single Tag.
• To print three tags per page, click Three Tag.
Tip
• For tags that are multi-case, this option prints the governing case.
3. In the Find Tag dialog box search for the tag number according to the criteria you
specify, or click Find for a list that you can choose from.
4. Select the tags to include in the report.
Tip
• For multi-case tags, select each case that you want to include in the
report.
5. Click OK.
Related Topics

Process Data Module
Viewing and Editing Process Data Revisions

You use revisions to keep track of the changes made to your process data. It is
important and useful to have a chronological description of the changes, dates of
change, and a list of persons who approved them. You can add, edit, and delete
revisions. The Process Data module shares the following two types of revisions with
the rest of SmartPlant Instrumentation: local revisions and global revisions. There is
an additional type of revision available only in the Process Data module, which is an
external revision.
Note
• If the process data workflow control has been enabled, only users with
access rights are able to edit the Process Data Revisions.
Working with External Revisions

Use this procedure to add, edit, or delete external revisions in the Process Data
module.
Work With External Process Data Revisions

• Click .
• On the Actions menu, click External Revisions.
serial revisions).
Tip
3. Click New to add a new revision or click in a data field to update existing revision
data in that field.

Process Data Module

Tip
• The By data field contains the current user's initials by default, if
previously defined by the SmartPlant Instrumentation System
Administrator. You can also edit this field if desired.
5. To delete revisions, do the following:
a. Select the revision you want to delete.
b. Click Delete.
Tip
•As a time saver and a forget-me-not precaution, take advantage of
using a default Revision method. The software automatically adds a
new line with the next logical character and date each time you click
New after you select the initial method.
6. When done, click OK.
Note
• If the process data workflow control has been enabled, only users with
access rights are able to edit the Process Data Revisions.
Related Topics
• Viewing and Editing Process Data Revisions, page 1286

Process Data Module
Viewing Process Data History

SmartPlant Instrumentation can indicate process data changes by comparing current
data with the data stored in the audit trail repository for the date range that you
specify. You can choose any or all of the following modes of emphasis:
• You can set a color to emphasize changes on the screen.

• You can set a shade of gray to emphasize the changed data in printed
reports and their previews.
• You can set bold and italic font style for emphasis on the screen and in
print.
Note
• History indication is available only if the System Administrator has
activated the audit trail functionality. When the audit trail functionality is
activated, each time that you save data after making changes, the data is
recorded in the audit trail repository.
View Process Data History

1. In the Process Data module, open the desired tag.
2. On the Options menu, click History Options.
3. Select the date range for data history comparison, by doing one of the following:
• In the From and To data fields, type the appropriate dates.
• Select the appropriate dates using the spinner.
Tip
• To set the To data field value as today's date, click Today.
4. To set a font style to emphasize changes on the screen and in print, do one or both
of the following:
• Select Bold.
• Select Italic.
5. To change the color used to display changes on the screen:
b. In the Color dialog box, choose the color that you require.
dialog box.

Process Data Module
and their previews:
b. In the Grayscale dialog box, slide the bar to the desired position.
c. Click OK to save your new grayscale setting and return to the History
Options dialog box.
dialog box.
8. On the Options menu, click Mark Changes to mark changes in the current
process data sheet for the dates that you specified in the History Options dialog
box. Clear the check box to clear all history indications in the current process
data sheet.
Note
• To refresh the history indication in an open process data sheet, on the
Options menu, clear Mark Changes and then select the option again.

Calculation Module: An Overview

This module provides the capabilities to quickly perform calculations for Cv, noise,
orifice diameter, required discharge area, and other parameters for Control Valves,
Flowmeters, Relief Valves, and Thermowells.
The Calculation module employs the major international standards (ISA, ANSI, API,
ISO, and IEC 60534-2-1 (1998)), to perform complex control valve, flow element,
relief valve, and thermowell calculations quickly and effortlessly.
Calculation data originates mainly from the Process Data module, but also from the
Instrument Index module. You then open the relevant dialog box for the specified
instrument type, (control valve, flowmeter, relief valve, or thermowell), enter all the
parameters required for calculation, and initiate the calculation. After performing the
calculation, the relevant data may then be incorporated into generated reports and
specifications.
Notes
• The software does not support calculations for materials for which the
state is solid/powder, nor for 2-phase flow.
• If you need to add or modify process data, you can do this in the
Calculation module (for details, see Editing Instrument Process Data,
page 1238).
Related Topics

Starting the Calculation Module

This procedure explains how to start the calculation module.
Note
• Before starting this module, check with the Domain Administrator to
ensure that you have been granted appropriate access rights for the tasks
you will carry out.
Start the Calculation Module

• In any SmartPlant Instrumentation window, do one of the following:
• On the SmartPlant Instrumentation toolbar, click .
• Click Module > Calculation.

Viewing and Editing a Calculation Item

Use this procedure to open individual control valve, flowmeter, relief valve, and
thermowell process data sheets for calculation.
Note
• You can also select a batch of instruments of a given process function for
calculation (for details, see Multiple Process Data Cases, page 1260).
Open a Process Data Sheet for Calculation

1. In the Calculation Module window, click Edit > Calculation, and then click one
of the following:
• Flowmeter
• Thermowell
• Control Valve
• Relief Valve
• Type the tag number that you want to calculate.
• Click Find to open the Find Tag dialog box, where you search for the
tag that you want to calculate.
3. Click OK to display the calculation Process Data window for the instrument that
you selected.
4. If you defined multiple process cases, from the Case list, select the case that you
want to calculate.
Related Topics

Fluid Definition
When opening a tag in a process data sheet, you are required to define the fluid for
which a calculation will be carried out. You define the fluid by selecting the fluid
state, entering the fluid name or selecting it from one of the two property databases,
and setting the fluid phase.
Notes
• If this is a new tag that you just created in the Calculation module, the
PROPERTIES section of the window will be blank until you select the
required Fluid State.
• The software does not support calculations for materials for which the
state is solid/powder, nor for 2-phase flow.

Define the Fluid

want to calculate.
3. In the GENERAL section of the process data sheet, from the Fluid state list, do
• Accept the fluid state that you set when you first opened the tag in the
Process Data or Calculation module.
• Select a different fluid state.
4. From the Fluid name source list, select one of the following options, which the
software uses to calculate the item properties:
• Database – activates the Fluid Properties database after selecting the
required fluid from the Name list (for details, see Calculating Physical
Properties, page 1247).
• API2540 – calculates liquid density at operating and base conditions
in accordance with the API2540 standard. To learn how to use the
API 2540 Standard Properties database, see API 2540 Standard for
Liquid Density Calculation, page 1275).
• User-defined– define the fluid properties according to your own
standards.
Tip
• If you selected Solid/Powder as the material state, the Select from list
does not appear.
5. In the Fluid name box, enter the fluid name.
6. From the Fluid phase list, select the required fluid phase.
Related Topics

Performing Calculations
The calculation dialog boxes comprise the essence of the Calculation module. The
values that you enter in these dialog boxes together with the data in the process data
sheets serve as the basis of the calculations displayed on the screen. Calculation item
reports provide information that is more comprehensive.
Tip
• When you open a Calculation Item window and some of the process data
values are not filled in, you can click Highlight Process Data on the
Options menu to highlight all the fields that you must fill in to carry out
the calculation.
Related Topics
• Calculating a Control Valve, page 1306
• Calculating a Relief Valve, page 1303
• Calculating a Thermowell, page 1309
• Preparing for Flowmeter Calculation, page 1296

Preparing for Flowmeter Calculation

Use this procedure to enter the values common to all three types of flowmeter
calculation:
• Orifice flowmeter calculation

• Tube flowmeter calculation
• Restriction device calculation
When you reach the last step of the current procedure, click the link to the procedure
that you require to complete the calculation.
Notes
• By default, SmartPlant Instrumentation updates tag values from the
current unit of measure to their value in a new unit of measure that you
set. If on the Options menu you clear Automatic Unit Conversion, the
software changes the unit of measure without recalculating the values.
Therefore, to protect the integrity of your values, on the Options menu,
click Automatic Unit Conversion.
• To highlight the fields that are required for a calculation, on the Options
menu, click Highlight Process Data.
Prepare for Flowmeter Calculation

1. Open a calculation data sheet for the flowmeter tag that you want to calculate.
want to calculate.
3. Make sure that you enter process data in all of the fields in the data sheet that are
required for calculation.

• Click Actions > Calculate.
6. In the Flowmeter Calculation dialog box, continue with one of the following
procedures:
Related Topics
• Orifice Flowmeter Calculation, page 1297
• Restriction Device Calculation, page 1301
• Tube Flowmeter Calculation, page 1299

Orifice Flowmeter Calculation

This option enables you to calculate orifice flowmeter parameters based on the fluid
state values of the flowmeter and values retrieved from the Process Data module. In a
calculation data sheet for a flowmeter item, you can accept or modify these values, or
enter additional values. Then, in the Flowmeter Calculation dialog box, you
calculate orifice flowmeter parameters for a selected orifice flowmeter and view the
calculation results.
Calculate Orifice Flowmeter Parameters

1. Open the Flowmeter Calculation dialog box for the orifice flowmeter that you
want to calculate.
2. From the Flowmeter type list, select the required orifice flowmeter.
Tip
• The Quarter of Circle Orifice (also known as Quadrant Edge
Orifice) sizing is in accordance with the new edition of British
Standard (BS 1042: Section 1.2; 1989).
3. From the Sub type list, select the required sub type for the current orifice
flowmeter.
4. Type the required values in the fields next to the other two calculation options that
you haven't selected. SmartPlant Instrumentation will then use these values to
calculate the tube flowmeter parameters for the selected option.
5. Under Pipe, view the data in the Material field and the Linear expansion
coefficient field.
Tips
• The data in the Pipe material field is retrieved from the Process Data
module.
• The linear expansion coefficient value for the displayed pipe is the
standard value taken from SmartPlant Instrumentation database.
• From the Linear expansion coefficient list of units of measure, you
can select a required unit of measure for the current linear expansion
coefficient.

6. Under Orifice, from the Orifice material list, select the orifice material.
Tips
• The Orifice material list contains standard options provided with
SmartPlant Instrumentation. If the required orifice material is not in
the list, select from the list the MATERIAL NOT LISTED option
and in the Linear expansion coefficient field type the required linear
expansion coefficient.
• If you select a standard option from the Orifice material list, you
cannot change the linear expansion coefficient value for the displayed
orifice material because this is the standard value taken from
SmartPlant Instrumentation database.
7. In the Diameter of bleed/vent hole field, type the required diameter of the
bleed/vent hole or accept the given value.
Tips
• When calculating the orifice flowmeter parameters for the Steam fluid
state, in the Water in steam, %wt field, type the percentage of water
in steam.
• If the value in the Full scale flow field has been changed, you can
click to get the values from the Process Data module.
8. Under Select calculate field, select one of the following options to calculate the
orifice flowmeter parameters:
• Orifice diameter
• Full scale flow
• Differential range
9. Click Calculate.
10. Examine the calculation results and possible calibration error messages.
Tips
• The units of pressure loss derive from the default units for Differential
Range (Flow) set in the Units of Measure and Accuracy dialog box.
• When sizing flowmeters for Liquids and Water, SmartPlant
Instrumentation checks whether Downstream pressure is greater than
Vapor pressure. If it is, the program continues sizing. If it is not,
critical flow takes place, and the program advises you to check the
input data.
11. To recalculate the orifice flowmeter parameters, enter the new data and click the
Calculate command button.
12. Click Close to return to the calculation data sheet.

Tube Flowmeter Calculation

This option enables you to calculate tube flowmeter parameters based on the fluid
state values of the flowmeter and the values retrieved from the Process Data module.
In a calculation data sheet for a flowmeter item, you can accept or modify these
values, or enter additional values. Then, in the Flowmeter Calculation dialog box,
you calculate the tube flowmeter parameters for a selected tube flowmeter, view and
print out the calculation results.
Calculate Tube Flowmeter Parameters

1. Open the Flowmeter Calculation dialog box for the tube flowmeter that you
want to calculate.
2. From the Flowmeter type list, select the tube flowmeter type.
3. From the Sub type list, select the tube flowmeter sub-type, if available.
4. Type the required values in the fields next to the other two calculation options that
you haven't selected. SmartPlant Instrumentation will then use these values to
calculate the tube flowmeter parameters for the selected option.
5. In the Tube group box, view the data in the Material field and the corresponding
linear expansion coefficient value in the Linear expansion coefficient field.
Tips
• The data in the Material field is retrieved from the Process Data
module.
standard value taken from the SmartPlant Instrumentation database.
coefficient.

6. In the Throat group box, select the required throat material.

Tips
• The Material list contains standard options provided with SmartPlant
Instrumentation. If the required throat material is not in the list, select
from the list the MATERIAL NOT LISTED option and in the
Linear expansion coefficient field type the required linear expansion
coefficient.
• If you select a standard option from the Material list, you cannot
change the linear expansion coefficient value for the displayed throat
material because this is the standard value taken from the SmartPlant
• When calculating the tube flowmeter parameters for the steam fluid
in steam.
click to retrieve the values from the Process Data module.
tube flowmeter parameters:
• Throat diameter
• Full scale flow
• Differential range
8. Click OK to carry out and display the calculation results.
Tips
• The values of pressure loss in the results comes from the default values
for differential range flow set in the Units of Measure and Accuracy
dialog box.
• When sizing flowmeters for Liquids and Water, the software checks
whether Downstream pressure is greater than Vapor pressure. If it
is, the program continues sizing. If it is not, critical flow takes place,
and the program advises you to check the input data.
10. To recalculate the tube flowmeter parameters, enter the new data and then click
Calculate.
11. Click Close to return to the calculation data sheet, where you can click to
generate a report for the current calculation result. Error messages also appear in
a calculation report.
Related Topics
• Preparing for Flowmeter Calculation, page 1296

Restriction Device Calculation

This option enables you to calculate the restriction device parameters based on the
fluid state values of a flowmeter and values retrieved from the Process Data module.
In a calculation data sheet for a flowmeter item, you can accept or modify these
values, or enter additional values. Then, in the Flowmeter Calculation dialog box,
you calculate the restriction device parameters and view the calculation results.
Calculate the Restriction Device Parameters

1. Open the Flowmeter Calculation dialog box for the restriction device that you
want to calculate.
2. From the Flowmeter type list, select Restriction Device.
3. From the Sub type list, select the restriction device sub type.
4. Type the appropriate values in the fields next to the other two calculation options
that you haven't selected. SmartPlant Instrumentation will then use these values
to calculate the tube flowmeter parameters for the selected option.
5. In the Pipe group box, view the data in the Material field and the corresponding
linear expansion coefficient value in the Linear expansion coefficient field.
Tips
• The data in the Pipe material field is retrieved from the Process Data
module.
standard value taken from the SmartPlant Instrumentation database.
coefficient.
6. In the Orifice group box, from the Material list, select the orifice material of the
restriction device.
Tips
• The Orifice material list contains standard options provided with
SmartPlant Instrumentation. If the required orifice material is not in
the list, select from the list the MATERIAL NOT LISTED option
and in the Linear expansion coefficient field type the required linear
expansion coefficient.
• If you select a standard option from the Material list, you cannot
change the linear expansion coefficient value for the displayed orifice
material because this is the standard value taken from the SmartPlant

7. In the Diameter of the bleed/vent hole field, accept the displayed value, or type
the diameter of the bleed/vent hole.
8. If needed, clear the Calculate discharge coefficient check box to enable you to
type the discharge coefficient.
Tips
• If you leave the Calculate discharge coefficient check box selected,
the software automatically calculates the discharge coefficient
according to the preset values.
• When calculating the restriction device parameters for the Steam fluid
in steam.
click to get the values from the Process Data module.
restriction device parameters:
• Orifice diameter
• Full scale flow
• Pressure loss
Caution
• Do not type any values in the field next to the selected calculation
option.
10. Click OK to carry out and display the calculation results.
Tips
• The values of pressure loss in the results comes from the default values
for differential range flow set in the Units of Measure and Accuracy
dialog box.
• When sizing flowmeters for Liquids and Water, SmartPlant
Instrumentation checks whether Downstream pressure is greater than
Vapor pressure. If it is, the program continues sizing. If it is not,
critical flow takes place, and the program advises you to check the
input data.
12. To recalculate the restriction device parameters, enter the new data and then click
Calculate.
13. Click Close to return to the calculation data sheet, where you can click to
generate a report for the current calculation result. Error messages also appear in
a calculation report.

Calculating a Relief Valve

Use this procedure to calculate the sizing of a relief valve. This option works for
single phase fluids only and for all fluid states, with the exception of Solid/Powder.
Notes
software changes the unit of measure without recalculating the values!
Calculate a Relief Valve

1. Open a calculation window for a relief valve item.
want to calculate.
Tip
• Although from the Pressure/Vacuum list, you can select Vacuum
only or Pressure and vacuum, SmartPlant Instrumentation calculates
pressure relief valves only, and not vacuum relief valves or dual mode
pressure/vacuum relief valves. The vacuum service set point value
that you enter beside Valve Set Vacuum is displayed in the process
data report for this instrument, but not in the calculation report.
4. Click .
5. Click to display the Relief Valve Calculation dialog box.
Tip
• The default selection for Use Rupture Disk at the inlet? is No.
Selecting Yes enables the Combination Capacity factor (Kc) field
below.

6. Select user-defined conditions for the relief valve:

• ASME Capacity Certification requirement.
• Sizing basis.
• Rupture Disk at the inlet use.
7. If you are using the Bellows valve style in liquid or water applications, you can
also let SmartPlant Instrumentation calculate the correction factor for back
pressure (Kw) by checking the Calculate check box.
8. Type the required value for Effective coefficient of discharge (Kd) or click
Default to use the SmartPlant Instrumentation default value.
9. If available, type the required value for Combination capacity factor (Kc) or
click Default to use the SmartPlant Instrumentation default value.
10. Click the Calculate command button.
Related Topics
• Calculating a Relief Valve in Case of Fire, page 1305
• Entering Built-Up Back Pressure - Relief Valve, page 1319

Calculating a Relief Valve in Case of Fire

Use this procedure to calculate the sizing of a relief valve in case of fire.
Notes
Size a Relief Valve in Case of Fire

1. With a calculation data sheet open for a relief valve item, scroll to the SIZING
DATA section.
2. From the Case (fire/non-fire) list, select Fire.
3. Enter all the required values, especially the Area and Properties @relieving
condition values. Some properties vary for the Liquid and Gas fluid states.
• Complete the Relief Valve Calculation dialog box, and click the
Calculate command button to get the calculation results.
Tip
• The Sizing basis and other calculation results (the Calculated area,
Selected area, and Orifice designation) appear on specifications based on
SmartPlant Instrumentation library form # 7.
Related Topics
• Calculating a Relief Valve, page 1303

Calculating a Control Valve

This procedure enables you to enter various values for calculating a control valve.
First, you define a CV calculation method and a flow coefficient standard (US or
Europe) of CV sizing, then you select a noise calculation method and a CV body
type. Next, you enter values, perform the calculation, and view the results.
Notes
Calculate a Control Valve

1. Open a control valve calculation item.
want to calculate.
4. Click to save the values.

6. In the Control Valve Calculation dialog box, from the Calculation method list,
select the required calculation method – ISA or IEC.
Tip
• The IEC standard is 60534-2-1 (1998)
7. From the Flow coefficient list, select the required flow coefficient standard of CV
sizing – Cv or Kv.
Tip
• Kv is a European standard flow coefficient available for an IEC CV
calculation method. Kv=Cv*0.865

8. Based on the value that you selected from the Fluid state list on the process data
sheet, do one of the following:
• If you set Liquid or Water, select Masoneilan or IEC from the Noise
calculation method list.
• If you set Gas/Vapor or Steam, select ISA or IEC from the Noise
calculation method list.
9. Enter hydrodynamic noise data as necessary.
Tip
• This option is available only If under State you selected Liquid or
Water, and under Noise Calculation Method you selected IEC.
10. From the Body type list, select the required body type.
11. Enter the required critical flow factor values (Fl, Cf) at minimum, normal, and
maximum control valve coefficients.
12. To define the required pressure drop ratio factor values (Xt) at minimum, normal,
and maximum control valve coefficients, do one of the following:
• To calculate the values automatically, as a function of critical flow,
select Calculate pressure drop ratio factor.
• Type the required values in the @Minimum, @Normal, and
@Maximum fields.
13. Type the Valve style modifier (Fd) value.
14. To set the Relative capacity value, do one of the following:
• Accept the value that SmartPlant Instrumentation calculates based on
the calculation method and on the standard that you selected from the
Flow coefficient list.
• Type the value that you require.
15. Type the required Number of flow passages.
16. Enter the appropriate Valve size and select its unit of measure.
17. To set the outlet pipe diameter, do one of the following:
• Under Outlet pipe diameter, type the value required.
• Click Default to apply the inlet pipe diameter.
18. Click Calculate to carry out and display the calculation results.
19. Examine the figures for results that may have to be re-calculated.

20. To recalculate the orifice flowmeter parameters, enter the new data and click the
Calculate command button.
Tip
• You can calculate a control valve and the relevant parameters even if
the pipe wall thickness is not defined. In this case, Noise is not
calculated and a line of text in Notes section of the calculation sheet
informs you that Noise will not be calculated because Pipe wall
thickness is not defined.
Related Topics
• Recommended Control Valve Characteristic, page 1318

Calculating a Thermowell
A Thermowell, inserted into a pipe, enables you to calculate tag temperature. This
procedure shows you how SmartPlant Instrumentation calculates the maximum
permissible length of a Thermowell. The calculation is based on the maximum
frequency that the Thermowell can withstand. The calculation complies with ASME
PTC 19.3 Standard.
Notes
Calculate the Maximum Permissible Thermowell Length

1. Open a thermowell calculation item.
want to calculate.
4. Click to save the values.
5. Click to open the Thermowell Calculation window.
6. Select the appropriate velocity: minimum, normal, or maximum.
7. Select the required values from the Nominal size of sensing element list.
8. Enter additional values as need, and click Calculate.
9. When done, click Cancel to return to the main calculation window for a
Temperature Item.
Related Topics

Performing a Batch Calculation

This option enables you to perform a calculation for a group of tags, all belonging to
one of the following types: Control Valve, Flowmeter, Relief Valve, or Thermowell.
Notes
• You must define process data before calculation.
• After calculating tags, you can change parameters and then use this
procedure to recalculate.
Perform a Batch Calculation

1. On the Edit menu, point to Batch Calculation, and click the required instrument
type. SmartPlant Instrumentation opens the Batch Calculation window for
instruments of that type.
2. On the Actions menu, click Find Tag.
3. In the Find Tag dialog box, under Search parameters, do one of the following:
• Type and select filter parameters.
• To display all tags, leave the boxes blank.
4. Click Find.
Tips
• For tags for which you defined multiple cases, each case is displayed
in a separate row, which allows you to select one or more cases of a
given tag for calculation.
• To utilize the entire dialog box to display the results, click Show more
search results.
5. Select the tags that you want to calculate, and click OK.
6. In the Batch Calculation window, for each tag for which you want to display or
edit calculation parameters, select the tag and do the following:
a. Click Actions > Type Data.
b. Type and select data you want to change for the calculation, and click OK to
return to the Batch Calculation window.

7. Select the tags that you want to calculate, and do one of the following:
8. For information on items with status Failed, on the Reports menu, click Batch
Calculation Messages.
9. To display process data for a given tag, in the Batch Calculation window, select
a tag, and on the Reports menu, click Process Data Report.
Related Topics
• Generating Calculation Item Reports, page 1315

Calculating Multiple Cases

A given instrument or line is often used for more than one operating service. For
example, a dual-fuel control system might use a single supply line and control valve
to carry various fuels, gas or liquid. Each group of process data settings that you
enter for a given instrument or line is called a case. For more information, see
Multiple Process Data Cases, page 1260.
Use this procedure to calculate multiple cases of a given tag.
Calculate Multiple Cases

1. In the Calculation module, create multiple cases for the tag that you want to
calculate. For details, see Creating Process Data Cases, page 1261.
Tip
• You can create multiple cases in the Process Data module, and later
open the tag in the Calculation module
• .
2. For each case that you want to calculate, do the following:
a. In the GENERAL section of the calculation data sheet, from the Case list,
select the required case.
b. Calculate the case.
c. To generate a calculation report for the current case, on the Actions menu,
click Reports.
Related Topics
• Creating a Hybrid Case, page 1313

Creating a Hybrid Case

For a control valve for which you defined multiple cases, you can create a hybrid case
from the minimum, normal, and maximum flow coefficient values (Cv/Kv) that you
calculated for the various cases. Use this procedure to create such a hybrid case.
Create A Hybrid Case

1. In the Process Data module or in the Calculation module, create multiple cases for
the control valve for which you want to create a hybrid case (for details, see
Creating Process Data Cases, page 1261).
2. Do one of the following to calculate every one of the cases:
• In a Control Valve Calculation window for the given tag, calculate
every one of the cases individually.
• Perform a batch calculation procedure to select and calculate all of the
cases of the given control valve tag.
3. In the main window of the Calculation module, click Edit > Hybrid Case.
4. On the Select Tag dialog box, click Find, and then select the tag for which you
want to create a hybrid case.
5. On the Hybrid Case dialog box, do the following to set values for the hybrid
case:
a. In the Case selection data window, select the value that you want to copy for
the hybrid flow coefficient at minimum, and then click Add Minimum.
b. In the Case selection data window, select the value that you want to copy for
the hybrid normal flow coefficient, and then click Add Normal.
c. In the Case selection data window, select the value that you want to copy for
the hybrid flow coefficient at maximum and then click Add Maximum.
Tips
• Flow coefficients are displayed dynamically as Cv or Kv, depending
on the method of calculation that you set for a given control valve in
the Control Valve Calculation dialog box.
• The software offers you the flexibility to select any value of a case for
any level of the hybrid case — minimum, normal, or maximum.
Related Topics
• Calculating Multiple Cases, page 1312

Principles of Generating Calculation Item Reports

SmartPlant Instrumentation generates Calculation item reports by utilizing two
predefined report templates: Liquid and Gas, with which the data of an instrument is
associated. An instrument may be a Control Valve, Flowmeter, Relief Valve, or
Thermowell. This is done through the association of an instrument, and its process
function to its predefined template defined in the Process Data module.
Each report is made up of a number of sections depending on the process function.

For example: the heading, information gathered from the Process Data module, data
entered via the Body Type dialog box of the Calculation module, the Results and
Coefficients section, and an area provided for Notes and Revisions.
Caution
• When generating a report, only those items that include the saved
calculation results appear on the list in the Find Tag dialog box.

Generating Calculation Item Reports

Use this procedure to do the following:
• Generate calculation reports for instrument tags.

• Add, edit, and delete calculation report revisions.
• Assign, edit, and delete external drawing numbers assigned to the
calculation reports.
Generate a Calculation Item Report

1. In the Calculation Module window, on the Reports menu, click the report that
you require.
Tip
• You can also generate a calculation item report when a calculation
item window is open. On the module toolbar click , or on the
Actions menu, click Report.
Tip
2. In the Find Tag dialog box, under Search parameters, do one of the following:
• Type and select filter parameters.
• Leave the boxes blank to display all tags.
3. Click Find.
4. Select the tags for which you want to generate a report, and click OK.
5. At the prompt, click Yes to display the calculation item report print preview. You
can do any of the following:
• Adjust the zoom level.
• Save this report as an external file.
• Perform, edit, or delete a revision on the calculation report.
• Assign, edit or delete an external drawing number for the calculation
report.
Related Topics
• Calculation Revisions, page 1316

Calculation Revisions
The revision feature is used to keep track of the changes made to SmartPlant
Instrumentation reports and items, including calculations. It is important and useful
to have a chronological description of the changes, dates of change, and a list of
persons who approved them. Use this procedure to add, edit, and delete revisions.
Maintain Calculation Revisions

1. Generate a report preview for the calculation (for details, see Generating
Calculation Item Reports, page 1315).
2. In the Print Preview: Calculation Report window, on the print preview toolbar,
click .
P0, P1, P2... for preliminary revisions or 0, 1, 2 /A, B, C etc. for normal serial
revisions).
Tips
• If you select any revision method besides Other, SmartPlant
Instrumentation successively numbers each new revision.
4. Click New to add a new revision data or click Edit to update an existing revision
data line.
Tip
• The By data field contains the current user's initials by default, if the
System Administrator has defined it as such.
6. Under Drawing number, accept the default drawing number, or edit as required.
7. To delete revisions do the following:
a. Select the revision you want to delete.
b. Click Delete.
8. Click OK.
Note
• You can also maintain revisions in batch mode using global revisions.

Creating New Tags in the Calculation Module

You can create new tag numbers directly in the Calculation module, without having
to open the Instrument Index module.
Create a New Tag in the Calculation Module

1. In the Calculation Module window, on the Edit menu, point to Calculate, and
then click one of the following:
• Flowmeter
• Thermowell
• Control Valve
• Relief Valve
2. On the Enter Tag Number dialog box, type the name of the new tag number, and
click OK.
and click OK.
• Accept the displayed loop number and click OK.
• Type the loop number that you need and click OK.
• To create the tag number without a loop association, click Cancel.
5. On the Tag Number Properties dialog box, on the General tab, enter the
appropriate values.
6. Enter power supply values.
7. If the Process Data dialog box opens, select a fluid state and then click OK.
• In the process data sheet, enter and save the relevant process data values.
Related Topics
• Working With Instrument Tags in the Process Data Module, page 1236

Recommended Control Valve Characteristic

This feature allows you to calculate the recommended control valve characteristic.
You can determine whether Linear or Equal Percentage valve is more suitable for a
specific valve application.
Note
• Make sure that you enter the required pressure drop, pump drop, and
system loss values in the process data sheet before performing this
procedure.
Calculate the Recommended Control Valve Characteristic

1. Open the required calculation item sheet for a control valve calculation.
2. On the Actions menu, click the Recommended Valve Characteristic option.
3. Enter the required Critical value or click Default to utilize the default value.
4. Click Calculate.
Tip
• SmartPlant Instrumentation calculates the recommended valve
characteristic and displays the result (Linear or Equal %) both in this
dialog box and the Notes window.

Entering Built-Up Back Pressure - Relief Valve

The option enables you to enter a built-up back pressure value, which is taken into
account for calculation when sizing the relief valves. The result is displayed in the
NOTES section of the calculation data sheet, under General Notes.
Take Built-Up Back Pressure Into the Calculation Account

1. With a calculation data sheet open for a relief valve item, on the Actions menu,
click Enter Built-up Back Pressure.
2. In the Built-up Back Pressure dialog box, type the required value, select the unit
of measure and click OK.

Dimensional Data for Piping Module

The Dimensional Data for Piping (DDP) module enables you to store and manage
three levels of dimensional data: default, working, and vendor. This structure
represents the natural flow of information and activities related to dimensional data
processing.
You can store and maintain default instrument dimensional data by classifying it per
group, manufacturer, or process connection.
The DDP module also enables you to store and maintain dimensional data received
from a vendor. This data can also be classified per group, manufacturer, or process
connection.
Most significantly, the DDP module provides the means to transfer, store, and
maintain certified vendor dimensional data for your instruments. This certified
vendor data will then be transferred to your Working data which you use for the
actual instruments in your database.
You can use the DDP module to transfer external dimensional data to your
SmartPlant Instrumentation database and export of dimensional data from your
database to an external 3-D piping design application.
In addition, the DDP module enables you to generate and print out various
dimensional data reports that facilitate your dimensional data management. These
reports can help you keep track of suspected data, data status, default dimensional
data, and vendor dimensional data, and so forth.
Note
• The Dimensional Data for Piping module is available only if it is included
in the software license that you purchased from Intergraph.

Principles of the DDP Module

This section provides general guidelines and a recommended flow of activities for the
DDP module.
At the initial stage, you should select the appropriate instrument types and define their
instrument profiles so that dimensional data handling is clearly specified. Based on
the existing dimensional library and practices of dimensional data processing, you
also classify the instruments by their type and pre-assigned DDP group by defining
this group in the instrument type profile.
Next, define basic instrument parameters in the Instrument Index module or

Specifications module, including the instrument manufacturer, model, and process
connections.
Group definition coupled with basic information enables the dimensional data
designer to provide piping designers with preliminary dimensions filled from the
standard dimensional data library based on specified basic instrument parameters.
When requests for quotations are issued and vendor bids are evaluated, more detailed
dimensional information supplied by vendors and manufacturers in electronic or hard
copy form can be automatically imported or manually entered as vendor data.
This vendor data lets the designer re-evaluate dimensional data, if desired, and issue
vendor-certified dimensional data to the piping.
Starting from the moment when the preliminary dimensional data was selected for the
instruments, you are able to release this information to the piping design. This can be
done in two forms — electronically or by providing a hard copy. Electronic form is
an automatic transfer and processing of the structured data to a 3-D CAD system.
Alternatively, dimensional data report or dimensional data sheet can be printed out
and transferred to the piping design department in paper form.
The status of the dimensional data design can be tracked through the instrument
status. You can also view the history information for the selected instrument
modifications.
Controlling the modifications of critical definitions, such as a DDP group, instrument

type, model, and process connections provides the means to manage and keep track of
suspected data during the whole life cycle of the dimensional data design.

Starting the DDP Module

Use this procedure to start a DDP (Dimensional Data for Piping) module session.
Note
• The DDP module is available only if it is included in the software license
that you purchased from Intergraph.
Start the Dimensional Data for Piping Module

• Click Modules > Dimensional Data.

Preliminary Procedures
There are two preliminary procedures that you have to carry out before you start
entering dimensional data. These procedures are:
• Defining the setting for the Dimensional Data for Piping module. To
carry out this procedure, you must log on to the Administration module as
System Administrator and enter the desired data on the Dimensional Data
Settings Dialog Box.
• Associating an Instrument Type with a DDP Group, page 1331

Defining the Process Connection Class

This procedure enables you to define the desired process connection class / rating.
This represents the value of the maximum in-line pressure that the process connection
can withstand.
Define the Process Connection Class / Rating

1. In the Dimensional Data for Piping Module window, on the Tables menu, click
Process Connection Classes.
2. To create a new process connection class, click New.
3. Type the appropriate process connection class name and description.
Tip
• You cannot delete a process connection class if it is associated with
default, working, or vendor data.
Note
• The connection class name may not be longer than 9 characters so that the
DDP Export Utility can include it in the output file.
Related Topics
• Defining the Connection End Preparation, page 1325
• Principles of the DDP Module, page 1321

Defining the Connection End Preparation

This option enables you to define the desired process connection end preparation.
Define a Process Connection End Preparation

Process Connection End Prep.
2. To create a new process connection end preparation, click New.
3. Type the appropriate process connection end preparation name, design code, and
description.
Note
• The end preparation name may not be longer than 9 characters so that the
DDP Export Utility can include it in the output file.
Related Topics
• Defining the Process Connection Class, page 1324

Additional Settings
You also have to make some additional settings for the dimensional data. These
settings include the following:
• Equipment and equipment type

• Instrument manufacturer
• Instrument model
You access the appropriate dialog boxes from the Dimensional Data for Piping
Module window and by selecting the desired command on the Tables menu. These
definitions are actually made in the Instrument Index module and can be accessed
from the DDP module too.
For a detailed explanation about the above-mentioned features, see the Instrument
Index module documentation.

Defining Dimensional Groups

Defining the dimensional groups is the step in storing and managing dimensional
data. You need dimensional groups to store, display, and manage default, working
and vendor dimensional data. Moreover, instrument types are also associated with
dimensional groups. Hence, new tag numbers whose instrument type is associated
with a particular dimensional group will contain dimensional data and this
dimensional record will be displayed in the Working Data window.
Note
• The Domain Administrator first needs to import DDP library data,
including default groups.
Define a Dimensional Group

1. In the Dimensional Data for Piping window, on the Tables menu, click
Dimensional Groups.
2. To create a new dimensional group, in the Dimensional Groups dialog box, click
New.
3. Under Dimensional Group, type the group name.
4. Under Description, type the group description.
5. Select the 3 Points and/or 4 Points check boxes, depending on how many
connection points you want to define.
6. In the CAD Code field, type the desired CAD code.
7. To define the current group parameters, click Properties. See Defining
Dimensional Group Properties, page 1328 for more details.
8. To assign a picture to the selected group, do the following:
a. Under Picture, click Assign.
b. In the Select Group Picture dialog box, navigate to the desired file, and click
Open.
9. To assign a dimensional data sheet form to the current group, under Form, click
Assign.
Related Topics
• Defining Dimensional Group Properties, page 1328

Defining Dimensional Group Properties

This procedure enables you to define dimensional data parameters for a given
dimensional group. These parameters then appear in the Default Data window, the
Working Data window, and the Vendor Data window, as well as in the Dimensions
section of the Add Data, and Edit Data dialog boxes.
Thirty parameters are available for each dimensional group. You create an active
parameter by typing its description, selecting it for use, and setting its allowed
minimum value to be zero or greater than zero.
Define Dimensional Group Properties

Dimensional Groups.
Tip
• At this point, you can modify general properties of the dimensional
group (for details, see Defining Dimensional Groups, page 1327).
2. Click Properties.
3. In the Dimensional Group Properties dialog box, under Description, type the
desired parameter description.
4. To include this parameter in the selected dimensional group, click Select.
Tips
• To select all thirty parameters, select the Select all check box.
• You cannot clear a Select check box for a parameter for which the
dimensional group is assigned.
5. If you require the selected parameter to have a value greater than zero, select the
Release if Zero check box.
Tip
• Clearing Release if Zero does not prevent you from placing zeros in
this field, but rather prevents the release of dimensional data by
disabling the Ready for Release option.
6. Click OK to accept your definitions and return to the Dimensional Groups
dialog box.
Related Topics
• Defining Dimensional Groups, page 1327

Duplicating a Dimensional Group

This option enables you to create a new dimensional group based on the same group
parameters as the selected group.
Duplicate a Dimensional Group

1. With the Dimensional Groups dialog box open, highlight the desired group.
2. Click Duplicate to duplicate the selected group.
3. Click OK to accept your definitions, save the group data, and close the dialog
box.

Assigning Dimensional Data Forms

Assigning a dimensional data form to a dimensional group consists of two stages:
• Assigning a .psr file to a dimensional data form

• Assigning the dimensional data form to a dimensional group
Assign a PSR File to a Dimensional Data Form

Dimensional Data Sheet Forms.
2. To create a new dimensional data form, do the following:
a. Click New.
b. Type the form name and description in the appropriate fields.
3. Select the dimensional data form to which you want to assign a .psr file, and click
Assign.
4. In the Select Group Form dialog box, navigate to the desired .psr file and click
Open.
5. In the Dimensional Data Forms dialog box, click OK.
Assign a Dimensional Data Form to a Dimensional Group

1. Click Tables > Dimensional Groups.
2. Select the group to which you want to assign a dimensional data form, and under
Form, click Assign.
3. In the Assign Dimensional Data Form dialog box, select a form, and click OK.
Related Topics
• Defining Dimensional Groups, page 1327

Associating an Instrument Type with a DDP Group

This option enables you to set the default dimensional group for new tag numbers that
are associated with dimensional data. Note that this procedure is performed in the
Associate an Instrument Type With a Dimensional Group

1. In the Instrument Index Module window, on the Tables menu, click
Instrument Types.
2. From the Process function list, select the process function.
3. In the data window, select the instrument type.
4. Click Profile.
5. On the General tab, under Dimensional data, do the following:
a. Select the Include dimensional data check box to associate the selected
instrument type with dimensional data.
b. From the Group Name list, select the dimensional group with which
dimensional data will be associated by default.
6. Click OK to close the Instrument Type Profile dialog box and then click OK to
close the Instrument Types dialog box.

Managing Vendor Data

Vendor data is used for data validation and verification purposes of dimensional data
for piping design. You use Vendor data to certify the Working data prior to its
release to piping.
Instead of inserting raw Vendor data manually, use the Import Utility to import a
large amount of raw vendor information. After importing the Vendor data, you revise
the raw vendor data to assign it to a dimensional group, verify the instrument tags,
and, if desired, manually modify the vendor data details.
Sometimes multiple records for the same instrument can exist. This can happen if
you import vendor data from several manufacturers. You can copy vendor data to the
Working data if the manufacturer, model, the Dimensional Group, and the process
connection values match the Working data values.
You can also indicate whether the imported data has been copied to the Working data.
You can reset this indication every time import is performed for a specific record,
thus creating a clear indication if the latest information has been copied to the
Working data.
Managing Vendor data involves editing it and entering new dimensional vendor data
for a selected instrument.
Vendor data is displayed in the Vendor Data window.
Display and Access Vendor Data

1. With the Dimensional Data for Piping Module window open, click or click
Vendor Data on the View menu.
2. In the Select Dimensional Group dialog box that opens, select the desired
dimensional group and click OK.
The Vendor Data window opens displaying the existing vendor data records.
• You can customize the display and layout of the data in the Working
Data window.9

Entering Vendor Data

This feature allows you to enter vendor data manually. It is useful when adding a
few records. If you want to enter numerous records, use the Import Utility.
Enter Vendor Data Manually

1. Open the Vendor Data window and do one of the following:
• Right-click anywhere in the Vendor Data window and click New
Vendor Data on the shortcut menu.
• Click New Vendor Data on the Actions menu.
2. Beside Tag number, click Browse and then do the following:
a. In the Enter Tag dialog box, type in the desired tag number and click OK or
click Find to find the desired tag number.
b. In the Find Tag dialog box, enter the desired search parameters and click
Find to find the desired tag number.
c. Under Search Results, highlight the desired tag number and click OK to
return to the New Vendor Data dialog box where this tag number is displayed
in the Tag name field.
3. Select the desired instrument manufacturer from the Manufacturer list.
4. Select the desired instrument model from the Model list.
5. Type the desired full and dry weight values and select the weight unit of measure
from the Weight UOM list.
6. In the Revision field, type the revision number as needed.
7. Enter the default INLET and OUTLET values: type in the Size values and select
the appropriate values from the Class and End preparation lists.
8. Enter the default #3 and #4 process connection values if needed: type in the Size
values and select the appropriate values from the Class and End preparation
lists.
9. In the Dimensions section, type in the default dimensional properties. Note that
the Dimensions field names appear as you have defined them in the Dimensional
Groups dialog box.
10. Type the Full and Dry Weight values.
11. Select the weight unit of measure from the Weight UOM list.
12. Click OK to save the data and close the dialog box.

Entering Vendor Data

This feature allows you to enter vendor data manually. It is useful when adding a
few records. If you want to enter numerous records, use the Import Utility.
Enter Vendor Data Manually

1. Open the Vendor Data window and do one of the following:
• Right-click anywhere in the Vendor Data window and click New
Vendor Data on the shortcut menu.
• Click New Vendor Data on the Actions menu.
2. Beside Tag number, click Browse and then do the following:
a. In the Enter Tag dialog box, type in the desired tag number and click OK or
click Find to find the desired tag number.
b. In the Find Tag dialog box, enter the desired search parameters and click
Find to find the desired tag number.
c. Under Search Results, highlight the desired tag number and click OK to
return to the New Vendor Data dialog box where this tag number is displayed
in the Tag name field.
5. Type the desired full and dry weight values and select the weight unit of measure
from the Weight UOM list.
6. In the Revision field, type the revision number as needed.
8. Enter the default #3 and #4 process connection values if needed: type in the Size
lists.
Groups dialog box.

Managing Working Data

This feature enables you to store and manage Working dimensional data. The
Working Data window displays existing Working dimensional data for tag numbers
entered in the Instrument Index module. Once you create a new tag number whose
instrument type is associated with dimensional data and a dimensional group, the
dimensional data for this tag will be displayed in the Working Data window.
You can also add more records to the Working data by copying from Vendor data or
by copying preliminary default data from the Default Library if the Dimensional
Group, manufacturer, model, and the process connection values match the Working
data.
Managing Working data involves editing it, modifying the data status, entering the
piping design area, and finally generating and printing out a Dimensional Data Sheet
for a particular instrument.
You access Working data in the Working Data window.
Display And Access Working Data

1. With the Dimensional Data for Piping Module window open, click or click
Working Data on the View menu.
2. In the Select Dimensional Group dialog box, highlight the desired dimensional
group and click OK.
The Working Data window opens displaying the existing working data records
for the instruments whose instrument type is associated with dimensional data and
the current dimensional group.
Tip
• You can customize the display and layout of the data in the Working
Data window.

Editing Working Data

You can edit the working data either in the Working Data window or in the
Working Data Properties dialog box. Note however, that not all the fields are
accessible for editing in the Working Data window. Therefore, you should edit the
data in the Working Data Properties dialog box.
Edit Working Data

1. With the Working Data window open, highlight the desired tags and do one of
the following to open the Working Data Properties dialog box:
• Right-click the selected tag numbers and click Working Data
Properties on the shortcut menu.
• Click Working Data Properties on the Actions menu.
2. Enter the default INLET and OUTLET values and from the Units of Measure list
choose the required unit of measure.
3. Type in the Size values and select the appropriate values from the Class and End
preparation lists.
4. Enter the default #3 and #4 process connection values and from the Units of
Measure list choose the required unit of measure.
preparation lists.
6. Under Dimension values, type the default dimensional properties. Note that the
Dimensions field names appear as you have defined them in the Dimensional
Groups dialog box.

Piping Design Area

This option enables the piping designers to enter 3-D CAD design model or piping
design area for the selected instrument. You can select multiple records from the
Working Data window and enter or modify the piping design area as needed.
Enter the Piping Design Area

1. In the Working Data window, highlight the desired instruments and do one of the
following:
• Right-click the selected instruments and click Piping Design on the
shortcut menu.
• Click Piping Design on the Actions menu.
• b>Piping Design Area dialog box opens.
2. Type in the desired design area name in the Design Area field and click Save.
3. Select the Copy to all tags check box to copy the design area name you have just
entered to all the selected instruments or click Preview or Next to open the
previous or the next record.
Note that all the other fields in this dialog box are read-only.

Copying Working Data to Default Data

This option enables you to copy working dimensional data to the Default Library.
The copied record includes all its definitions: the dimensional group, manufacturer,
model, and the process connection values.
You can select only a single instrument at a time. This instrument will serve as a
default example. For each selected instrument, the software can then search a default
record with corresponding dimensional group, manufacturer, model, and process
connection values.
Copy Working Data to the Default Library

1. In the Working Data window, highlight the instruments whose working data you
want to copy to the Default Library and then do one of the following:
• Right-click the selected tag numbers and click Copy Working to
Default on the shortcut menu.
• Click Copy Working to Default on the Actions menu.
2. Examine the information in this view-only dialog box and click Copy to copy the
Working data to the Default Library.
Note that the Copy button will be disabled if no matching values are found.

Copying Default Data to Working Data

This feature allows you to copy records with preliminary default dimensional data
into the working data of the selected instrument. Copying default data from the
Default Library is only possible if the dimensional group, manufacturer, model, and
the process connection data match the working data.
You can select numerous instruments whose default data you want to copy. For
every selected tag number, the software can then search for values matching the
working data. Only after matching dimensional group, manufacturer, model, and
process connection values are found, the software copies the default data.
After successfully copying default data, the status of the copied records is set as
Preliminary and its revision number as 0 (zero). The revision number will then be
incremented from the last preliminary status by one, e.g., Preliminary 1.
Copy Default Data to Working Data

1. In the Working Data window, highlight the tag numbers whose default data you
want to copy and then do one of the following:
• Right-click the selected tag numbers and click Copy Default to
Working on the shortcut menu.
• Click Copy Default to Working on the Actions menu.
The software searches for instruments with matching dimensional group,
manufacturer, model, and process connection values. Once matching values
are found, the Copy Dimensional data from Default Data dialog box opens:
2. Examine the displayed data:
• Instruments selected— this field shows how many tag numbers you
selected whose default dimensions you want to copy.
• Instruments found— this field shows how many tag numbers in the
working data match the values in the default data.
• Instruments with incomplete data— this field shows how many tag
numbers in the working data have incomplete data.
A progress bar opens under the data status indication showing you the data
copying progress. For every instrument with matching values, default
dimensional values are copied.

3. Click Copy to copy the data.

copying progress.
Note the following possibilities:
• If the instrument contains no working data, the copied default dimensions

will be marked as ready for release.
• If the instrument contains working data, you will be prompted if you want
the working data to be overwritten by the default data. The copied
dimensions will be marked as suspected.
• If the instrument contains working data whose status is certified, a
warning message appears informing you that the working data for this
instrument is certified by vendor. You will be prompted whether you
want the working data to be overwritten by the default data. If you choose
to overwrite it, the dimensional data status will marked as suspected.

Copying from Vendor Data to Working Data

This feature allows you to copy certified vendor data to the working data of a
selected instrument. Copying vendor data is only possible if the dimensional group,
manufacturer, model, and the process connection data match the working data.
You can select numerous instruments for which you want to copy vendor data. For
each selected instrument, the software can then search for matching dimensional
group, manufacturer, model, and process connection values. Once matching values
are found, the software opens the Copy from Vendor to Working dialog box that
displays the number of instruments selected and the number of instruments found
with matching values.
Copy From Vendor Data to Working Data

1. In the Working Data window, highlight the tag numbers for which you want to
copy vendor data and then do one of the following:
• Right-click the selected tag numbers and click Copy from Vendor to
Working on the shortcut menu.
• Click Copy from Vendor to Working on the Actions menu.
The software searches for instruments with matching dimensional group,
manufacturer, model, and process connection values. Once matching values
are found, the Copy from Vendor to Working dialog box opens:
2. Examine the displayed data:
• Instruments selected— this field shows how many tag numbers you
selected for which you want to copy vendor dimensions.
• Instruments found— this field shows how many tag numbers in the
working data match the values in the vendor data.
• Instruments with incomplete data— this field shows how many tag
numbers in the working data have incomplete data.
copying progress. For every instrument with matching values, vendor
dimensional values are copied including the vendor revision number. This
data will be marked as copied to working data.
3. In the Set Status section, select the dimensional data status of the working data as
desired: Preliminary, Design, or Certified.

4. Click Copy to copy the data.

Note the following possibilities:
• If the instrument contains no working data and all desired dimensional

data is defined, the data will be marked as ready for release.
• If the instrument contains working data, you will be prompted if you want
the working data to be overwritten by the vendor data. The copied
dimensions will be marked as suspected data and copied from vendor.
Notes
• When you copy the vendor data to the working data of a specific tag, the
working data revision number is incremented automatically (Modify
Status and Revision dialog box).

Modifying Working Data Status

This option enables you to display and modify the current status of Working
dimensional data for the selected instrument. Three status stages are available:
Preliminary, Design, and Certified. Within each status, a revision number (from zero
to 99) indicates the progress of the dimensional data handling. An instrument status
can be described as a combination of these two parameters: the status of the Working
dimensional data and the revision number, for example PRELIMINARY 1 or
DESIGN 5.
Note that when you modify the data status because of any dimensional data
management, you will be able to reset the suspected data flag and mark the data as
correct and ready for release to piping.
Caution
• The Working data status cannot be changed to CERTIFIED unless a
purchase order has been issued and entered in the Instrument Index or
Note also that you can select multiple instruments for status modification.
Modify Working Data Status

1. In the Working Data window, highlight the instruments whose working status
you want to modify and then do one of the following:
• Right-click the selected instruments and click Modify Status and
Revision on the shortcut menu.
• Click Modify Status and Revision on the Actions menu.
2. On the Status tab, click Set status and select the desired status from the Status
list. The list displays the selected status and becomes unavailable until you click
Set status again.
3. Click Raise to next revision to raise the revision number if needed.
4. Click in the Description text box and type a short status description.
5. Select the Reset Suspect Flag check box to remove the suspected data status for
the current instrument.
6. Click Save to save your settings.
7. Click Next or Previous to display the next or previous selected tag number.
8. Click OK to close this dialog box or click the History tab to open the History tab
folder.

Managing Default Dimensional Data

This feature enables you to store and manage preliminary dimensional data for your
instrumentation design. You can use standard (default) dimensions of known
manufacturers who are likely to supply the instruments. This Default data is stored in
the Default Library which allows you browse through the data, modify it, and copy it
to the Working data as needed. Once sufficient Default data is available, the DDP
designer can provide this data to the piping designers for their preliminary design.
The Default data will then be replaced or modified according to the actual
dimensional data received from the manufacturers.
Caution
• Note that you must first define the appropriate dimensional group, the
process connection data, and the manufacturer before you can start
entering default data. Remember that only one set of default dimensional
data can exist for a domain.

Entering Data into the Default Library

Use this procedure to add default dimensional data for a given dimensional group.
Enter Default Data Into the Default Library

1. With the Dimensional Data for Piping Module window open, click Default
Library on the View menu or click on the toolbar.
2. In the Select Dimensional Group dialog box, highlight the desired group and
click OK.
Caution
• If you select All Groups, you will not be able to edit the data and no
process connection values will be displayed.
3. Click Actions > New Default Data.
4. In the Default Data Properties dialog box, select the desired instrument
manufacturer from the Manufacturer list.
7. Enter the default #3 and #4 process connection values if needed: type the Size
lists.
Groups dialog box.

Editing Default Data

Use this procedure to edit default data for a given dimensional group.
Edit Default Dimensional Data

1. Open the Default Data window for the desired dimensional group (for details, see
Entering Data into the Default Library, page 1345).
2. Right-click the entries that you want to edit, and on the shortcut menu, click
Default Data Properties.
5. Enter the default INLET and OUTLET values and from the Units of Measure list
choose the required unit of measure.
preparation lists.
7. Enter the default #3 and #4 process connection values and from the Units of
Measure list choose the required unit of measure.
preparation lists.
Groups dialog box.
10. Type the Full and Dry weight values.

Customizing the Default Library Display and Layout

You can customize the display and layout of the data in the Default Library. The
following options are available:
• Sorting the data

• Filtering the data
• Determining the fields to be displayed
Generating a Dimensional Data Sheet

This feature enables you to produce a dimensional data sheet for a selected
instrument. The dimensional data sheet can complement or serve as an alternative for
the automatic 3-D CAD piping design.
A dimensional data sheet includes general tag information, dimensional data of the
specific group, and the graphic schematic or detailed presentation of the instrument
and its dimensions.
Generate a Dimensional Data Sheet

1. In the Working Data window, highlight the desired instrument and do one of the
following:
• Right-click the selected instrument and click Dimensional Data Sheet
on the shortcut menu.
• Click Dimensional Data Sheet on the Actions menu.
2. In the Dimensional Data Sheet window that opens, you can do the following:
• Enter or modify the values in the dimensional data sheet fields. Click
in the appropriate field to type a value or select a value from a list.
Note that not all the fields are accessible for editing.
• Manage and enter dimensional data sheet revisions. Click to open
the Revisions dialog box where you can enter and modify revisions.
• Save the dimensional data sheet as an external file, click .
• Print out the dimensional data sheet, click .
Tip
• You can also preview and print dimensional data sheets in batch mode.
For details, see Printing Dimensional Data Sheets, page 1351.

Tracking the Data Status History

This option allows you to track the Working data status history.
Track the Working Data Status History

1. With the Modify Status dialog box open, click the History tab to open the
History tab folder.
2. Examine the information and click Edit to type in any appropriate description if
necessary.

Generating DDP Reports

You can generate and print out the following reports.
Report Description
Group List Contains a detailed list of all existing Dimensional Groups and their
parameters, such as group name, description, associated picture file,
cad group identifier, and dimensional parameter definitions.
Dimensions Displays a detailed list of all dimensional data for each instrument
List that is associated with dimensional data.
Suspected Data Presents a list of all the instruments for which dimensional data must
List be re-evaluated due to some changes made to the instrument
definitions. For example, if the process connection or any other key
parameter has been changed, the data is marked as suspected. This
report shows the cause of the suspected data flag.
Status History Contains all the dimensional data status history per all Tags whose
dimensional data status has been changed.
Suspected Data Displays a list of all Tags whose dimensional data was or still is
History marked as suspected. The report also presents the reasons for the
suspected data indication.
Default Contains a list of general default definitions for the elements of the
Library List Default Library.
Default Lists detailed definitions of the elements in the Default Library.
Dimensional
Data
Vendor Contains a detailed list of vendor dimensional data.
Dimensional
Data
Data Sheets Allows you to display data sheets associated with specific tag
numbers.
Empty Sheet Allows you to display field names and dimensional properties only,
Forms without displaying the values. An empty sheet form also displays a
dimensional group diagram.
• With the Dimensional Data for Piping Module window open, on the
Reports menu, click a report menu command.

Generate A Suspected Data List, Status History, Or

Suspected Data History Report
1. With the Dimensional Data for Piping Module window open, on the Reports
menu, click the appropriate menu command.
2. In the Report Parameters dialog box, in the Report Per section, select if you
want the report to include data for all the instruments associated with dimensional
data or just for the selected groups.
3. In the Show data for section, select if you want the report to be generated for the
current <plant> or the current <unit>, and click OK.
Related Topics
• Printing Dimensional Data Sheets, page 1351
• Printing Empty Sheet Forms, page 1352

Printing Dimensional Data Sheets

Use this procedure to open a print preview of one more dimensional data sheets and
print dimensional data sheets in batch mode.
Batch preview and printing is available either from the Dimensional Data for Piping
Module window or from the Working Data window.
Print Dimensional Data Sheets From the Dimensional Data

for Piping Module Window
1. Click Reports > Data Sheets.
2. In the Select Tags for Printing Dimensional Data Sheets dialog box, find the
desired instruments.
3. Under Search results, select source tag numbers.
4. Click OK.
Print Dimensional Data Sheets From the Working Data

Window
1. In the Working Data window, select one or more instruments.
• On the Actions menu or shortcut menu, click Print Dimensional Data
Sheets.
• On the Working Data window toolbar, click .
Tip
• Clicking only prints the instrument list displayed in the Working
Data window.
Related Topics
• Generating DDP Reports, page 1349
• Printing Empty Sheet Forms, page 1352

Printing Empty Sheet Forms

Use this procedure open a print preview and print one more empty sheet forms. An
empty sheet form is a form that does not contain any values. Such a form only
displays the names of the fields and dimensional properties, and also display the
dimensional group diagram. Each dimensional group is associated by default with
one sheet form.
Print Empty Sheets Forms

1. Click Reports > Empty Sheet Forms
2. In the Print Empty Sheet Forms dialog box, select one or more dimensional
groups.
3. Click OK.
Related Topics
• Generating DDP Reports, page 1349
• Printing Dimensional Data Sheets, page 1351

SmartPlant Instrumentation and InfoMaker

Using InfoMaker, you can customize SmartPlant Instrumentation spec pages and
reports. Customization includes emphasizing particular fields or data, inserting a
graphic other than the default, or using a different color, and so forth. You can also
perform more complex customizations such as selecting tables, creating and selecting
reports, or defining the SmartPlant Instrumentation database profile. For complete
information on InfoMaker functions, see the InfoMaker documentation.
Important
• You must have working knowledge of the SmartPlant Instrumentation
database table structure to be able to customize reports. For further
information, please refer to the SmartPlant Instrumentation Data
Dictionary, which is available upon request.
• The latest InfoMaker Service Pack is available from the Sybase Web site
(accessible via the InfoMaker Help menu). To find out which version of
InfoMaker you require for the current version of SmartPlant
Instrumentation, refer to the Compatibility Matrix on the Intergraph PPM
Support Web site at http://crmweb.intergraph.com/ecustomer_enu.
Related Topics
• Enabling InfoMaker for SmartPlant Instrumentation Common Tasks, page
1356
• SmartPlant Instrumentation Database Structure, page 1354
• Working with Libraries and Reports Common Tasks, page 1360

SmartPlant Instrumentation Database Structure

The following discussion is a very broad explanation of the internal structure of the
SmartPlant Instrumentation database. It is not meant to be a database primer, but
rather an aid for the user to have a better understanding of what tables to select when
creating a customized report.
Two of the important features of the SmartPlant Instrumentation database are its
hierarchical and relational structure.
Hierarchical Structure of the Database

At the top of the database hierarchy are schemas. The SmartPlant Instrumentation
database has separate schemas for the Administration module and for the rest of the
SmartPlant Instrumentation modules. At the next level, below the schema, are tables,
and below the tables are table columns, which are represented in the interface as data
fields.
Notes
• In the Administration module, with the Domain Definition dialog box
open, you specify the schema as the login name.
• The schema name always appears prefixed to the table name separated by
a period (.). If, for example in SmartPlant Instrumentation, you chose
WORK_1 as your Login Name (schema name), and in InfoMaker you
select CABLE as your table name, the full table name is
WORK_1.CABLE

Relational Structure of the Database

The relational structure of the database is concerned with the associations (or links)
that are defined between tables and columns.
For example, if you want to create a customized cable report that includes only the
cable's actual description, color, manufacturer, and model, you need to know that
these are columns that are associated with their respective tables. The following is a
summary for this example, taken from the SmartPlant Instrumentation Data
Dictionary.
Full Table Name Table Description Table Column Display Name

Name
work_1.cable Information stored cable_desc Cable
about the existence Description
of a cable
work_1.cable_color The list of colors cable_color_name Cable Color
available for all
cables
work_1.cable_mfr The data structure cable_mfr_name Cable
for a list of cable Manufacturer
manufacturers
work_1.cable_mfr_mod The model of the cable_mod_name Cable Model
cable
Note
• The SmartPlant Instrumentation Data Dictionary is available upon request,
and contains complete information about tables and columns.
Related Topics
1356
• SmartPlant Instrumentation and InfoMaker, page 1353

Enabling InfoMaker for SmartPlant Instrumentation

Common Tasks
These tasks deal with creating a database profile in InfoMaker and defining
InfoMaker as the default report generator.
Create a SmartPlant Instrumentation Database Profile

Use this procedure to create a database profile in InfoMaker so that you automatically
connect to your database when opening InfoMaker. InfoMaker automatically creates
database profiles for various types of data. However, you may find that your
parameter settings do not point to the SmartPlant Instrumentation data source. In
such cases, you need to enter the proper profile settings to connect to the SmartPlant
Instrumentation database. For details, see Create a SmartPlant Instrumentation
Database Profile, page 1357.
Display SmartPlant Instrumentation Data Automatically

Use this procedure to to display all rows or a particular SmartPlant Instrumentation
database table. For details, see Display SmartPlant Instrumentation Data
Automatically, page 1358.
Display SmartPlant Instrumentation Data by Executing an SQL

Statement
Use this procedure to to display selected rows or a particular SmartPlant
Instrumentation database table by executing an SQL statement. For details, see
Display SmartPlant Instrumentation Data by Executing an SQL Statement, page
1358.
Define InfoMaker As the Default Report Generator

After you complete the installation of InfoMaker, you can define InfoMaker as your
default report generator. After that, you can open InfoMaker from SmartPlant
Instrumentation. For details, see Define InfoMaker As the Default Report Generator,
page 1359.
Related Topics

Create a SmartPlant Instrumentation Database Profile

1. With the main InfoMaker window open, click .
2. On the Database Profiles dialog box, select ODB ODBC.
3. Click New.
4. In the Database Profile Setup dialog box, on the Connection tab, do the
following:
a. In the Profile Name box, type the profile name.
b. From the Data source box, select the SmartPlant Instrumentation database
you want to connect to.
c. In the User ID box, type the target schema logon name.
d. In the Password box, type the target schema logon password.
Tips
• If you want to connect to the Admin schema of the demo database, the
default value for both the User ID and Password properties is
IN_DBAMN.
• If you want to connect to the Domain schema of the demo database,
the default value for both the User ID and Password properties is
demo.
5. When finished, click OK to reopen the Database Profiles dialog box, where the
current SmartPlant Instrumentation database profile is selected by default.
6. Select the database profile and click Connect to make the connection with the
profile.
Related Topics
1356

Display SmartPlant Instrumentation Data Automatically

1. After connecting to the SmartPlant Instrumentation database, on the main
InfoMaker window menu bar, click Tools > Database Painter.
2. In the tree view, double-click the appropriate SmartPlant Instrumentation database
profile.
3. Double-click the Tables folder to display all the tables that exist in SmartPlant
Instrumentation.
Tip
• If the Domain schema name precedes most of the table names, you are
connected to the Admin schema.
4. To display all rows of a particular table, right-click a table, and then, on the
shortcut menu, click Edit Data > Grid.
Related Topics
1356
Display SmartPlant Instrumentation Data by Executing an

SQL Statement
1. After connecting to the SmartPlant Instrumentation database, on the main
InfoMaker window menu bar, click Tools > Database Painter.
2. In the tree view, double-click the appropriate SmartPlant Instrumentation database
profile.
3. To display selected rows of a particular table, in the ISQL Session pane (bottom
right pane by default), click the ISQL Session tab.
4. Type a Select statement.
Tip
• If you are connected to the Admin schema of SmartPlant
Instrumentation and want to select rows from a Domain schema table,
you must include the Domain schema name in the SQl Statement using
the following syntax <Domain schema name>.<SQL Statement>;
5. After typing the SQL statement, do on of the following:
• Select the statement and press Ctrrl+L.
• Right-click the statement, and then, on the shortcut menu, click
Execute.

Define InfoMaker As the Default Report Generator

1. In SmartPlant Instrumentation, on the menu bar, click File > Preferences.
2. On the Preferences dialog box, in the left pane, click Report Generator.
3. From the Report generator list, select InfoMaker.
4. Beside the Report generator program path box, click Browse to navigate to the
location of the InfoMaker executable file on your computer, and click OK.
Related Topics
1356

Working with Libraries and Reports Common Tasks

These tasks deal with creating new libraries in InfoMaker and opening SmartPlant
Instrumentation reports saved as .psr files. You might need to create a new library to
manage reports or save queries. Also, you can create new browsers for adding in the
Browser module of SmartPlant Instrumentation.
Create an InfoMaker Library

Use this procedure to create an InfoMaker library for SmartPlant Instrumentation
reports. Also, before building a query, you need to create a backup library. The
software automatically puts all queries that you save into this library. For details, see
Create an InfoMaker Library, page 1361.
Create an InfoMaker Library and Report for Editing PSR Files

Use this procedure to create an InfoMaker library and report. Then, In SmartPlant
Instrumentation, you can open this report from within an InfoMaker library and
report. For details, see Create an InfoMaker Library and Report for Editing PSR
Files, page 1362.
Open a PSR File from an InfoMaker Library and Report

Use this procedure to open an existing .psr file with SmartPlant Instrumentation data
from the pre-defined InfoMaker library and report. SmartPlant Instrumentation
reports can be saved as external .psr files, edited in InfoMaker, and then opened in
SmartPlant Instrumentation from within an InfoMaker library and report. For details,
see Open a PSR File from an InfoMaker Library and Report, page 1363.
Save a Customized Report in InfoMaker

Use this procedure to save a customized SmartPlant Instrumentation report in
InfoMaker. When a customized report satisfies your requirements, you can save it in
any one of several formats such as .psr (PowerSoft report), Excel, text file, and so
forth.. For details, see Save a Customized Report in InfoMaker, page 1363.
Build a Query
This procedure describes how to build a query, which is necessary for exporting
SmartPlant Instrumentation data to an external file that you can use to generate an
InfoMaker report. The customized report created in this procedure is limited to only
one data source and presentation style with no other adornments. This example uses
information from the Instrument Index module to generate a report for the description
of a set of instruments, including their service and function type. For details, see
Build a Query, page 1364.


Use this procedure to create a custom browser that you can then add in SmartPlant
Instrumentation. For details, see Create a New Browser for SmartPlant
Instrumentation, page 1366.
Related Topics
1356
Create an InfoMaker Library

2. On the New dialog box, click the Library tab.
3. Double-click the Library icon .

4. On the Specify New Library dialog box, type the desired path and name of the
library (.pbl) file, or click the ellipsis beside the Library box to navigate to the
file.
5. Click Finish.
Related Topics

Create an InfoMaker Library and Report for Editing PSR

Files
Note
• Before performing this procedure, make sure that InfoMaker is defined as
your default report generator. For details, see Define InfoMaker As the
Default Report Generator, page 1359.
1. From any SmartPlant Instrumentation window, on the menu bar, click File >
Generate Reports to open InfoMaker.
2. In InfoMaker, create a new library. For details, see Create an InfoMaker Library,
page 1361.
3. Define a report as follows:
a. Click File > New.
b. On the New dialog box, on the Object tab, select Freeform and click OK.
c. In the Freeform Report Generator dialog box, select External and click
Next.
d. On the Define Result Set dialog box, in the Name box, type a name for the
result description, and click Next. The name cannot contain spaces.
e. On the Select Color and Border Settings dialog box, click Next.
f. On the Ready to Create Freeform dialog box, click Finish.
g. If the Database Profiles dialog box opens, follow the procedure Create a
SmartPlant Instrumentation Database Profile, page 1357.
4. In the Report window, do the following to save the report that you just defined:
a. Click File > Save.
b. On the Save Report dialog box, under Reports, type a name for the report.
c. Make sure that under Libraries the correct library is selected and then click
OK.
Tip
• To organize your display of .psr files in InfoMaker, create various
reports within various libraries.
5. In the Report window, click File > Open File.
6. On the Select a File Name dialog box, navigate to the .psr file that you want to
Related Topics

Open a PSR File from an InfoMaker Library and Report

Note
• Before performing this procedure, make sure that InfoMaker is defined as
your default report generator. For details, see Define InfoMaker As the
Default Report Generator, page 1359.
1. From any SmartPlant Instrumentation window, on the menu bar, click File >
Generate Reports to open InfoMaker.
2. In InfoMaker, on the menu bar, click File > Open.
3. On the Open dialog box, do the following:
a. Under Library, select the appropriate library.
b. Under Object Type, select Reports.
c. Under Object, select the desired report from the list.
d. Click OK.
4. Click File > Open File.
5. On the Select a File Name dialog box, navigate to the .psr file that you want to
Related Topics
Save a Customized Report in InfoMaker

1. In SQL Preview mode, click File > Save Rows As.
2. On the Save As dialog box, do the following:
a. Navigate to the folder where you want to save the report.
b. In the File name box, type the name of the file (without an extension).
c. From the Save as type list, select the file format that you require (for
example, PowerSoft Report).
3. Click Save to save your report and return to the Preview mode.
Related Topics

Build a Query
2. On the New dialog box, click the Database tab.
3. Double-click Query to open the Select Tables dialog box.

4. Select the desired tables by clicking with the mouse button.
5. When finished, click Open to display the Query window.

6. Click View > Table Layout.
7. Select the desired columns as shown in the following example.

8. Click to view the available data as shown.
9. Click the close box to close the Preview window and return to the Query
window.
10. If you want to select additional tables, click to reopen the Select Tables dialog
box.
11. Perform additional steps as desired. These can include the following:
• Using the Join function to rebuild links manually between table rows.
• Defining a sort sequence for the retrieved data.
• Using a Where condition to filter the retrieved data.
Note
• Full details of these procedures are beyond the scope of this topic. For
further information, see to the InfoMaker documentation.
12. To view details of your query, click the Syntax tab. The following screen shot
shows an example of a query.

13. When finished, save your query by doing one of the following:
• Click .
• Click File > Save Query.
14. On the Save Query dialog box, in the Queries box, type a name for your query.
Notes
• Your query name must not include any spaces.
• The software saves the query in the backup library that you defined. For
details, see Create an InfoMaker Library, page 1361.
Related Topics
• Create an InfoMaker Library, page 1361

1. Click File > New.
2. On the New dialog box, on the Library tab, double-click the library icon and
create a .pbl library where you can group newly-created browsers.
3. Reopen the New dialog box and click the Object tab.
4. Select Grid for the report layout and click OK.
5. In the Grid Report Generator Wizard, select SQL Select, and then complete
the Wizard steps.
6. On the Select Tables dialog box, select the tables that you require.
a. Select fields from the tables.
b. Select a primary key from each table.
8. Click the Return icon to open the Select Color and Border Settings dialog
box, where you can set the browser colors. After setting the browser colors, click
Next and then click Finish to display the Report preview window.
9. In the report preview window, click the Data Source icon to reopen the Select
window.


a. On the Design menu, click Convert to Syntax to convert the selected fields
from the graphic mode to the syntax mode.
b. Remove all the quotation marks (") from the displayed SQL statement.
The following example shows how the final SQL statement should appear:
SELECT component.cmpnt_name,
component.cmpnt_serv,
loop.loop_name,
loop.loop_serv, component.cmpnt_id,
loop.loop_id
FROM component,
loop
WHERE (loop.loop_id=component.loop_id )
loop
11. Return to the report preview window and do the following:

a. Set the header font style to MS Sans Serif, 8 point, Bold.
b. Protect fields that you want to reserve for internal use (do not protect the
primary keys) by the protected column attribute to 1 (one).
c. For each header name, use the following naming convention: <column
name>_t. For example, cmpnt_name_t.
d. For each field name, use the following naming convention: <column name>.
For example, cmpnt_name.
e. Delete the flag_color field, and also delete all the columns that contain
primary keys (the primary keys remain in the SQL statement).
f. On the General tab, from the Units select list, select Inches.
12. Save the report data in one of the following ways:
• Without previewing, click Save As to save the report in the specially
created .pbl library.
• Save the report as a stand-alone .psr file.
13. If you saved the report in the .pbl library, do the following:
a. Copy the .pbl file to another location, preferably to the SmartPlant
Instrumentation home folder, and then change the file extension from .pbl to
.pbd.
b. In the [CUSTOM] section of your Intools.ini file, add the following line
(including the full pathname of the .pbd file): LibraryList=XYZ.pbd.
Related Topics

SmartPlant Instrumentation and MicroStation: An Overview
SmartPlant Instrumentation and MicroStation:

An Overview
MicroStation is a three-dimensional CAD software package which includes features
to allow the interchange of design data with SmartPlant Instrumentation. SmartPlant
Instrumentation supplies the design data, and generates a schematic drawing
associated with a specific loop, component or block by means of MicroStation.
Notes
• SmartPlant Instrumentation use of the term Block corresponds to the term
Cell in MicroStation.
• This section explains how MicroStation works with SmartPlant
Instrumentation. All the topics in this section require a basic level of
familiarity with MicroStation. Refer to the MicroStation user manual for
detailed explanations of MicroStation functionality.

System Requirements
Minimum hardware and software requirements must be met before installing
MicroStation on your computer.
• 16 MB RAM in addition to SmartPlant Instrumentation installation

requirements.
• 75 MB of free hard disk space.
Refer to your MicroStation user manual, Getting Started for more detailed
requirements for running the MicroStation software package.

MicroStation Settings
Once MicroStation has been successfully installed, a number of modifications still
have to be made to ensure compatibility with SmartPlant Instrumentation. The
modifications are done directly through the options on the menu bar of the main
MicroStation window.
Define MicroStation Settings

1. Click Workspace > Preferences.
2. On the Preferences dialog box, under Category, select Memory Usage and
ascertain that your settings are as follows:
Setting MicroStation 95 or SE MicroStation J
Max. Element Cache 8000 10240
Resource Cache 24 1024
Undo Buffer 256 2048
Font Cache 30 256
Conserve Memory Cleared Cleared
Disable OLE Automation Cleared Cleared
Tip
• When working with MicroStation 95, SE or J, the Conserve Memory
check box must be cleared.

3. Under Category, select Operation and ascertain that your settings are as follows:
Setting Value
Locate Tolerance 10
Pointer Size Normal
Pointer Type Orthogonal
Display Levels Names
Immediately Save Design Changes Selected
Save Settings on Exit Cleared
Compress Design on Exit Cleared
Enter into Untitled Design Selected
Reset Aborts Fence Operations Selected
Level Lock Applies for Fence Operations Selected
Use Semaphore File for Locking Cleared
Tip
• When working with MicroStation, the Immediately Save Design
Changes check box must be selected to enable viewing or generation
of loop drawings if MicroStation was not previously launched.
4. Under Category, select Tags and ascertain that your settings are as follows:
Setting Value
Prompt on Duplicate Tag Sets Cleared
Use Design File Tag Sets by Default Cleared
Place Tags in Same Graphic Group Cleared
5. When finished, click OK to return to the main MicroStation window.

Setting the SmartPlant Instrumentation Parameters

for MicroStation SE/J
To generate CAD loop drawings using MicroStation, the temporary folder path
setting on the General page of the SmartPlant Instrumentation Preferences dialog
box must not exceed 42 characters. This means for example that you cannot use the
default path C:\Program Files\SmartPlant\Instrumentation\TEMP.
If you installed MicroStation SE or J, you can enter file paths with spaces (long file
paths) on the Loop Drawings > CAD File Locations page of the SmartPlant
Instrumentation Preferences dialog box. This requires that you specify the
MicroStation version to work with long file paths.
Enable MicroStation SE/J to Work With Long File Paths

1. In SmartPlant Instrumentation, click File > Preferences.
2. Expand the hierarchy Loop Drawings > General.
3. From the MicroStation version list, select MicroStation SE/J.

Creating Tag Sets

In MicroStation you group tags into tag sets. Use this procedure when you need to
create a new tag set from scratch. To save time it is recommended that you duplicate
and rename tag sets instead of creating new ones. You can save tag sets to a tag set
library file and then copy them to other files as desired
Create Tag Sets

1. In the main MicroStation window, click Element > Tags > Define.
2. In the Tag Sets window, under Sets, click Add.
3. On the Tag Set Name dialog box, type the desired name, for example
instrument.
4. Click OK to accept the value and reopen the Tag Sets window.
5. Repeat the above steps to add another tag set named loop.
6. In the Tag Sets window, under Sets, select instrument.
7. Under Tags, click Add.
8. On the Define Tag dialog box, type tag_loc. This value represents the tag
location.
9. Repeat the above steps to add another property named tag_num.
Tip
• The text in the Default Tag Value pane must be typed in upper case.
10. In the Tag Sets window, under Sets, select loop.
11. Under Tags, add the following properties:
• loop_func (Loop Function)
• loop_type (Loop Type)

Exporting Tag Sets

Exporting Tag Sets allows you to save new tag sets in a library file. This makes it
more convenient to import the exported tag set.
Export Tag Sets

1. In the Tag Sets window, select the Set (for example, instrument) to export.
2. Click File > Export > Create.
3. On the Export Tag Library dialog box, click OK to return to the Tag Sets
window.
4. Repeat the previous steps to create a tag library for the loop set.
Note
• The next time you open a MicroStation session, select Import to display
the latest tag set definition.

Importing Tag Sets

This procedure explains how to retrieve a previously created tag set from a tag library
file.
Import a Tag Set

1. In the Tag Sets window, click File > Import.
2. On the Open Tag Library dialog box, select the desired library and click OK to
open the Import Sets dialog box.
3. Click OK to reopen the Tag Sets window with the set and its associated tags
displayed.
4. To add another set, to the Tag Sets window, repeat steps 1 and 2, but this time
select instrmnt.tlb on the Open Tag Library dialog box.

Linking a Tag to a Drawing Element

This procedure explains how to create a drawing element and associate it with the tag
definitions that you defined in the Define Tag window.
Link a Tag to a Drawing Element

1. In the main MicroStation window, click Tools > Main > Tags.
2. In the Tags window, select, for example, the Place Block tool from the Main tool
palette to draw a rectangle on the MicroStation desktop.
3. Select Attach tags to an element to open the Attach Tags dialog box.
4. On the Attach Tags dialog box, place the cursor on the rectangle that you drew in
step two:
5. Double click the cursor to open the Attach Tags dialog box.
Tip
• If you want to display another tag set, such as the loop tag set, open
the Attach Tags dialog box and repeat steps 3 - 5.
6. Click OK to display the tags on the desktop.
7. Move the tags, without clicking, to the desired location. Below is a typical
example.
8. Click the left mouse button when the tag position is appropriate.
The tag is now associated with the design element (the rectangle in this case).

Creating a Cell Library

This procedure explains how to create a cell library to which you can add cells (for
details, see Add a Cell to the Cell Library, page 1380).
Create a Cell Library

1. In the main MicroStation window, click Element > Cells to open an unnamed
Cell Library window.
2. Click File > New to open the Create Cell Library dialog box.
3. Click OK to reopen the Cell Library window.
4. Drag the Cell Library window as far off the desktop as possible and store it for
future use. The window will be recalled later when you add a cell to it.

Fencing Elements for a Cell

You can fence elements to globally perform actions on them in batch mode. This
allows you to identify the cell in a cell library to be recalled as many times as needed.
This enables you for example to edit the cell, or combine it with other cells to create a
larger design.
Fence Elements for a Cell

1. Set all the elements on the desktop, and select the fence icon on the main tool
palette.
2. Fence the desired elements.
Tip
• Fencing an area automatically opens the Cell Library window. Prior
to saving a cell in the cell library you need to define the cell origin.

Defining the Cell Origin

You define a cell origin to set the position of a graphic object in a design. This will
subsequently and automatically entail the Create action in the Cell Library window.
Define the Cell Origin

1. Select the Define Cell Origin icon from the Main tool palette.
2. Click the cursor on the lower left corner of the desktop.
Tip
• Now that the cell origin is defined, you have to accurately set the cell
origin coordinates (for details, see Defining the Coordinates of the Cell
Origin, page 1380).

Defining the Coordinates of the Cell Origin

This procedure explains how to generate the cell origin coordinates for a graphic
element placed on the desktop.
Define the Cell Origin Coordinates

1. With the cell origin defined (typically, on the lower left corner of the desktop),
click to open the AccuDraw window.
2. Set the X and Y coordinates to 0.0000.
3. Select all the check boxes.
Add a Cell to the Cell Library

1. Open the Cell Library window.
2. Click Create to open the Create New Cell dialog box.
Tip
• Both Name and Description must be defined otherwise the software
does not perform the create action.
3. Click Create to display the new cell name and description in the data window of
the Cell Library window.
Related Topics
• Previewing a Cell, page 1381

Previewing a Cell
When several cells are listed in the cell library, it is recommended that you preview a
cell to make sure that you have selected the correct one. This procedure explains how
to generate a thumbnail view of the cell.
Preview a Cell
• Open the appropriate cell library, and click the cell that you want to
preview.
A thumbnail view of the cell appears in the Print Preview pane.

Displaying a Cell on the Desktop

This procedure explains how to take a previewed cell and place it on the desktop.
This may also be useful when you want to relocate a cell to achieve a different design
than the current one.
Display a Cell on the Desktop

1. Open the Cell Library window, click a cell to preview it, and then click
Placement.
2. On the Main tool palette, click the Place Active Cell icon.
Tip
• A tool from the View Control bar may be needed to display your Cell.
3. Move the mouse to the desired location on the desktop.
4. Click to pin the cell to a selected location.
5. If you need another copy of the same cell, repeat steps 3 and 4.
6. When done, right click.
Tip
• You can also add cells from other libraries, print/plot your design, and
so forth. Refer to the MicroStation user manual to learn more about
the available MicroStation options.

Generating a Report Using MicroStation

You can generate SmartPlant Instrumentation reports using MicroStation from either
SmartPlant Instrumentation or MicroStation. When you generate the report from the
MicroStation environment you need to manually open the desired report file using the
Open dialog box in MicroStation. However, the recommended method is to generate
the reports from the SmartPlant Instrumentation Loop Drawings module.

SmartPlant Instrumentation KKS Overview

SmartPlant Instrumentation supports KKS naming conventions for process-related
identification of the following item types:
• Instruments (including functional requirement tags and virtual tags)

• Loops
• Lines
• Process equipment
• Control system tags
• Panels (plant panels only, belonging to panel categories available in the
Convention list in the Naming Conventions dialog box)
• Cables (plant cables only)
For each of these item types, the following KKS segment properties are available:
KKS Level Property Description

Name
Total Plant Total Plant Single character (numeric or
alphabetic).
System Code System Code Prefix Single digit.
(optional)
System Three-character alphabetic
Classification key, selected from a
standard list, that
represents the type of
system in use the plant.
System Two-digit number with
Numbering leading zeros.
Equipment Unit Equipment Unit Two-character alphabetic key, selected
Code Classification from a standard list, that represents the
type of equipment within the system
used for measuring or monitoring the
system, or the type of measurement
circuit (level, flow, and so forth).
Equipment Unit Three-digit number with
Equipment Unit Optional character
Additional Code (alphabetic).

KKS Level Property Description

Name
Component Component Classification Two-character alphabetic key, selected
Code from a standard list, that represents the
type of component.
Component Two-digit number with
Numbering Application Area Single digit (0-9) representing the
Element (for application area of a cable (voltage
cables only) levels).
Cable Number Two-digit number.
(digits 2 and 3)
Cable Suffix The fourth position of the
cable number can be a
numeric or alphabetic
character, mostly used for
grouping purposes.
Total Plant
This property is a single character (numeric or alphabetic).
System Code
System Code Prefix (optional) — Single digit.
System Classification — Three-character alphabetic key, selected from a standard

list, that represents the type of system in use the plant.
System Numbering — Two-digit number with leading zeros.
Equipment Unit Code

Equipment Unit Classification — Two-character alphabetic key, selected from a
standard list, that represents the type of equipment within the system used for
measuring or monitoring the system, or the type of measurement circuit (level, flow,
and so forth).
Equipment Unit Numbering — Three-digit number with leading zeros.
Equipment Unit Additional Code — Optional character (alphabetic).

Component Code
Component Classification — Two-character alphabetic key, selected from a
standard list, that represents the type of component.
Component Numbering — Two-digit number with leading zeros.
Numbering Element (for cables only)

Application Area — A single digit (0-9) representing the application area of a cable
(voltage levels).
Cable Number — Two-digit number.
Cable Suffix — The fourth position of the cable number can be a numeric or
alphabetic character, mostly used for grouping purposes.
Note
• SmartPlant Instrumentation does not auto-increment the numbering of the
various segments in the process identification.
Process Identification Prefix and Notation Characters
Process Identification usually uses the equal (=) character as a prefix. Identification
may include space (" ") or pipe (|) characters.
Examples
For a medium voltage panel, only the System Code segments might be required in
most cases. Thus a suitable KKS name would be 1 0BBA01, where the values are
designated as follows:
Property Value Description

Total Plant 1
System Code Prefix 0
System Classification BBA MV distribution board
System Numbering 01
Equipment Unit Classification (Not used)
Equipment Unit Numbering (Not used)

For a flow transmitter, the KKS identification 1 0PAE01 CF013 – B01 could be
used, where the values are designated as follows:
Property Value Description

Total Plant 1
System Code Prefix 0
System Classification PAE Circulating (main cooling) water pump
system
System Numbering 01
Equipment Unit Classification CF Open flow loops
Equipment Unit Numbering 001
Component Classification -B Transducer
Component Numbering 01
Notes
• When creating a new instrument, the associated loop inherits the relevant
segments of the instrument names and vice versa. Also, KKS naming is
propagated to cables when you connect them to panels that already have
KKS naming. Cables inherit the KKS naming of the panel whose system
code is first in alphabetic order.
• Not all items use all the described segments. For example, DCS and PLC
panels do not use equipment unit code and component code segments.
Marshaling racks, junction boxes, process equipment, and lines do not use
component code segments.
Requirements for Importing Line Data in KKS Mode

When importing line data to the Instrument Index module, you need to perform the
following procedure to enable the use of KKS segments in the import link.
1. In the Import Utility, select the desired import link and open the Link Properties
dialog box.
2. Click the Style tab.
3. Select the Display all fields check box.
Related Topics
• Propagation of KKS Names in SmartPlant Instrumentation, page 1388
• SmartPlant Instrumentation KKS Overview, page 1384

Propagation of KKS Names in SmartPlant

Instrumentation
When an item, such as a loop, has KKS naming, and you perform tag number
association, the software automatically propagates the loop naming to the associated
tags. The software also propagates panel naming when you connect a cable to a
panel.
Target Inherited Components of Possible Example of Source

Item Type Target Item Name Source Item Name
Item Type
Instrument All populated segments of the Loop =1 LBA01 CF001
loop number
Cable All common and used process Panel =1 LBA01 CF001
identification segments of the 4120 (4120 is the cable
panel (the first system numbering, which is
classification which comes in entered manually)
alphabetic order)
For a specific example of loop naming propagation, see Example of KKS Naming
Propagation, page 1389.
Notes
• The software performs propagation according to hard-coded rules. Name
segments that are not included in a propagation rule remain blank.
• On connecting a cable to a panel, the KKS naming is propagated to the
cable. On disconnection, the cable retains the name received by
propagation until you reconnect it.
Related Topics

Example of KKS Naming Propagation

This scenario shows how SmartPlant Instrumentation propagates loop naming to its
tag when you create a loop in the Domain Explorer and associate a tag with this
loop.
1. In the Domain Explorer, create a new loop using the following KKS settings:
2. Click OK to open the Instrument Number dialog box, where you can create a
new instrument tag number. At this stage, the software has already propagated all
the loop naming settings.
3. Accept the propagated settings, and then, define the component classification as
shown (-B 01):

4. Click OK to display the Select Instrument Type dialog box, where the software
displays the instrument type that matches the component classification key value
in the instrument tag name:
Tip
• To display the matching instrument types, you must first populate the
Instrument Type supporting table with applicable KKS entries.
5. Select the instrument type and click OK to display the loop and its tag in the
Domain Explorer:
Related Topics
• Rename an Item in KKS Mode, page 1393

Scope of KKS Issues for the Current SmartPlant

Instrumentation Version
The current version of SmartPlant Instrumentation supports KKS naming conventions
for process-related identification of most instrumentation items.
Out of Scope Issues

The following issues are not supported in the current development:
• Integrated environment operations

• Configuration rules for KKS establishments
• Grouping of items hierarchically by a common physical system
classification or equipment unit
• Point of installation and location identification
• Signal identification (signal area, signal applications, and gated signals)
• Typical loop management
• Loop naming propagation to instruments when renaming the loop
• Searching for items using KKS segments as search parameters. You can,
however, search for items using wild cards in the Find Items dialog box,
in the box where you can enter the full item tag name.
• Telecom options (partially supported, can create telecom tags).
• Macro expansion when importing from SmartPlant P&ID
• Management of KKS classification keys
Notes
• The software does not automatically increment numbering properties of
KKS segments.
• When creating multiple items, the names of all the items, other than the
first one, appear in the interface as zeros, for example: '00000', even
though KKS naming is actually applied to them. In such cases, the user
needs to rename the individual items by changing the appropriate
numbering segment, after which the software displays the item names
correctly.
• The software does not reset cable names when you disconnect one of the
cable sides from a panel that originally propagated its naming to the cable.
• When renaming a panel, the software does not update the cable naming
according to KKS rules.

• If you change the naming convention, it only affects new items. Existing
items retain their names according to the previous naming convention.
• The software does not make any validations between the item type and the
KKS code.
• The software does not validate imported data. For this reason, you need to
check the source data before importing it. It is recommended to use the
comparison list before importing line, equipment, or wiring data. For
instrument tags and loops, you can map the appropriate segments of the
source data to the KKS data segments in SmartPlant Instrumentation.
• Moving a loop to another plant group or associating an instrument or a
loop with another loop does not affect the tag naming.
• The software correlates instrument types by name using the KKS
component classification. The KKS seed database includes a
representative list of instrument types, which you should review and
update as needed prior to project execution.
Related Topics

Rename an Item in KKS Mode

1. In the Domain Explorer, select an item such as an instrument and do one of the
following:
• On the item's Properties dialog box, beside Number (for an
instrument), click the ellipsis button .
• Right-click the item, and on the shortcut menu, click Rename.
Tip
• The name of the field representing the item name varies according to
the item type.
2. Type appropriate values in each segment of the item tag.
Tips
• Press the Tab key to move from one segment box to another.
• Move the mouse pointer over a segment to display a Tool Tip
indicating the name of the segment.
• Click the ellipsis button beside a Classification segment to display

the appropriate Classification dialog box, from which you can select
suitable values. If you have already typed part of the key prior to
clicking the ellipsis button, the Classification dialog box opens at the
appropriate place in the list.
• When a numeric segment accepts more than one digit, if you enter
fewer digits than the maximum, the software automatically adds
leading zeros to the value you typed. You cannot remove the leading
zeros from the segment.
Related Topics

Import Utility: An Overview

The Import Utility enables you to import data from most common database formats
into a selected table or module in the SmartPlant Instrumentation database. The
Import Utility also provides you access to database platforms other than your own
(Oracle, SQL Server, or Sybase Adaptive Server Anywhere).
To import data, you need to have some knowledge of the SmartPlant Instrumentation
database structure and concepts such as naming conventions. You should also know
how to connect to the source and target databases (for example, correct ODBC
profile, or native connection to the database).
The Import Utility is essential because inserting data into SmartPlant Instrumentation
is not a trivial matter. Since the SmartPlant Instrumentation table structure is
relational, there is a constant maintenance of integrity constraints. You have to keep
the relation between the tables and create unique values in the primary key. You
therefore have to insert data into SmartPlant Instrumentation only through the
SmartPlant Instrumentation interface or by using the Import Utility.
Related Topics
• Data Import Process, page 1492
• General Import Prerequisites, page 1489
• Import Links: An Overview, page 1409

Database Platform Support

The Import Utility provides you with inherent support of the following database
platforms and database file formats:
• Oracle (only if you have selected Oracle as your current database platform
during Setup)
• SQL Server (only if you have selected SQL Server as your current
database platform during Setup)
• Sybase Adaptive Server Anywhere (only if you have selected Sybase
Adaptive Server Anywhere as your current database platform during
Setup)
• Microsoft Access
• DBF (SmartPlant Instrumentation comes shipped with .dbf files. These
files appear in the path <SmartPlant Instrumentation home folder>Import.
You can use these files as examples when learning how to import source
data from .dbf files.)
• Text files
Note
• To install drivers and profiles of ODBC platforms other than those listed
above, you need to install the appropriate software, for example, Excel 7
or later, Microsoft Access, and so forth.
You can import data from a database platform (for example, Oracle, SQL Server or
Sybase Adaptive Server Anywhere) other than your current SmartPlant
Instrumentation database platform. To do this, you have to comply with the
appropriate system requirements of the external database platform. For example, if
your current SmartPlant Instrumentation database platform is Sybase Adaptive Server
Anywhere and you want to import data from an Oracle database, you must have
Oracle client installed and running on your computer.
You can also import from database platforms other than those specified above. To do
this you need to provide drivers and modify the appropriate configuration files.

Flow of Activities for Importing Data into SmartPlant

Instrumentation
This topic describes the flow of activities for importing data into SmartPlant
Instrumentation.
1. Define an Import Source

You must define a file or database with the data you want to import. For details about
supported data sources, see Database Platform Support, page 1395.
2. Create a Link Group

If you intend to use several data sources, you will have to define an import link for
each source. Therefore, creating defining import links, create a link group. For
details, see Managing Import Link Groups Common Tasks, page 1399.
3. Create an Import Link

Create a link between the data source that you defined and the target table or module
of SmartPlant Instrumentation. For details, see Defining Import Links Common
Tasks, page 1412.
4. Define Import Link Properties

After creating an import link, you must specify how you want to import use the
source data associated with the link. For example, you might only want to insert new
records into SmartPlant Instrumentation without updating existing data, or you want
to import data into more than one <plant> or project. For details, see Defining Import
Link Properties Common Tasks, page 1423.
5. Map Source and Target Fields

At this stage, you map the fields in your data source with target table columns in
SmartPlant Instrumentation. For details, see Map Source and Target Fields Common
Tasks, page 1446.
6. Test Data Import or User Comparison Options

If needed, test the import process before importing data. Testing the import process
can be useful when testing a single link before carrying out a large batch operation.
A test can also give you an indication on the rejected rows and allow you to fix the
problem prior to a batch operation. For details, see Test the Import Process, page
1493. After you have run an import session on a set of data at least once, you can run
subsequent sessions by comparing the new rows to be imported with previously
imported rows. for details, see Comparison Options Common Tasks, page 1469.
7. Import Data into SmartPlant Instrumentation

Run the import process. For details, see Importing Data Common Tasks, page 1491.

Starting the Import Utility

The Import Utility is automatically installed when selected during SmartPlant
Instrumentation setup. However, if the Import Utility was not installed in your
computer, you can install it by running the SmartPlant Instrumentation setup and
selecting to install the Import Utility.
Important
• You must have Domain Administrator access rights to be able to perform
import activities.
You can start the Import Utility in one of two ways:
• By selecting Import Utility from the Intergraph SmartPlant

Instrumentation program group in the Windows Start menu.
• By running an import session using a command-line (see Run an Import
Session from the Command Line, page 1495).

Link Groups: An Overview

A link group allows you to categorize import links according to your requirements
and easily find the appropriate link when needed. You create and manage link groups
in the Link Explorer. The software comes shipped with the All link group, which
you cannot edit or delete.
Every link must belong to a link group, so if you do not create an group, links that
you create automatically appear in the All link group. Other link groups that you
create are considered user-defined. You can create as many user-defined link groups
as you require, edit or delete them when needed, move links from one group to
another, duplicate links, or associate the same link with more than one group.
Changing properties of such a link in one group results in changing the properties of
all instances of this link in all the groups it is associated with. You can only delete a
link group together with the links this group contains. Deleting a link group results in
deletion of all the group links from the All group as well.
You can import data either from a specific link or from all links in the group in batch
mode. For batch mode, the Import Utility runs the group links one after another with
the link that appears right under the group name in the Link Explorer having the
highest priority.
Related Topics
• Managing Import Link Groups Common Tasks, page 1399

Managing Import Link Groups Common Tasks

These tasks deal with creating and managing import link groups, and organizing links
into groups in the Link Explorer window.
Create a Link Group

Use this procedure to create an empty link group. For details, see Create a Link
Group, page 1400.
Rename a Link Group

Use this procedure to rename an existing link group, provided that the name you
define is unique. you cannot rename the All group. For details, see Rename a Link
Group, page 1401.
Rename a Link in the Link Explorer

Use this procedure to rename an existing link in the Link Explorer, provided that the
name you define is unique. For details, see Rename a Link in the Link Explorer, page
1401.
Rename a Link in the Import Link Window

Use this procedure to rename an existing link after opening this link in the Import
Link window, provided that the name you define is unique. For details, see Rename
a Link in the Import Link Window, page 1402.
Prioritize Links in a Link Group

Use this procedure to define or modify the sequence in which the links appear in a
group. This sequence determines the link priority. When executing an import session
for the entire group, the links are run in the order in which they appear in the group.
By default, links in groups are arranged automatically in alphabetical order. For
details, see Prioritize Links in a Link Group, page 1403.
Duplicate a Link in the Link Explorer

Use this procedure to duplicate an existing link within the same link group by
selecting a source link in the Link Explorer. You can only duplicate one link at a
time. For details, see Duplicate a Link in the Link Explorer, page 1403.
Duplicate a Link in the Import Link Window

Use this procedure to duplicate an existing link within the same link group after
opening this link in the Import Link window. For details, see Duplicate a Link in
the Import Link Window, page 1405.

Move Links to Another Group

Use this procedure to move one or more link from one group to another. You cannot
move links from the All group. For details, see Move Links to Another Group, page
1406.
Associate the Same Links with Several Groups

Use this procedure to associate the same link or links with more than one group.
Changing properties of a link in one group results in changing the properties of all
instances of this link in all the groups it is associated with, including the All group.
In the same way, deleting such a link from a particular group results in deletion of all
instances of this links from all the groups it is associated with, including the All
group. For details, see Associate the Same Links with Several Groups, page 1406.
Dissociate Links From a Group

Use this procedure to dissociate one or more links from a group. If a link is not
associated with any group, you can still locate it and run it from the All group, if
required. For details, see Dissociate Links From a Group, page 1407.
Delete Links
Use this procedure to delete one or more links that you no longer require. For details,
see Delete Links, page 1407.
Delete a Link Group

Use this procedure to delete an entire link group with all the links that it contains. For
more information, see Delete a Link Group, page 1408.
Related Topics
• Flow of Activities for Importing Data into SmartPlant Instrumentation,
page 1396
• Link Groups: An Overview, page 1398
Create a Link Group

1. In the Link Explorer, do one of the following:
• On the toolbar, click (New Group).

• Right-click anywhere in the Link list pane, and then, on the shortcut
menu, click New Group.
2. Under Link list, type a unique name for the link group.
Tip
• In the link group name string, you can use spaces and special
characters if required.

Rename a Link Group

1. In the Link Explorer, click the group you want to rename.
2. On the toolbar, click (Rename).
3. Type the new unique name for the group.
Tip
• Since groups in the Link list are arranged in alphabetical order,
renaming a group may result in its moving to a different position in the
Link Explorer.
Related Topics
• Rename a Link in the Link Explorer, page 1401
Rename a Link in the Link Explorer

Caution
• Links in groups are arranged in alphabetical order. Renaming a link may
result in its moving to a different position in the group. Therefore, if you
intend to import data in batch mode, note that the link running order may
change. For batch mode, the Import Utility runs the group links one after
another with the link that appears right under the group name in the Link
Explorer having the highest priority.
1. In the Link Explorer, click the group in which you want rename a link.
2. Click the link that you want to rename.
3. On the toolbar, click (Rename).
4. Type the new unique name for the link.
Related Topics
• Rename a Link Group, page 1401

Rename a Link in the Import Link Window

Caution
• Links in groups are arranged in alphabetical order. Renaming a link may
result in its moving to a different position in the group. Therefore, if you
intend to import data in batch mode, note that the link running order may
change. For batch mode, the Import Utility runs the group links one after
another with the link that appears right under the group name in the Link
Explorer having the highest priority.
1. With the link open in the Import Link window, on the toolbar, click (Save
As).
2. On the Save Link As dialog box, under Link name, enter the new unique name
for the link.
3. Under Save options, select Rename current link.
4. Click OK.
Related Topics
• Rename a Link in the Link Explorer, page 1401

Prioritize Links in a Link Group

1. In the Link Explorer, in the Link list pane, expand a link list in a user-defined
group.
2. To set a particular link as having the highest priority, do one of the following:
• In the Link list pane, drag the appropriate link to the group level.
• In the right pane, drag the link to the top of the list so that the link that
appears at the top moves down and becomes the second link from the
top.
Tip
• In the right pane, if the link you want to move up appears right under
the first link at the top, move the topmost link down to swap the
positions of the two links.
3. Arrange the other links in the required sequence in the group by dragging the link
to the appropriate positions.
Tip
• If you have a link that appears right above the link that has the lowest
priority and you want to swap the positions of these links, move the
higher link down.
Related Topics
Duplicate a Link in the Link Explorer

Caution
• Links in groups are arranged in alphabetical order. Duplicating a link may
result in changing the priority of running links in batch mode. For batch
mode, the Import Utility runs the group links one after another with the
link that appears right under the group name in the Link Explorer having
the highest priority. After duplicating a link, you might need to rearrange
the order of your links manually. For details, see Prioritize Links in a Link
Group, page 1403.
1. In the Link Explorer, click the group containing the link you want to duplicate.
2. Select the link you want to duplicate and do one of the following:
• On the toolbar, click (Edit Links).

• On the shortcut menu, click Edit Link.

3. On the Link Definitions dialog box, do the following:

a. In the Link box, enter a unique name for the link you want to create by
duplicating the existing link.
b. If needed, modify the source settings.
c. Select Save as new link.
d. Click Apply and then Close.
Caution
• We recommend that you do not modify the import method when
duplicating a link. This is because the source link properties are also
duplicated and might be not applicable for a new link if you change
the import method. For example, suppose your source import link
properties include multi-tag spec options and the link is assigned to the
Module (multiple tables) import method. If you change the import
method to Single table, select a specification table, and save the link
under a new name, the multi-tag spec option properties are applied to
the new link as well. You cannot manually dissociate these properties
from the duplicated link because the multi-tag spec options are
disabled on the Link Properties dialog box when the link is assigned
to the Single table method.
4. On the toolbar, click to display the duplicated link in the link group.
Related Topics

Duplicate a Link in the Import Link Window

Caution
• Links in groups are arranged in alphabetical order. Duplicating a link may
result in changing the priority of running links in batch mode. For batch
mode, the Import Utility runs the group links one after another with the
link that appears right under the group name in the Link Explorer having
the highest priority. After duplicating a link, you might need to rearrange
the order of your links manually. For details, see Prioritize Links in a Link
Group, page 1403.
1. With the link open in the Import Link window, on the toolbar, click (Save
As).
2. On the Save Link As dialog box, under Link name, enter the new unique name
for the link.
3. Under Save options, select Save as new link.
4. Click OK.
Tip
• The duplicated link automatically appears in the Link Explorer in the
group to which the source link belongs.
Related Topics
• Duplicate a Link in the Link Explorer, page 1403

Move Links to Another Group

Caution
• Links in groups are arranged in alphabetical order. If the target group
already contains links, moving a link into this group may result in
changing the priority of running links in batch mode. For batch mode, the
Import Utility runs the group links one after another with the link that
appears right under the group name in the Link Explorer having the
highest priority. After moving links, you might need to rearrange the
order of your links manually. For details, see Prioritize Links in a Link
Group, page 1403.
1. In the Link Explorer, click a user-defined group containing the links you want to
move.
2. In the right pane, while pressing and holding down the Shift key, select the links
you want to move.
3. Drag the selected links to the target group in the Link list pane.
Related Topics
Associate the Same Links with Several Groups

Caution
• Links in groups are arranged in alphabetical order. If the target group
already contains links, associating another link with the group may result
in changing the priority of running links in batch mode. For batch mode,
the Import Utility runs the group links one after another with the link that
appears right under the group name in the Link Explorer having the
highest priority. After associating additional links, you might need to
rearrange the order of your links manually. For details, see Prioritize
Links in a Link Group, page 1403.
1. In the Link Explorer, click a group containing the links you want to associate
with another group as well.
2. In the right pane, select one or more links (use the Ctrl key to select multiple
links).
3. Drag the selected links to the target group in the Link list pane.
Related Topics

Dissociate Links From a Group

1. In the Link Explorer, click the group where you want to dissociate links.
2. Select one or more links in the right pane (press Ctrl or Shift for multiple
selections).
3. On the toolbar, click (Dissociate) to dissociate the selected links from the
group.
Related Topics
Delete Links
Caution
• Link deletion is irreversible. When deleting a link, the software
permanently removes this link from all link groups it is associated with,
including the shipped group All. For this reason, you should exercise an
extreme caution when deleting links.
1. In the Link Explorer, click the group containing the links you want to delete.
2. In the right pane, select links that you want to select (press Ctrl or Shift for
3. On the toolbar, click (Delete).
4. When prompted, click Yes to confirm the deletion.
Tip
• You can delete links by deleting the entire link group. For details, see
Delete a Link Group, page 1408.
Related Topics

Delete a Link Group

Caution
• Link group deletion is irreversible. When deleting a link group, the
software deletes the links from all other groups they are associated with,
including the shipped group All. For this reason, you should exercise an
extreme caution when deleting link groups.
1. In the Link Explorer, click the group you want to delete.
2. On the toolbar, click (Delete).
3. When prompted, click Yes to confirm the deletion.
Tips
• Deleting a link group results in deletion of all the group links from the
All group as well.
• You can delete individual links without deleting the whole group. For
details, see Delete Links, page 1407.
Related Topics

Import Links: An Overview

Before the actual import can take place, you must have a link between the source data
and the target table or module of SmartPlant Instrumentation. If you do not have a
previously saved link or you do not want to use an existing link, you need to create a
new one.
The first step in building a new link is to define the source data using your database
tools or a file source. When defining an import link, you need to establish a
connection to the source database or file that contains predefined source data. Your
import source must contain at least one field, even if you want to specify an import
value manually. You either map existing source fields or specify import values
manually in the Import Link window.
The second step in creating an import link is to specify the import method. The
import method can be either Single table or Module (multiple tables). The Single
table method is useful when you need to or to import specific items or update
properties of items that already exist in SmartPlant Instrumentation. This method is
especially useful when importing wiring data. First, you import your panels into the
PANEL table. Then, you import terminal strips into the PANEL_STRIP table and
make appropriate associations with the previously imported panels. Then, you import
terminals into the PANEL_STRIP_TERM table, and so forth. You can also use the
Single table method in conjunction with data import into reference tables. The
Module (multiple tables) method is useful for massive data import. For example,
you need to use this method to import multiple tag numbers, loop numbers,
supporting table values, and automatically associate appropriate supporting table
values to the imported instrument and loops. This method, however, is not useful for
wiring data import due to the complexity of wiring connections and parent item –
child item relations in SmartPlant Instrumentation.
When creating an import link, you must define a unique link name. If you create
several links, you might need to categorize them into link groups. For details, see
Link Groups: An Overview, page 1398. You create, rename, delete import links, and
associate them with link groups in the Link Explorer window. Also, you can move
import links between databases or domains. For details, see Moving Links Between
Databases or Domains: An Overview, page 1411. It is possible to run import links in
batch mode, in order of priorities.

After creating an import link, you need to set various properties for the link on the
Link Properties dialog box. The properties that appear on this dialog box depend on
your import method and target table or module selection. For details, see Defining
Import Link Properties Common Tasks, page 1423.
Important
• If you intend to import a large number of records (more than 400 records)
in one import session, you must create a new section in the Intools.ini file
called [Rules] and add the following parameter disable = y.
Related Topics
• Defining Import Links Common Tasks, page 1412
page 1396
• Formulas and Arithmetic Functions in Import Links, page 1453
• Prioritize Links in a Link Group, page 1403
• String Operators in Import Links, page 1452

Moving Links Between Databases or Domains: An

Overview
You can move the links you have created to other databases or other domains (note
that links are used per domain). This process consists of two stages. First, you
transfer the link information to an ASCII file (export the links) and then you create a
group of links from that ASCII file in the other database (import the links). You can
export and import only a group of links and not an individual link. Hence, if you
want to move a single link, you need create a group to which you associate the link.
Caution
• Make sure that special data such as a tag naming convention is the same in
both databases or domains. In case the naming convention is not the
same, you will not be able to carry out the import process automatically.
In this case you will first need to modify the links of the naming
convention of the required part of the name. The source and the target
domain or database for the links have to be of the same version of the
Import Utility.
Related Topics

Defining Import Links Common Tasks

The following tasks are used when you define import links.
Create an Import Link for an ODBC Source

This procedure describes the setup for the ODBC platform. For more information,
see Create an Import Link for an ODBC Source, page 1413.
Create an Import Link for an Oracle Source

You use this procedure to build a new link using a source database platform other
than ODBC. To do this you must have access rights to the database server as well as
the appropriate database drivers. You must also have the appropriate settings in the
configuration files (for example, ini files) and in the Windows registry. For more
information, see Create an Import Link for an Oracle Source, page 1415.
Create an Import Link for a File Source

Use this procedure to create an import link for a data source that is a predefined file
containing tables with table columns and values. For more information, see Create
an Import Link for a File Source, page 1416.
Define a Data Import Source in Excel Spreadsheets

Use this procedure to define tables, table columns and column values in an Excel
spreadsheet. You can then use this Excel spreadsheets as a source for data import.
For more information, see Define a Data Import Source in Excel Spreadsheets, page
1417.
Prerequisite for Using Microsoft Access as an Import Source

Before you create an import link for a Microsoft Access data source file, you need to
perform the following procedure in Microsoft Access file containing the source data.
For more information, see Prerequisite for Using Microsoft Access as an Import
Source, page 1418.
Using the Link Explorer Window

You use the Link Explorer window to move and copy links. For more information,
see Using the Link Explorer Window, page 1418.
Change Link Source Paths

You this procedure to change the path or name of the source file of an existing link
when you need to update the source path. You can change the source path of a single
link or you can set one default folder for all your links in that group. For more
information, see Change Link Source Paths, page 1419.

Export Links
You use this procedure when moving a link or exporting a group of links to another
database or domain. When you export a group of links you transfer the information
about a group of links to an ASCII file which has the .imp extension. You can then
use the exported links in other domains or databases. The link information is saved to
an ASCII file which you can use for import. For more information, see Export a
Group of Links, page 1420.
Import Links
You use this procedure to import the link or group of links you exported using the
Exporting Links procedure. You can use a file with the .imp extension to create a
group of links based on the information you have saved in this file. A number of
predefined link groups are provided by Intergraph for use with the interfaces (for
example, PDS, SmartPlant P&ID, CENTUM CS, and so forth). When you first
install SmartPlant Instrumentation, you must import these link groups as add-ins in
the Administration module (an appropriate license is required). After you have added
the predefined import links, you can export and import them freely between domains.
For more information, see Import Links, page 1421.
Related Topics
page 1396
Create an Import Link for an ODBC Source

• On the Actions menu, click New Group (or click ) to create a new
link group.
• In the link list, select an existing link group.
• Click .
• On the Actions menu, click New Link.
3. On the Link Definitions dialog box, under Import method, click Single table or
Module (multiple tables) and select the appropriate target table or module from
the list.
Important
• You can import data only into a target table which has a table
definition (for example, a table which has a correct definition of a
primary key, foreign keys, and reference tables). If you import data
into a target module, all the tables in the target module must have a
table definition.

4. Under Source, from the Database type list, select ODBC as the source database
platform.
5. From the ODBC profile list, select the required database profile or a file that
contains source table definitions.
Tip
• Your selection affects the way you connect to the SQL data source and
the dialog box options change accordingly.
• If you selected a database profile, specify the user name and password
for connecting to the source database and click Connect; then, from
the Table list, select a table from which you want to import data.
• If you selected a data source file, beside File name and path, click
Browse and specify the data source file.
Tip
• If you are creating a new link on the basis of an existing link, select
Save as new link.
7. Click Apply and then Close.
8. Click to display the link you defined in the Link Explorer.
Related Topics
• Create an Import Link for a File Source, page 1416
• Create an Import Link for an Oracle Source, page 1415
• Setting the Target Table Definitions: An Overview, page 1464

Create an Import Link for an Oracle Source

link group.
• Click .
3. On the Link Definitions dialog box, under Import method, select Single table
or Module (multiple tables) and select the appropriate target table or module
from the list.
Important
table definition.
4. Under Source, from the Database type list, select a source Oracle version.
5. Under Server name, type the server name where the source Oracle database
resides.
6. Under User name and Password, provide logon information for connection to the
source Oracle database.
7. Click Connect to establish a connection to the selected Oracle database.
8. From the Table list, select a table from which you want to import data.
Tip
Save as new link.
Related Topics
• Create an Import Link for an ODBC Source, page 1413

Create an Import Link for a File Source

link group.
• Click .
3. On the Link Definitions dialog box, under Import method, click Single table or
Module (multiple tables) and select the appropriate target table or module from
the list.
Caution
table definition. If you select a target table which does not have a
table definition or has an incorrect table definition, an appropriate
message will be displayed. In this case you will have to select another
target table or modify the table definition. To learn more about setting
the table definition, see Setting the Target Table Definitions: An
4. Under Source, from the Database type list, select ODBC as the source database
platform.
5. From the ODBC profile list, select the appropriate data source file type.
6. Beside File name and path, click Browse.
7. On the Select File dialog box, select the source file and then, do one of the
following:
• In the data source file does not have table definitions, click Open to
display the file name and path on the Link Definitions dialog box.
• If the file that you selected has table definitions, for example, an Excel
spreadsheet, on the Enter Table Name dialog box, type the name of
the source table in upper case, as it appears in the data source file, and
then click OK to display the file name and path on the Link
Tip
Save as new link.


Related Topics
• Define a Data Import Source in Excel Spreadsheets, page 1417
• Prerequisite for Using Microsoft Access as an Import Source, page 1418
Define a Data Import Source in Excel Spreadsheets

1. With your Excel worksheet open, in the top cell row, define table column names
without spaces, for example, instrument_tag_number, service, and so forth.
2. In the cells under the table column names, define the column values, for example,
101-FT -100/A, Flow, and so forth.
Tips
• The table or column names that you define do not have to match the
table column names in SmartPlant Instrumentation.
• Make sure that the values you enter in the cells comply with the data
format used in SmartPlant Instrumentation. For example, when
defining instrument tag numbers, you must use the naming convention
defined in SmartPlant Instrumentation.
3. Select the cells that you want to include into a table.
4. Click Insert > Name > Define.
5. In the Name in workbook box, type the table name in upper case, for example,
SOURCE_INSTRUMENTS.
6. Click Add.
7. Click OK to return to your Excel spreadsheet and repeat this procedure for all
other tables that you require.
8. Save the spreadsheet.
Related Topics
• Matching Naming Conventions, page 1490

Prerequisite for Using Microsoft Access as an Import

Source
1. In Microsoft Access, open a data source file and click Tools > Options.
2. On the View tab, select the System objects check box and click OK.
3. Click Tools > Security > User and Group Permissions.
4. Under Object Name, select MSysObjects.
5. Select the Read Data check box and click OK.
Related Topics
Using the Link Explorer Window

You can perform the following actions in the Link Explorer window.
To do With the mouse... From the Notes

this... keyboard...
Move a Select a link in the left Press Ctrl+X to cut The link always
link pane and drag the link to the selected link; appears below the
the new location press Ctrl+V to position you drag it
paste in the new to; drag to the group
location to make it the first
link in the group
Copy a Select a link in the left Press Ctrl+C to copy The link always
link pane and hold down Ctrl the selected link; appears below the
while dragging the link to press Ctrl+V to position you drag it
the new location paste in the new to; drag to the group
link in the group
Move a Select a group in the left Press Ctrl+X to cut If one or more of the
group of pane and it to the new the selected group; links already exists in
links location press Ctrl+V to the target, it is not
paste in the new deleted in the source
location
Copy a Select a group in the left Press Ctrl+C to copy
group of pane and hold down Ctrl the selected group;
links while dragging it to the press Ctrl+V to
new location paste in the new
location

To do With the mouse... From the Notes

this... keyboard...
Move In the right pane, hold The links always
multiple down Shift or Ctrl while appear below the
links selecting the required links position you drag it
and drag to the new to; drag to the group
location in the left pane to make it the first
link in the group
Copy In the right pane, hold The links always
multiple down Shift or Ctrl while appear below the
links selecting the required links position you drag it
and drag to the new to; drag to the group
location in the left pane to make it the first
while holding down Ctrl link in the group
Change Drag links up or down in Press Ctrl+X to cut The link always
the link the group the selected link; appears below the
order press Ctrl+V to position you drag it
paste in the new to; drag to the group
link in the group
Related Topics
• Delete a Link Group, page 1408
• Dissociate Links From a Group, page 1407
Change Link Source Paths

1. In the Link Explorer, select the required group and click to expand the group
and display its links.
2. On the toolbar, click (Edit Links).
3. On the Link Definitions dialog box, click Browse.
4. Navigate to the required source file and click Open.
5. Click Close to close the Link Definitions dialog box.

Specify a New Default Folder for All Links

1. In the Link Explorer, do one of the following:
• On the toolbar, click (Folder).
• On the menu bar, click Actions > Folder.
2. In the Default Source File Folder dialog box, click Browse.
3. Navigate to a file in the required folder and click Open.
4. Click Apply.
5. To undo the current default folder settings, click Clear next to the default path.
6. Click Close.
Tip
• You can change the source path only if the platform is a database file,
for example, dBase, Excel, ASCII, and so forth.
Related Topics
Export a Group of Links

1. On the Service menu, click Export Links.
2. In the Export Link Groups dialog box, select the link group that you want to
export.
3. Click Export.
4. In the Enter Export Link File Name dialog box, do the following:
a. Type the filename of the link file name (you do not have to add the .imp
extension).
b. Navigate to the required location where you will save the link file.
c. Click Save to save the link file.
Related Topics
• Import Links, page 1421
• Moving Links Between Databases or Domains: An Overview, page 1411

Import Links
1. On the Service menu, click Import Links.
2. In the Open File dialog box, navigate to the required ASCII file with the imp
extension which you want to use for import and click OK.
3. At the prompt, click Yes to import the group of links from the imp file you
selected in the Open File dialog box.
4. In the Database Table Definition dialog box, select the Import link table
definition check box to import the table definition saved in the group of links as
well as the links themselves, or clear the check box to import only the group of
links.
5. Under Duplicate table definition names, do one of the following:
• Click Create new to import the link table definition if the imported
table definition name is the same as the current table definition. This
way, the Import Utility will rename the imported table definition by
adding a $ sign next to the table definition name. For example,
Process Data will be renamed as Process Data$.
• Click Skip to skip the import of the table definition if the current table
definition name is the same as the imported table definition.
6. Click OK to import the group of links.
Related Topics
• Export a Group of Links, page 1420
• Moving Links Between Databases or Domains: An Overview, page 1411

Link Properties: An Overview

Import link properties are various parameters that influence the import process when
you run the link. You define and manage import link properties using various options
on the tabs of the Link Properties dialog box. By selecting properties on the
General tab, you control various features which influence the import setup process.
The available options depend on whether the current link is assigned to the Module
(multiple tables) or Single table import method. Some of the displayed options
depend on the specific module that you selected for the link.
When duplicating an import link, all the source import link properties are retained.
Related Topics
• Defining Import Link Properties Common Tasks, page 1423

Defining Import Link Properties Common Tasks

The following tasks are used when you setting the import link properties.
Open Link Properties

Use this procedure to display the Link Properties dialog box either from the Link
Explorer or Import Link window. For more information, see Open Link Properties,
page 1425.
Set Properties for Handling Mismatched Data

This procedure allows you to determine how the software handles imported source
rows with invalid empty foreign key columns that are defined as NOT NULL but
contain no value. For more information, see Set Properties for Handling Mismatched
Data, page 1426.
Set Import Mode Parameters

The update operation is carried out automatically whenever a source row contains the
same key definition as the target row.
You can perform the following operations:
• Determine the way SmartPlant Instrumentation treats identical source and

target rows by setting the appropriate parameters in the Import mode tab.
• Determine how the Import Utility updates target rows during the import
process.
• Select source and target keys for the Import Utility to use to refresh the
target data during the import process. This option is available to you only
if the source and target tables have been already used in a previous import
session.
For more information, see Set Import Mode Parameters, page 1426.
Specify a Filtering Condition

This procedure allows you to define a filtering condition which will be used by
Import to selectively import data from the source table. The filtering condition can
contain any combination of the following:
• Source table columns

• Operators or functions
• Alphanumeric values
For more information, see Specify a Filtering Condition, page 1428.

Enable Reference Tables for Import

Use this procedure to enable data insertion into the target reference tables during the
import process whenever data exists in the source table but it is missing in the target
table. As a rule of thumb, you must always import data into reference tables before
importing data into the tables they refer to. You can also control which reference
table columns are displayed in the Import Link window by selecting a browser view
created in SmartPlant Instrumentation. You can perform this procedure only when
using the Single table import method. For more information, see Enable Reference
Tables for Import, page 1430.
Set the Tag/Loop Parameters

This procedure shows you how to determine the way the Import Utility handles the
naming conventions of the source data during the import process. This procedure is
possible only if the target table or module you selected requires naming conventions,
for example, COMPONENT table, LOOP table, Instrument Index module, and so
forth. For more information, see Set the Tag/Loop Parameters, page 1431.
Set Custom Parameters (Import to Module Only)

The selections that you make in this tab folder enable you to show in the Import
Link window only those table columns used in a selected Browser module view style.
This way, you can use these columns in creating the current import link. You can
perform this procedure only if you selected to import data into the following modules:
Instrument Index, Process Data - Line, or Dimensional Data for Piping. For more
information, see Set Custom Parameters (Import to Module Only), page 1432.
Set Column Display for the Module Import Method

When your link is assigned to the Module (multiple table) import method, you can
use this procedure to set the Import Utility to display all target module table columns
in the Import Link window. By default, when opening an import link assigned to
the Module (multiple table) import method, the Import Utility only retrieves those
columns that appear in a special hard-coded list and displays them in the Import
Link window. The special list serves two purposes:
• To shorten the list of table columns displayed in the Import Link

window.
• To display data field names instead of the table column names used in the
database.
Note
• You cannot perform this procedure when importing data into the
For more information, see Set Column Display for the Module Import Method, page
1434.

Refresh Previously Imported Data

This procedure shows you how to keep tables that you have already used in a
previous import session up to date by refreshing them.
To refresh tables you previously imported, you need to select the same source and
target data as you did in the previous import session. Then you select the appropriate
source and target refreshing keys which are the source and target table columns
according to which contents the target data will be refreshed during the import
process.
If the Import Utility detects a change in the selected source refreshing key contents
(in comparison to the selected target refreshing key contents), the target table
column contents will be updated accordingly.
For more information, see Refresh Previously Imported Data, page 1434.
Related Topics
page 1396
• Link Properties: An Overview, page 1422
Open Link Properties

• To open the Link Properties dialog box, do one of the following:
• On the menu bar, click .
• On the Actions menu, click Properties.
Related Topics

Set Properties for Handling Mismatched Data

1. Open the Link Properties dialog box.
2. On the General tab, under Undefined NOT NULL fields, do one of the
following:
• Select Use default value to sets any reference columns values in the
target table to zero during the import process if these columns do not
appear in the appropriate reference table.
Tip
• Selecting the Use default value option overrides any selections
you make in the Default column on the Target Table Definition
dialog box. To learn how to use the Target Table Definition
dialog box, see Setting the Target Table Definitions: An Overview,
page 1464.
• Select Reject rows to set the Import Utility to reject all source rows
that contain reference columns that do not appear in the appropriate
reference table during the import process.
Related Topics
• Common Error Messages, page 1532
Set Import Mode Parameters

1. On the Link Properties dialog box, click the Import Mode tab.
2. Under Target database import mode, do one of the following:
• Select Insert and update to enable the Import Utility to insert new
source rows and update existing target rows during the import process.
• Select Insert to prevent the Import Utility from updating target rows
and to enable insertion of only new source rows in the target domain
during the import process.
• Select Delete to delete existing rows in the target domain during the
import process.
• Select Move to move the rows in the target domain to a different
<unit> in the same domain.
Tip
• The Delete and Move modes are only available when using the Single
table import method.

3. If you chose the Insert and update option in step 2, under Target database
update condition, select any combination of the following check boxes:
a. If the source contains a NULL value
• Select to overwrite the target table column even if the
corresponding source table column contains a NULL value.
• Clear to skip source table columns that contain a NULL value.
b. If the source contains a space or a zero value
• Select to overwrite the target table column even if the
corresponding source table column contains a space value or a zero
value.
• Clear to skip source table columns that contain a space value or a
zero value.
Tips
• Some database drivers interpret spaces in a source table column as
a NULL value. To avoid incorrect overwriting of data in the
target, it is highly recommended that you select both or neither of
the above two check boxes.
• When inserting NULL values for table columns of data type String
that can normally accept a NULL value, you can specify the
insertion of a single space instead of NULL. To do so, in the
Intools.ini file, under the [Import] section, type the line:
FillSpace=Y.
c. Do not insert
• Select to skip inserting source rows that do not exist in the target
table.
• Clear to insert source rows that do not exist in the target table.
Related Topics
• Refresh Previously Imported Data, page 1434

Specify a Filtering Condition

1. On the Link Properties dialog box, click the Source tab.
2. Select Filter the source table to enable filtering during the import process.
3. Click Modify to open the Import Source Filter dialog box.
4. To create a filtering condition, do one or more of the following:
• In the Source table columns data window, double-click the table
column that you want to add to the filter condition in the data window.
• Under Operators and functions, click the appropriate operator or
function buttons to add the appropriate operator or function to the
filtering condition.
• Under Operators and functions, select the desired SQL function from
the appropriate list. Then right-click the selected SQL function to be
applied in the filter condition.
• In the Import Source Filter dialog box, type the appropriate
expression. You can also add this expression to the filtering condition
already displayed in the Import Source Filter data window.
Tips
• The Filter feature provides you with various built-in operators and
functions. For details, see Built-In Operators and Functions, page
1441. The built-in operators and functions are those used in the
WHERE SQL statement. See your database platform manual to learn
more about database statements.
• The Filter feature also provides you with special SQL functions,
which are native to the source database. For details, see SQL
Functions Native to Source Database, page 1442.
5. Repeat step 4 to add as many table columns, operators, functions and values as
required.
The new condition appears in the window of the Import Source Filter dialog
box, for example:

6. To check the filter condition syntax, click Verify.

An appropriate message is displayed, notifying you that:
• The condition in the data window is valid - in this case the message
also indicates the number of rows which match the condition.
• The condition in the data window is invalid - in this case you can
correct the condition and try again.
7. To view the way the filtering condition affects the source data, click View
Source.
8. Click OK to close the Import Source Filter dialog box and return to the Source
tab where your condition appears in the data window.
Tip
• You can disable the current filtering condition without deleting it. To
do this clear Filter the source table after you define a condition.
9. Under Associate source tables, select Apply to associate additional source data
with the source data that you selected when you started this import session. To
make the source data definitions, click Define. See Associate Additional Source
Data, page 1439 to learn how to do this.
10. Under Process function, select Assign to assign SmartPlant Instrumentation
process functions to the imported data based on their instrument types. To make
the source data definitions, click Define. For details, see Associate Source Fields
with Existing Instrument Types, page 1510 or Set Source Fields as Instrument
Type Fields, page 1508.
Related Topics
• Viewing the Source Data, page 1436

Enable Reference Tables for Import

Prerequisite
• The link for which you want to enable reference tables must be assigned to
the Single table import method.
1. Select a link and open the Link Properties dialog box.
2. On the General tab, select Insert data into reference tables.
3. Click the Style tab and do the following:
a. Under Browser view, select the browser view whose fields you want to
display when you open the current link in the Import Link window.
b. Click Style Preview to display the list of data field names and table columns
defined for the selected browser view style.
c. Click Select View to apply the style settings for the current link.
Tips
• You can only select one browser view.
• If you click Clear to clear the browser view selection, or select the
Display all fields check box, when you open the current link in the
Import Link window, the software displays all columns of all the
reference tables as they are defined in the database. Selecting the
Display all fields check box disables browser view style selection
options.
• The browser view list contains all browser views defined in
SmartPlant Instrumentation. You can define a new browser view in
SmartPlant Instrumentation if you find no suitable browser view for
the current import link.
4. Click OK.
Related Topics

Set the Tag/Loop Parameters

1. On the Link Properties dialog box, click the Tag/Loop tab.
• Select Define the naming conventions in the link to enable the
Import Utility to define the naming conventions structure
automatically by extracting the naming conventions structure from the
current link.
• Clear Define the naming conventions in the link to define the
naming convention structure manually by entering a naming
convention string in the Define Tag Name Structure dialog box
and/or the Define Loop Name Structure dialog box.
3. If you cleared the check box in the previous step, do one of the following:
• Select Redefine the naming convention to redefine links for the
tag/loop naming conventions parts of the source table.
• Clear Redefine the naming convention to use the current naming
conventions without redefining their links.
Tip
• Instrument conventions are defined in the Administration module. If
you select to redefine the naming conventions, you need to assign new
values to the instrument tag segments.
4. Select Validate tag and loop segments to verify the following during the import
process:
• Whether the instrument type values of the imported tags in the
COMPONENT table exist in the Instrument Type table
(COMPONENT_FUNCTION_TYPE).
• Whether the loop function values of the imported loops in the LOOP
table exist in the Loop Function table (LOOP_FUNCTION).
• Whether the measured variables of the imported loops in the LOOP
table exist in the Loop Process Variable table (LOOP_PROC). Note
that selecting this option slows down the import process.
Caution
• Validate tag and loop segments is selected by default, thus enabling
the validation check of the imported tags and loops before transferring
data. It is recommended you do not clear this box to avoid import
failure due to missing data.


• Select Use the loop reference data to also import loop reference data
into the COMPONENT table during the import process.
• Clear Use the loop reference data to disregard any loop reference
data during the import process.
Caution
• To prevent import failure, clear Use Loop reference data if the
imported COMPONENT table contains empty loop reference columns.
6. If you selected in the beginning of the current import session to import into the
Instrument Index module, the Use Tag data check box appears in the Tag/Loop
tab folder. In this case, do one of the following:
• Select the check box to include source tag number data from
supporting tables in the current import. You will need to redefine the
naming conventions for all target <units> in the Administration
module before you start the import process.
• Clear the check box to exclude tag supporting table data from the
current import session.
Related Topics
• Define Links for Naming Conventions, page 1447
Set Custom Parameters (Import to Module Only)

1. On the Link Properties dialog box, click the Custom Fields tab.
2. To show the custom fields of a line style in the Import Link window, under
Line, do the following:
a. Select Use style for line to include the custom fields of the selected style in
the Import Link window.
b. From the list, select the browser view style whose custom fields you want to
show in the Import Link window.
3. To show the custom fields of an equipment style in the Import Link window,
under Equipment, do the following:
a. Select Use style for equipment to include the custom fields of the selected
style in the Import Link window.

4. To show the custom fields of a loop style in the Import Link window, under
Loop, do the following:
a. Select Use style for loop to include the custom fields of the selected style in
5. To select the dimensional group to be used in the Import Link window for
importing data to the Dimensional Data for Piping module custom fields, under
Select dimensional group for custom name, select Apply to enable a selection
to be made from the list, and then from the list, select the browser view style
whose custom fields you want to show in the Import Link window. The
following options are available:
• Computed group name — Automatically creates the source for the
Dimensional Group Name field in the Import Link window, using
the group from the COMPONENT_DIMENSIONAL table to which
the tag defined in the link belongs.
• All Groups — Allows you to import data for all custom fields in the
module. The Dimensional Group Name section in the Import Link
window consists of two table columns: Dimensional Group CAD
Code and Dimensional Group Description. With this option
selected, you can enter an existing group or a new group for the source
name.
Tip
• All the custom fields are displayed in the Import Link window and
are assigned sequential numbers.
Related Topics

Set Column Display for the Module Import Method

Prerequisite
• The link for which you want to enable reference tables must be assigned to
the Module (multiple tables) import method.
1. Select a link and open the Link Properties dialog box.
2. Click the Style tab.
• Select the Display all fields check box to display in the Import Link
window all the pertinent table columns of the target module.
• Clear the Display all fields check box to display in the Import Link
window only those table columns that are included in the hard-coded
list.
Tip
• Browser view selection options on the Style tab are only available
when the import link is assigned to the Single table import method.
4. Click OK.
Related Topics
• Open Link Properties, page 1425
Refresh Previously Imported Data

1. On the Link Properties dialog box, click the Import Mode tab.
2. Click Insert and update to enable refreshing.
3. Under Refresh from source, select Apply.
4. Click Parameters.

5. On the Refresh Parameters dialog box, under Target:

a. From the Table name list, do one of the following:
• Select the appropriate target table.
• Accept the given default value (the current target table).
Tip
• The target tables which are available to you in the Target section
Table list depend on your target data type that you selected in the
beginning of the current import session:
• If you selected to import data into a specific table, only that target
table would appear in the Table list.
•If you selected to import data into a module, all the tables which
are associated with that target module would appear in the Table
list.
b. From the Refresh key list, do one of the following:
• Select the target table column to refresh during the import process.
•Accept the given default value (the current target table).
6. Under Source:
a. From the Table list, select the appropriate source table. This box is empty by
default.
b. From the Refresh key list, select the source table column to refresh from
during the import process. This box is empty by default.
7. Select View saved parameters to automatically select the last saved refreshing
parameters.
Tip
• If you click Delete, you are prompted to delete the last saved
refreshing parameters.
8. Click Save to save the refreshing parameters you currently selected in the
Refresh Parameters dialog box.
9. When prompted to confirm the new selection, do one of the following:
• Click Yes to overwrite the last saved refreshing parameters and return
to the Link Properties dialog box.
• Click No to return to the Refresh Parameters dialog box without
overwriting the last saved refresh parameters.
Tip
• If you enable the data refresh option or overwrite the last saved
refreshing parameters, you are prompted to use data refreshing or
overwrite the existing target data during the current import session.

Viewing the Source Data

This feature enables you to view the contents of the source table or database file
specified for a particular import link. You can view source data from any of the
following locations in the Import Utility:
• Link Definitions dialog box (after you select the source data)
• Import Source Filter dialog box
• Import Link window
You can perform the following actions:
• Select the Desired Viewing Option, page 1438

• Sort the Displayed Source Data Fields, page 1439
• Specify a Filtering Condition, page 1428
• Filter the Displayed Source Data Fields, page 1438

Working with Source Data

The following tasks are used when you working with the source table or database file.
View the Source Data

This procedure enables you to view the contents of the source table or database file
that you selected when entering the Import Utility. For more information, see View
the Source Data, page 1438.
Select the Desired Viewing Option

This procedure shows you how to select viewing options.
The following viewing options are available:
• View all source data fields.

• View only linked source data fields.
• View only selected source data fields.
For more information, see Select the Desired Viewing Option, page 1438.
Filter the Displayed Source Data Fields

You can filter the source data displayed in the Source Data section according to the
filtering condition you defined in the Source tab in the Link Properties dialog box.
To use this option, you must define a filtering condition. For more information, see
Filter the Displayed Source Data Fields, page 1438.
Sort the Displayed Source Data Fields

You can perform an alphanumeric ascending sorting of the information displayed in
the Source Data window according to one or more selected data fields. For more
information, see Sort the Displayed Source Data Fields, page 1439.
Associate Additional Source Data

You can import additional data and associate it to the source table that you selected in
the Link Definitions dialog box. This way you can import data into your database
from more than one source table. You do this by associating columns from other
tables or database files with the source table or database file. The associated columns
automatically become a part of the source data which you have selected on the Link
Note
• You can use associations which have been previously saved in a link. To
do this you have to start the import process using a previously saved link.
For more information, see Associate Additional Source Data, page 1439.

View the Source Data

• Do one of the following to display the Source Data window:
• In the Import Link window, click .
• In the Link Definitions dialog box or the Import Source Filter dialog
box, click View Source.
Related Topics
• Working with Source Data, page 1437
Select the Desired Viewing Option

1. With the Source Data window open, do one of the following:
• To view all the source data fields, on the View menu, click All Fields.
• To view only the fields of the displayed source data which are linked
to other tables or to the database, on the View menu, click Linked
Fields.
Tip
• You can view linked data fields only if you have already defined the
links between the source and the target data fields in the Import Link
window or if you have already used the definitions of a previously
saved link.
2. To view selected source data fields, do the following:
a. On the View menu, click Display Fields.
b. In the Display Source Fields dialog box, drag the data fields you want to
view from Source Fields to Selected Fields.
c. Click OK.
Related Topics
Filter the Displayed Source Data Fields

• With the Source Data window open, do one of the following:
• On the Filter menu, click On to filter the displayed source data
according to the filtering condition you previously defined.
• On the Filter menu, click Off to display the source data without
filtering it.
Related Topics

Sort the Displayed Source Data Fields

1. With the Source Data window open, on the Sort menu, click Custom Set.
2. In the Display Source Fields dialog box, drag the data fields by which you want
to sort the displayed source data from Source Fields to Selected Fields.
3. Click OK.
Note
• Sorting the source data in this dialog box does not affect the import
results.
Related Topics
Associate Additional Source Data

1. Select the desired link and click .
2. In the Link Properties dialog box, click the Source tab.
3. Under Source tables, click Define.
4. In the Associate Source Data dialog box, click Add to add a data set (for
example, a table or a database file) to the Source list data window.
5. Repeat the previous step to add as many data sets as required.
Tip
• It is possible to use the same table more than once as a source.
6. Highlight the desired data set to associate to and under the Association group
box, click Select.
The selected data set is copied to the Source for association data window.
7. Expand the data sets as desired in each data window by double- clicking them,
then drag the required item in that data set to the appropriate data set item in the
Source for association data window.
The association between the two data items is indicated by the appearance of
an icon ( ) to the right of each data item in the appropriate section.
Caution
• In SmartPlant Instrumentation, table columns contain numbers (num
type columns) and characters (char type column). You cannot
associate a num type column with a char type column or the other
way around.

8. Repeat the previous step to associate other data items as desired.

Tip
• You can associate several items with a single data set item, however,
you cannot associate data from a data set with itself.
• To delete an association, select the desired item in the Source for
association data window and press Delete on the keyboard.
9. Click Verify to make sure your selections are valid (this way you can check, for
example, whether the associated table columns are both of the same data type –
numeric or alphanumeric).
An appropriate message is displayed: if the associations are valid, the total
number of rows of the source data set (including the associated data) is
indicated, or else you are notified that the associations are invalid, in which
case you should correct your selection in the Source Associations dialog box.
10. Click Confirm.
11. At the prompt, click Yes to save your associations.
The data sets disappear from the right data window and appear at the top of
the left data window.
12. To make the fields of the associated data appear in future dialog boxes, do the
following:
a. Expand the associated data sets by double-clicking them.
b. Click once on every item you want to view.
The icons appear as follows:
• Item selected:
• Item not selected:

Tip
• You can view the contents of an associated data item in the Import
Link window. To be able to view the associated data, click when
available, after you select the required table. For further details, see
Viewing the Source Data, page 1436.
Caution
• Make sure you remove all disassociated tables from the data windows
in the Source Associations dialog box before you click Save.
13. Click Save to save your association.

14. In the Link Properties dialog box, under Source Associations, do one of the
following:
• Select Apply to use your associations in the current import process.
• Clear Apply to skip the defined associations.
Related Topics
• Example of Concatenated Sources, page 1515
Built-In Operators and Functions

Operator / Description Example
Function
= Equal to cpmnt_mfr =
'Shell'
> Greater than cmpnt_num > 101
< Less than item_price < 100
>= Greater or equal to cmpnt_num >= 10
=< Less than or equal to item_price =< 30
<> Not equal to prefix <> 'AA'
AND Include the following expression in the filter (name <> '') AND
combination (num <> 0)
OR Accept either the previous or the following (loop = '') OR
expression in the filter combination (line = '')
NOT Select the value opposite to the following NOT (item_price
expression = 0)
LIKE[value] Select a similar value that is similar to the one in cmpnt_num LIKE
the [value] field. You can use the following '%AA%'
wildcard characters: % - any combination of
characters. _ - any single character.
IN Select a value that is equal to one of those cpmnt_num = IN
specified in the parentheses (101,103)
BETWEEN Select a value which is within the following item_price
interval BETWEEN 100
AND 500
IS NULL Contains an undefined value loop_name IS
NULL
IS NOT Not equal to NULL cpmnt_name IS
NULL NOT NULL

SQL Functions Native to Source Database

The SQL Functions select list enables the use of special functions which are native
to the source database. The following functions are the most common ones:
SQL Function and Description Syntax and Output Example

Source Databases
LTRIM (<value>)dBase Removes all leading LTRIM(cmpnt_mfr)
Sybase Adaptive Server spaces in the field cmpnt_mfr = ' Shell'
Anywhere 7.0, Oracle, indicated in the LTRIM(cmpnt_mfr)='Shell'
SQL Server parentheses.
RTRIM(<value>) dBase Removes all trailing RTRIM(cmpnt_num) IS
Sybase Adaptive Server spaces in the field NULL cmpnt_num =
Anywhere 7.0, Oracle, indicated in the '108-FT 100'
SQL Server parentheses. RTRIM(cmpnt_num)='108-FT
100'
SUBSTRING(<value>, Retrieves a part of the SUBSTRING(cmpnt_mfr,1,4)
<begin>,<count>)dBase field indicated in the cmpnt_mfr = 'Shell'
Sybase Adaptive Server <value> data field from SUBSTRING(cmpnt_mfr,1,4)
Anywhere 7.0, Oracle the <begin> position for ='Shel'
the number of characters
indicated in the <count>
field.
SUBSTR(<value>, Retrieves a part of the SUBSTR (cmpnt_mfr,1,4)
<begin>,<count>)SQL field indicated in the cmpnt_mfr = 'Shell'
Server <value> data field from SUBSTR(cmpnt_mfr,1,4)='Sh
the <begin> position for el'
the number of characters
indicated in the <count>
field.
UCASE(<value>)dBase The upper case format of UCASE(cpmnt_name)
Sybase Adaptive Server the contents of the field cmpnt_name = '101-aa'
Anywhere 7.0 indicated in the <value> UCASE(cmpnt_name)='101-
data field. AA'
UPPER(<value>)Sybase The upper case format of UPPER(cpmnt_name)
Adaptive Server the contents of the field cmpnt_name = '101-aa'
Anywhere 7.0, Oracle, indicated in the <value> UPPER(cmpnt_name)='101-
SQL Server data field. AA
LCASE(<value>)dBase The lower case format of LCASE(loop_name)
Sybase Adaptive Server the contents of the field loop_name = '101-AA'
Anywhere 7.0 indicated in the <value> LCASE(loop_name)='101-aa
data field.

SQL Function and Description Syntax and Output Example

Source Databases
LOWER(<value>) The lower case format of LOWER(loop_name)
Oracle, SQL Server the contents of the field loop_name = '101-AA'
indicated in the <value> LOWER(loop_name)='101-aa
data field.
Related Topics
• Built-In Operators and Functions, page 1441
• Specify a Filtering Condition, page 1428

Primary Keys and Primary Values: An Overview

Each SmartPlant Instrumentation table contains a primary key data field, which, like
the primary key table column, is used as a prime key for accessing the table data. The
difference between the primary key table column and the primary key data field is
that you can only access the latter, whereas the primary key table column is an
internal database key used by SmartPlant Instrumentation only.
Example:
The COMPONENT table contains a primary key table column, CMPNT_ID, which is
an internal SmartPlant Instrumentation database key, and a primary key
CMPNT_NAME, which contains the tag number.
If you import data using the Single table method you can:
• Allow the Import Utility to generate the primary key data field
automatically according to the naming conventions that you will enter; to
do this you will need to manually define appropriate naming conventions
for both the tag and the loop. This way, the primary key data field will
contain the value Computed which means that its contents have been
predetermined by the Import Utility, based on the naming conventions you
entered.
• Use the naming conventions in the link; this way you will need to
manually create the primary key data field contents and naming
conventions by specifying the appropriate parts (for example, PREFIX,
SUFFIX). This way, you define the value of all the target data fields that
you require either by typing in the appropriate value in the target data
field, or by selecting the appropriate source table column and linking it to
the desired target data field.
Note
• If you select to import data using the Single table method you must define
the links of all primary key data fields. If you have selected to import data
using the Module (multiple tables) method, you do not need to define the
links to all the primary key data fields, because it is possible to limit the
import of data only into certain target tables.

At this stage you can also::
• Make a more precise selection by selecting the required source and target
rows which will be processed during the import process.
• Select the reference tables you want to import.
• Save the current link to be used in future import sessions.
• View the source rows.
• Perform a test run to evaluate the import process results.
• Carry out the import process.
After you map all the desired source and target data you can make a more precise
selection. You do this by selecting the source and target rows to be inserted updated
or deleted during the import process.
When you finish defining the mapping between the target and the source, you will
come to the end of the import setup process at which point you will be able to carry
out the actual import of data.
Related Topics
• Configure Source Data for Variable Length Data Fields, page 1451
• Map Source and Target Fields Common Tasks, page 1446
• Tag Class Mapping Codes for Instrument Index Import, page 1454

Map Source and Target Fields Common Tasks

The following tasks are used when you map the fields in your data source with target
table columns in SmartPlant Instrumentation.
Define Links for Naming Conventions

In this procedure you define the source naming conventions of the tag name and the
loop name. You have to go through this stage in one of the following situations:
• You have selected the Redefine the naming conventions check box in
the Tag/Loop tab on the Link Properties dialog box.
• You have started a new import session but you did not clear Define the
naming conventions in the link check box in the Tag/Loop tab on the
Link Properties dialog box.
You define the links for the naming conventions on the Define Tag Name Structure
dialog box and/or on the Define Loop Name Structure dialog box depending on
whether the target contains component names, loop names or both. You have to
complete the definitions in one or both dialog boxes depending on whether the target
table or tables contain one or both naming conventions.
The current naming conventions are those that the Domain Administrator previously
defined in the Administration module. For more information, see Define Links for
Naming Conventions, page 1447.
Open Import Links

This procedure shows you how, after selecting the required import links in the Link
Explorer, you can open the links to view or modify the mapping before importing
data. For more information, see Open Import Links, page 1448.
Define the Import Mapping

This procedure shows you how, after creating the import links and defining the
required properties, to map the source and target data. Depending on the import
method (Single table or Module), you define the link mapping in the appropriate
Import Link window. The table columns that you need to map depend on the target
data type. For more information, see Define the Import Mapping, page 1449.
Configure Source Data for Variable Length Data Fields

Where a source data field is likely to vary in length and it is only a sub-string of
another field, you should ensure that your source data is configured correctly. For
more information, see Configure Source Data for Variable Length Data Fields, page
1451.

Define Links for Naming Conventions

Note
• In this procedure, the Define Tag Name Structure dialog box is used as
an example.
1. If required, do the following to instruct the Import Utility to put leading zeros in
front of the numeric part of the loop / tag name (for example, to have the tag 108-
FT 0001 instead of 108-FT 1) for the loops or tags in all the available import
links:
a. On the File menu, click Preferences.
b. In the Import dialog box, click the Tag/Loop tab.
c. Select Insert leading zeros for numeric values and click OK.
2. In the Link Explorer, select the required links that include loop or tag data.
3. Click to open the Link Properties dialog box and click the Tag/Loop tab.
4. Do the following.
a. Clear Define the naming conventions in the link.
b. If required, select Redefine the naming conventions.
c. If required, select Replace null string with space to instruct the Import
Utility to translate any null strings in your source data into spaces.
d. Click OK.
Tip
• It is advisable to select the Replace null string with space check box
if you are not sure if any source table columns are null or not.
• Click to open the links.
• Click to import data using the links.
6. In the Define Tag Name Structure dialog box, select the name of the source
table from the Source Table Column List data window.
Tip
• You can search for a source name in the Source Table Column List
by pressing the key corresponding to the first letter of the source name.
Make sure you select one of the rows in the Source Table Column
List data window first.

7. Drag the selected source name to the Name Convention window (the target) and
drop it in the appropriate Source Name row.
Tip
• You should ensure that your source data configured correctly if the
loop or tag names are likely to be of variable length. For details, see
Configure Source Data for Variable Length Data Fields, page 1451.
8. In the Start column of the Name Convention data window, enter the starting
location of the string within the naming convention.
Tip
• If you click Cancel in the Define Tag Name Structure dialog box or
in the Define Loop Name Structure dialog box without completing
the tag or loop definition, an appropriate message will be displayed,
after which you will return to the Link Explorer.
9. Select Enable any source name for prefix to allow you to enter any value for the
prefix or clear the check box to restrict the prefix to a fixed value based on the
current plant hierarchy item.
Tip
• If you are importing data for both loops and tag numbers, you must
select or clear this option for both the loop and tag name structures.
10. Click View Source to view the source table. For further details, see Viewing the
Source Data, page 1436.
11. Click OK to proceed with the import setup process.
Related Topics
• Define the Import Mapping, page 1449
Open Import Links

1. In the Link Explorer, select the required groups or links in the Link list.
• On the menu bar, click Actions > Open Link.
• On the toolbar, click (Open Link).
3. In the Import Link window, make changes to the link mapping as required. For
more details, see Using the Link Explorer Window, page 1418.
Related Topics
• Define the Import Mapping, page 1449

Define the Import Mapping

1. In Import Link window, in the Target pane, review the status of the target data
fields. The status is indicated by the following colors:
• Red — Indicates a primary key column (must be defined in the link).
• Blue — Indicates a foreign key column.
• Black — Indicates a regular column in the specific target table.
• Magenta — A column defined as NOT NULL and which is defined
in the Table Definition dialog box as NOT DEFAULT.
Important
• When importing data using the Module method, you do not need to
define the Primary Key links. However, if you want to import any
part of a table, its supporting table, or its reference tables, you must
define that table's Primary Key links.
2. In the Target pane, under Source Name, do one of the following:
• Click the desired row under Source Name, and then select one or
more table columns in turn from the Source pane.
• Type known source table column values.
• Enter a fixed string (for example, a formula) instead of linking source
data. The fixed string must be enclosed in single quotes ('...').
• Drag one or more selected table columns from the Source pane to the
desired row under Source Name in the Target pane.
Tips
• Whenever you drag a new source table column to a field under Source
Name, a + sign is automatically added before the new field, for
example: CMPNT_NAME+FUNC_DESC+FUNC_TYPE
• When defining import mapping for COMPONENT table columns,
you must specify a correct value for the CMPNT CAT ID (Tag
Class) column. For details, see Tag Class Mapping Codes for
Instrument Index Import, page 1454.
3. If needed, in the Source Name fields, use formulas and arithmetic functions. For
details, see Formulas and Arithmetic Functions in Import Links, page 1453.
Tip
• If the total length of the Source Name data field is longer than the
target field length (in the Length data field of the Target pane), a
scissors symbol ( ) appears to the left of the Source Name data field.

4. In the Source Name column, modify the data fields as you require, using various
string operators. For details, see String Operators in Import Links, page 1452.
Tip
• If you need to define import mapping for a process function
(PROC_FUNC_NAME column), note that you can set the software to
use the @PROC_FUNC_NAME macro, so that you do not need to
define manual mapping for process function and instrument type
fields. The software uses this macro if you have assigned process
functions to instrument type fields using the Source tab options of
Link Properties dialog box. For details, see Set Source Fields as
Instrument Type Fields, page 1508. This macro appears in the Import
Link window whenever the PROC_FUNC_NAME column exists in
the target table.
5. After defining all desired settings in the Import Link window, do one of the
following:
• Click to start an import test run which helps you evaluate the import
results without saving data to the target table or tables. For details, see
Test the Import Process, page 1493.
• Click to start the import process.
• Click to save the current link settings in the Import Utility. You can
use the saved link in other import sessions.
Related Topics

Configure Source Data for Variable Length Data Fields

Where a source data field is likely to vary in length and it is only a sub-string of
another field, you should create a separate data field in the source for each of the sub-
strings (PREFIX, MEASURED VARIABLE, FUNCTION TYPE, and so forth).
For example, the source table may contain the following tags (the instrument type is
indicated in bold type):
108FT100
108ICP100
108FT100
108ILP100
In this case the data field in bold type varies in length according to the particular tag.
Therefore, you need to create a separate data field for each of the parts of the
instrument type, for example:
108 FT 100
108 ICP 100
108 FT 100
108 ILP 100
If you have defined a fixed-name string as a prefix, you do not have to link source
data to this part of the naming convention. The Import Utility will create this part
automatically during the import process.
Related Topics

String Operators in Import Links

When defining the import mapping, you can use various string operators in the
Source Name field of the Import Link window. The following string operators are
available:
Operator Description Example

'...' Single quotes. You must '101-FT-100' – imports a
enclose any fixed string in specific tag number.
single quotes if you do not want
to link the source data directly.
(n,n) Sub-string operator. This cab_name(3,2) – indicates that you
operator allows you to transfer a want to transfer two characters from the
sub-string of a source field cab_name field, starting from the third
value by adding in parentheses character.
the string parameters: the
starting character and the string
length.
& Ampersand character. This &spec_note – imports a spec
character allows you to trim any note from a predefined source field
leading or trailing spaces in the without trailing or leading spaces.
imported value. You must add
the & character before the field
value in the link.
# Pound character. The # spec_note1+#+spec_note2 –
character, preceded and imports two spec note from a
followed by a + character predefined source fields and displays
(...+#+...) indicates the end of the second note on a new line.
the current line so that the
imported value following #+
appears on the next line.
Tip
• You can use any combination of the string operators in an import link.
Related Topics

Formulas and Arithmetic Functions in Import Links

When defining the import mapping, as an alternative to using individual source table
columns dragged from the Source pane of the Import Link window, you can also
link together several values in the Target pane, in the Source Name column and use
them as a single source. For example, the source used for the drawing name is dwg +
equip which is a combination of the drawing ID and equipment ID (the '+' character
is entered automatically if you select both sources by dragging them to the same data
field).
The source can be composed of several different functions using the arithmetic
operators (+, -, /, *) in addition to the string operators. The following conventions
apply:
• Arithmetic operators are treated as such only in data fields whose table
column type is number.
• Each arithmetic operator is preceded by the '!' character, for example:
param1 !+ param2 !- param3(If the values are: param1 = 2, param2 = 10, and
param3 = 5, the result of the above formula will be 7.)
• Constants must be enclosed within single quotes, for example:

param1!+ '2' !* '5'
(Since the operations are performed from left to right, if the value of param1 is 2, the
result of the above formula will be 20.)
In the following example, the fluid temperatures are calculated using the base
temperatures in the following formulas:
• Normal temperature = Base temperature + 10

• Minimum temperature = (Base temperature + 10) / 1.2
• Maximum temperature = (Base temperature + 10) * 1.2

The syntax used by the Source Name data field is entered as follows:
Related Topics
Tag Class Mapping Codes for Instrument Index Import

In SmartPlant Instrumentation, if you have instruments belonging to more than one
tag class, you must define a mapping value for the Tag Class (CMPNT_CAT_ID)
column when defining an import link for COMPONENT table columns. In the
database, CMPNT_CAT_ID is the column that contains the tag class ID numbers.
Depending on the import method you selected on the Link Definitions dialog box,
the Import Link window either displays CMPNT CAT ID (the definition in the
database) or Tag Class (the definition in the SmartPlant Instrumentation interface):
• When defining a link for importing data using the Module method, the
Import Link window displays Tag Class under the Target Name column
and also displays CMPNT CAT ID under the Column Name column.
• When defining a link for importing data directly into the COMPONENT
table, using the Single table method, the Import Link window only
displays CMPNT CAT ID under the Target Name column.

The following table lists ID values for all possible instrument tag classes that
SmartPlant Instrumentation supports. Note that there is no 4 value.
Tag Class (CMPNT CAT ID Column) Mapping Code

Conventional 0
Telecom 1
Foundation Fieldbus 2
Typical 3
Electrical Signal Tag 5
Analyzer Component 6
Analyzer Stream 7
Functional Requirement 8
Foundation/Profibus PA virtual tag 9
Profibus DP 10
Profibus PA 11
HART Device 12
HART Signal 13
Soft Tag 14
Related Topics
page 1396
• Import Instrument Index, page 1512
• Importing Data Common Tasks, page 1491
Related Topics

Process Function Mapping Codes for Instrument Index

Import
The following table lists the process functions that exist in SmartPlant
Instrumentation and displays the corresponding codes that you must include in the
import source in a separate column or define manually when mapping the
PROC_FUNC_ID column in the PROCESS_FUNCTION table in the Import Link
window.
Process Function Mapping Code

General 0
Flow 1
Level 2
Pressure 3
Temperature 4
Analyzer 5
Control Valve 6
Relief Valve 7
Caution
• Do not import data into the PROCESS_FUNCTION table. This might
damage your database.
Related Topics
page 1396

Fluid State Mapping Codes for Process Data Import

The following table lists the fluid states that exist in SmartPlant Instrumentation and
displays the corresponding codes that you must include in the import source in a
separate column or define manually when mapping the Fluid State
(PD_FLUID_PHASE) column in the PD_GENERAL table in Import Link
window. Mapping the fluid state is required for process data import or specification
import using the Module (multiple tables) import method.
Note
• In the Import Link window, the Fluid State (PD_FLUID_PHASE)
column is also referred to as Upstream Condition.
Fluid State (PD_FLUID_PHASE) Mapping Code
Gas/Vapor G
Liquid L
Steam S
Water W
Solid/Powder P
Related Topics
• Create Specs Using the Module Import Method, page 1517
page 1396

Mapping Codes for Wiring Data Import

The following table lists all the codes that you need to use for correct import of
wiring data. You must either include the codes in the import source in a separate
column or define the code values manually when mapping the wiring data columns in
Mapping for the DEF_FLG Flag
DEF_FLG Mapping Note

Code
<Plant> data N In SmartPlant Instrumentation, the imported data
import appears in the Domain Explorer in the appropriate
<plant>.
Reference data Y In SmartPlant Instrumentation, the imported data
import appears in the Reference Explorer.
Mapping for the PANEL_CATEGORY Column in the PANEL Table
Important
• After defining mapping for a panel category, you must also define
mapping for the panel sub-category.
Panel Category Mapping Code
Junction Box 1
Marshaling Rack 2
Cabinet 3
Device Panel 4
DCS 5
PLC 6

Mapping for the PANEL_SUBCATEGORY Column in the PANEL Table
Panel Sub-Category Mapping Code

Junction Box 110
Fieldbus Plug-and-Socket Junction Box 120
Splice Panel 130
Patch Panel 140
Telecom Junction Box 150
Marshaling Rack 210
Distribution Frame 220
Cabinet 310
PA Cabinet 320
PABX Cabinet 330
Miscellaneous Cabinets 340
Hub Cabinet 350
Intercom Cabinet 360
Power Distribution Board 370
Device Panel 410
Telecom Plug-and-Socket Device Panel 420
Fieldbus Plug-and-Socket Device Panel 430
Telecom Device Panel 440
Multi-Input Device Panel with Plugs 450
Multi-input Device Panel Without Plugs 460
DCS 510
PLC 610
Telecom Equipment 620

Mapping for the STRIP_CATEGORY Column in the PANEL_STRIP Table
Terminal Strip Category Mapping Code

Regular Terminal Strip 0
Plug-and-Socket Box 2
Connector 6
Switch Port (Telecom) 7
Apparatus 8
Mapping for the TERMINAL_CATEGORY Column in the

PANEL_STRIP_TERM Table
Terminal Category Mapping Code

Regular Terminal (General) G
Apparatus Right Terminal R
Apparatus Left Terminal L
Apparatus Left and Right Terminal H
Mapping for the CABLE_CATEGORY Column in the CABLE Table
Cable Category Mapping Code

Fieldbus Home-Run H
Conventional R
Telecom T

Mapping for the APPAR_CAT_ID Column in the APPARATUS Table
Wiring Equipment Category Mapping Code

Miscellaneous Wiring Equipment 0
I/O Card 1
I/O Termination 2
Hub 4
Intercom 5
Switch 6
Miscellaneous Telecom Equipment 7
Fieldbus Brick 8
Isolator 9
Safety Barrier 10
Relay 11
Trip Amplifier 12
Amplifier 13
Mapping for the CHANNEL_CATEGORY Column in the CHANNEL Table
Channel Category Mapping Code

Conventional G
Apparatus H
I/O Channel I
Related Topics
page 1396

Import Comparison
Import Comparison
After you have run an import session on a set of data at least once, you can run
subsequent sessions by comparing the new rows to be imported with previously
imported rows. You can do this from the Import Comparison List dialog box as
well as from the Comparison tab in the Link Properties dialog box. You can also
start transferring data after you have selected specific rows that you want to import
from the source to the target. For details of the import comparison criteria and how to
modify them, see Setting the Target Table Definitions: An Overview, page 1464.)
Related Topics
• Comparison Options Common Tasks, page 1469
page 1396
• Setting the Import Comparison List Options, page 1463

Import Comparison
Setting the Import Comparison List Options

During the import process the Import Utility modifies the contents of the SmartPlant
Instrumentation database (for example, the target module or table). This is done by
inserting, deleting and updating rows in the SmartPlant Instrumentation database. It
is therefore advisable to be able to coordinate between these rows before you start the
import process.
This feature provides you with the means to coordinate between the rows to be
inserted, deleted or updated during the import process. You do this by reviewing the
source and target rows and selecting the appropriate rows which will be processed
Note
• The Comparison tab only becomes active after the first time you have
imported data and saved the selected link.
Related Topics
• Import Comparison, page 1462

Import Comparison
Setting the Target Table Definitions: An Overview

You can control the way in which the Import Utility regards the source and the target
rows as identical during the import process. This is important, because when the
Import Utility encounters identical source and target rows, it can overwrite the target
row or leave it intact, depending on the Comparison options which you select on the
Link Properties dialog box. You can therefore control the import process result by
selecting the appropriate import comparison criteria.
In SmartPlant Instrumentation, the database is organized in tables, for example:

CABLE, COMPONENT, CONTROL_VALVE, and so forth. These tables contain
data arranged in table columns, which represent properties of various item types such
as instruments, cables, panels, and so forth.
For example, the COMPONENT table contains all the instrument tag data together
with the appropriate links to other tables, which utilize tags, such as
COMPONENT_MFR (instrument manufacturer table), COMPONENT_MOD
(instrument model table), and so forth.

Import Comparison
In the following example, the COMPONENT table primary key is CMPNT_ID.

This means that each row in the COMPONENT table has a unique value for the
CPMNT_ID table column.

Import Comparison
The CABLE_MFR_MOD table key definition consists of the CABLE_MFR_ID

and CABLE_ MOD_ID keys. These keys ensure that the value of any particular
cable model is unique. Both keys are required because different manufacturers may
use the same model number, and therefore the manufacturer name must be included
to specify model uniqueness, as shown in the following example.
Every SmartPlant Instrumentation table has a key definition, which is used to specify
a unique set of values. You can use one or more table columns in each table as
components of the key definition.
Key Name – This is found in every table and is used only by SmartPlant
Instrumentation to access the corresponding table. The key name table column is
usually denoted by an _ID suffix. In most cases, the key name is designated as a
primary key.
Reference Table Column – A reference table column is found in every table and is
used by the user to access the table. For the COMPONENT table, the reference
column is CMPNT_NAME. This means that each row in the COMPONENT table
has a different value in the CPMNT_NAME column.

Import Comparison
Foreign Key – In some tables, the key name is designated as a foreign key, which is
used as a reference table column to link to another table called a reference table. For
example, the CPMNT_MFR_ID foreign key in the COMPONENT table contains
the COMPONENT_MFR table value in its key definition. This way, the
CPMNT_MFR foreign key table column links the COMPONENT table to the
COMPONENT_MFR table. This allows SmartPlant Instrumentation to obtain the
required instrument manufacturer data from the COMPONENT_MFR table.
Regular Table Column – This is found in most tables and contains the appropriate
table data such as display color, item price, remarks, specifications, and so forth.
Caution
• Changing the settings in the Table Definition dialog box alters the
relations between the tables. We therefore recommend you do not change
these settings unless absolutely necessary and only if you are familiar with
the SmartPlant Instrumentation database structure.
Notes
• Both the key name and the reference table column provide access to the
SmartPlant Instrumentation database, but only the reference table column
is accessible to you (the key name is for SmartPlant Instrumentation
internal use only).
• When comparing rows, the Import Utility treats source and target rows as
identical only if both the source and the target Reference Table Column
values are the same. For example, if the COMPONENT table in both
source and target rows contains the same values in the Reference Table
Column data fields, both rows are considered as identical.
• When the Import Utility encounters identical source and target rows it can
either replace the contents of the target row with the source row contents
or leave this target row intact, depending on the import process settings.
You can select an appropriate reference table column for every table in the database.
This way you can create a different comparison criteria for each table.

Import Comparison
You can also create a link to other tables by defining appropriate foreign key table
columns. This way the Import Utility imports additional reference data during the
import process, depending on the selection you make on the Source tab of the Link
You can perform the following actions:
• Modify the target table primary key and foreign key table column
definitions.
• Clear the current definitions of table columns.
• Save the changes that you make to the table structure in an existing
structure definition or create a new definition.
Related Topics

Import Comparison
Comparison Options Common Tasks

The following tasks are used when you compare import data against data already
imported.
Modify Table Column Definitions

Use this procedure to modify the table column definitions in the target database. For
more information, see Modify Table Column Definitions, page 1470.
Delete Table Column Key Definitions

Use this procedure to delete existing table column key definitions. For more
information, see Delete Table Column Key Definitions, page 1477.
View the Source and Target Rows

You can view the source and target rows according to the selection you made, or per
process (for example, rows that will be inserted, rows that will be deleted, and so
forth). For more information, see View the Source and Target Rows, page 1478.
Filter the Displayed Target Rows

You can filter the target rows displayed in the Import Comparison List dialog box.
Note that filtering the target rows this way will not affect the target rows currently
selected to be included in the import process. For more information, see Filter the
Displayed Target Rows, page 1478.
Preview and Print the Source and Target Rows

This option enables you to preview and print out the source and target rows displayed
in the Import Comparison List dialog box. For more information, see Preview and
Print the Source and Target Rows, page 1479.
Import Data Using the Comparison List

Use this procedure to import data using the comparison list. For more information,
see Import Data Using the Comparison List, page 1479.
Related Topics
page 1396

Import Comparison
Modify Table Column Definitions

• On the Service menu, click Target Table Definition.
• With the Link Properties dialog box open, click Target Definition.
Tip
• If you open the Table Definition dialog box by clicking Target
Definition in the Link Properties dialog box, you will not be able to
modify the definition of tables other than the one you selected in the
Link Definition dialog box.
2. In the Table Definition dialog box, under Table List, highlight the table whose
column definitions you want to modify.
Tip
• The appropriate option button (beneath the Table List section)
becomes automatically active. This option button indicates the plant
hierarchy level of the table in the target domain.
3. Click Definition.
4. In the Definition Names dialog box, do one of the following:
• In the Description data window, select an existing definition.
• Click Insert to add a new definition in the Description data window
and type the new definition name.
Tip
• For certain tables with several available existing definitions, you must
select a definition that is appropriate for the type of association of the
items that you are going to import. For example, when importing
panel-strip data, you might have some panels with direct connections
to strips, and other panels that include items above the strip, such as a
panel- rack-apparatus-strip association. In this case, you would create
several links, each with an appropriate definition for the desired
association.
5. Click OK to return to the Table Definition dialog box.

Import Comparison
6. In the Column Definition section, do the following:

a. Select Visible for each table column you want to display in the Import Link
window.
b. Select Default for each table column to apply the default value (space, zero or
asterisk) in the case where the data field is empty during the import process.
Caution
• For some table columns (for example, primary keys) the Import Utility
automatically clears the Visible check box. We recommend that, to
avoid import failure, you do not make these table columns visible.
7. To set the type of the table column selected under Key Definition, do one of the
following:
• Click Primary key to use this table column as a primary key.
• Click Foreign key to use this table column as a foreign key, then
double-click to close the Foreign Key List window (see the

following step for more details).
• Accept the given default values.
8. To modify the definition of a foreign key, with the Foreign Key List window
open, drag the required foreign key from Foreign Key List to Key Definition in
the Table Definition dialog box.
9. To link the selected table column to a reference table, do the following:
a. From the Reference Table list, select the appropriate reference table.
b. From the Reference Column list, select the appropriate Primary Key data
field.
Tip
• The value under Reference Column can be one of the following:
• A table column name in the current table, if the current key is not a
foreign key.
• A table column name in the reference table specified under the
Reference Table column, if the current key is a foreign key.
10. From the Reference Key list, do one of the following:
• Accept the given default values (recommended).
• Select the appropriate reference key if required.

Import Comparison
11. To determine the way the current key will be numbered in the target database
(note that this is an internal value which is not accessible to you), do one of the
following:
• Select the Local check box to follow the previous- level numbering to
make the currently defined table column address unique in the target
database.
• Clear the Local check box to follow the global numbering in
12. To modify the definition of the additional column of the current table, do the
following:
a. Drag the appropriate table columns from Column Definition to Key
Definition.
b. Specify the data fields that the Import Utility will create during the import
process before generating a selected target data field by selecting Define
parameters for Level Key. This way, the Import Utility will create the table
columns specified under Level Key (in the Column Definition data window)
before creating the corresponding table columns under Column Name.
c. In the Column Definition data window, click to view the Level Key data
column.
d. In the Level Key data column, do one of the following:
• Type the names of the table columns to be created by the Import
Utility during the import process before it creates the
corresponding table columns under Column Name.
• Clear Define parameters for Level Key to discard the table
columns specified under Level Key.
13. Repeat all of the above steps in this procedure for each table column.
14. Click OK.
15. When prompted, click Yes to confirm the changes and clear the Key Definition
data window.
Tips
• You can select another table and skip the changes you made to the
current table as follows:
• In the Table List data window, select another table.
• Click Definition and then click No in the message dialog box.
16. Click Save to save your selection of table keys.

Import Comparison
17. At the prompt to confirm the new definitions, do one of the following:
• Click Yes to open the Definition Names dialog box and save the new
definition.
• Click No to return to the Table Definition dialog box and modify your
definitions.
18. Repeat steps 1 through 16 of this procedure for each required table.
19. Click Close to close the Table Definition dialog box and return to the Link
Explorer.
Related Topics
Modifying Table Column Definitions - Table Definitions Note

Every SmartPlant Instrumentation table is defined at a specific plant hierarchy item
level. This means that the value of the primary key column of that table is unique on
the specified level.
For example:
The primary key column value of the COMPONENT table is CMPNT_NAME. If

you define the COMPONENT table on the <unit> level, then the CMPNT_NAME
value will become unique on the <unit> level. This means in the <unit> level there
cannot be more than one row with a particular value in the CMPNT_NAME table
column.
Modifying Table Column Definitions - Column Colors Note

• The table columns appear under Column Definition in four possible
colors:
• Red — Primary key (must be defined)
• Blue — Foreign key
• Black — Regular column in the specific target table
• Magenta — Reference table column which is defined as a regular
table column (for example, not used to get linked data)
• In SmartPlant Instrumentation, each table column has a numeric address
which is used in the SmartPlant Instrumentation database to access the
information in that column. In the Table Definition dialog box you can
determine that the table column address will be unique either in the target
database (for example, locally) or in SmartPlant Instrumentation.

Import Comparison
Modifying Table Column Definitions - Column Status Note

You can use the Column status button also to change the target table column type
(for example, from char to number and vice versa). This is required if the source
table column and the target table column are of different types (for example, one table
column is defined as char and the other is defined as number). In this case you can
change the column type of the target table into char by defining it as a foreign key or
change the table column type into number by deleting this column key definition
(see Delete Table Column Key Definitions, page 1477 to learn how to delete the
column key definition).
Modifying Table Column Definitions - Key Note

A primary key and a foreign key may contain more than one table column.
For example:
The CABLE table primary key can contain both CABLE_ID and CABLE_NUM
table columns. Each key is numbered in the table. If a key contains more than one
table column, each table column is numbered in the key.
For example:
If CABLE_ID and CABLE_NUM are the table columns comprising the CABLE
table primary key, then each table column has a serial number within the CABLE
table primary key (for example, 1 and 2).

Import Comparison
Modifying Table Column Definitions - Key Caution

Selecting a value for the Reference Key table column is not required if the current
key is a not a Foreign Key.
When the current key is a foreign key, two situations are possible:
• The value in the Reference Key data column is the same as the one
specified under Key Name; in this case the Reference Key data column is
left empty.
For example:
If using the CABLE_MOD_ID from the CABLE table in the key definition, the
key name CABLE_ID is identical to the reference key.
• The value in the Reference Key data column is different from the one
specified under Key Name; in this case the appropriate value appears
under the Reference Key data column, and the column title Reference
Key is displayed in bold text.
For example:
If using the CONNECTOR_SIDE1_ID from the CABLE table in the key
definition, the key name CABLE_ID is different from the reference key, the value
of which in this case is CONNECTOR_ID.

Import Comparison
Modifying Table Column Definitions - Numbering System Note

The software uses three numbering systems:
• A global numbering system: this way the selected key number originates
from a general number list that applies to the entire system.
• A local numbering system: this way the selected key is numbered within a
table or an object (for example, Panel, Cable, and so forth). For example:
• The PANEL_STRIP table Primary Key field consists of two sub-
fields:
• PANEL_NAME that originates from the PANEL Table and is
numbered globally.
• STRIP_NAME which is numbered locally.
This means that in every new panel, the strip numbering restarts from 1, whereas the
panel numbering continues the global numbering which exists in SmartPlant
Instrumentation.
• A local revision numbering system: this is a local numbering method

which starts from zero instead of from one.
Modifying Table Column Definitions - Key Level Note

The key level operation is designated for tables that contain strip data
(STRIP_CONFIG, STRIP_MFR, and so forth).
You can specify what fields the Import Utility creates during the import process prior
to generating a selected target field. You do this by activating the level key option
and specifying the required target field(s) to create prior to generating the selected
target field.
For example:
The Strip Manufacturer Models (STRIP_MFR_MOD) table Primary Key field

contains two columns: STRIP_MFR_ID and STRIP_MOD_NAME.
To generate the STRIP_MOD_NAME field, the Import Utility will create the
STRIP_MFR_ID and the STRIP_MOD_ID fields prior to generating the
STRIP_MOD_NAME field.
If you select Define parameters for Level Key, the Import Utility will automatically
create the fields which you specify in the Level Key field (in the Column Definition
data window) prior to generating the corresponding field in the Column Name data
field.

Import Comparison
Delete Table Column Key Definitions

1. With the Table Definition dialog box open, select the required table in the Table
List data window.
2. Click Definition.
3. In the Definition Names dialog box, under Description, select the required
definition.
• Click Delete to delete the required definition.
• Click OK to display the columns of the selected table in the Table
List data window.
Tip
• The appropriate table columns appear in the Column Definition
section. The comparison definition also appears under Key
Definition.
5. Click Delete Key to delete all the key definitions of the selected table.
6. At the prompt, click Yes to confirm the deletion
7. Click Save to save your selection of table keys in the Import Utility.
8. When prompted, click Yes to save the changes you performed.
9. Repeat steps 1 through 8 of this procedure for every required table.
10. Click Close to close the Table Definition dialog box and return to the Link
Explorer.
Related Topics

Import Comparison
View the Source and Target Rows

1. On the Import Comparison List dialog box, under Show, do one of the
following:
• Select All to view all target rows.
• Select the Selected option to view only the selected target rows.
Selecting this option displays only the rows you have previously
selected.
• Select By mode to view the displayed rows according to their import
mode.
2. If you selected the By mode option, under Import mode, do one or more of the
following:
• Select Inserted to select all the source rows whose status is Insert (for
example, the letter I appears in the Mode column).
• Select Updated to select all source and target rows whose the status is
Update (for example, the letter U appears in the Mode column).
• Select Deleted to select all source rows whose status is Delete (for
example, the letter D appears in the Mode column).
• Select Refreshed to select all source and target rows whose status is
Refresh (for example, the letter R appears in the Mode column).
Tip
• You can select more than one import mode by which the data in the
data window will be displayed. This way you show the source and
target data by more than one import mode.
3. Click Display to display rows in the Comparison data pane according to the
specified filtering options.
Related Topics
Filter the Displayed Target Rows

• At the bottom of the Import Comparison List dialog box, click Filter to
open the Import Target Filter dialog box.
Tip
• The source table columns available in this data window are only the
ones currently displayed in the Import Comparison List dialog box.
These are the same table columns that you linked in the Import Link
window.

Import Comparison
Preview and Print the Source and Target Rows

1. At the bottom of the Import Comparison List dialog box, click Report.
2. On the Print Preview dialog box, view the displayed data.
Tip
• Placing the cursor on the scroll box displays the current page number.
Scroll the box down in the scroll bar to display the total number of
pages that the printout includes.
3. Click Print.
Related Topics
Import Data Using the Comparison List

• In the Import Link window for a table or module, click .
• Specify the deviation options on the Comparison tab of the Link
Properties dialog box. This method applies only if you started this
import session using a saved link.
2. In the Import Comparison List dialog box, under Show, click All to display all
the data rows.
Tip
• If you have already defined a source filter condition in this session (in
the Link Properties dialog box), only the source rows which comply
with this condition will be displayed in the Import Comparison List
dialog box. See Specify a Filtering Condition, page 1428 for details.
3. Select the required data rows to be processed for import by doing one of the
following:
• Select the check box in the Select column for each row you want to
include.
• In the Select rows section, click the All button to select all the rows.
• In the Select rows section, select one or more of the check boxes to
include all the rows where the mode corresponds to the selection.
4. Select Re-open the Comparison List.
Tip
• Rows where data was changed are highlighted in light blue.

Import Comparison
5. Click Test to check the import process without actually saving data to the target
table.
6. Modify the link mapping, if required, to correct any errors.
7. Click Run to import the data.
Related Topics

Import Comparison
System Codes: An Overview

When importing data from a non-SmartPlant Instrumentation database that uses
system or unit of measure codes different from the ones used in your target
SmartPlant Instrumentation database, you are required to adapt the source system and
unit of measure codes to the codes used in your target SmartPlant Instrumentation
database. This feature can also be used to adapt system and unit of measure codes of
a SmartPlant Instrumentation source domain, when importing data from one
SmartPlant Instrumentation domain to another.
Suppose a source table contains a code (for example, A) that is used as a reference in
another source table. This code may be different from the one used in your
corresponding target SmartPlant Instrumentation database (for example, psia).
Therefore, prior to running import, you have to make the appropriate adaptations for
the system codes and unit of measure codes.
Note
• If you want to use system codes in your current import session, you must
select the appropriate source system and adapt its code prior to starting the
import of data (see the procedure below for details). Also note that the
target code values are predefined in the system and cannot be modified.
When importing process data and/or calculation data and the units of
measure are not defined, the Import Utility will insert default unit of
measure values belonging to the SmartPlant Instrumentation <unit> with
which the imported tag data is associated.
To adapt source system and unit of measure codes you need to do the following:
• Select the source system whose codes you want to adapt. for details, see
Define Source Systems, page 1483.
• Adapt the source codes to the target codes. for details, see Adapt System
Codes, page 1484.
Using this feature you can also keep the code adaptation data in a text file (with a .cds
extension) and use it in future import sessions. You can do the following:
• Import a code file that contains adapted system codes, unit of measure
codes or both. For details, see Import Codes, page 1487. Importing codes
this way does not overwrite the current code adaptations.
• Export a code file that contains adapted system codes, unit of measure
codes or both. For details, see Export Codes, page 1487.
• Display the name of the source system set as the currently source system.
For details see View the Currently Selected Source System Name, page
1488.

Import Comparison
Working with System Codes Common Tasks

The following tasks are used when you import data from a non-SmartPlant
Instrumentation database that uses system or unit of measure codes different from the
ones used in your target SmartPlant Instrumentation database.
Define Source Systems

Before you can adapt the source codes to comply with the target codes, you need to
specify the source systems whose codes you want to adapt. At this stage, you also
select the current source system whose codes you want to use during the current
import session. For more information, see Define Source Systems, page 1483.
Adapt System Codes

Use this procedure to adapt the codes which are not associated with units of measure
to the codes that are used in the target SmartPlant Instrumentation database. Several
source code values can be represented by a single target code value. For example, the
source code values AA, BB, CC, DD can be represented by (adapted to) a single
target code: XX. For more information, see Adapt System Codes, page 1484.
Adapt UOM Codes

This procedure shows you how to adapt unit of measure codes for SmartPlant
Instrumentation. For more information, see Adapt UOM Codes, page 1485.
Import Codes
This feature allows you to import from the same code file (with a .cds extension) both
the system codes and the unit of measure codes or just one of them, depending on
whether these codes exist in the ASCII file you are going to use. This way you can
use code adaptation settings that were previously saved in files without having to
redefine the code adaptation for every case. For more information, see Import Codes,
page 1487.
Export Codes
This feature allows you to export the current code settings of any selected source
system to a code file (with a .cds extension). You can export both the system codes
and the unit of measure codes or just one of them. This way you can keep code
adaptation settings in a file and use them in future import sessions without having to
redefine the code adaptation for every case. For more information, see Export Codes,
page 1487.
View the Currently Selected Source System Name

This option enables you to view the currently selected source system name. For more
information, see View the Currently Selected Source System Name, page 1488.

Import Comparison
Use Source Codes in an Import Link

After you have adapted unit of measure codes and system codes, this procedure
describes how to use them in your import links. For more information, see Use
Source Codes in an Import Link, page 1488.
Related Topics
• System Codes Table, page 1537
• System Codes: An Overview, page 1481
• Unit of Measure Codes Table, page 1547
Define Source Systems

1. On the System Codes menu, click Select Source System.
2. In the Source System List dialog box, do one of the following:
• Add a new source system (see step 3).
• Edit an existing source system name (see step 4).
• Delete an existing source system (see step 5).
• Select the current source system (see step 6).
3. To add a new source system:
a. Click New.
b. Click in the highlighted line.
c. Type the new source system name.
4. To edit an existing source system name:
a. In the data window, highlight the source system whose name you want to
modify.
b. Click Edit to make the line selected in the data window.
c. Edit the source system name as required.
5. To delete an existing source system:
a. In the data window, highlight the source system you want to delete.
b. Click Delete to delete the line selected in the data window.
6. To select the current source system, in the data window, highlight the required
line and click OK.
Related Topics
• Working with System Codes Common Tasks, page 1482

Import Comparison
Adapt System Codes

Note
• For a list of system codes you can adapt, see System Codes Table, page
1537.
1. On the System Codes menu, click Adapt System Codes.
2. In the Source System List dialog box, select the source system whose codes you
want to adapt. The available source systems are the ones you entered in the
Source System List dialog box.
3. In the Adapt System Codes dialog box, under Module, do one of the following:
• Click All to make all properties available.
• Click the SmartPlant Instrumentation module whose properties you
want to make available (Process Data, Wiring, or Calculation).
• Click Other to make the properties available for all modules except
for Process Data, Wiring, and Calculation.
4. From the Code Values list, select the property whose codes need adapting.
5. To set the code values, do the following:
a. In the data window, click the Source Code field of the appropriate code. The
selected Source Code field becomes editable (if the field color was light blue,
it changes to white).
b. Type the source value corresponding to the target system code value.
c. To clear the currently selected source system code value, click Unused.
d. To specify an additional source system code value for the target system code
value currently selected in the data window, click Duplicate and type an
additional value in the Source Code column of the new row.
Tip
• You can only set the values of source codes where the Source
Code field color is either light blue or white.
6. Repeat steps 3 through 5 for every required SmartPlant Instrumentation module.
7. Repeat steps 2 through 6 for other source systems whose codes need adapting.
8. Click OK to close the Adapt System Codes dialog box.
Note
• You can adapt system codes and unit of measure codes only if you
selected a source system.
Related Topics

Import Comparison
Adapt UOM Codes

Note
• For a list of system codes you can adapt, see Unit of Measure Codes
Table, page 1547.
1. On the System Codes menu, click Adapt UOM Codes.
2. In the Adapt UOM Codes dialog box, from the Source System list, select the
source system whose codes you want to adapt. The available source systems are
the ones you entered in the Source System List dialog box.
3. From the UOM Type list, select the UOM category whose codes need adapting.
4. To set the code values, do the following:
a. In the data window, click the Source UOM Code field of the appropriate
code.
Tip
• You can only set the values of source codes where the Source
UOM Code field color is either light blue or white.
b. Type the source value which corresponds to the target UOM code value.
c. Click Unused to clear the currently selected source UOM code value.
d. Click Duplicate to specify an additional source UOM code value for the
target UOM code value currently selected in the data window.
5. Repeat steps 3 and 4 for every required SmartPlant Instrumentation module.
6. Repeat steps 2 through 5 for other source UOM whose codes need adapting.
7. Do one of he following:
• Click OK to save the changes you made to the current UOM code
settings and close the Adapt UOM Codes dialog box.
• Click Save to save the changes you made to the current UOM code
settings and keep the Adapt UOM Codes dialog box open. This way
you can save the portion of the work you have done so far and keep
working in the Adapt UOM Codes dialog box.
Related Topics
• Adapting UOM Codes - Special Characters, page 1486
• Use Source Codes in an Import Link, page 1488

Import Comparison
Adapting UOM Codes - Special Characters

To type power indexes (for example, 2 as in cm2) and other special characters (for
example, as in C), do the following:
• Run the Windows Character Map utility and select the appropriate
character to copy and click the Copy button.
• Switch to Import and paste the character in the required location.
• Hold down Alt and, with the Num Lock indication on, type the
required character's ASCII value (a four-digit number) using the
keyboard numeric keypad (see your Windows User Guide for
additional information about ASCII numbering).
For example:
Type Alt + 178 to add: 2
Type Alt + 179 to add: 3
Related Topics
• Adapt UOM Codes, page 1485
• Use Source Codes in an Import Link, page 1488

Import Comparison
Import Codes
1. On the System Codes menu, click Import Codes.
2. In the Import System and UOM Codes dialog box, do one of the following:
• Under Select File, type the full path and filename of the ASCII file
from where you want to import the codes, if you know it.
• Click to navigate to the required file.
3. Under Import Data, click the code type you want to import: System Codes,
UOM Codes, or both.
Tip
• The code type that will be imported depends on whether the file you
selected in step 2 in this procedure actually contains the code type that
you select in the Import Data section.
4. Click OK to import the selected codes.
Note
• Importing codes from an external file does not overwrite existing code
settings.
Related Topics
Export Codes
1. On the System Codes menu, click Export Codes.
2. In the Export System and UOM Codes dialog box, select one or more source
systems whose code settings you want to export to a file. To deselect a system,
click it again.
3. Under Export Data click the code type you want to import: System Codes,
UOM Codes, or both.
4. Click OK.
5. In the Enter Export File Name dialog box, select the file where you want to keep
the codes of the system you selected in step 2 in this procedure.
6. Click Save to export the codes to the selected file.
Related Topics

Import Comparison
View the Currently Selected Source System Name

• On the System Codes menu, click Current Source System.
Related Topics
Use Source Codes in an Import Link

1. In the Link Explorer, select the link where you want to use source codes.
2. On the Actions menu, click Properties.
4. Select Use system codes.
5. Click OK.
6. In the Update mode, if prompted to use the overwrite option, click Yes.
7. Open the link which you want to use to import your data.
8. Define the link mapping by dragging the appropriate source names to the target
window.
9. In the Import Link window link, select the check boxes in the target window
under the Code column for those link parameters for which you want to use
source codes.
Tip
• To use all available source codes in the link, on the menu bar, click
Actions > System Codes > Check All.
Related Topics

Import Comparison
General Import Prerequisites

Before importing data into SmartPlant Instrumentation, the following general
prerequisites must be met:
• There must be a target SmartPlant Instrumentation domain containing at

least one plant hierarchy item at the lowest level of the hierarchy (by
default, this is a <unit>). You create plant hierarchy items in the
• There must be a naming convention for instruments and loops in each
target <unit>. This is necessary only if you intend to work with tables
whose columns require naming conventions (for example, COMPONENT,
LOOP). You set naming conventions in the Administration module.
Related Topics
page 1396
• Prerequisite for Importing Instrument Types, page 1506

Import Comparison
Matching Naming Conventions

It is very important to adjust the import links so that they match the naming
conventions of tags and loops used in the domain into which you are about to import
data.
For example, in the SmartPlant Instrumentation demonstration domain, the naming

convention structure of conventional instruments is as follows:
101-AAAA-BBBB
In this convention, 101 is the <unit> number prefix, AAAA represents the instrument
type segment and BBBB represents the tag number segment; the hyphens are segment
separators. Therefore, an instrument with tag number 101FE22212 is represented in
the demonstration domain as 101-FE -2212.
Before starting the import setup process, you need to pay attention to the source table
columns that construct the source instrument and loop and how they match the
SmartPlant Instrumentation instrument and loop data.
When you select an import link that is associated with either instruments or loops,
you are prompted to define the naming convention structure.
Caution
• When redefining the naming convention structure, make sure that no data
redundancy is created. Such a redundancy may be caused, for example, if
the source table columns use data segments that are shorter than those
used in the target table columns. For example, the 101PS2212 source tag
number uses only a two character table column for the instrument type. In
SmartPlant Instrumentation, this tag number appears as 101-PS - 2212.
This situation may cause data redundancy, since this tag number can stand
for either 101-PSH -2212 or 101-PSL-2212.
Related Topics
• Importing Instrument Index Common Tasks, page 1503

Import Comparison
Importing Data Common Tasks

The following tasks are used when importing data.
Data Import Process

The data import process involves creating links that map between the source and the
target object (module or table). After defining the links, you perform the actions that
import the data into SmartPlant Instrumentation. For more information, see Data
Import Process, page 1492.
Test the Import Process

You can run a test of the import process according to the parameters you have set in
the Import Link window. The software tests the import process without carrying out
the actual import of data, for example, without inserting, updating or deleting rows of
the SmartPlant Instrumentation database.
Testing the import process can be useful when testing a single link before carrying
out a large batch operation. A test can also give you an indication on the rejected
rows and allow you to fix the problem prior to a batch operation. A test run is carried
out slightly faster than the actual import operation. For more information, see Test
the Import Process, page 1493.
Run an Import Session from the User Interface

Use this procedure to run an import session from the user-interface. For more
information, see Run an Import Session from the User Interface, page 1494.
Run an Import Session from the Command Line

You can use command-line parameters to start an import session that will execute an
existing import link. This way you can import data using the settings in the selected
link without having to utilize the Import Utility. For more information, see Run an
Import Session from the Command Line, page 1495.
Execute the Import of Data

This procedure shows you how, after you finish defining the links between the source
and target, you can execute the import of data. For more information, see Execute the
Import of Data, page 1496.
Related Topics
page 1396

Import Comparison
Data Import Process

Caution
• We recommend proceeding cautiously with the import process, as some of
the Import Utility features change the structure and contents of the target
database.
Important
• Before importing data, familiarize yourself with import prerequisites. For
details, see General Import Prerequisites, page 1489. Also, if you intend
to import a large number of records (more than 400 records) in one import
session, you must create a new section in the Intools.ini file called [Rules]
and add the following parameter: disable = y.
1. Select the import method (Module or Single table).
2. Select the target SmartPlant Instrumentation table or module for the import.
When importing data to tables, the order of the import is important. You should
first import data into a table that the next table refers to (for example, before
importing data into the COMPONENT table, you should import data into the
COMPONENT_LOCATION table, if you want import both instrument
locations and instrument tag numbers.
3. Set the import parameters. This includes:
• Selecting specific source rows.
• Specifying a filtering condition.
• Reviewing and modifying the table definition.
• Defining a source consisting of more than one table or file.
4. Establish a link between the source and the target data. You can do one of the
following:
• Use an existing link that was saved previously
• Build a new link and save it (see step 5).
5. To build a new link, do the following:
a. Set the appropriate parameters for the import.
b. Where appropriate, define the structure of the import link.
c. Define the link mapping between the source and the target table columns.

Import Comparison
6. Run an import test or perform the import process.

The results of running a test provide you with information about the expected
outcome of the actual import process.
Notes
• You can modify the source definition after creating the link to insure that
all required data exists in your source database. Use the SmartPlant
Instrumentation Data Dictionary to help you identify target SmartPlant
Instrumentation tables.
• You can run import links in batch mode from the command line. For
details, including the appropriate parameters, see Run an Import Session
from the User Interface, page 1494 and Run an Import Session from the
Command Line, page 1495.
• If required, you can reset the import order as well as select the reference
tables to import. To learn how to control the import order, See Setting the
Target Table Definitions: An Overview, page 1464.
Related Topics
• Execute the Import of Data, page 1496
• Test the Import Process, page 1493
Test the Import Process

Note
• You can perform a test run of a sub-set of the selected source and target
data by applying the appropriate filtering condition to the data (see Specify
a Filtering Condition, page 1428) and / or partially linking the source and
target data (see Define the Import Mapping, page 1449).
1. With the Import Link (table) or Import Link (module) window open, click
to start checking the import process.
Tip
• It is recommended that you define a log file, if you have not yet done
so.
2. On the Import Progress Test dialog box, which opens automatically, view the
expected import process results.
Tip
• The test results are inaccurate when you import data in a group of links
of which some links are related as in the example: cable, cable set, and
wire. Also, the test results are inaccurate when you import one or
more source tables containing multiple prime values.

Import Comparison
Run an Import Session from the User Interface

1. Select the Import application from the SmartPlant Instrumentation program
group in the Windows Start menu.
2. In the Login dialog box, type the Domain Administrator name and password.
3. In the Open dialog box, drill down to select the target <unit> into which you will
import data.
Tip
• Whenever you start the Import Utility, you are prompted to select a
target <unit>. For some data it is inapplicable to be associated with a
particular plant hierarchy item, however, you must always select a
<unit> to import data into.
4. In the Domain Name data field, select the target domain, for example, the
domain to which data will be imported.
5. In the data window, double-click the icons for the appropriate plant hierarchy
items to expand them and select the required target <unit>.
6. Click OK to open the Import Utility Link Explorer.
Related Topics

Import Comparison
Run an Import Session from the Command Line

1. On the Windows Start menu, click Run.
2. In the Run dialog box, type the following parameters (on one line):
[home folder]\import [username],[password],[Domain name],
[<plant> name], intermediate plant hierarchy item 1
[/intermediate plant hierarchy item 2][/intermediate plant
hierarchy item 3]...,[<unit> name],[link name] - or - @[group
name],[Project name]
Note
• Plant hierarchy item names into which you intend to import data may
not contain / characters because the software interprets these
characters as separators between successive hierarchy levels.
The phrases in brackets stand for the following parameters:
• [home folder] - the folder where you installed SmartPlant

Instrumentation.
• [username], [password] - the Domain Administrator's username and
password.
• [Domain name] - the target domain.
• [<plant> name] - the plant or equivalent highest level item in the
plant hierarchy.
• [intermediate plant hierarchy item 1][/ intermediate plant
hierarchy item 2][/ intermediate plant hierarchy item 3]... - when
you want to import source data from multiple plant hierarchies into the
target plant hierarchy and the intermediate plant hierarchy has two or
more levels, use the character defined in the Administration module as
the plant hierarchy separator for the domain, for example, /. (If no
separator is defined in the Administration module, use / as the default.)
• [<unit> name] - the unit or equivalent lowest level item in the plant
hierarchy.
• [link name] - the name of the import link you want to execute in the
current import session.
• [group name] - the name of the group whose links you want to
execute in the current import session. When used, this parameter is
always preceded by a commercial sign @.
• [Project name] - the target project when working in an Operating
owner domain.

Import Comparison
Examples
The following are two examples of using the command-line syntax:

a. Importing data to the demonstration domain by executing a link named Flow
in an Operating owner domain (the following statement should be typed on
one line):
import DBA,DBA,Demo Domain,Plant 1 - DEMO,Main
Building/North/Room 1,Unit 3,Flow,Demo Project
b. Importing data to the demonstration domain by executing all the links in a

group named 'Process Data' in an EPC domain (the following statement
should be typed on one line):
c. import DBA,DBA,Demo Domain,Plant 1 - DEMO,Main
Building/North/Room 1,Unit 3,@ Process Data
3. Press Enter.
You see the links that you specified in the statement being carried out.
Related Topics

Caution
• The import process is irreversible: once you carry out the import process,
you cannot undo the changes import made to the target database. We
therefore recommend that you use the Test feature to check the import
process before carrying out the actual data transfer.
At this stage the Import Link window is open and contains all the appropriate
definitions.

Import Comparison

• In the Import Link window, click .
The Import Progress dialog box opens, displaying the following information:
Data Field Description

Source Table The total number of rows and number of rows currently imported
Rows: Total / in the currently selected source table.
Current
Target Table The number of rows of the current table that have already been
Rows processed by the Import Utility during the current import session,
according to their status (Inserted, Updated, Deleted, or Rejected).
Tables / Rows in The percentage of data which has already been processed (for a
current table module import link) for the entire module and for the table
(progress bars) currently being processed.
Progress bar The percentage of data which has already been processed (for a
table import link).
Cancel Stop the import process during execution.
Report View the report on rejected rows. This button is available only if
any rejected rows occurred and if you selected the Rejected data
report check box in the Link Properties dialog box. This option
allows you also to generate a hard copy of the current report.
(This button becomes active only after the import process was
stopped or was completed.)
Information View the import process information: the target table name and
the row count before and after import. (This button becomes
active only after the import process was stopped or was
completed.)
Related Topics
• Test the Import Process, page 1493

Import Comparison
Importing Data into Multiple Plant Hierarchy Items

or Projects
You use the Import Level tab options when you want to import source tables which
are defined per plant hierarchy item to a domain which contains more than one plant
hierarchy item or to an Operating owner that has As-Built and multiple projects. In
your import source, you need to define the projects names and the plant hierarchy
items exactly as they appear in your target domain. In an Operating owner domain,
projects are always implemented per <plant>. Several projects can be associated with
the same <plant> and even share the same hierarchy levels or belong to different
plants in the domain.
When importing data that includes more than one plant hierarchy item, some of the
source rows may recur (due to the existence of several plant hierarchy items). In this
case, you can instruct the Import Utility to differentiate rows of different plant
hierarchy items during the import process, thus importing data into the appropriate
plant hierarchy items. When you select to import data into multiple plant hierarchy
items, you can also specify the level of import, for the Import Utility to differentiate
rows per <plant>, per <area> or per <unit>.
If you select to import data per <plant> or per <area>, the Import Utility rejects rows
defined per <unit>. If you do not specify a plant hierarchy level, the Import Utility
rejects all recurring source rows during the import process. In this case, the Import
Utility does not differentiate between rows of different plant hierarchy items. After
you select the level for which the Import Utility distinguishes unique data during the
import process, you need to select the naming convention to be used during the
import process.
In SmartPlant Instrumentation, database tables are defined per plant hierarchy item.
When a table is defined at a specified level, it contains data which is unique at that
level.
Data Import at the Highest Level

If you select to import data per <plant>, the Import Utility distinguishes only rows of
different <plants> during the import process. The Import Utility rejects rows of
different <areas> and <units> if a plant contains more than one <area> and <unit>.
For example, the CABLE table is defined per <plant>. Therefore the CABLE table
contains data which is unique only at the plant level.
Data Import at the Intermediate Level

If you select to import data per <area>, the Import Utility distinguishes only rows of
different areas during the import process. The Import Utility rejects rows of different
<units> if an <area> contains more than one <unit>.

Import Comparison
Data Import at the Lowest Level

The target table is CHANNEL (a table defined per <plant>) and you select on the
Import Level tab the <unit> level. In this case the AREA_ID and UNIT_ID table
columns become Foreign Key columns in the CHANNEL Table.
Primary Key and the Foreign Key Column Definitions

The Import Utility defines the Primary Key and the Foreign Key columns of the
target table, which you selected on the Link Definitions dialog box, in three possible
ways:
• You select the same import level as the level of the target table (this is the
default option): in this case only the table columns regarding this level (for
example, UNIT_ID, AREA_ID, and so forth) is automatically defined by
the Import Utility as a Primary Key in the target table.
For example:
The target table is COMPONENT (a table defined per <unit>) and you select
on the Import Level tab the <unit> level: the UNIT_ID table column is also
defined as a Primary Key column in the target table.
• You select a higher import level than the level of the target table: in this
case all the table columns regarding the level of the target table and the
levels above (for example, PLANT_ID, AREA_ID) will be automatically
defined as Primary Key columns in the target table.
For example:
The target table is COMPONENT (a table defined per <unit>) and you select
on the Import Level tab the <area> level. In this case both the AREA_ID
table column and the UNIT_ID table column become Primary Key columns in
the COMPONENT Table.
• You select a lower import level than the level of the target table: In this
case all the table columns regarding the level you select and the levels
below will be automatically defined as Foreign Key columns in the target
table.
Related Topics
• Common Error Messages, page 1532
• Import Data Into Multiple Plant Hierarchy Items, page 1500
• Import Data into Several Projects, page 1501
• Importing Data into Multiple Plant Hierarchy Items or Projects Common
Tasks, page 1500

Import Comparison
Importing Data into Multiple Plant Hierarchy Items

or Projects Common Tasks
The following tasks are used when you import data into multiple plant hierarchy
items or projects.
Import Data Into Multiple Plant Hierarchy Items

This procedure shows you how to import data into multiple plant hierarchy items or
projects. For more information, see Import Data Into Multiple Plant Hierarchy
Items, page 1500.
Import Data into Several Projects

This procedure shows you how to import data into several projects. For more
information, see Import Data into Several Projects, page 1501.
Related Topics
• Importing Data into Multiple Plant Hierarchy Items or Projects, page
1498
Import Data Into Multiple Plant Hierarchy Items

1. In your import source, do the following:
a. Define the plant hierarchy items if you use more than one plant hierarchy in
your projects.
b. For each plant hierarchy item, define data you want to import.
Tip
• Make sure the plant hierarchy item names or <unit numbers> are
exactly the same as in the target domain.
2. In the Import Utility, create the import link for the import source containing your
target plant hierarchy item definitions.
3. On the Link Properties dialog box, click the Import Level tab, and then, do the
following:
a. Under Hierarchy levels, select the desired plant hierarchy level.
b. If you want to import data to several <units> in your plant, under Import unit
data using, select Unit name or Unit number, depending on the definitions
in your import source.
c. Clock OK to close the Link Properties dialog box.

Import Comparison
4. Open the link in the Import Link window and make your link definitions as you
require.
5. Test and import data to the target projects.
Related Topics
Tasks, page 1500
1498
Import Data into Several Projects

1. In your import source, do the following:
a. Define the project names exactly as they appear in your target domain.
b. Define the plant hierarchy items if you use more than one plant hierarchy in
your projects.
c. For each project, define data you want to import.
Tip
• You can also include As-Built in the import source. Make sure the
name As-Built in the import source appears exactly as in SmartPlant
Instrumentation.
2. In the Import Utility, create the import link for the import source containing your
target project definitions.
3. On the Link Properties dialog box, click the Import Level tab, and then, do the
following:
a. Under Hierarchy levels, select the desired plant hierarchy level that the target
projects contain.
b. If the lowest plant hierarchy item in your projects is not the same, under
Import unit data using, select Unit name or Unit number, depending on the
definitions in your import source.
c. Select Specify target projects in link.
d. Clock OK to close the Link Properties dialog box.

Import Comparison
4. Open the link in the Import Link window, and, depending on the import method,
• If the import method is Single table, link your source project table
definition to the ENGINEER NAME/ENG PROJ ID field in the
Target Name column.
•If the import method is Module (multiple tables), link your source
project table definition to the Engineering Project Name field in the
Target Name column.
5. Complete making the import link definitions as you require.
6. Test and import data to the target projects.
Related Topics
Tasks, page 1500
1498

Import Comparison
Importing Instrument Index Common Tasks

The following tasks are used when importing instrument tags and loops.
Enable Creation of Complementary Elements for Instrument Index

If on the Link Definitions dialog box, under Import method, the Instrument Index
module or instrument index-related table is selected as the import target, the General
tab of the Link Properties dialog box displays an additional section called Create
complementary elements. The options in this section allow you to set the software
to import instrument tags according to the instrument type profile definitions. You
can enable the following elements for instrument index import:
• A device panel and a cable for an instrument whose instrument type

profile includes wiring, and which has the following default elements:
panel, cable, and connection type.
• A document number row and a default revision row (which is initially
empty) in the DRAWING table for a specification, process data sheet and
calculation sheet.
• Instrument associations with the appropriate I/O type, locations and hook-
ups.
For more information, see Enable Creation of Complementary Elements for
Instrument Index, page 1507.

Import Comparison
Set Source Fields as Instrument Type Fields

This procedure is useful if your import source does not contain instrument types or
instrument type descriptions and you want to create new instrument types and
descriptions in SmartPlant Instrumentation when importing tag numbers. This
procedure allows you to define one or more source columns as columns for importing
instrument type abbreviations and descriptions. To each field in the source column,
you must assign a process function. After that, when you open the Import Link
window, you do not have to define mapping for the process function and instrument
type fields. The process function macro @PROC_FUNC_NAME appears in the
Source Name column mapped to the PROC_FUNC_NAME column. When
importing tag numbers, the software runs the macro to import the instrument type
abbreviations and descriptions using the fields you set as the instrument type fields
and associate the imported tag numbers with the appropriate instrument types.
In SmartPlant Instrumentation, the instrument type of a tag is abbreviated and

therefore needs to be associated with a description that provides more information
about that instrument type, for example, the default instrument type FV description is
Flow Valve. An instrument type abbreviation does not have to be unique. For
example, in SmartPlant Instrumentation, FE stands for either Flow Element or Mass
Flow Sensor. The combination of the instrument type abbreviation and description
provides a unique identifier for a tag instrument type. For more information, see Set
Source Fields as Instrument Type Fields, page 1508.
Associate Source Fields with Existing Instrument Types

This procedure is useful if your import source does not contain instrument types or
instrument type descriptions and all the instrument types and descriptions that you
require already exist in SmartPlant Instrumentation. This procedure allows you to set
one or more source columns as columns containing instrument type fields and
associate each field with a combination of instrument type abbreviation, description,
and process function that exists in SmartPlant Instrumentation. After that, when you
open the Import Link window, you do not have to define mapping for the process
function and instrument type fields. The process function macro
@PROC_FUNC_NAME appears in the Source Name column mapped to the
PROC_FUNC_NAME column. When importing tag numbers, the software runs the
macro and the imported the tag numbers are associated automatically with the
appropriate instrument types. For more information, see Associate Source Fields with
Existing Instrument Types, page 1510.

Import Comparison
Associate Tag Numbers with Correct Instrument Type Descriptions

The instrument type of a tag is an important part of the initial information for building
a tag. This is true both when working with SmartPlant Instrumentation as an
application as well as when entering tags using the Import Utility. The instrument
type information is designated in the function part of the instrument tag (for example,
100- FY400). Sometimes the source data lacks an instrument type description, for
instance, there is an FY function type name that is an I/P Converter and also a
Solenoid Valve. This procedure enables you to specify that each that that you import
is automatically associated with the instrument type description that you require. For
more information, see Associate Tag Numbers with Correct Instrument Type
Descriptions, page 1511.
Import Instrument Index

Use this procedure to import instrument tags into SmartPlant Instrumentation using
the Module (multiple table) import method. This procedure is useful if you have not
yet defined your instrument index in SmartPlant Instrumentation. For more
information, see Import Instrument Index, page 1512.
Import Instrument Properties

Use this procedure to import one or more properties of instrument tag numbers. In
this procedure, you use the Single table import method and select the
COMPONENT table as the target table for data import. This procedure is useful if
you have already created instrument index in SmartPlant Instrumentation and only
need to assign certain properties to a large number of existing tag numbers. These
properties can be custom field values, supporting table values, or text string
properties, such as Service, Note, and so forth. For more information, see Import
Instrument Properties, page 1514.
Related Topics
page 1396

Import Comparison
Prerequisite for Importing Instrument Types

The current prerequisite only applies if you want to define instrument types in your
source and do not want to map them to instrument types shipped with SmartPlant
Instrumentation. Before defining source table columns as data fields holding
instrument type abbreviations and instrument type descriptions, you must ensure that
the values in the source table columns comply with the conventions used in
After you select the source table columns to be used as the instrument type name
(abbreviation) and description, when importing data, the Import Utility creates in
SmartPlant Instrumentation new instrument types and instrument type descriptions
according to the existing conventions. For example, when importing instrument type
abbreviation, all characters exceeding the first six characters are truncated. To carry
out a successful import, you need to select the source table columns which are most
compatible with the SmartPlant Instrumentation instrument type, instrument type
description, and process function conventions.
Use the following table as guidelines when selecting source table columns and setting
them as instrument type abbreviation fields and instrument type description fields:
Instrument Type Parameter SmartPlant Instrumentation Conventions

Abbreviation maximum length 6 characters
Abbreviation typeface Upper case (for example, FY - not - fy or Fy)
Description maximum length 40 characters
Important
• Both instrument type abbreviation and description are required
parameters. A combination of instrument type abbreviation and
description must be unique.
Related Topics
• Import Instrument Properties, page 1514

Import Comparison
Enable Creation of Complementary Elements for Instrument

Index
Prerequisite
• Make sure that the appropriate instrument type profile definitions exist in
target domain.
1. On the Link Definitions dialog box, in the Link box, type a unique link name.
2. Under Import method select one of the following:
• Select Module (multiple tables), and then, under Name of module or
table, select Instrument Index.
•Select Single table, and then, under Name of module or table, select
COMPONENT or any other instrument index-related table.
3. Complete the import link creation.
4. Open the Link Properties dialog box, and click the General tab.
5. Under Create complementary elements, select check boxes for the elements that
you want to create. You can create any of the following elements:
• A device panel and a cable for an instrument whose instrument type
profile includes wiring, and which has the following default elements:
panel, cable, and connection type.
• A document number row and a default revision row (which is initially
empty) in the DRAWING table for a specification, process data sheet
and calculation sheet.
• Instrument associations with an existing I/O type, location, and hook-
up.
Related Topics

Import Comparison
Set Source Fields as Instrument Type Fields

2. Under Process Function, click Define.
3. If this is the first time you are running the link, on the Define Instrument Type
Fields dialog box, which opens automatically, do the following:
a. From the Source pane, drag one or more source table columns to the
Instrument type name pane. The values in the source column fields become
instrument type abbreviation fields after data import.
b. From the Source pane, drag one or more source table columns to the
Instrument type description pane. The values in the source column fields
become instrument type description fields after data import.
Tips
• You can use concatenated sources. For details, see Example of
Concatenated Sources, page 1515.
• Instrument type abbreviation characters that exceed six characters are
truncated. For details about instrument type conventions that exist in
SmartPlant Instrumentation, see Prerequisite for Importing Instrument
Types, page 1506.
4. Click OK to close the Define Instrument Type Fields dialog box.
5. On the Process Function Mapping dialog box, for each instrument type in the
left section, drag the appropriate process function from the right section to either a
light-blue field (unassigned process function) or a white field (previously assigned
process function) in the Process function column next to the appropriate
instrument type.

Import Comparison
6. To filter the instrument type fields displayed in the left pane, under Display
process function assignments, do one of the following:
• Select All to display assigned and unassigned instrument types.
• Select Unassigned only to display only instrument types which are not
assigned yet with process functions.
• Select Assigned only to display only instrument types which are
assigned with process functions.
Tips
• If you previously imported instrument types using the current link,
some of the instrument types are already assigned to process functions
and exist in SmartPlant Instrumentation. These instrument types are
displayed in a gray background, and you cannot reassign the process
functions for them.
•The Process Function Mapping dialog box displays all the source
fields that belong to the source table columns you set as instrument
type and description columns on the Define Instrument Type Fields
dialog box.
7. When done, click OK to return to the Source tab.
8. On the Source tab, under Process function, select Assign.
9. Click OK.
Note
• When you open the Import Link window, the process function macro
@PROC_FUNC_NAME appears in the Source Name column mapped
to the PROC_FUNC_NAME column. You do not need to define any
manual mapping for the process function and instrument type fields.
When importing data, the software uses the source fields that you set as
the instrument type fields.
Related Topics

Import Comparison
Associate Source Fields with Existing Instrument Types

2. Under Process Function, click Define.
3. If this is the first time you are running the link, on the Define Instrument Type
Fields dialog box, which opens automatically, do the following:
a. From the Source pane, drag one or more source table columns to the
Instrument type name pane. The values in the source columns become
instrument type abbreviation fields after data import.
b. From the Source pane, drag one or more source table columns to the
Instrument type description pane. The values in the source columns
become instrument type description fields after data import.
Tips
• You can use concatenated sources. For details, see Example of
Concatenated Sources, page 1515.
• Instrument type abbreviation characters that exceed six characters are
truncated. For details about instrument type conventions that exist in
SmartPlant Instrumentation, see Prerequisite for Importing Instrument
Types, page 1506.
4. Click OK to close the Define Instrument Type Fields dialog box.
5. On the Process Function Mapping dialog box, click Instrument Type to open
the Instrument Type Mapping dialog box.
6. From the Instrument types pane, drag an instrument type to each field displayed
in the Instrument type mapping to source pane.
7. Click OK to return to return to the Process Function Mapping dialog box.
8. On the Process Function Mapping dialog box, click OK.
9. On the Source tab, under Process function, select Assign.
10. Click OK.
Note
• When you open the Import Link window, the process function macro
@PROC_FUNC_NAME appears in the Source Name column mapped
to the PROC_FUNC_NAME column. You do not need to define any
manual mapping for the process function and instrument type fields.
When importing instrument tags, the software uses the source fields that
you set as the instrument type field to automatically associate the tags with
the appropriate instrument types.
Related Topics

Import Comparison
Associate Tag Numbers with Correct Instrument Type

Descriptions
1. Click Service > Preliminary Function.
2. On the Preliminary Function dialog box, click OK.
3. On the Select ODBC Profile dialog box, select the appropriate data source and
click OK.
Tip
• For this procedure, you can select only .dbf and .xls data file sources.
4. On the Enter File Name dialog box, navigate to the appropriate ODBC data
source file and click Open.
5. On the Preliminary Function dialog box, in the Source column list pane, drag
the appropriate column you want to use for the instrument type name.
6. Repeat the previous step for each of the other properties: Instrument type
description, Process function type, and Tag number.
8. On the Define Function Type dialog box, do the following:
a. In the Function Type section, select a function type name from the Name
column.
b. In the Description column adjacent to your selection, display the list, and if
more than one description is available, select the required description.
c. Do one of the following:
• In the Tag Number section, select the instrument tags you want to
associate with the selected function type.
• In the Function Type section, select the All check box to associate
all the available instrument tags with the selected function type.
d. To use the same function type name with more than one description for
different instrument tags, click Duplicate and for the new row select the
required description from the list.
9. Click OK after you finish associating all function type names and tag numbers
with SmartPlant Instrumentation component function types.
Caution
• To import the tag successfully, you must associate all the tag numbers.
Related Topics

Import Comparison
Import Instrument Index

Prerequisites
• Make sure that the tag numbers or tag number segments in the import
source are compatible with the naming convention that is defined in the
target <unit> of SmartPlant Instrumentation.
• Make sure that the import source contains instrument type name,
description, and process function definitions. For details about process
function codes that exist in SmartPlant Instrumentation, see Process
Function Mapping Codes for Instrument Index Import, page 1456.
1. On the Link Definitions dialog box, create an import link as follows:
a. In the Link box, type a unique link name.
b. Under Import method, select Module (multiple tables).
c. Under Name of module or table, select Instrument Index.
d. Complete the import link creation.
2. Open the Link Properties dialog box, and do the following:
a. If you want to import instruments that exist into more than one <unit>, on the
Import Level tab, under Hierarchy levels, select Apply and also select the
lowest plant hierarchy level. For details, see Import Data Into Multiple Plant
Hierarchy Items, page 1500.
b. If needed, on the General tab, enable creation of complementary elements
according to instrument type profiles of the source tags. For details, see
Enable Creation of Complementary Elements for Instrument Index, page
1507.
c. On the General tab, make sure that Import to supporting tables only is
cleared. If you select this check box, you cannot import tag numbers using
this import link but only supporting table data.
d. If you do not want to create any loop numbers, on the Tag/Loop tab, clear the
Use loop reference data check box.
3. In the Import Link window, open the import link.

Import Comparison
4. In the Target pane, define the import mapping as follows:

a. If you have instruments belonging to more than one tag class, define a
mapping value for the Tag Class (CMPNT_CAT_ID) column. For details,
see Tag Class Mapping Codes for Instrument Index Import, page 1454.
b. Select the Tag No field, and then, from the Source pane, drag the column
containing the tag numbers.
c. If you want to import data into instrument index supporting tables, define
mapping for the supporting table names (indicated by bold blue font in the
Target pane), and then map the fields that you need.
d. Map the process function column PROC_FUNC_NAME, instrument type
abbreviation column CMPNT_FUNC_TYPE_NAME and instrument type
description column CMPNT_FUNC_TYPE_DESC.
Tip
• You can set the software to use the @PROC_FUNC_NAME macro
instead of mapping the process function and instrument type fields.
The software runs this macro if you have assigned process functions to
instrument type fields using the Source tab options of Link
Properties dialog box. The macro appears in the Import Link
window mapped automatically to the PROC_FUNC_NAME column.
For details, see Set Source Fields as Instrument Type Fields, page
1508.
5. Complete the import mapping by dragging the appropriate column names from
the Source pane or by entering strings or values in the fields in the Target pane.
Tip
• If you want to import line P&ID drawing references and assign them
to the imported tag numbers, you must map the same source P&ID
column to the following columns in the Target pane: P&ID
(DWG_NAME) and LineP&ID (DWG_NAME). This is because the
Import Utility does not support automatic association of line P&ID
drawing references with tag numbers.
6. Import the data.
Note
• After importing supporting table data, the imported values appear in
SmartPlant Instrumentation in two places: Tag Number Properties dialog
box and the appropriate supporting table dialog boxes. This is because
primary key columns of supporting tables (those with the _ID suffix) have
reference foreign key columns in the COMPONENT table, which holds
tag numbers in the CMPNT_ID column.

Import Comparison
Import Instrument Properties

Prerequisite
• If you want to import an instrument property and this property is a

supporting table value, make sure that this value already exists in the
appropriate supporting table in SmartPlant Instrumentation. For example,
if you want to assign a Field location to a number of instruments, make
sure that Field is defined in the Instrument Locations supporting table.
If, however, you want to import a new instrument property and also insert
it into a supporting table, you need to use another procedure. For details,
see Import Instrument Index, page 1512.
b. Under Import method, select Single table.
c. Under Name of module or table, select COMPONENT.
2. Open the Link Properties dialog box, and do the following:
a. If you want to import data to instruments that exist in more than one <unit>,
on the Import Level tab, under Hierarchy levels, select Apply and also
select the lowest plant hierarchy level. For details, see Import Data Into
Multiple Plant Hierarchy Items, page 1500.
b. On the Tag/Loop tab, clear the Use loop reference data check box if you do
not want to import loop properties.
a. If you have instruments belonging to more than one tag class, define a
mapping value for the Tag Class (CMPNT_CAT_ID) column. For details,
see Tag Class Mapping Codes for Instrument Index Import, page 1454.
c. Define mapping for the instrument properties that you want to insert into the
COMPONENT table for the mapped tag numbers.
Tip
• If you want to associate the source tag numbers with lines that exist in
SmartPlant Instrumentation, note that the Import Utility does not
associate P&ID drawing references of lines with tag numbers
automatically. If you want to assign line P&ID drawing references to
the source tag numbers, you must define mapping for both
LINE_NUM/LINE_ID and DWG_NAME/DWG_ID columns in the
Target pane.

Import Comparison
5. Import the data.

Note
• After importing supporting table data, the imported values appear as
assigned to the appropriate instruments in the Tag Number Properties
dialog box.
Related Topics
Example of Concatenated Sources

The following example refers to the use of concatenated sources on the Define
Instrument Type Fields dialog box, where you set source fields as instrument type
fields. You can also use concatenated sources in any field in the Import Link
window, when mapping source and target columns.
Suppose that your data source contains the following columns:

cmpnt_func_type_name column holding source instrument type names and
cmpnt_func_type_desc column holding source source instrument type descriptions.
On the Define Instrument Type Fields dialog box, you can move both columns to
the Instrument type description pane and specify sub-string parameters as follows:
cmpn_func + cmpnt_name(2,5)
The imported instrument type description is made up of the source instrument type
plus five characters of the source description starting from the second character.
Now, suppose that you specify the following concatenated string:
cmpn_func + cmpnt_name(2)
The imported instrument type description is made up of the source instrument type
plus all the characters of the source description starting from the second character.
Related Topics
• Prerequisite for Importing Instrument Types, page 1506

Import Comparison
Creating Specifications by Data Import Common

Tasks
The following tasks are used when creating specifications in SmartPlant
Instrumentation by importing data from a predefined source.
Create Specs Using the Module Import Method

Use this procedure if you want to create instrument specs based on the same spec
form and all of your source instrument tags belong to the same process function as the
target spec form. You can also import revisions from the source and create process
data sheets. For more information, see Create Specs Using the Module Import
Method, page 1517.
Create Specs Using the Single Table Import Method

This procedure is useful if you want to create specs based on various spec forms for a
specific item type, for example, instrument specs, cable specs, panel specs, and so
forth. For more information, see Create Specs Using the Single Table Import
Method, page 1519.
Create a Multi-Tag Spec by Data Import

Use this procedure if you want to create a multi-tag spec with SEE LIST columns in
SmartPlant Instrumentation. For more information, see Create a Multi-Tag Spec by
Data Import, page 1521.
Related Topics
page 1396
• Importing Revisions, page 1523

Import Comparison
Create Specs Using the Module Import Method

Prerequisites
• In SmartPlant Instrumentation, create a target spec form with the

• Make sure that the instrument tags in your source already exist in
• Make sure that all the source tags have the same process function as the
target spec form. Tags that do not have the same process function are
rejected by the Import Utility and you cannot import data from your
source.
c. Under Name of module or table, select Specifications.
2. Open the Link Properties dialog box, and click the Specs tab.
3. Under Specifications module, do the following:
a. From the Specification form list, select the target spec form.
b. Clear Import to multiple-item specification sheets.
4. Under Specification sheet options, to define the target spec document numbers,
• Select Use custom drawing name to import spec document numbers
from the source. You can then map the Spec Drawing Name field in
• Clear Use custom drawing name to set the Import Utility to create
specs with default document numbers.
Tip
• Document numbers in the import source must be unique for each
instrument.
5. Select Include revisions in import to import spec revisions from the source.
You can then map the Spec Revision No field in the Import Link window.
Tip
• If you clear this check box, you cannot import any specification
revision data using the current import link.

Import Comparison
6. Select Use custom drawing name for process data to import source document
numbers for process data sheets. You can then map the Process Data Drawing
Name field in the Import Link window.
Tips
• Even if the target spec form does not contain fields from process data
tables and you do not import any process data value with the spec,
after you map the document numbers for process data sheets and run
the import process, the Import Utility creates an empty process data
sheet in SmartPlant Instrumentation and associates it with the
instrument for which you created the spec.
• If you clear this check box, if you import any process data value, when
creating a spec, the Import Utility also creates a process data sheet and
assigns a default document number to the process data sheet.
• Document numbers in the import source must be unique for each
instrument.
a. If the source tag does not have process data cases, in the CASE_NAME field,
type '' (or '*' if the database platform is SQL Server).
c. Depending on the link properties, define mapping for the Spec Drawing
Name, Spec Revision No, and Process Data Drawing Name fields.
d. If you define mapping process data fields belonging to the PD_GENERAL
table, map the Upstream Condition field, which is actually the Fluid State
field. For details, see Fluid State Mapping Codes for Process Data Import,
page 1457.
10. Import the data.
Related Topics
• Creating Specifications by Data Import Common Tasks, page 1516
page 1396
• Process Function Mapping Codes for Instrument Index Import, page 1456

Import Comparison
Create Specs Using the Single Table Import Method

Prerequisites
• In SmartPlant Instrumentation, create the target spec forms.

• Make sure that the spec form numbers in your source match the target
spec forms in SmartPlant Instrumentation.
• Make sure that the items in your source already exist in SmartPlant
Instrumentation, for example, instrument, cables, panels, and so forth.
• If you want to create instrument specs, make sure that the process
functions of the source tags match the process functions of the target form.
Tags that do not have the same process function will be rejected by the
Import Utility and you will not be able to perform data import from your
source.
Caution
• When creating specs using the Single table method, the Import Utility
does not validate whether the process function of source tags matches the
process function of the target form. Therefore, to prevent database
problems in SmartPlant Instrumentation after data import, you must
exercise an extreme caution when defining tag process functions in the
source columns.
c. Under Name of module or table, select SPEC_SHEET_DATA.
2. Open the Link Properties dialog box, and then, on the General tab, under
Create complementary elements do one of the following:
• Select the Create check box beside Drawing & Revision to create
automatically a default document number for each spec and insert a
zero revision row for each spec (invisible the SmartPlant
Instrumentation interface).
• Clear the Create check box beside Drawing & Revision if you want
to map the document numbers and revisions from the source or if you
do not want to create any document numbers or revisions for specs
3. Click the Specs tab, and then, from the Specification item type list, select the
item type for which you want to create specs.

Import Comparison

a. If the selected item type is Instrument but the source tags do not have process
data cases, in the CASE_NAME/CASE ID field, type '' (or '*' if the database
platform is SQL Server).
b. Select the item type field (the Tag Number field if you want to create
instrument specs), and then, from the Source pane, drag the column
containing the source items.
c. Map the SPEC FORM CNUM/SPEC FORM ID column to match the
source and target form numbers.
d. If you want to import document numbers and revisions from the source, map
the DWG NAME/DWG ID column to import the document numbers from
the source and also map the REV NO/REV ID column to import the source
revisions.
7. Import the data.
Related Topics
page 1396

Import Comparison
Create a Multi-Tag Spec by Data Import

Prerequisites
• Make sure that the instrument tags that you want to include in a multi-item
spec exist in SmartPlant Instrumentation.
• In SmartPlant Instrumentation, create a target spec form and generate a
format with SEE LIST fields.
• In your import source, define all the instrument tags you want to include in
the multi-tag spec. The first tag in your source column becomes the
master tag in the created spec. In the same import source, define the target
columns and column values.
c. Under Name of module or table, select Specifications.
2. Open the Link Properties dialog box, and click the Specs tab.
3. From the Specification item type list, select Instrument.
4. Under Specifications module, do the following:
a. From the Specification form list, select the target spec form for which you
defined a multi-tag list format.
b. Select Import to multiple-item specification sheets.
c. From the Specification format list, select the target format.
Tip
• The Use custom drawing name check box is selected automatically
because you must define manually one document number for all the
instrument tags when mapping the source and target table columns in
a. If the source tags do not have process data cases, in the CASE_NAME field,
type '' (or '*' if the database platform is SQL Server).
c. In the Spec Drawing Name field, type one alpha-numeric value for the multi-
tag spec document number you want to create.

Import Comparison
8. Import the data.
Related Topics
page 1396
• Fluid State Mapping Codes for Process Data Import, page 1457

Import Comparison
Importing Revisions
The Import Utility allows you to import revision data into any document that has a
document number. Therefore, your import source must contain a column with
document numbers that already exist in SmartPlant Instrumentation. When importing
data, the Import Utility matches the source and target document numbers and imports
the revision data into the appropriate document, be it a calculation or process data
sheet, a spec, or any other document for which it is possible to define revisions in
In the database, revision data is stored in the REVISION table columns. There are
two types of revision data fields: custom fields (REV_UDF columns) and non-custom
(other than REV_UDF). Non-custom fields appear in SmartPlant Instrumentation on
the Revisions dialog box and in document title block fields. You can import data to
any of these fields. Custom fields do not appear in the SmartPlant Instrumentation
interface by default. You can add custom fields as additional revision fields when
customizing title blocks in InfoMaker. You cannot import data into the REV_UDF
fields.
The required columns for import mapping are DWG_NAME (document number) and
REV_NO (revision number).
If you assign an import link to the Single table import method and select the
REVISION table, you can import revision data to any SmartPlant Instrumentation
document, provided that the target document and the import source have the same
document number. If you assign an import link to the Module (multiple tables)
import method, and select the Process Data or Specifications module, you need to
define revision import options on the Link Properties dialog box (General tab options
for importing process data or calculation sheet revisions, or Specs tab for importing
specification revisions).
Related Topics
page 1396
• Import Process Data and Calculation Sheet Revisions, page 1525
• Import Revisions, page 1524

Import Comparison
Import Revisions
Use this procedure to import revisions to any document in SmartPlant
Instrumentation.
Prerequisites
• Make sure that the documents for which you want to import revisions
already exist in SmartPlant Instrumentation.
• Make sure that the document numbers are defined both in the import
source and in the target documents.
c. Under Name of module or table, select REVISION.
2. On the Link Properties dialog box, define the import link properties as you
require.
a. Select the DWG NAME/DWG ID field, and then, from the Source pane,
drag the column containing the source document numbers.
b. Select the REV NO field, and then, from the Source pane, drag the column
containing the source revision numbers.
Tip
• You cannot import data into the REV UDF fields. These fields are
custom fields that you can add as additional revision fields when
customizing title blocks in InfoMaker. You can import revision values
to any non-custom fields (other than REV UDF). The display names
of these fields are shown on the Revisions dialog box in SmartPlant
Instrumentation.
6. Import the data.
Related Topics
page 1396

Import Comparison
Import Process Data and Calculation Sheet Revisions

Use this procedure if you only want to import process data revisions. You can also
set the software to create a calculation sheet and import calculation sheet revisions
when importing process data revisions.
Prerequisite
• Make sure that the tag numbers for which you want to import process data
or calculation sheet revisions already exist in SmartPlant Instrumentation.
c. Under Name of module or table, select Process Data.
2. On the General tab of the Link Properties dialog box, select a combination of
the following check boxes: Import revisions, Use custom drawing names, and
Create calculation sheet. Use the following table as a guide to the check box
selection combinations you can use and the data for which you need to define the
links:
Data to Link Import Use custom Create
revisions drawing names calculation
sheet
Process data revisions Select Clear Clear
Process data sheet document Clear Select Clear
numbers
Process data sheet document Select Select Clear
numbers and revisions
Calculation data Clear Clear Select
Calculation and process data Select Clear Select
sheet revisions
Calculation and process data Clear Select Select
sheet document numbers
Calculation and process data Select Select Select
sheet document numbers and
revisions
3. Define other properties for the link as you require.


Import Comparison

a. Map the Tag Number and Case Name fields by dragging the appropriate
column names from the Source pane.
b. Map the appropriate revision and document number (drawing name) fields by
dragging the appropriate column names from the Source pane.
Tip
• If the source tags do not have process data cases, in the Case Name
field, type '' (or '*' if the database platform is SQL Server).
7. Import the data.
Related Topics
page 1396
• Importing Revisions, page 1523

Import Comparison
Working with Log Files: An Overview

A log file allows you to keep track of all your import operations. Log files carry all
the information about your import activities. When you first start the Import Utility,
you will create your first log file. It will keep growing as you continue importing
data unless you decide to change the current log file. The information in the log file
is organized in an ascending chronological order. This information includes:
• The domain details.

• The source and target details (the source table/file name; the target
table/module name).
• Rejected data rows details (if there are any).
• The import results (the number of total rows, inserted, updated, and
rejected rows).
Note
• You can perform the import process without a log file but it is not
advisable, as you will not have a record of the import execution. If you
start the Import Utility with no log file defined, you will get a message
after you select the target <unit> in the Open dialog box.
You can create a new log file, open an existing log file, delete a log file, view a log
file, check the name of the current log file, or close the current log file.
Related Topics
• Working with Log Files Common Tasks, page 1528

Import Comparison
Working with Log Files Common Tasks

The following tasks are used when you work with log files.
Create a New Log File

This procedure shows you how to create a log file. It is advisable to create a new log
file each time you perform an important import operation. You should also create a
new log file if your existing log file has become too long.
For more information, see Create a New Log File, page 1529.
Open an Existing Log File

This procedure shows you how to open an existing log file. It is advisable to open a
log file before you perform an import procedure so that you have a record of the
import process.
For more information, see Open an Existing Log File, page 1529.
View the Current Log File

You can view the current log file to review the previous import process information.
You can also view any other existing log file.
For more information, see View the Current Log File, page 1530.
Check the Name of the Current Log File

This procedure shows you how to check the name of current log in use.
For more information, see Check the Name of the Current Log File, page 1530.
Close the Current Log File

You can also import data without a log file. If you choose to do this and there is a
current log file, you can close it.
For more information, see Close the Current Log File, page 1530.
Delete an Existing Log File

You can delete a log file when the information in it becomes unimportant.
Caution
• This action deletes the selected log file from your hard disk.
For more information, see Delete an Existing Log File, page 1531.

Import Comparison
Log the Import Parameters

This procedure shows you how to log the import parameters which you use in the
current import process.
For more information, see Log the Import Parameters, page 1531.
Related Topics
• Working with Log Files: An Overview, page 1527

1. On the Log File menu, click New.
2. In the New Log File dialog box, type the name of your new log file, select the
required path and click OK.
Tip
• The Import Utility opens a new (empty) log file automatically, even
though you do not see it.
Related Topics

1. On the Log File menu, click Open.
2. In the Open Log File dialog box, select the name of the log file you want to open
and click OK.
Tip
• After you create a new log file or open an existing one, it stays open
even though you do not see it displayed. The log file remains active
until you close the Import Utility. When you exit the Import Utility,
the log file closes automatically and reopens when you restart the
Import Utility. See Close the Current Log File, page 1530 to learn
how to close the current log file manually.
Related Topics

Import Comparison

• Click .
• On the Log File menu, click View.
Tip
• The current log file is opened for viewing by Notepad. SmartPlant
Instrumentation uses Notepad to view the log file. However, Notepad
is limited by file size that it can handle. If your log file becomes too
large for Notepad, you will get an appropriate message. In this case
you can view your log file using Windows Write or another
appropriate utility.
Related Topics
Check the Name of the Current Log File

• On the Log File menu, click Log File Name.
Tip
• The Import Utility shows you a message where it states the path and
filename of your current log file..
Related Topics

• On the Log File menu, click Close.
Tip
• The Import Utility immediately closes the current log file. After you
close the current log file you need to define a new log file to resume
tracking the import process. For details, see Create a New Log File,
page 1529.
Related Topics

Import Comparison

1. On the Log File menu, click Delete.
2. In the Open Log File Name dialog box, select the name of the log file you want
to delete and click OK.
The specified log file is deleted from your hard disk.
Related Topics
Log the Import Parameters

• On the Log File menu, click Show Link Parameters (repeat this step to
deselect this option).
Tips
• The Show Link Parameters command remains checked on the Log
File menu. Click the command again if you need to deselect this
option.
• After you run the import process, a section named Link Parameters is
added in the current log file, where you see the import parameters used
in this import process.
Related Topics

Import Comparison
Common Error Messages

This table describes some of the most common error messages which appear in both
the Import Report and the log file after an import process takes place. Also included
in this table are possible causes and suggested solutions for each case.
Message Possible Cause Suggested Solution

Empty The imported Tag LOOP Modify the source data.
Compone IDENTIFIER segment is Modify the import naming conventions.
nt empty.
Number
of Tag
Number
Empty The imported LOOP Modify the source data.
Loop NUMBER segment is Modify the import naming conventions.
Number empty.
of Loop
Number
Illegal The imported Tag Modify the source data.
Instrume Instrument Type value Import the Instrument Type Table
nt Type does not exist in the target (COMPONENT FUNCTION TYPE) first.
of Tag domain (see Note 1). Clear the Validate tag and loop segments
Number check box (see Note 3).
Illegal The imported Tag Modify the source data.
Equipme Equipment Name value Import the Equipment Table (EQUIPMENT)
nt Name does not exist in the target first (see Note 3).
of Tag domain (see Note 1).
Number
Illegal The imported Loop Modify the source data.
Equipme Equipment Name value Import the Equipment Table (EQUIPMENT)
nt Name does not exist in the target first (see Note 3).
of Loop domain (see Note 1).
Number
Loop FUNCTION segment Import the Loop Function Table
Function value does not exist in the (LOOP_FUNCTION) first (see Note 3).
of Loop target domain.
Number

Import Comparison

Measured MEASURED Import the Loop Function Table
Variable VARIABLE segment (LOOP_PROC) first (see Note 3).
of Loop value does not exist in the
Number target domain.
Illegal The imported <unit> When importing more than one plant
<Unit> number is different from hierarchy item, make sure that you have
Number the target <unit> number specified the data import level and selected
in Tag (see Notes 1, 2). Apply on the Import Level tab of the Link
Modify the source data.
Modify the import naming conventions.
Illegal The imported <unit> name When importing more than one plant
<Unit> is different than the target hierarchy item, make sure that you have
Name in <unit> name (see Notes 1, specified the data import level and selected
Tag 2). Apply on the Import Level tab of the Link
Illegal The imported Area When importing more than one plant
Area number is different than hierarchy item, make sure that you have
Number the target Area number specified the data import level and selected
in Tag (see Notes 1, 2). Apply on the Import Level tab of the Link
Illegal The imported Plant When importing more than one plant, make
Plant number is different than sure that you have specified the data import
Number the target Plant number level and selected Apply on the Import
in Tag (see Notes 1, 2). Level tab of the Link Properties dialog box.
Number Modify the source data.

Import Comparison

The The imported Process Modify the import source and define correct
Process Function Name is different mapping codes for instrument process
Function than the target (note that function assignment. For details, see Process
is not this variable is case Function Mapping Codes for Instrument
found sensitive and that this Index Import, page 1456.
value is usually
capitalized).
The Process Function
Name value (in the
Component Table or in the
Component Function Type
Table) is different than the
Process Function Name
value in the Process
Function Table (see Note
1).
The In the COMPONENT Modify the link settings or the source data, or
Instrume Table, the clear the Validate tag and loop segments
nt Type is CMPNT_FUNC_TYPE_I check box.
not found D field value contains an
invalid reference to the
COMPONENT_FUNCTI
ON_TYPE Table.
The In the COMPONENT Modify the link settings or the source data, or
Instrume Table, the Instrument clear the Validate tag and loop segments
nt Type Type value in the check box.
does not COMPONENT_NAME
match the field (Tag Number) is
Tag different than the value in
Number the
CMPNT_FUNC_TYPE_I
D field.
The The Process Function Modify the link settings or the source data, or
Instrume value in the Tag Number clear the Validate tag and loop segments
nt Type does not comply with the check box.
does not Process Function type (for
match the example, Flow,
Process Temperature, and so
Function forth).

Import Comparison

User has The Import Utility rejected You can modify the selection you made for
selected a mismatched source row this link, if appropriate.
to reject (see Note 4).
row on
data
mismatch
User has The Import Utility has You can modify the selection you made for
selected rejected a source row this link, if appropriate.
to which is identical to an
disallow existing target row (see
overwrite Note 4).
User has The Import Utility rejected You can modify the selection you made for
selected a source new row (for this link, if appropriate.
to example, the Import
disallow Utility is only updating the
insertion target data) (see Note 5).
Unique The imported table Make sure the table which provides the value
value not primary key value does for the primary key is selected for import.
found not match the value of in
the table from which it is
derived (see Note 6).
This is An attempt has been made Make sure you selected the appropriate links
not a to import a non-numeric in the Link Explorer.
numeric field to a numeric field.
value
Invalid Inappropriate symbols Select the Use reserved symbols with
data were used in one or more import on the General tab of the Link
imported fields. An Properties dialog box. Make sure you have
incorrect comparison correct comparison criteria settings. See
criteria was applied in the Setting the Target Table Definitions: An
current import process Overview, page 1464 for more information
(see Note 7). about this option.
Data is The Import Utility has This message does not indicate an error.
empty imported a Zero-ID row
(see Note 8).

Import Comparison
The following notes apply to this table:

1. This message is specific for the case in which you select the Validate tag and
loop segments check box on the Tag/Loop tab of the Link Properties dialog
box. See Set the Tag/Loop Parameters, page 1431 for more information.
2. By default, the target <unit> is the one you selected when you started the current
import session. If you selected during the import setup process to import data into
additional <units>, the target <unit> would be any of these <units> which data
will be imported into during the import process. See Importing Data into
Multiple Plant Hierarchy Items or Projects, page 1498 for further information
about importing data into additional target <units>.
3. As a rule of thumb, always import data into reference tables before importing data
into the tables they refer to. When importing data using the Module (multiple
tables) import method, make sure that all appropriate reference tables have been
selected for import. The corresponding message in the table varies according to
the relevant reference table.
4. This message is typical for the case in which you select the Insert option on the
Import Mode tab of the Link Properties dialog box.
5. This message is typical for the case in which you select the Reject rows on the
General tab of the Link Properties dialog box. See Set Properties for Handling
Mismatched Data, page 1426 to learn how to handle mismatched data.
6. This message is typical for the case in which you import a table whose primary
key is derived from another table's primary key. In this case the table the primary
key belongs to must also be imported. For example, the PD_GENERAL table
primary key, CMPNT_ID, is derived from the COMPONENT table. Therefore,
the PD_GENERAL table primary key value must exist in the COMPONENT
table.
7. This message is reported by your SQL platform. The name of the field the
problem occurred in appears under Column Name in the Import Report. In this
case we highly recommend that you refer also to the information regarding this
import attempt in your log file.
8. Most SmartPlant Instrumentation tables contain a Zero-ID row which is used to
maintain the linkage between the tables in the database. During the import
process this row is not transferred from the source data to the target data, in which
case the Import Utility displays an appropriate message in the Import Report.
Related Topics
page 1396

Import Comparison
System Codes Table
Process Data Property Code Description Value in

Import
Source
Build-up Tendency Free Value
(lower fluid) No N
Yes Y
Coagulation Fluid Free Value
No N
Yes Y
Coagulation Liquid Free Value
(lower fluid) No N
Yes Y
Colored Fluid Free Value
No N
Yes Y
Colored Liquid Free Value
(lower fluid) No N
Yes Y
Corrosive Fluid Free Value
No N
Yes Y
Corrosive Liquid Free Value
(lower fluid) No N
Yes Y
Erosive Fluid Free Value
No N
Yes Y
Erosive Liquid Free Value
(lower fluid) No N
Yes Y

Import Comparison

Import
Source
Failure Action Close Close
Last Last
Open Open
Flag for Above/ Above Reference Line A
Below Reference Below Reference Line B
Line
Flag for Built-up Absolute Pressure A
Back Pressure Gage Pressure G
Flag for Center C
Center/Tangent Line Tangent T
Flag for Constant Absolute Pressure A
Back Pressure Gage Pressure G
Flag for Critical Absolute Pressure A
Pressure Gage Pressure G
Flag for Design Absolute Pressure A
Flag for Elasticity Gage Pressure G
Module
Flag for Fire/Non- Fire case F
fire Case Non-fire case N
Flag for Flow Mass flow
@ Operating conditions A
@ Base conditions B
@ Normal conditions N
@ Standard conditions S
Flag for Flow Range Mass flow
@ Operating conditions A
@ Base conditions B
Flag for Flow Trip/ Mass flow

Import Comparison

Import
Source
Alarm @ Operating conditions A
@ Base conditions B
Flag for Lever Free Value
No N
Yes Y
Flag for Maximum Mass flow
Discharge @ Operating conditions O
@ Base conditions B
Flag for Maximum Absolute Pressure A
Pressure (Relief Valve) Gage Pressure G
Flag for Maximum Free Value
Pressure (Relief Valve) Absolute Pressure A
Gage Pressure G
Flag for Pressure Free Value
Range Absolute Pressure A
Gage Pressure G
Flag for Pressure Trip/ Free Value
Alarm Absolute Pressure A
Gage Pressure G
Flag for Set Pressure Absolute Pressure A
Gage Pressure G
Flag for Variable Back Absolute Pressure A
Flag to enter Density Density to be imported D
or SG Gravity to be imported G
Flag to enter Density Density to be imported D
or SG (lower fluid) Gravity to be imported G

Import Comparison

Import
Source
Fluid Phase Homogeneous 2-phase H
Non-Homogeneous 2-phase N
Single phase S
Fluid State Gas/Vapor G
Liquid L
Steam S
Water W
Solid/Powder P
Foaming up Free Value
No N
Yes Y
Foaming up Free Value
(lower fluid) No N
Yes Y
Handwheel Free Value
No N
Yes Y
Oxidizing Fluid Free Value
No N
Yes Y

Import Comparison

Import
Source
Pipe Material Plain Carbon Steel (SAE 1020) 1
Inconel X, Annealed 10
Hanel Stellite 25 (L605) 11
Copper (ASTM B152, B124, B133) 12
Yellow Brass (ASTM B36, B134, 13
B135)
Alum. Bronz (ASTM B169 A) 14
Beryllium Copper 25 (ASTM B194) 15
Cuperonickel 30% 16
K-Monel 17
Nickel 18
Pyrex Glass 19
301 S.S. 2
Titanium 20
Tantalum 21
304 S.S. 3
310 S.S. 4
316 S.S. 5
330 S.S. 6
347 S.S. 7
Hastelloy B 8
Hastelloy C 9
Material Not Listed 99

Import Comparison

Import
Source
Seat Leakage ANSI I ANSI I
ANSI II ANSI II
ANSI III ANSI III
ANSI IV (standard) ANSI IV
(standard)
ANSI V ANSI V
ANSI VI (TSO) ANSI VI
(TSO)
BS6755A BS6755A
BS6755B BS6755B
BS6755C BS6755C
No Tight Shut-Off No Tight
Shut-Off
Tight Shut-Off Tight
Shut-Off
Solidifying Fluid Free Value
No N
Yes Y
Solidifying Liquid Free Value
(lower fluid) No N
Yes Y
Toxic Fluid Free Value
No N
Yes Y
Toxic Liquid Free Value
(lower fluid) No N
Yes Y
Transparent Fluid Free Value
No N
Yes Y

Import Comparison

Import
Source
Transparent Liquid Free Value
(lower fluid) No N
Yes Y
Wiring Property Code Description Value
Panel Category Code Junction Box 1
Marshaling Rack 2
Cabinet 3
Field Device 4
DCS 5
PLC 6
Calculation Property Code Description Value
Calc Type ISA Standard 1
IEC Standard 2
Calculated Parameters Orifice Diameter calculation B
(D,W,DP) Differential Pressure calculation D
Flow Rate Calculation W
Flag for Full Scale Mass flow
Flow @ Operating conditions O
@ Base conditions B
Flag for Rupture Disk Without Rupture Disk 0
With Rupture Disk 1
Flag to enter Compressibility to be imported C
Compressibility or Density to be imported D
Density (for Gas)
Flag to enter Molecular Specific Gravity to be imported G
Mass or SG (for Gas) Molecular Mass to be imported M

Import Comparison

Meter Sub Type Flange Tappings (Quarter of Circle 11
Orifice)
Corner Tappings (Quarter of Circle 12
Orifice)
Classical Venturi (as cast 17
convergent section)
Classical Venturi (machined 18
convergent section)
Classical Venturi (rough-welded 19
sheet-iron conv)
Flange Tappings (Square Edge 2
Orifice)
Universal Venturi 20
ISO Long Radius Nozzle 23
ASME Long Radius Nozzle 24
ISA 1932 Nozzle 25
Venturi Nozzle 26
Diametrically Opposite Flange 28
Tappings (Eccentric Orifice)
Side Flange Tappings (Eccentric 29
Orifice)
Corner Tappings (Square Edge 3
Orifice)
Diametrically Opposite Vena 30
Contracta Tappings (Eccentric
Orifice)
Side Vena Contracta Tappings 33
(Eccentric Orifice)
Vena Contracta Tappings 34
(Segmental Orifice)
Radius Tappings (Square Edge 4
Orifice)
SBHO Meter Run with Corner 5
Tappings
SBHO Meter Run with Flange 6
Tappings
Pipe Tappings 7

Import Comparison

AGA Report 3 (Flange Tappings) 8
AGA Report 3 (Pipe Tappings) 9
Meter Type Square Edge Orifice 1
Quarter of Circle Orifice 2
Conical Entrance Orifice 3
Lo-Loss Tube 4
Venturi Tube 5
Nozzle 6
Eccentric Orifice 7
Segmental Orifice 8
Orifice Material Plain Carbon Steel (SAE 1020) 1
Inconel X, Annealed 10
Hanel Stellite 25 (L605) 11
Copper (ASTM B152, B124, B133) 12
Yellow Brass (ASTM B36, B134, 13
B135)
Alum. Bronz (ASTM B169 A) 14
Beryllium Copper 25 (ASTM B194) 15
Cuperonickel 30% 16
K-Monel 17
Nickel 18
Pyrex Glass 19
301 S.S. 2
Titanium 20
Tantalum 21
304 S.S. 3
310 S.S. 4
316 S.S. 5
330 S.S. 6
347 S.S. 7
Hastelloy B 8
Hastelloy C 9
Material Not Listed 99

Import Comparison

Relief Valve Style Bellows Valve B
Conventional Valve C
Pilot-operated Valve P
Sizing Basis Blocked Flow B
Valve Type Signal Seat Globe 1
Double Seat Globe 2
Angle 3
Ball 4
Butterfly 5
Well Material Austenitic Steel 0
Ferritic Steel 1
Related Topics
• Adapt System Codes, page 1484

Import Comparison
Unit of Measure Codes Table
Unit of Measure Type Unit of Measure Name Value

Area centimeter2 cm2
Foot2 ft2
Inch2 in2
Kilometer2 km2
meter2 m2
mile2 mile2
millimeter2 mm2
yard2 yd2
Capacitance F F
nF nF
pF pF
Capacitance/Length F/ft F/ft
F/km F/km
F/m F/m
F/ft F/ft
F/km F/km
F/m F/m
mF/ft mF/ft
mF/km mF/km
mF/m mF/m
nF/ft nF/ft
nF/km nF/km
nF/m nF/m
pF/ft pF/ft
pF/km pF/km
Capacitance/Length pF/m pF/m

Import Comparison

Conductivity mho/cm mho/cm
S/cm S/cm
mho/cm mho/cm
mmho/cm mmho/cm
mS/cm mS/cm
S/cm S/cm
Current A A
mA mA
Density gram/milliliter g/ml
kg/cubic meter kg/m3
kg/liter kg/l
lb/cubic foot lb/ft3
lb/cubic inch lb/in3
lb/cubic yard lb/yd3
lb/ U.K. gallon lb/UK gal
lb/U.S. gallon lb/US gal
oz/cubic inch oz/in3
oz/ U.K. gallon oz/UK gal
lb/U.S. gallon oz/US gal
slug/cubic foot slug/ft3
ton(long)/cubic yard tonl/yd3
ton(short)/cubic yard tons/yd3
Diameter and Length 1/1000 inch MILS
centimeter cm
foot ft
inch in
Diameter and Length kilometer km
meter m
mile mile
millimeter mm
yard yd

Import Comparison

Flow CANADIAN gallon/day CN gal/d
CANADIAN gallon/hr CN gal/h
CANADIAN gallon/min. CN gal/min
CANADIAN gallon/sec. CN gal/s
Cubic centimeter/min cm3/min
cubic ft/day ft3/d
cubic ft/hr ft3/h
cubic ft/min. ft3/min
cubic ft/sec. ft3/s
cubic inch/day in3/d
cubic inch/hr in3/h
cubic inch/min. in3/min
cubic inch/sec. in3/s
cubic kilofoot/day kft3/d
cubic kilofoot/hr kft3/h
Cubic kilofoot/min. kft3/min
cubic meter/day m3/d
cubic meter/hr m3/h
cubic meter/min. m3/min
cubic meter/sec. m3/s
grain/day grain/d
grain/hr grain/h
grain/min. grain/min

Import Comparison

Flow grain/sec. grain/s
gram/day g/d
gram/hr g/h
gram/min. g/min
gram/sec. g/s
kg/day kg/d
kg/hr kg/h
kg/min. kg/min
kg/sec. kg/s
klb/day klb/d
klb/hr klb/h
lb/day lb/d
lb/hr lb/h
lb/min. lb/min
lb/sec. lb/s
Mega cubic foot/day Mft3/d
Mega cubic foot/minute Mft3/min
Mega cubic meter/day Mm3/d
Mega cubic meter/hr Mm3/h
Mega lb/day Mlb/d
metric ton/day t/d
metric ton/hr t/h
metric ton/min. t/min
metric ton/sec. t/s
U.K. gallon/day UK gal/d
U.K. gallon/hr UK gal/h
U.K. gallon/min. UK gal/min
U.K. gallon/sec. UK gal/s

Import Comparison

Flow U.K. ton/day UK ton/d
U.K. ton/hr UK ton/h
U.K. ton/min. UK ton/min
U.K. ton/sec. UK ton/s
U.S. barrel/day US bbl/d
U.S. barrel/hr US bbl/h
U.S. barrel/min. US bbl/min
U.S. barrel/sec. US bbl/s
U.S. gallon/day US gal/d
U.S. gallon/hr US gal/h
U.S. gallon/min. US gal/min
U.S. gallon/sec. US gal/s
U.S. kilobarrel/day US kbbl/d
U.S. kilobarrel/hr US kbbl/h
U.S. megabarrel/day US mbbl/d
Force kilogram-force kgf
lb-force lbf
newton N
Inductance H H
mH mH
Inductance/Length H/ft H/ft
H/km H/km
H/m H/m
H/ft H/ft
H/km H/km
H/m H/m
mH/ft mH/ft
Inductance/Length mH/Km mH/Km
nH/km nh/km
pH/ft pH/ft
Inductance/Resistance H/ohm H/ohm
mH/ohm mH/ohm

Import Comparison

Latent Heat Btu(39)/lb Btu39/lb
Btu(59)/lb Btu59/lb
Btu(60)/lb Btu60/lb
Btu(IT)/lb Btu IT /lb
Btu(M)/lb Btu M /lb
Btu(th)/lb Btu th /lb
cal(15)/g cal15/g
cal(20)/g cal20/g
cal(IT)/g cal IT/g
cal(M)/g cal M /g
cal(th)/g cal th /g
J/kg J/kg
kcal(15)/kg kcal15/kg
kcal(20)/kg kcal20/kg
kcal(IT)/kg kcal IT /kg
kcal(M)/kg kcal M /kg
kcal(th)/kg kcal th /kg
kJ/kg kJ/kg
Power mW mW
W W
Pressure atmosphere(standard) Atm (stand)
atmosphere(tech) at (tech)
bar bar

Import Comparison

Pressure centimeter of Hg (0C) cmHg 0C
centimeter of water cmH2O (4C)
dyne/cm2 dyn/cm2
foot of water (39.2C) ftH2O
gram-force/cm2 gf/cm2
hecto pascal hPa
inch of Hg(32C) inHg
inch of water(60C) inH2O
kg-force/cm2 kgf/cm2
kg-force/m2 kgf/m2
kg-force/mm2 kgf/mm2
kilo pascal kPa
Ksi Ksi
lb-force/ft2 lbf/ft2
lb-force/in2 lbf/in2
mega pascal MPa
meter water(4C) mH2O 4C
millibar mbar
millimeter of Hg (0C) mmHg 0C
millimeter of water mmH2O 4C
pascal (Pa) Pa
psi psi
torr (mm Hg 0C) Torr
Resistance Kohm Kohm
ohm ohm
Resistance/Length kOhm/ft kOhm/ft
kOhm/km kOhm/km
Resistance/Length kOhm/m kOhm/m
MOhm/m MOhm/km
Ohm/ft Ohm/ft
Ohm/km Ohm/km
Ohm/m Ohm/m
statOhm/km statOhm/km

Import Comparison

Specific Heat Btu(39)/(lbF) Btu39/lbF
Btu(59)/(lbF) Btu59/lbF
Btu(60)/(lbF) Btu60/lbF
Btu(IT)/( lbF) BtuIT / lbF
Btu(M)/(lbF) Btu M / lbF
Btu(th)/(lbF) Btuth/lbF
cal(15)/(gK) cal15/(gK)
cal(20)/ (gK) cal20/(gK)
cal(IT)/ (gK) calIT/(gK)
cal(M)/ (gK) cal M /(gK)
cal(th)/ (gK) calth/(gK)
J/(kgK) J/(kgK)
kcal(15)/(kgK) kcal15/kgK
kcal(20)/ (kgK) kcal20/kgK
kcal(IT)/ (kgK) kcal IT /kgK
kcal(M)/ (kgK) kcal M /kgK
kcal(th)/ (kgK) kcal th /kgK
kJ/(kgK) kJ/(kgK)
Temperature Degrees Celsius C C
Degrees Fahrenheit F F
Degrees Rankin R R
Temperature Kelvin K K
Velocity ft/h ft/h
ft/min ft/min
ft/s ft/s
in/s in/s
km/h km/h
m/s m/s

Import Comparison

Viscosity centipoise cP
centistokes cS
cm2/s cm2/s
ft2/sec. ft2/s
in2/sec. in2/s
lb/(fthr) lb/(fth)
lb/(ftsec.) lb/(fts)
lb-forcesec/ft2 lbfsec/ft2
lb-forcesec/in2 lbfsec/in2
m2/sec. m2/s
mm2/s mm2/s
mPas mPas
pascal sec. Pas
poise P
slug/(ftsec.) slug/fts
stokes St
Voltage mV mV
V V
Weight gram g
kilogram kg
Weight metric ton ton
ounce oz
pound lb
Weight/Length kg/km kg/km
lbs/mft lbs/mft
Related Topics
• Adapt UOM Codes, page 1485

SmartPlant Electrical Interface: An Overview

The SmartPlant Electrical Interface allows you to exchange data between the two
applications using the following document types:
Power elements — You initially define power supply requirements in SmartPlant

Instrumentation for tag numbers and for any panel type except for junction boxes and
device panels. On publishing the data from SmartPlant Instrumentation, SmartPlant
Electrical uses the published power supply data to create instruments from SmartPlant
Instrumentation tag number data and cabinets from panel data in SmartPlant
Instrumentation. You can then publish the data and retrieve it back to SmartPlant
Instrumentation with SmartPlant Electrical PDB information.
Signals — Signal data can originate in SmartPlant Electrical or in SmartPlant

Instrumentation. You can define signal data for generators, battery banks, converting
equipment, loads, control stations, any type of circuit, and disconnect equipment. On
retrieving all SmartPlant Electrical signals, SmartPlant Instrumentation creates
special electrical tags, for which you can perform wiring and I/O control system tag
assignments. After the wiring is complete, you can publish the data back to
SmartPlant Electrical for further processing, and use it to display PLC or other host
I/O data in SmartPlant Electrical schematics.
Notes
• The documents published by the two applications do not contain the same
properties. For example, instrument and cabinet data includes power
supply parameters such as rated voltage, full load current, and so forth,
which originate in SmartPlant Instrumentation. However, SmartPlant
Electrical only publishes PDB/Cell/Circuit information. Similarly,
SmartPlant Instrumentation publishes host data for signals that originate in
SmartPlant Electrical, but SmartPlant Electrical does not publish the host
data back to SmartPlant Instrumentation. For this reason, if, in SmartPlant
Electrical, you change data values that originated from SmartPlant
Instrumentation, you should update those values accordingly in
SmartPlant Instrumentation, and vice versa.
• If you publish signals in SmartPlant Electrical for circuits that feed items
other than loads, converting equipment, generators, battery banks,
instruments, or cabinets, then on retrieving the items in SmartPlant
Instrumentation and running the tasks, SmartPlant Instrumentation does
not display the associated items.
Related Topics
• Flow of Activities for Creating Control Systems, page 1559
• Prerequisites for Working with the SmartPlant Electrical Interface, page
1557

Prerequisites for Working with the SmartPlant

Electrical Interface
Before you can work with the SmartPlant Electrical Interface, you must perform the
following actions:
1. Install the SmartPlant Schema Component from the SmartPlant Instrumentation
CD Browser (click Add-In Software, and then click Schema Component
Installation).
Tip
• On the Select Optional Features page, clear the Schema Editor
check box if you do not need to use the Schema Editor.
2. Install the SmartPlant Client from the SmartPlant Instrumentation CD Browser
(click Add-In Software, and then click SmartPlant Client Installation).
Tip
• On the Select Features page, make sure that you clear the SmartPlant
Automatic Retrieval check box.
3. In the Windows Registry, you need to specify the folder location of the .xml file
containing the published data. In the case where multiple users publish the data,
all the users must define the same path. The path is defined in the Registry
location HKEY_CURRENT_USER\Software\INTERGRAPH\INTOOLS using the
parameter OutputXMLFolder = <.xml file path>.
4. The System Administrator must enable the item registry. For details, see Enable
Item Registry in the Administration User's Guide, under System Administration,
Domain Management.
5. The Domain Administrator must register the items. For details, see Register
Items in the Administration User's Guide, under Working in an Integrated
Environment.
6. Set up the plant hierarchy for which you are going to publish and retrieve data.
Tips
• To ensure the smooth functioning of the SmartPlant Instrumentation
backup and restore functions and to avoid duplicating data, each plant
in SmartPlant Electrical must map to SmartPlant Instrumentation at the
domain level. For this reason, make sure that each SmartPlant
Instrumentation domain that you map contains no more than one plant.
• At this stage, the prerequisites for working with the interface must also
be met on the SmartPlant Electrical side. For details, refer to the
SmartPlant Electrical Online Help topic: Prerequisites for Working
with the SmartPlant Instrumentation Interface.

7. In SmartPlant Instrumentation, retrieve the file Plant Groups.xml, (on the

SmartPlant menu, click Retrieve, and then navigate to the file which is
published in the folder of the current specified SmartPlant Electrical plant). This
file contains plant structure information to facilitate correlation of the plant
structures between both applications.
8. For each unit where data is to be published and retrieved, the Domain
Administrator must open the Unit dialog box and enter a unit number
corresponding to the unit code of the mapped SmartPlant Electrical unit.
You are now ready to use the interface to publish and retrieve data.
Related Topics
• SmartPlant Electrical Interface: An Overview, page 1556

Flow of Activities for Creating Control Systems

The following steps constitute the primary flow of activities when you use SmartPlant
Instrumentation to create the detailed wiring and control system data for a SmartPlant
Electrical item:
1. In SmartPlant Electrical, create signals for the items you want to associate with
control systems in SmartPlant Instrumentation and publish the data from
SmartPlant Electrical. For details, refer to SmartPlant Electrical Online Help.
Tip
• SmartPlant Electrical publishes the data in an .xml file, which it
creates in the plant structure path.
2. Open SmartPlant Instrumentation and retrieve the data that originated in
SmartPlant Electrical. For details, see Retrieve SmartPlant Electrical Data, page
1561.
3. Run the tasks that the software generates as a result of the retrieve. For details,
see Run a Task from the To Do List, page 1676.
Tips
• SmartPlant Instrumentation automatically creates tag numbers from
the retrieved data and identifies them as SmartPlant Electrical tags.
• As an alternative to creating signals in SmartPlant Electrical and then
publishing them, you can create the Electrical tags directly in
SmartPlant Instrumentation. For details, see Create Electrical Tags,
page 1562.
4. View the SmartPlant Electrical tags created in SmartPlant Instrumentation. For
details, see Viewing Electrical Tag Numbers, page 1563.
5. Associate the SmartPlant Electrical tags with loop numbers where needed; the
software populates the loop number data to SmartPlant Electrical later.
6. Associate the SmartPlant Electrical tags with electrical equipment where needed.
For details, see Associate Electrical Signals with Equipment, page 1564.

7. Create the necessary panels and cables and make the connections needed to
propagate the signal to the DCS or PLC that is used to define the control system
tag relationship. For details, see Create Wiring Items for SmartPlant Electrical
Signals, page 1565.
Tip
• If a signal is associated with a circuit in SmartPlant Electrical, it
inherits its power distribution board (PDB) item tag as an associated
field and is considered as a preassigned signal for the PDB cabinet.
For circuit signals, SmartPlant Instrumentation automatically creates a
cabinet with the name of the power distribution board to which the
circuit was connected in SmartPlant Electrical. For other signals, you
need to create device panels manually in SmartPlant Instrumentation.
For details, see Create a Local Signal for Electrical Tags, page 1567.
8. Publish the data to SmartPlant Electrical. This creates an .xml document
containing SmartPlant Instrumentation data such as the control system
configuration, I/O assignment, PLC I/O card and channel, instrument tags, loop
number, and so forth. For details, see Publish Data for SmartPlant Electrical,
page 1569.
Tip
• The software creates the file in the path: <SmartPlant Instrumentation
home folder>\XML\IO Assignment_data.xml.
9. Retrieve (import) the configured data in SmartPlant Electrical.
10. Display the I/O assignment data in a SmartPlant Electrical schematic by including
in the schematic macros related to SmartPlant Electrical signal data.
Tip
• In Enhanced Report Utility reports and CAD drawings for a signal that
applies to a circuit, the loop macros cannot retrieve main or associated
electrical equipment names and types because the signal is not directly
linked with these items. Furthermore, it is possible for a circuit to feed
more than one item of equipment, and this is incompatible with the
way that macros function, where each macro can retrieve only a single
data value at a time. Likewise, if a signal is linked to an item of
electrical equipment, you cannot use macros to retrieve circuit data.

Notes
• You can repeat this procedure as many times as you want to; SmartPlant
Instrumentation recognizes new, modified, and deleted data that is
published from SmartPlant Electrical.
• The data is owned by the application that created it. If you modify or
delete the data in the application that does not own it, the next time you
retrieve the data from the owner application, it overwrites any modified
data, or reinserts data if it was deleted. A specific data property usually
belongs to one or other of the applications; however, the Sys I/O type
property is owned by both applications and in this case the software
overwrites the value in whichever application you retrieve the data.
Related Topics
1557
Retrieve SmartPlant Electrical Data

1. Click SmartPlant> Retrieve.
2. On the Retrieve Document dialog box, type the path to the folder where the
source .xml files containing the published data are located, or click Browse to
navigate to the folder.
3. From the Document list, select the document that you want to retrieve.
Notes
• The software automatically retrieves the appropriate .xml files associated
with the document that you select.
• It is possible for SmartPlant Electrical users to delete items that originated
from SmartPlant Instrumentation, such as cabinets. In this case, when data
is next published from SmartPlant Electrical and retrieved back into
SmartPlant Instrumentation, the software creates Delete tasks for those
items in the To Do List window. If you do not want those items to be
deleted from the SmartPlant Instrumentation database, you should click
to remove the task from the To Do List window.
Related Topics

Create Electrical Tags

1. In the Domain Explorer, expand the plant hierarchy to display the Electrical
Tags folder and right-click the folder.
2. On the New Tag Number dialog box, enter a tag number.
3. On the Loop Name dialog box, if desired, enter a loop number or click Cancel to
skip loop creation.
4. On the Tag Number Properties dialog box, enter values as desired.
Tip
• Values that you enter for the Service and I/O type properties appear in
the Description and I/O type fields respectively for the signal
properties after the data is retrieved in SmartPlant Electrical.
Related Topics
1557

Viewing Electrical Tag Numbers

On retrieving data from SmartPlant Electrical, SmartPlant Instrumentation creates
corresponding electrical tags. You can view these tags from the Domain Explorer
or in the Browser module.
Notes
• Some tag number properties apply to SmartPlant Electrical data only, and
are read-only. You can edit other properties such as Service, I/O type,
and Notes.
• When you retrieve a SmartPlant Electrical PDB (power distribution board)
preassigned circuit signal, SmartPlant Instrumentation automatically
creates a cabinet with the name of the power distribution board associated
with the signal. If you delete such a cabinet, its preassignment
relationship with the signal is lost and you will no longer be able to find
the tag for that signal when you select Pre-assigned signals only in the
Signal Filter dialog box. However, the next time you publish the signal
from SmartPlant Electrical and retrieve it into SmartPlant Instrumentation,
the cabinet is created afresh.
• When you download electrical tags from SmartPlant Electrical, after
making the I/O assignments, SmartPlant Instrumentation automatically
assigns a control system tag to each electrical tag.
• There are three categories of electrical signals, for each of which the user
interface differs slightly, as follows:
• Signals related directly to PDB circuits that are associated with main
equipment; for example, a signal created in a feeder circuit that feeds a
motor.
• Signals directly related to main equipment; for example, a signal
created under a motor or a transformer.
• Signals associated directly with control stations that are associated
with main equipment such as motors.
In the Domain Explorer, electrical tag numbers can be viewed by expanding the
Electrical Tags folder.

In the Browser module, you can view electrical tag numbers from one of the
following browsers:
• Electrical Tag Browser — Displays data for all tag numbers derived
from SmartPlant Electrical signals for all items but does not retrieve data
values of associated attributes for signals created under circuits. The
software displays data for the main item and also associated circuit data.
• Circuit Related Electrical Tag Browser — Displays data for tag
numbers derived from SmartPlant Electrical signals for circuits. If a
circuit relates to more than one electrical item, a separate data row appears
for each item.
• Electrical Power Element Browser — Displays electrical properties
owned by SmartPlant Instrumentation and SmartPlant Electrical for
instruments and cabinets.
Related Topics
Associate Electrical Signals with Equipment

1. In the Domain Explorer, expand the Electrical Equipment folder hierarchy and
select the desired item of electrical equipment from one of the following sub-
folders:
• PDBs — for Power Distribution Boards and their associated circuits.
• Main Equipment — for items such as motors, heaters, control
stations that are associated with electrical equipment, and so forth.
• Control Stations — for control stations without associations with
electrical equipment.
Tips
• The items that appear in these folders are retrieved from SmartPlant
Electrical; you cannot create them in SmartPlant Instrumentation.
• To associate an electrical signal with an electrical equipment item, that
item may not have any existing associations.
2. From the Electrical Tags folder, select an electrical signal tag and drag it to the
desired item under the Electrical Equipment sub-folder.
Tip
• You can only associate electrical tag signals that do not have existing
associations with electrical equipment.

Create Wiring Items for SmartPlant Electrical Signals

1. If necessary, press F7 to open the Domain Explorer.
• Double-click the Panels by Location folder, right-click a location, and
then on the shortcut menu, click New > PLC Panel.
• Double-click the Panels by Category folder, right-click the PLC
Panels folder, and then on the shortcut menu, click New > PLC
Panel.
3. Create an I/O card for the PLC panel.
Tip
• When entering channel addresses for the I/O card, the values must be
numeric only for publishing to SmartPlant Electrical.
4. Create the cables needed to make the connections.
5. Add terminal strips to the cabinets that SmartPlant Instrumentation created
automatically from circuit signals that you downloaded from SmartPlant
Electrical.
6. Create device panels for tags that do not come from preassigned signals. Such
tags usually originate from SmartPlant Electrical control stations or from one of
the types of electrical equipment (motors, heaters, transformers, generators, and
so forth).
7. Create tag signals. For details, see Create a Local Signal for Electrical Tags,
page 1567.
8. Connect the PLC to the cabinet using the cable you created.
9. Re-propagate the tag signal to the PLC.
Note
• You can use macros related to SmartPlant Electrical signal data to
generate Enhanced Report Utility reports or CAD application-based
drawings.
Related Topics

Create a Device Panel for an Electrical Tag

This procedure shows you how to create a device panel for a tag that was created
from retrieved data originating in SmartPlant Electrical.
1. Open the Wiring module.

• Click Actions > Device Panels.
4. To display SmartPlant Electrical tags only, in the Filter dialog box, enter values
as shown:
5. Click OK to return to the Device Panels window.

6. Select a tag number and do one of the following:
• Click Actions > Create.

7. In the Create Device Panel and Cable dialog box, select the required default
panel, default cable, and connection type.
8. To apply the values that you set to all of the tags with incomplete profiles that you
selected in the Device Panels window, select Apply to all selected tags with
incomplete profile.
Related Topics

Create a Local Signal for Electrical Tags

This procedure shows you how to create a local signal in SmartPlant Instrumentation
for tags that were created from retrieved data originating in SmartPlant Electrical.
1. If necessary, press F7 to open the Domain Explorer.
2. Select one of the following:
• A terminal strip that you created for an automatically generated
cabinet (derived from the PDB in SmartPlant Electrical).
• A field device panel.
3. Right-click the selected item , and on the shortcut menu, click Actions >
Connection.
• Right-click in the data window and on the shortcut menu, click
Manage Local Signals.
5. On the Local Signal dialog box, click Filter.
6. In the Filter dialog box, select SmartPlant Electrical tags only. This option
selects only tags related to SmartPlant Electrical that do not have any connections.
• Select Preassigned signals only to select only those electrical tags for
which the SmartPlant Electrical signals have preassigned associations
to a power distribution board.
• Clear Preassigned signals only to select all unconnected tags related
to SmartPlant Electrical.
8. Click OK to return to the Local Signal dialog box.
9. Select a tag number and click Create to create and associate the local signal with
the tag number. Repeat this action for each tag number.
Tip
• SmartPlant Instrumentation creates the local signal and its name
appears next to the instrument tag with which it is associated in the
Local Signal dialog box.
10. Click Close.
Related Topics

Flow of Activities for Defining Power Supplies

The following steps constitute the primary flow of activities when you use SmartPlant
Instrumentation to define power supply requirements for instruments and cabinets:
1. In SmartPlant Instrumentation, press F7 to open the Domain Explorer.
2. Expand the appropriate folder to display instruments or panels.
3. Right-click the desired instrument or panel, and on the shortcut menu, click
Properties.
4. On the General tab of the dialog box for the selected item , select Requires
power supply.
Caution
• If the cabinet originated from PDB information in SmartPlant
Electrical, the power supply data for that cabinet belongs to
SmartPlant Electrical. In this case, entering power supply data in
SmartPlant Instrumentation results in the creation of a task in
SmartPlant Electrical that generates an error when run. To prevent
publishing of power supply data in this case, make sure that you clear
Requires power supply.
5. Click the Power Supply tab and enter your electrical load data.
6. Click OK to close the dialog box.
7. Publish the data to SmartPlant Electrical. This creates an .xml document
containing all SmartPlant Instrumentation data in the current plant such as the
control system configuration, I/O assignment, PLC I/O card and channel,
instrument tags, loop number, and so forth.
Tip
• The software creates the file in the path: <SmartPlant Instrumentation
home folder>\XML\IO Assignment_data.xml.
8. Retrieve the data in SmartPlant Electrical and run the tasks there to create
instruments and cabinets.
9. After assigning a PDB and circuit for each load, publish the data from SmartPlant
Electrical.
10. In SmartPlant Instrumentation, retrieve the SmartPlant Electrical data. For
details, see Retrieve SmartPlant Electrical Data, page 1561.

12. View the tag numbers or cabinets in SmartPlant Instrumentation and note that
power distribution board data appears on the Power Supply tab of the appropriate
dialog box.
Notes
• The power distribution board data is also available for displaying in loop
drawings.
• You can repeat this procedure as many times as you want to; SmartPlant
Instrumentation recognizes new, modified, and deleted data that is
published from SmartPlant Electrical.
• The data is owned by the application that created it. If you modify or
delete the data in the application that does not own it, the next time you
retrieve the data from the owner application, it overwrites any modified
data, or reinserts data if it was deleted. A specific data property usually
belongs to one or other of the applications.
Related Topics
1557
Publish Data for SmartPlant Electrical

1. Open the Browser module.
2. In the Browser Manager window, do one of the following:
• To publish electrical signal data, expand the hierarchy Instrument
Index > Electrical Tag Browser.
• To publish power supply data, expand the hierarchy Instrument
Index > Electrical Power Element Browser.
3. Open the browser view, or create a new view.
4. On the toolbar, click Print .
5. At the prompt to preview the report, click Yes.
6. On the Print Preview window toolbar, click Revisions .
7. On the Publish SmartPlant Electrical Data dialog box, select Publish
document and data.
Important
• You must always choose this option when revising data in the
SmartPlant Electrical Interface.
8. On the Revisions dialog box, click New.

9. On the SmartPlant Foundation Revise dialog box, beside Revision Scheme, select
a value from the list.
10. Under Revise in Tool, beside Major, select a value from the list.
11. Click OK to implement the revision.
Tip
• When publishing in point-to-point mode, clicking New on the
Revisions dialog box just adds a new line in which you can type the
revision details.
12. Click OK to close the Revisions dialog box.
13. Click SmartPlant > Publish.
14. On the Publish SmartPlant Electrical Data dialog box, select Publish
document and data.
Important
• You must always choose this option when publishing in the
SmartPlant Electrical Interface.
15. On the Publish dialog box, from the Operation list, select Publish Now or
Background Publish.
16. Click OK to publish the data.
17. From the Publish message box, click Close if the publish operation was
successful, or View Log if there were errors.
Related Topics

DCS Vendor Interfaces
Overview
The DCS Vendor interfaces allow you to share data between SmartPlant
Instrumentation and the appropriate DCS vendor software at the component/card
level. If, for example, you design a loop that needs to be controlled by a particular
DCS system, you need to connect the loop wiring to I/O cards in the DCS for the
vendor that you specify. SmartPlant Instrumentation supports the following DCS
vendors:
DCS Product Name Vendor Available Activities

DeltaV Emerson Bidirectional publish and retrieve
Yokogawa - CENTUM CS Yokogawa Bidirectional publish and retrieve
3000
ABB ABB Retrieve I/O card catalog definitions
only
Honeywell Honeywell Retrieve I/O card catalog definitions
only
Notes
• All DCS vendors support both conventional and Foundation Fieldbus
instruments. In addition, DeltaV supports HART instruments.
• You are allowed to specify only one DCS vendor per domain.
• A number of shipped rules apply to SmartPlant Instrumentation items
when used for specific DCS vendors. You can view these rules in the
Rule Manager under Interfaces.
Related Topics
• Flow of Activities for Configuring DeltaV, page Error! Bookmark not
defined.
• Flow of Activities for Configuring Yokogawa CENTUM CS 3000, page
Error! Bookmark not defined.
• Prerequisites for Working with DCS Vendor Interfaces, page 1573

SmartPlant Instrumentation - DCS Vendors: Comparative

Terminology
Although the SmartPlant Instrumentation - DCS vendor interfaces effect automated
transfer of definitions and data, it is important to understand some of the differences
in terminology between SmartPlant Instrumentation and different DCS vendors. The
following is a partial list:
SmartPlant SmartPlant DeltaV CENTUM CS

Instrumentation Instrumentation Terminology 3000
Dialog Box Terminology Terminology
Distributed Control Rack Carrier Node
System (DCS)
Properties;
Racks
Racks Slot Position
Card Module
I/O Card Properties; Strip Type I/O Card Type
Strip Type
Channels; Channel Type I/O Channel
Channel Types Type
Channels; Channel Channel Terminal
Terminal Properties (conventional)
Channel (fieldbus) Port
I/O Termination Termination
Board
Fieldbus Instrument Instrument Type + Device Type
Tag Association Description
Related Topics
• DCS Vendor Interfaces: An Overview, page 1571

Prerequisites for Working with DCS Vendor

Interfaces
The DCS vendor interfaces function for any Oracle or SQL Server database that is
approved for SmartPlant Instrumentation Version 2007. (For details, see SmartPlant
Instrumentation Installation Guide, Installing SmartPlant Instrumentation on Oracle
and Installing SmartPlant Instrumentation on SQL Server.)
Make sure that you have Internet access to the URL from which you download the
particular DCS vendor definitions document.
Before you can work with any DCS vendor interface, you must perform the following
actions:
1. Install the SmartPlant Schema Component from the SmartPlant Instrumentation
CD Browser (click Add-In Software, and then click Schema Component
Installation).
Tip
• On the Select Optional Features page, clear the Schema Editor
check box if you do not need to use the Schema Editor.
2. Install the SmartPlant Client from the SmartPlant Instrumentation CD Browser
(click Add-In Software, and then click SmartPlant Client Installation).
Tip
• On the Select Features page, make sure that you clear the SmartPlant
Automatic Retrieval check box.
3. Configure SmartPlant Instrumentation to work in file mode. For details, see
Configure SmartPlant Instrumentation to Publish and Retrieve Data in File
Mode, page 1575.
4. The System Administrator must enable the item registry. For details, see Enable
Item Registry in the Administration User's Guide, under System Administration,
Domain Management.
5. The System Administrator must specify the XML path to the folder in which the
IntoolsMap.xml and ContextMap.xml files are located; this must be done for each
domain where you intend to publish DCS vendor data. By default, these files are
located in the path: <SmartPlant Instrumentation home folder>\XML\.
6. The Domain Administrator must register the items. For details, see Register
Items in the Administration User's Guide, under Working in an Integrated
Environment.

7. The Domain Administrator must ensure that he SmartPlant Instrumentation and

DeltaV naming conventions are identical and that function blocks are defined
using free segment naming conventions as shown.
8. Create new instrument type definitions in SmartPlant Instrumentation as needed

to match those in DeltaV.
9. Optimize your SmartPlant Instrumentation preferences for the interface with your
selected DCS vendor. For details, see DCS Vendors (Preferences) in SmartPlant
Instrumentation Online Help.
Related Topics
• Flow of Activities for Configuring DeltaV, page 1576
1590

Configure SmartPlant Instrumentation to Publish and

Retrieve Data in File Mode
1. Close any programs that are currently running.
2. On the Windows desktop, right-click the My Computer icon, and on the shortcut
3. Click the Advanced tab.
4. Click Environment Variables.
5. Under System variables, click New.
6. On the New System Variable dialog box, in the Variable name field, type
EFCommonufilemode and in the Variable value field, type 1.

Flow of Activities for Configuring DeltaV

This topic describes the primary flow of activities when you use SmartPlant
Instrumentation to design a plant to be run and controlled using the Emerson DeltaV
plant automation and control system.
Notes
• Before publishing or retrieving DeltaV data for the first time, make sure
that you perform the prerequisite activities indicated: retrieving DeltaV
definitions, updating your plant design, and if appropriate, associating
Foundation Fieldbus device types.
• You may perform any of the stages of this flow of activities multiple times
during the project life cycle.
Retrieve DeltaV Definitions
Retrieving DeltaV definitions is a prerequisite for both publishing and retrieving
DeltaV data. The DeltaV item definition documents that you download and retrieve
in SmartPlant Instrumentation constitute the engineering library of DeltaV objects -
the DeltaV DCS (Distributed Control System), Foundation Fieldbus and HART
elements, and entries for supporting tables such as Manufacturer, Model, and so
forth. For more information, see Retrieve DeltaV Definitions, page 1582.
Update Your Plant Design

Prior to publishing or retrieving data, you must update your plant design using the
DeltaV-compatible objects now available in the Reference Explorer and supporting
tables of your SmartPlant Instrumentation database. From the perspective of
SmartPlant Instrumentation, the DeltaV DCS (Distributed Control System) panel is a
DCS in the Reference Explorer from which you create a specific DeltaV DCS in the
Domain Explorer. You can then create appropriate sub-items and perform wiring
connections as desired.
Important
• In the Reference Explorer, do not change any of the values in the items
that you retrieved from the DCS vendor.

Publish Data for DeltaV

After you complete the process of designing your DeltaV-compatible plant in
SmartPlant Instrumentation, use this procedure to publish (export) the required data
for accurate and efficient DeltaV configuration. The software publishes a partial set
of the SmartPlant Instrumentation database, including data such as the DeltaV
configuration, I/O assignment, instrument tags, and so forth (the process does not
export specification data, for example). For details of the procedure to publish data,
see Publish Data for DeltaV, page 1588.
After retrieving the published data in DeltaV, validate and, if necessary, reconcile the
data with the DeltaV database.
Retrieve DeltaV Data

Use this procedure to retrieve (import) data from DeltaV. The software retrieves
controllers and slots and, if specified in the published .xml file, Foundation Fieldbus
devices. For details of the procedure to retrieve data, see Retrieve DeltaV Data, page
1583.
Important
• If using fieldbus tags, after retrieving the DeltaV data, but before running
any To Do List tasks, you must make associations between device types
for Foundation Fieldbus or HART instruments with instrument
manufacturers, and SmartPlant Instrumentation instrument types. For
more information, see Associate Device Types for DCS Vendors, page
1599.
Related Topics
• Crucial Fields for the DeltaV Interface, page 1585
• Prerequisites for Working with DCS Vendor Interfaces, page Error!
Bookmark not defined.

Data Limitations for the DeltaV Interface

When you prepare a SmartPlant Instrumentation domain for publishing to DeltaV,
you must be careful to enter values with limitations according to the table that
follows. In most cases, the software validates the data; however, it does not validate
data that you merge in the database or data that you enter via a browser view; in these
cases, it is up to you to check that the values comply with these limitations.
Important
• SmartPlant Instrumentation validates the data only if the DCS
manufacturer name is Emerson Process.
• If you intend to publish fieldbus data, set the relevant option on the
Preferences dialog box. For details, see Interfaces > DCS Vendors
(Preferences).
• Spaces are not allowed in DeltaV tags, therefore, when publishing data,
SmartPlant Instrumentation removes spaces in instrument and Control
System tags. You can specify a substitute character, such as an
underscore, to replace the spaces; to do so, you must add the following
line in the Intools.ini file under the [API] section:
NameSpacesReplacement = "_"
It is recommended not to select any character that appears in the tag names as the
substitute character because when retrieving data back from DeltaV, SmartPlant
Instrumentation replaces that character with spaces again.
Item Type Limitation

I/O Card The DCS manufacturer name is Emerson Process
and this must not be modified.
I/O Card The card name must begin with an uppercase 'C'
followed by a numeric value, for example C16.
Rack The rack name must be a numeric value.
Slot The slot name must be a numeric value between 1
and 8 characters.
Controller The controller name must be unique in the domain.
Controller The controller name must be uppercase and between
1 and 16 characters.

Units of Measure Limitations

To avoid errors when publishing data, only those units of measure that are supported
by DeltaV should be available for selection. To set the available units of measure,
click Tools > Units of Measure Codes, and clear the Enabled check boxes for all
units of measure except for those that appear in the following table.
Unit of Measure Code Unit of Measure Name Unit of Measure Type

% Percent PT
%V Percent of volume PT
%W Percent of weight PT
µF µF FA
µH µH HE
µm micrometer LN
1/ºC 1/Degree C LE
1/ºF 1/Degree F LE
A A CU
Btu IT/ft³ Btu IT/ft³ CV
Btu IT/h Btu IT/h WT
Btu IT/s Btu IT/s WT
Btu_IT/(ft^2-h-degf
Btu_IT/lbm
Btu_IT-in/(h-ft^2-degF)
BtuIT/lbºF Btu(IT)/(lbºF) SH
Btuth/lbºF Btu(th)/(lbºF) SH
cal IT/m³ cal IT/m³ CV
Cal_IT/g
Cal_th/g
cm² centimeter² AR
cm²/s cm²/s VS
cS centistokes VS
D Days
ft² foot² AR
ft²/s ft²/sec. VS
ft³ ft³ VM
g gram ML
G in/s² AC


h hours TT
HP Horse Power WT
Hz Hz FQ
in² inch² AR
in²/s in²/sec. VS
in³ in³ VM
J/(kg.K) J/(kg.K) SH
J/kg J/kg LH
kg kilogram ML
kg/m kg/m WL
kgf kilogram-force FR
kHz kilo Hertz FQ
KJ/m³ Kilo Joule per cubic CV
meter
kj/(kg.K) kj/(kg.K) SH
kJ/(kg.ºC) kJ/(kg.ºC) SH
kJ/kg kJ/kg LH
km kilometer LN
km² kilometer² AR
Kohm Kohm OM
kV kilo Volt VO
kVA kiloVolt-ampere
kVAr kiloVolt-ampere reactive WR
kW kilo Watt WT
L L VM
lb pound ML
Lbf lb-force FR
Lbm/ft
Lm lumen LI
m² Square Meter AR
m²/s m²/sec. VS
m³ Cubic Meter VM
mA mA CU
Mg milligram ML


mg/m³ milligram/cubic meter DN
mH mH HE
MHz Mega Hertz FQ
Mi^2_int
Micron micron LN
Mile mile LN
mile² mile² AR
MILS 1/1000 inch LN
Min minutes TT
mm/s millimeter/sec. VL
mm/s² mm/s² AC
mm² millimeter² AR
mm²/s mm²/s VS
Mohm Mega Ohm OM
mPa-s
mV mV VO
mW mW WT
MW Mega Watt WT
N newton FR
nF nF FA
º degree AN
Ohm ohm OM
Ohm/m Ohm/m RF
oz ounce ML
PPMV a millionth volume PT
PPMW a millionth weight PT
Rad radian AN
Rpm revolutions per min FQ
S seconds TT
St stokes VS
T metric ton ML
US gal US gallon VM
V V VO


W W WT
yd² yard² AR
Related Topics
1590
• Publish Data for Yokogawa CENTUM CS 3000, page 1596
Retrieve DeltaV Definitions

Important
• Before you start this procedure, make sure that you have an Internet
connection and a valid Intergraph customer user name and password.
• SmartPlant Instrumentation is only capable of handling certain I/O types
that DeltaV supports. For this reason, not all of the I/O cards that you
download in the DeltaV definitions are compatible with SmartPlant
Instrumentation: for example, the interface does not handle ASI and Serial
cards.
1. In any SmartPlant Instrumentation module, click Tools > Interfaces > DeltaV.
2. Under Data transfer mode, select Retrieve DeltaV definitions and click OK.
3. To download the DeltaV definitions files, do the following:
a. On the Retrieve DeltaV Definitions dialog box, beside Default DeltaV
definitions URL, click Download.
b. On the Web page that opens, complete the form and click Submit.
c. Follow the instructions for downloading the files.
d. On the File Download dialog box, click Save.
e. On the Save As dialog box, navigate to the desired folder and click Save.
f. On the Download Complete dialog box, click Close.
4. On the Retrieve DeltaV Definitions dialog box, click Browse and navigate to the
folder where you downloaded the DeltaV definitions files.
5. Under the Select column, select the documents that you want to retrieve in
SmartPlant Instrumentation and click OK.
Important
• If retrieving the HART definition file in order to publish and retrieve
HART instruments, you must first retrieve the fieldbus definition file.

6. When done, click Cancel.

Notes
• Once you have retrieved Foundation Fieldbus or HART definitions, you
can use them to make appropriate associations among Foundation
Fieldbus device types, instrument manufacturers, and SmartPlant
Instrumentation instrument types. For details, see Associate Device Types
for DCS Vendors, page 1599.
• When retrieving DeltaV definitions, the software automatically adds new
definitions and updates any modifications to definitions that already exist
in the SmartPlant Instrumentation database. However, you must delete
any redundant definitions manually from the Reference Explorer.
Related Topics
• SmartPlant Instrumentation - DCS Vendors: Comparative Terminology,
page Error! Bookmark not defined.
• View the Log File for a DCS Vendor, page 1601
Retrieve DeltaV Data

Important
• Before retrieving data, you must configure SmartPlant Instrumentation to
work in file mode. For details, see Configure SmartPlant Instrumentation
to Publish and Retrieve Data in File Mode, page 1575.
2. Under Data transfer mode, select Retrieve DeltaV data and click OK.
3. In the Select Data XML File window, navigate to the .xml file that contains the
DeltaV data and click Open.
Tip
• After selecting the file, two more windows open: Select Meta-data
XML File and Select Tombstones XML File. Just click Cancel in
both of these windows.
4. On successful completion of the retrieval, click Close on the message box that
appears, or if errors occurred, click View Log to troubleshoot them.

5. Click SmartPlant > To Do List.

Important
• If using fieldbus tags, after retrieving the DeltaV data, but before
running any tasks from the To Do List, you must make associations
between Foundation Fieldbus device types, instrument manufacturers,
and SmartPlant Instrumentation instrument types. For more
information, see Associate Device Types for DCS Vendors, page 1599.
6. In the To Do List window, select all the Create tasks for the DeltaV items;
however, do not select the Update task for the CS Tag.
7. From the To Do List toolbar, click Run Task .
Tips
• Performing this action creates the DeltaV controllers, slots, I/O cards,
and so forth in the Domain Explorer under the Controllers folder.
• For more details of available options when running tasks, see Run a
Task from the To Do List, page 1676.
8. In the Domain Explorer, create a DCS and rack as needed, and then drag a DeltaV
slot to the rack.
9. In the To Do List window, run the Update task for the CS Tag.
Related Topics
• Using the To Do List: An Overview, page 1673

Crucial Fields for the DeltaV Interface

When you prepare a SmartPlant Instrumentation domain for publishing to DeltaV,
you must be careful to enter values according to the table that follows.
Important
• If you diverge from the following table and its notes, the software does not
validate the data; however, the DeltaV reconciliation program will reject
data values that are incompatible. For complete details of the exact
DeltaV values to use, please refer to your DeltaV Hardware Manual.
(Preferences).
Dialog Box Field Accept Enter Valid Optional
DeltaV Value Value
Value
DCS Properties Type - - Y
DCS Properties Manufacturer - - Y
Rack Properties Number of Y
Slots See note #3
Rack Properties Rack position Y
numbering See note #3
Slot Properties Controller - Y -
See note #4
Controllers Controller - Y -
See note #4
Controllers Redundant - Y -
Controllers Manufacturer - Emerson -
Process
I/O Card Properties, Series Y - -
General tab
I/O Card Properties, Type Y - -
General tab
I/O Card Properties, Manufacturer Y - -
General tab
I/O Card Properties, I/O type Y - -
Control System tab
I/O Card Properties, Rack/Carrier - Y -
Control System tab

Dialog Box Field Accept Enter Valid Optional

DeltaV Value Value
Value
I/O Card Properties, Define a Y - -
Control System tab Redundant I/O See note #5
Terminal Properties Terminal - Y -
Terminal Properties Sequence Y - -
Terminal Properties Terminal color - Y -
Terminal Properties Channel Y - -
Channels Channel Y - -
Channels Enable - Y -
Channels Channel type - Y -
See note #6
Channel Types Channel type Y - -
See note #6
Tag Number Properties Manufacturer - Y -
General tab See note #7
Tag Number Properties Field device - Y -
Fieldbus tab address See note #8
Tag Number Properties Fieldbus device - Y -
Fieldbus tab revision See note #9
Tag Number Properties Backup link - Y -
Fieldbus tab master See note
#10
Notes
1. The value Y (Yes) is an indication to act according to the column header as
follows:
• Accept DeltaV Value — Do NOT change the value of this field.
• Enter Valid Value — Accept the value retrieved from DeltaV, if one
exists, or enter a different valid value.
• Optional Value — Accept the value retrieved from DeltaV, if one
exists, or enter a different valid value, or enter no value.
2. Although there are additional optional fields in the dialog boxes listed, the table
only includes optional fields for which data is retrieved from DeltaV.
3. In the Racks dialog box, under Rack position numbering, accept the default
selection of Start from one. In the data window, for each rack that you create,
type the value 8 under Number of slots.

4. A controller name must be upper case, and not more than 16 characters. You
must assign each controller to those slots that share the associated I/O card.
5. If you are defining a DeltaV redundant I/O card for a DCS panel, make sure that
in the Primary location group box the value under Position is an odd number,
and that the secondary location position value is an even number one greater than
the position value for the primary location.
6. DeltaV redundant I/O cards are wide and therefore they occupy two adjacent slots
in their carriers. Note that the cards can only be placed in odd-numbered slots.
DeltaV I/O cards have their terminations on the I/O cards themselves, and so there
is no need for separate termination cards to be connected to the I/O cards. On the
Control System tab of the I/O Termination dialog box, you must select the
Define a redundant I/O card check box. On publishing the data, this indicates to
DeltaV that the card is defined as a redundant double-width I/O card.
7. You can use only the following DeltaV cards as redundant I/O cards:
• AI_8CH_HART_4-20_RED
• AO_8CH_HART_4-20_RED
• RFIC
• DI_8CH_24VDC_DCT_RED
• DO_8CH_24VDC_HSS_RED
• RED_PROG_SERIAL_32DS
• RED_SERIAL_32DS
8. After you retrieve DeltaV definitions, the Channel Types supporting table is
populated with DeltaV-compatible channel types for DeltaV-compatible I/O strip
types. These are the only DeltaV-compatible values for the Channel Type field in
the Channels dialog box.
9. When you create a fieldbus tag based on an given instrument type, on the
General tab of the Tag Number Properties dialog box, make sure that the value
that you select from the Manufacturer list is among the acceptable values that
you set for this instrument type during retrieval from DeltaV.
10. On the Fieldbus tab of the Tag Number Properties dialog box, under Field
device address, you must type a value between 20 and 35 (inclusive). If you
select the Backup link master check box, type the value 20 under Field device
address.
11. The values available on the Fieldbus tab of the Tag Number Properties dialog
box under Fieldbus device revision are determined by the value that you select
from the Manufacturer list on the General tab.
12. On the Fieldbus tab of the Tag Number Properties dialog box, select the
Backup link master check box only for a device that you verified is capable of
being a backup.

Publish Data for DeltaV

Important
• Spaces are not allowed in DeltaV tags, therefore, when publishing data,
SmartPlant Instrumentation removes spaces in instrument and Control
System tags. You can specify a substitute character, such as an
underscore, to replace the spaces; to do so, you must add the following
line in the Intools.ini file under the [API] section:
NameSpacesReplacement = "_".
2. On the DeltaV Interface dialog box, under Data transfer mode, click Publish
SmartPlant Instrumentation data, and then click OK.
Tip
• If prompted to enable the item registry (even though your System
Administrator has already activated this option as required), contact
SmartPlant Instrumentation support.
3. On the Plant Controller Selection dialog box, do one of the following:
• To publish all relevant database fields for DeltaV, select the Select all
check box.
• For publishing of data associated with a given controller, select the
Select check box next to that controller.
4. On the Publish to File dialog box, under Folder to save XML files, type the path
for DeltaV publishing, and click OK to publish the .xml file for the first controller
that you selected.

5. For each additional controller that you selected in the SmartPlant Instrumentation
Plant Controller Selection dialog box, when the Publish to File dialog box
reopens, click OK.
Notes
• SmartPlant Instrumentation publishes the data associated with each
controller into a separate .xml file.
• On publishing data other than for the first time, DeltaV identifies changes
as follows:
• The software identifies new items created in SmartPlant
Instrumentation as new items to be created in DeltaV.
• If you move items, cards, CS tags, or if you modify item fields in
SmartPlant Instrumentation, the software identifies these as items to be
updated in DeltaV.
• The software identifies items deleted in SmartPlant Instrumentation as
items to be deleted in DeltaV.
Related Topics
• Crucial Fields for the DeltaV Interface, page 1585

Flow of Activities for Configuring Yokogawa

CENTUM CS 3000
This topic describes the primary flow of activities when you use SmartPlant
Instrumentation to design a plant to be run and controlled using the Yokogawa
CENTUM CS 3000 plant automation and control system. Note that the flow that
follows may be performed multiple times during the project life cycle.
1. Retrieve the Yokogawa CENTUM CS 3000 Definitions

The Yokogawa CENTUM CS 3000 item definition documents that you download and
retrieve in SmartPlant Instrumentation constitute the engineering library of
Yokogawa CENTUM CS 3000 objects - Yokogawa CENTUM CS 3000 I/O cards,
Foundation Fieldbus elements, and entries for supporting tables such as
Manufacturer, Model, and so forth. For more information, see Retrieve Yokogawa
CENTUM CS 3000 Definitions, page 1594.
2. Retrieve Yokogawa CENTUM CS 3000 Data

For more information, see Retrieve Yokogawa CENTUM CS 3000 Data, page 1595.
3. Update Your Plant Design

Using the Yokogawa CENTUM CS 3000-compatible objects now available in the
Reference Explorer and supporting tables of your SmartPlant Instrumentation
database, update your plant design. From the perspective of SmartPlant
Instrumentation, the Yokogawa CENTUM CS 3000 panel is a DCS in the Reference
Explorer from which you create a specific Yokogawa CENTUM CS 3000 DCS in
the Domain Explorer.
Important
• In the Reference Explorer, do not change any of the values in the items
that you retrieved from the DCS vendor.
For information on how to make associations between Foundation Fieldbus device
types, instrument manufacturers, and SmartPlant Instrumentation instrument types,
see Associate Device Types for DCS Vendors, page 1599.

4. Publish Data for Yokogawa CENTUM CS 3000

The .xml document that you publish (export) is a partial set of the SmartPlant
Instrumentation database, including data such as the Yokogawa CENTUM CS 3000
configuration, I/O assignment, conventional and fieldbus data, and so forth.
After you complete the process of designing your Yokogawa CENTUM CS 3000-
compatible plant in SmartPlant Instrumentation, use this procedure to publish (export)
the required data for accurate and efficient Yokogawa CENTUM CS 3000
configuration. You publish a partial set of the SmartPlant Instrumentation database,
including data such as the Yokogawa CENTUM CS 3000 configuration, I/O
assignment, instrument tags, and so forth. (The process does not export specification
data, for example.) For more information, see Publish Data for Yokogawa CENTUM
CS 3000, page 1596.
5. Retrieve Data Published from SmartPlant Instrumentation into

Yokogawa CENTUM CS 3000
Following the retrieval, validate and — if necessary — reconcile the data retrieved
from SmartPlant Instrumentation with the Yokogawa CENTUM CS 3000 database.
Related Topics

Data Limitations for the Yokogawa CENTUM CS 3000

Interface
When you prepare a SmartPlant Instrumentation domain for publishing to Yokogawa
CENTUM CS 3000, you must be careful to enter values with limitations according to
the table that follows. In most cases, the software validates the data; however, it does
not validate data that you merge in the database or data that you enter via a browser
view; in these cases, it is up to you to check that the values comply with these
limitations.
Important
• SmartPlant Instrumentation validates the data only if the DCS
manufacturer name is CENTUM CS 3000.
(Preferences).
• Only ONE I/O card is allowed per slot.
• Spaces are not allowed in Yokogawa CENTUM CS 3000 tags, therefore,
when publishing data, SmartPlant Instrumentation removes spaces in
instrument and Control System tags. You can specify a substitute
character, such as an underscore, to replace the spaces; to do so, you must
add the following line in the Intools.ini file under the [API] section:
NameSpacesReplacement = "_"
It is recommended not to select any character that appears in the tag names as the
substitute character because when retrieving data back from Yokogawa
CENTUM CS 3000, SmartPlant Instrumentation replaces that character with
spaces again.
Panel The panel name is not allowed to exceed 7
characters.
Panel The Panel DCS naming must start with the string
"FCS".
Panel The Panel DCS naming must contain two 2-digit
numeric strings.
Panel The first number in the panel DCS must be between 1
and 32.
Panel The second number in the panel DCS must be
between 1 and 64.
Panel The Naming Convention for a default panel is read-
only and must not be modified.


I/O Card The DCS manufacturer name is CENTUM CS 3000
and this must not be modified.
I/O Card The following properties are read-only and must not
be modified: card type, I/O type, model, module,
controller.
I/O Card The card name and type must be the same.
I/O Card A card can only appear under a slot.
I/O Card The Naming Convention for default Wiring
Equipment is read-only and must not be modified.
I/O Card The controller or the module for a default card is
read-only and must not be modified.
I/O Card The series for I/O Wiring Equipment is read-only and
must not be modified.
Control System Tag The DCS function block name is not allowed to
exceed 16 characters.
Control System Tag The control strategy drawing number must be
between 1 and 200.
Control System Tag The control system tag description is not allowed to
exceed 24 characters.
Channel The channel name and sequence values must be the
same.
Channel The channel address is read-only and must not be
modified.
Rack The default rack name is read-only and must not be
modified.
Rack The cabinet rack name must be between 1 and 15
characters.
Slot The slot name must be a numeric value between 1
and 8 characters.
Slot The controller for a default slot is read-only and must
not be modified.
Related Topics
1590
• Publish Data for Yokogawa CENTUM CS 3000, page 1596

Retrieve Yokogawa CENTUM CS 3000 Definitions

Important
1. In any SmartPlant Instrumentation module, click Tools > Interfaces > Yokogawa
CENTUM CS 3000.
2. Under Data transfer mode, select Retrieve Yokogawa CENTUM CS 3000
definitions and click OK.
3. On the Retrieve Yokogawa CENTUM CS 3000 Definitions dialog box, click
Browse, navigate to the folder that contains the Yokogawa files, and click OK.
4. In the data window, under Select, select the documents that you want to retrieve
in SmartPlant Instrumentation, and click OK.
Notes
• Once you have retrieved Foundation Fieldbus definitions, you can use
them to make appropriate associations among Foundation Fieldbus device
types, instrument manufacturers, and SmartPlant Instrumentation
instrument types. For details, see Associate Device Types for DCS
Vendors, page 1599.
• When retrieving Yokogawa CENTUM CS 3000 definitions, the software
automatically adds new definitions and updates any modifications to
definitions that already exist in the SmartPlant Instrumentation database.
However, you must delete any redundant definitions manually from the
Reference Explorer.
Related Topics
1590
• SmartPlant Instrumentation - DCS Vendors: Comparative Terminology,
page 1572

Retrieve Yokogawa CENTUM CS 3000 Data

Important
• Before retrieving data, you must configure SmartPlant Instrumentation to
work in file mode. For details, see Configure SmartPlant Instrumentation
to Publish and Retrieve Data in File Mode, page 1575.
- CENTUM CS 3000.
2. Under Data transfer mode, select Retrieve Yokogawa - CENTUM CS 3000
data and click OK.
3. In the Select Data XML File window, navigate to the .xml file that contains the
Yokogawa data and click Open.
Tip
• After selecting the file, two more windows open: Select Meta-data
XML File and Select Tombstones XML File. Just click Cancel in
both of these windows.
4. On successful completion of the retrieval, click Close on the message box that
appears, or if errors occurred, click View Log to troubleshoot them.
Important
• If using fieldbus tags, after retrieving the Yokogawa data, but before
running any tasks from the To Do List, you must make associations
between Foundation Fieldbus device types, instrument manufacturers,
and SmartPlant Instrumentation instrument types. For more
information, see Associate Device Types for DCS Vendors, page 1599.
6. In the To Do List window, select the tasks that you want to run.
Tip
• For more details of available options when running tasks, see Run a
7. On the To Do List toolbar, click Run Task .
Related Topics
1590

Publish Data for Yokogawa CENTUM CS 3000

Important
• Spaces are not allowed in Yokogawa CENTUM CS 3000 tags, therefore,
when publishing data, SmartPlant Instrumentation removes spaces in
instrument and Control System tags. You can specify a substitute
character, such as an underscore, to replace the spaces; to do so, you must
add the following line in the Intools.ini file under the [API] section:
NameSpacesReplacement = "_".
CENTUM CS 3000.
2. On the Yokogawa CENTUM CS 3000 Interface dialog box, under Data
transfer mode, click Publish SmartPlant Instrumentation data, and then click
OK.
Tip
• If prompted to enable item registry (even though your System
Administrator has already activated this option as required), contact
SmartPlant Instrumentation support.
3. On the Plant Panel Selection dialog box, do one of the following:
• To publish all relevant database fields for Yokogawa CENTUM CS
3000, select the Select all check box.
• For publishing of data associated with a given DCS panel, select the
Select check box next to that panel.
4. On the Publish to File dialog box, under Folder to save XML files, type the path
for Yokogawa CENTUM CS 3000 publishing, and click OK to publish the .xml
file for the first DCS panel that you selected.
5. For each additional DCS panel that you selected in the SmartPlant
Instrumentation Plant Panel Selection dialog box, when the Publish to File
dialog box reopens, click OK.
Note
• SmartPlant Instrumentation publishes the data associated with each DCS
panel into a separate .xml file.
Related Topics
• Prerequisites for Working with DCS Vendor Interfaces, page 1573

Retrieving ABB Definitions
Retrieve ABB Definitions

Important
• SmartPlant Instrumentation is only capable of handling certain I/O types
that ABB supports. For details of supported I/O card catalog definitions,
contact Intergraph Support.
1. In any SmartPlant Instrumentation module, click Tools > Interfaces > ABB.
2. On the Retrieve ABB Definitions dialog box, click Browse, navigate to the
folder that contains the ABB files, and click OK.
Note
• When retrieving ABB definitions, the software automatically adds new
definitions and updates any modifications to definitions that already exist
in the SmartPlant Instrumentation database. However, you must delete
any redundant definitions manually from the Reference Explorer.
Related Topics

Retrieving Honeywell Definitions
Retrieve Honeywell Definitions

Important
• SmartPlant Instrumentation is only capable of handling the following I/O
types that Honeywell supports:
• PMIO.
• Series C IO.
• Safety Manager IO (SM).
• Fail Safe Controller IO (FSC).
1. In any SmartPlant Instrumentation module, click Tools > Interfaces >
Honeywell.
2. On the Retrieve Honeywell Definitions dialog box, click Browse, navigate to the
folder to which you unzipped the files that you downloaded, and click OK.
Note
• When retrieving Honeywell definitions, the software automatically adds
new definitions and updates any modifications to definitions that already
exist in the SmartPlant Instrumentation database. However, you must
delete any redundant definitions manually from the Reference Explorer.
Related Topics

General DCS Vendor Activities
Associate Device Types for DCS Vendors

Use this procedure to make associations between Foundation Fieldbus and HART
device types, instrument manufacturers, and SmartPlant Instrumentation instrument
types.
Important
• After you have retrieved data from your DCS vendor interface, you can
determine the manufacturer and device type of each Foundation Fieldbus
device that you need to associate with a SmartPlant Instrumentation
instrument type. To do so, display the To Do List window and double-
click a fieldbus device. On the Details tab, the value of the MFR
COMPANY IDENTIFICATION property corresponds to the
manufacturer's identification number. This number appears in parentheses
beside the name of the manufacturer in the Tree View pane of the
Associate Foundation Fieldbus Device Types with Instrument Type
dialog box. The value of the FieldBus Device ID task property
corresponds to the number in the Device Type column on the Details pane
of the Associate Foundation Fieldbus Device Types with Instrument
Type dialog box. The adjacent Device Type Description column assists
you in selecting the appropriate instrument type to associate.
1. Click Tools > Interfaces > Associate Foundation Fieldbus Device Types.
2. In the Tree View pane, click to expand the Certified Fieldbus Instruments list
and display the available manufacturers.
• Select a manufacturer to view details of all the device types available
for that manufacturer.
• For a particular manufacturer, click and select a device type to view
its details.
4. In the Details pane, select the desired device type and click Associate.

5. In the Instrument Types dialog box, do one of the following:

• Select an existing fieldbus instrument type for which the I/O type
value is Fieldbus, for association with the current device type. You
can check the I/O type by viewing the profile of the instrument type.
• Create a new fieldbus instrument type or edit an existing one. For
details, see Define Foundation Fieldbus and Profibus Instrument Type
Profiles.
Important
• When you create fieldbus tags that are compatible with the DCS
vendor, the only acceptable values for instrument type are those that
you associated with device types for that vendor during the
downloading process.
6. Click OK to associate the selected instrument type with the current device type
and close the Instrument Types dialog box.
Important
• When you create a fieldbus tag based on the displayed instrument type,
the only acceptable values for the manufacturer are those displayed in
this dialog box. If you select other manufacturers, this will prevent
validation in the DCS vendor's database.
•You can associate only one function block for each device type with a
particular instrument type.
Notes
• For general guidelines regarding fieldbus devices, see Foundation
Fieldbus Design: An Overview and Profibus Design: An Overview.
• For details of how to create fieldbus devices, see Create Foundation
Fieldbus and Profibus Instruments.

View the Log File for a DCS Vendor

Note
• After you retrieve item definition documents from a DCS vendor into
SmartPlant Instrumentation, you can use this procedure to view and save
the log. You can then open the .txt file in a word processor or text editor
and print it.
1. On the appropriate DCS vendor dialog box, for example, Retrieve Yokogawa -
CENTUM CS 3000 Definitions, click View Log.
2. On the Log dialog box, view the log.
3. To save the log as a .txt file, click Save.
4. On the Select File dialog box, navigate to the desired folder and type a file name.
5. Click Save.

NE-100 Interface: An Overview

The SmartPlant Instrumentation NE-100 interface is designed to map SmartPlant
Instrument attributes to their corresponding NE-100 attributes and allow for the
transfer of data between SmartPlant Instrumentation databases and NE-100 compliant
databases.
NE-100 Interface Common Tasks

The following tasks are used when you use the NE – 100 interface to transfer
specification data between SmartPlant Instrumentation and NE – 100 databases.
Activate the NE – 100 Interface Menu Commands

This procedure shows you how to activate the NE – 100 menu commands.
For more information, see Activate the NE – 100 Interface Menu Commands, page
1603.
Map NE – 100 Attributes to SmartPlant Instrumentation Specs Form

This procedure explains how to map EN – 100 attributes to SmartPlant
Instrumentation Specs attributes.
For more information, see Map NE – 100 Attributes to SmartPlant Instrumentation

Specs Form, page 1603.
Publish SmartPlant Instrumentation Spec Data to NE – 100

This procedure shows you how to publish SmartPlant Instrumentation Spec Data to
an .xml file that can be used with NE – 100 databases.
For more information, see Publish SmartPlant Instrumentation Spec Data to NE –

100, page 1604.
Retrieve NE – 100 Data to SmartPlant Instrumentation Specs

This procedure explains how to retrieve data from an .xml file with EN – 100 data to
For more information, see Retrieve NE – 100 Data to SmartPlant Instrumentation

Specs, page 1605.
Related Topics
• NE-100 Interface: An Overview, page 1602

Activate the NE-100 Interface Menu Commands

1. Locate the intools.ini file in the SmartPlant > Instrumentation folder.
2. Open the intools.ini file in a text editor, such as Notepad or WordPad.
3. Under the General section create the property NE100=Y.
4. Save and close the text editor.
5. Start the SmartPlant Administration module, and log on as System Administrator.
6. Open the Domain Definitions window, and set the required path for XML files in
the Path for SmartPlant XML Files text box. For more details, see Make
Domain Definitions in the Administration User's Guide, under System
Administration > Domain Management.
7. Close the Domain Definitions window, and log off as System Administrator.
8. Log on as Domain Administrator.
9. Run Register Items. For more details, see Register Items in the Administration
User's Guide, under Using SmartPlant Instrumentation in an Integrated
Environment.
10. Close the Administration module.
Related Topics
• NE-100 Interface Common Tasks, page 1602

Map NE-100 Attributes to SmartPlant Instrumentation Specs

Form
Important
To view the NE – 100 interface options, in the intools.ini file, you must add the
setting NE100=Y. For more details, see Activate the NE – 100 Interface Menu
Commands., page 1603.
NE – 100 > Mapping.
2. From the Language select list, select the language you want the NE – 100
attributes to be displayed in.
3. From the Specification form list, select the specs form whose attributes you want
the NE – 100 attributes mapped to.
4. To map an NE – 100 attribute to a specs form attribute, do one of the following;
• Drag the NE – 100 attribute to the Map cell opposite the Specification
attribute cell you want mapped.
• Press, and while holding, the Ctrl key, select an NE – 100 attribute
and its specs form attribute equivalent, and then click Map.
5. After mapping the required attributes, do one of the following;
• Click Save, to save the mapping to the selected specs form.
• Click Save for all, to save the mapped attributes to all the spec forms
that have the same attributes, such as Manufacture or Color.
6. Click Close.
Related Topics

Publish SmartPlant Instrumentation Spec Data to NE-100

Important
Commands, page 1603.
1. Map the NE – 100 attributes to the required spec form. For more information, see
Map NE – 100 Attributes to SmartPlant Instrumentation Specs Form, page 1603.
2. In any SmartPlant Instrumentation module, click Tools > Interfaces > NE – 100
> Publish.
3. On the Publish to NE – 100 dialog box, click on the Browse button to select the
target folder for the published NE – 100 .xml file.
4. Click Find.
5. In the Find Items dialog box, select the tag numbers of the items whose data you
want to publish.
6. Click OK, the software starts to publish the SmartPlant data to the NE – 100
format.
Tip
• The publishing progress is displayed on the Progress bar and on the
Activity status bar.
Related Topics
Retrieve NE-100 Data to SmartPlant Instrumentation Specs

Important
Commands, page 1603.
NE – 100 > Retrieve.
2. On the Select XML File dialog box, click the Browse button to locate the .xml
file containing the NE – 100 data you want to retrieve to SmartPlant
Instrumentation.
3. Click OK.
4. From the To Do List, run Update Task. For more details, see Run a Task from
the To Do List, page 1676

Working with SmartPlant Integration

Overview
SmartPlant integration standardizes and improves the communication among the
various authoring tools you use in the course of designing, constructing, and
operating a plant. SmartPlant integration manages data exchange among these
authoring tools, which enables sharing and re-use of plant information throughout the
plant lifecycle. SmartPlant Foundation acts as a repository for data and a medium
through which information is shared among other tools, such as SmartPlant Electrical,
SmartPlant P&ID, and Zyqad.
Most of the commands that provide access to SmartPlant integration functionality

exist in the common user interface available on the SmartPlant menu in SmartPlant
Instrumentation.
The following graphic displays what SmartPlant Instrumentation publishes and

retrieves and shows the flow of data and the different types of data.

SmartPlant Instrumentation interacts with SmartPlant Foundation by correlating items

between the plant database and the SmartPlant Foundation database, retrieving such
documents as Cabinets, Electrical Signals, P&IDs, and the like from SmartPlant.
Also, SmartPlant Instrumentation creates a set of tasks in the To Do List that you can
run to update the plant database. In SmartPlant Instrumentation, you can also use the
SmartPlant menu to publish documents and retrieve data, access the SmartPlant
Foundation Web Client in order to browse data, and subscribe to change notifications
and compare documents.
Note
• You can only use the SmartPlant menu commands after your plant is
registered.
Registering Tools
Before you can publish and retrieve information from any of the authoring tools, you
must register each plant in SmartPlant Instrumentation with a SmartPlant Foundation
database. The connection allows SmartPlant Instrumentation to use the SmartPlant
integration commands. A SmartPlant Instrumentation Domain Administrator
typically performs the registration.
The software maps a plant and all its projects to a single SmartPlant Foundation URL,
which points to one, and only one, SmartPlant Foundation plant database and its
projects. When you use the Register command in any of the authoring tools, you are
registering an authoring tool plant with a SmartPlant Foundation URL and plant that
you specify.
The Domain Administrator must register each plant in the authoring tool once; this
action takes place in the Administration module. After the plant is registered, you can
publish and retrieve documents.
Note
• When working with SmartPlant integration, there are certain requirements
relating to As-Built and projects.
Related Topics
• Access the SmartPlant Foundation Web Client, page 1608
• Publishing in an Integrated Environment: An Overview, page 1654
• Retrieving in an Integrated Environment: An Overview, page 1668

Access the SmartPlant Foundation Web Client

Click SmartPlant > Browser.
Tip
• This command is available only if the active plant has been registered.
For more information, see Configuring SmartPlant Instrumentation for an
Integrated Environment: An Overview in the Administration User's Guide,
under SmartPlant Integration and Item Registry and Related Topics.
Note
• From the SmartPlant Foundation Web Client, you can perform a number
of tasks, such as publishing or retrieving documents, comparing
documents, subscribing to document changes, and so forth. Many of these
tasks can be performed from the authoring tools, such as SmartPlant P&ID
or SmartPlant Electrical, but the Web Client provides unique access to
other features such as the Web Client To Do List and search capabilities.
Related Topics
• Working with SmartPlant Integration, page 1606

Updating SmartPlant Information in Title Blocks

Update Title Block is a SmartPlant Foundation add-in that allows you to update
published SmartPlant Instrumentation reports to the latest revisions and include issue
data in the custom title blocks. Also, the add-in converts the published reports with
their title blocks from SmartPlant Instrumentation native format (.brw , .ssf, and .spd
files) to .pdf files.
Notes
• For the .brw , .ssf, and .spd file types, SmartPlant Foundation uses the
following component address (ProgID):
SPITitleBlock.TitleBlockInfo
• These file types are already configured in the delivered database dump
files.
For a detailed flow of activities, see Updating SmartPlant Information in Title
Blocks: Flow of Activities, page 1610.

Updating SmartPlant Information in Title Blocks:

Flow of Activities
The following is the required flow of activities for the Update Title Block add-in.
1. Configure the Custom Title Blocks for Integration Reports

Prior to running the Update Title Block add-in, you need to configure your custom
title blocks so that they meet integration requirements. For more information, see
Title Block Requirements for Integration Reports, page 1611.
2. Install the Update Title Block Component

After you have configured your custom title blocks, you need to install the Update
Title Block Component. This component contains the DLL file that enables the
inclusion of issue data in your custom title blocks in native SmartPlant
Instrumentation format and the conversion the reports to PDF. For more information,
see Install the Update Title Block Component for SmartPlant Instrumentation, page
1626.
3. Install and Configure Software for Generating PDF Files

You must install the appropriate software for generating PDF files. For more
information, see Installing and Configuring Software for Generating PDF Files, page
1615.
Related Topics
• Updating SmartPlant Information in Title Blocks, page 1609

Title Block Requirements for Integration Reports

The title blocks in the reports used for integration contain macros that specify issue
data. You can generate these reports either in SmartPlant Instrumentation native
format (.brw, .ssf. or spd) or enhanced report (.sma) format. For both of these
formats, there are shipped files that you can use that include the correct formatting
and data for the reports. There are also certain requirements that you need to follow
if you intend to customize your own reports.
PowerSoft Reports
The title block files for the reports in .psr format are in the location <SmartPlant
Instrumentation installation folder>\PSR\ and the available files are as follows:
• A3tall_inchunit.psr
• A3tall_pbunit.psr
• A3wideborder_inchunit.psr
• A3wideborder_pbunit.psr
• A4tall_inch.psr
• A4tall_pbunit.psr
• A4tall_pbunit_general.psr
• A4widerborder_inchunit.psr
• A4widerborder_pbunit.psr

If you are creating your own custom reports in .psr format in which you want to
include issue data, you must create a custom title block and add macros as shown in
the following table.
Section Heading Macro Name

ISSUE issueno_x
REV issuedrevision_x
MATERIAL OR JOB SPEC materialorjobspec_x
BID (DATE ISSUED FOR) bid_x
FAB (DATE ISSUED FOR) fabrication_x
CONST (DATE ISSUED FOR) construction_x
REF (DATE ISSUED FOR) reference_x
SITE sitename
SITE LOCATION sitelocation
DIVISION divisionname
DIVISION LOCATION divisionlocation
For the macro names, 'x' represents an integer used to specify the sequence, for
example, issueno_1, issueno_2, and so forth.
Enhanced Reports
The title blocks that use the .sma format are designed to be used by all the tools that
communicate in an integrated environment; however, if you use them in SmartPlant
Instrumentation as delivered, parts of the drawing may overlap the margins of the
drawing area. For this reason, you need to set values of the working area margins for
any templates that you intend to use for generating reports in an integrated
environment. To prepare the templates, you define the settings under Preferences >
Enhanced Reports (for all layouts of a particular report type) or for a specific layout
as desired.
The template files are installed on the SmartPlant Instrumentation machine. The
default location for enhanced report templates for the reports used in an integrated
environment is:
<SmartPlant Instrumentation installation folder>\RAD\Template\Generic\*.sma
The title block files are installed on the SmartPlant Instrumentation machine. The
default location for enhanced report title blocks for the reports used in an integrated
environment is:
<SmartPlant Instrumentation installation
folder>\RAD\Template\Generic\TitleBlocks\*.sym

The following settings represent the minimum values required for the working area
margins:
Title Block Left Right Top Bottom

D Wide 0.44 0.3 0.3 0
C Wide 0.7 0.3 0.3 0
B Wide 0.3 0.3 0.3 0
A1 Wide 0.7 0.3 0.5 0
B Tall 0 0 0.3 0
A3 Tall 0 0 0.3 0
A Wide 0 0 0.3 0
A2 Wide 0.7 0.2 0.5 0
A3 Wide 0 0 0.3 0
A4 Wide 0 0 0.4 0
Note
• To place issue data on other title blocks for enhanced reports, use the
SmartPlant Instrumentation Place Drawing Property Label command in
the Enhanced Report Utility. For more information, see Place Property
Labels on a Drawing Sheet in the Enhanced Report Utility User's Guide,
under Working with Templates and Title Blocks.
Related Topics
• Updating SmartPlant Information in Title Blocks: Flow of Activities, page
1610
Associating a Custom Title Block with SmartPlant

Instrumentation
After you have finished creating a report title block and customized it in InfoMaker to
fit your needs, you need to associate it with SmartPlant Instrumentation so that the
Domain Administrator can assign it to the appropriate reports. If needed, you can edit
the associated title block properties by defining the headers for revision custom fields
and defining the headers for the drawing records.
Note
• There are title blocks that come shipped with SmartPlant Instrumentation.
For the list of available title blocks and their descriptions, see Title Block
Descriptions in the Administration User's Guide, under Domain and
Project Administration, Report Management

Open a Custom Title Block

1. In the main SmartPlant Instrumentation window, on the Tools menu, click Title
Blocks.
2. In the Title Blocks dialog box, click New to open the Title Block Properties
dialog box.
• Navigate to the .psr file that you have created containing the new
custom title block, and select this file.
• Navigate to the default tb with in units.psr file, or the default tb with
pb units.psr file.
4. Click Open.
5. In the Title Block Properties dialog box, do the following if required:
a. Under Revision custom field headers, in the Header column, type the name
for each custom field.
b. In the Title block name field, type the name that you have selected for the
title block.
c. Under Document custom field headers, in the Header column, type the
name for each custom field.
Tip
• If you want to modify the number of revisions of custom title blocks,
you need to add more revision rows and create appropriate macros in
InfoMaker. The Revision rows box displays the number of revision
rows that you have customized for your title block.
6. Click OK to save the edited title block and add it to the inventory of title blocks
in SmartPlant Instrumentation.
7. In the Title Blocks dialog box, click Close to return to the main window.

Installing and Configuring Software for Generating

PDF Files
You can use Adobe Acrobat Distiller or GPL Ghostscript to generate PDF files using
SmartPlant Instrumentation Server. This section provides information on installing
and configuring these tools for use with SmartPlant Instrumentation Server.
Important
• Adobe Acrobat Distiller and GPL Ghostscript are not Intergraph
Corporation software and are owned by third parties. The customer is
responsible for selecting in its sole discretion the applicable third party
software to use. Intergraph makes no recommendation as to the choice of
said third party software. Customer is responsible for obtaining a valid
license to use said third party software from owner of said third party
software and to pay any license fees to the owner of said third party
software for the use of said third party software. INTERGRAPH
DISCLAIMS AND MAKES NO WARRANTY EITHER EXPRESS OR
IMPLIED, INCLUDING THE WARRANTIES OF
MERCHANTABILITY OR THE WARRANTIES OF FITNESS FOR A
PARTICULAR PURPOSE IN REGARDS TO SAID THIRD PARTY
SOFTWARE.
• The third party PDF generation software must be installed on the same
host as the SmartPlant Instrumentation Server.
Install and Configure Adobe Acrobat
• Refer to the Adobe Acrobat documentation for details on installing the
software. For details of how to configure Adobe Acrobat, see Configure
Adobe Acrobat Distiller 7, page 1620.
Install and Configure GPL Ghostscript
• GPL Ghostscript is a software package that translates various file types
into PostScript and PDF files. You can find information about GPL
Ghostscript, including download locations and installation instructions, at
the following Web site: http://www.ghostscript.com/. The license for the
GPL version of Ghostscript is less restrictive than the AFPL version. The
filename for the GPL version is gsnnnw32-gpl.exe, where nnn is the
Ghostscript version number.
Important
• When using Ghostscript to generate PDF files for SmartPlant
Instrumentation file types, you also need to install RedMon, a utility
that redirects standard printer port output to Ghostscript.

Configure the Generic PostScript Printer

1. Click Start > Settings > Printers and Faxes > Generic PostScript Printer.
2. Click Printer > Properties.
3. On the Ports tab, select the new redirected port you created when creating your
generic postscript printer, and then click Configure Port.

4. On the <Port> Properties dialog box, enter the path to the GPL Ghostscript
software executable file in the Redirect this port to the program box. For
example, type:
c:\gs\gs8.54\bin\gswin32c.exe
Tip
• If the program is installed in a location other than C:\gs\, after
installing SmartPlant Instrumentation, open the Intools.ini file, and
under the [PRINTER] section, add the line PDFDIR=<folder path>,
for example, type:
PDFDIR=d:\gs\gs8.54\bin\

5. In the box Arguments for this program are, type:

@c:\gs\pdfwrite.rsp -c .setpdfwrite -f -
dCompatibilityLevel#1.5 -
Caution
• You must have a space between #1.5 and -.
Tips
• If the GPL Ghostscript software is installed in a location other than the
default c:\gs\ folder, create the folder c:\gs\ and give the
SmartPlant Instrumentation Server user read/write access to this
folder. This folder will be used to store the pdfswrite.rsp file.
• If you do not want to use the c:\gs\ folder, you can use any other folder
according to the following criteria:
• The SmartPlant Instrumentation Server user has read\write access
to this folder.
• Replace the @c:\gs\ at the beginning of the argument with @<your
folder path>.
6. In the Output list, select Program handles output, and in the Run list, select
Normal.
Tip
• If you are installing the printer driver on the SmartPlant server for
integration or if you are using Ghostscript from Citrix or a remote
desktop, make sure that the Run as User check box is selected to
avoid errors when generating PDF files.
• If you are installing the printer driver on the SmartPlant
Instrumentation Client or Server, make sure that the Run as User
check box is cleared to avoid errors when generating PDF files.
7. Click OK on the <Port> Properties dialog box.

8. On the Advanced tab of the Generic PostScript Printer Properties dialog box,
verify the following:
• The Always Available option is selected.
• The Print directly to the printer option is enabled.
9. Click OK to close the Generic PostScript Printer Properties dialog box.
Related Topics
1610

Configure Adobe Acrobat Distiller 7

1. Log on to the Windows account where you have administrator privileges.
2. In the SmartPlant Instrumentation home folder, create a new folder PDF Output
for the output .pdf files.
3. Click Start > Settings > Printers and Faxes > Adobe PDF.
5. Click the Ports tab, and then click Add Port.
6. On the Printer Ports dialog box, select Adobe PDF Port.
7. Click New Port and navigate to the SmartPlant\Instrumentation\PDF Output
folder path.
8. Create a new port pointing to the PDF Output folder.
9. Close the Printer Ports dialog box.
10. Click the Advanced tab and ensure that the Print directly to the printer option
is selected.

11. Go to the General tab and click Printing Preferences.

12. On the Adobe PDF Printing Preferences dialog box, click the Adobe PDF
Settings tab.
13. Beside Adobe PDF Output Folder, select the path to the PDF output folder that
you defined.
14. Clear the View Adobe PDF results check box.
Related Topics
1610

Test the PostScript Printer Configuration

1. Open Notepad and create a text file named PDFWrite.rsp in the folder specified
for PDF generator path. This file creates a Ghostscript device named PDFWrite
and sets some parameters for the device.
2. Type the following lines in the PDFWrite.rsp file:
-Ic:\gs\gs8.54\lib;c:\gs\fonts
-sDEVICE=pdfwrite
-r300
-dNOPAUSE
-dSAFER
-sPAPERSIZE=A4
-sOUTPUTFILE=c:\gs\test\gs_test_output.pdf
Tips
• If the library and font files are installed in locations other than the
default, or if your GPL Ghostscript version is other than 8.54, type
appropriate parameters in the first line, for example:
-Id:\gs\gs8.15\lib;d:\Program Files\gs\fonts
• You can change -r300 to -r600 to use a higher resolution (600dpi).

• You can change -sPAPERSIZE=A4 to -sPAPERSIZE=Letter to use
letter paper size.
• If you want the output file to be generated in a location other than the
path shown, type an appropriate path for the -sOUTPUTFILE
parameter. If you are using Ghostscript from Citrix or a remote
desktop, the output path must be on the same machine as the
Ghostscript installation. The software updates the -sOUTPUTFILE
parameter automatically when Ghostscript generates a PDF file.

3. Test the generation of .pdf files by opening the Generic PostScript Printer
Properties dialog box and clicking Print Test Page.
Tips
• The .pdf file should appear in the output folder that you specified. If a
Save As dialog box opens, or the .pdf file opens automatically, it is
recommended that you check the printer settings and ensure that all the
file paths are specified correctly, and then perform this procedure
again.
• If you obtain a .pdf file of the printer test page in the location specified
by the pdfwrite.rsp file, this indicates that the PostScript printer driver,
port redirection and Ghostscript are configured correctly.
• If the software is unable to print the test page but the print job still
appears in the queue, cancel the printing by selecting Administrative
Tools > Services from the Windows Control Panel. Next, select the
Print Spooler service and click Actions > Restart.
4. Verify that this file is readable by opening it with Adobe Reader.
Important
• After testing your PostScript printer configuration, you must delete the
PDFWrite.rsp file, to avoid problems later on when publishing DDP
data.
Related Topics
• Configure the Generic PostScript Printer, page 1616

Test the Acrobat Distiller Driver Configuration

Important
• When performing the printing test, make sure that no Acrobat Distiller
dialog boxes are open.
1. Click Start > Settings > Printers and Faxes > Adobe PDF.
3. Click the Ports tab and select the PDF port that you defined:

4. Click the General tab and click Print Test Page.
Tips
• The .pdf file should appear in the output folder that you specified. If a
Save As dialog box opens, or the .pdf file opens automatically, it is
recommended that you check the printer settings and ensure that all the
file paths are specified correctly, and then perform this procedure
again.
• If you obtain a .pdf file of the printer test page in the location specified
for the port, this indicates that the Acrobat Distiller printer driver is
configured correctly.
• If the software is unable to print the test page but the print job still
appears in the queue, cancel the printing by selecting Administrative
Tools > Services from the Windows Control Panel. Next, select the
Print Spooler service and click Actions > Restart.
5. Verify that this file is readable by opening it with Adobe Reader.
Related Topics
• Configure Adobe Acrobat Distiller 7, page 1620

Install the Update Title Block Component for SmartPlant

Instrumentation
The SmartPlant Instrumentation title block component is only required if you are
using SmartPlant Instrumentation in an integrated environment. The SmartPlant
Instrumentation title block component software must be installed on the same
computer as the SmartPlant Foundation Title Block component and PDF Generator
software. These components are usually installed on the SmartPlant Foundation
server, but may be installed on another server.
1. Insert the SmartPlant Foundation CD into the CD-ROM drive. If the installation
does not start automatically, double-click setup.exe on the CD.
2. Click SmartPlant Software in the SmartPlant Foundation Installation
window.
3. Click SmartPlant Instrumentation Title Block Installation.
Tip
• If you have installed the SmartPlant Instrumentation Title Block
component previously, the software prompts you to modify, repair, or
remove the older version of the component. After you uninstall the
older version, click SmartPlant Instrumentation Title Block
Installation again in the SmartPlant Foundation Installation
window.
4. Click Next.
5. To accept the default installation location for the SmartPlant Instrumentation Title
Block component, click Next.
Tip
• If you want to change the installation location, click Browse and
navigate to the new folder. Then, click Next.
6. Click Finish.
Related Topics
1610

Schema Mapping: An Overview

This section describes the assumptions, rules, and limitations imposed by the
SmartPlant Instrumentation adapter on schema mapping.
This section describes the structure of the tool schema and how it is used by the
authoring tool SmartPlant integration adapter in support of the publish and retrieve
operations. This topic does not provide a list of the classes, properties, or enumerated
lists (select lists) that are mapped by the delivered SmartPlant Instrumentation tool
schema. You can obtain this information by viewing the tool schema directly. This
set of topics does not describe the user interface of the Schema Editor.
Before modifying the mapping for SmartPlant Instrumentation, you must understand:
• The SmartPlant Instrumentation software

• The SmartPlant Instrumentation data model
• The delivered mapping for SmartPlant Instrumentation
• How the delivered mapping for SmartPlant Instrumentation works
• SmartPlant schema modeling
• The Schema Editor
• The To Do List feature of SmartPlant Instrumentation
In the topics that describe schema mapping, the following terms are frequently
referenced:
• Tool schema — Defines the SmartPlant Instrumentation objects to be

published or retrieved and how they map to objects in the SmartPlant
schema. The tool map schema implements mapping between the objects
in the SmartPlant Instrumentation data model and the objects in the
SmartPlant schema. Users who customize either the SmartPlant
Instrumentation data model or the SmartPlant schema may also need to
customize the mapping contained in the tool schema.
• SmartPlant schema — Defines the SmartPlant integration data model.
• Adapter — The SmartPlant Instrumentation code module that supports the
SmartPlant integration commands.
When you publish SmartPlant Instrumentation data, the SmartPlant integration
adapter extracts data from the SmartPlant Instrumentation database and converts it
into a set of objects and relationships that are compatible with the SmartPlant schema.
These objects and relationships are defined in an .xml file, which is sent to
SmartPlant Foundation for further processing. For SmartPlant Instrumentation, the
name of this file is INtoolsMap.xml, and it must be located in the folder specified in
the Path for SmartPlant XML files box of the Domain Definition window.

General Information About Schema Mapping

This topic provides general information about the mapping in SmartPlant
Instrumentation.
SmartPlant Instrumentation Adapter

Each authoring tool has an adapter that processes information during the publish and
retrieve operations. One of the adapter's functions is to map information between
SmartPlant Integration and the particular authoring tool. The SmartPlant
Instrumentation adapter is a component that belongs to SmartPlant Instrumentation
and requires installation of SmartPlant Instrumentation Version 2007 on one of the
following database platforms:
• Oracle 9.2.0 or 10g

• SQL Server 2000 or 2005
Any communication between SmartPlant Foundation and SmartPlant Instrumentation
is performed via this adapter, which sends information to SmartPlant Integration
through the Common UI where the user is shown the appropriate user interface and
data available.
The adapter does not handle tool schema files directly, but uses them indirectly. The
tool schema files are used to define the retrieve map file, which is then used by the
adapter. Direct use of the schema files would mean that the adapter accessed them
directly to do its work. Both retrieve and publish operations only work through map
files.
Mapping Configuration
The SmartPlant Instrumentation adapter uses the tool schema map file and the
Schema Editor, delivered with the SmartPlant Schema Component, to perform
mapping between the SmartPlant Instrumentation object structure and the structure of
objects in SmartPlant integration. The map file is installed with SmartPlant
Instrumentation Setup. This file includes all objects that are mapped for SmartPlant
integration (not the entire set of objects in SmartPlant Instrumentation, nor all
properties, but only those that are relevant for other applications that use SmartPlant
Integration).

Tool Schema Location

The name of the SmartPlant Instrumentation tool schema files are: INtoolsMap.xml,
ContextMap.xml, and NamingConventionMap.xml. SmartPlant Instrumentation uses
these files for all types of published and retrieved documents. They are installed by
default in the path <SmartPlant Instrumentation home folder>\XML\ and should be
treated as installation files. If you move or copy these .xml files to a different folder,
the System Administrator can specify the location in the Administration module,
Domain Definition window, by typing it in the Path for SmartPlant XML files
box. This allows you to specify a different tool schema for each domain.
Related Topics
• Schema Mapping: An Overview, page 1627

Upgrading the SmartPlant Instrumentation Tool

Schema for a New Software Version
If you have previously customized the SmartPlant Instrumentation tool schema for a
previous version, you will need to upgrade the latest INtoolsMap.xml file in order to
preserve your custom changes.
Caution
• Before removing the previous version of SmartPlant Instrumentation, be
sure to back up your existing INtoolsMap.xml file so that you do not lose
your custom changes. The INtoolsMap.xml file is located in the path
<SmartPlant Instrumentation home folder>\XML\.
Related Topics
• Define a Schema for SmartPlant Instrumentation, page 1646
• Export a New Schema Configuration, page 1648
• Workflow for Extending the Schema, page 1631
Upgrade the SmartPlant Instrumentation Tool Schema

With this procedure, the software upgrades the IntoolsMap.xml file, including user
customizations, with the latest version data from the files in the '<SmartPlant
Instrumentation home folder>\XML\Backup' folder path and registers the schema
version at the beginning of the IntoolsMap.xml file.
1. In the SmartPlant Instrumentation Administration module, log on as Domain
Administrator in the domain where you are going to work in an integrated
environment.
2. Click File > Domain Definition.
3. On the Domain Definition window, select the desired domain.
4. On the Module Toolbar, click Edit .
5. Beside Path for SmartPlant XML files, click Browse to navigate to the location
of the IntoolsMap.xml file containing your custom definitions.
6. Click SmartPlant > Upgrade Schema.
Related Topics

Workflow for Extending the Schema

When you need to extend the SmartPlant schema, such as when new properties or
select list entries are added, you or an administrator must take steps to update the data
in SmartPlant Instrumentation. The overall steps include:
1. Generate component schemas using the Schema Editor.
2. Run the SmartPlant Instrumentation Schema Configuration Wizard to extend the
configuration of the SmartPlant Instrumentation data model, which provides a
view of your data.
The wizard output is a schema hierarchy with the following structure:
Schema name
Document type
Object type (class)
Interface
Properties
The following example illustrates how the hierarchy is organized for two
object types, 'Loop' and 'Instrument', both belonging to the document type
'InstrumentIndex':
TEFPublish(publish)
InstrumentIndex
Loop
ILoop
LOOP_NAME
LOOP_SERV
Instrument
IInstrument
CMPNT_NAME
CMPNT_SERV
For details of the procedure, see Define a Schema for SmartPlant

Instrumentation, page 1646.
3. Run the Export Schema Configuration Utility to create a new tool schema map
file using the classes that you selected with the SmartPlant Instrumentation
Schema Configuration Wizard. For details of the procedure, see Export a New
Schema Configuration, page 1648.
Tips
• The tool schema class is identified by a unique name consisting of
<schema name>_<document name>_<class>.
• For SmartPlant Instrumentation, the source file is INtoolsMap.xml.

4. Using the Schema Editor, open the newly-created tool map class and synchronize
it with the SmartPlant Instrumentation tool schema. For more information, see
Synchronizing Schemas, page 1640.
Important
• To be able to publish data that includes the new classes, you need to
rename the target .xml file to 'INtoolsMap.xml'.
Related Topics
Modify the Tool Schema for a Custom Plant Hierarchy

1. Create a hierarchy in SmartPlant Instrumentation that contains the same number
of levels as the one defined in the SmartPlant Foundation custom hierarchy. For
details, see Create a Plant Hierarchy in the Administration User's Guide, under
Domain Administration, Plant Design and Structure.
2. Modify the following information in the delivered INtoolsMap.xml file to map it
to the levels in the example custom hierarchy.
Tips
• The INtoolsMap.xml file is installed by default in the path
<SmartPlant Instrumentation home folder>\XML\.
INtoolsMap.xml File Level Mapped To Custom Hierarchy Level
TEFRetrieve_PBSDocument_Plant County Top level
TEFRetrieve_PBSDocument_Area City & District Intermediate levels
TEFRetrieve_PBSDocument_Unit Precinct Lowest level
• The values in the Mapped To column are for this example only. You
should substitute the appropriate values for your hierarchy.
• You will need to create new map classes ICity, IDistrict, and IPrecinct.
For details of the procedure, see Creating New Objects and
Relationships in the Schema: An Overview in the Schema Editor
User's Guide.
3. Launch Schema Editor.
4. On the Workflows dialog box, click the Tool Schema tab.

5. Click Open.
6. Navigate to the file path: Program Files > Common Files > Intergraph >
EFSchema > EFSchema.xml.
Tip
• The file may take some time to open.

7. Click Open to select the tool schema file.
8. Navigate to the INtoolsMap.xml file.

9. Click View.
10. On the View Tool Schema dialog box, from the Form list, select Tree/Table
Horizontal, and then click OK.
11. In the tree view, expand the SPMapClassDef node.

12. Scroll down to the TEFRetrieve_PBSDocument_Plant node.
13. Right-click this SPMapClass and on the shortcut menu, click Edit
INTL_TEFRetrieve_PBSDocument_Plant.

14. On the Edit Map Class Definition dialog box, under the Retrieve map section,
clear the value IPlant and click the ellipsis button as shown:
15. On the dialog box Possible ClassToMapClass\Classes for TEF

Retrieve_PBSDocument_Plant, in the Search box, type iplant.

16. Select IPlant as shown and click OK.
Tip
• The top level interface (IPlant in this example) cannot be renamed.
Therefore in the custom hierarchy, the top level will always be mapped
to IPlant. Consequently, the IPlant interface remains mapped to the
IPlant interface (as shown in the graphic) and no mapping changes are
required.
17. Click OK to close the Edit Map Class Definition dialog box.
18. Right-click the TEFRetrieve_PBSDocument_Area node, and on the shortcut
menu, click the Edit option.
clear the value IFunctionalArea and click the ellipsis button.
Retrieve_PBSDocument_Area, map the intermediate level interface to ICity and
IDistrict.
22. Right-click the TEFRetrieve_PBSDocument_Unit node, and on the shortcut
menu, click the Edit option.
clear the value IFunctionalUnit and click the ellipsis button.
Retrieve_PBSDocument_Unit, map the lowest level interface to IPrecinct.

26. Click File > Save.
27. Close the Schema Editor, and at the prompts to save the data and to load the
changes to the SmartPlant Foundation Server, click Yes.
Related Topics

Synchronizing Schemas
This section describes how to use the Schema Editor to synchronize the tool metadata
(stored in the tool's database) and the map schema file (INtoolsMap.xml) when you
define new properties for publishing or retrieving.
You can begin the update by first adding a new property to the tool metadata and then
synchronizing the map schema file to it, or you can first modify the map schema file
and then synchronize the metadata with it.
Note
• For SmartPlant Instrumentation, new properties are created using custom
fields.
Important
• You are not allowed to delete a property that you have already
synchronized between the tool metadata and the map schema file because
the software cannot determine whether data values exist for that property.
Related Topics

Synchronize the Map Schema File with the Tool Schema

1. In the SmartPlant Instrumentation Administration module, log on as Domain
Administrator in the domain defined for an integrated environment.
2. Click Activities > Custom Fields.
3. Select the plant that you have registered for integration.
4. Select the item type appropriate for the property you want to add.
5. Add the desired property name in the Definition column of a vacant custom field
(with field type Char).
6. Click Apply and then click Close.

7. Click Start > Intergraph SmartPlant Foundation > SmartPlant Schema
Component > SmartPlant Schema Editor.
8. In the Schema Editor Workflows window, click the Application Metadata tab.

9. Connect to the SmartPlant Foundation database as shown.
10. On the SmartPlant Foundation URL page of the SmartPlant Registration

Wizard, type the node name and virtual directory of the SmartPlant Foundation
database where you registered your plant. Use the following format:
http://<SPFServer>/<VirtualDirectory>.
For example:
http://<SPFServer>/SPFASP.
Tips
• Replace <SPFServer> with the name of your SmartPlant Foundation
Web server.
• Replace <VirtualDirectory> with the name of the virtual directory for
the SmartPlant Foundation Web Client. By default, the virtual
directory for the first instance of the Web Client that you install is
SPFASP. However, if you install multiple instances of the Web Client
to connect to multiple databases, the virtual directory name may be
different.
11. Click Next.
12. On the SmartPlant Foundation Plant page, select from the Plant name list the
SmartPlant Foundation plant in which you want to synchronize your data.

13. Click Next.

14. On the Engineering Application Options page, select from the Engineering
application/map schema list the schema for the tool that you want to
synchronize.
15. Under Startup options, select the Load map schema check box.
Tip
• For SmartPlant Instrumentation, the software automatically selects the
Connect to application schema check box.
16. If desired, select the Automatically synchronize schemas check box.
Tip
• You can select more than one schema from the Engineering
application/map schema list (if available) and specify the startup
options. In this case, the software will load the map schema for each
application and perform connection and synchronization as specified.
17. Click Finish to complete the connection.
The Synchronize window opens with all the properties selected by default for
synchronizing in the map schema file (located in this example in the path
C:\Program Files\SmartPlant\Instrumentation\XML\INtoolsMap.xml).


• Leave the properties selected where you want the software to
synchronize the map schema file by updating it with the value in the
database.
• Select the properties in the SPI Database column where you want the
software to update the database with the current value from the map
schema file.
19. Click OK to synchronize the data and open the Map Environment window.

20. Expand the SmartPlant Instrumentation node by clicking the icons.
21. Under the Map Classes node, scroll down to the IInstrumentUDF map class (the
instrument custom field where you created the new properties in SmartPlant
Instrumentation) and expand the node to display these properties.
Related Topics

Define a Schema for SmartPlant Instrumentation

1. In the Intools.ini file, add a new section, [FRAMEWORK], and type the
following parameter:
EnableTEFWizard=1
2. In the SmartPlant Instrumentation home folder, double-click the file spiscw.exe.
3. On the Logon Information dialog box, type your user name and password.
4. In the SmartPlant Instrumentation Schema Configuration Wizard, on the
Welcome page, click Next.
5. Select a SmartPlant Instrumentation domain and click Next.
6. On the Schema Options page, select whether to create an entirely new schema
definition or to modify an existing schema definition.
• For a new schema, on the Define New Schema Configuration page,
type a schema name and select the appropriate option according to
whether the purpose of the schema is to publish or retrieve
information. If you select to use the schema for publishing, type the
name of the target application.
• For an existing schema, on the Select Schema page, select the desired
schema and click Next.
Tip
• When selecting an existing schema, the word 'publish' or 'retrieve' in
parentheses indicates the purpose of the schema.
8. On the Select Document Type page, select from the list the document type that
you want to add to the schema and click Next.
Tips
• You can select only one document type at a time to add to the schema.
• Document types that have already been added to the schema are
indicated with an asterisk.
9. On the Select Object Types page, select the objects, representing a class of items
that you want to represent in the schema and click Next.
Tip
• All object types are available for any document type that you have
selected, although it is recommended that you select related object
types for a particular document type, for example, Cable, CableSet,
Wire.

10. On the Define Object Levels and Restrictions page, select the level at which to
set each object for determining parent-child relationships.
Tips
• The highest level must always be 0.
• The software publishes or retrieves data for object types at each
successive level associated with the object type at the next highest
level. For example:
Line (level 0)
Instrument (level 1)
Piping port (level 2)
Loop (level 2)
11. Select the check boxes as desired beside each object type to specify restrictions
according to the requirements of the target application.
12. When done, click Next.
13. For a publish schema, if desired, on the Define Filter Condition page, specify a
filter condition for each level 0 object type by selecting the object type and typing
an appropriate SQL command.
14. When done, click Next.
15. On the Select Object Interfaces page, select for each object type the desired
interfaces and click Next.
Tip
• Double-click an interface to view its properties.
16. On the Completing the Schema Configuration Wizard page, select the desired
options and click Finish.
Tip
• To prepare for the next stage of the mapping, select the Export to tool
schema check box.
Related Topics

Export a New Schema Configuration

1. In the SmartPlant Instrumentation home folder, double-click the file
UpdateToolSchema.exe.
2. On the Logon Information dialog box, type your user name and password.
3. In the Export Schema Configuration Utility, beside the Source tool schema field,
click the ellipsis button and navigate to the INtoolsMap.xml file.
4. Beside the Target tool schema field, click the ellipsis button and specify the
name of the .xml file that you want to use as the target.
Important
• After testing the updated schema to ensure that it works correctly, you
must rename the target file to 'INtoolsMap.xml' to enable the software
to publish the data successfully.
5. Click Connect to SmartPlant Instrumentation Domain.
6. On the Logon dialog box that opens, select the desired domain.
7. From the Object schema list, select the object schema that you want to export.
8. To export the object schema to the target tool schema, click Export.
Related Topics

Define and Map DDP Data

The following procedure is used when you want to publish instruments that have
dimensional data but where those instruments are not included in the schema. In an
integrated environment, the software supports publishing of dimensional data sheets
for certain dimensional groups only. For the full list of supported dimensional
groups, see List of Publishable Dimensional Groups.
1. The SmartPlant 3D user must define a symbol in the catalog for each instrument
that is going to be published from SmartPlant Instrumentation.
2. The SmartPlant 3D user must inform the SmartPlant Instrumentation user which
DDP attributes for the instrument need to be published.
3. Add the appropriate DDP attributes to the SmartPlant schema using the Schema
Editor.
4. The SmartPlant 3D user must map the DDP attributes to the SmartPlant schema.
5. Define the appropriate DDP attributes for the instrument in SmartPlant
Instrumentation.
6. Define the mapping between SmartPlant Instrumentation and the SmartPlant
schema.
Related Topics

Welcome to the SmartPlant Instrumentation Schema

Configuration Wizard
The Schema Configuration Wizard enables you to define, modify, or delete schemas
that you use to define the data set for publishing or retrieving. A schema definition
consists of the schema name and the target application. You can specify one or more
document types for each schema, and in the target application, you retrieve or publish
data for individual documents based on a single document type. After you generate a
schema, you need to map it to the .xml file used for publishing or retrieving your
data.
Select Domain
Select the SmartPlant Instrumentation domain for which you want to define a new
schema for publishing or retrieving data, modify an existing schema, or delete an
existing schema.
Schema Options
Select the desired schema option.
Define New Schema Configuration

Ensure that the schema name that you enter is unique for the domain. If the schema is
intended for publishing data, you must type a target application name that matches the
name of a supported application in an integrated environment.
Select Schema
Select the existing schema that you want to modify or delete. Note that there may be
more than one schema for a particular application and that separate schemas are
defined for publish and retrieve operations.

Select Document Type

Examples of document types are loops, cables, or PBS Documents. The document
type that you select is for recognition by the target application. You may add as
many document types to the schema as desired, however, you can select only one
document type at a time for addition to the schema. To add another document type,
run the wizard again after completing the current definition.
Select Object Types

All object types are available for selection regardless of the document type that you
selected; nevertheless it is recommended that you select object types that are
appropriate for the specified document type.
Define Object Levels and Restrictions

The options on this page apply to schemas used for retrieving data only. For objects
that you want to be at the highest level, you must specify a value of 0 for the level.
The software retrieves or publishes data for objects at lower levels based on the
appropriate object at the next highest level. Select restrictions for the objects
according to the requirements of the target application, for example, you may want to
specify a restriction that does not allow the creation or deletion of instruments.
Specifying a restriction generates a manual task for the restricted activity in the To
Do List after retrieval.
Define Filter Condition

Filter conditions apply to schemas used for retrieving data only. The software retains
the filter definition that you make for each object. Click Validate to verify that the
syntax of the filter condition is correct.
Select Object Interfaces

On this page, after you select an object type, highlight an object interface under
Available interfaces and click Add to select it for the object type. You cannot
perform multi-selection of interfaces, therefore you must repeat this action for each
interface that you want to add. Each interface consists of a group of related
engineering properties – these properties are hard-coded.

Select Interface Properties

On this page, after you select an object type, highlight an object interface under
Available interfaces and click Add to select it for the object type. You cannot
perform multi-selection of interfaces, therefore you must repeat this action for each
interface that you want to add. Each interface consists of a group of related
engineering properties – these properties are hard-coded.
Completing the Schema Configuration Wizard

The following options are available:
• To save the schema definitions to the database, select Save schema

definitions and then click Finish.
• To discard the current definitions and start again, select Restart wizard to
make another modification and then click Finish. If you select this
option with one or both check boxes selected, you can still create an SQL
file or export the definitions to the tool schema.
• To perform the mapping directly, select Export to tool schema.
• To save the definitions in an SQL file that you use to generate the
mapping to the XML component manually, select Create SQL file. The
software saves the SQL file in the SmartPlant Instrumentation home
folder.

Export Schema Configuration Utility

The Export Schema Configuration Utility enables you to copy existing map file data
into a new class definition so that the interfaces belonging to that class are exposed in
the tool schema.
Source tool schema — The name and path of the XML file that you use as the map
source. Click the ellipsis button to navigate to the desired location.
Target tool schema — The name and path of the XML file that you will obtain as
the output. Click the ellipsis button to navigate to the desired location.
Connect to Domain — Opens the Logon dialog box where you select the desired
SmartPlant Instrumentation domain.
Object schema — Select from the list the object schema that you want to export.
Export — Exports the selected object schema to the target tool schema.

Publishing in an Integrated Environment: An

Overview
In an integrated environment, the authoring tools share data and relationships when
you publish documents containing the data and relationships. The publishing process
involves selecting a document to publish, assigning it to a workflow when necessary,
and specifying a version and revision of the document if specified in SmartPlant
Foundation. For most documents, the software also publishes the data that is
associated with the document when you publish.
The authoring tools (SmartPlant P&ID or SmartPlant Instrumentation, for instance)

publish data in .xml format. All leading and trailing spaces are trimmed from all
strings and from all values without units. These spaces will not appear in the
published data file. The software then loads the data from the .xml files to the
SmartPlant Foundation database. After the data is loaded into SmartPlant
Foundation, you can retrieve the data from into other authoring tools.
When you publish documents, the software does the following things:
• Creates a new master document and the first revision in SmartPlant

Foundation the first time that you publish a particular document. From
that point on, the software creates new versions and revisions each time
that you publish the document. The software relates revisions to the
master document. You can publish subsequent revisions into a workflow,
which can be a different workflow from the original publish action.
Changes in the document status of a related revision change the status of
the subsequently published versions and revisions of the document.
• Publishes a visual representation of the document that you can view
without the authoring tool. For many applications, this is an Intergraph
proprietary file, called a RAD file. The viewable file can also be an Excel
workbook or another viewable file type, such as .pdf or .doc. Users can
review and edit the visual representation of the document using
SmartPlant Markup.
• Publishes associated data, depending on workflow approval. If the data is
approved and loaded, it is used for reporting and subsequent retrieval by
downstream applications. The software publishes only meaningful
engineering data. The published data is not enough to recreate the
document in the original authoring tool.
• The software publishes some document types without the associated data,
such as reports from authoring tools (for example, line lists in P&ID).
You can submit documents published without data to workflows just like
documents with data. The document types and data that you can publish
depend on the authoring tool that you use.

For more information about revisions and versions, see the SmartPlant Foundation
Web Client User's Guide.
Reasons to Publish
You can publish documents and associated data for several reasons:
• To exchange and enhance data among tools, to avoid creating data

multiple times in multiple authoring tools
• To report on common data that originates in multiple tools
• To provide enterprise-wide accessibility to published documents
• To manage change, including workflow history and document revision
management
You can also publish documents to share information with users in other tools
without going through a formal workflow. To share data, you can publish a
document to a For sharing workflow that has only a load step so that the data is
loaded into SmartPlant Foundation as soon as you publish the document.
You can also publish a document by not assigning the document to a workflow, but
rather by using the default workflow from SmartPlant Foundation. When you do not
select a workflow for a document during publishing, the SmartPlant Loader loads the
document into SmartPlant Foundation as soon as it reaches the top of the Loader
queue.
Document Types for Publishing

Each authoring tool publishes different documents and data. For details of documents
that each authoring tool can publish and retrieve, see Tool Documents That are
Published and Retrieved.
The published PBS document contains information about the physical plant with a
structure consisting of plants, areas, and units. The default structure is plant/area/unit,
but you can define a custom hierarchy in the Schema Editor. When a PBS document
is published from SmartPlant Foundation, the authoring tools are notified about the
plant, areas, and units that need to be created in each authoring tool.
The project breakdown structure, project definition document, and project list contain
information about projects and their statuses.
The project breakdown structure contains a single project and the hierarchy of
contracts under that project in a plant/project structure. The project definition
document contains information for a single project that needs to be created in the
authoring tool. The project list contains a list of all projects in a plant, and it is used
by those authoring tools that create all projects at one time.

Note
• The plant breakdown structure and project breakdown structure used in the
authoring tools must match the structure in SmartPlant Foundation for
publishing from the authoring tools and object correlation to work
correctly.
Publishing Files without Data
You can also browse to other file types on the file system, such as Microsoft Word or
Excel files, or SmartSketch® files, in order to publish them. These documents are
always published without data. The primary reasons to publish documents without
data are that the SmartPlant Foundation Change Management functionality can
manage document changes and reviews using workflows and that you can view the
documents electronically.
Note
• When you publish data from an authoring tool, you may not be able view
all the properties that you published in the SmartPlant Foundation client.
You can customize view definitions to allow you to see additional
properties. For more information about defining view definitions in the
SmartPlant schema, see Working with View Definitions: An Overview and
Create a View Definition in the Schema Editor User's Guide. For further
assistance with visualizing data in SmartPlant Foundation, contact
Intergraph Support Services.
Related Topics
• Access the SmartPlant Foundation Web Client, page 1608

Publish Documents from SmartPlant Instrumentation

Caution
• When publishing documents, select a unit from a plant hierarchy.
• After you start to publish documents from an Instrument Index Standard
Browser view, you should not change the default view. Changing the view
can result in incorrect revision numbers and inconsistencies between the
graphical and XML output files.
Important
• Before you can publish SmartPlant Instrumentation engineering
documents, you must make a revision for each document you want to
publish. The software finds only those documents for which you have
made revisions. If you have made several revisions for one document, the
software finds a document containing the most recent revision.
• When publishing data from different units, you must specify separate
document numbers and sets of revisions for each unit. To do so, open the
Intools.ini file, and under the [Index] section, type the following line:
DrawingPerLevel=Y
1. Display one of the following:
• The main SmartPlant Instrumentation window with no modules
open.
• The Instrument Index Standard Browser view.
• An open instrument specification.
• An open process data sheet.
• An open dimensional data sheet.
• An open loop drawing sheet.

2. Click SmartPlant > Publish.

Tips
• This command is available only if you have registered the active plant
using the SmartPlant Registration Wizard.
• If you logged onto SmartPlant Instrumentation with a user name that is
not defined in the integrated environment, you are prompted to log on
when you use this command.
• The documents that appear in the Selected documents list on the
Publish dialog box when it first appears are documents that were
selected within SmartPlant Instrumentation before you accessed the
Publish command.
3. Add any additional documents to the Selected documents list by clicking the
Engineering Tool, File System, or Find toolbar buttons and choosing other
documents to publish.
4. In the Document Selection Wizard, on the Select Document Type page, select
the check boxes for the types of documents you want to publish.
5. Click Next.
6. On the Select Unit page, navigate to the lowest level plant hierarchy item, such as
a unit, from which you want to publish documents.
Tips
• Double-click the icons to expand the plant hierarchy.
• The Next command is enabled only after you select a unit.

7. Click Next.
8. Depending on your document type selection, select engineering documents on
each Select page that opens as follows:
• Specify search parameters as necessary, and then click Find.
• In the Search results data window, select the rows for the documents
that you want to publish, and then click Next.
Note
• If you select the Instrument Index check box on the Select
Document Type page, the software automatically finds the instrument
index document that exists in the unit.
9. On the Document Selection Summary page, review your selections, and click
Finish to exit the Document Selection Wizard and return to the Publish dialog
box.
Tip
• To redefine your selections, click Back.
10. On the Publish dialog box, review the documents that you want to publish and
edit information as necessary.
Tips
• When multiple documents are selected, only property values shared by
all the selected documents appear in the table. Changing a value in the
table changes that value for all of the selected documents.
11. Specify a method of publishing in the Operation box:
• Click Publish now to immediately start the publishing process as soon
as you click OK.
• Click Background publish to publish the selected documents
immediately as a separate process, allowing you to perform other tasks
at the same time. When you use this feature, an e-mail message alerts
you when the process is complete.
• Select the Scheduled publish option to indicate that the publish
process should be run in batch mode, if the authoring tool supports
scheduled batch publishing.
12. Click OK to complete the publish operation.
Note
• When the publish is complete, a dialog box appears indicating whether the
publish operation was completed successfully or with errors. If the View
Log button on the dialog box is enabled, you can click it to view messages
concerning the operation. These may be errors, warnings or informational
messages.

Find Documents to Publish from SmartPlant

Instrumentation
1. Click SmartPlant > Find Documents to Publish.
Tips
• This feature is also available by clicking Find on the Publish
dialog box.
• The Find Documents to Publish command determines which
documents need to be published or re-published and displays the
results on the Find Documents to Publish dialog box.

2. From the Select documents to publish list on the Find Documents to Publish
dialog box, check the box beside the documents that you want to publish.
Tip
• You can quickly select the entire list by clicking Select All, or you can
clear the entire list by clicking Clear All.

3. Click OK to accept the selections. The documents you selected to publish now
appear in the Documents to Publish list on the Publish dialog box, and are ready
to be published.
Note
• The lists displayed on the Find Documents to Publish dialog box are
compiled at the time indicated in the Last search performed box. You
can update the lists by clicking Update, but this process can be time-
consuming, depending on whether you are running the applications in
synchronous or asynchronous mode.
Related Topics
• Publish Documents from SmartPlant Instrumentation, page 1657
List of Publishable Dimensional Groups

The SmartPlant Instrumentation dimensional groups in the list are those that also
appear in the SmartPlant schema, in INtoolsMap.xml, and in SmartPlant 3D. Only
dimensional data sheets for instruments that use these groups will publish
successfully. Other dimensional groups in SmartPlant Instrumentation are currently
not supported for publishing.
Group Description
IA1 Annubar Type 1
IA2 Annubar Type 2
ICM1 Coriolis Flowmeter Type 1
ICM2 Coriolis Flowmeter Type 2 Liquid
ICM3 Coriolis Flowmeter Type 2 Gas
ICM4 Coriolis Flowmeter Type 3 Liquid
ICM5 Coriolis Flowmeter Type 3 Gas
IDCO Orifice_Double Chamber Fitting
IDL1C Valve_Rotary Diaph. Act. Pos C1
IDL1D Valve_Rotary Diaph. Act. Pos D1
IDL4C Valve_Rotary Diaph.Act.Pos C4(Vert.Line)
IDL4D Valve_Rotary Diaph.Act.Pos D4(Vert.Line)
IDR1A Valve_Rotary Diaph. Act. Pos A1
IDR1B Valve_Rotary Diaph. Act. Pos B1
IDR4A Valve_Rotary Diaph.Act.Pos A4(Vert.Line)
IDR4B Valve_Rotary Diaph.Act.Pos B4(Vert.Line)
IEAM1 Valve_Electric Actuator Type 1

Group Description
IIOL Orifice_Integral Type 2
IIOR Orifice_Integral Type 1
IIV Insert Venturi
IKG1 Knife Gate Valve Typ 1_Piston Actuator
IKG2 Knife Gate Valve Typ 2_Piston Actuator
ILSV Long or Short Venturi
IMFM1 Magnetic Flowmeter Type 1
IMOP1 Meterrun_Orifice Flanges & Plate
IMRSV Meterrun_Short Venturi
IOP Orifice Plate
IPDA1 Valve_Double Acting Dual Cyl Act. TYP 1
IPDA2 Valve_Double Acting Sngl Cyl Act. TYP 2
IPDA3 Valve_Double Acting Piston Act. TYP 3 FC
IPDA3A Valve_Double Acting/Sprg Rtrn Act. 90 RS
IPDA4 Valve_Double Acting Sngl. Piston Act. FO
IPDA4A Valve_Double Acting/Sprg Rtrn Act. 90 LS
IPDA5 Valve_Double Acting Dual Cyl Act TYP 5
IPL1C Valve_Rotary Piston Act. POS C1
IPL1D Valve_Rotary Piston Act. POS D1
IPL4C Valve_Rotary Piston Act.POS C4(Vert.Line)
IPL4D Valve_Rotary Piston Act.Pos D4(Vert.Line)
IPR1A Valve_Rotary Piston Act. POS A1
IPR1B Valve_Rotary Piston Act. POS B1
IPR4A Valve_Rotary Piston Act.POS A4(Vert.Line)
IPR4B Valve_Rotary Piston Act.POS B4(Vert.Line)
IPSR1 Valve_Spring Return Piston Act. Typ1 FC

Group Description
IPSR2 Valve_Spring Return Piston Act. Typ2 FO
IPSR3 Valve_Spring Return Piston Act. Typ3 FC
IPSR4 Valve_Spring Return Piston Act. Typ4 FO
IR1 Rotameter Type 1
IREG1 Regulator Type 1
IRVT3 Relief Valve Type 3 (Pilot)
IRVT4 Relief Valve Type 4 (Pilot)
IRVT7 Relief Valve Type 7 (Specials)
IRXPA Valve_Rack & Pinion Actuator
ISSDA Valve Angle_Linear Diaphragm Actuator
ISSDS Valve Linear Diaphragm Actuator
ISSPS 3 Way Valve_Linear Piston Actuator
ITM Turbine Meter
IVM1 Vortex Flowmeter Type 1
IVM4 Vortex Flowmeter Type 4_Dual Head
IWFE Wedge Flow Element
Related Topics
• Publishing in an Integrated Environment: An Overview, page 1654

Revising Documents in an Integrated Environment: An Overview
Revising Documents in an Integrated

Environment: An Overview
The Revise Documents command, available on the SmartPlant menu, allows you to
revise a document and save it to the database of the authoring tool without publishing
it. When you register a plant, the software implements integrated revisions. During
report publishing, the software first checks whether the report has an integrated
revision and then assigns the appropriate revision scheme automatically.
Reserving Revision Number

The Revise functionality also provides an option that allows you to designate
revisions numbers to the plant or to particular projects. For each document, you can
reserve revision numbers at the plant or project level. Using this feature, you can use
the same document in different projects, while still allowing the revision numbers to
be sequential within each project.
For each project (or even at the plant level) you can reserve a certain number of
revisions that are held for that particular project. If the document is used within a
different project and revised, it is given either a later revision number or its own set of
numbers.
For more information about reserving revision numbers, see the Online Help for the
Revise dialog box.
Related Topics
• Revise a Document, page 1666

Revise a Document
1. Do one of the following to open the Revise dialog box:
• From any module that supports publishing and retrieving of
documents, on the Revisions dialog box, click New
• .
• From within SmartPlant Instrumentation, click SmartPlant > Revise
Documents
• .
Tips
• This option is available only if you have registered the active
SmartPlant Instrumentation plant.
• If you are logged on to SmartPlant Instrumentation with a user name
that is not defined in SmartPlant Foundation for the specific plant, you
are prompted to log on to SmartPlant Foundation when you use this
command.
• The documents that appear in the Selected documents list on the
Revise dialog box when it first appears are documents that were
selected within the authoring tool before you clicked the Revise
Documents command.

2. For a new document, or a document that does not yet have a defined revision
scheme, select the revision scheme you want to use from the Revision Scheme
list.
Tip
• If you selected a document that already has a defined revision scheme,
it is displayed in the Revision Scheme field and cannot be changed.
3. In the Revise in Tool section, choose the next available major and minor revision
numbers.
Tip
• Any revision numbers that have been reserved by another project are
not available and are skipped in the revision scheme, if applicable. In
other words, if the current version of the document is B and there are
three outstanding revision reservations for that document in other
projects, the next available revision number will be F.
4. Click OK.
Notes
• When you click OK to revise the document, it is saved to the authoring
tool database. The document stored in SmartPlant Foundation is not
updated until your publish it from SmartPlant Instrumentation.
• Using the Revise dialog box, you can reserve revision numbers, revise
documents, or do both at the same time.
Related Topics
• Revising Documents in an Integrated Environment: An Overview, page
1665

Retrieving in an Integrated Environment: An

Overview
When you retrieve documents into an authoring tool, you are retrieving the document
data that was published by another authoring tool. For example, in SmartPlant
Instrumentation, you can retrieve engineering information from a published P&ID
into the SmartPlant Instrumentation database.
The authoring tools provide commands that let you select a document and retrieve it
into that tool. You can use either the SmartPlant > Retrieve command to open a
wizard that assists you in retrieving applicable documents, or with some authoring
tools, you can configure an automatic retrieval feature.
Note
• The software trims all leading and trailing spaces from all strings and from
all values without units of measure. These spaces do not appear in the
retrieved data file.
Additionally, you can access the Web Client through the SmartPlant > Browser
command. This allows you to select the document or documents that you want to
retrieve from your Web Client To Do List, the tree view, or by using the Web Client
search functionality. After you select the documents that you want to retrieve, you
can use the Retrieve command on the Web Client SmartPlant menu to start the
retrieval process.
The Retrieve command provided in the authoring tools is slightly different from the
Retrieve command available in the SmartPlant Foundation Web Client. The Web
Client presents a list of documents from which you can select those you want to
retrieve. However, when you use the command from an authoring tool without first
selecting documents, the software searches the SmartPlant Foundation project for
documents to retrieve, and these are presented in a list on the Retrieve dialog box.
You can retrieve a document in two ways:
• As published — Retrieves only the data the authoring tool originally

published with the selected revision and version of the document.
Retrieving as-published data retrieves the .xml file the authoring tool
published from the appropriate SmartPlant Foundation vault.
• With the latest data — Retrieves the latest data associated with the
selected document in the SmartPlant Foundation database. If another,
more-recently published document contains updates to objects in the
selected document, the software retrieves the most current data in the
SmartPlant Foundation database for those shared objects. When you
retrieve the latest data, SmartPlant Foundation generates an .xml file
containing the published data.

Document Types for Retrieval

The types of documents that you can retrieve depend on the authoring tool that you
are using. For details of documents that each authoring tool can publish and retrieve,
see Tool Documents That are Published and Retrieved.
From the authoring tools, you can retrieve the plant breakdown structure (PBS) and
project documents. The PBS and project documents, created in SmartPlant
Foundation, are retrieved by authoring tools to provide information about the plants,
areas, units, projects, and contracts that need to be created in the authoring tool so that
the information is consistent across all authoring tools.
The PBS document published by SmartPlant Foundation contains information about

the physical plant with a structure consisting of plants, areas, and units. The default
structure is plant/area/unit, but you can define a custom hierarchy in the Schema
Editor. The project breakdown structure, project list, and project definition document
contain information about the project or projects and their statuses in a plant/project
structure.
Notes
• Retrieving the project breakdown documents and the PBS into SmartPlant
Engineering Manager creates the appropriate structures automatically.
• When using SmartPlant Instrumentation, you must create the plant
hierarchy according to the PBS information in SmartPlant Foundation
before you retrieve either the PBS or the project definition document.
You must create a plant hierarchy with at least three levels with a
minimum of one PBS item at the lowest level before you can retrieve the
PBS and project definition document.
Data Handling After Retrieval
The authoring tool that you use also determines how the system deals with changes in
downstream data when you retrieve a document. SmartPlant P&ID, SmartPlant
Instrumentation, SmartPlant Electrical, and Zyqad analyze the impact of the newly
retrieved data on the existing database, then place tasks on the authoring tool's To Do
List that allow you to create, delete, or modify items at the appropriate time in the
design process. The To Do List gives you the opportunity to view and understand
potential changes before accepting, deleting, or modifying those changes.

Design Basis
Objects that tools retrieve from other authoring tool documents can become the
design basis for objects in downstream documents. Objects that become the design
basis for other objects can be specific objects that get richer as they move through the
lifecycle or they can be schematic or logical objects in one application that evolve
into more detailed objects downstream.
Design basis is implicit based on retrieval; you do not have to define it. For example,
a pump retrieved from a PFD becomes the design basis for a pump in the P&ID.
When you change common properties for the pump and retrieve the changes into
SmartPlant P&ID, tasks to update the pump automatically appear in the To Do List.
The same process works for logical items that are a design basis for other items, such
as a P&ID tag in SmartPlant P&ID can evolve into a control loop with associated tag
numbers in SmartPlant Instrumentation.
Related Topics
• Open the To Do List, page 1675
Retrieve Documents to SmartPlant Instrumentation

1. Display one of the following:
• The main SmartPlant Instrumentation window with no modules
open.
• The Instrument Index Standard Browser view.
2. Click SmartPlant > Retrieve. The Retrieve dialog box appears.
Tips
• If you logged onto SmartPlant Instrumentation with a user name that is
not defined in the integrated environment, you are prompted to log on
when you use this command.
• The Retrieve command searches the integrated environment for
documents that are ready to be retrieved into SmartPlant
Instrumentation. These documents appear in the Documents to
retrieve list on the Retrieve dialog box.
3. In the Document type box, specify the type of document to be retrieved.

4. In the Show section, select Documents to be retrieved only to include

documents that have been retrieved previously and have been published again
since the last retrieval. Select All documents to include all revisions and types of
documents. Select New documents only to retrieve documents that have not been
retrieved yet.
5. In the Documents to retrieve list, select the check box beside each document you
want to retrieve. To help identify the documents, review the details in the Type,
Revision, Version, and Last Retrieved columns.
Tip
• To quickly select the entire list, click Select All. To quickly cancel the
selections, click Clear All.
6. For each document you checked, use the Retrieve Option column to specify
whether you want to retrieve the document with the latest data or retrieve it as
published.

7. Click OK to retrieve the specified documents.

Notes
• Check the Batch retrieve option if you want the retrieve process to run in
batch mode. If you select this option, an e-mail message will alert you
when the process is complete. Otherwise, the retrieval process begins
when you click OK.
• The Deleted and Unclaimed Objects document is retrieved automatically
every time you retrieve, if there is a newer version of this document since
the last retrieval. The document is not included in the list, but it is
retrieved automatically, when necessary, to ensure that the applicable
information is updated.
• When the retrieve is complete, a dialog box appears indicating whether the
retrieve operation was completed successfully or with errors. If the View
Log button on the dialog box is enabled, you can click it to view messages
concerning the operation. These may be errors, warnings or informational
messages.
Related Topics
• Find Documents to Publish from SmartPlant Instrumentation, page 1660
• Publish Documents from SmartPlant Instrumentation, page 1657

Using the To Do List: An Overview

The To Do List allows you to keep track of tasks required to keep your plant updated
with information in an integrated environment. Specifically, this feature aids in
retrieving data by providing a list of all the things that must be added, deleted, or
modified to bring the plant data into agreement with the latest retrieved information.
All the users of a plant database share a single To Do List. You can view the entire
To Do List and see the tasks that have been completed and those that are pending.
Some types of tasks have associated code and when you run those tasks, the software
modifies the database.
From the To Do List, you can perform tasks, defer them, or delete them altogether.
Additionally, you can view properties for each task in the To Do List. The
information that is available is specific to the type of task that is selected: Create
tasks and Update tasks, for instance, but certain information is provided for all types.
The available task types are:
• Create — Creates a new item in the plant

• Update — Updates the selected properties of the specified item
• Delete — Deletes the specified item from the plant
• Manual — Creates and displays a reminder. You can decide when a
manual task is complete and set the status accordingly.
Each task in the To Do List has a status. Initially, the status is Open. If you
successfully run the task, the status changes to Completed . If you attempt to run
a task, but the process is not completed successfully, the status is changed to Error
. Error status occurs, for example, if you attempt to run an Update task assigned
to a drawing that is not currently open. You can also postpone running a task and
change its status to Deferred .
Notes
• When an Update task is created in the To Do List, the units of measure
used in properties are automatically converted to the defaults for the plant.
The software converts units of measure used for properties in Create tasks
to the plant defaults when the task is run.
• By clicking the heading of columns on the To Do List, you sort the list by
the values in that column. You can change the order in which these
columns appear by selecting a column heading and dragging it to the left
or right to the desired position.

To Do List Common Tasks

The following tasks are used frequently when you work with the To Do List.
Run a Task from the To Do List

You run tasks to create, update, or delete data in the SmartPlant Instrumentation
database with data from a retrieved document. For more information, see Run a Task
from the To Do List, page 1676.
Sort Tasks in the To Do List

This procedure enables you to sort the To Do List tasks by task properties such as
Status, Task Type, Item Type, and Item Name. For more information, see Sort
Tasks in the To Do List, page 1679.
Filter Tasks in the To Do List

This procedure enables you to filter the To Do List tasks by task properties or for
tasks with specific values. For example, you may want to filter only those tags with
task type Create. For more information, see Filter Tasks in the To Do List, page
1679.
Remove a Task from the To Do List

This procedure enables you to delete tasks that are no longer needed from the To Do
List. Permanent deletion of tasks is a two-stage operation. First, you need to move
the task from the To Do List to a buffer that displays tasks intended for deletion. If
necessary, you can restore tasks in the buffer to the To Do List. Next, you delete the
task from the buffer. When you delete the task from the buffer, the software removes
it from the database and it cannot be restored. For more information, see Remove a
Update the To Do List Display

Updating the To Do List display is useful when several users can access the To Do
List, and you want to refresh the display with the latest information from the
SmartPlant Instrumentation database after another user has modified the item
specified by the task. For more information, see Update the To Do List Display, page
1681.
Related Topics

Set Preferences for the To Do List

1. Log on to the SmartPlant Instrumentation application.
3. In the Preferences dialog box tree-view pane, click SmartPlant Integration >
To Do List.
4. Under Task execution, click the desired option to determine how the software
executes tasks in the To Do List when you implement the Run command:
• Execute — Executes tasks immediately.
• Submit — Submits tasks for batch execution at a later stage.
5. Select other options as desired.
Related Topics
• To Do List Common Tasks, page 1674
Open the To Do List

Click SmartPlant > To Do List on the main menu bar.
Related Topics

Modify To Do List Task Properties

2. On the To Do List window, select the task or tasks that you want to edit.
3. On the To Do List toolbar, click Properties .
Tip
• You can also open the Task Properties dialog box by double-clicking
a task in the To Do List.
4. On the Task Properties dialog box, click the Details tab.
5. Select the check box beside each property for which you want the software to
create or update the value when you run the task.
Note
• The properties available for each task depend on the type of task. For all
types, you can edit the name and notes for the task. For Create tasks, you
can edit the item being created and turn off or on the values assigned to
different properties for that item. For Update tasks, you can turn off or on
the new values assigned to properties for the item.
Related Topics
Run a Task from the To Do List

2. On the To Do List window, select the task or tasks that you want to run.
Tips
• You can configure the Run Task command to execute tasks
immediately or to submit selected tasks for batch execution at a later
stage. For details, see Set Preferences for the To Do List, page 1675.
• Before running tasks, you can select a filter to run only tasks that meet
certain criteria, for example Update tasks only. For details, see Filter
Tasks in the To Do List, page 1679.
• You can select specific data columns for which to transfer data values
from the Details tab on the Task Properties dialog box.
• You can select all the tasks on the To Do List by pressing Ctrl + A.

3. On the To Do List toolbar, click Run Task .

Notes
• When creating process data for which minimum, normal, and maximum
values of a property apply, the software converts the minimum and
maximum values to the normal units of measure, if different. If there is
no normal value, the software converts to the maximum units of measure,
and if there are no normal and maximum values, only the minimum value
is used. For updates, the software converts all values to the existing units
of measure in SmartPlant Instrumentation.
• When retrieving loops without equipment and tag numbers with
equipment and then running a task that creates a relation between the
loops and the tag numbers, you must ensure that the loop equipment is not
set to propagate to the tag numbers by default, otherwise, the empty loop
equipment value will overwrite the existing equipment values for the tag
numbers. To do so, before running the task, open the intools.ini file, and
under the [Index] section, type the following line:
• LoopNoPropagateCheck=1
Related Topics

Task Dependencies
When you run tasks, there are some task types that require other tasks to run first.
For example, if two tasks exist for an item, one to move it to another <unit>, and the
other to update some of the item properties, the software cannot run the update task
until the move task is complete. The software analyzes the To Do List for these
dependencies to ensure that the tasks run in the appropriate sequence. The following
table indicates the dependencies that can exist between different task types.
Master Task Dependent Task

Claim Move
Claim Update
Move Update
Task dependencies influence the way in which the result of running a master task
affects the status of the dependent tasks. On running a task, the software checks the
To Do List for prerequisites, and changes the status of those tasks that are New to
Submitted. If the status of a prerequisite task is Deferred, Deleted, or Failed, then
the software marks all dependent tasks as Failed.
Related Topics
• Run a Task from the To Do List, page 1676
Complete a Task from the To Do List

2. On the To Do List window, select the task or tasks that you want to complete.
Tip
• You can select all the tasks on the To Do List by pressing Ctrl + A.
3. On the To Do List toolbar, click Complete Task .
Related Topics

Sort Tasks in the To Do List

2. On the To Do List toolbar, click Sort .
3. On the Sort dialog box, select a property under the Available columns list.
• Click Add.
• Drag the selected property to the Sort by pane.
5. Repeat for other properties that you want to sort by.
Tip
• After selecting the columns, you can change the sort order for the
properties by selecting a column in the Sort by pane and clicking
Move Up or Move Down as needed.
6. If you want to specify sorting for a particular column by descending order of the
values, select the Descending check box beside that column. Clear the check box
to sort by that column in ascending order.
Related Topics
Filter Tasks in the To Do List

2. On the To Do List toolbar, click Filter .
3. On the Filter dialog box, click Add to specify a new filter condition.
4. Specify the filter condition by selecting the desired parameters from the
Property, Operator, and Value columns; for example, you can specify the
condition:
Task Type = Create
5. If desired, specify additional filter conditions.

6. For two or more conditions, specify the logic (AND or OR) between each pair of
successive conditions.
Related Topics

Defer a Task from the To Do List

2. On the To Do List window, select the task or tasks that you want to defer.
3. On the To Do List toolbar, click Defer Task .
Related Topics
Remove a Task from the To Do List

2. On the To Do List window, select the task or tasks that you want to remove.
3. On the To Do List toolbar, click Delete Task .
Note
• You can display deleted tasks on the To Do List. For more information,
see Display Deleted Tasks in the To Do List, page 1680.
Related Topics
Display Deleted Tasks in the To Do List

2. On the To Do List toolbar, click View Deleted .
Tip
• To return to the current task list, click View Deleted again.
3. To delete tasks permanently, select the task or tasks that you want to delete, and
on the To Do List toolbar, click Delete .
Related Topics

Run a To Do List Report

1. Click SmartPlant > To Do List on the main menu bar.
2. On the To Do List toolbar, click Report .
Related Topics
Update the To Do List Display

On the To Do List toolbar, click Refresh .
Related Topics

Merger Utility: An Overview

The Merger Utility provides you with the means of transferring a selected plant
hierarchy item (for example, domain, plant, and so forth) from a source domain to the
same type of plant hierarchy item in an existing target domain. The source and target
domains can be a part of the same database or part of different databases. You can
also merge source and target plant hierarchy items within the same domain.
You run the Merger Utility in any of the following scenarios:
• You need to transfer all the data from a source domain to a target
domain.
• You need to transfer all the data from a source plant hierarchy item to a
target plant hierarchy item at the same level.
Notes
• Only the Domain Administrator has access to the Merger Utility.
• The source and target domains must be of the same SmartPlant
Instrumentation version. If they are not the same version, the Merger
Utility displays an appropriate message. In this case, you need to upgrade
the domain that belongs to the earlier version.
• The Merger Utility only supports domains of type Engineering company
when merging plant data. For configuration data, the Merger Utility
supports Engineering company and Operating owner (As-Built) domains.
• The Merger Utility changes the contents of your target database.
Therefore, we recommend that you backup your target database before
proceeding with the merge process. (For details of how to backup your
database, see Installation Guide, Backup and Restore.)
Related Topics
• Configuring Your Environment, page 1684
• Database Platform Support, page 1395
• Start the Merger Utility, page 1684

Database Platform Support

The Merger Utility provides you with inherent support of the following database
platforms:
• Oracle
• Microsoft SQL Server
• Sybase Adaptive Server Anywhere
You can use any of the above database platforms after you configured that database
platform to work with SmartPlant Instrumentation.
You can also import data from database platforms other than those specified above.
To do this, you need to install the appropriate drivers manually and configure the
appropriate configuration files.
Note
• SmartPlant Instrumentation uses a database engine developed by Sybase
for SmartPlant Instrumentation repository. This engine is called Sybase
Adaptive Server Anywhere.
Related Topics
• Merger Utility: An Overview, page 1682

Configuring Your Environment

When you install the software, the Merger Utility settings are automatically
configured in the appropriate configuration files. See your database manual to learn
more about your database configuration.
In a Windows 2000 or Windows XP environment, the database configuration settings

are located in the following registry folders:
• HKEY_CURRENT_USER\Software\ODBC\ODBC.INI
• HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI
Caution
• Do not change the setting in the configuration files if you are not familiar
with the database configuration.
Related Topics
Start the Merger Utility

To start the Merger Utility you must comply with the following requirements:
• You must have a previously defined source and target domains with at
least one plant hierarchy item at the lowest level of the hierarchy (by
default, this is a unit).
• Both the source and target domains must be of the same SmartPlant
Instrumentation version and sub-version.
See Installation Guide, SmartPlant Instrumentation Setup Maintenance and Database
Selection, Installing SmartPlant Instrumentation Components to learn more about
SmartPlant Instrumentation programs and utilities.
1. Select Merger Utility from the Intergraph SmartPlant Instrumentation
program group in the Windows Start menu.
2. On the Logon Information dialog box, type the Domain Administrator name and
password.

3. On the Open dialog box, expand the hierarchy as needed by clicking and select
the desired <unit> .
Tips
• Whenever you start the Merger Utility, the software prompts you to
select a target <unit>. If you have already started a merge process in a
previous Merger Utility session, you are prompted to resume that
merge process.
• You need to select a single target <unit> before starting the merge
process, the same way you do when you enter every SmartPlant
Instrumentation module. You can select additional target plant
hierarchy items as you proceed through the merge process. (For
details of how to select additional target data, see Merging Data: An
Overview, page 1692 .)
Related Topics

Working with Log Files

Log files allow you to keep track of all operations during a merge process.
When you start the Merger Utility for the first time, you create a new log file. The
log file keeps growing as you continue merging data unless you decide to change the
current log file. The information in the log file describes chronologically the events
which have taken place during the merge process. This information includes:
• and time in which the merge process started.

• Details of the selected source and target:
• The database platform (for example, Oracle)
• The domain name
• The plant hierarchy item name on the level at which data has been
transferred
• The starting ID of each table (for details of how to set the starting ID, see
Setting the Merger Comparison Criteria, page 1687 ).
• The total number of updated target rows (where the software overwrites
data).
• The total number of inserted rows (new rows that were appended in the
target domain).
• The total number of rejected source rows: source rows which were not
transferred).
• The transferring results: whether the merge process was successful if the
user stopped it or if it stopped due to merge failure.
If you start the merge process with no log file defined, the software prompts you to
define a log file when you are about to start the data transfer.
Note
• SmartPlant Instrumentation uses Notepad to view the log file; however,
Notepad is limited by file size that it can handle. If your log file becomes
too large for Notepad, an appropriate message appears. In this case, you
can view your log file using Windows Write or another appropriate utility.
Related Topics
• Preparing to Merge Data: Common Tasks, page 1689
• Setting the Merger Comparison Criteria, page 1687

Setting the Merger Comparison Criteria

You can control the way the Merger Utility identifies the source data as identical to
the target data during the merge process. This is important, because when the Merger
Utility encounters identical source and target rows, it can overwrite the target row or
leave it intact, depending on the comparison criteria settings. You can therefore
control the merge results by selecting the appropriate comparison criteria.
In SmartPlant Instrumentation, the database is organized in tables, for example:

CABLE, COMPONENT, CONTROL_VALVE, and so forth. These tables contain
data arranged in columns that represent various item types such as tags, cables,
panels, and so forth.
For example:
The COMPONENT table contains all the tags together with the appropriate links to
other tables, which utilize tags, such as: COMPONENT_MFR (Manufacturers table),
CABLES (Cables table), and so forth.
You can use one or more data columns in each table as the primary key fields of this
table. The value of the primary key of each table is unique in this table. For
example, the primary key of the COMPONENTS Table is CMPNT_ID. This means
that each row in the COMPONENT Table has a different value in the CMPNT_ID
field.
Note that the primary keys are not accessible to you when you work in SmartPlant
Instrumentation. The primary keys are designed only for SmartPlant Instrumentation
internal use.
When comparing rows, the Merger Utility treats the source and target rows as
identical only if both the source primary key and target primary key contain the
same value. For example, if the COMPONENT table in both source and target rows
contains the same values in the columns defined as primary keys, then the software
considers both rows as being identical.
In this case, the Merger Utility can either replace the entire target row with the source
row or leave this target row intact, depending on the merge process settings.

You can select the appropriate primary key of every table in the database. This way
you can create a different comparison criterion for each table.
Caution
• Changing the settings in the Target Definition dialog box alters the
relations between the tables. We therefore recommend that you do not
change these settings unless you find it necessary and only if you are
familiar with the SmartPlant Instrumentation database structure. In most
cases when you merge data, you do not have to modify the Merger Utility
comparison criteria. If you decide to modify the comparison criteria,
make sure you enter the appropriate data, as this feature changes the
contents of the target.
Related Topics
• Working with Log Files, page 1686

Preparing to Merge Data: Common Tasks

The following tasks are used when you prepare to merge data from one domain to
another, or one plant hierarchy to another.

This procedure shows you how to create a new log file. It is advisable to create a new
log file each time you perform an important import operation. You should also create
a new log file if your existing log file has become too long. For more information,
see Create a New Log File, page 1529.

This procedure shows you how to open an existing log file. It is advisable to open a
log file before you perform an import procedure so that you have a record of the
import process. For more information, see Open an Existing Log File, page 1529.

This procedure shows you to view the current log file and to review the previous
import process information. You can also view any other existing log file. For more
information, see View the Current Log File, page 1530.

This procedure shows you how to close the current log file, if you to choose to import
data without a log file. For more information, see Close the Current Log File, page
1530.

This procedure shows you how to delete a log file when the information in it becomes
unimportant. For more information, see Delete an Existing Log File, page 1531.
Related Topics
• Working with Log Files, page 1686

1. Click Log > New.
2. On the New Log File dialog box, type the name of your new log file, select the
desired path, and click Save.
Tip
• The Merger Utility opens a new (empty) log file automatically (even
though you do not see it).


1. Click Log > Open.
2. On the Open Log File dialog box, select the name of the log file you want to
open and click Open.
Tip
• After you create a new log file or open an existing one, it stays open
even though you do not see it displayed. The log file remains active
until you close the Merger Utility. (For details of how to close the
current log file manually, see Create a New Log File, page 1529.)
When you exit the Merger Utility, the log file closes automatically and
reopens when you restart the Merger Utility.
Related Topics

• Click .
• Click Log > View.
Tip
• The current log file opens for viewing in Notepad. SmartPlant
Instrumentation uses Notepad to view the log file. However, Notepad
is limited by file size that it can handle. If your log file becomes too
large for Notepad, you will get an appropriate message. In this case
you can view your log file using Windows Write or another
appropriate utility.
Related Topics

• Click Log > Close.
Tip
• The Merger Utility immediately closes the current log file. After you
close the current log file you need to define a new log file to resume
tracking the import process. (For details of how to define a new log
file, see Create a New Log File, page 1529.)


Caution
• This action deletes the selected log file from your hard disk and cannot be
reversed.
1. Click Log > Delete.
2. On the Open Log File Name dialog box, select the name of the log file you want
to delete and click Open.
Tip
• On clicking Open, the software deletes the specified log file from your
hard disk.
Related Topics

Merging Data: An Overview

Before you can merge data, you must create a merge session, within which you select
the source data, match the source and target data, and set the merging options.
After selecting the source data, you match the source and the target <units>. You
need to do this because the source and target domains may differ in the domain
hierarchy. For example, there may be more <units> in the selected source area than
in the target area.
The next stage is to select the data to be merged. There are two ways you can select
the data to be merged:
• Transfer all the data of selected modules or sub-modules using the module
list feature. When you select this option, the software transfers the entire
data for the selected item types.
• Transfer only the data that you select using the comparison list feature.
With this option, you can generate comparison reports which help you to
identify exactly which data needs to be merged. We recommend that you
save the comparison reports as .psr files. The advantage of having the
comparison reports in the .psr format is that you can re-use them in other
Merger Utility sessions if needed. There are, however, some limitations:
• PSR files reflect the situation at the time they were created. If the data
has changed during the time between the report creation and its
restoration, you cannot be certain that the data contained in the report
is up- to-date.
• Restore only supporting tables and reports for main item types (loops,
tags, cables, panels, and so forth). Do not select composite tables such
as tag and block relations.
Note
• If you want to delete data that is present in the target but not in the source,
you can do so only through the comparison list option.
You can manipulate, view, and print a .psr file from both InfoMaker and SmartPlant
Instrumentation. SmartPlant Instrumentation provides the best interface to deal with
the .psr files, as there are built-in features to filter, sort and column selection. If you
edit a .psr file outside SmartPlant Instrumentation, the hidden columns become
visible. This is a technical limitation that you should be aware of.
If you intend to merge data based on saved PSR files, do not save any changes made
through InfoMaker (you can make changes temporarily in order to adjust the layout
of the printed document, but do not save it).

Generate and save the comparison reports as PSR files. If there is a lot of data in the
source and target databases, consider doing this on a per <unit> basis for the basic
engineering. In this case, save the comparison reports in different folders.
If you use InfoMaker, set it so it does not retrieve the data from the database when the
document is opened. To set it, follow this procedure:
• Open the .psr file in InfoMaker in design mode.

• Click Design > Options.
• Clear the Retrieve on Preview option.
• Make sure that the Retain Data to Design option is selected.
In order not to run out of resources during the different comparisons, run this process
in different sessions as recommended.
To improve performance, make sure that the Build table list for merging data check
box in the Compare Source-Target Data window is cleared (there is no need to
build a table list for merging if you do not intend to use it at that time).
The next stage is to set the Merger Utility settings which include the general options,
setting the date from which to start merging the data, and selecting the tag custom
field data to be merged.
When you start to merge data, you can monitor the transfer process in the Merger
Progress window.
The merge process includes the following major steps:
• Selecting the source data; that is, the plant hierarchy item.
• Matching the source data with the target data.
• Selecting the source data to be transferred to the target domain.
• Setting the general Merger Utility options.
• Setting other Merger Utility options: date, user-defined fields, and log file.
• Transferring the selected source data to the target data.
Related Topics
• Merger Session: Common Tasks, page 1694

Merger Session: Common Tasks

The following tasks are used when you create a merge session, for merging your data.
Select the Target Item

When merging data, the Merger Utility treats the database identified in the current
intools.ini file as the target database and refers to your current plant hierarchy item as
the target. This means that the source data will be merged data in that <unit>.
SmartPlant Instrumentation connects to the current (target) database when you start
the Merger Utility. After the Merger Utility starts, the Open dialog box appears,
where you can select the desired target <unit>. For more information, see Select the
Target Item, page 1694.
Create a New Merger Session

This procedure shows you how to create a new merger session. For more
information, see Create a New Merger Session, page 1695.
Open a Merger Session

This procedure shows you how to open a merger session. For more information, see
Open a Merger Session, page 1695.
Rename a Merger Session

This procedure shows you how to rename a merger session. For more information,
see Rename a Merger Session, page 1695.
Duplicate a Merger Session

This procedure shows you how to duplicate a merger session. For more information,
see Duplicate a Merger Session, page 1696.
Delete a Merger Session

This procedure shows you how to delete a merger session. For more information, see
Delete a Merger Session, page 1696.
Related Topics
• Merging Data: An Overview, page 1692
Select the Target Item

1. Click File > Select Plant Hierarchy Item for Target.
2. On the Open dialog box, expand the hierarchy as needed by clicking and select
the desired <unit> .

Create a New Merger Session

1. Click Actions > New Session.
2. In the text box, type a unique name for the session.
3. Click Actions > Open Session.
4. Make your definitions for the session as you require.
5. When done, on the Actions menu, click Save Session.
Related Topics
Open a Merger Session

1. In the Merger Session Manager window, select the session that you want to
open.
• Click Actions > Open Session.
• Right-click the session, and on the shortcut menu, click Open Session.
3. Make any changes to the session as you require.
4. When done, on the Actions menu, click Save Session.
Related Topics
Rename a Merger Session

rename.
• Click Actions > Rename Session.
• Right-click the session, and on the shortcut menu, click Rename
Session.
3. In the text box, type a new name for the session.
Related Topics

Duplicate a Merger Session

duplicate.
• Click Actions > Duplicate Session.
• Right-click the session, and on the shortcut menu, click Duplicate
Session.
3. On the Duplicate Session dialog box, do one of the following:
• Click New and type a new session name.
• Select an existing session to overwrite it with the new session data.
Related Topics
Delete a Merger Session

delete.
• Click Actions > Delete Session.
• Right-click the session, and on the shortcut menu, click Delete
Session.
3. At the prompt, confirm the deletion.
Related Topics

Selecting the Source Domain: An Overview

After you have opened a session or defined a new session, the next step is to select a
domain or any plant hierarchy item within the domain.
The source domain can be:
• The same as the target domain (for details, see Select the Same Source
Domain As the Target Domain, page 1699).
• Different from the target domain but belonging to the same database (for
details, see Select a Source Domain from an ODBC Database, page 1700).
• A domain from a database or a database platform other than the target
domain database (for details, see Select a Source Domain From a
Database Other Than ODBC, page 1701).
Note
• You can select multiple <units> to be merged with the target.
During this stage you can also:
• Select the appropriate source modules.

• Select the appropriate source tables.
Related Topics
• Selecting and Matching Source Domains: Common Tasks, page 1698

Selecting and Matching Source Domains: Common

Tasks
The following tasks are used when you select source domains during the merge
process.
Select the Same Source Domain As the Target Domain

This procedure shows you how to select identical source and target domains if
required. For more information, see Select the Same Source Domain As the Target
Domain, page 1699.
Select a Source Domain from an ODBC Database

This procedure shows how you can select a different source domain than the target
domain, but from the same database as the target domain. You do this by selecting
ODBC as your database and Sybase Adaptive Server Anywhere as your database
platform. After selecting your source and target domains you need to establish the
connection to the required domain. For more information, see Select a Source
Domain from an ODBC Database, page 1700.
Select a Source Domain From a Database Other Than ODBC

This procedure shows you how to select a source domain from a database platform
other than ODBC. After selecting your source domain you need to establish the
connection to the required database. For more information, see Select a Source
Domain From a Database Other Than ODBC, page 1701.
Match the Source Projects to the Target Projects

This procedure shows you how to match source and target projects if you have
selected to merge configuration data and the source domain is of type Operating
owner. In this way, the Merger Utility transfers data from the selected source projects
to the selected target projects which you are going to link. For more information, see
Match the Source Projects to the Target Projects, page 1702.
Match the Source Data with the Target Data

This procedure show you how after connecting to a database and selecting the source
domain or plant hierarchy item, you match the source and the target <units>. In this
way, the Merger Utility transfers data from the selected source <units> to the selected
target <units> which you are going to link. This procedure applies where you have
selected a source plant hierarchy item other than a <unit>. For more information, see
Match the Source Data with the Target Data, page 1702.

Match Source And Target Naming Conventions

This procedure show you how after mapping source and target <units>, you can
match the loop and tag naming conventions for those <units>. In most cases, if the
source and target <units> use the same naming convention type, you do not need to
match the segment names. However, under certain circumstances, for example, if the
target naming convention is the Flexible standard, you may need to match individual
segments between the source and target or map segments automatically when the
source and target segment names are identical. For more information, see Match
Source And Target Naming Conventions, page 1703.
Related Topics
• Selecting the Source Domain: An Overview, page 1697
Select the Same Source Domain As the Target Domain

1. Open a Merger Utility session. For details, see Open a Merger Session, page
1695.
• Expand the tree and click Connect.
• Click Actions > Connect to Source.
3. On the Connect to Source dialog box, select Use target domain as source.
Tip
• Whenever you open a new Merger Utility session, the source domain
is the same as the target domain by default. Therefore the details of
the current target domain (the domain that you selected when you
started this merge session) appear under Information.
4. Click Plant Hierarchy.
5. On the Source Plant Hierarchy dialog box, select as the source either the entire
domain or any plant hierarchy item within the domain. For details of how to
continue the merge process, see Match the Source Data with the Target Data,
page 1702.
Related Topics

Select a Source Domain from an ODBC Database

Important
• The Merger Utility does not support source databases that have the As-
Built functionality.
• Make sure you have the proper access rights (logon name and password)
required to connect to the source domain.
1. In the Merger Session Manager window, open the desired Merger Utility
session.
3. On the Connect to Source dialog box, clear Use target domain as source.
4. Click Connect.
5. On the Connect to Database dialog box, from the DBMS list, select ODBC as
the database platform.
6. From the Profile name list, select the source database profile.
Tip
• If you select ODBC as your database platform you can select only a
Sybase Adaptive Server Anywhere database profile (for example,
IN_DEMO, SP_INSTRUM, and so forth) from the Profile name list.
7. In the Logon name and Logon password boxes, type the logon name and
password to connect to the selected database.
8. Click Plant Hierarchy.
domain or any plant hierarchy item within the domain. For details of how to
page 1702.
Related Topics

Select a Source Domain From a Database Other Than

ODBC
Important
In order to establish a connection to the required database platform:
• Make sure you have all the correct .dll files and the right settings in the
appropriate .ini files and/or registry.
• Make sure you have the proper access rights (logon name and password)
required to connect to the source database. See SmartPlant
Instrumentation Configuration and Maintenance Guide, Appendixes,
SmartPlant Instrumentation Database Technical Review, Logon Data and
Database Connection Security to learn more about database access rights.
session.
3. On the Connect to Source dialog box, clear Use target domain as source.
4. Click Connect.
5. On the Connect to Database dialog box, from the DBMS list, select the database
platform that you require.
6. Click OK to open the additional part of the Connect to Database dialog box.
7. In the Server name box, type the name of the database server.
8. From the Logon name list, select a logon name to connect to the selected source
database.
9. In the Logon password box, type the appropriate password to connect to the
selected source database.
10. On the Connect to Database dialog box, click Plant Hierarchy.
domain or any plant hierarchy item within the domain. (For details of how to
page 1702.)
Note
• The Merger Utility does not support source databases that have the As-
Built functionality.

Match the Source Projects to the Target Projects

Important
• You must perform this procedure when you select the User Group or
Access Rights options for merging the data.
1. On the Connect to Source dialog box, click Match Projects.
2. On the Match Projects dialog box, match each target project individually to the
required source project by selecting in the Target (left) data window, the row that
represents the required target project and dragging it to the required cell under
Connected to Target Project in the Source data window.
Tips
• If projects in the source and target have the same names, you can
connect them automatically by clicking Match Names.
• You cannot map a project onto itself.
3. Click OK to return to the Connect to Source dialog box.
Related Topics
Match the Source Data with the Target Data

1. On the Connect to Source dialog box, click Match Plant Items.
Tip
• If the Match Plant Items command button is not available, first click
Plant Hierarchy to open the Source Plant Hierarchy dialog box
where you have to select the domain, a plant, or an area as the source.
This action automatically opens the Match Plant Hierarchy Items
dialog box.
2. On the Match Plant Hierarchy Items dialog box, match each target <unit>
individually to the desired source <unit> by selecting in the Target (left) data
window, the row that represents the required target <unit> and dragging it to the
required cell under Connected To in the Source data window.
Tips
• You can map multiple source <units> to the same target <unit>.
• If <units> in the source and target have the same names, you can
connect them automatically by clicking Match Names.
• You cannot map a <unit> onto itself.

3. Click OK to return to the Connect to Source dialog box.

Tip
• If you need to merge the entire plant data; that is, matching all the
source and target <units>, you should consider merging the data in
several separate sessions. Merging the entire plant data in one session
may take a long time because it increases the time required to generate
the comparison reports. Also, a single merge session requires more
client and server computer resources.
Related Topics
Match Source And Target Naming Conventions

1. On the Connect to Source dialog box, click Match Conventions.
2. On the Match Naming Conventions dialog box, under Target plant hierarchy,
expand the hierarchy and navigate to the desired <unit>.
Tip
• If a source <unit> is mapped to the selected <unit>, the plant hierarchy
of the source <unit> appears beside the target <unit> name.
3. Under Naming convention type, do one of the following:
• Click Tag to map a tag naming convention.
• Click Loop to map a loop naming convention.
4. If required, click Clear to clear the mapping between the naming convention
segments in the source and target <units>. This action clears all the data in the
Source Segment column.
Tip
• You can clear the loop and tag naming convention mapping for all
<units> in the domain by clicking Clear All.


• Under Source naming convention, select a row representing the
segment you want to match, and drag it to the Source Segment
column under Target naming convention for the required target
segment.
• Under Target naming convention, type in the Source Segment
column for the required target segment the required source segment
name.
Tips
• If segments in the source and target have the same names, you can
connect them automatically by clicking Match Segments.
• When you drag the source name, the software displays the number of
the source segment in the Source Segment column instead of copying
the full string. You can add a substring and include fixed text in the
source segment name. For example: #2 (1,3) + 'DD'. This means that
the name of the second segment in the source is used. The segment
itself consists of the first three characters of the source segment name,
and has suffix DD (without the quotes).
Note
• After matching naming conventions, it is recommended that you run the
comparison list to view loop and tag names before merging the data.
Related Topics

Defining Merger Utility Settings: Common Tasks

The following tasks are used when you defining the merger utility settings.
Define Merger Utility Settings

Before merging data in a session, you need to set the Merger Utility options.
You can determine whether to do any of the following:
• Overwrite the target rows with identical source rows.

• Stop data merging if a source row fails to be transferred to the target.
• Use tag names for wiring items, and use the same source and target tag
and loop convention names.
For more information, see Define Merger Utility Settings, page 1708.
Select the Source Modules and Module Data

You use this option if you want to transfer all the data of selected modules or sub-
modules to the target domain. You can select entire modules and/or expand the
appropriate modules to select the required module data. At this stage, you can also
select specific loops that you want to merge.
For example, you can select the entire Instrument Index module or you can double
click the Instrument Index module icon to expand it and select the required
module data (for example, Line, Equipment, and so forth). You can also expand any
Instrument Index module data, such as supporting tables.
Note
• You cannot proceed with the merge process until you select the source
module and/or module data. The data window in the Select Items dialog
box does not contain module data with the caption Tags. This is because
the source tags are automatically selected when you select the Instrument
Index module. Therefore, to merge the source tags, select the source
Instrument Index module without expanding it.
For more information, see Select the Source Modules and Module Data, page 1709.

Select the Source Tables to Be Merged

You can make a more precise selection of the source data. You do this by selecting
the source tables to be merged (for example, Manufacturers Table, Status Table, I/O
Table, and so forth) in the Advanced Selection dialog box.
You open the Advanced Selection dialog box by clicking Advanced in the Select
Items dialog box.
The Advanced Selection dialog box consists of the following sections:
• Filter: Select the criteria that are used to filter the displayed tables.
• Sort: Select whether to sort the tables by name or by merge order.
• (Table data): Select the required source table to transfer to the target
domain. You can also type additional data to append to the target domain
during the transfer process.
Note
• If you resume a previous merge session, you see in the Advanced
Selection dialog box the source tables which were selected in that merge
session.
Now you can:
• Select the source tables that you want to merge.

• Specify data which will be appended to the target domain during the data
transfer.
• Specify an insertion condition for the required source tables.
• View the displayed source tables according to your required filtering and
sorting options.
For more information, see Select the Source Tables to Be Merged, page 1711.
Select the Source Item Types to Merge

You can select specific item types in the source that you want to merge:
• Wiring — All source wiring items, reference items, or plant (user-

created) items.
• Documents — All documents saved to the database or just P&ID
document numbers, or specs, process data sheets and calculation sheets, or
all documents apart from specs, process data sheets and calculation sheets.
For more information, see Select the Source Item Types to Merge, page 1711.

Specify an Insertion Condition

You can specify an insertion condition for every selected source table. This way you
instruct the Merger Utility to insert every selected source row of the selected source
table, which complies with the table's insertion condition. Note that the insertion
condition will affect only the source tables which you have selected to be merged.
The insertion condition can contain any combination of the following:
• Source columns
• Operators or functions
• Alphanumeric values
For more information, see Specify an Insertion Condition, page 1712.
Filter And Sort the Displayed Source Table List

You can filter and sort the displayed source tables. You do this by selecting the
options in the appropriate parts of this dialog box.
Note
• Filtering and sorting the source data in this dialog box does not affect the
results of the merge process.
For more information, see Filter And Sort the Displayed Source Table List, page
1714.

Define Merger Utility Settings

1. Open a Merger Utility session.
2. Click Actions > Options.
3. On the Options dialog box, specify your settings as desired.
Tips
• The Comparison Action tab folder becomes available only after
running a comparison list.
• The Update Mode tab folder becomes available only after you select
Update existing data in the General tab folder.
• When merging configuration data items, you must select Update
existing data if you want to merge data for the Custom Field
Definitions and Custom Table Definitions items. These items
include tables that contain a fixed number of existing rows, and for
this reason, these rows can only be updated; it is not possible to insert
new rows.
4. After defining all the settings, proceed with the selection of the item types to
merge by performing one of the following procedures:
• Select the item types that you want to merge.
• Compare the source and target data.
Related Topics
• Select the Source Item Types to Merge, page 1711
• Selecting Source Data Using the Comparison List: Overview, page 1715

Select the Source Modules and Module Data

1. Open a Merger Utility session.
3. Click the Item Type tab.
4. Under Merge data for, do one of the following:
• Click All plant items to select all items in the plant for data merging.
This option is available only if you have connected to a database that
is an Engineering company domain.
• Click Configuration data items to select configuration data items
only for merging. Configuration data is background data that includes
default panels and cables, specification forms, instrument types, and
various supporting table data. This option is available for any database
connection, whether it is part of an Operating owner domain or an
Engineering company domain. This option is useful where you need
to populate several domains with basic data from the same source.
Tips
• When merging configuration data items, on the Merger Preferences
dialog box, you must select Update existing data if you want to
merge data for the Browser with Specification item. This ensures
that the browser views open properly after merging.
• When merging configuration data items, you must select Update
existing data if you want to merge data for the Custom Field
Definitions and Custom Table Definitions items. These items
include tables that contain a fixed number of existing rows, and for
this reason, these rows can only be updated; it is not possible to insert
new rows.
5. Return to the Merger Session Manager and do one of the following:
• Expand the tree and click Select.
• Click Actions > Select Items.

6. On the Select Items dialog box, select the module data that you want to transfer
from the source domain to the target domain.
A check mark appears beside everything that you select.
Tip
• Using the Select all check box to select items is not the same as
selecting all the items in the data window. If you select the Select all
check box, the software selects all plant items and all configuration
data items (excluding User Group and Access Rights), regardless of
which items appear in the data window.
7. To make a more precise selection of the source data by selecting the required
source table (applies only if you selected All plant items), do the following:
a. Click Advanced.
b. On the Advanced Selection dialog box, select the source table to be merged
to the target domain.
8. Click OK to save the Merger Utility settings.
9. At the prompt, click Yes to confirm your selection of the source data.
Related Topics
• Select the Source Tables to Be Merged, page 1711
• Start the Transfer Process, page 1731

Select the Source Tables to Be Merged

• Under the Select column, select the check box for each table you
require to include in the merge process.
• Select the Select all check box to select all the available source tables.
Selected source tables are displayed in red; unselected source tables are
displayed in black.
Tip
• To locate a table by name, click Search and type the table name in the
text box.
2. Select the check box in the Insert Only column if you want to specify an
insertion condition for the selected table — any updated data in the table does not
get merged in this case.
3. To merge the reference tables of any selected source table, click Reference
Tables.
Note
• All the reference tables associated with the selected source table are
automatically selected for merging.
Related Topics
• Select the Source Modules and Module Data, page 1709
Select the Source Item Types to Merge

1. With the Advanced Selection dialog box open, click Data Types.
2. On the Data Type Selection dialog box, under Wiring, select the source wiring
items you want to merge in the target domain.
3. To select the source documents, under the Documents select the source
documents you want to merge in the target domain.
Tip
• When merging P&ID document numbers, the associated source data
such as specifications, tags, and loops, is not transferred.
4. Click OK to close the Data Type Selection dialog box and return to the
Advanced Selection dialog box after accepting the values.

Specify an Insertion Condition

1. On the Advanced Selection dialog box, select the check box under the Insert
Only column for the selected table. Use the horizontal scroll bar to display the
pertinent section of the dialog box.
This causes the Merger Utility to insert any source rows (of the selected
source table) which comply with the condition specified in the adjacent
Condition column.
2. Under the Condition column, type the appropriate insertion condition.
Caution
• Make sure you type the appropriate condition, as this will affect the
merge process results.
The Merger Utility provides you with the following inherent operators and functions.
Operator / Descriptions Example

Function
= Equal to cpmnt_mfr = 'Shell'
> Greater than cmpnt_name > '101'
< Less than item_price < 100
>= Greater or equal to num >= 10
=< Less than or equal to item_price =< 30
<> Not equal to prefix <> 'AA'
AND Include the following expression in the name AND num <> 0
filter combination
OR Accept either the previous or the Loop OR line = ''
following expression in the filter
combination
NOT Select the value opposite to the following NOT (item_price = 0)
expression
LIKE Select a value that is similar to the one in cmpnt_name LIKE
the `%[value]%' field '%AA%'
IN Select a value that is equal to one of those cpmnt_name = IN
specified in the parentheses ('101','103')
BETWEEN Select a value which is within the item_price BETWEEN
following interval 100 AND 500
IS NULL Equal to NULL Loop IS NULL
IS NOT NULL Not equal to NULL line IS NOT NULL

Tip
• The above operators and functions are those used in the WHERE string of
the SQL statement.
You can also use special functions which are native to the source database.
The following table describes some of the most common functions. The source
databases which provide each function are specified beneath the function name (in
italics) in the Function column. The function output is described beneath the syntax
example (in italics) in the Example column.
Function Descriptions Example

LTRIM (<value>) dBase Remove all leading LTRIM(cmpnt_mfr) cmpnt_mfr
Sybase Adaptive Server spaces in the field = 'Shell'
Anywhere 7.0 Oracle 9i, indicated in the LTRIM(cmpnt_mfr)='Shell'
10g SQL Server parentheses
RTRIM(<value>) dBase Remove all trailing RTRIM(cmpnt_num) IS NULL
Sybase Adaptive Server spaces in the field cmpnt_num = '108-FT 100'
Anywhere 7.0 Oracle 9i, indicated in the RTRIM(cmpnt_num)='108-FT
10g SQL Server parentheses 100'
SUBSTRING(<value>, Retrieve a part of SUBSTRING(cmpnt_mfr,1,4)
<begin>,<count>) dBase the field indicated cmpnt_mfr = 'Shell'
Sybase Adaptive Server in the [value] data SUBSTRING(cmpnt_mfr,1,4)='S
Anywhere 7.0 Oracle 9i, field from the hell'
10g [begin] position for
the number of
characters
SUBSTR(<value>,<begin>, indicated in the SUBSTR (cmpnt_mfr,1,4)
<count>) SQL Server [count] field cmpnt_mfr = 'Shell'
SUBSTR(cmpnt_mfr,1,4)='Shel'
UCASE(<value>) DBase The upper case UCASE(cpmnt_name)
Sybase Adaptive Server format of the cmpnt_name = '101-aa'
Anywhere 7.0 contents of the field UCASE(cmpnt_name)='101-AA'
UPPER(<value>) Sybase indicated in the UPPER(cpmnt_name)
Adaptive Server Anywhere [value] data field cmpnt_name = '101-aa'
7.0 Oracle 9i, 10g SQL UPPER(cmpnt_name)='101-AA'
Server
LCASE(<value>) dBase The lower case LCASE(Loop_name)
Sybase Adaptive Server format of the Loop_name = '101-AA'
Anywhere 7.0 contents of the field LCASE(Loop_name)='101-aa'
LOWER(<value>) Oracle indicated in the LOWER(Loop_name)
9i, 10g SQL Server [value] data field Loop_name = '101-AA'
LOWER(Loop_name)='101-aa'

Note
• When a table is defined on a specified level, it contains data which is
unique on that specified level. For example, the CABLE Table is defined
per area. Therefore, the CABLE Table contains data which is unique only
on the area level of the domain.
Filter And Sort the Displayed Source Table List

1. To sort the table list which is displayed in the Advanced Selection dialog box, do
• Click By name to list the source tables by table name
• Click By merger order to list the source tables by the order in which
they will be merged during the transfer process (the merging order).
Tip
• You cannot change the merge order because it is automatically
determined by the Merger Utility.
2. To filter the data which is displayed in the Advanced Selection dialog box,
specify the filter conditions by doing one of the following:
• Select All to display tables at all levels in the domain.
• Select Selected to display only tables that were selected for merging.
• Select Per domain to display only tables that relate to the domain
level.
• Select Per plant to display only tables that relate to the plant level.
• Select Per area check box to display only tables that relate to the area
level.
• Select the Per unit check box to display only tables that relate to the
unit level.

Selecting Source Data Using the Comparison List: Overview
Selecting Source Data Using the Comparison

List: Overview
This option enables you to compare the source and target data before you select it to
be merged. You can select item types to be compared either in batch mode (group
mode) or one by one. If you use group mode, the Merger Utility allows you to save
the comparison list in a number of file formats (psr, dbf, xls, and so forth). If you do
not select group mode, the Merger Utility displays the comparison data in a special
dialog box for each item type that you select in the Compare Source-Target Data
window.
After running the comparison list, you should examine the comparison results
carefully and select the desired data transfer mode and transfer parameters. For
example, you can determine whether you want to delete target data that does not exist
in the source or whether you want to delete all the tags associated with a deleted loop,
and so forth. You can also access specific comparison data, such as Specs, Process
Data, Cross Wiring, Signals, and so forth, depending on the item type you selected to
compare. Furthermore, you can customize the comparison list data display by
filtering and/or sorting the data according to your needs.
Related Topics
• Selecting Source Data Using the Comparison List Common Tasks, page
1716

Selecting Source Data Using the Comparison List

Common Tasks
The following tasks are used when you select source data using the comparison list.
Define Comparison List Options

This procedure shows you how before comparing data in a session, you set the
comparison list options.
You can determine whether to do any of the following:
• Include or exclude wiring data when comparing tag data.

• Include or exclude connections when comparing wiring data.
• Include or exclude complementary data in the comparison.
For more information, see Define Comparison List Options, page 1719.
Define a Comparison List Style

This procedure shows you how when displaying comparison data for an item type,
you can specify which properties of that item type you want to appear in the
comparison list by defining a style. By means of a style you can determine which
columns are available, the order of the columns, column widths, column header text,
and the appearance of the column header: border, background color, and overall
height.
For more information, see Define a Comparison List Style, page 1720.
Compare Source And Target Data

This procedure shows how you can compare data between the source and the target
by opening a comparison list for a selected item type. You can then select which data
items to merge. You can also specify the items that you want to display and print a
report for the displayed items.
For more information, see Compare Source And Target Data, page 1721.
Compare Data Using Group Mode

This procedure shows you how group mode enables you to make a batch selection of
item types for comparison and subsequent transfer of data. You save the comparison
data for subsequent inspection and analysis in an external file in a file format of your
choice. After running the comparison list, you can open the saved external file to
examine the data so that you can determine how to use the comparison list data.
For more information, see Compare Data Using Group Mode, page 1723.

Check for Duplicate Items

This procedure shows you how to check for duplicated items. Sometimes, when you
create data, you can add spaces or other characters accidentally, so that what is
intended to be the same record with updated data is in fact viewed by the database as
a separate record. You can specify redundant characters that you want the software to
ignore, and then you can run a check for duplicate items based on the item names
without the redundant characters.
For more information, see Check for Duplicate Items, page 1726.
Restore a Saved PSR File

This procedure shows you how restoring .psr files enables you to avoid regeneration
of the comparison list. Restore your existing .psr files if you are certain that they
reflect updated data. If you are not sure that the .psr files contain updated data,
regenerate the comparison lists either one at a time (not recommended) or in group
mode.
For more information, see Restore a Saved PSR File, page 1727.
Run the Comparison List by Making an Individual Item Type Selection

This procedure shows how you can select individual item types for comparison. You
can expand an item type and run the comparison list for the selected item type only.
If a child item type contains other child item types, they will also be included in the
comparison list for that item type. Expand the desired child item type and make your
selections.
For more information, see Run the Comparison List by Making an Individual Item
Type Selection, page 1727.
Filter the Comparison List Data

This option enables you to filter the rows displayed in the comparison list. You can
specify a filtering condition that will filter the comparison list data.
For more information, see Filter the Comparison List Data, page 1728.
Display Specific Data Columns in the Comparison List

This procedure shows you how to select the data columns that you want to be
displayed in the comparison list.
For more information, see Display Specific Data Columns in the Comparison List,
page 1729.

Sort the Comparison List Data

This procedure shows you how to sort the comparison list data. You can select any
number of columns to use for sorting the data.
For more information, see Sort the Comparison List Data, page 1729.
Display the Comparison List for a Child Item Type

This procedure shows you how to display additional detailed comparison data
pertaining to a child item type (if available).
The following table indicates the item types that contain child item types.
Main Item Type Available Child Item Types for Comparison

Line Process Data
Tag Signal, Process Data, Specs
Panel 1 Side, 2 Side, Cross Wire, Jumper
Strip 1 Side, 2 Sides
Terminal 1 Side, 2 Sides
Cable 1 Side
Cable Set 1 Side
Wire 1 Side
For more information, see Display the Comparison List for a Child Item Type, page
1730.
Start the Transfer Process

This procedure shows you how to carry out the actual data transfer, after you have
selected the source and target data and matched one to the other.
For more information, see Start the Transfer Process, page 1731.

Perform A Preliminary Configuration

This feature provides you with the means to control the data flow during the merge
process. You can also use this feature to select the application to view the log file. In
most cases, you do not need to use this feature. However, you can use it if you
encounter the following problems:
• The merge process is slow.

• Your computer has insufficient memory resources to perform the merge
process.
• The current application which is used to view the log file cannot handle
the current log file (for example, due to the size of the log file).
• This procedure enables you to:
• Speed up the transfer process.
• Free memory resources for the transfer process.
For more information, see Perform A Preliminary Configuration, page 1732.
Related Topics
Define Comparison List Options

1. With the Merger Session Manager window open, click to display the
Compare Source-Target Data window.
2. Click Actions > Options.
3. On the Merger Compare Data Options dialog box, do the following to specify
how the Merger Utility auto-selects and merges wiring information:
a. If you selected Tag in the Compare Source-Target Data window, click one
of the following settings under Wiring selection by tag to merge wiring data:
• No wiring — The software includes no wiring data with the
selected tags during the transfer: the wiring information of the
target tags remains intact.
• Instrument wiring — The software includes all the device panel
and device cable data relevant to the selected tag be included, that
is, only the field device panels and cables are created for the
selected tags. If you select this option, make sure that you also
select Without connections under Selection by panel/cable.
• All wiring — The software includes the entire signal data that is
relevant to the selected tag.

b. If you selected the Cable, Set, Wire (Plant) and/or Panel, Strip, Terminal
(Plant) options in the Compare Source-Target Data window, select one of
the following settings to merge wiring data:
• Without connections — The software includes no connection data
with the selected item type during the transfer, that is, when
selecting panels and/or cables, only their structure is selected. This
is useful when merging or moving cables or panels from one
domain to another. You can access the connection information by
clicking 1 Side in the comparison list and select the relevant rows.
• With connections — The software includes the relevant
connection data during the transfer, that is, when selecting cables
or panels, their connections are also selected. This option instructs
the Merger Utility to select all the relevant panels, cables, tag
numbers, loop numbers, and all the rest of the required data. You
can refine the selection by canceling the selected connections.
c. Under Complementary data, beside each item, select the Select check box to
merge complementary data (specifications, process data, hook-ups, loop
module data, calibration data, custom field data, and other items).
Related Topics
1716
Define a Comparison List Style

2. Select an item type from the Comparison Item Tree and do one of the following:
• Click Actions > Create Style.
• Right-click the item type, and on the shortcut menu, click Style.
3. Specify the comparison list layout as follows:
• Change the column sequence by dragging the column header to the
required position.
• Change the column widths by dragging the right border between the
columns to the left or right as needed.
• Adjust the overall column header height by dragging the lower border
of the header up or down.
4. To change the header text, double-click inside the header to open the Edit
Column Name dialog box and edit the text as required.


• Click Actions > Style Properties.
6. On the Comparison List Style Properties dialog box, from the Border list, click
the border type that you require for the header.
7. Select View beside each column that you want to appear in the style.
Tip
• To display all the columns, select View all; to display none of the
columns, clear View all.
8. To choose a background color for the comparison list header, click Color to open
the Windows Color dialog box, where you can specify the color that you require.
9. When done, click OK to accept the values and close the Comparison List Style
10. Click Actions > Save to save the style for the selected item type.
11. Click Actions > Close to return to the Compare Source- Target Data window.
Related Topics
1716
Compare Source And Target Data

2. Select an item type from the Comparison Item Tree and do one of the following:
• Click Actions > Compare Data.
• Right-click the item type, and on the shortcut menu, click Compare
Data.
• Double-click the item type.
3. In the comparison list window for the selected item type, do one or more of the
following:
• To filter the data records to display, click .
• To sort the data, click .
• To specify which data columns to display, click .

4. To create or modify a style for viewing a comparison list that is already open, do
the following:
a. Click to return to the Compare Source-Target Data window.
b. Select the item type and click to open the Style window.
c. Modify the style as desired.
d. In the comparison list window for the selected item type, click to update
the comparison list using the style properties.
e. Select the records for merging by doing one of the following:
• Select the Select check box beside each data record that you want
to merge.
• To select all the data records, click .
• To clear the selection of all the data records, click .
• To select updated data records only, click .
• To select inserted data records only, click .
• To select deleted data records only, click .
f. Select the data to display by doing one of the following:
• To display all the data items, click .
• To display modified data items only, that is, where the source and
target data differs, click .
• To display selected data items only, click .
g. If a comparison list is available for a child item type, click the desired option
on the Reports menu.
h. To generate a comparison list report, on the Actions menu, click Report.
i. To save the selection you made for merging, on the Actions menu, click Save.
Related Topics
1716

Compare Data Using Group Mode

Caution
• If you selected wiring item types or wiring information to be merged, do
not change the settings you made in the Merger Compare Data Options
dialog box. If you change these settings after selecting wiring item types
in the comparison list, the new settings apply only to new comparison list
selections. In any case, it is difficult to predict what happens when you
merge data in this case, as sometimes there can be a relation between
different item types that you select.
session.
• Click Actions > Comparison List.
• Right-click the session, and on the shortcut menu, click Comparison
List.
3. Click Actions > Use Group Mode.
4. Click Actions > Group Mode Parameters.
5. On the Group Mode Parameters dialog box, select Save comparison list as
report only if you do not want to save the comparison results to the database.
This saves the generated comparison reports as external files only. You have to
make the appropriate selections under the Save data in section.
6. To automate the selection process, select the type of data to be selected under
Select data:
• All– This option selects all the existing item types (for example,
instrument, loop, panel, cable, and so forth) This option is
recommended to get all the wiring and connection changes.
• Deleted– This option selects the item types that appear in the target
domain only.
• Inserted– This option selects the item types that appear in the source
domain only.
• Updated– This option selects the item types that exist both in the
source and target and need to be updated.
• Saved previously– This option includes previously saved comparison
data.
Tip
• It is recommended that you select the Deleted, Inserted, and Updated
options.

7. Under Additional options, select the required types of comparison reports to be

generated based on the selections you made under Select data:
• 1 Side– This report is for cables and panels. It reports the wire and
• Cable levels – Generate two additional reports for cables: cable sets
and wires of the cable (not mandatory if 1 Side is selected.)
• Panel level – Generate two additional reports for panels: panel,
strips, and sets and wires of the cable (not mandatory if 1 Side is
selected.)
• Jumper– This report identifies the jumpers by listing the two
terminals that the jumpers are connected to.
• Cross Wire– This report identifies the crossed wires by listing the
two terminals/strips and panel names that the crossed wires are
connected to.
• 2 Sides– This report lists the connections on both sides of a terminal
strip. Note that this report and the relevant comparison list data cannot
be used to select connections: it is for your information only.
• Signal– This report lists the connections for the selected tag numbers.
Note that this report and the relevant comparison list data cannot be
used to select connections – it is for your information only.
• Specs– This report lists the differences in specifications. This is a
generic report that displays the changed data only. You cannot select
single attributes for an update.
• Process Data– This report lists the differences in process data. This
is a generic report that displays the changed data only. You cannot
select single attributes for an update.
• For all data – Generate comprehensive comparison reports for
selected item types under Additional options (recommended).
• For selected data – Generate comparison reports based on your
selections under Select data for the item types selected under
Additional options.
8. Click to specify the path and format of the file in which you will save the
comparison data. Several file formats are available, for example, .psr, .dbf, .xls.
After you make your selection, the Group Mode Parameters dialog box displays
the information in the Save data in section.
Caution
• Make sure that you select the .psr format so that you can use the report
in the merge process.
9. Click OK to accept your selections and to return to the Compare Source-Target
Data window.

10. Make your selections in the data window by clicking the desired item type. The
icon beside the selected item type changes to . The software automatically
selects all the child item types belonging to a selected item type. You can select
or deselect individual child item types if required as follows:
a. Double-click an item type to expand it. (Certain child item types may contain
other child item types.)
b. Click the desired item type to select or deselect it. The icon beside selected
item types changes to . If a check mark appears beside an item type, it
means that the item type has already been used in a previous run of the
comparison list.
Caution
• To ensure correct merging of specification data, make sure that you
select all the tag numbers associated with multi-tag specifications,
especially the master tag number. If you do not do so, the
specification information will not be updated.
11. Click Actions > Build Item List if you want make additional source selections in
the module list after running the comparison list. Note that selecting this option
will slow down the merge process. Do not select this option if you do not intend
to use the module list feature.
• On the menu bar, click Actions > Compare Data.
Note
• The comparison procedure may take some time depending on the size of
the database tables. At the end of the comparison procedure, you can view
the comparison reports by opening the appropriate .psr files.
Related Topics
1716

Check for Duplicate Items

1. With a Merger Comparison List dialog box open, on the Actions menu, click
Duplicates to open the Duplicate Items dialog box.
2. Click Characters to open the Redundant Characters dialog box.
• Click Add to add a new row and type in the required character or
string.
• Select an existing character and modify it as needed.
• Select a row and click Delete to remove that row from the list of
redundant characters.
• Click Use Default to clear all user changes and restore the default set
of redundant characters.
Tip
• You can type strings of up to 20 characters.
4. Click OK to return to the Duplicate Items dialog box.
Tip
• The Identity Name column displays the modified item name without
the redundant characters, and selects any duplicate rows using
background shading: the software selects the first instance using light
blue shading and duplicate items using gray shading.
5. Under View, click one of the following options:
• All items– All the items derived from the comparison list appear.
• Selected items– Only the items you select for merging appear.
• Duplicate items– Only the items highlighted as duplicates appear.
• In the Select column, select the items you want to include for data
merging.
• Select the Select all check box to include all of the items or clear the
check box to include none of the items.
Tip
• Selecting or clearing Select all affects the displayed items only.
Related Topics
1716

Restore a Saved PSR File

session.
2. Define a new log file.
3. Define the required Merger Utility settings — the settings depend on the item
types you are about to merge.
• Click Actions > Comparison List.
• Right-click the session, and on the shortcut menu, click Comparison
List.
5. In the Compare Source-Target Data window, highlight the item types that you
want to include in the comparison.
6. Click Actions > Restore Comparison Data.
7. On the Select PSR File dialog box, navigate to the .psr file that you want to
restore.
8. Click Actions > Merge to start generating the comparison lists.
Related Topics
1716
Run the Comparison List by Making an Individual Item Type

Selection
1. With the Compare Source-Target Data window open, make sure that on the
Actions menu, the Use Group Mode menu command is not selected (no check
mark beside the command).
2. Expand the items in the tree so that you can highlight the individual item type for
which you want to run a comparison list.
• Click Actions > Compare Data.
• Right-click the item type, and on the shortcut menu, click Compare
Data.
• Double-click the selected item type.
The Merger Utility starts running the comparison list. At the end of this
process, the Merger Comparison List dialog box opens.

4. If available, select an option on the Reports menu to display the Connection,

Process Data, and Specifications comparison data to facilitate the selection of
rows to be merged. Note that some of these options are disabled if they are not
relevant for the item type you selected in the Compare Source-Target Data
window.
5. To customize the displayed data in the comparison list, on the Actions menu,
point to Display Records and click one of the following options:
• All Records — Displays all the available records.
• Selected — Displays only those records selected for merging
• Modified — Displays modified records only, where the source and
target data differs.
• Under the Select column, click the check box for each row you want to
select to be merged.
• Make a batch selection by right-clicking in the window, pointing to
Select Records and clicking one of the commands: All, Updated,
Inserted, or Deleted to specify the rows to include in the merge
process.
7. Click Actions > Save.
Related Topics
1716
Filter the Comparison List Data

1. With the comparison list open, on the Actions menu, click Filter to open the
Merger Comparison List Filter dialog box.
2. To include a field in the filter condition, double-click the required field in the
Field list and it will appear in the editable data window at the top of the dialog
box.
3. Enter the required filter condition by either typing it in directly in the data
window or by selecting the appropriate operators and functions.
4. Click OK to accept the filter condition and return to the comparison list.
Note
• Filtering the comparison list rows will not affect the selection and row
sorting you made prior to filtering the comparison list data.

Display Specific Data Columns in the Comparison List

1. With the comparison list open, on the Actions menu, click View to open the
Select Columns for Viewing dialog box.
2. Under Column list, drag the required columns to be displayed to Columns to
view. Only the columns that appear under Columns to view will be displayed in
the comparison list.
3. If the comparison list currently does not display all the available rows, you can
select the check boxes Select All to display all the columns in the comparison list,
or Include modified columns to display only those columns that contain changed
data.
4. Click OK to accept your selections and return to the comparison list.
Related Topics
1716
Sort the Comparison List Data

1. With the comparison list open, on the Actions menu, click Sort to open the Select
Columns for Sorting dialog box.
2. Under Column list, drag the required columns to be used for sorting to Sorted
columns. The data will be sorted according to the columns that appear under
Sorted columns in the order that they appear.
3. To remove a column to be used for sorting, drag it from Sorted columns to
Column list.
Tip
• To change the sort order, drag all the columns to Column list, and
then drag them in the required order under Sorted columns.
4. Click OK to accept your selections and return to the comparison list.
Related Topics
1716

Display the Comparison List for a Child Item Type

Note
• The information in the comparison list for child item types is not editable.
1. With the comparison list for the selected item type open, on the Reports menu,
click the appropriate command to open the Merger Comparison List dialog box
for the desired child item type.
2. Under View, click All or Changed data only as required to filter the data to be
displayed.
3. Click Print to print out the data.
4. Click Close to return to the comparison list.
Tip
• When the 2 Sides option is selected for panels, strips, or terminals, if
some of the connection data was changed, the merge mode will be U
(update), and both the previous and current values will appear in the
same field. Fields that contain no data signify that the selected panel
has no wiring on that side.
Related Topics
1716

Start the Transfer Process

Caution
• You will not be able to change the Merger Utility process parameters after
you start the data transfer.
1. With the Merger dialog box open, click Merge to start the transfer process.
2. At the prompt, click Yes to start the data transfer.
Tip
• If you encounter memory problems or you want to make the data
transfer process faster.
3. On the Merger Progress dialog box, click Stop if required at any point during
the transfer process to stop the current data transfer process.
Note
• If you stop the transfer process, the Merger Utility skips all the rows of
the currently processed table. You can resume the transfer process in
the current merge session (by clicking Continue) or in another merge
session (after exiting the current merge session). When you resume
the transfer process, the Merger Utility restarts the merge of the last
table from which you left off.
4. On completion or stopping of the transfer process, click OK to close the
notification message.
5. In the Merger Progress window click Cancel to return to the Merger dialog box.
You have successfully copied data from a source domain to a target domain.
Now you can:
• Start SmartPlant Instrumentation and enter the appropriate target domain

to view the results of the merge.
• View the log file to examine information about the merge results of the
current merge process (for details of how to view the log file contents, see
Working with Log Files, page 1686).
Related Topics
1716
Caution
• We recommend that you do not configure the Merger Utility unless it is
absolutely necessary.

Perform A Preliminary Configuration

2. Click the Data Flow tab.
3. Do one of the following to determine how fast the software merges data:
• Leave the contents of the fields unchanged (the default values are:
1000 rows in the Source rows to retrieve data field, and 500 rows in
the Target rows to commit data field).
• Type a larger number of rows than the current default values. This
way you speed up the merge process.
• Type a smaller number of rows than the current default values. This
way you free memory resources but it may slow down the merge
process.
Tip
• Make sure you do not exceed your memory capacity as this may cause
the merge process to fail during the data transfer.
4. To see the effect of the new settings, continue with the merge process.
Related Topics
• Merging Data: An Overview, page 1692
1716

Running the Comparison List in Multi-Sessions

So as not to run out of computer resources, it is highly recommended that you run the
comparison list in group mode in more than one session. Make sure that on the
Actions menu, the Build Item List menu command is not selected (no check mark
beside the command) — this speeds up the process. There is may be no need to
create a table list for merging if you don't intend to use it at that time. The following
table summarizes the recommendations for the multi-session procedure.
Session A Session B Session C Session D Session

E
Mandatory: No Yes Yes Yes No
Can be No Yes No No No
done per
<unit>?
Long time No Yes Yes Yes Moderate
for
generation?
Select Wiring Instrument Panels Cables Restore Panel
items Supporting Index (Plant) (Plant) (Plant) PSR
Tables Supporting and run for
Default Tables Loop Strip &
Cables Tag Line Terminals
Default Equipment Comparison
Panels Loop P&ID CS Tags List, then
Drawings save
Module
Hook-Ups
Module

Session A Session B Session C Session D Session

E
Group Select data Select data – Select data – Select The Panel
Mode – All Cable All All Cross data – and Cable
Options Levels Panel Specifications Wiring 2 All 1 Levels can be
Levels Save Process Data Sides Side generated
comparison Signal Select (optional) Select separately
list as report the For all Select the the For from the PSR
only Note: Data option For all Data all Data files of the
Cable and Save the option Save option Panel &
panel levels Comparison the Cable to save
are not list as report Comparison the computer
mandatory. only. list as report resources
only. during the
Group mode
comparison.
If run on Panel Levels Cable
<unit> basis, (see session Levels
save in E) (see
different session
folders E)
Note
• You can reduce the amount of data to be merged by selecting fewer item
types, depending on the comparison information you require.

Analyzing Comparison Reports

After the comparison reports are saved as psr files (or any other type of file), you can
print them out and start analyzing the data. If a field's value was changed, a U mode
is assigned to this record and the changed column is highlighted with a light blue
background.
The following example is for instrument type comparison.
In the second row, the highlighted changes were made in the target table. In the
source table, these fields do not contain data.
In the third row, the target table does not contain an entry while the source table does.
That is why there are two rows. Sometimes the field is too short to display the entire
record, which causes the text to auto- scroll. Note that this can also make the field
appear as two rows. You can then stretch the column to make it longer.
To analyze the data, you need to print out the reports and mark changes you want to
make on the printouts. In the case of the supporting tables, this is a simple task since
these tables usually include two columns. All of the supporting tables are merged in
one process since they are required for the main item types. Therefore, you do not
need to worry about them so much.

Concentrate on the main item types:
• Loops and tags

• Instrument Type (although this is a supporting table)
• Cables
• Panels
• Analyze the changes in process data and specifications
• Connections (1 Side)
• Cross Wires
• Jumpers
• Control system tags:
• Loop blocks
• Hook-up drawings
Mark the reports (use color markers if possible), mainly for wiring changes.

Merging Supporting Tables

When merging supporting tables, note the following:
• Instrument Index module: When selecting tag numbers, the appropriate

items from the relevant supporting tables will also be selected. Specific
supporting tables can be also merged using the comparison list feature.
• Wiring module: Use the comparison list feature to merge specific Wiring
module supporting tables. However, if a cable or a panel was selected by
you or by the Merger Utility, previous selections will be ignored and the
entire table will be merged. To merge data successfully, you must include
the entire set of reference data. This rule applies to both the Instrument
Index and Wiring modules. Failure to select all the reference data may
result in a chain reaction which will cause large amounts of data not to be
merged. The Merger Utility makes sure that this situation does occur by
selecting entire supporting tables to be merged.
Related Topics
1716

Guidelines for Selecting Item Types and Defining

Merger Settings
The following tables provide some specific guidelines to help you define the settings
when merging various SmartPlant Instrumentation modules. Remember to define
these settings before you select the item types to be merged. If you run merger
several times to merge different tables, click Clear all to reset the previous selections.
Selected Option Settings Result Comments

Instrument Types General: Update Imports all references
existing data as per instrument type
Comparison profile: Wiring
Options: supporting tables,
Insert/Update defaults for cable,
Include all reference panel and connection
tables types I/O Types
Location Hook-ups and
hook-up types
Specification forms
Equipment General: Update Equipment type
existing data Equipment custom
fields
Line General: Update Line Type PD
existing data insulation Line and
Comparison Line custom fields
Options:
Insert/Update
Include all reference
tables
Loop General: Update Loop Reference Tables New loops will
existing data Loop and Loop custom automatically be
Identical source and fields Specification added if new
tag Comparison forms tags are added
Options: from the source.
Insert/Update
Include all reference
tables


Tag Numbers – General: Update Wiring supporting Merges all
No Wiring existing data tables Associated associated
Identical source and instrument types reference tables.
tag Comparison Associated index and No wiring will
Options: loop tables Loop be merged or
Insert/Update drawing information changed for
Include all reference Blocks/cells and types selected tag
tables Wiring Process Data numbers.
Selections Selection Specifications and Selecting With
by Tag No Wiring Revisions Associated Connections
Selection by custom fields will not
Panel/Cable Associated hook-up affect/add any
Without Connections data wiring data.
Tag Numbers – General: Update Wiring supporting Control System
Instrument Wiring existing data tables Associated tags will not be
(Field Devices Identical source and instrument types merged
only) tag Comparison Associated index and Important: If
Options: loop tables Loop the With
Insert/Update drawing information Connections
Include all reference Blocks/cells and types option is
tables Wiring Process Data selected,
Selections Selection Specifications and additional
by Tag Instrument Revisions Associated panels, cables,
Wiring Selection by custom fields and connections
Panel/Cable Associated hook-up will not be
Without Connections data Field Device added (junction
cables, panels, and their boxes and
connections on the marshaling
instrument side racks) unless
these are
selected from
Panel/Cable
lists.


Tag Numbers – General: Update Wiring supporting Will only
All Wiring existing data tables Associated connect the
Identical source and instrument types wires associated
tag Comparison Associated index and with the
Options: loop tables Loop selected tag
Insert/Update drawing information numbers.
Include all reference Blocks/cells and types Caution: If the
tables Wiring Process Data With
Selections Selection Specifications and Connections
by Tag Instrument Revisions Associated option is
Wiring Selection by custom fields selected,
Panel/Cable Associated hook-up additional
Without Connections data Field Device panels, cables,
cables, panels, and their and connections
connections on the will be added
instrument side All for all the
associated panels and selected panels.
cables that the signals
go through


Cable or Panel General: Update Merges the Panel/Cable Connections can
(Plant or Default) existing data structures without be merged if
Comparison connections. selected from
Options: Panel/Cable supporting the Merger
Insert/Update tables Comparison
Include all reference List - Wire
tables Wiring Terminal
Selections Selection dialog box.
by Panel/Cable This will
Without Connections include
additional
information as
required. If you
select
connections (by
cables) with
signals, field
device cables
will be selected
to be merged
but they will not
be connected.
The Selection
by Tag setting
has no effect in
this case.


Cable (with General: Update Complete cable You can cancel
connections) existing data structures the selection of
Caution: Working Comparison (cable/set/wires) and cable
in this mode Options: supporting tables. All connections on
makes Merger Insert/Update the panels / strips / the Merger
select more Include all reference terminals that are Comparison
panels, cables, and tables Wiring required to connect List - Wire
connections than Selections Selection their wires. Instrument Terminal
selected. This is by Panel/Cable Index – tag numbers dialog box.
due to signal With Connections and their loop and Additional
relations. If you supporting table panels, cables,
are not sure, records. Specifications and all their
choose the and Process Data. Loop connections will
Without and Hook-Ups module be added and
connections associated data (for tag processed if
option. numbers). Wire connections
connections. All with signals are
associated custom field involved. The
data. Selection by
Tag setting has
no effect in this
case.


Panel (with General: Update Complete panel You can cancel
connections) existing data structures the selection of
Caution: Comparison (panel/strip/terminals) cable
Working in this Options: and supporting tables. connections on
mode makes Insert/Update All the cables the Merger
Merger select Include all reference connected to the Comparison
more panels, tables Wiring selected panel / strip, List - Wire
cables, and Selections Selection including the cable Terminal
connections than by Panel/Cable supporting tables. dialog box.
selected. This is With Connections Instrument Index – tag You can cancel
due to signal numbers and their loop the selection of
relations. If you and supporting table jumpers and
are not sure, records. Specifications cross wires in
choose the and Process Data. Loop appropriate
Without and Hook-Ups module dialog boxes.
connections associated data (for tag Additional
option. numbers). Wire panels, cables,
connections, including and all their
jumpers and cross connections will
wires connected to the be added and
selected panels / strips. processed if
All associated custom connections
field data. with signals are
involved. The
Selection by
Tag setting has
no effect in this
case.


Control System General: Update Appropriate data will You will not
Tag Caution: If existing data be selected to be need this option
With connections Comparison merged depending on in most cases.
is selected, the Options: the setting you select in However, if you
entire wiring Insert/Update the Selection by Tag do, the software
chain of all cables Include all reference section: No Wiring and will merge basic
is selected (not tables Wiring Instrument Wiring engineering,
recommended). Selections Selection will select the data wiring, and
by Panel/Cable required for tag other associated
Without Connections assignment. If a field data.
Selection by Tag No device exists, it will be
Wiring OR All merged too. The All
Wiring (not Wiring option will
recommended) select the entire signal
data. Instrument Index
– tag numbers
and their loop and
supporting table
records. Specifications
and Process Data. Loop
blocks. All associated
custom field data.
Associated hook-up
data.
External Blocks N/A Block Types Blocks
Tag & Block N/A for information only. Tag and block
Association Not selectable to be associations are
merged. merged when
merging tag
numbers
Item List Comparison Item List Library Items Selecting the
Options: List Include all
Insert/Update reference
Include all reference tables option in
tables the
Comparison
Options tab
folder will
merge the hook-
types, hook-ups,
and hook-up
items


Hook-Ups No special settings Hook-up type Hook-
ups Item Library and
Items
Tag and Hook-Up N/A for information only. Tag and hook-
Association Not selectable to be up association is
merged. merged when
merging tag
numbers.
Important Notes:
1. Do not change the wiring selection options before starting the actual merge
process. The software processes the selected rows and carries out the merge
process in accordance with the settings.
2. When selecting the With connections option in the Wiring Selections tab folder,
records that appear only in the target are marked as deleted and are selected
automatically by the Merger Utility. These selections, in most cases, will be
wrong and you will have to clear the Select the check box in the appropriate
comparison list dialog box (for example, after clicking on the 1 Side button in the
Comparison List).
3. Exercise caution when using the Delete option in Merge Options dialog box,
Comparison Actions tab folder. This option instructs the Merger Utility to
actually carry out delete operations. It is possible that the software will not delete
items that are associated with other items. Double check the selected records after
merging. Delete data directly in SmartPlant Instrumentation if results are not
satisfactory. In most cases, you do not need to select the Delete option.
4. When selecting item types to be merged, especially Wiring and Instrument Index
data, it is important not to select different item types within the same merge
session. This is due to the fact that the Merger Utility processes your selections
differently when it comes to tag numbers, cables, panels, and connections based
on the pre-selected settings.
5. The final selection of tables and item types to be merged is determined when you
click Save to close the Merger Comparison List window. You can browse the
selected records of different item types. Click Close to close the window without
saving your changes.
Related Topics
1716

Merging Jumpers and Cross Wires

Jumpers and cross wires are processed differently from ordinary cables since the
Merger Utility has to connect both sides of the wires when adding them. To access
the cross wires or jumpers, select a panel and in the Merger Comparison List
window, on the Reports menu, click Cross Wire or Jumper. The dialog box
displays the wires that are connected to the selected panels. Under Records to select,
click the appropriate check boxes for the records that need to be inserted, depending
on whether you selected With connections or Without connections.
You can select or deselect records as required. It is important to have all the jumpers
and cross wires existing in the Wiring module for further processing.
Note that when you select a panel using the With connections option, the Merger
Utility automatically selects the jumpers and cross wires.
Related Topics
1716

Merging Specification Forms that Include Custom

Title Blocks
When you associate custom title blocks with specification forms, two methods of
association are available:
• A separate special title block definition for each form

• A common standard title block definition used for all the forms in the
domain.
When merging data in update mode, you must analyze your source and target
databases to determine which option they are using for specification form custom title
blocks. If the options are identical in both, or if the target uses the standard option,
you can merge the data without any problems.
If the source database uses the standard option, and the target uses the special option,
you are likely to lose data after merging. In this case, your System Administrator
must change the Custom title block assignment method option in the source domain
from Standard to Special.
Related Topics
1716

Customizing the Comparison List Display

The Merger Utility enables you to customize the comparison list data display. You
can filter and or sort the data according to your needs. You can select the columns
you want to view, in which case the other columns will not be displayed. It is also
possible to display only the data lines that you selected for the merge process
(selected check boxes in the Select column). Another way of choosing the rows to
display is to select the By mode option. In this case, you can display deleted,
inserted, and or updated rows.
Related Topics
1716

Post Merging Actions

After the merge process has been completed (in one or several sessions), it is
recommended to test the results. In some cases, there might be a need to do some re-
propagation of tag numbers in the Wiring module (some manual adjustments may be
required in the database). This is due to tag numbers that were created in one
database in the field, but in the other database they originated in a DCS or PLC.
For a large quantity of data, it is recommended running the comparison lists again to
verify that all new items were inserted and there are no missing connections or cross
wires.

Index
Index
.bmp files spec customization guidelines, 834
adding to spec page, 723 .xml files
.dxf files prerequisites for working with DCS vendors, 1573
saving reports, 119 .zip files
.imp files binder package documents, 1029
exporting links, 1420 binder packages, 1023
importing links, 1421 revisions, 1023
.isf files spec revisions, 821
saving specs in .isf format, 826 ABB
.pbl files associate fieldbus device types, 1599
retrieving reports, 133 retrieving definitions, 1597
.pdf files ABB interface, 1571
document binder package, 1028 access rights
printing documents, 114 maintenance event records, 1190
printing specs into .pdf files, 859 accessing
.psr files Web Client, 1608
adding drop-down data windows, 739 Acrobat Distiller
adding select lists, 740 batch printing to .pdf files, 114
correcting grid line divergence, 840 setting print options, 116
correcting line discontinuity, 839 Acrobat Distiller printer driver
creating invisible vertical line, 838 testing configuration, 1624
customizing for Save as Excel, 836 active item library
InfoMaker libraries, 1362 defining, 1119
managing the file list, 132 add_spec9 table, 712
opening as spec page, 708 Adobe Acrobat
opening in InfoMaker, 729 configuring for SmartPlant Foundation, 1615
opening in InfoMaker from libraries, 1363 installing, 1615
overview, 127 Adobe Acrobat Distiller
replacing double lines, 839 configuring, 1620
retrieving custom spec pages, 716 ampersand, 83
retrieving files, 129 ampersand character in specs, 730
revisions, 1023 amplifiers
saving data, 130 adding connectors, 977, 981
saving spec pages, 710 creating, 976
saving specs in .psr format, 825 analyzers
spec customization for Excel common tasks, 832 analyzer stream specs, 780
spec revisions, 821 complex analyzer specs, 764
specprn.psr, 852 defining complex analyzers, 1268
user-defined fields, 134 linking stream and line components, 1269
value display precision for Excel, 841 overview, 1265
viewing, 128, 131 API 2540 standard
.wmf liquid density calculation, 1275
saving spec pages, 710 apparatus
.xls files add an apparatus to a group, 550
font style of specs, 831 apparatus group, 549
global value display precision, 840 common tasks, 546
Save as Excel overview, 831 configuring, 547
saving specs, 827 editing terminal properties, 551
saving specs in batch mode, 827 fieldbus apparatus configuration, 912
setting macro security, 844 overview, 545
spec customization common tasks, 832 approvals

Index
in hook-up drawings, 1146 propagation of line data, 1243

in loop drawings, 1067 saving single-tag specs, 826
As-Built saving specs as Excel, 827
claiming items common tasks, 220 batch printing
claiming items for a project, 216 dimensional data sheets, 1351
claiming items in Domain Explorer, 224 dimensional sheet forms, 1352
copying items for merging as Merge Now, 227 Bill of Material
copying items for merging as Release Claim, 228 calculating total quantity, 1160
copying items to Claim Buffer, 223 common tasks, 1161
displaying data in project, 221 generation, 1162
merging items common tasks, 220 opening by selecting document numbers, 1164
merging project items, 218 sorting data, 1163
assign I/O binder packages
instrument tags, 447 adding revisions, 1021
tag numbers, 447 change notification, 1018, 1024
associating change summary report, 1017
fieldbus device types, 1599 common tasks, 999
items in KKS mode, 1389 creating, 1001
symbols with items, 469 deleting, 1006
associating external files, 1007 deleting revisions, 1022
AutoCAD General Document Binder, 998
CAD settings, 1073 managing external files, 1007
LISP function, 1073 notes, 1008, 1011, 1013
paths, 1073 notes overview, 1009
auto-wiring overview, 996
changing task status, 630 printing, 1027
common tasks, 619 printing common tasks, 1026
control systems, 625 printing overview, 1025
control systems (pre-assigned junction boxes), 627 printing to file, 1028
flow of activities, 618 properties, 1003, 1030
overview, 615 revision archive, 1019
pre-assigned junction boxes, 621 revisions, 1015
task statuses, 630 revisions common tasks, 1020
tasks overview, 616 saving, 1029
two panels, 623 Specification Binder, 997
base conditions templates, 1010, 1011
in the Process Data module, 1239 troubleshooting, 1031
batch loop creation block assignment methods
typical loop, 419 assigning to instrument types, 1049
batch operations, 1310 assigning to instruments, 1051
Acrobat Distiller options, 116 changing from Automatic to Manual, 1050
adding tags to a multi-tag spec, 773, 774 icons in the Domain Explorer, 1034
applying reference cables, 486 manual assignment, 1051
batch calculation, 1310 overview, 1034
CAD drawing block assignment, 1051 updating block assignments, 1052
changing form assignment for specs, 754 block types
creating hook-up items, 1120 adding, 1042
deleting spec revisions, 822 adding blocks, 1042
deleting specs, 702 icons in the Domain Explorer, 1036
dissociating CAD drawing blocks, 1056 overview, 1036
generating specs, 698 specifying default border block, 1056
Ghostscript printer options, 115 specifying default logo block, 1056
import link priority order, 1403 blocks
importing data to instrument specs, 830 assigning blocks common tasks, 1046
printing documents, 113 associating loop block, 1048
printing documents to .pdf files, 114 copying all automatically assigned blocks, 1054

Index
copying to another plant hierarchy item, 1045 changing instrument type, 447
copying to other instruments, 1053 changing process function, 447
dissociating from instruments, 1056 clearing data from the buffer, 349
dissociating loop block, 1048 common tasks, 343
drawing generation per block, 1079 copying data, 348
hook-up drawing border block, 1149 counting rows, 349
hook-up drawing logo block, 1149 counting tag number rows, 443
inserting macros in drawing blocks, 1096 creating device panels and cables, 520
overview of loop blocks, 1038 displaying wiring connections, 447
shipped blocks, 1039 editing data, 346
updating paths, 1067 editing typical tags, 423
viewing in CAD application, 1043 Field Indication Color, 352
working with CAD drawing blocks, 1041 finding a value, 351
border blocks finding a value in a column, 440
CAD loop drawings drawings, 1056 instrument index standard view, 437
hook-up drawings, 1149 modifying layout, 346
breakdown maintenance opening, 345
creating a repair form, 1187 opening a module, 352
filling out repair forms, 1188 overview, 342
issuing a new work request, 1184 refreshing displayed data, 350
opening a work request, 1185 selecting for data import, 1430
performing, 1171 sorting rows, 349
brick assemblies using the buffer, 348
common tasks, 909 view data history, 444
creating, 910 browsers
overview, 908 adding new browser common tasks, 337
browser manager adding new browser overview, 336
adding a new view, 290 adding new form browser, 340
browser types, 297, 299, 300, 301, 302, 303, 304, adding new powersoft browser, 340
305, 306, 307 creating in InfoMaker, 338, 1366
clearing a view setting, 313 creating spec form browser fields, 750
common tasks, 287 custom browser, 338, 1366
copying a view, 292 opening specifications, 699
creating a view style, 311 showing in Explorer Items pane, 267
default view, 288 built-in operators and functions, 1441
defining a view, 289 built-up back pressure, 1319
deleting, 294 cabinets
displaying current settings, 323 creating, 497
displaying current style, 310 cable block diagram, 686
duplicating a view, 291 common tasks, 686
duplicating views, 319 cable block diagrams, 685, 687, 689, 690, 691, 692
filter settings, 328, 330, 331, 333, 334, 335 adding items, 689
finding, 295 associating a cable with a panel, 692
hierarchy, 296 creating, 687
modifing a profile, 292 disconnecting cable, 690
modifying style settings, 314 open an existing diagram, 690
overview, 286 overview, 685
print layout, 316, 318 removing objects, 691
printing style setting, 320 viewing an existing diagram, 690
sorting sequence, 323, 325, 326, 327 cable drums
sorting settings, 321, 322 adding drums manually, 671
style settings, 308, 309 associating pulling areas, 669
browser module automatic cable assignment, 672
overview, 285 common tasks, 667
browser views, 444 defining attributes, 670
applying profiles, 381 deleting drums, 671

Index
editing drum properties, 671 assigning blocks common tasks, 1046

flow of activities, 666 assigning to CAD drawing pages, 1055
manual cable assignment, 672 assigning to instrument types, 1049
optimizing, 672 associating loop block, 1048
overview, 666 common tasks, 1041
pulling areas, 669 copying all automatically assigned blocks, 1054
cable routing copying to another plant hierarchy item, 1045
adding sections, 660 copying to other instruments, 1053
appending to cable, 665 defining insertion points, 1044
associating with cables, 662 display rules in Domain Explorer, 242
common tasks, 654 dissociating from instruments, 1056
copying to another cable, 664 dissociating loop block, 1048
customizing terminology, 657 icons in the Domain Explorer, 1036
editing, 663 logo and border blocks, 1056
editing sections, 661 overview, 1034
overview, 652, 653 reassigning dissociated blocks, 1052
setting options, 656 shipped blocks, 1039
standard positions, 658 updating block assignments, 1052
standard widths, 658 user-defined general blocks, 1057
cables working with, 1041
adding connectors, 481, 918 CAD loop drawing generation
adding sets to cables, 483 macros, 1094
applying a cable structure, 487 per instrument block, 1079
applying reference cables, 486 per loop, 1079
assigning drums automatically, 672 per page, 1079
assigning drums manually, 672 CAD loop drawing history
associating with pulling areas, 669 deleting generation history records, 1083
associating with routing section, 662 displaying generation history, 1082
cable hierarchy in Domain Explorer, 241 showing latest generated drawing, 1081
common tasks, 472 CAD loop drawings
connecting device cables in batch mode, 573 assigning drawing blocks to pages, 1055
connecting to terminal strips, 571 associating external drawing, 1069
creating, 479 client and vendor approvals, 1067
creating home-run cables, 895 common tasks, 1077
cross wiring, 614 date formats, 1061
defining a configuration, 475 defining insertion points for blocks, 1044
deleting a configuration, 478 dissociating external drawing, 1069
device cables, 524 generation error report, 1084
disconnecting, 577 generation prerequisites, 1071
display adjacent connections, 582 generation principles, 1071
display farthest connections, 582 generation procedure, 1079
editing, 482 maintaining document references, 1066
editing a configuration, 476 maintaining revisions, 1064
examples of farthest connections, 583 multi-drawings, 1062
fieldbus cables common tasks, 895 multi-page drawings, 1063
filtering in Explorer, 263 page size of SmartSketch drawings, 1079
moving to other terminals, 576 TagAsMacroName parameter, 1071
overview, 471 updating paths, 1067
renaming device cables in batch mode, 525 viewing drawing blocks, 1043
spur cables, 896 viewing external drawing, 1069
telecom, 967 CAD paths
view connection destination, 581 AutoCAD, 1073
without sets and wires, 486 long paths, 1073
CAD drawing blocks MicroStation, 1073
actions in Domain Explorer, 242 SmartSketch, 1073
adding to block type, 1042 updating for CAD loop drawings and blocks, 1067

Index
updating for hook-up drawings and blocks, 1150 common tasks, 1203
calculation copying process data range values, 1202
batch calculation, 1310 custom fields, 1204
calculating a control valve, 1306 errors and points, 1204
calculating a relief valve, 1303 scale definition, 1204
common tasks, 1295 set point, 1206
creating new tags, 1317 cases, 1312, 1313
editing a calculation item, 1292 calculating, 1312
flow coefficient standard, 1306 hybrid case, 1313
fluid definition, 1293 multiple, 1260, 1261, 1262, 1263, 1264
hybrid case, 1313 CENTUM CS 3000
multi-case, 1312 terminology differences, 1572
Thermowell, 1309 CENTUM CS 30000 interface, 1571
viewing a calculation item, 1292 change
calculation item reports line type, 429
generation principles, 1314 changed documents, 103
Calculation module changing
overview, 1290 schema, 1631
starting, 1291 tasks, 1676
Calculation module reports channels
Calculation Item, 1315 assigning instruments, 594
calculation sheets, 1292, 1295 assigning segments, 594
calculation common tasks, 1295 associating with pins, 920
editing a calculation item, 1292 associating with terminals, 920
opening, 446 creating, 595
viewing a calculation item, 1292 displaying in panel-strip reports, 684
calibration errors, 1219 finding for I/O assignment, 603
as found, 1219 claiming
as left, 1219 common tasks, 220
calculation formulas, 1219 copying items to Claim Buffer, 223
square root extraction, 1219 device panels,, 224
calibration failure equipment in Browser module, 226
action codes, 1208 exclusive claim mode, 216
damage codes, 1209 lines in Browser module, 226
diagnostic codes, 1210 loops in Browser module, 226
calibration history non-exclusive claim mode, 216
generating reports, 1228 overview, 216
maintaining, 1224 tags in Browser module, 225
Calibration module tags in Instrument Index module, 225
Calibration module windows, 1197 To Do List, 1673
common tasks, 1195 using Domain Explorer, 224
flow of activities, 1195 CMPNT_CAT_ID mapping, 1454
overview, 1194 comparing data
starting, 1196 in the Merger Utility, 1721
calibration reports comparison list
generation, 1227 analyzing Merger comparison reports, 1735
history reports, 1228 common tasks, 1716
calibration results customizing Merger Comparison List display,
deleting, 1225 1748
recording in tag calibration history, 1214 defining style, 1720
result codes, 1211 displaying, 1721
viewing and editing, 1226 displaying specific columns to merge, 1729
calibration settings filtering Merger Comparison List data, 1728
alarm and trip levels, 1205 import options, 1419, 1436, 1438, 1451, 1463,
calibration ranges, 1204 1470, 1473, 1474, 1475, 1476, 1477, 1478,
clearing ranges, 1207 1483, 1487

Index
importing data, 1479 disconnecting cables and wires, 577

Merger data for child item types, 1730 display adjacent connections, 582
Merger group mode selection of source data, 1723 display farthest connections, 582
Merger multi-session mode, 1733 displaying, 447
options, 1719 examples of farthest connections, 583
overview, 1462 generating reports, 586, 682
printing source and target rows, 1479 moving cables and wires to other terminals, 576
selecting individual item types to merge, 1727 overview, 564
selecting source data to merge, 1715 PDF panel-strip reports, 683
sorting Merger Comparison List data, 1729 removing jumpers, 579
comparison of data tracing signals, 584
comparing with saved spec, 819 updating, 581
comparing with spec revision, 818 view cable destinations, 581
spec data comparison common tasks, 815 connectors
comparison options adding to amplifiers, 977, 981
merger comparison criteria, 1687 adding to cables, 481, 918
comparison options for import adding to switches, 981
common tasks, 1469 assigning connector pins, 919
complex analyzers defining connector types, 916
defining, 1268 deleting, 920
flow of activities, 1266 deleting connector types, 917
fluid components, 1267 hub connecors, 987
line components, 1267 intercom connecors, 990
linking stream and line components, 1269 panels with terminals and connectors, 504
overview, 1265 pin configuration, 916
COMPONENT table control system tags
importing line P&ID drawing references, 1514 adding in I/O Assignment, 596
importing tag properties, 1514 coupling with instruments, 598
supporting table references, 1512 creating in standard browser view, 597
composite specs CS tag alias, 380
duplicating, 793 decoupling instruments and CS tags, 599
features not supported, 793 deleting, 599
loop composite spec, 798 filtering in I/O Assignment window, 600
overview, 793 renaming, 598
removing instruments, 800 control valves, 1306, 1318
removing sections, 800 calculating, 1306
title block assignment method, 801 flow coefficient standard, 1306
with multiple instruments, 795 recommended characteristics, 1318
with process data cases, 796 Controller/Processor header in I/O Card Properties,
computed values in spec fields 542
defining field with computed values, 731 conventions
showing revision numbers, 733 KKS, 1384
configuring copy
Adobe Acrobat, 1615 instrument tags, 394, 395
Ghostscript, 1615 line data, 430
connection types tag numbers, 394, 395
defining, 567 typical loop, 417
examples, 569 copy profile data
connections instrument types, 380
adding jumpers, 578 copying spec data
common tasks, 565 common tasks, 809
connecting cables to terminal strips, 571 from form data template to spec, 812
connecting device cables in batch mode, 573 from one spec to another, 813
connecting wires to terminal strips, 575 from spec to form data template, 810
connection types, 567 overview, 808
device panel connections, 447 protecting fields from overwriting, 810

Index
create displaying field names in spec page, 709

line type, 428 duplicating in spec page, 736
criticality editing spec page field headers, 730
adding values, 402 formatting spec page field values, 734
associating, 402, 404 generating spec reports by field name, 856
cross wiring setting tab order in spec page, 715
automatic, 611 spec form browser, 750
cables, 614 spec_note_large column, 712
common tasks, 606 with computed values in spec page, 731
manual, 607 data formats
overview, 605 Save As options, 118, 119, 120, 130, 1029
panel-strip reports, 614, 682 data import
preferences, 579, 611 calculation sheet revisions, 1525
semiautomatic, 609 CMPNT_CAT_ID mapping codes, 1454
CS tags common error messages, 1532
adding in I/O Assignment, 596 fluid state mapping codes, 1457
coupling with instruments, 598 import mode parameters, 1426, 1428
creating in standard browser view, 597 importing instrument index, 1512
CS tag alias, 380 importing lines, 1512
decoupling instruments and CS tags, 599 importing P&ID drawing reference, 1512
deleting, 599 importing supporting table data, 1512
filtering in I/O Assignment window, 600 mapping codes for wiring data, 1458
renaming, 598 multi-tag specs, 1521
custom process data sheet, 1517
calibration fields, 1204 process data sheet revisions, 1525
custom browser, 338, 1366 process function mapping codes, 1456
custom fields refresh parameters, 1434
assigning drop-down data windows, 739 REVISION table, 1524
custom title block, 122 spec creation, 1517
documents, 122 SPEC_SHEET_DATA table, 1519
in the Process Data window, 1238 database
of wiring equipment in spec page, 737 creating profiles in InfoMaker, 1357
revisions, 122 drop-down data windows, 741
viewing PSR user-defined fields, 136 executing SQL statements in InfoMaker, 1358
custom hierarchy, 1632 structure, 1354
custom tables, 76 database dables
create report, 455 displaying data in InfoMaker, 1358
managing custom tables, 76 database tables
custom title blocks enabling reference tables for import, 1430
associating with SmartPlant Instrumentation, 1613 table column display for import, 1434
customization requirements, 122 database views
customizing in InfoMaker, 804 associating with specs, 735
editing properties, 126 databases, 1395
field descriptions, 122 databases supported by Import Utility, 1395
modifying for specs, 806 date formats
overview, 121 CAD loop drawings, 1061
updating for specs after upgrade, 807 maintenance event records, 1191
custom views DCS panels
defining for Domain Explorer, 268 associating with Profibus DP segment, 937
defining for Reference Explorer, 268 creating, 501
customize manufacturer-specific labels, 76
instrument tag name template, 389 DCS vendors, 1599
loop name template, 368 configuring for file mode, 1575
tag number name template, 389 overview, 1571
data fields prerequisites, 1573
deleting from spec page, 737 viewing the log, 1601

Index
DEF_FLG, 1458 groups, 1327, 1328

deferring overview, 1320
tasks, 1680 printing data sheets, 1351
delete printing empty sheet forms, 1352
instrument tags, 396, 397 process connection class, 1324
line type, 431 dimensional data sheets
loop numbers, 369 publishable groups, 1662
loops, 369 dimensional groups
tag numbers, 396, 397 printing empty sheet forms, 1352
typical loops, 422 Distiller printer driver
deleting testing configuration, 1624
tasks, 1680 distribution frames
DeltaV creating, 971
associate fieldbus device types, 1599 in Domain Explorer, 958
crucial fields, 1585 document binder, 996
data limitations, 1578 common tasks, 999
flow of activities, 1576 Document Binder module
publishing data, 1588 starting, 1001
retrieving data, 1583 Document Binder module reports
retrieving definitions, 1582 Change Summary, 1017
terminology differences, 1572 document creation
DeltaV interface, 1571 common tasks, 450
de-multiplexing tag signals, 644 overview, 449
device cables document headers
connecting in batch mode, 573 editing, 120
creating, 524 document management
creating in standard browser view, 520 common tasks, 999
filtering in Explorer, 264 revisions common tasks, 1020
device panels document numbers
associating instruments, 523 defining for hook-up drawings, 1145
automatic configuration, 514 defining for specs, 703
claiming, 224 importing for multi-tag spec, 1521
common tasks, 511 importing for process data sheets, 1517
copying to Claim Buffer, 223 importing for specs, 1517
copying to Merge Buffer as Merge Now, 227 opening hook-up reports, 1164
copying to Merge Buffer as Release Claim, 228 documents
creating, 499 associating external documents, 1007
creating device cables, 524 defining spec document numbers, 703
creating in standard browser view, 520 dissociating external documents, 1007
displaying connections, 447 Document Browser view, 347
dissociating instruments, 523 modifying document numbers, 347
editing plug-and-socket boxes, 901 previewing, 111, 1007
for instruments, 521 printing, 113
manual configuration, 516 printing to .pdf files, 114
multi-input with terminals, 947 REF_NAME macro, 1088
overview, 509 references in hook-up drawings, 1148
plug-and-socket multi-input device panel, 946 retrieving, 1668
pre-assigning junction boxes, 620 revision archive, 97
principles, 510 revision management common tasks, 86
renaming device cables, 525 revision management overview, 84
with plug-and-socket connections, 899 saving, 118
device types saving in .dxf format, 119
telecom profile defaults, 963 viewing associated documents, 1007
dimensional data for piping documents numbers
connection end preparation, 1325 modifying in a browser view, 347
forms, 1330 domain explorer

Index
changing tag-loop, 410 typical loop properties, 421

Domain Explorer typical tag properties, 422
arrangement of telecom items, 958 edit data
association rules, 249 common tasks, 433
cable hierarchy, 241 overview, 432
claiming As-Built items, 224 editing
common tasks, 232 tasks, 1676
creating items, 254 editing line process data
custom views, 268 fluid, 1256
deleting items, 255 selecting a pipe standard, 1255
dragging items, 249 electrical equipment
drawing blocks, 242 actions in Domain Explorer, 244
duplicating items, 254 display rules in Domain Explorer, 244
editing item properties, 255 electrical tags, 388
electrical equipment, 244 Emerson DeltaV i,nterface, 1571
features, 230 enhanced reports, 469
filtering items, 261 associating symbols with items, 469
filtering items according to item name, 260 equipment
finding a specific item, 259 wiring equipment common tasks, 528
hook-ups, 244 wiring equipment overview, 526
item status indicators, 253 error messages, 1310
loops, 246 batch calculation, 1310
moving itmes, 255 messages related to data import, 1532
My List, 267 printing binder package, 1031
overview, 230 Excel
panels by category hierarchy, 239 defining tables for data import, 1417
panels by location hierarchy, 241 font style of specs, 831
searching for items, 257 global value display precision, 840
showing browser in Items pane, 267 macro security requirement, 831
tree view structure, 236 Save as Excel overview, 831
DP instruments saving specs in batch mode, 827
creating, 886 saving specs in Excel format, 827
drawing setting macro security, 844
drawing report, 453 spec customization common tasks, 832
drawing blocks spec customization guidelines, 834
actions in Domain Explorer, 242 executing
display rules in Domain Explorer, 242 tasks, 1676
drawing generation methods Explorer
applying to hook-ups, 1144 Domain Explorer common tasks, 232
default, 1154 overview, 229
default method, 1145 Reference Explorer common tasks, 270
viewing, 1144 export
drop-down data windows process data files, 1280
adding in .psr files, 739 Save As options, 118, 119, 120, 130, 1029
units of measure, 741 Export Schema Configuration Utility, 1653
duplicate exporting spec data
instrument tags, 394, 395 overview, 823
loop numbers, 359, 1253 protecting fields, 828
tag numbers, 394, 395 external documents
typical loop, 417 associating, 458
edit common tasks, 457
instrument tag properties, 392 opening, 458
line data, 427 overview, 456
loop numbers, 362 remove, 459
tag data, 438 viewing, 460
tag number properties, 392 external macros

Index
assigning data sources, 1113 editing columns in single-tag specs, 759

connecting to external data source, 1109 file mode
connecting to non-ODBC data source profile, 1112 configuring, 1575
connecting to ODBC data source profile, 1111 filter (Explorer)
data source connection prerequisites, 1110 device cables, 264
naming conventions, 1107 filtering cables, 263
overview, 1106 filtering items, 261
structure conventions, 1108 filtering items according to item name, 260
field devices, 499 filtering loops, 265
conventional, 966 filter settings
plug-and socket, 967 clearing view filter, 335
field tags defining filter view, 331
creating, 964 displaying filter conditions, 331
duplicating, 965 duplicating view filter, 334
field values modifying view filter, 333
setting a date range, 445 find
tracking changes, 445 value in a column, 440
fieldbus finding
brick assemblies common tasks, 909 SmartPlant Instrumentation documents to publish,
brick assemblies overview, 908 1660
changing segment instrument association, 893 finding loops
configuring apparatuses, 912 all loops in a unit, 62
connections and associations common tasks, 914 common tasks, 57
creating brick assemblies, 910 overview, 56
creating home-run cables, 895 typical loops, 64
creating I/O cards, 924 using search parameters, 62
creating segments, 891 finding tag numbers
creating spur cables, 896 in the Calibration module, 1198
device type associations, 1599 finding tags
dissociating from instruments, 893 all tags in a unit, 58
editing fieldbus segments, 892 common tasks, 57
Fieldbus Tag Numbers Browser, 883 overview, 56
flow of activities, 870 typical tags, 61
function block overview, 879 using search parameters, 59
I/O assignment, 925 flow coefficient standard, 1306
instrument type profiles, 885 flowmeters, 1296, 1297, 1299, 1301
instruments, 886 calculating a restriction device, 1301
managing cables common tasks, 895 calculating a tube flowmeter, 1299
multi-input devices, 944 calculating an orifice, 1297
overview, 869 preparing for calculation, 1296
plug-and-socket boxes overview, 897 fluid definition, 1293
preliminary definitions common tasks, 874 fluid state import mapping codes, 1457
Profibus DP segments, 935 Fluke interface
Profibus PA segments, 935 overview, 1229
segment wiring report, 930 Fluke Interface
segment-wide parameters, 875 downloading data, 1230
segment-wide parameters example, 878 uploading data, 1232
terminators, 903 folders in Domain Explorer, 236
terminators common tasks, 904 form browser
validation overview, 926 adding new browser, 340
validation report for a segment, 928 form data templates
validation report for multiple segments, 929 common tasks, 756
view in Fieldbus Tag Numbers browser, 894 copying data from specs, 810
fieldbus specs copying data to specs, 812
adding function block custom fields, 738 creating, 756
editing columns in multi-tag specs, 769 modifying, 756

Index
overview, 755 template, 1010

protecting fields from overwriting, 810 generate documents
formats for multi-tag specs overview, 449
changing for existing specs, 787 generating documents
common tasks, 782 common tasks, 450
creating, 783 generic PostScript printer
deleting, 786 configuring, 1616
modifying, 784 Ghostscript
overview, 781 configuring for SmartPlant Foundation, 1615
print layout, 787 installing, 1615
regenerating, 786 printer options, 115
Foundation Fieldbus global revisions
brick assemblies common tasks, 909 adding, 88
brick assemblies overview, 908 common tasks, 86
configuring apparatuses, 912 deleting, 94
connections and associations common tasks, 914 filtering items, 87
creating brick assemblies, 910 managing spec revisions, 817
creating home-run cables, 895 overview, 85
creating I/O cards, 924 updating, 91
creating segments, 891 upgrade example, 93
creating spur cables, 896 upgrade settings, 90
Fieldbus Tag Numbers Browser, 883 upgrading, 92
flow of activities, 870 grid lines in specs
function block overview, 879 correcting horizontal divergence, 840
I/O assignment, 925 correcting line discontinuity, 839
instrument type profiles, 885 correcting vertical divergence, 840
instruments, 886 creating invisible vertical line, 838
overview, 869 replacing double lines, 839
preliminary definitions common tasks, 874 groups
segment wiring report, 930 dimensional, 1327, 1328
segment-wide parameters, 875 HART instruments
segment-wide parameters example, 878 creating, 940
validation overview, 926 flow of activities, 939
validation report for a segment, 928 I/O assignment, 943
validation report for multiple segments, 929 I/O cards, 943
function blocks, 882 instrument type profiles, 940
associating with instrument types, 881 overview, 938
associating with instruments, 889 virtual digital tags, 942
customizing, 880 history
enabling, 894 calibration history reports, 1228
overview, 879 deleting CAD loop drawing generation history,
supporting table, 882 1083
user-defined, 880 displaying CAD loop drawing generation history,
function requirement 1082
defining for a loop, 373 in the Process Data module, 1288
functional requirement maintaining calibration history, 1224
generating specs, 792 spec data, 820
general blocks home-run cables
assigning via instrument type, 1057 associating with segments, 922
border and logo blocks, 1056 connecting to plug-and-socket boxes, 921
general signals creating, 895
creating, 641 Honeywell
de-multiplexing tag signals, 644 associate fieldbus device types, 1599
linking tag signals, 642 retrieving definitions, 1598
multiplexing tag signals, 643 Honeywell interface, 1571
general specification notes hook-up drawings, 1144

Index
applying generation methods, 1144 hook-up types

assign a symbol, 1149 assigning to instrument types, 1130
assigning border and logo blocks, 1149 creating, 1128
changing output file names, 1145 deleting, 1138
clearing generation methods, 1144 hook-ups
client approvals, 1146 actions in Domain Explorer, 244
common tasks, 1142 assigning to sub-libraries, 1133
default generation method, 1145 associating instrument tags, 1131
document references, 1148 associating items, 1134
editing identifying fields, 1145 common tasks, 1126
file formats, 1151 creating, 1128
general drawing, 1139 deleting, 1138
generating enhanced hook-up drawings, 1153 display rules in Domain Explorer, 244
generating in CAD application, 1151 dissociating instrument tags, 1137
generating in mixed mode, 1154 dissociating items, 1136
generation overview, 1139 duplicating, 1128
generation scenarios, 1139 item list report, 1163
multi-page drawing, 1151 moving all to another hook-up type, 1132
output file name, 1151 overview, 1114
page size of SmartSketch drawings, 1151 tag list report, 1164
paths for drawings and blocks, 1150 hubs
revision display order, 1139 adding connectors, 987
revisions, 1147 adding ports, 987
symbols, 1144 creating, 986
vendor approvals, 1146 creating hub cabinets, 985
hook-up items hybrid case, 1313
associating with hook-ups, 1134 hybrid case specs, 767
calculating the total for BOM, 1160 I/O assignment
calculation formula, 1160 assigning instruments, 594
common tasks, 1117 assigning segments, 594
creating, 1120 canceling, 601
creating in batch mode, 1120 common tasks, 588
deleting, 1125 coupling CS tags with instruments, 598
displaying assigned pipe specs, 866 creating channels, 595
dissociating from hook-ups, 1136 creating CS tags, 596
duplicating, 1119 decoupling instruments and CS tags, 599
overview, 1115 enabling function blocks, 894
sorting in libraries, 1122 filtering CS tags, 600
hook-up libraries finding I/O channels, 603
actions in Reference Explorer, 275 for instruments, 591
common tasks, 1117 for segments, 593
deleting items, 1125 Foundation Fieldbus, 925
display rules in Reference Explorer, 275 generating reports, 601, 683
overview, 1116 HART instruments, 943
hook-up reports overview, 587
available reports, 1158 point-topoint wiring diagram, 584
Bill of Material, 1162 Profibus, 925
common tasks, 1161 tag preferences, 591
Hook-Up Item List, 1163 I/O cards
Hook-Up Tag List, 1164 associating with I/O terminations, 543
opening by selecting document numbers, 1164 common tasks, 923
overview, 1158 creating, 537
hook-up sub-libraries for Foundation Fieldbus, 924
actions in Reference Explorer, 275 for HART instruments, 943
display rules in Reference Explorer, 275 for Profibus, 924
overview, 1116 manufacturer-specific labels, 76

Index
panel manufacturer-specific headers, 542 SPEC_SHEET_DATA table, 1519

reference I/O cards, 277 import mapping codes
I/O terminations CMPNT_CAT_ID, 1454
associating with I/O cards, 543 DEF_FLG, 1458
creating, 282, 540 fluid state, 1457
icons in Domain Explorer, 253 process function, 1456
import link properties tag class, 1454
common tasks, 1423 upstream condition, 1457
hierarchy items, 1500 wiring data, 1458
import level, 1498 import methods, 1409
projects in links, 1501 import modes
tag and loop properties, 1431 Delete, 1426
import links Insert, 1426
arithmetic operators, 1453 Insert and update, 1426
assigning to more than one group, 1406 Move, 1426
common tasks, 1412 import process
complementary elements for instrument index, common tasks, 1491
1507 execute the import of data, 1496
defining in Excel, 1417 general prerequisites, 1489
defining links for naming conventions, 1447 importing large number of records, 1492
deleting, 1407 instrument type import prerequisite, 1506
dissociating from groups, 1407 prerequisites, 1396
duplicating, 1403 procedure, 1492
duplicating in Import Link window, 1405 running from command line, 1495
exporting to .imp files, 1420 running from user interface, 1494
file sources, 1416 testing, 1493
formulas, 1453 import source
importing from .imp files, 1421 assigning existing instrument types, 1510
Link Explorer, 1418 associating source data, 1439
matching naming conventions, 1490 common tasks, 1437
moving links, 1411, 1419 concatenated sources, 1515
moving to another group, 1406 filtering data fields, 1438
ODBC sources, 1413 instrument type import prerequisite, 1506
opening, 1448 setting instrument type fields, 1508
Oracle, 1415 sorting source data fields, 1439
overview, 1409 supported databases and file types, 1395
prerequisite for Microsoft Access, 1418 viewing source data, 1438
priority order, 1403 import sources
renaming, 1401 Excel, 1417
renaming in Import Link window, 1402 files, 1416
string operators, 1452 ODBC, 1413
using system codes, 1488 Oracle, 1415
import log files prerequisite for Microsoft Access, 1418
closing current log file, 1530 import target
creating, 1529 overview of table definitions, 1464
current log file name, 1530 import utility
logging import parameters, 1531 configuring source data, 1451
opening existing log file, 1529 importing data into multiple plant hierarchy, 1500
import mapping log files, 1528
CASE_NAME field, 1521 opening link properties, 1425
colors or target columns, 1449 primary keys, 1444
common tasks, 1446 Import Utility
defining, 1449 log files, 1530
multi-tag spec, 1521 overview, 1394, 1527, 1531
process function, 1449 starting, 1397
REVISION table, 1524 system codes, 1483, 1487

Index
importing data, 1434 concatenated instrument type fields, 1515

general prerequisites, 1489 importing lines, 1512
import mode parameters, 1426, 1428 importing specific properties, 1514
importing large number of records, 1492 importing supporting table data, 1512
instrument type import prerequisite, 1506 importing tag numbers, 1512
prerequisites, 1396 instrument type import prerequisite, 1506
process data files, 1278 matching naming conventions, 1490
refresh parameters, 1434 setting instrument type fields, 1508
importing spec data using preliminary functions, 1511
from external file, 829 instrument tags, 377
overview, 823 adding remarks, 393
to instrument specs, 830 adding tag categories, 403
importing specs assigning I/O, 447
common tasks, 1516 associate new loop, 410
Mudule method, 1517 associating external documents, 458
multi-tag specs, 1521 change instrument type, 401
Single table method, 1519 copying, 394, 395
InfoMaker counting rows, 443
adding drop-down data windows, 739 customizing tag names, 389
adding select lists, 740 deleting, 396, 397
building a query, 1364 duplicating, 394, 395
creating a library, 1361 editing properties, 392, 442
creating browsers, 338, 1366 editing tag categories, 403
creating database profiles, 1357 generate a list, 454
customizing title blocks for specs, 804 generate a report, 454
defining as default report generator, 1359 instrument type profile defaults, 377, 378
displaying SmartPlant Instrumentation tables, 1358 list, 454
enabling for SmartPlant Instrumentation, 1356 list available numbers, 454
executing SQL statements, 1358 loop association, 410, 411
opening .psr files from libraries, 1363 moving multiple tags, 398
opening spec pages, 729 moving to another unit, 397
overview, 1353 multiple, 409
saving customized reports, 1363 multi-row mode editing, 442
InfoMaker Libraries naming, 388
common tasks, 1360 new, 385, 387
installing opening an external document, 458
Adobe Acrobat, 1615 remove external document, 459
Ghostscript, 1615 renaming, 398
instrument blocks renaming options, 400
actions in Domain Explorer, 242 sorting tag rows, 441
display rules in Domain Explorer, 242 telecom field tags, 964
drawing generation per block, 1079 track field value changes, 445
overview, 1036 viewing associated documents, 460
instrument creation wiring and CS profile, 378
with auto-configured device panel, 514 instrument types, 377
with manually configured device panel, 516 appling profiles, 381
without a device panel, 518 assigning CAD drawing blocks, 1049
instrument index assigning existing instrument types, 1510
change tag-loop association, 411 assigning hook-up types, 1130
create custom table report, 455 associating with fieldbus device types, 1599
defining standard view, 437 associating with function blocks, 881
overview, 353 changing, 447
instrument index import common tasks, 375
assigning existing instrument types, 1510 concatenated source fields, 1515
common tasks, 1503 copying profile data, 380
complementatry elements, 1507 default profile, 377, 378

Index
define CS alias tag, 380 accessing Web, 1608

fieldbus instruments, 885 creating custom hierarchy, 1632
HART instruments, 940 deferring tasks, 1680
import prerequisite, 1506 define To Do List settings, 1675
overview, 374 defining schema, 1646
source fields in import link, 1508 deleting tasks, 1680
wiring and control system, 378 filtering tasks, 1679
Instrumentation Explorer installing Update Title Block Component, 1626
overview, 229 mapping DDP data, 1649
instruments mapping schema, 1630, 1641, 1648
adding CS tags, 256 overview, 1606
assigning CAD drawing blocks, 1051 publishable dimensional groups, 1662
assigning pipe specs, 863 publishing documents, 1654
assigning to channels, 594 refreshing, 1681
associating device panels, 523 reporting, 1681
associating with function blocks, 889 retrieving documents, 1668
associating with hook-ups, 1131 sorting tasks, 1679
associating with Profibus DP segments, 936, 937 task dependencies, 1678
associating with Profibus PA segments, 935 title blocks, 1609, 1611
associating with segment, 892 To Do List, 1673, 1675, 1676, 1678, 1680
base conditions, 1239 updating title blocks, 1610
calculating physical properties, 1247 intercom
changing segment association, 893 adding connectors, 990
copying CAD drawing blocks, 1053 intercoms
copying line process data, 1242 creating, 989
copying process data from other tags, 1241 creating cabinets, 988
coupling with CS tags, 598 interface language
creating and associating device cables, 524 common tasks, 78
creating device panels, 521 creating language files, 80
creating in Specifications module, 701 editing, 81
decoupling instruments and CS tags, 599 overview, 77
dissociating CAD drawing blocks, 1056 prefixes and suffixes, 83
dissociating device panels, 523 replacing from database, 79
dissociating from hook-ups, 1137 replacing from file, 79
dissociating from segment, 893 interface to SmartPlant Electrical
entering power supply data, 390, 505 create device panel, 1566
fieldbus instruments common tasks, 884 create tag signal, 1567
finding, 56 create wiring items, 1565
Foundation Fieldbus instruments, 886 overview, 1556
generate process data sheet, 452 power supplies, 1568
generating a report, 256 prerequisites, 1557
generating a specification, 256 publish, 1569
generating process data reports, 1285 retrieve, 1561
HART instruments, 940 signals, 1559, 1562, 1564
Hook-Up Tag List report, 1164 viewing tag numbers, 1563
I/O assignment, 591 interfaces, 1602, 1603
Instruments folder in Domain Explorer, 236 associate fieldbus device types, 1599
multi-input (plug-and-socket connections), 948 DCS vendors, 1571
multi-input (terminal connections), 950 Fluke, 1229
performing various actions, 256 NE-100, 1602, 1603, 1604, 1605
process data sheets, 256 SmartPlant Electrical, 1556
Profibus instruments, 886 intrinsic safety, 647
serial interface (plug-and-socket), 952 calculating, 647
serial interface (terminal connection), 953 calculating for loops, 651
insulation types, 1270 common tasks, 645
integration, 1606 creating a new circuit type, 647

Index
creating circuit types, 646 editing plug-and-socket boxes, 902

defining circuit cables, 650 generic junction boxes, 493
defining tags, 649 pre-assigning device panels, 620
item libraries telecom, 969
active item library, 1119 KKS
creating, 1118 importing line data, 1387
creating in batch mode, 1120 overview, 1384
creating items, 1120 propagation, 1388, 1389
creating sub-libraries, 1119 renaming items, 1393
deleting sub-libraries, 1125 scope, 1391
duplicating, 1118 language
sorting hook-up items, 1122 common tasks, 78
items, 260, 261 creating language files, 80
adding to custom view, 268 editing, 81
applying naming conventions, 468 overview, 77
associating with symbols, 469 prefixes and suffixes, 83
association rules in Domain Explorer, 249 replacing from database, 79
checking for duplicates, 1726 replacing from file, 79
claiming common tasks, 220 large note page
claiming for a project, 216 creating, 712
claiming items in Domain Explorer, 224 libraries in InfoMaker
copying As-Built items to Claim Buffer, 223 creating, 1361
copying items for merging as Merge Now, 227 for .psr files, 1362
copying items for merging as Release Claim, 228 opening .psr files, 1363
copying reference items, 257, 284 saving built queries, 1364
creating in Domain Explorer, 254 line type
creating reference items, 277 create or edit, 428
deleting, 255 line types
duplicating, 254 adding new, 1248
editing, 255 changing, 1250
filtering, 261 deleting, 1251
filtering according to item name, 260 editing properties, 1249
filtering for global revisions, 87 lines
Merger item type selection, 1711 adding in the Process Data module, 1252
merging common tasks, 220 adding line types, 1248
merging with As-Built, 218 assigning pipe specs, 864
moving, 249 changing line type, 429
moving in Domain Explorer, 255 common tasks, 426
name uniqueness of wiring items, 466 copying data to another line, 1257
reference items, 269 copying data to instruments, 1242
removing trailing separators, 470 copying line data, 430
renaming in KKS mode, 1393 create a line type, 428
revision management common tasks, 86 define pipe specifications, 431
revision management overview, 84 deleting, 431
searching for a specific item, 259 deleting pipe specs, 1273
searching for items, 257 dissociating pipe specs, 867
sequence uniqueness of wiring items, 466 edit a line type, 428
showing browser in Explorer Items pane, 267 editing line data, 427
status indicators in Domain Explorer, 253 line fluid velocity, 1259
using My List, 267 line ID in spec page, 721
jumpers line process data reports, 1284
adding, 578 modify pipe specifications, 431
merging, 1746 new, 427
removing, 579 overview, 425
junction boxes pipe specs in Process Data, 1272
creating plug-and-socket boxes, 900 process data - fluid, 1256

Index
properties, 1253 loop blocks

link groups actions in Domain Explorer, 242
All, 1398 associating with loops, 1048
assigning to more than one group, 1406 display rules in Domain Explorer, 242
common tasks, 1399 macro structure, 1038
creating, 1400 overview, 1038
deleting, 1408 loop drawing generation methods
deleting links, 1407 applying to loops, 1078
dissociating links, 1407 By Loop, 1070
duplicating links, 1403 By Signal, 1070
moving links, 1406 common tasks, 1077
overview, 1398 Custom by Loop, 1070
prioritize links, 1403 Custom by Signal, 1070
renaming, 1401 overview, 1070
renaming links, 1401 loop drawing history
link properties clearing temporary data, 1083
browser view styles, 1430 loop drawing reports, 1084
custom fields, 1432 loop drawings
import mode parameters, 1426, 1428 associating loop block, 1048
opening, 1425 common tasks, 1059
overview, 1422 dissociating loop block, 1048
reference tables, 1430 modifying identifying information, 1067
refresh parameters, 1434 single-page drawings, 1064
system codes, 1488 updating properties, 1058
table column display settings, 1434 Loop Drawings module overview, 1033
undefined NOT NULL fields, 1426 Loop Drawings module reports
local revisions CAD Loop Drawing Generation Errors, 1084
adding, 95 loop error
deleting, 96 calculating, 1222
editing, 96 overview, 1217
local signals setting tags, 1220
creating, 639 Loop Error Calculation Common Tasks, 1218
filtering tag numbers, 640 loop numbers
locations common tasks, 355
changing panel locations, 675 customizing loop name template, 368
defining panel locations, 674 deleting, 369
deleting panel locations, 676 duplicating, 359, 1253
dissociating panel locations, 675 editing, 362, 364
modifying panel locations, 674 editing multipe loops, 366
panel locations common tasks, 673 finding all loops in a unit, 62
panel locations overview, 673 finding loops using search parameters, 62
log file finding typical loops, 64
DCS vendors, 1601 function requirements, 373
log files moving to another unit, 361
.isf data import records, 830 naming, 357, 358
checking import log file name, 1530 new, 367
closing import log file, 1530 overview, 354
creating import log file, 1529 preferences, 371
import_isf.log, 830 properties, 364
logging import parameters, 1531 renaming, 370
opening import log file, 1529 renaming multiple loops, 372
logo blocks search options, 57
CAD loop drawings drawings, 1056 search options overview, 56
hook-up drawings, 1149 loops
logon passwords actions in Domain Explorer, 246
changing, 51 associate instrument tag, 410

Index
associate tag number,, 410 Maintenance module

change instrument tags, 410 access rights, 1166
change tag numbers, 411 breakdown maintenance, 1171
customizing loop name template, 368 creating a repair form, 1187
deleting, 369 defining PM activities, 1175
display rules in Domain Explorer, 246 defining PM attachments, 1173
duplicating, 359, 1253 defining PM tasks, 1174
edit properties, 364 entering PM data, 1180
filtering in Explorer, 265 extending existing scheduling, 1179
function requirements, 373 filtering maintenance activities, 1168
instrument tags, 410, 411 flow of activities for PM, 1182
instrument tags association, 410 issuing work requests, 1184
loop report, 455 opening work requests, 1185
loop summary, 455 overview, 1165
moving from one unit to another unit, 361 preliminary activities in PM, 1170
multiple instrument tags, 409 scheduling maintenance, 1177
multiple renaming, 372 starting, 1167
multiple tags, 409 Maintenance module reports
preferences, 371 generating maintenance reports, 1169
renaming, 370 mandatory calibration data, 1214
tag numbers association, 411 manufacturers (instruments)
Loops folder in Domain Explorer, 236 editing in specs, 763
macro definitions manufacturer-specific field headers, 76
overview, 1097 map file, 1628
macro function description, 1628
abbreviation, 1103 mapping schemas
creating user-defined functions, 1103 overview, 1627
default macro function, 1103 SmartPlant schema to tool schema, 1630
deleting, 1105 marshaling racks
modifying, 1105 creating, 495
standard, 1102 master tag, 775
standard macro function, 1103 merge actions
user-defined, 1100 merge now, 218
macros release claim, 218
CAD loop drawings, 1094 merger
creating definitions, 1098, 1156 merger utility common tasks, 1705
customized macro definitions, 1097 Merger
deleting definitions, 1099, 1157 analyzing comparison reports, 1735
external, 1106, 1107, 1108, 1113 Comparison List, 1715
external macro data sources, 1109 defining settings, 1708
generating report, 1093 filtering and sorting source table data, 1714
inserting in AutoCAD blocks, 1096 group mode selection of source data in the
loop blocks, 1038 Comparison List, 1723
loop title block, 1088 merging jumpers and cross wires, 1746
overview, 1085 merging supporting tables, 1738
structure, 1087 monitoring the data transfer process, 1731
wiring macro conventions, 1091 post-merge acrions, 1749
maintenance event records preliminary configuration, 1732
access rights, 1190 restoring saved PSR files, 1727
completing, 1193 running the Comparison List in multi- sessions,
creating, 1192 1733
date formats, 1191 selecting individual item types, 1727
deleting, 1193 selecting item types, 1711
description field, 1192 source table selection, 1711
flow of activities, 1190 specification forms that include custom title
overview, 1189 blocks, 1747

Index
specifying insertion conditions, 1712 fencing elements for cells, 1378

update mode, 1708 importing tag sets, 1375
merger utility linking tags to drawing elements, 1376
closing log files, 1690 long paths, 1073
configuring environment, 1684 microstation settings, 1370
creating a merger session, 1695 overview, 1368
creating log files, 1689 path settings, 1372
database platform support, 1683 prerequisites for running, 1372
deleting a merger session, 1696 report generation, 1383
deleting log files, 1691 SmartPlant Instrumentation parameters, 1372
duplicating a merger session, 1696 system requirements, 1369
log files, 1686 miscellaneous cabinets
matching source and target data, 1702 creating, 984
matching source and target data naming in Domain Explorer, 958
conventions, 1703 models (instruments)
matching source and target projects, 1702 editing in specs, 763
matching source domains, 1698 modifying
merger session common tasks, 1694 schema, 1631
opening a merger session, 1695 tasks, 1676
opening log files, 1690 modules
overview, 1682 opening, 52
preparing common tasks, 1689 move
renaming a merger session, 1695 instrument tags to another unit, 397
selecting a source domain from a non-ODBC loop from one unit to another unit, 361
database, 1701 multiple instrument tags, 398
selecting a source domain from the same ODBC multiple tag numbers, 398
database as the target domain, 1700 multiple tags, 398
selecting a target, 1694 tag numbers to another unit, 397
selecting source domains, 1698 multi-case process data, 1312, 1313
selecting the same source domain as the target calculation, 1312
domain, 1699 creating, 1261
selecting the source domain overview, 1697 deleting a case, 1264
setting comparison criteria, 1687 governing case, 1262
starting, 1684 hybrid case, 1313
the merge process overview, 1692 managing case names, 1263
viewing log files, 1690 overview, 1260
merging multi-drawings
common tasks, 220 assigning blocks to pages, 1055
copying to Merge Buffer as Merge Now, 227 defining CAD drawings as multi-drawings, 1062
copying to Merge Buffer as Release Claim, 228 multi-input devices
merge actions, 218 common tasks, 945
overview, 218 device panels with terminals, 947
merging data instruments (plug-and-socket), 948
comparing data, 1721 instruments (terminal connections), 950
Microsoft Access overview, 944
prerequisite for import links, 1418 plug-and-socket device panel, 946
MicroStation, 1369 serial interface (plug-and-socket), 952
adding cells to cell libraries, 1380 serial interface (terminal connection), 953
CAD settings, 1073 multi-page drawings
cell libraries, 1377 assigning blocks to pages, 1055
cell on the Desktop, 1382 defining CAD drawings as multi-page drawings,
cell origin, 1379 1063
cell origin coordinates, 1380 multiple loops
cell preview, 1381 editing, 366
creating tag sets, 1373 multiplexing tag signals, 643
exporting tag sets, 1374 multi-row mode

Index
editing properties, 442 generating, 791

multi-tag specs generation prerequisites, 790
adding a single tag, 773 overview, 789
adding tags in batch mode, 774 non-wiring instruments
changing format, 787 signal propagation, 638
common tasks, 770 notes
creating by data import, 1521 binder packages, 1009
editing, 774 notes in binder packages
formats common tasks, 782 form, 1010, 1011, 1013
generating, 772 general specification, 1008, 1010, 1011, 1013,
master tag, 775 1014
moving tag from single-tag spec, 763 notes in specs
moving tags to another see list, 777 adding notes and remarks, 701
moving tags to single-tag spec, 778 ODBC
overview, 769 selecting a merger source domain from ODBC,
overview of see list formats, 781 1700
removing tags, 779 ODBC source for import, 1413
title block, 802 Online Help conventions, 46
My List, 267 open
name calculation sheets, 446
customizing instrument tags, 389 external document, 458
customizing tag numbers, 389 specification sheets, 446
electrical tags, 388 supporting tables, 439
instrument tags, 388 opening
instrument tags renaming options, 400 Web Client, 1608
loop numbers, 357, 358 Oracle
renaming loop numbers, 370 data import source, 1415
renaming loops, 370 organizing
renaming multiple loops, 372 tasks, 1675
tag numbers, 388 PA cabinets
tag numbers renaming options, 400 adding amplifiers, 976
typical loops and tags, 424 creating, 975
naming conventions in Domain Explorer, 958
applying to wiring items, 468, 470 PA instruments
defining import links, 1447 creating, 886
item types supporting KKS, 1384 PABX cabinets
matching in import links, 1490 adding racks, 979
NE-100 interface, 1602, 1603 creating, 978
activate interface in SmartPlant Instrumentation, PABX racks
1603 adding switches, 980
common tasks, 1602 creating, 979
mapping from NE-100 to SmartPlant packages
Instrumentation, 1604 General Document Binder, 998
overview, 1602 Specification Binder, 997
publish SmartPlant Instrumentation data to NE- panels
100, 1605 adding racks, 507
retrieve data to SmartPlant Instrumentation, 1605 cabinets, 497
new, 405, 406 changing locations, 675
instrument tags, 385, 387 conventional panels common tasks, 491
line, 427 conventional panels overview, 490
soft tags, 405, 406 creating plug-and-socket junction boxes, 900
tag numbers, 385, 387 DCS panels, 501
new loop defining new locations, 674
during tag edit, 367 deleting locations, 676
non-instrument specs device panel overview, 509
common tasks, 790 device panel principles, 510

Index
device panels, 499 dissociating pipe specs, 867

device panels common tasks, 511 modifying properties, 862
dissociating locations, 675 overview, 860
DP-compatible panels, 936 pipes
editing plug-and-socket device panels, 901 material, 1271
editing plug-and-socket junction boxes, 902 selecting a pipe standard, 1255
entering power supply data, 390, 505 plant hierarchy
fieldbus panels common tasks, 898 custom, 1632
generic junction boxes, 493 PLC panels
in Domain Explorer, 236 associating with Profibus DP segment, 937
in Reference Explorer, 274 creating, 503
locations common tasks, 673 manufacturer-specific labels, 76
managing locations, 673 plug-and-socket boxes
manufacturer-specific labels, 76 common tasks for fieldbus, 898
marshaling racks, 495 connecting home-run cables, 921
modifying locations, 674 creating junction boxes, 900
panels by category hierarchy in Domain Explorer, device panels, 899
239 editing device panels, 901
panels by location hierarchy in Domain Explorer, editing junction boxes, 902
241 for fieldbus, 897
PLC panels, 503 panels with terminals and connectors, 504
plug-and-socket device panels, 899 point-to-point wiring diagrams
telecom panels common tasks, 968, 973 changing font size, 585
with terminals and connectors, 504 opening, 584
paper size viewing, 443
SmartSketch hook-up drawings, 1151 ports
SmartSketch loop drawings, 1079 adding to hubs, 987
specs, 694 adding to switches, 981, 982
passwords postponing
changing the logon password, 51 tasks, 1680
patch panels PostScript printer driver
creating, 972 configuring, 1616
in Domain Explorer, 958 testing configuration, 1622
paths power supplies
for MicroStation, 1372 entering data for instruments, 390, 505
PDF files entering data for panels, 390, 505
Acrobat Distiller options, 116 flow of activities, 1568
generating, 1615 powersoft browser
pins adding new browser, 340
assigning connector pins, 919 preferences
associating with channels, 920 CAD settings, 1073
connector type pin configuration, 916 cross wiring, 579, 611
pipe specifications customizing, 53, 137
defining, 431 displaying, 53, 137
modifiying, 431 general preferences common tasks, 53
pipe specs I/O assignment, 591
assigned to hook-up item sub-library, 866 intools ini file, 54, 137
assigned to hook-ups, 1133 loop numbers, 371
assigning to instruments, 863 preventive maintenance
assigning to lines, 864 defining attachments, 1173
associating with hook-up item libraries, 865 defining PM activities, 1175
defining, 862 defining PM tasks, 1174
defining in Process Data module, 1272 entering PM details, 1180
deleting, 868 extending existing scheduling, 1179
deleting in Process Data module, 1273 overview, 1182
dissociating from instruments, 863 preliminary activities, 1170

Index
scheduling maintenance, 1177 line process data reports, 1284

previewing documents, 111 modifying line data, 1253
print layout multi-case, 1260, 1261, 1262, 1263
defining for multi-tag specs, 787 propagating line data, 1243
testing for multi-tag specs, 787 selecting data for copying, 1244
print sheet size viewing, 1254
SmartSketch hook-up drawings, 1151 Process Data module
SmartSketch loop drawings, 1079 adding insulation types, 1270
specs, 694 adding tag numbers, 1236
printer settings external revisions, 1286
modifying, 117 overview, 1233
printing documents starting, 1235
Acrobat Distiller options, 116 workflow, 1234
details, 113 Process Data module reports
Ghostscript printer options, 115 for one line or instrument, 1283
overview, 110 generation pronciples, 1282
printing specs reports for instruments, 1285
sheet size for composite specs, 793 reports for lines, 1284
sheet size for specs, 694 process data sheets, 446
title block adjustment, 801 create for instrument, 452
printing specs and reports exporting, 1280
common tasks, 854 generate, 404
list of spec reports, 852 generate in browser view, 452
printing a spec report, 855 importing, 1278
printing a specification, 858 opening, 446
process analyzers process functions
complex analyzers, 1265 changing for instruments, 447
simple analyzers, 1265 codes for import, 1456
process data selecting for spec page, 714
fluid state mapping codes, 1457 sub-categories, 378
implementing Workflow, 107 Profibus
statuses for Workflow, 109 common tasks, 934
Workflow overview, 104 creating I/O cards, 924
Workflow prerequisites, 105 flow of activities, 932
process data cases function block overview, 879
generating hybrid case specs, 767 I/O assignment, 925
generating specs, 766 instruments, 886
process data for instruments overview, 931
calculating physical properties, 1247 segment-wide parameters, 875
copying from another tag, 1241 validation report for a segment, 928
deleting, 1246 validation report for multiple segments, 929
deleting cases, 1264 Profibus DP
differential pressure instruments, 1245 associating instruments with segments, 936, 937
editing, 1238 creating segments, 935
multi-case, 1260, 1261, 1262, 1263 DP-compatible panels, 936
process data for lines generating enhanced Profibus layouts, 937
adding line types, 1248 Profibus PA
adding new lines, 1252 associating instruments with segments, 935
changing line types, 1250 creating segments, 935
copying to instruments, 1242 generating enhanced Profibus layouts, 937
copying to other lines, 1257 segment wiring report, 930
deleting cases, 1264 validation overview, 926
deleting line process data, 1258 profile
deleting line types, 1251 applying to an instrument type, 381
fluids, 1256 project + As-Built
line fluid velocity, 1259 claiming equipment in Browser module, 226

Index
claiming items in Domain Explorer, 224 hook-up libraries, 275

claiming lines in Browser module, 226 I/O terminations, 282
claiming loops in Browser module, 226 moving items, 269
copying items for merging as Merge Now, 227 overview, 269
copying items for merging as Release Claim, 228 searching for items, 257
copying items to Claim Buffer, 223 showing browser in Items pane, 267
displaying As-Built data, 221 tree view structure, 274
tags in Browser module, 225 wiring equipment, 280
tags in Instrument Index module, 225 reference tables
projects enabling for import, 1430
importing to multiple projects, 1501 refreshing
propagation To Do List, 1681
KKS, 1388, 1389 regenerating
propagation of signals spec forms, 752
common tasks, 634 spec pages, 709
de-multiplexing tag signals, 644 relief valves, 1303, 1305, 1319
forcing, 636 calculating, 1303
general signals, 641 calculating sizing in case of fire, 1305
linking tag signals with general signals, 642 entering built-up back pressure, 1319
local signals, 639 remarks
manual, 637 adding to instrument tags, 393
multiplexing tag signals, 643 adding to tag numbers, 393
non-wiring instruments, 638 removing
possible cases, 632 tasks, 1680
re-propagating, 636 rename
properties instrument tags, 398
editing instrument tags, 392 tag number, 398
editing loop properties, 364 renaming items
editing tag numbers, 392 KKS, 1393
editing typical loops, 421 repair forms
editing typical tags, 422 creating, 1187
tasks, 1676 report comparison
PSR files comparing archived reports, 100
restoring for Merger, 1727 comparison color, 99
publish data, 1569 comparison font, 99
publishing currently previewed with archived, 101
documents, 1654 overview, 98
SmartPlant Instrumentation documents, 1657 report generation
query, 1364 from the Connection window, 586, 682
racks Spec Pages per Form, 751
adding slots, 507 report management
creating, 507 comparison options, 98
Reference Explorer editing report headers, 120
arrangement of telecom items, 958 previewing documents, 111
common tasks, 270 printing, 113
copying items, 257, 284 printing documents to .pdf files, 114
creating I/O cards, 277 saving, 118
creating items, 277 saving in .dxf format, 119
custom views, 268 viewing archived reports, 102
deleting items, 255 report types
duplicating items, 254 list, 84
editing item properties, 255 non-list, 84
features, 269 reporting
filtering items, 261 to do list, 1681
filtering items according to item name, 260 reports
finding a specific item, 259 channels in panel-strip reports, 684

Index
drawing report, 453 common tasks, 86

generating from the Domain Explorer, 256 converting spec revisions, 821
generating spec reports by date, 856 data import overview, 1523
generating spec reports by field name, 856 deleting global revisions, 94
loop summary, 455 deleting local revisions, 96
panel-strip from Cross Wiring, 614, 682 deleting specs in batch mode, 702
PDF panel-strip reports, 683 display order in hook-up drawings, 1139
process data sheets, 452 document binder revision archive, 1019
saving in InfoMaker, 1363 editing local revisions, 96
spec form field reports, 857 external revisions for process data, 1286
spec report list, 852 filtering items for global revisions, 87
spec reports common tasks, 854 global revisions, 85
specification sheets, 451 global upgrade example, 93
telecom, 991 hook-up drawings, 1147
wiring equipment in panel-strip reports, 684 importing into calculation sheets, 1525
reports (Calculation module) importing into process data sheets, 1525
Calculation Item, 1315 in the Calculation module, 1316
generation principles, 1314 in the Process Data module, 1286
reports (DDP module) managing spec revisions globally, 817
report descriptions, 1349 overview, 84
reports (Document Binder module) per document, 84
Change Summary, 1017 per item, 84
reports (hook-ups) printing spec revisions, 818
available reports, 1158 report types, 84
Bill of Material, 1162 spec revisions common tasks, 815
Hook-Up Item List, 1163 spec revisions overview, 814
Hook-Up Tag List, 1164 updating revisions globally, 91
opening by selecting document numbers, 1164 upgrade settings for global revisions, 90
reports (Loop Drawings module) upgrading global revisions, 92
macro reports, 1093 viewing archive, 97
reports (Maintenance module) viewing spec data history, 820
generating maintenance reports, 1169 saving data
reports (Process Data module) in .dxf format, 119
for one line or instrument, 1283 in various formats, 118, 130
reports for instruments, 1285 saving documents
reports for lines, 1284 editing headers, 120
reserving,revision numbers, 1665 in .dxf format, 119
restriction device calculation, 1301 in various formats, 118, 130
retrieve data, 1561 overview, 110
retrieving ZIP files, 1029
documents, 1668 saving specs
retrieving documents as Excel, 827
to SmartPlant Instrumentation, 1670 as Excel in batch mode, 827
revising batch save of instrument specs, 826
documents, 1665, 1666 in .isf format, 826
revision archive in .psr format, 825
binder packages in ZIP files, 1023 overview, 823
for binder package (overview), 1019 save options common tasks, 824
revision macro order, 1139 Schema Configuration Wizard
revisions, 1316 completing the schema configuration wizard, 1652
adding global revisions, 88 defining a new schema configuration, 1650
adding local revisions, 95 defining filter conditions, 1651
adding to binder package, 1021 defining object levels and restrictions, 1651
batch deletion of spec revisions, 822 overview, 1650
binder package, 1015, 1020, 1023 selecting a domain, 1650
CAD loop drawings, 1064 selecting a schema, 1650

Index
selecting document types, 1651 associating instruments with Profibus PA

selecting interface properties, 1652 segments, 935
selecting object interfaces, 1651 associating with home-run cables, 922
selecting object types, 1651 associating with instruments, 892
selecting schema options, 1650 associating with terminators in plug-and-socket
schema mapping boxes, 907
map file, 1628 associating with terminators on terminal strips, 907
schemas changing instrument association, 893
synchronizing, 1640 common tasks, 890
search options dissociating from instruments, 893
common tasks, 57 DP-compatible panels, 936
overview, 56 editing, 892
searching enabling function blocks, 894
for tag numbers in the Calibration module, 1198 Fieldbus Tag Numbers Browser, 883
searching for for Foundation Fieldbus, 891
all loop numbers, 62 generating enhanced Profibus layouts, 937
all tag numbers, 58 I/O assignment, 593
items in Explorer tree view, 257 Profibus DP segments, 935
items to open spec for, 700 Profibus PA segments, 935
loops using search parameters, 62 segment-wide parameters, 875
spec forms, 700 select lists, 75
specific item in Domain Explorer, 259 adding in .psr files, 740
specific item in Reference Explorer, 259 adding new values, 75
tags in see list, 775 assigning in InfoMaker, 740
tags using search parameters, 59 sequence
typical loops, 64 uniqueness of wiring items, 466
typical tags, 61 serial interface
sections instruments with terminal connection, 953
instrument composite spec, 795, 796 plug-and-socket instruments, 952
loop composite spec, 798 session
overview of composite specs, 793 creating, 1695
removing from composite page, 800 deleting, 1696
removing instruments, 800 duplicating, 1696
see list opening, 1695
adding tags, 774 renaming, 1695
changing columns header font, 776 sets (cable)
changing format, 787 adding cable sets, 483
editing, 774 connecting to terminal strips, 571
finding tags, 775 shipped data
formats common tasks, 782 CAD drawing block files, 1039
generating multi-tag spec, 772 fieldbus bricks, 910
master tag, 775 function blocks, 879
moving tag from single-tag spec, 763 instrument types, 374
moving tags to another see list, 777 signals
moving tags to single-tag spec, 778 common tasks, 634
multi-tag specs common tasks, 770 create wiring items, 1565
overview, 769 de-multiplexing tag signals, 644
overview of see list formats, 781 filtering tag numbers, 640
removing tags, 779 flow of activities, 1559, 1562, 1564
resizing columns, 776 forcing propagation, 636
title block, 802 from non-wiring instruments, 638
segments general signals, 641
assigning to channels, 594 linking tag signals with general signals, 642
associating DCS with Profibus DP segments, 937 local signals, 639
associating instruments with Profibus DP manual propagation, 637
segments, 936 multiplexing tag signals, 643

Index
point-to-point wiring diagram, 584 create new instrument, 385

propagation examples, 632 creating, 406
propagation overview, 631 loop drawings, 405
re-propagating, 636 new, 385, 405, 406
tracing, 584 workflow, 406
single-page drawings sort settings
modifying properties, 1064 displaying current setting, 323
single-tag specs sorting sequence, 323, 325, 326, 327
common tasks, 760 sorting
editing field values, 762 hook-up items, 1122
editing units of measure, 762 source
generating, 761 filtering and sorting Merger source table data,
moving tags from see list, 778 1714
moving to see list spec, 763 matching merger source and target data, 1702
overview, 759 matching merger source and target projects, 1702
saving in .isf format, 826 Merger group mode selection using the
saving in batch mode, 826 Comparison List, 1723
slots merger source domain selection, 1697
adding to racks in batch mode, 507 Merger source table selection, 1711
creating, 508 using the Comparison List to select source data to
SmartPlant Electrical data, 1087 merge, 1715
macro structure, 1087 source data for import
SmartPlant Electrical interface assigning existing instrument types, 1510
create device panel, 1566 associating source data, 1439
create tag signal, 1567 common tasks, 1437
create wiring items, 1565 concatenated sources, 1515
overview, 1556 instrument type import prerequisite, 1506
power supplies, 1568 setting instrument type fields, 1508
prerequisites, 1557 viewing, 1438
publish, 1569 source domain for merger
retrieve, 1561 selecting a source domain from a non-ODBC
signals, 1559, 1562, 1564 database, 1701
viewing tag numbers, 1563 selecting from the same ODBC database as the
SmartPlant Instrumentation target domain, 1700
changing the logon password, 51 selecting the same source domain as the target
general preferences, 53 domain, 1699
getting started, 48 source domain selection, 1697
navigating, 49 sp_style.pbl, 739
opening a module, 52 spec form data templates
opening another domain, 50 common tasks, 756
overview, 43 creating, 756
searching for loops, 56 deleting, 758
searching for tags, 56 modifying, 756
starting, 49 overview, 755
swtching to another unit, 51 protecting fields from overwriting, 810
SmartPlant Instrumentation Explorer spec forms
overview, 229 adding pages, 747
SmartPlant integration adapter, 1628 analyzer stream form 78, 780
SmartPlant schema assigning title block, 805
mapping overview, 1627 changing form assignment, 753
mapping to tool schema, 1630 changing form assignment in batch mode, 754
synchronizing, 1640 common tasks, 743
SmartSketch complex analyzer form 77, 764
CAD settings, 1073 creating, 745
paths, 1073 creating spec form browser fields, 750
soft tags, 385, 405, 406 deleting, 751

Index
editing properties, 746 duplicating data fields, 736

hybrid case form 76, 767 editing field headers, 730
listing form pages, 751 formatting column values, 734
overview, 742 large note page creation, 712
regenerating library forms, 752 listing forms using the page, 709
removing pages, 748 listing pages included in a form, 751
restoring library forms, 752 opening, 708
searching for, 700 opening from external file, 708
sorting pages for print order, 749 opening in InfoMaker, 729
spec generation overview, 704
analyzer stream spec, 780 regenerating, 709
complex analyzer spec, 764 removing from spec form, 748
functional requirement specs, 792 retrieving as .psr files, 716
hybrid case specs, 767 saving as files, 710
multi-tag specs (see list), 772 saving to database, 710
non-instrument specs, 791 selecting different process function, 714
prerequisites for non-instrument specs, 790 setting field tab order, 715
principles, 695 showing revision numbers in changed fields, 733
single-tag spec, 761 sorting within spec form, 749
specs with tag cases, 766 spec revisions
spec import adding, 816
Mudule method, 1517 common tasks, 815
multi-tag specs, 1521 comparing data with saved spec, 819
process data sheet document, 1517 comparing spec data with revision, 818
Single table method, 1519 deleting, 816
spec page graphics deleting in batch mode, 822
adding lines, 718 editing, 816
adding to spec page, 723 managing globally, 817
common tasks, 717 overview, 814
defining line ID, 721 showing revision numbers in changed fields, 733
duplicating lines, 722 storage methods, 821
modifying line length using arrow keys, 719 viewing and printing, 818
modifying line length usng the mouse, 720 viewing spec data history, 820
modifying position using arrow keys, 725 spec title block assignment methods, 801
modifying position usng the mouse, 725 spec types
modifying size using arrow keys, 725 composite specs, 793
modifying size usng the mouse, 725 descriptions, 695
selecting line color, 721 instrument composite spec, 795, 796
selecting line style, 721 loop composite spec, 798
selecting line thickness, 721 spec_note_large column, 712
setting line X and Y coordinates, 719 SPEC_SHEET_DATA table
setting X and Y coordinates, 724 data import, 1519
spec pages import link properties, 1519
adding drop-down data windows, 739 Specification Binder packages
adding select lists, 740 assigning spec sheets to, 1002
adding table columns, 734 removing all spec sheets, 1006
adding to spec form, 747 removing selected spec sheets, 1004
common tasks, 705 removing single spec sheets, 1005
customization common tasks, 726 specification reports
customizing for Save as Excel, 834 change notification, 1018, 1024
default tab order, 715 specification sheets
defining fields with computed values, 731 generate a report, 451
deleting, 711 generate specification sheet, 451
deleting columns, 737 open, 446
displaying data field names, 709 removing from Specification Binder package,
displaying invisible fields, 731 1004, 1005, 1006

Index
specprn.psr, 852 spur cables

specs creating, 896
adding notes and remarks, 701 example of segment-wide parameters, 878
changing form assignment, 753 SQL functions, 1442
changing form assignment in batch mode, 754 SQL statements
deleting in batch mode, 702 creating custom browser in InfoMaker, 338, 1366
generating in batch mode, 698 executing in InfoMaker, 1358
modifying custom title blocks, 806 standard browser view
opening from Instrument Index Browser, 699 creating CS tags, 597
opening from the Specifications module, 700 creating device panels and cables, 520
overview, 694 standard positions (cable routing)
print sheet size, 694 adding, 658
printing, 858 deleting, 658
printing into .pdf files, 859 editing, 658
save options common tasks, 824 maximum number of cables, 659
specs (non-instrument) standard width (cable routing)
generating, 791 adding, 658
generation prerequisites, 790 deleting, 658
overview, 789 editing, 658
specs (see list) style settings
adding a single tag, 773 clearing a view setting, 313
adding tags in batch mode, 774 creating a view, 311
changing columns header font, 776 displaying current style, 310
changing format, 787 duplicating views, 319
editing, 774 modifying, 314
finding tags, 775 print layout, 316, 318
generating, 772 printing style setting, 320
moving tags to another see list, 777 sub-libraries
moving tags to single-tag spec, 778 assigning hook-ups, 1133
overview of see list formats, 781 associating items, 1123
removing tags, 779 associating pipe specs, 865
resizing columns, 776 creating, 1119
title block, 802 deleting, 1125
specs (single-tag) displaying assigned pipe specs, 866
editing field values, 762 dissociating items, 1124
editing units of measure, 762 duplicating, 1119
generating, 761 summary
moving tags from see list, 778 loop summary, 455
moving to see list spec, 763 supporting tables, 65, 66, 67, 74, 75, 647, 882, 959
overview, 759 adding new values, 75
saving in .isf format, 826 common tasks, 66
saving in batch mode, 826 function blocks, 882
specs (tag cases) instrument type overview, 374
common tasks, 766 intrinsic safety, 647
generating, 766 list, 67
generating hybrid case specs, 767 merging, 1738
overview, 765 open active column, 439
Specs Default TB with PB Units.psr, 804 overview, 65
specs types Telecom, 74, 959
multi-tag (see list) specs, 769 switches
non-instrument specs, 789 adding connectors, 981
single-tag specs, 759 adding to PABX racks, 980
tag case specs, 765 symbols
splice panels associating with items, 469
creating, 970 system codes
in Domain Explorer, 958 adapting for SmartPlant Instrumentation, 1484

Index
assigning to import link, 1488 change loop association, 410, 411

common tasks, 1482 changing segment association, 893
list of codes, 1537 common tasks, 383
overview, 1481 copying, 394, 395
special characters, 1486 counting rows, 443
viewing current source system name, 1488 creating in Specifications module, 701
tab order in spec page customizing tag names, 389
setting field tab order, 715 deleting, 396, 397
switching to default tab order, 715 dissociating from hook-ups, 1137
zero numbers, 715 duplicating, 394, 395
table columns editing properties, 392, 442
add_spec9 table, 712 editing tag categories, 403
adding to spec page, 734 electrical, 1563
creating spec form browser fields, 750 fieldbus instruments common tasks, 884
displaying field names in spec page, 709 finding all tags in a unit, 58
displaying invisible fields in spec page, 731 finding tags using search parameters, 59
duplicating data fields in spec page, 736 finding typical tags, 61
editing spec page field headers, 730 Foundation Fieldbus instruments, 886
formatting spec page field values, 734 HART instruments, 940
generating spec reports by field name, 856 instrument type overview, 374
spec_note_large, 712 instrument type profile defaults, 377, 378
with computed values in spec page, 731 list available numbers, 454
tables moving multiple tags, 398
defining in Excel, 1417 moving to another unit, 397
tables in import target multiple tags, 409
overview of table definitions, 1464 multi-row mode editing, 442
tag case specs naming, 388
common tasks, 766 new, 385, 387
generating, 766 opening an external document, 458
generating hybrid case specs, 767 overview, 382
overview, 765 power supply data, 390, 505
tag category Profibus instruments, 886
associating, 402, 404 remove external document, 459
tag class renaming, 398
CMPNT_CAT_ID column mapping, 1454 renaming options, 400
source and target mapping, 1454 search options, 57
tag data search options overview, 56
editing tag data, 438 sorting tag rows, 441
tag edit telecom field tags, 964
creating new loop, 367 track field value changes, 445
tag loop association viewing associated documents, 460
common tasks, 408 target
overview, 407 matching merger source and target data, 1702
tag numbers, 377 matching merger source and target projects, 1702
adding in the Process Data module, 1236 selecting a merger target, 1694
adding remarks, 393 tasks
adding tag categories, 403 completing, 1678
assigning I/O, 447 deferring, 1680
associate new loop, 410 executing, 1676
associating external documents, 458 filtering, 1679
associating with function blocks, 889 modifying, 1676
associating with hook-ups, 1131 properties, 1676
associating with Profibus DP segments, 936, 937 refreshing, 1681
associating with Profibus PA segments, 935 removing, 1680
associating with segment, 892 reporting, 1681
change instrument type, 401 running, 1676

Index
sorting, 1679 creating, 982

To Do List, 1673, 1675 unassociated telephone numbers, 983
types, 1673 templates
updating, 1681 creating for spec forms, 756
Tb_mss.psr, 804 form note, 1010, 1011
Tb_ora.psr, 804 general specification note, 1010
Tbsample.psr, 804 protecting spec fields from overwriting, 810
telecom spec form data templates, 755
amplifiers, 976 terminal strips
arrangement of items in Explorer, 958 common tasks, 553
associating telephone numbers, 983 creating, 558
cables, 967 defining terminal configurations, 554
cables common tasks, 961 modifying terminal configurations, 556
connectors, 977, 981 moving to another panel, 559
conventional field devices, 966 overview, 552
creating field tags, 964 terminal configuration examples, 557
creating telephone numbers, 982 terminals
device type profile defaults, 963 adding a group, 561
devices common tasks, 961 adding to terminal strips, 560
distribution frames, 971 associating with channels, 920
duplicating field tags, 965 configuration examples, 557
flow of activities, 956 defining configurations, 554
hub cabinets, 985 editing, 562
hub connectors, 987 modifying configurations, 556
hubs, 986 selecting a graphic, 563
instruments common tasks, 961 terminators
intercom cabinets, 988 common tasks, 904
intercom connectors, 990 external terminator in plug-and-socket box, 905
intercom equipment, 989 external terminator on terminal strip, 905
junction boxes, 969 in plug-and-socket boxes, 907
miscellaneous cabinets, 984 internal terminators, 906
old equipment, 960 moving external terminators to other ports, 906
overview, 955 on terminal strips, 907
PA cabinets, 975 overview, 903
PABX cabinets, 978 test equipment
PABX racks, 979 managing, 1212
panels common tasks, 968, 973 overview, 1216
patch panels, 972 selecting, 1216
plug-and socket field devices, 967 Thermowell calculation, 1309
splice panels, 970 title blocks
switch ports, 981, 982 adjustment for printing specs, 801
switches, 980 assigning to spec form, 805
unassociated telephone numbers, 983 associating with SmartPlant Instrumentation, 1613
Telecom Equipment folder in Domain Explorer, 236 custom title block macros, 122
telecom reports customization requirements, 122
actual load, 995 editing properties, 126
common tasks, 991 in composite specs, 801
communication line report, 992 installing Update Title Block Component, 1626
field equipment, 994 integration, 1609
line numbers, 994 macros, 1088
signal levels, 995 multi-tag specs, 802
speaker load, 993 overview of custom title blocks, 121
telecom device types, 994 requirements for integration, 1611
telecommunication device lists, 993 spec title block assignment methods, 801
telephone numbers spec title block common tasks, 803
associating with channels, 983 spec title blocks overview, 801

Index
Tb_mss.psr, 805 batch loop creation, 419

Tb_ora.psr, 805 copying, 417
Tbsample.psr, 805 deleting typical loops, 422
updating for integration, 1610 duplicating, 417
title blocks (custom) editing properties, 421
customizing in InfoMaker, 804 finding, 64
modifying for specs, 806 typical loops and tags
updating for specs after upgrade, 807 common tasks, 413
title blocks of CAD loop drawings creating a typical loop, 415
client and vendor approvals, 1067 naming convention, 424
document references, 1066 overview, 412
revisions, 1064 verifying data, 420
to do list typical tags
task dependencies, 1678 editing, 423
tasks, 1673 editing properties, 422
To Do List, 1674 finding, 61
common tasks, 1674 UDF
completing a task, 1678 see custom fields, 122
deferring tasks, 1680 uniqueness
deleted tasks, 1680 names of wiring items, 466
filtering tasks, 1679 sequence of wiring items, 466
opening, 1675 unit
properties, 1676 moving loop to another unit, 361
remove a task, 1680 units
reporting, 1681 opening another unit, 51
sorting tasks, 1679 To Do List, 1673
updating, 1681 units of measure
tool schema adapting codes for import, 1485
mapping to SmartPlant schema, 1630 adding drop-down data windows, 739
synchronizing, 1640 drop-down data window descriptions, 741
Tool Schema list of codes, 1547
map file, 1628 units of measure for process data
track changes automatic conversion, 1276
field values, 445 copying defaults, 1277
tree view structure setting defaults, 1274
in Domain Explorer, 236 update mode
in Reference Explorer, 274 merging data, 1708
troubleshooting updating
binder packages, 1031 schema, 1631
troubleshooting (Save as Excel) to do list, 1681
common tasks, 842 upgrade
data saving problem, 845 updating custom title blocks for specs, 807
displaced labels, 848 user-defined sub-libraries
display of select lists, 851 assigning hook-ups, 1133
display of vertical fields, 850 associating items, 1123
function conversion problems, 849 associating pipe specs, 865
grid line overlap problem, 845 creating, 1119
overshooting of grid lines, 846 deleting, 1125
preparing Excel file for Intergraph Support, 851 dissociating items, 1124
removing protection, 845 user-defined views
spec accessing problem, 844 associating with specs, 735
text display in Excel cells, 849 validation
truncation of labels and values, 847 fieldbus validation common tasks, 928
undershooting of grid lines, 846 for fieldbus, 926
value display precision, 850 report for multiple segments, 929
typical loops report for one segment, 928

Index
views (Browser) principles, 462

adding a new view, 290 removing trailing separators, 470
changing instrument type, 447 reports common tasks, 677
changing process function, 447 signal propagation, 631
copying a view, 292 splitting wiring design, 463
default view, 288 wiring and control system
defining a view, 289 instrument type profile, 378
deleting, 294 wiring data import
duplicating a view, 291 mapping codes, 1458
finding, 295 reference wiring data import, 1458
hierarchy, 296 wiring diagrams
instrument index standard view, 437 viewing point-to-point, 443
modifing a profile, 292 wiring equipment
style settings, 308, 309 associating I/O cards with I/O terminations, 543
views in the Browser module common tasks, 528
in Fieldbus Tag Numbers browser, 894 creating, 280, 533
virtual tags custom fields in spec page, 737
creating digital tags, 942 customizing categories, 530
Web Client displaying in panel-strip reports, 684
accessing, 1608 I/O cards, 537
wires I/O terminations, 282, 540
adding, 484 overview, 526
applying regional colors, 489 reference I/O cards, 277
assign designations, 580 user-defined category properties, 532
connecting to terminal strips, 575 wiring items, 1565
disconnecting, 577 work requests
editing, 487 issuing a new work request, 1184
moving to other terminals, 576 opening, 1185
wiring workflow
apparatus common tasks, 546 implementing, 1234
apparatus overview, 545 Workflow
auto-wiring, 615 example scenario, 104
connections, 564 implementing, 107
creating a wiring scheme, 465 overview, 104
cross wiring, 605 prerequisites, 105
equipment, 526 process data statuses, 109
general definitions, 468 Yokogawa CENTUM CS 3000
intrinsic safety, 645 associate fieldbus device types, 1599
item hierarchy examples, 535 data limitations, 1592
item name uniqueness, 466 flow of activities, 1590
item sequence uniqueness, 466 publishing data, 1596
list of reports, 678 retrieving data, 1595
naming conventions, 468 retrieving definitions, 1594
overview, 461 Yokogawa interface, 1571

SPI User Guide PDF

Загружено:

Сведения о документе

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

SPI User Guide PDF

Загружено:

Авторское право:

Доступные форматы

SmartPlant Instrumentation

Version 2007.3 (8.0) September 2007 DINS-08.00.0001D

Restricted Rights Legend

Warranties and Liabilities

Working with SmartPlant Instrumentation: An Overview .........................................43

Searching for Tag and Loop Numbers: An Overview..................................................56

Supporting Tables: An Overview ...................................................................................65

Interface Languages: An Overview................................................................................77

Revision Management: An Overview.............................................................................84

SmartPlant Instrumentation User’s Guide 3

Global Revisions: An Overview......................................................................................85

Report Comparison: An Overview.................................................................................98

Workflow: An Overview ...............................................................................................104

Printing and Saving Documents: An Overview ..........................................................110

4 SmartPlant Instrumentation User’s Guide

Save the Current Document to a File .............................................................................. 118

Customizing Title Blocks for Reports: An Overview .................................................121

PSR Files .........................................................................................................................127

Displaying and Customizing Preferences ....................................................................137

SmartPlant Instrumentation User’s Guide 5

Wiring > I/O Assignment (Preferences) ......................................................................... 156

6 SmartPlant Instrumentation User’s Guide

Interfaces > DCS Vendors (Preferences) ........................................................................ 207

Claiming As-Built Items in a Project: An Overview ..................................................216

Preparing Project Items for Merging with As-Built: An Overview..........................218

Working with the SmartPlant Instrumentation Explorer: An Overview ................229

Working with the Domain Explorer: An Overview....................................................230

SmartPlant Instrumentation User’s Guide 7

Filter Cables in an Explorer Window ............................................................................. 263

Working with the Reference Explorer: An Overview ................................................269

Browser Module Overview............................................................................................285

Browser Manager Overview .........................................................................................286

8 SmartPlant Instrumentation User’s Guide

Style Settings: An Overview..........................................................................................308

Sort Settings: An Overview...........................................................................................321

View Filter Settings: An Overview...............................................................................328

Adding New Browsers: An Overview ..........................................................................336

Browser Views: An Overview .......................................................................................342

SmartPlant Instrumentation User’s Guide 9

Instrument Index Module: An Overview ....................................................................353

Managing Loop Numbers: An Overview.....................................................................354

Working with Instrument Types: An Overview .........................................................374

Managing Instrument Tags: An Overview..................................................................382

10 SmartPlant Instrumentation User’s Guide

Change an Instrument Type ............................................................................................ 401

Associating Instrument Tags with Loop Numbers: An Overview ............................407

Working with Typical Loops and Tags: An Overview...............................................412

Managing Lines: An Overview .....................................................................................425

Edit Data: An Overview ................................................................................................432

SmartPlant Instrumentation User’s Guide 11

View Point-to-Point Wiring Diagrams ........................................................................... 443

Generating Documents: An Overview .........................................................................449

Working with External Documents: An Overview.....................................................456

Wiring in SmartPlant Instrumentation: An Overview ..............................................461

Creating and Managing Cables: An Overview ...........................................................471

12 SmartPlant Instrumentation User’s Guide

Conventional Panels: An Overview..............................................................................490

Device Panels: An Overview .........................................................................................509

Wiring Equipment: An Overview ................................................................................526

Apparatus: An Overview ..............................................................................................545

SmartPlant Instrumentation User’s Guide 13

Terminal Strips: An Overview .....................................................................................552

Making Connections in SmartPlant Instrumentation: An Overview .......................564