Académique Documents
Professionnel Documents
Culture Documents
User Manual
Copyright
Including software, file formats, and audio-visual displays; may be used pursuant to applicable software licence
agreement; contains confidential and proprietary information of CAXperts 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 authorisation.
Rights reserved under the copyright laws of the Federal Republic of Germany.
All warranties given by CAXperts 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. CAXperts 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. CAXperts is not responsible for any error that may appear
in this document.
The software discussed in this document is furnished under a licence and may be used or copied only in
accordance with the terms of this licence. THE USER OF THE SOFTWARE IS EXPECTED TO MAKE THE
FINAL EVALUATION AS TO THE USEFULNESS OF THE SOFTWARE IN HIS OWN ENVIRONMENT.
Trademarks
CAXperts is a registered trademark of CAXperts GmbH. Intergraph, the Intergraph logo, SmartSketch,
FrameWorks, SmartPlant, INtools, MARIAN, PDS, IGDS, RIS and IntelliShip are registered trademarks of
Intergraph Corporation. IGDS file formats ©1987-1994 Intergraph Corporation. Microsoft and Windows are
registered trademarks of Microsoft Corporation. Bentley, the Bentley logo “B,” and MicroStation are registered
trademarks of Bentley Systems, Inc. ISOGEN is a registered trademark of Alias Limited. Other brands and
product names are trademarks of their respective owners.
Table of Contents
I. Introduction.......................................................................................................... 3
II. Installation ............................................................................................................ 3
Uninstall
Setup command line (for administrators)
Licence
III. ReportAdapter for Smart® 3D .......................................................................... 6
Setting up ReportAdapter for Smart® 3D
Configure attributes
Geometry extraction
Extraction
Additional SQL statements
Settings
Command line mode
IV. Contact ................................................................................................................ 20
Helpdesk
Introduction
ReportAdapter for Smart® 3D is designed to export a Smart 3D attributes and graphics into a SQLite
database, containing one table per task. The resulting records are compressed and internally resolved by code
lists.
Installation
Requirements:
Administrator rights are required on each computer to install CAXperts ReportAdapter for Smart® 3D. “Run
as” is not supported.
Uninstall
To uninstall the software, select Control panel from the start menu. Then on in large or small icon view, click
Programs and features. If you're using category view, under Programs, click Uninstall a program.
Select the program you want to remove, and click Uninstall/Remove. Alternatively, right-click the program and
select Uninstall.
This command line option also has an optional INI file that can be passed containing session variable values.
For example:
"C:\output\setup.exe" "/S:C:\setupvars.ini"
This will cause the session variables in the INI file to be used for the setup. The INI file should be in the format:
[SetupValues]
%AppFolder%=C:\Program Files\MyProduct
CAXperts will need your Current domain name to issue a licence file (.lic).
The licence file has to be stored on a local or network location accessible by the machine running the CAXperts
product; a licence server is not required.
The location of the licence file should be defined on every machine with the CAXperts product installed, which
can be done
If the licence key file location is not defined, “C:\Program Files (x86)\CAXperts\Licensing\” is used
The licence key file may be renamed (including the extension). The CAXperts product will check the content of all files in
the licence folder(s) for valid keys.
Changes to the key path (in the environment variable or registry key) are read during the next start of the CAXperts
product.
Every running instance of the CAXperts software product will require one seat, no matter if the application is running
multiple times on the same or different machine(s).
New instances can only be started as long as seats are available and the FlexNET server is accessible.
The location of the licence server must be defined on every machine with the CAXperts product installed, which
can be done
Every computer name must be preceded by the @ symbol. Multiple licence server locations should be separated
by semicolons (“;”).
YourServerName is the Windows computer name of the machine running lmadmin (FlexNET server). If
lmadmin is running on a non-default port, the port number should be defined like this: port@ YourServerName.
Changes to the server path (in the environment variable or registry key) are read during the next start of the CAXperts
product.
To borrow a licence seat press the Borrow seat button, define the loan period (up to 7 days) and press OK.
When the borrowed seat expires it gets automatically returned back to the FlexNET server.
The seat can be returned earlier by pressing the Return borrowed seat button.
Without a valid licence file the software will run in demo mode.
ReportAdapter for Smart® 3D requires Smart 3D and a Smart 3D (S3D) licence seat on a Smart Licence Server.
A window will open where all filters are listed, please select filter and click OK.
Select output
Browse with the Browse… button to select a location to create a Microsoft Access (.*mdb) or SQLite Database
(*.db) in which the results will be shown.
All the settings are stored automatically in the configuration file which is found under Tools → Settings.
Attribute set
Each table consists of one or more attribute sets. Each attribute set holds the data for a specific top node. The
result of one or more attribute sets is grouped together in the table they belong to in the output database.
Drag and drop an attribute to the table on the right side. The attribute will then appear under the Attribute set.
The type selected here defines the main item used for reporting, e.g. pipe component → run: pipe component
selected → only runs that belong to the component are listed; run selected → also empty runs get listed.
• Numeric values
By default all attributes have common units configuration as defined in Menu->Unit settings. Here you can select custom
unit for a specific attribute.
Find
Select Find… from the Edit menu to search for the available attributes:
Enter the search text in Find what and define the task name in Look in to search for the attribute in the given
task:
Geometry extraction
ReportAdapter for Smart® 3D allows extraction of geometry from Smart 3D, which is used by CAXperts
UniversalPlantViewer and CAXperts S3D2PDS software.
2. Empty 3D DGN drawing has to be created through the Smart 3D Drawing Console, e.g. like this:
This 3D DGN Drawing is by ReportAdapter for Smart® 3D for the geometry extraction. The
user needs the permission to update this drawing.
3. Permission to create new filter in the folder (“Plant filters\3D ReportAdapter” by default).
The extraction of geometry using ReportAdapter for Smart® 3D is based on Intergraph Smart 3D export to 3D DGN file
and has the same limitations: only graphical model data in a range of -26843 m to 26843 m in XYZ direction (for M/MM
dgn-seed-file) and from -88069 ' to 88069 ' in XYZ direction (for '/" dgn-seed.file) are exported into MicroStation-files.
Model data out of this range are not exported.
Extraction
To start extraction of attributes and geometry if enabled click on Extract.
The additional SQL statements can be typed in the Additional SQL statements to be processed after
extraction field. They have to look like the following examples
Tables that can be used in the queries are those that will be created during extraction. Additional tables (if
needed) have to be copied before extraction to the Template.mdb database which can be found in the application
folder.
The %TABLE1% and %COLUMN1% fields are filled from the Access database defined for extraction output, which also
includes the tables from Template.mdb. This means, the fields are only filled after the extraction was performed once.
With the Show hidden tables field checked, all tables of the database can be selected to build the query. If it is
not checked, only tables that will be displayed in UniversalReporter are available and tables created for
internal use are hidden.
Fill in the text of SQL statement and the Placeholders for Tables and columns to be used by query textboxes
by using the %TABLE"1% and %COLUMN1% buttons.
User defined templates can be deleted or modified using the Remove or Edit buttons.
Depending on output database format: Microsoft Access (*.mdb) or SQLite (*.db) SQL syntax may be different.
General
Add manual extract info: if enabled shows following dialog before extraction where the user can provide
additional information evaluated by CAXperts UniversalReporter.
Extract interferences: if geometry extraction is enabled this option extracts interference bubbles (graphic) with
their attributes.
Custom coordinate system: to report coordinates using custom coordinate system (CS) instead of a global one
(by default) click “more” and select CS to use.
Custom coordinate system is applied only for attributes extraction (reporting) and has no effect for extracted geometry.
Force Exit extraction job: additional possibility to ensure an extraction job to be finished by 3D
ReportAdapter. This might be helpful especially for more extraction jobs scheduled in a row. This option is also
available as a command line parameter. Force Exit extraction job - use 'lite' disconnect from S3D. Use this
option only if you have problem with standard exit from 3D ReportAdapter.
Select the rules to apply from the list of available Surface Rule Style on left hand side and press Add button.
The rules are executed top->bottom. If no Style rules defined standard colours and MicroStation levels are used.
Drawings
Defines Isometric and Composed drawings to extract. To exclude drawings with a specific approval status,
uncheck corresponding Approval Status in list.
Piping Catalogue
Defines piping specifications to extract.
The location of the plant configuration file is not affected, only the content of the file will be overwritten
To then open the ReportAdapter batch mode help type in the installation path of ReportAdapter followed by
“\3D ReportAdapter.exe” /?
-config config_file.ini Config file which contains the settings for the extraction. If a configuration file is not defined, the last
configuration will be used
-filter filter_name Filter name from S3D Plant. Can be a Plant Filter or from My Filters. If a filter is not defined, the last
configuration will be used
-output output_file.mdb Output database. If Output database is not defined, the last configuration will be used
-forceexit Force Exit extraction job - use 'lite' disconnect from S3D. Use this option only if you have problem with
standard exit from 3D ReportAdapter)
CAXperts GmbH
Carl-Zeiss-Ring 4
85737 Ismaning
Germany
https://www.caxperts.com/contact/
Phone: +49 (89) 969772-0
Email: info@caxperts.com
Helpdesk
Available Monday to Friday 08.00 a.m. – 5.00 pm (UTC +1)
Phone: +49 (89) 969772-250
support@caxperts.com