Professional Documents
Culture Documents
Manual - Pdms Report
Manual - Pdms Report
Version 11.3
pdms1131/man8/doc1
Issue 290101
PLEASE NOTE:
Cadcentre has a policy of continuing product development: therefore, the information contained in this
document may be subject to change without notice.
CADCENTRE MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS DOCUMENT,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE.
While every effort has been made to verify the accuracy of this document, Cadcentre shall not be
liable for errors contained herein or direct, indirect, special, incidental or consequential damages in
connection with the furnishing, performance or use of this material.
This manual provides documentation relating to products which you may not have access to or which
may not be licensed to you. For further information on which products are licensed to you please refer
to your licence conditions.
All rights reserved. No part of this document may be reproduced, stored in a retrieval system or
transmitted, in any form or by any means, electronic, mechanical, photocopying, recording or
otherwise, without prior written permission of Cadcentre.
The software programs described in this document are confidential information and proprietary
products of Cadcentre Ltd or its licensors.
For details of Cadcentre's worldwide sales and support offices, see our website at
http://www.cadcentre.com/location
1 Introduction to Reports.....................................................................1-1
1.1 The Sample Report Templates .....................................................1-1
1.2 Before You Start............................................................................1-3
1.3 Starting to Use Reports ................................................................1-3
1.4 How to Use This Manual ..............................................................1-4
1.5 Running a Report from a Saved Template ...................................1-4
This manual assumes that you are familiar with PDMS to the
level of the Basic Training Course.
Most of the examples in this manual illustrate templates which
report directly on PDMS attributes and pseudo-attributes. You
can also use more complex expressions in report templates, and
although some of these are illustrated, you will need to be
familiar with PML, the Cadcentre Programmable Macro
Language, if you want to set these up for yourself.
For information about further training, please contact your
nearest Cadcentre Support Office (see the copyright page at the
front of this guide for details).
To use the sample templates supplied with the product, the
PDMS variable $PDMSREPDIR should be set to the directory
where the sample reports are stored.
You will usually have a library of report templates set up for you,
but you can produce and run a report template quickly by
selecting Reports>Create, filling in the New Report Template
form to specify what you want to report on and then pressing
Apply on the form, which will run the report.
Note that this is the easiest way of testing a template that you are
creating or modifying.
Hierarchy
Give a list of elements. The report will be output for all the
elements given, and all the elements owned by them.
2.1.1 Destination
2.1.2 Selection
The Selection options allow you to specify the type of item you
want to report on, and the level in the database hierarchy below
which the selection will be made.
2.1.3 Columns
Now create three columns for the report, to display the name of
the Nozzle, the arrive bore and the position, using the Columns
options.
1. Select the New option button, and the Creating Column form
will be displayed.
The Expression text box defines the contents of the column.
You can enter a PDMS attribute or pseudo-attribute here, or an
expression containing attributes or pseudo-attributes.
Ignore the Sorting and Precedence option for now. By
default, the list of items in the report will be sorted in the order in
which they are stored in the database.
You can set the Units option when appropriate.
The Column Layout button is used to control the format of
each column, but we will use the default layout for now.
Select Apply on the New Report Template form, which will run
the report.
The report will be output to a window: if you have an active
window displayed, for example the command line window, the
report will be displayed there. If there is no active window, a
new window will be opened.
The report should look like this:
Note that by default the text that you entered in the Expression
text box is used as the column heading. You can change this, as
described in Section 2.7.3, Text Display.
The layout of this report is not very easy to read, so now we will
use the option on the Layout for Column form to improve it.
Highlight POS in the list on the New Report Template form, and
select Modify. On the Modifying Column 3 form, select
Column Layout, and you will see the Layout for Column form.
Set the Spaces before Column option to 4, and set
Justification to Left. The output will look like this:
Now we will add two more columns to the report, for P1 CONN
and P1 DIR.
1. A new column is inserted before the one selected in the list on
the New Report Template form. To insert a column at the end
of the list of columns, make sure that the entry reading <end>
is highlighted, and select New again.
2. Enter P1 CONN into the Expression text box and set Units
to Off. On the Column Layout form, set justification to Left.
Select Next Column on the Creating Column form.
3. Enter P1 DIR into the Expression text box and set Units to
Off. On the Column Layout form, set justification to Centre
and select OK.
4. Select OK on the Creating Column form.
Now move the POS column so that it is the last (fifth) column
again.
File name allows you to specify the file where the report will be
stored. The only other options we have looked at so far are
Type(s) and Hierarchy.
1. Switch on File name, Type(s) and Hierarchy on the
Runtime Prompts form and select OK.
2. Now run the report again, by selecting Apply on the New
Report Template form. You will see the Report Details form,
with the values you have set on the Report Template form for
the three parameters displayed. You can now change them: for
example, enter a filename, and add other Equipments to
Hierarchy.
If you want to save the report template in a file, select one of the
options under File on the menu at the top of the New Report
Template form:
Save As allows you to save the template in a new file. A
File Browser will be displayed.
The parts of the database you want to include in the report are
specified by entering the elements at the top of each part of the
hierarchy in the Hierarchy text box on the New/Modify Report
Template form. The default is the World. If you just want to
specify one or two elements, you can just type in the element
names. The names must always be preceded by a slash and
separated by a space, because you can enter several names, for
example:
/100-B-1 /100-B-2
If you want to specify several elements, it is easiest to use the
Hierarchy form, which also allows you to report on all the
elements in a Volume, selected from the MDB, the Drawlist or
the Obstruction list.
2.6.3 From
The From options are used to specify where the Reports Utility
will look for the elements to report on:
MDB should be used if you are giving specific elements in
the Hierarchy.
Drawlist will select all elements in the drawlist. The
Hierarchy text box should be left blank.
Obstruction list will select all elements in the obstruction
list. The Hierarchy text box should be left blank.
2.7.1 Layout
Space before the HBORE column set to 2, and the column width
set to 15:
Values
For reports without sorting or totalling Values will normally be
On. For examples of the other options see Chapter 3, Sorting and
Totalling.
Subtotals and Totals
Totals can only be produced for columns containing numeric
data, and which do not have the Subtotal option set. For more
information, see Chapter 3, Sorting and Totalling.
3.3 Totalling
3.4 Subtotalling
===========
55236.56
For a sorted column, you can output only the first occurrence of a
value. For example, set the Values to 1st for the HBORE
column:
===========
55236.56
You can display each value for a sorted column next to the
corresponding subtotal value.
Set the Values option for HBORE (which must be sorted) to
Sub. Set the Centre Line Length Subtotals to 4, that is, show
subtotals for each value in column 4 (HBORE).
===========
55236.56
3.5 Quantity
4.2.1 WRT
'Q POS'
will return the position of the current element relatively to its
owner.
'Q POS OF /EQUIP1'
will return the position of EQUIP1 relative to its owner. If we
require the result in some other axis system then the WRT
keyword is used. e.g. 'Q POS WRT /*' for the position in world
coordinates.
When we specify a Cartesian coordinate we are dealing with a
relative position. For example, 'N 10' is meaningless until we
specify the axis system, or default to an axis system. Again we
use 'WRT' to do this, although it is important to note that in this
case we are going from a relative position to an absolute position
(in the previous example WRT was used to go from an absolute
position to a relative one). For example:
'N 100 WRT /BOX1'
specifies an absolute position in world space which is N100 of
/BOX1.
The default is that Cartesian coordinates are in the owning
element's axis system. This absolute position can be expressed in
different coordinate systems: the default is again the owner's axis
system.
Note: The CONSTRUCT syntax uses the world as the default
axis.
Example 1
Consider the following:
A SITE at (0,0,0) with default orientation
A ZONE at (100,0,0) with default orientation
An EQUIPMENT at (100,0,0) with orientation 'N IS E'
A BOX at (-100,0,0) with default orientation
4.2.2 FROM
4.4 Direction
4.5 Orientations
!date
Inserts today's date.
!time
Inserts the time.
These variables must be used together with the operators which
control late evaluation of variables. See Section 5.2.1, Late
Evaluation of Variables.
Both file reports and screen reports can have an Introduction and
Summary. You can insert whatever text and variables you want.
5.5 Examples
To insert the user’s name in the form of the text User Name:
followed by the name, use the PDMS global variable !!user:
'User name: ' + vtext(!!user)
To insert the date and time, use the report variables !date and
!time:
'Date: ' + vtext(!date) + ' ' + vtext(!time)
To insert a blank line, use:
''
To insert the hierarchy reported on, use:
'Nozzle Schedule for ' + vtext(!selhierarchy)
To insert the number of elements reported on, use, for example:
'Summary: ' + vtext(!selsize) + ' Nozzles in Schedule'